Deploy SAP

APM Connect allows you to extract data from multiple SAP Systems using the Master Job to extract from multiple systems. You must set up the appropriate directory structures.

1. On the machine on which you installed APM Connect, navigate to the following location: C:\APMConnect\Config\.
2. Create a new folder for each SAP System using the following folder structure: C:\APMConnect\Config\<SAP System Name>.
3. In each SAP system folder, place a copy of the context file.
4. Label each copy of the context file using the following format: SAP_<system name>_Contextfile.xml.
   Important: You must label the context file with SAP_ at the beginning of the file name, or APM Connect will be unable to read the context file during the extraction.
   The directory structure is in place with the complete file path: C:APMConnect\Config\<SAP system name>\SAP_<SAP system name>_Contextfile.xml.For example, a configured directory will resemble the following: C:\APMConnect\Config\Q-66\SAP_Q66_Contextfile.xml.

To facilitate data transfer, there must be a java connector between SAP and the APM Connect server. This topic describes how to establish the connection via the SAP Java Connector (SAP JCO).

1. Navigate to the location where you downloaded the SAP Java Connector package from the SAP marketplace, and copy the following files:
   • sapjco3.dll
   • sapjco3.jar

   Note: If you are using a 64-bit machine, per the APM Connect system requirements, you must select the 64-bit installer.
2. Navigate to C:\APMConnect\Utilities\runtime\lib\wrapper, and then paste the copied files in that location.
3. Copy the file sapjco3.dll again.
4. Navigate C:\windows\system32, and then paste the copied file in that location.

Adapters in APM Now require an SSL certificate to transfer files. As a part of implementation, GE Digital APM will supply you with an SSL certificate.

1. Access the SSL truststore file, provided at installation.
2. Copy the truststore file.
3. On your APM Connect Server, paste the truststore file in a secure file system location that is accessible by the APM Container service user.
4. In the context file, ensure you have configured the SSL Connection parameters, USE_SSL, TRUSTSTORE_FILE, and TRUSTSTORE_PASSWORD.

   The adapters are configured to use SSL.

1. On the APM Connect server, access your context file. If you installed it in the default location, navigate to the following folder: C:\APMConnect\Config
2. Configure the context file for your type of deployment.
   Important: Changes made to the context file will override changes made in the Context parameters section of APM Connect Administration Center.

   To configure the context file, enter the appropriate values for each parameter into the context file according to the following table.

   Interface Mode Selection
   Parameters	Description	Default or Recommended Value
   SAP_CLOUD_ENABLED	Determines whether the Adapter will be used in a cloud environment.	You must enter one of the following values: true: Adapter will be run in the cloud. false: Adapter will be run on premises.
   LOAD_MERIDIUM_APM	Determines whether the data will be loaded into the Meridium database.	You must enter one of the following values: true: Data will be loaded into the Meridium database. false: Data will not be loaded into the Meridium database.
   LOAD_DIGITAL_APM	Determines whether the data will be loaded into the Predix database.	You must enter one of the following values: true: Data will be loaded into the Predix database. false: Data will not be loaded into the Predix database.
   CMMS_ID	The CMMS ID is used as the identifier for your SAP system, and is <SAP System ID>-<SAP Client ID>. For example, if your System ID is D03 and your Client ID is 001, then your CMMS ID would be DO3-001.	This value is required. Enter a unique value.
   SOURCE_SYSTEM_TYPE	Identifies the type of system connecting with GE Digital APM.	This value is required. You must enter one of the following values: SAP: If the source system is SAP. SAP-PI: If the source system is SAP-PI.
   Intermediate Repository (IR) Connection
   Parameters	Description	Default or Recommended Value
   IR_HOST	The IP address of the IR.	Enter the host name of the PostgresSQL server. If you installed APM Connect using the default settings, then the value is localhost.
   IR_PORT	The port number of the IR.	Enter your PostgreSQL port. The default value is 5432.
   IR_DATABASE	The database in which the IR data is stored.	Enter a name for the IR database. This value will be used to create the IR database.
   IR_SCHEMA	The schema in which the IR database will be created.	The default value is public.
   IR_USERID	The IR user name.	Enter the user name for the PostgresSQL database. The default user name is postgres.
   IR_PASSWORD	The IR system password.	Enter the password for the PostgresSQL database that was created during installation.
   SAP Connection
   Parameters	Description	Default or Recommended Value
   SAP_CLIENT	The SAP client from where the data is imported.	Enter a unique value.
   SAP_HOST	The IP address or the host name of the SAP application server.	Enter a unique value.
   SAP_LANGUAGE	The language in which the SAP system sends messages to APM Connect.	The default value is EN.
   SAP_SYSTEM_NUMBER	The instance number of the SAP application server.	Enter a unique value.
   SAP_USERID	The SAP system user ID.	Enter a unique value.
   SAP_PASSWORD	The SAP system password.	Enter a unique value.
   SAP_SYSTEM_TIMEZONE	The SAP Application Server Operating System time zone.	The default value is EST.
   SAP_FILE_ENCODING	Determines the encoding of the source data.	The default value is UTF8. All the character encoding supported by the Java Virtual Machine (JVM) are correct.
   EXTRACT_NUM_PARALLEL_JOB	Determines the maximum number of SAP background jobs allowed during extraction.	The recommended value is 10.
   IR_LOAD_NUM_PARALLEL_JOBS	Determines the maximum number of SAP background jobs allowed during loading.	The recommended value is 10.
   LOG_REQUEST	Logs the APM web service requests.	You must enter one of the following values: true: Enables logging false: Disables logging. This is the recommended value.
   LOG_RESPONSE	Logs the APM web service responses.	You must enter one of the following values: true: Enables logging false: Disables logging. This is the recommended value.
   File System
   Parameters	Description	Default or Recommended Value
   PLSAP_INPUT	The path of the directory you created, which SAP uses to place data files used by APM Connect.	Enter a unique value.
   PLSAP_OUTPUT	The path of the directory used by APM Connect to search for the files created by SAP. This directory should be shared with the SAP server.	Enter a unique value.
   IR_TALEND_OUTPUT	The temporary workspace used when moving files from SAP to APM Connect.	Enter your unique directory path.
   LOG_BASE_DIR	The directory path to the log file.	C:\APMConnect\Logs
   SFTP_STAGING_DIR	The temporary storage location for files that are waiting to be loaded.	Enter your unique value (for example, C:\APMConnect\Staging).
   UNC_FILE_PATH	The path of the directory of the data loader file share.	Enter a unique value.
   APM Connect
   Parameters	Description	Default or Recommended Value
   APM_CONNECT_HOST	The host name of the machine where APM Connect Administration Center is installed.	Enter a unique value.
   APM_CONNECT_PORT	The port name of the machine where APM Connect Administration Center is installed.	Enter a unique value.
   Parameters	Description	Default or Recommended Value
   APM Connection Note: The APM Connection Parameters are not required for a cloud deployment.
   APM_API_APP_SERVER	The GE Digital APM API application server name.	Enter the name of your GE Digital APM API server.
   APM_API_USE_SSL	Specifies whether the GE Digital APM API application uses SSL.	The valid values are: true: The API application uses SSL. false: The API application does not use SSL. The default value is false.
   APM_APP_SERVER	The GE Digital APM application server name.	Enter the name of your GE Digital APM server.
   APM_DATASOURCE	The GE Digital APM data source to which the data will be exported.	Enter the name of your GE Digital APM data source.
   APM_USERID	The GE Digital APM Framework user ID.	Enter a unique value.
   APM_PASSWORD	The GE Digital APM Framework password.	Enter a unique value.
   Miscellaneous
   Parameters	Description	Default or Recommended Value
   MANUAL_RUN	Determines how the date parameters will be treated.	You must enter one of the following values: true: The dates specified in the context files will be used. Additionally, the dates of the last successful run stored in the database will not be updated. false: The date range used during the extraction will be the date of the last successful record as stored in the database. Each time a job is run successfully, the database is updated with those dates and all the subsequent runs will use the dates from the last successful record.
   MULTI_OBJECTS_ENABLED	Determines if different types of objects that are logically related to each other can be classified into a single class type. For example, you can use class type 023 to classify both materials and batches.	You must enter one of the following values: true: Used if the SAP system is enabled to allow multiple objects. false: Used if the SAP system is not enabled to allow multiple objects. This is the default value.
   TECHNICAL_CHARACTERISTICS_ENABLED	Determines if the technical characteristics of Equipment or Functional Location will be extracted.	You must enter one of the following values: true: If you are using Equipment or Functional Location Adapter. false: If you are not using Equipment or Functional Location Adapter. This is the default value.
   Filter
   Parameters	Description	Default or Recommended Value
   MAINT_PLANT	The ID(s) of the Maintenance Plant whose data you want to extract.	Plant values cannot exceed four characters.
   LANGUAGE	The SAP code that represents the language of the description to transfer data into GE Digital APM.	The value must be a single character.
   CREATE_DATE_START	The date value that limits the data extracted to records created on or after the specified date.	Date must be entered in the following format: YYYYMMDD.
   CREATE_DATE_END	The date value that limits the data extracted to records created on or before the specified date.	Date must be entered in the following format: YYYYMMDD.
   CHANGE_DATE_START	The date value that limits the data extracted to records changed on or after the specified date.	Date must be entered in the following format: YYYYMMDD.
   CHANGE_DATE_END	The date value that limits the data extracted to records changed on or before the specified date.	Date must be entered in the following format: YYYYMMDD.
   Equipment Filter Criteria
   Parameters	Description	Default or Recommended Value
   EQUIPMENT_NO	The number that identifies the Equipment record that you want to extract.	Equipment number should not exceed 18 characters. You cannot exceed 500 Equipment numbers. For multiple Equipment records, separate the numbers using commas.
   EQUIPMENT_CATEGORY	The ID of the Equipment category that limits the Equipment records extracted.	Equipment category ID must be a single character. For multiple Equipment categories, separate the IDs using commas.
   EQUIPMENT_TYPE	The ID of the Equipment type that limits the Equipment records extracted.	Equipment type ID should not exceed 10 characters. For multiple Equipment types, separate the IDs using commas.
   EQUIPMENT_CLASS	The ID of the Equipment classification that limits the Equipment records extracted.	Equipment classification ID should not exceed 18 characters. If an Equipment has multiple classifications, if you specify any one of those classifications, the Equipment record will be extracted. For multiple Equipment classifications, separate the IDs using commas.
   Functional Location Filter Criteria
   Parameters	Description	Default or Recommended Value
   FLOC_NO	The ID of the Functional Location that limits the Functional Location records extracted.	Functional Location ID should not exceed 40 characters. You cannot exceed 500 Functional Location numbers. For multiple Functional Locations, separate the IDs using commas.
   FLOC_TYPE	The ID of the Functional Location type that limits the Functional Location records extracted.	Functional Location type ID should not exceed 10 characters. For multiple Functional Location types, separate the IDs using commas.
   FLOC_CLASS	The ID of the Functional Location classification that limits the Functional Location records extracted.	Functional Location classification ID should not exceed 18 characters. For multiple Functional Location classifications, separate the IDs using commas.
   FLOC_CATEGORY	The ID of the Functional Location category that limits the Functional Location records extracted.	Functional Location category ID must be a single character. For multiple Functional Location categories, separate the IDs using commas.
   Work History Filter Criteria
   Parameters	Description	Default or Recommended Value
   NOTIFICATION_NO	The number that identifies the Notification record that you want to extract.	Notification number should not exceed 12 characters. For multiple Notification records, separate the numbers using commas.
   WORK_ORDER_NO	The number that identifies the Work Order record that you want to extract.	Work Order number should not exceed 12 characters. For multiple Work Order records, separate the numbers using commas.
   NOTIFICATION_TYPE	The Notification type that limits the Work Order records that you want to extract.	Notification type should not exceed two characters. For multiple Notification types, separate the Notification types using commas.
   WORK_ORDER_TYPE	The ID of the Work Order type that limits the orders that you want to extract.	Work Order type should not exceed four characters. For multiple Work Order types, separate the IDs using commas.
   WORK_ORDER_SYSTEM_STATUS	The Work Order systems status that limits the Work Orders that you want to extract.	Work Order system status should not exceed four characters.
   WORK_ORDER_USER_STATUS	The Work Order user status that limits the Work Orders that you want to extract.	Work Order user status should not exceed four characters.
   NOTIFICATION_SYSTEM_STATUS	The Notification system status that limits the notifications that you want to extract.	Notification system status should not exceed four characters.
   NOTIFICATION_USER_STATUS	Notification user status that limits the notifications that you want to extract.	Notification user status should not exceed four characters.
   CREATE_TIME_START	The time value that limits the data extracted to records created on or after the specified time.	Time must be in the following format: HHMMSS.
   CREATE_TIME_END	The time value that limits the data extracted to records created on or before the specified time.	Time must be in the following format: HHMMSS.
   CHANGE_TIME_START	The time value that limits the data extracted to records changed on or after the specified time.	Time must be in the following format: HHMMSS.
   CHANGE_TIME_END	The time value that limits the data extracted to records changed on or before the specified time.	Time must be in the following format: HHMMSS.
   Work Management
   Parameters	Description	Default or Recommended Value
   MAINTENANCE_PLAN	The number that identifies the maintenance plan record.	The maintenance plan number must not exceed 12 characters.
   INSPECTION_FAMILY	Determines the family to which the Inspection records are associated.	To use the default association, enter the value MI_TASKINSP.
   INSPECTION_CONDITION	Determines the SAP control key used to identify trigger values for Inspection records.	The parameter requires the following specific syntax: <SAP Table>-<SAP Field> EQ '<Key Value 1>,<Key Value 2>,<Key Value 3>, etc.' To use the default configuration, enter the following value: PLPO-STEUS EQ 'ZMI1'.
   CALIBRATION_FAMILY	Determines the family to which the Calibration records are associated.	To use the default configuration, enter the value MI_TASKCALB.
   CALIBRATION_CONDITION	Determines the SAP control key used to identify trigger values for Calibration records.	The parameter requires the following specific syntax: <SAP Table>-<SAP Field> EQ '<Key Value 1>,<Key Value 2>,<Key Value 3>, etc.' To use the default configuration, enter the following value: PLPO-STEUS EQ 'ZMI2'.
   Parameters	Description	Default or Recommended Value
   Queue Note: The Queue parameters apply only to cloud deployment.
   QUEUE_HOST	The queue host name.	Enter your unique value, which was provided during installation.
   QUEUE_HOST_1	An additional queue host name.	Enter your unique value, which was provided during installation.
   QUEUE_HOST_2	An additional queue host name.	Enter your unique value, which was provided during installation.
   QUEUE_PORT	The queue port.	Enter your unique value, which was provided during installation.
   QUEUE_PORT_1	An additional queue port.	Enter your unique value, which was provided during installation.
   QUEUE_PORT_2	An additional queue port.	Enter your unique value, which was provided during installation.
   QUEUE_USER	The queue user name.	Enter your unique value, which was provided during installation.
   QUEUE_PASSWORD	The queue password.	Enter your unique value, which was provided during installation.
   CUSTOMER_NAME	The coded customer name.	Enter your unique value, which was provided during installation.
   USE_SSL	Provides for encryption and authentication of the data and its transmission to the server.	Enter a unique value.
   TRUSTSTORE_FILE	Location of the file with all the necessary keys and certificates for data transfer to the server using the active message queue.	Enter a unique value.
   TRUSTSTORE_PASSWORD	Password of the trust store for APM Connect to retrieve the keys.	Enter a unique value.
   Parameters	Description	Default or Recommended Value
   SFTP SFTP Connection is supported only for the SAP Adapters, and configuration is required only if you are using FTP to transfer information between your systems. Important: If you are using an SAP System with the SAPFTP_SERVERS table, you must configure that table to activate SFTP servers according to the SAP Help system. You can refer to SAP OSS 1605054 for more details. Typically, this will apply to any SAP version later than ECC6 EHP5.
   PLSAP_FTP_HOST	The SFTP server host name.	Enter a unique value.
   PLSAP_FTP_USERID	The SFTP server user name.	Enter a unique value.
   PLSAP_FTP_PASSWORD	The SFTP server password.	Enter a unique value.
   PLSAP_FTP_PORT	The SFTP server port.	If the default configuration was followed, enter one of the following values: 21: For FTP connection. 22: For SFTP connection.
   PLSAP_FTP_MODE	The mode by which files are copied.	Enter one of the following values: SERVER: To use file shares. FTP: To use standard FTP. SFTP: To use standard secure FTP.
   PLSAP_FTP_SCAN_DIR	The remote SFTP directory used to scan for files.	Enter a unique value.
   PLSAP_FTP_NUM_OF_RETRY	The number of times to scan the SFTP server for files.	10
   PLSAP_FTP_SLEEP_TIME	The time in seconds between scans.	10
   PLSAP_SFTP_SCP_COMMAND	The command name created when establishing the SFTP transfer in SAP.	Enter a unique value.
   Parameters	Description	Default or Recommended Value
   SFTP Note: The SFTP parameters apply only to cloud deployment.
   SFTP_HOST	The SFTP server host name.	Enter your unique value, which was provided during installation.
   SFTP_USERID	The SFTP server user name.	Enter your unique value, which was provided during installation.
   SFTP_PASSWORD	The SFTP server password.	Enter your unique value, which was provided during installation.
   SFTP_PORT	The SFTP server port.	Enter your unique value, which was provided during installation.
   SFTP_LANDING_DIR	The directory path where the shared files are stored.	Enter your unique value, which was provided during installation.
   USE_SSH_KEY	Determines if SSH security configuration will be used by the adapters.	You must enter one of the following values: true: SSH configuration will be used. false: SSH configuration will not be used.
   SSH_PRIVATE_KEY	The directory where the SSH key is stored.	Enter a unique value. The SSH key must be generated by the user in the openSSH format. This key can be stored in any directory on the APM Connect server, but it is recommended to store it in the following directory: C:\APMConnect\Config
   Parameters	Description	Default or Recommended Value
   Email Notification Note: The Email Notification parameters apply only to cloud deployment.
   EMAIL_FROM	The email address from which the notification email will be sent.	Enter a unique value.
   EMAIL_TO	The email address(es) to which the email will be sent.	Enter a unique value.
   FAILURE_DETAIL_REPORT_ENABLED	Indicates whether the failure detail report will be sent when a record fails to load.	You must enter one of the following values: true: The failure detail report, detailing the records that failed to load into GE Digital APM and the reason for failure, will be sent. false: The failure detail report will not be sent.
   FAILURE_DETAIL_REPORT_JRXML_FILE_PATH	Directory where the JasperReport file to generate the failure detail report in PDF will be delivered.	Enter a unique value.
   LOAD_SUMMARY_REPORT_ENABLED	Indicates whether the load complete report will be loaded with each extraction.	You must enter one of the following values: true: The load complete report, detailing the number of records that were extracted and successfully loaded into GE Digital APM, will be sent. false: The load complete report will not be sent.
   LOAD_SUMMARY_REPORT_JRXML_FILE_PATH	Directory where the JasperReport file to generate the summary detail report in PDF will be delivered.	Enter a unique value.
   REPORT_TARGET_DIR	Directory where the report file will be delivered.	Enter a unique value.
   SMTP_HOST	The host for SMTP installation the APM Connect server.	Enter a unique value.
   SMTP_PORT	The port for SMTP.	The default value is 25.
   Guardrail
   Parameters	Description	Default or Recommended Value
   EQUIPMENT_THRESHOLD	The maximum number of records that should be transferred from SAP to GE Digital APM in a single run of the Equipment Adapter.	The default value is 100000.
   FLOC_THRESHOLD	The maximum number of records that should be transferred from SAP to GE Digital APM in a single run of the Function Location Adapter.	The default value is 100000.
   WORKHISTORY_THRESHOLD	The maximum number of records that should be transferred from SAP to GE Digital APM in a single run of the Work History Adapter.	The default value is 50000.
   OVERRIDE_GUARDRAILS	Indicates whether the job will continue if the number of records exceeds the defined threshold.	The default value is Y, which means that the job will run regardless of the number of records included. A warning notification will also be sent to the email address specified in the EMAIL_TO parameter within the Email Notification Parameters section of this file. If you set this parameter to N, the job will be terminated when the number of records exceeds the defined threshold, and an error notification will be sent.
   Parameters	Description	Default or Recommended Value
   SAP PI Note: Enter the appropriate values for the following parameters into the context file only if you are deploying the SAP Adapters for Process Integration (SAP PI) (in which case the parameter SAP_USE_PI should have the value true).
   SAP_USE_PI	Determines whether the SAP PI connection will be used.	You must enter one of the following values: true: SAP PI connection will be used. false: SAP PI connection will not be used. This is the default value.
   SAP_SYSTEM_ID	The system IDs of the SAP systems from which you want to extract data.	Enter a unique value.
   SAP_PI_HOST	The SAP PI server host.	Enter a unique value. For example: http://your.pi_system.com - when not using SSL. https://your.pi_system.com - when using SSL.
   SAP_PI_PORT	The SAP PI server port.	Enter a unique value.
   SAP_PI_RECEIVER_PARTY	The receiver party configured in the SAP PI ID configurations.	This is optional and unique to the user.
   SAP_PI_RECEIVER_SERVICE	The receiver service configured in the SAP PI ID configurations.	This is optional and unique to the user.
   SAP_PI_SENDER_PARTY	The sender party configured in the SAP PI ID configurations.	This is optional and unique to the user.
   SAP_PI_SENDER_SERVICE	The sender service configured in the SAP PI ID configurations.	If not specified, the default value is Meridium_APMConnect. The value must match what is in the communication channel in SAP.
   SAP_PI_USERID	The SAP PI user ID.	Enter a unique value.
   SAP_PI_PASSWORD	The SAP PI password.	Enter a unique value.
   COMPRESS_TYPE	Determines if the files will be compressed and the method of compression that is used.	You must enter one of the following values: None: Files are not compressed. Note: If you do not compress files, large extractions will take a long time. SAPCAR: Files are compressed by SAP. This is the recommended value. If used, you must install the SAPCAR file on the APM Connect server. ZIP: Files are compressed through a standard zip method.
   COMPRESS_SAP_COMMAND_NAME	The value of the command name created.	You must enter one of the following values: ZSAPCAR: The command name for SAP compression. ZSZIP: The command name for standard compression.
   FILE_MOVE_USE_PI	Determines if APM Connect should use SAP PI to extract and load data.	You must enter one of the following values: true: SAP PI will move the data from SAP to APM Connect. false: APM Connect will directly copy the data from SAP.
   MAX_FILE_WAIT_SEC	Defines how long the PI Adapters will wait for the extraction to complete before the job times out.	The recommended value is 1000.
   SAP_PI_AAE	If you are using SAP 7.3 or above, you may use the Advanced Adapter Engine (AAE). This parameter allows this functionality to be used during extraction.	You must enter one of the following values: true: If you are using AAE. false: If you are not using AAE. This is the default value.

1. In the APM Connect Administration Center, in the Job Conductor workspace, select the Job for which you would like to set parameters.
2. At the bottom of the Job Conductor workspace, select Context parameters.
   The Context parameters section appears.
   
   
3. In the Context parameter column, scroll down to the context parameter you would like to configure.
4. In the Custom value box, configure context parameters, and select the Active check boxes for the following:
   • APM User_ID: Enter your GE Digital APM user name
   • APM_PASSWORD: Enter your GE Digital APM password.
   • IR_USERID:Enter your intermediate repository user name.
   • IR_PASSWORD: Enter your intermediate repository password.
   • SAP_USERID: Enter you SAP System user name.
   • SAP_PASSWORD: Enter your SAP system password.
   • CONFIG_FILE_PATH: Enter the file path to the location where the context file is stored.
   • LOG4j_FILE_PATH: Enter the filed path to the location where the Log4j file is stored. If you installed APM Connect in the defualt location, then enter \APMConnect\Config\log4jproperties

   • MANUAL_RUN: Enter true or false to determine whether or not the dates recorded in the context file will be used during extraction.

     Note: If the MANUAL_RUN parameter is set to true, the dates specified in the context file will be used. Additionally, the dates of the last successful run stored in the database will not be updated. If set to false, the date range used during the extraction will be the date of the last successful run, as stored in the database. Each time a Job is run successfully, the database is updated with those dates, and all subsequent runs will use the dates from the last successful run.

   The context parameters are configured.

5. Repeat steps 1-4 for every imported Job you will run.
6. To configure the Master job to run, select the SAP_MASTER_INTERFACE Job.
7. At the bottom of the Job Conductor workspace, select Context parameters.

   The Context parameters section appears, displaying the following parameters:

   • RUN_STATIC_DATA:The Static Data Job
   • RUN_EQUIPMENT:The Equipment Job
   • RUN_FLOC:The Functional Location Job
   • RUN_WORKHISTORY:The Work History Job
   • RUN_WORKMANAGEMENT: The Work Management Job
   • MASTER_CONFIG_FILE_DIR:The file path to context files for the jobs
   • SYSTEM_TO_RUN: The source system from which you want to extract data
   • RUN_TC_EQUIPMENT: The Equipment Technical Characteristic Job
   • RUN_TC_FLOC:The Functional Location Technical Characteristics Job
8. For each extraction jobs you want to run, in the Custom value column enter true, and then select the Active check box.
9. In the MASTER_CONFIG_FILE_DIR Custom value box, enter the directory where the context file(s) is stored.
10. In the SYSTEM_TO_RUN Custom value box enter:
    • The name of the system directory from which you want to extract data.
    • * to extract from all systems.
11. Select Enter.

    The Jobs are configured to run.

1. In the APM Connect Administration Center, in the Job Conductor workspace, select the Extraction Wrapper job, and then select Context parameters.

   The Context parameters section appears.

   

2. Configure the Custom value for the following connection parameters:
   • CONFIG_FILE_DIR: Enter the directory path where your context file is stored.

   • SYSTEM_TO_RUN: Enter the name of the directory containing the context file from which you want to extract data, or, to extract from all context directories, enter *.

   • LOG_BASE_DIR: Enter the directory path into which the log files will be written.
   • LOG4J_CONFIG_FILE: Enter the directory path where your log4j properties file is stored.
3. Select the Active check box corresponding to each of the connection parameters.
4. For each extraction jobs you want to run, in the Custom value column enter true, and then select the Active check box.

   For example, if you want run only the Equipment Adapter, in the RUN_EQUIPMENT row, in the Custom value box enter true. Then, select the Active check box.

   

   The Extraction Wrapper job is configured to run. Once the job is executed, the data designated to be extracted in the Connect parameters will be transferred from your SAP System to your GE Digital APM system.

5. For each of the remaining jobs imported into the APM Connect Administration center, select the job, and then Context parameters.
6. Configure the following parameters:
   • CONFIG_FILE_PATH: Enter the directory path where your context file is stored, including the name of the context file, for example C:\APMConnect\Config\SYS-001\SAP_ContextFile.xml
   • LOG4J_CONFIG_FILE: Enter the directory path where your log4j properties file is stored, including the name of the context file, for example C:\APMConnect\Config\log4j.properties
7. Repeat steps 5-7 for each imported job that you plan to run.

To assign site references to records using values other than those in the baseline configuration, you must modify the autojoin_control table in the Intermediate Repository.

• Configure the Site Reference Value to Use an Indirect Site Reference Value
  1. Access a database browser tool, and then access your Intermediate Repository (PostgreSQL) database.
  2. Locate the autojoin_control table, and then locate the site_reference column.
     Tip: For details about what each column in the autojoin_control table contains, see About Site Filtering Configuration.
  3. Update the value in the site_reference column using the format #FIELD_ID#, where FIELD_ID represents the ID of the field from which you want to populate the site reference value.

     For example, if you want the site reference value to be the value in the SAP Maintenance Plant field of the corresponding Equipment or Functional Location.

     • Where the value #MI_FNCLOC00_SAP_SYSTEM_C# occurs, replace the value with #MI_FNCLOC00_MAINT_PLNT_C#
     • Where the value #MI_EQUIPOO_SAP_SYSTEM_C# occurs, replace the value with #MI_EQUIP000_MAINT_PLANT_C#

     When you import record into GE Digital APM from your SAP System, its Site Reference Key will be the value in the field that you specified. In the example above, the Site Reference Key will be the SAP Maintenance Plant of the corresponding Equipment or Functional Location.

• Configure the Site Reference Value to be A Specific Site Name
  1. Access a database browser tool, and then access your Intermediate Repository (PostgreSQL) database.
  2. Locate the autojoin_control table, and then locate the site_reference column.
     Tip: For details about what each column in the autojoin_control table contains, see About Site Filtering Configuration.
  3. Where the value #MI_EQUIPOO_SAP_SYSTEM_C# occurs, replace the value with the Site name as defined in a GE Digital APM Site Reference record.

     When you import records into GE Digital APM from your SAP System, its Site Reference Key will be the name of the Site as defined in the APM Site Reference record.

This topic details the basic process for setting up a file share based on your operating systems.

• Create a File Share on a Windows Server, and then Mount the Share to a Linux Server
  1. On your APM Connect server (i.e., the Windows server on which you want to create the share), create a new folder for file sharing.
     Note: This share can be anywhere on your APM Connect server and can have any name.
  2. Right-click on the new folder, and then select Properties.
     The <Folder Name> Properties window appears.
     
     
  3. Select the Sharing tab, and then select Advanced Sharing.
     The Advanced Sharing window appears.
     
     
  4. Select the Share this folder check box.
     The other fields on the window are enabled.
  5. Optionally, edit the name in the Share name: box. If you do not edit this name, the name will default to the folder name.
  6. Select Permissions.
     The Permissions for <Folder Name> window appears.
     
     
  7. Select Add….
     The Select, Users, Computers, Service Accounts, or Groups window appears.
     
     
  8. In the Enter the object names to select (examples) box, enter the name of your APM Connect service account user.
     Note: The user must have permission to read and write to the shared folder.
  9. Select OK.
     The Select, Users, Computers, Service Accounts, or Groups window closes.
  10. On the Permissions for <Folder Name> window, in the Permissions for <Service User Name> box, in the Allow column select the Full Control check box, the Change check box, and the Read check box.
  11. Select OK.
      The Permissions for <Folder Name> window closes.
  12. On the Advanced Sharing window, select OK.
      The Advanced Sharing window closes. Then, on the <Folder Name> Properties window, in the Network File and Folder Sharing section, the Network Path: subsection is populated.
  13. Record the network path.
  14. Access your SAP PI server or your SAP server (i.e., the Linux server to which you want to mount the share) via a Linux Command Line Editor tool (for example, Vim or Nano).
  15. Determine an existing directory that will be used as the share, or create a new directory.
  16. In that directory, to initiate the connection between your source and target share, execute a mount command. The command will likely require the APM Connect service account user, source of the file share folder you created on the APM Connect server, and target for the share on your Linux server.
      Tip: The exact mount command will vary based on the system that you are using. An example of a mount command is mount -t smbfs -o username=Administrator //recurring/c$ /mnt/recurring
  17. To verify that the new mount is configured correctly, enter the command mount.

      The mount appears in the list of mounted shares.

      Tip: At this point, you should be able to write files from one share to another. To test, place a file in the source folder on the Windows machine, and then the file should appear in the target directory on the Linux machine.
  18. On the Linux machine, navigate to the file /etc/fstab.
      Tip: Mounting the share into the /etc/fstab file makes the file share permanent meaning that upon reboot the file share is still be mounted. If you do not execute the mount in this location, once the machine is rebooted the mount will be disconnected.
  19. Open the file to be edited using a data base editor (for example Vim or Nano).
  20. Add a new line to the file defining the share, mount point, file system driver, and options.
      Tips:

      • The following is an example of the statement syntax: //<Source Folder Name> /<Target Folder Name <Systems Type or Driver> username=username password=<password> 02.
      • Additionally, the following is the same entry with sample values: //APMConnectServer1/WindowsSharedFolder /opt/LinuxSharedFolder cifs –o username=APMConnectSeriveAccount1 password=APMConnect 0 2
  21. Close the file, and then return to the root directory.
  22. To unmount the share created, execute the command umount (i.e., if the original mount directory was /opt/LinuxFileShare, then execute the command unmount /opt/LinuxFileShare).
      Tip: You must unmount the share from the original location for it to be mounted from the /etc/fstab file.
  23. Execute the command mount.

      The original mount directory does not appear in the list of mounted shares, and the new share in the /etc/fstab folder can be mounted.

  24. Execute the command mount –a.
      Tip: Executing the command will read the configuration from the /etc/fstab file, and then preform the mount operation based on the parameters in the file.
  25. To verify that the share has been mounted, execute the command mount.

      The new mount point added to the /etc/fstab file appears in the list.

      At this point, you can place a file on the APM Connect server in the shared folder, and it will be transferred to the shared Linux folder.

• Create a File Share on a Linux Server, and then Mount the Share to a Linux Server
  1. Access your SAP Server (i.e., the Linux server to which you want to mount the share) via a Linux Command Line Editor tool (for example, Vim or Nano).
  2. Ensure that the nfs-kernel-server service is installed and running.
     Important: The name of this service can vary based on the Linux system.
  3. Create the directory that will be mounted to your SAP PI server or your SAP server.
  4. To grant the remote server permission to mount a local directory, locate the file /etc/exports.
  5. In that file, enter the directory you created in Step 3, and then identify the server that can mount the directory.
     For example, if you wanted to create the directory /opt/PI_FileShare and grant all users permissions to mount that directory, then you would enter the following: /opt/PI_FileShare *(rw, sync, no_root_squash, not_subtree_check).

     Tip: You can find all of the export options and access control lists in the manual file accessed by executing the command man exports.
  6. Restart the service /etc/init.d/nfs-kernel-server.
  7. Access your SAP PI server or your SAP server (i.e., the Linux machine to which you want to mount the share).
  8. Create a directory to which files will be written from the share.
  9. Execute the mount command to mount the exported directory on to the SAP PI server or the SAP server.
     Tips:

     • The exact mount command will vary based on the system that you are using. An example of a mount command is mount example.hostname.com:/ubuntu/local/ubuntu.
     • For example, if your SAP server hostname is SAPServer1, your source directory is /opt/PI_FileShare, and your target directory is /opt/SAP_FileShare, you would enter the following: mount SAPServer1: /opt/PI_File_Share /opt/SAP_FileShare
  10. The directory created in step 3 appears in the list of mounted directories.
      Tip: At this point, you should be able to write files from one share to another. To test, place a file in the source folder on the Windows machine, and then the file should appear in the target directory on the Linux machine
  11. On the Linux machine on which the share will be mounted, navigate to the file /etc/fstab.
      Tip: Mounting the share into the /etc/fstab file makes the file share permanent, meaning that upon reboot the file share will still be mounted. If you do not execute the mount in this location, once the machine is rebooted the mount will be disconnected.
  12. Open the file to be edited using a database editor (for example, Vim or Nano).
  13. Add a new line to the file defining the share, mount point, file system driver, and options.
      Tips:

      • The following is an example of the statement syntax: <exporting server hostname>:<exported Folder Name> <Target Folder Name> <Systems Type or Driver> 0 2.
      • Additionally, the following is the same entry with sample values: APMConnectServer1.company.com:/exportedFolder /opt/mountpointFolder nfs 0 2
  14. Close the file, and then return to the root directory.
  15. To unmount the share in the directory created in step 8, execute the command umount.

      For example if the original mount directory was /opt/LinuxFileShare, then execute the command unmount /opt/LinuxFileShare.

      Tip: You must unmount the share from the original location for it to be mounted from the /etc/fstab file.
  16. Execute the command mount –a.
      Tip: Executing the command will read the configuration from the /etc/fstab file, and then preform the mount operation based on the parameters in the file.
  17. To verify that the share has been mounted, execute the command mount.

      The new mount point added to the /etc/fstab file appears in the list.

      At this point, you can place a file on the APM Connect server in the shared folder, and it will be transferred to the shared Linux folder.

If you use (S)FTP to transfer files between SAP, APM Connect, and GE Digital APM, you must complete additional configuration in SAP. You must download a puTTY file and set up command names in SAP to use the puTTY file.

1. On your SAP system, in a browser, navigate to the PuTTY website.
2. Download the following puTTy file: pscp.exe.
3. Copy it into the PATH on your SAP system. The recommended directory is %WINDIR%/System32.
4. In SAP, run the transaction code SM69.

   The External Operation System Commands screen appears.

5. Select .
   The Create an External Command screen appears.
6. In the Command Section, in the Command Name box, enter a name for your command.
7. In the Definition section, in the Operating system command box, enter following systems commands: pscp.
8. Select Save.
   The puTTY file is on the SAP system, and the corresponding command names are set up.

Data files written by SAP are placed in a specific directory defined by the context parameter PLSAP_INPUT. This topic describes how to create the appropriate directory structure.

1. Navigate to the folder into which your SAP system writes files.
   Note: This folder will be different for each customer, but will likely be labeled PLSAP_INPUT.
2. Create a new folder for each of the following:
   • EQUIPMENT
   • FLOC
   • TC_EQUI
   • TC_IFLOT
   • WMI
   • WORKHISTORY

1. On a machine from which you can access the SAP Server, navigate to the FTP site provided to you.
2. Determine how to proceed based on your ABAP release, level, and type of SAP system.
   • For ECC6, if your currently installed ABAP release is 400_600 and the level is 0000, 0030, 0032, 0033, or 0034, proceed directly to step 16. Otherwise, proceed to the next step.
   • For S/4 Hana, if your currently installed ABAP release is 4XX_750 and the level is 0034, proceed directly to Step 16. Otherwise, proceed to the next step.
3. Depending on your SAP environment, navigate to the folder \\SAP Interfaces ABAP Add-On\Service Pack Files\ECC6 or \\SAP Interfaces ABAP Add-On\Service Pack Files\S/4 Hana, and then select one of the following folders:
   • Exchange Upgrade: To upgrade the ABAP package when upgrading to a new SAP version.
   • Install: To install the ABAP Package for the first time.
   • Upgrade: To upgrade the ABAP package.
4. Copy the .pat file(s).
   The file names begin with either D07 for ECC6 or H4S for S/4 Hana.
5. On the SAP Server, paste the copied file into the folder \\usr\sap\trans\EPS\in.
6. Log in to the SAP system as a user with:
   • SCTSIMPSGL and S_CTS_ADMIN authorizations.
   • SAP_ALL authorization.
7. Run the following transaction: SAINT.

   The Add-On Installation Tool screen appears.

8. In the page, select Installation Package, then select Load packages, and then select From Application Server.
   
9. Select Yes.

   The SAINT: Uploading Packages from the File System screen appears.

   Note: In an S/4 Hana environment, two files are uploaded and are displayed in the SAINT: Uploading Packages from the File System screen.

   In the row corresponding to the .pat file that you copied previously, the Message Text column displays Uploaded successfully.

10. At the top of the screen, select .

    The Add-On Installation Tool screen appears again.

11. Select Start.
    A new grid appears. MIAPMINT appears in the list of add-on packages that can be installed.
12. Select the row containing the value MIAPMINT in the first column, and then select Continue.
    The Support Package selection screen appears.
13. Select Continue, and then select Continue again.
    Note:

    • During the installation, the Add Modification Adjustment Transports to the Queue window might appear. If it does, select No.
    • During the installation, the Open data extraction requests window might appear. If it does, select Skip, and then select Yes.

    An indicator appears at the bottom of the screen to indicate the installation progress.

    When the progress indicator disappears, a message appears, indicating that the add-on package will be installed.

14. Select .

    The status is updated to indicate that the add-on package will now be imported, and the installation process continues. When the installation process is complete, the status is updated to indicate that the add-on package was imported successfully.

15. Select Finish.
    The MIAPMINT add-on package appears in the list of installed add-on packages on the Add-On Installation Tool screen.
16. On the FTP site, navigate to the folder \\SAP Interfaces ABAP Add-On\Support Package.
17. Depending on your SAP environment, navigate to the ECC6 folder or navigate to the S/4 Hana folder, and copy the .pat file(s).
18. On the SAP Server, paste the copied file(s) into the folder \\usr\sap\trans\EPS\in.
19. Log in to the SAP system.
20. Run the following transaction: SPAM.
    The Support Package Manager screen appears.
21. Select Menu, then select Support Package, then select Load Packages, and then select From Application Server.
    A message appears, asking if you want to upload the package.
22. Select Yes.
    A summary screen appears, indicating that the package was uploaded successfully.
23. Select Back.
24. Select Display/define.
    The Component Selection window appears.
25. Select the MIAPMINT component.
26. When prompted, confirm that the patch will be imported into the queue, and then select .
27. Select Menu, then select Support Package, and then select .
    The SPAM: Import: Queue window appears.
28. In the SPAM: Import: Queue window, select .
    The import process begins. When it is complete, a message appears, indicating that the import process was successful.
29. Select Continue.
    Another message appears, indicating that the import process was successful.
30. Select .
31. Select Menu, then select Support Package, and then select .
    The installation is complete.

1. In SAP, in the System menu, select Status....
   The System: Status window appears.
   
   
2. In the SAP System data subsection, select .
   The System: Component information window appears.
3. If you have deployed the ABAP Add-On package for the SAP Adapter, scroll down until you see the Software Component MIAPMINT.
   If you see the following values in the following columns, the Add-On was applied successfully:

   • Release:
     • ECC6: 400_600
     • S/4 Hana: 4XX_750
   • Level:
     • ECC6: 0035
     • S/4 Hana: 0035

   Note: If the level does not match, go back to the copy .pat files step of Install the ABAP Base Service Pack Add-on and rerun the installation steps.

Use this procedure to provide SAP and SAP-PI data flows in situations that require access to both V3.6.x and V4.3.x GE Digital APM at the same time.

1. In the APM Connect installation package, navigate to \\SAP Interfaces ABAP Add-On\Service Pack Files\Dual Pack - V36 & V4 .
2. Install the ABAP package as described in Install the ABAP Base Service Pack Add-on, using ECC6 as when you need to make choices.
3. Verify the package as described in Verify ABAP Installation.
   The release and level values should match these:

   Release:

   ECC6: 436_600

   Level:

   ECC6: 0000

If you are upgrading from one version of the ABAP Base service pack add-on to a newer version, you will need to uninstall the currently installed service pack.

1. Log in to the SAP server as a user with either SCTSIMPSGL and S_CTS_ADMIN authorizations or SAP_ALL authorization.
2. Enter SAINT.
   The Add-On Installation Tool screen appears.
3. Select the Uninstallable components tab.
   MIAPMINT appears in the list of add-on packages that can be uninstalled.
4. Select MIAPMINT, and then select Continue.
   The Start options window appears.
5. Select Default options.
6. Select .
   The status is updated to indicate that the add-on package will now be imported and the uninstall process continues. When the process completes, the status is updated to show that the add-on package was removed successfully.
7. Select Finish.

To successfully transfer data between GE Digital APM and SAP, you must create an APM Connect user for SAP. This topic describes the process of creating a user profile.

1. In SAP, run the transaction PFCG.
2. In the Role Maintenance screen, in the Role box, enter your role name (for example, ZRM_APMCONNECT_AUTH_PROFILE), and then select Single Role.
3. In the Display Roles screen, select the Authorizations tab.
4. Define authorizations.
   1. In the Maintain Authorization Data and Generate Profiles section, in the Change Authorization Data row, select .
   2. In the Choose Template window, select do not select templates.
   3. In the Change Role: Authorizations window, select Manually.
   4. In the Manual selection of authorizations pane, in the Authorization Object box, enter the following authorization object values.

      Authorization Object	Description
      C_TCLA_BKA	Authorization for Class Types
      I_AUART	PM: Order Type
      I_BERG	PM: Authorization Group
      I_BETRVORG	PM: Business Operation
      I_INGRP	PM: Maintenance Planner Group
      I_KOSTL	PM: Cost Centers
      I_QMEL	PM/QM: Notification Types
      I_SWERK	PM: Maintenance Plant
      I_WERK	PM: Maintenance Planning Plant
      S_BTCH_JOB	Background Processing: Operations
      S_DATASET	Authorization for File Access
      S_LOG_COM	Required if file transfer is SFTP/SCP. For server mode this authorization is not required.
      S_RFC	Authorization Check for RFC Access
      S_TABU_NAM	Table Access with Generic Standard

   5. Select .
5. Define RFC access.
   1. In the Cross-application Authorization Objects row, select to expand the workspace, then select the Authorization Check for RFC Access row, then select the Activity row, and then select .
   2. In the Define Values window, select the Execute box, and then select .
   3. In the workspace, in the Name of RFC to be protected row, select .
   4. In the Field values window, in the Value Intrvl section, in the ‘From’ column, enter the following RFC values.

      /MIAPM/*	RFC_GET_FUNCTION_INTERFACE	SYSTEM_RESET_RFC_SERVER
      CLAF_CLASSIFICATION_OF_OBJECTS	RFCPING
      DDIF_FIELDINFO_GET	SYSTEM_RESET_RFC_CONNECTION

   5. Select .
   6. In the workspace, in the Type of RFC object to be protected row, select .
   7. Select the FUNC check box, and then select .
6. Select to expand the Basis: Administration row to access the administration section.
7. Define table access.
   1. In the Table Access with Generic Standard Tools row, select to expand the workspace.
   2. In the Activity row, select .
   3. In the Define Values window, select the Display check box, and then select .
   4. In the Table Name row, select .
   5. In the Field values pane, in the Value Intrvl section, enter the following table values in the 'From' column.

      /MIAPM/*	COVP	INOB	PLPO	T024I	TCURR
      AFVV	CRHD	JEST	PMCO	T350	T499S
      AFKO	CRTX	JSTO	PRPS	T352B_T	TGSBT
      AFRU	CSKT	KLAH	QMEL	T353I_T	TJ02T
      AFVC	CVERS	KSML	QMFE	T356_T	TJ30T
      AFVV	EAPL	KSSK	QMMA	T357	TKA01
      AUSP	EQBS	MAKT	QMUR	T357A_T	TQ80
      BGMKOBJ	EQKT	MHIS	QPCT	T357M_T	TQ80_T
      CABN	EQUI	MHIO	SWOR	T370C_T	VIAUFKST
      CABNT	EQUZ	MMPT	T001	T370F_T	VIQMEL
      CAWN	IFLO	MPLA	T001W	T370U	VIMPLA
      CAWNT	IFLOS	OBJK	T003P	TAPL	VIMPOS
      COBK	IFLOT	PLAS	T006	TCLA
      COEP	ILOA	PLKO	T006A	TCURC

8. Select .
9. Define background processing.
   1. In the Background Processing: Operations on Background Jobs row, select to expand the workspace, and then, in the Job operations row, select .
   2. In the Define Values pane, select the RELE check box, and then select .
   3. In the workspace, in the Summary of jobs for a group row, select .
   4. In the Field values window, select Full authorization, and then select .
10. Define file access.
    1. In the Authorization for file access row, select to expand the workspace.
    2. In the Activity row, select .
    3. Select the Delete, Read, Write, Read with filter, and Write with filter check boxes, and then select .
    4. In the Physical file name row, select .
    5. In the Field values window, select Full authorization, and then select .
    6. In the Program Name with Search Help row, select .
    7. In the Field values window, select Full authorization, and then select .
11. In the Plant Maintenance row, select to expand the workspace to define the plant maintenance configuration.
12. Define notification types.
    1. In the M/QM: Notification Types row, select to expand the workspace. Then in the Notification types row, select .
    2. In the Field values window, in the Value Intrvl section, in the 'From' column, enter your notification types (for example, M1 and M2).
13. Optional: If you are using SFTP or SCP to transfer files between GE Digital APM and SAP, supply the following values to S_LOG_COM Assign Authority object.

    Command	Value
    COMMAND	ZSCP - the command defined in the SM69 transaction code that triggers the external command to transfer the file to the FTP server.
    HOST	SAP host name, for example, SAPPERDEV
    OPSYSTEM	Operating system of your SAP system, for example, Windows NT.

14. In the Classification row, select to define the classification configuration.
15. Define the class type authorizations.
    1. In the Classification row, select , and then, in the Authorization for Class Types row, select to expand the workspace.
    2. In the Class Type row, select .
    3. In the Field values window, in the Value Intrvl section, in the 'From' column, enter the class types used in the process (for example, 002 and 003), and then select .
16. In the Transaction codes row of the workspace, select to define the transaction codes.
    1. In the Field values window, in the Value Intrvl section, in the 'From' column, enter the transaction codes IW21, IW22, and IW23.
17. Define the plant maintenance configuration.
    1. In the PM: Order Type row, select to expand the workspace.
    2. In the Order type row, select , and then select the order types you are using.
       Note: Each order type you use (for example, PM01 and PM02), needs the same configuration.
    3. In the Field values window, in the Value Intrvl section, in the 'From' column, enter *.
    4. In the PM: Authorization Group row, select to expand the workspace, and then, in the Technical object authorization row, select , to add the authorization groups you are using.
    5. In the Transaction codes row select .
    6. In the Field values window, in the Value Intrvl section, in the 'From' column, enter the transaction codes IW21, IW22, IW23, IW31, IW32, and IW33.
    7. In the PM: Business Operation row, select to expand the workspace. Then, in the Business Transaction row, select , and then add the Business Transaction that you are using.
    8. In the PM: Maintenance Planner Group row, select to expand the workspace. Then, in the Planner Group for Customer Set row, select , and then add the Planner Groups that you are using.
    9. In the workspace, in the Maintenance Planning Plant row, select to add the Maintenance Planning plants.
    10. In the maintenance planning plant row you added in step 17.i, select .
    11. In the Field values window, in the Value Intrvl section, in the 'From' column, enter the transaction codes IW21, IW22, IW23, IW31, IW32, and IW33.
    12. In the PM: Cost Centers row, select to expand the workspace. Then, in the Controlling Area row select to add the Controlling Areas you are using.
18. In the workspace, in the Cost Center row, select to add the Cost Centers you are using.
    1. In the Field values window, in the Value Intrvl section, in the 'From' column, enter the transaction codes IW21, IW22, IW23, IW31, IW32, and IW33.
19. In the Change Role Authorization screen, select , and then select .
20. In the Assign Profile Name for Generated Authorization Profile window, select .

This procedure describes how to assign an SAP profile to the APM Connect user in SAP.

1. In SAP, run the transaction SU01.
2. In the User Maintenance: Initial Screen window, in the User box, enter a user name (for example, APMCONNECT), and then select to create a new user.
   Note: Select to edit an existing user.
3. Select the Logon Data tab, and then enter an initial password for the user.
   Important: You must log on manually to change the initial password before using the user and password combination in APM Connect.
4. In the User Type box, select Dialog.
5. Select the Roles tab, and then, in the Role column, enter the role ZRM_APMCONNECT_AUTH_PROFILE.
6. Select other tabs in the User Maintenance: Initial Screen window to enter any other required information to conform to SAP guidelines.
7. Select to save the user.

The Work Management Adapter allows you to create Inspection Task and Calibration Task records from SAP Maintenance Plans using Operations and Object Lists. This topic describes how to identify which values in an Operation or Object list will trigger the creation of which Task records in GE Digital APM.

The SAP Interfaces feature allows you to create Recommendation records in GE Digital APM that will be used to create SAP Notifications automatically.

As recommended, and by default, a RestFUL SAP web service call is used as an intermediary between SAP and GE Digital APM, thereby avoiding RFC calls directly between GE Digital APM and your SAP server. Complete these steps to deploy and configure the files necessary to enable this connection.

1. Access the APM Connect installation package, and then copy the file connectorServices.jar.
2. On your APM Connect server, navigate to <root:>\APMConnect\Utilities\runtime\deploy.
3. Paste the copied file connectorServices.jar into the directory.

You can configure the priority value in GE Digital APM to match the priority value in SAP by editing the MI_PRIORITY system code table.

1. Determine the values in your EAM system that determine priority.
2. For each priority that exist in you EAM System, modify the MI_PRIORITY system table

You must configure an EAM System Record to establish a connection between any EAM system and GE Digital APM.

1. Create a new record, using the EAM System family.
2. In the Datasheet ID: box, select SAP.
   Note: If your SAP system requires an RFC connection, select SAP System for RCMO.
3. In the Name box, enter the name of your system.
4. If this system is the system to and from which you want to send data by default, select the Default EAM System? check box.
5. In the System Type box, select SAP.
   If you are defining an SAP System for RCMO, the box is not available.
6. In the User ID box, enter a valid User ID.
7. In the Password box, select .
8. In the Enter EAM System Password window, in the Password box, enter the password that is associated with the specified user ID.
9. In the Confirm Password box, reenter the password.
10. Select OK.
11. In the Connection String box, modify the template connection string.
    1. Replace the text SAP_SERVER_IP with the IP address of the Server.
    2. Replace the text SAP_SYSTEM_NUMBER with the System number.
    3. Replace the text SAP_CLIENT_NUMBER with the Client number.
    4. Delete all angle brackets.
12. Optional: In the ITS URL box:
    1. Replace the text: its_or_integrated_its_server_url with the ITS Server information. To locate the ITS Server information:
       1. In SAP, run the following transaction: SE80.
          Note: If you do not have access to this transaction, contact your SAP BASIS team for assistance.
       2. In the toolbar, select Utilities, and then select Settings.
       3. In the window, select repeatedly until the Internet Transaction Server tab appears.
       4. Select the Internet Transaction Server tab.

          The ITS Server information that you must enter in the ITS URL box in GE Digital APM is <Log><Path>, where <Log> is the text in the Log section and <Path> is the text in the Path section.

          
          
          
    2. Delete the angle brackets.
    3. Enter: webgui/! at the end of the URL.
       For example, the ITS URL that corresponds with the values in the image above is http:// DOCROAECC6.meridium.com:8000/sap/bc/gui/sap/its/webgui/!.
13. Select .
    The EAM System record is saved.
14. Select , and then select Test Connection.
    The connection parameters are verified, and the System ID box is populated with your EAM System ID.

1. In the GE Digital APM application, open the EAM System record whose connection information you want to test.
2. To access the Associated Pages menu, select , and then select Test Connection.
   The connection is tested.

This topic describes how to set up a repository in preparation to run your first job.

1. Log in to the APM Connect Administration Center web application.
   Note: The user logging in must have access to the Job Conductor by being designated the Operations Manager role. By default, users designated as administrators do not have Job Conductor permissions.
2. In the Job Conductor workspace, in the appropriate project, select the CreateIntermediateRepository job.
3. Select Context parameters.

   The Context parameters section appears.

4. Configure the following parameter.

   Context Parameter	Description
   CONFIG_FILE_PATH	The file path to context files for the jobs. Important: You must change the default value to reflect the actual path to your configuration file. CMMS_ID and SOURCE_SYSTEM_TYPE must be set in the context file.

5. Select Run.
   If you are configuring a single system, you have completed your configuration.
   The intermediate repository database is created for the project.

If you are configuring multiple EAM systems, perform the remaining steps in this topic.

6. In the Job Conductor workspace, in the appropriate project, select the addSourceSystem job.
7. Configure the following parameter.

   Context Parameter	Description
   CONFIG_FILE_PATH	The file path to context files for the jobs. Important: You must change the default value to reflect the actual path to your configuration file. CMMS_ID and SOURCE_SYSTEM_TYPE must be set in the context file.

8. Select Run.
9. Repeat steps 6 through 8 for all adapters.

The Static Data job populates the database with static site information. This topic describes how to run this job.

1. Open and log in to the APM Connect Administration Center web application.
   Note: The user logging in must have access to the Job Conductor by being designated the Operations Manager role. By default, users designated admin do not have Job Conductor permissions.
2. Select Job Conductor.
3. In the Job Conductor workspace, select an appropriate project, and then select the CreateStaticData Job.
4. Select Run.
   The static data pull is enabled.

   You can now execute jobs.

In order to transfer data between SAP items and GE Digital APM Task records and Event records for Inspection and Calibration, you will need to configure the datasheets used as the default datasheet.

• Configure GE Digital APM to Transfer Data Between SAP Items and Task Records
  1. Set the following baseline datasheets as the default datasheets on the Inspection and Calibration Task families:
     • Inspection Task for SAP Integration: Defined on the Inspection Task family.
     • Calibration Task for SAP Integration : Defined on the Calibration Task family.
• Configure GE Digital APM to Create Confirmations from Calibration Event Records
  1. Set the following baseline datasheets as the default datasheets on the Calibration Event families:
     • Calibration, Analog: Defined on the Calibration, Analog family.
     • Calibration, Analyzer Multi-Component: Defined on the Calibration, Analyzer Multi-Component family.
     • Calibration, Analyzer Single Component: Defined on the Calibration, Analyzer Single Component family.
     • Calibration, Discrete: Defined on the Calibration, Discrete family.
     • Calibration, Functional Test: Defined on the Calibration, Functional Test family.
     • Calibration, Weight Scale: Defined on the Calibration, Weight Scale family.
• Configure GE Digital APM to Create Confirmations from Inspection Event Records
  1. Set the following baseline datasheets as the default datasheets on the Inspection Event families:
     • Bundle Inspection SAP Integration: Defined on the Bundle Inspection family.
     • Bundle Sub-Inspection SAP Integration: Defined on the Bundle Sub-Inspection family.
     • Visual Inspection SAP Integration: Defined on the Full Inspection family.
     • General Inspection SAP Integration: Defined on the General Inspection family.
     • Pressure Test Inspection SAP Integration: Defined on the Pressure Test Inspection family.
     • Pressure Test Sub-Inspection SAP Integration: Defined on the Pressure Test Sub-Inspection family.

The query Get Tasks for Work Order Generation is used to determine which Task records to use to create Orders in SAP.

1. Access the Catalog page.
2. In the left pane, select Public, then select Meridium, then select Modules, then select SAP Integration Interfaces, and then select Queries.
   A list of queries appears.
3. Select the Get Tasks for Work Order Generation query.
   The workspace appears.
4. Select Design.
5. Modify the query to meet at least the following requirements:
   • Contains the following column:
     • Field: ([Task].[Next Date]-[Task].[Call Horizon])
     • Alias: Expr
     • Criteria (>=(? :d :caption='Last Successful Execution Date': id=LAST_DATE) AND < Now())
   • Includes at least one field from the source family record.

1. Access the APM Connect page.
   The APM Connect Configuration page appears.
2. Select EAM Settings.
   The EAM Settings page appears.
3. In the Scheduling Properties section, select Edit Schedule.
   Note: If there is a previously scheduled item, a schedule summary will be displayed next to the Edit Schedule button. If there is no scheduled item, Not scheduled appears next to the Edit Schedule button.
4. In the Edit Schedule window, select the Recurrence check box.
5. In the Time Zone box, select the appropriate time zone.
6. In the Start box, select to schedule the start date and time.
   1. Select one of the following as appropriate:
      • The current date: Select this option to use the current time and date as the starting point.
      • Clear: Select this option to clear the current selection.
      • <Date>: Select this option to use the selected date as the start date.
   2. Select , and then select the appropriate time.
   3. Select Close.
7. In the Every section, in the Interval box, enter the numeric value for how often you want the work order generation to occur.
8. In the Every section, in the Units box, select the interval unit (that is, minutes, hours, years, etc.).
9. In the Every section, in the Begin box, select one of the following:
   • From start time: Select this option to start the recurrence from the previously selected start time.
   • After last occurrence: Select this option to begin the generation after the last time the job ran.
10. In the End box, based on when you want the recurrence to end, select one of the following:
    • Never: If you select this option, the recurrence will not end.
    • After: If you select this option, you will enter a number of occurrences after which the generation will end.
    • Time & Date: Select this option to use the calendar to select a time and date when the generation will end.
11. Select OK.

    The schedule summary appears next to the Edit Schedule button. Additionally, the scheduled item can be viewed in the Scheduling feature in Operations Manager.

1. Access the GE Digital APM application.
2. In the upper-right corner of the page, select and search for the CMMS Classification Type record representing the item whose classifications you want to extract (i.e., Equipment or Functional Location).
3. Select a record from the list.
4. Select the Details tab.
5. Optional: For each Classification whose Characteristics you want to extract, in the right column of the Classification for Class Type grid, select the Extract From CMMS System check box.
6. Optional: If you want to stop extracting all Characteristics for a Classification, clear the Extract From CMMS System check box for the Classification.
7. Select .

   The CMMS Classification records are saved.

1. Open the CMMS Classification record representing the Classification whose Characteristics you want to extract. To do so, either:
   • Open the specific record in Record Manager.
   • Open the master CMMS Classification Type record to which it is linked, and then view the CMMS Classification record in the grid on the datasheet.
2. Select .
3. Optional: In the grid on the CMMS Classification datasheet, in the row for each Characteristic that you want to extract, select the Extract From CMMS System check box.
4. Optional: If you want to stop extracting a Characteristic, clear the Extract From CMMS System check box for the Characteristic.
5. Select .
   The CMMS Characteristic records are saved.
6. Commit the configuration by running the Static Data job.
   The Characteristics to extract have been identified.