Admin

Using the APM Connect Administration Center, you can run extraction and load jobs. Before you can begin running jobs, you must set up the APM Connect Administration Center. This topic explains how to access and deploy the APM Connect Administration Center for the first time.

1. Open a web browser, and then enter the following URL into your web browser: http://localhost or hostname provided:8080/apmconnect/.
2. In the Data Parameters window (if it appears, refer to the Step 3), in the Password box, enter postgres, and then select OK.
3. If the TAC license file was not provided during the install step you will get the Database Parameters window to setup the license. If already provided you will get the APM Connect Login Page (Check step 5).
4. Select .

   The Database parameters window appears, and a check is performed by the APM Connect Administration Center.

5. If your license validates, in the Database parameters window, select Go to login page.

   The Login page appears.

6. In the Login window, enter the required information and then select Login.
   • In the Login box, enter the default username: admin@company.com.
   • In the Password box, enter the default password: admin.

   The APM Connect Administration Center is successfully deployed, and the APM Connect Administration Center Welcome page appears.

7. Add an APM Connect Service User using the following steps:
   1. Select Users in the Menu Pane, and then select Add.
   2. Add the following information:
      • Login ID – preferably an e-mail id. For example, apmc@company.com
      • First Name and Last Name – Add an identifier name
      • Password – Preferably admin or user defined
      • Type – Data Integration/ESB
      • For the Role select all the roles except Auditor
   3. Select Save.
8. Logout of the APM Connect Administration Center and then log back in as the Service user that you setup in Step 7 (For example, apmc@company.com/admin).
9. Select a Project on the Welcome page.
   Note: If no project is displayed you can add a new project titled APMCONNECT_UNIFIED_PLATFORM with Project Type value set as Data Integration/ESB and Storage value set as None.
10. In the Menu pane select Project Authorizations
    
11. In the Project section select the project APMCONNECT_UNIFIED_PLATFORM, and provide the Read and Write access to the newly created service user.
12. In the Menu pane select Servers to check the execution server details.
13. If no Server is displayed, then add a server with Label value set as JobServer and other values configured as shown below:
    
14. Select Save.
15. In the Menu pane select Job Conductors to check if any jobs are deployed.
    Note: If jobs are not deployed then the APM Connect jobs provided need to be deployed manually.

This topic describes how to configure the APM Connect Administration Center.

1. If you are not already in the APM Connect Administration Center, access it via http://localhost:8080/apmconnect/.
2. If prompted, log in to the APM Connect Administration Center.
3. In the Menu pane, in the Settings section, select the Configuration tab.

   The Configuration pane appears.

4. Select the Job conductor (7 Parameters) group to expand the workspace.
5. Using the following table as a guide, enter the recommended parameters.
   Note: You can accept the default values of parameters not listed in the table. Make sure that the folders already exist.

   Parameter	Description	Recommended or Default Value
   Generated jobs folder	The path to the folder with the Job execution archives.	C:\APMConnect\Logs\generated_jobs
   Tasks logs folder	The path to the folder with the Job execution logs.	C:\APMConnect\Logs\execution_logs

6. Select the Servers group to expand the workspace.
7. In the workspace, select Add, and then select Add Server.
8. In the Execution server section, configure the server.
   1. Enter the name of the administrator host in the Label:, Description:, and Host: boxes.
   2. Select the Meridium Runtime check box.
   3. Select Save.
      The server configuration is saved.
   4. Select the server you just added to verify the configuration.
      All of the server indicators should be green.
9. Select the Monitoring (2 Parameters) group to expand the workspace.
   Note: Configuring this parameter is optional.
10. Select the Log4j (4 Parameters) group to expand the workspace.
11. Using the following table as a guide, enter the necessary parameters.

    Parameter	Description	Recommended or Default Value
    Technical file appender	The path to the technical log file of the APM Connect Administration Center.	C:/APMConnect/Utilities/Tomcat/logs/technical.log
    Technical log threshold	The level of logs you want to append.	WARN
    Business log file path	The path to the business log file of the APM Connect Administration Center.	C:/APMConnect/Utilities/Tomcat/logs/business.log
    Technical logstash appender	The host and port corresponding to the Logstash instance.	localhost:8050

Before a user can begin work on a specific project, that user must be authorized to work on that project. Each project can have multiple users with differing roles. Users can also be authorized for multiple projects. This topic explains how to authorize a user for a project.

1. In the Menu pane, in the Settings section, select Project authorizations.

   The Project Authorizations workspace appears displaying the Project section which lists all the projects to which you can add users and the User Authorizations for the Project: <name> section which lists all users that can be added to the project.

2. From the Project list, select the project to which you want to add a user.
3. To give a user read permissions only, in the Right column in the row for that user, select the button.
4. To give a user read and write permissions, in the Right column in the row for that user, select the button.
   Tip: The icons in the Right column will be appear in a lighter color if the user is not authorized for a specific action, and be colored if the user has the required permissions.

   The user is now authorized for the project.

To begin using the APM Connect Administration Center to run data extractions, or Jobs, you must first give the admin user all the user roles.

1. In the Menu pane, in the Settings section, select the Users tab.
2. Select the user that you want to be the administrator.

   The Data section is activated.

3. In the Data section, next to the Role: box, select .
4. In the Role Selection window, select each check box to assign the user all roles, or select the box of the role(s) you want to assign the user, based on the following table:
   Important: To access the Job Conductor, you must designate at least one user the role of Operation Manager.

   Role	Read Permissions by Module	Write Permissions by Module
   Administrator	None.	License, Configuration, Users, Projects, Rights Management, Backup, Notifications, Software Updates
   Operations Manager	Projects, EBS Publisher, Service Activity Monitoring, Authorization, Service Registry, Studio, Repository Browser	Configuration, Lock, Notifications, Servers, Job Conductor, ESB Conductor, Execution Plan, Monitoring Audit BRMS (Drools), Service Locator
   Designer	Configuration, Projects, Servers, Job Conductor, EBS Conductor, EBS Conductor, EBS Publisher, Execution Plan, Monitoring	Execution Plan, Audit, BRMS (Drools), Service Locator
   Viewer	Servers, Job Conductor, Execution Plan, Audit, Studio, Repository	None.

5. Select Validate, and then select Save.

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.

APM Connect documents a baseline set of fields that are considered standard in the APM to SAP Notification Creation integration with SAP. Additionally, there is capability to configure these and other fields to be included in the Notification Creation process. For information on the available fields to add to mapping, refer to the List of attributes that can be added to Notification Creation from APM to SAP topic. This topic describes how to configure additional baseline fields or make changes to default values.

About This Task

There are times when you need to have information that is stored in Essentials displayed in your source system database. To achieve this goal, you need to modify tables used by Essentials to send data to your source system.

Note: If Custom field mappings are needed, or fields that are not in this list, customization options exist with our Integration Center of Excellence engagement process.

The following procedure describes how to either configure a mapping between Essentials and your source system or to set a default in your source system from Essentials.

The following image is an example of the southbound_mapping_control table as displayed by a database tool.

Note: This feature is not available for creating work orders.

1. Using a database tool, navigate to the Essentials database you want to configure.
2. In the database navigation, in the Tables folder, select southbound_mapping_control.
3. Navigate to the target_field_name and target_field_map_name column you want to configure.
4. Configure the field mapping or default value for your source system.

   Item to configure	How to configure
   Field mapping	In the apm_field_name column, enter the name of the Essentials field that contains the value to apply in the source system, and then set the value in the mapping_enabled column to true For example, if you want to set the source system value of REPORTEDBY in map table REPORTEDBY_NOTIFHEADER from the Essentials field CurrentUserID, the table would resemble the following when you complete your update. Important: If, after configuring the mapping, you see a blank value for the field, make sure the value you entered in the apm_field_name column is correct.
   Default value	In the target_field_default column, enter the value you want to be the default in your source system and set the value in the mapping_enabled column to false.