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), when SAP Java connector was not setup through the installation.

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.

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.
   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. Note: When supporting multiple cultures from a single source system, the value indicates the language of the culture.
   TARGET_CMMS_ID	This parameter indicates the CMMS ID that receives data and matches the value of CMMS_ID.	This value is required only when enabling multiple cultures from a single source system. Enter a unique value. Note: When supporting multiple cultures from a single source system, the value indicates the language of the culture.
   SOURCE_SYSTEM_TYPE	Identifies the type of system connecting with Predix Essentials.	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.
   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 Predix Essentials API application server name.	Enter the name of your Predix Essentials API??server.
   APM_API_USE_SSL	Specifies whether the Predix Essentials 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 Predix Essentials application server name.	Enter the name of your Predix Essentials server.
   APM_DATASOURCE	The Predix Essentials data source to which the data will be exported.	Enter the name of your Predix Essentials data source.
   APM_USERID	The Predix Essentials Framework user ID.	Enter a unique value.
   APM_PASSWORD	The Predix Essentials 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 Predix Essentials.	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.
   Planned Work Filter Criteria
   Parameters	Description	Default or Recommended Value
   MAINTENANCE_PLAN	Maintenance Plan ID number that defines the Planned Work data that you want to extract.	The Maintenance Plan ID is 12 characters. If this filter is not specified, all Planned Work data is extracted.
   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 the following value: 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. SFTP: To use standard secure FTP. WS for the Webservice Transfer.
   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 Predix Essentials 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 Predix Essentials, 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 Predix Essentials 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 Predix Essentials 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 Predix Essentials 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 Predix Essentials user name
   • APM_PASSWORD: Enter your Predix Essentials 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 default 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
   • RUN_PWORK: The Planned Work 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.

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 *.

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 Predix Essentials 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:
   • 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
7. Repeat steps 5-7 for each imported job that you plan to run.

1. Log in to Talend Administration Centre.
2. In the Job Logging Levels, select the logging levels.
   The logging levels are saved.
3. Set the JVM parameter for the logs to a specific folder.
   The APMC logs are configured.

   Note: By default log files are located in the C:\APMConnect\Logs.To facilitate the download of the APMC Logs in the Predix Essentials, the logs should be linked through APM reference document.

   Important: To customize the logs, the reference to log4j2.propertiles file is passed to the job by providing the -Dlog4j.configurationFile={path to your custom log4j2 file} as JVM parameter.

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 Predix Essentials 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 Predix Essentials Site Reference record.

     When you import records into Predix Essentials from your SAP System, its Site Reference Key will be the name of the Site as defined in the 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 SFTP to transfer files between SAP, APM Connect, and Predix Essentials, 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.
5. In the External Operation System Commands screen, select .
6. In the Definition section, in the Operating system command box, enter following systems command: pscp.
7. Select Save.

To enable secure SFTP data transfer from a Linux SAP server, you must first set up SSH.

1. Log in to the computer you are using to access the remote system, and, on the command line, enter ssh-keygen -t rsa.
2. At the resulting prompt, enter a file name and a password for the generated key.
   Alternatively, you can press Enter to generate the key into a default file: ~/.ssh/id_rsa.pub. The remainder of this procedure will reference the generated file as ~/.ssh/id_rsa.pub.
3. Enter the command SCP or SFTP to copy the key file you created in step 2 to your account on the remote system.
   For example, scp ~/.ssh/id_rsa.pub username@remoteserver:.
4. At the system prompt, enter your password.
   The system copies the key file to the account home directory on the remote system.
5. Log in to the remote system with your credentials.
6. Optional: If your account on the remote system does not contain a ~/.ssh/authorized_keys file, create one.
   For example:

   mkdir -p ~/.ssh
   touch ~/.ssh/authorized_keys

7. On the remote system, on the command line, enter cat ~/id_rsa.pub >> ~/.ssh/authorized_keys.

   The content of the generated key file is copied into a new line in the ~/.ssh/authorized_keys file. You can verify the contents of the file by entering more ~/.ssh/authorized_keys.

If you use SFTP to transfer files from a Linux SAP server, you must complete additional configuration in SAP and the SAP server operating system. This procedure describes how to create a shell script that SAP uses when transferring data to Predix Essentials.

1. In a text editor, create a file, for example, MI_SCRIPT.SH, with contents as shown in the following example.

   #!/bin/bash
   #The following 5 arguments listed are retrieved from SAP: 
   #$1	-sftp (constant)
   #$2	-pw   (constant)
   #$3	password (PLSAP_FTP_PASSWORD)
   #$4	Source file (PLSAP_INPUT+<interface>+filename.*)
   #$5	USER@HOST:
   
   arg1=$4
   arg1=${arg1/.csv.*/.csv}
   arg1=${arg1/.dat.*/.dat}
   arg1=${arg1/.dat.dat/.dat}
   arg1=${arg1/.DAT.dat/.dat}
   arg1=${arg1/.dat.DAT/.dat}
   
   sftp $5 <<EOF  
   put $arg1
   

2. Copy the file MI_SCRIPT.SH into a directory on your SAP system.
   For simplicity, you should use the SAP home path.
3. In SAP, run the transaction code SM69.
4. In the External Operation System Commands screen, select .
5. In the Definition section, in the Operating System Command box, enter a value based on the following table.

   Location of the script	Value of Operating System Command
   The script is in the SAP home path	MI_SCRIPT
   Some other location	The full file path, for example, /home/h8sadm/scripts/MI_SCRIPT.SH

6. Select Save.

You can establish data transfer using Web Services by creating RFC Destination in SAP. If you use Web Services to transfer data between SAP and APM Connect, you must complete additional configuration steps in SAP.

1. In SAP, run the transaction code SM59.
2. In the RFC Connections screen, select HTTP Connections to External Server, and then select to create RFC Destination.
3. In the RFC Destination box, enter APMCONNECT.
   Note: To give a different name, job customizations can be done in the APM Connect server.
4. Select the Technical Settings tab, in the section that appears enter the values:
   • Target Host: Enter the server name where the EAMFileReciver service is deployed.
   • Service No.: Enter the port number of the EAMFileReciver service.
   • Path Prefix: Enter one of the following values:
     • If you are not using SAP PI/PO: /services/EamFileReceiver
     • If you are using SAP PI/PO:
       • For Advanced Adapter Engine (AAE): /XISOAPAdapter/MessageServlet?senderParty=&senderService= GE_APM_SAP &receiverParty=&receiverService=&interface=EAMFileReceiver_Out&interfaceNamespace=urn:ge.com:SAP:EamFileReceiver
       • For non-Advanced Adapter Engine (AAE): /sap/xi/engine?type=entry&Sender.Service=GE_APM_SAP&Interface=urn:ge.com:SAP:EamFileReceiver^EamFileReceiver_out
     Note: GE_APM_SAP is the default Sender Service name in SAP PI. If you are using a different service name, update the Sender Service value accordingly.
5. In the Logon & Security tab, select one of the following:
   • Basic Authentication: Select if you are using SAP PI.
   • Do Not Use a User: Select if you are not using SAP PI.
6. Select Save.

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\ARC
   • FLOC\ARC
   • PWORK\ARC
   • TC_EQUI\ARC
   • TC_IFLOT\ARC
   • WMI\ARC
   • WORKHISTORY\ARC

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 700_600 and the level is 0000 and above, proceed directly to step 16. Otherwise, proceed to the next step.
   • For S/4 Hana, if your currently installed ABAP??release is 700_600 and the level is 0000 and above, 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 files.
   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, as seen in the following image, 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 installation progress indicator appears.

    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 files.
    Note: For the Dual ABAP package, these folders reside under \\SAP Interfaces ABAP Add-On\Support Pack Files\Dual Pack - V36 & V4.
18. On the SAP Server, paste the copied files 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: 700_600
     • S/4 Hana: 700_750
   • Level:
     • ECC6: 0002 (GE APM Integration Interfaces SP 7 - 0001)
     • S/4 Hana: 0002

   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.

This procedure describes how to uninstall the ABAP Base Service Pack Add-on.

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 Installation Package > Load packages > From Application Server
4. Select Yes.

   In the SAINT: Uploading Packages from the File System, the Message Text column of the row corresponding to the .pat files that you originally copied displays Uploaded successfully.

5. In the SAINT: Uploading Packages from the File System window, select
6. In the Add-On Installation Tool, select Uninstallable components, then select MIAPMINT or MIAPM, and then selectContinue.
7. In the Start options window, select Default options.
8. 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.
9. Select Finish.

To successfully transfer data between Predix Essentials 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_BEGRP	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	RFC_PING
      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/*	CRHD	JEST	PRPS	T353I_T	TGSBT
      AFVV	CRTX	JSTO	QMEL	T356_P	TJ02
      AFKO	CSKT	KLAH	QMFE	T356_T	TJ02T
      AFRU	CVERS	KSML	QMMA	T357	TJ30
      AFVC	EAPL	KSSK	QMUR	T357A_T	TJ30T
      AFVV	EQBS	MAKT	QPCT	T357M_T	TKA01
      AUSP	EQKT	MHIS	SWOR	T370C_T	TQ80
      BGMKOBJ	EQUI	MHIO	T001	T370F_T	TQ80_T
      CABN	EQUZ	MMPT	T001W	T370K_T	VIAUFKST
      CABNT	IFLO	MPLA	T003P	T370U	VIQMEL
      CAWN	IFLOS	OBJK	T006	TAPL	VIMPLA
      CAWNT	IFLOT	PLAS	T006A	TCLA	VIMPOS
      COBK	IFLOTX	PLKO	T024I	TCURC
      COEP	ILOA	PLPO	T350	TCURR
      COVP	INOB	PMCO	T352B_T	T499S

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 Predix Essentials 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 Predix Essentials.

The SAP Interfaces feature allows you to create Recommendation records in Predix Essentials 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 Predix Essentials, thereby avoiding RFC calls directly between Predix Essentials and your SAP server. Complete these steps to deploy and configure the files necessary to enable this connection.

1. On the APM Connect server, navigate to folder <root:>\APMConnect\Config.
2. Copy the file connectServices.cfg to folder <root:>\APMConnect\Utilities\runtime\etc.
3. Edit the file and provide these values for the listed parameters.

   Parameter	Value
   context	Default
   IR_HOST	IP address of the system containing the Intermediate Repository.
   IR_PORT	Port number of the system containing the Intermediate Repository.
   IR_DATABASE	The database that contains the Intermediate Repository.
   IR_SCHEMA	The schema that defines the Intermediate Repository.
   IR_USERID	The userid to access the Intermediate Repository.
   IR_PASSWORD	The password associated with the userid that accesses the Intermediate Repository.
   LOG_REQUEST	false
   LOG_RESPONSE	false

4. Save the file.
5. Access the APM Connect installation package, and then copy the file connectorServices.jar.
6. On your APM Connect server, navigate to <root:>\APMConnect\Utilities\runtime\deploy.
7. Optional: If you already have an existing connectServices.jar file, delete it before copying the new file into the directory.

You can configure the priority value in Predix Essentials 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 Predix Essentials.

1. Create a new EAM System record.
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 Predix Essentials 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://myhost.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 Name.

1. In the Predix Essentials 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.
   Note: For ServiceMax, this job is called CreateIntermediateRepository_ServiceMax.
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 Predix Essentials Task records and Event records for Inspection and Calibration, you will need to configure the datasheets used as the default datasheet.

• Configure Predix Essentials 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 Predix Essentials 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 Predix Essentials 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.

1. In the SAP system, run the following transaction: /n/MIAPM/MIPRO.
   The Display IMG screen appears.
   
   
2. In the tree, expand Configurations In SAP.
3. Select Maintain GE Digital APM Parameters.
   The Meridium Configuration and Connection Parameters Management window appears.
   
   
4. In the APM Data Source column, enter the APM data source(s) from which and to which you want to transfer data.
5. In the APM Application Server, enter your GE Digital APM Application server(s).
6. Select .
   The Meridium Configuration and Connection Parameters Management window closes.
7. In the Maintain Task Configuration Parameters row, select .
   The Task Configuration screen appears.
   
   
8. In the APM Data Source list, select the GE Digital APM data source for which you want to identify which Operation values will create which Task records.
   Note: When defining the data sources, you must maintain the value for the App Server field.
9. Select .
   The Display View "Meridium Task Configuration Table": Overview screen appears. The following image illustrates the baseline table in an SAP system whose Client number is 000. Notice that there are two rows: one for Calibration Task records and one for Inspection Task records. This image illustrates a configuration in which Operations with the control key ZMI2 are used to create Calibration Task records, and Operations with the control key ZMI1 are used to create Inspection Task records.
10. To specify criteria that will be used to trigger the creation of Calibration Task and Inspection Task records, modify the values in the existing rows, or build on top of the current functionality by adding new rows. This documentation assumes that you are familiar with your SAP data structure and that you know how to define the criteria to achieve the desired result.
11. Select .
    The criteria is saved.

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 Predix Essentials 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.