Administer

Access the APM Connect Administration Center

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.

Procedure

  1. Open a web browser, and then enter the following URL into your web browser: http://localhost:8080/apmconnect/.
  2. In the Login window, in the Password box, enter admin, and then select OK.
  3. Select .

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

    Important: If your license does not validate as shown in the previous image, you can validate your license manually.
  4. If your license validates, in the Database parameters window, select Go to login page.

    The Login page appears.

  5. In the Login window, enter the required information and then select Login.
    • In the Login box, enter the default username: [email protected].
    • In the Password box, enter the default password: admin.

Results

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

Configure the APM Connect Administration Center

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

About this task

Depending on whether you are using the EAM Adapters or the Data Loaders, configuring the APM Connect Administration Center requires defining parameters for some or all of the following components: Commandline, Job conductor, Monitoring, and Log4j.

Procedure

  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.
    ParameterDescriptionRecommended or Default Value
    Generated jobs folderThe path to the folder with the Job execution archives. C:\APMConnect\Logs\generated_jobs
    Tasks logs folderThe 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.
    ParameterDescriptionRecommended or Default Value
    Technical file appenderThe 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 appenderThe host and port corresponding to the Logstash instance.localhost:8050

Results

The APM Connect Administration Center parameters are configured.

APM Connect Connection Records

The APM Connect workspace stores information about connections used by APM Connect. Specifically, it manages the connection between GE Digital APM and APM Connect components. This topic provides an alphabetical list and description of the fields that exist in the APM Connect workspace. The information in the table reflects the baseline state and behavior of these fields.

General Setting

Field

Data Type

Description

Behavior and Usage
Application ServerStringThe name of your GE Digital APM server. Enter the name of your GE Digital APM Server to establish your connection to your APM Connect Server.
Connection StringStringThe URL indicating the APM Connect server host and port used to connect GE Digital APM and the APM Connect sever.

This field is required.

The connection string is a combination of the APM Connect Connection parameters APM_CONNECT_HOST and APM_CONNECT_PORT as defined in the context file.

For example, if the host was apmconnect and the port was 8040, the connection string would be http://apmconnect:8040/.

Note: This string is used by the file SAP_ConnectorService.jar.
Integration ServerStringThe location of the server where the Integration Services is installed.This field is required.
Maximum Concurrent DL and EAM JobsNumericThe number of Data Loading jobs or EAM jobs that can run at the same time.This field is required. The default value is 1. This means that only one job can run at a time. The maximum value allowed is 5. When the number of concurrent jobs is low, data ingestion into GE Digital APM is faster and the system is less likely to become overloaded.
Note: Two Data Loaders of the same type are not allowed to run at the same time. For example, if you initiated two Taxonomy data loads at the same time, the second job would not begin loading until the first is complete regardless of the value in the field.
PasswordStringThe password for the APM Connect network.This field is required only if you are using network authentication.
Password

String

The password of the proxy server.This field is required only if you are using proxy server authentication.
Port StringThe port number of the PostgreSQL server.The default value is 5432. This value must match the value specified for the IR_PORT parameter in the context file.
Proxy ServerStringThe location of the proxy server.This field is required only if you are using proxy server authentication.
Timeout (ms)NumericThe time in milliseconds before the connection between the APM Connect server and GE Digital APM will timeout.The default value is 100,000 ms, and is populated automatically.
Use AuthenticationBooleanIndicates whether or not authorization will be used.If the check box is selected, authentication will be used, and you must enter the network user name and password.
Use Proxy ServerBooleanIndicates the whether or not to use a proxy server.If the check box is selected, the proxy server will be used.
Use Proxy Server AuthenticationBooleanIndicates whether or not authentication will be used to the proxy server.If the check box is selected, authentication will be used for the proxy server.
UsernameStringThe user name for the APM Connect network.This field is required only if you are using network authentication.
UsernameStringThe user name for the proxy server.This field is required only if you are using proxy server authentication.

Data Loader Settings

FieldData TypeDescriptionBehavior and Usage
Base File PathStringThe path to the file server.

This field is required.

An example of a valid server path is \\hostserver\share\subfolder. If an invalid server path is entered, an error message will appear.

Database NameStringThe database name of the Data Loader staging (IR) database.None.
Host NameStringThe host name of the Data Loaders staging (IR) database.None.
Logging LevelStringDetermines the logging level for the data loader logs.

The following logging levels can be selected:

  • Debug: The default logging level, and the highest level of logging. Selecting debug will return the most details and is helpful when trying to debug the application.
  • Info: Returns information message indicating the progress of the application, and is the second highest level of logging.
  • Warn: Returns warnings detected during the loading process.
  • Error: The lowest level of logging returning errors only.
Notes:
  • Logging levels are hierarchical. For example, if you select Info, you will see all warnings and errors. If you select Error, you will only see errors.
  • If you are loading a large amount of data, you should use logging level Warn or Error to improve performance, unless debugging a problem.
PasswordStringThe Data Loader staging database (IR) password.None.
PasswordStringThe password of the file server.None.
Use File Path AuthenticationBooleanIndicates whether or not to use authentication when accessing the file server.If selected, authentication will be used for the file path.
UserNameStringThe Data Loader staging database (IR) user name.None.
UsernameStringThe user name of the file server.None.

EAM Settings

FieldData TypeDescriptionBehavior and Usage
Work Order Generation Schedule BooleanStores the scheduling mechanism for transferring work orders to SAP.To determine the schedule, you must schedule work orders.

Set User Permissions

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.

Before you begin

A user must be authorized for a project before they can view or change sections associated with a project.

Procedure

  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.
    RoleRead Permissions by ModuleWrite Permissions by Module
    AdministratorNone.License, Configuration, Users, Projects, Rights Management, Backup, Notifications, Software Updates
    Operations ManagerProjects, 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
    DesignerConfiguration, Projects, Servers, Job Conductor, EBS Conductor, EBS Conductor, EBS Publisher, Execution Plan, MonitoringExecution Plan, Audit, BRMS (Drools), Service Locator
    ViewerServers, Job Conductor, Execution Plan, Audit, Studio, RepositoryNone.
  5. Select Validate, and then select Save.
  6. Select .

Results

The user permissions are set.

Authorize Users for Projects

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.

Procedure

  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.

Configure Logging

APM Connect uses log4j version 1.2 to log events and provides a default configuration for logging events. These steps describe how to modify this default configuration.

Procedure

  1. On the APM Connect Server, navigate to the folder C:\APMConnect\Config.
  2. Open the file log4j.properties in an application that you can use to modify a text file (for example, Notepad).
  3. Modify the log4j.rootLogger statement to select the correct severity level and appender. Consider the following example of a modified statement:
    log4j.rootLogger=ERROR, fileout

    ...where the first value is the severity level and the second value is the appender to use. You can enter any of the following values as the severity level:

    • TRACE
    • DEBUG
    • INFO
    • WARN
    • ERROR
    • FATAL
    • OFF

    The severity level that you configure controls the messages written to the log. Each severity causes the system to filter messages above that type in the preceding list.

    Note: The appender value must be either fileout or consoleout.
    Important: To collect the most complete information, do not change the conversion pattern on any appender you use.
  4. Modify the log4j.logger.org.apache.cd statement to log the Web Service request and response messages. The format is similar to that previously shown for log4j.rootlogger.
  5. Modify the log4j.logger.org.apache.activemq statement to enable the logging levels for ActiveMQ messages. The format is similar to to that previously shown for log4j.rootlogger.
  6. If you use the console appender, uncomment all statements containing consoleout and comment the statements containing fileout. Consider the following example:
    # consoleout is set to be a ConsoleAppender.
    log4j.appender.consoleout=org.apache.log4j.ConsoleAppender
    log4j.appender.consoleout.Threshold=DEBUG
    log4j.appender.consoleout.layout=org.apache.log4j.PatternLayout
    log4j.appender.consoleout.layout.ConversionPattern=[%-5p][%d{dd MMM yyyy HH:mm:ss}][%t][%c][%M] %x - %m%n
    #fileout uses fileAppender
    #log4j.appender.fileout=org.apache.log4j.RollingFileAppender
    #log4j.appender.fileout.Threshold=debug
    #log4j.appender.fileout.MaxFileSize=1MB
    #log4j.appender.fileout.MaxBackupIndex=2
    #log4j.appender.fileout.File=${LOG}/${LOG_FILE}
    #log4j.appender.fileout.Append=true
    #log4j.appender.fileout.layout=org.apache.log4j.PatternLayout
    #log4j.appender.fileout.layout.ConversionPattern=[%-5p][%d{dd MMM yyyy HH:mm:ss}][%t][%c][%M] %x - %m%n
    Note: When configuring logging for SAP or SAP PI, you must specify the actual path to the log file as the value of log4j.appender.fileout.file.
  7. If you use the file rolling appender:
    1. Modify the log4j.appender.fileout.MaxFileSize value to the appropriate size for your installation.
    2. Modify the log4j.appender.fileout.MaxBackupIndex value to the number of log files you want to keep.
  8. Save the file.

    Event logging has been configured.

Configure Source System Custom Field Mappings or Default Values

There may be times when you need to either map values from GE Digital APM to your source system or add a default value for a field in your source system from GE Digital APM. This topic describes how to achieve this goal.

Before you begin

To successfully perform this task, you must have the following:

  • Administrative rights to the APM Connect database from which you are retrieving the field values or setting the default values.
  • A database tool, such as DBeaver or DBVisualizer.

About this task

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

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

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.

Procedure

  1. Using a database tool, navigate to the GE Digital APM 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 configureHow to configure
    Field mapping

    In the apm_field_name column, enter the name of the GE Digital APM 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 GE Digital APM field CurrentUserID, the table would resemble the following when you complete your update.example of mapped field

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

Results

Your source system mappings or default values are configured.

Configure the APM Connect Administration Center for the Studio

About this task

Important: This step is required only if you have the APM Connect Studio license. If you are deploying APM Connect Base with a Basic or Plus License, skip this procedure.

Procedure

  1. Open a web browser.
    Tip: APM Connect is most compatible with Google Chrome or Mozilla Firefox web browsers. It is not recommend using Internet Explorer to access the APM Connect Administration Center.
  2. Enter the following URL into your web browser: http://localhost:8080/apmconnect/.
  3. If prompted, log in to the APM Connect Administration Center.
  4. In the Menu pane, in the Settings section, select the Configuration tab.

    The Configuration pane appears.

  5. Select the CommandLine/primary (5 Parameters) group to expand the workspace.
  6. According to recommendations in the information in the following table, enter the necessary parameters.
    ParameterDescriptionRecommend or Default Value
    Host The IP address of the CommandLine.localhost
    PortThe port number on which the CommandLine is queried.8002
    Job generation folderThe path to the folder where Jobs are generated. <root:>\APMConnect\Utilities\cmdline\generationCache
    User component pathThe path to the folder where user components are stored.<root:>\APMConnect\Utilities\cmdline\custom_components
    The default parameters are configured as shown in the following image.

Install the Studio

About this task

Important: This step is required only if you have the APM Connect Studio license. If you are deploying APM Connect Base with a Basic or Plus License, skip this procedure and proceed to the next step in the APM Connect Base deployment workflow.

Procedure

  1. On the machine on which you installed APM Connect, access the Talend Studio installation package.
  2. Open the file TalendStudioInstall.exe.
  3. In the Setup-Talend Studio window, select Next.

    The License Agreement window appears.

  4. Read the entire license agreement, and then select one of the following options:
    • I accept the agreement: If you agree to the terms of the license agreement and want to continue. These instructions assume that you want to continue.
    • I do not accept the agreement: This option is selected by default. If you do not agree to the terms of the license agreement and do not want to continue, select Cancel to exit the installer.
    Next is enabled.
  5. Select Next.

    The Select Destination Location screen appears.

  6. Select Next.

    The Select Components screen appears.

  7. Select the Add Start Menu Entry box, then select the Add Desktop Icon box, and then select Next.
  8. Select Next.
  9. In the Select Start Menu Folder window, select Next.
  10. In the Ready to Install window, select Install.

    The Installing screen appears, displaying an installation progress bar.

  11. When the installation completes, in the Completing the Talend Studio Setup Wizard window, select Finish.

Results

The installation is complete, and Talend Studio desktop icon is available.

Deploy Data Loaders or Adapters

After configuring APM Connect, you must deploy the adapters or data loaders you need.

The process for deploying and configuring the data loaders and the various adapters are described in the sections devoted to the APM Connect data loaders or the other adapters.

Access APM Connect EAM Jobs

Procedure

In the module navigation menu, select Admin > Operations Manager > APM Connect EAM Jobs.

The APM Connect EAM Jobs page appears.

Access the Details of an EAM Job

Procedure

  1. In the module navigation menu, select Admin > Operations Manager > APM Connect EAM Jobs.
  2. In the Status and Log column, view the status of each job.
    Tip: If necessary, you can cancel an import job by selecting the button that appears in the Status and Log column. If you cancel a job, any changes that have already occurred are not removed, therefore, you may need to manually modify records to update or remove unnecessary data.

    Status

    Description

    Waiting

    Initial state when job is created. The data import job is queued for pre-processing on the APM Connect Server.

    Staging In Progress

    The data import job is being prepared on the APM Connect Server.

    Staging Failure

    The data import job failed during preparation.

    Staging Complete

    The data import job was prepared successfully.

    Dataloader Enqueued

    The maximum number of data load jobs has been exceeded, as determined in the APM Connect Connection Records, or there is a job of the same type running. The data import will begin once the other jobs are complete.

    Configuring Dataloader

    The data import job is configuring the proper user roles and arranging data processing for most efficient execution flow.

    In Progress

    The data import job is loading data into the GE Digital APM Data Source.

    Data Synchronization in Progress

    The data import job is synchronizing the loaded data and relationships across the APM Data Source.

    Job Cancelling

    The data import job is in the process of being canceled. This occurs after you select .

    Cancelled by User

    The data import job was cancelled successfully.

    Note: When a job is cancelled, the data imported prior to cancelling is not removed.

    Errors

    The data import is complete, but encountered one or more errors. You can download the log file to view detailed error messages.

    Complete

    Data has been imported into GE Digital APM.

    Note: If the icon appears, the data was imported with warnings. You can download the log file to view detailed warning messages.
  3. In the Status and Log column, select on the row corresponding to the EAM job for which you want to access the log.

    The log file is downloaded.

  4. To access the Interface Log record for a specific job, in the Job ID column select the job ID that you want to open.

    The Record Manager page appears, displaying the datasheet for the selected job.

  5. To view the information contained in the Log Text, select the
    Log Text

    A window appears, displaying details about the job such as error messages, warnings concerning the data load, and general information regarding the data records that were loaded.

Delete a Job

When upgrading in a cloud environment or an adapter, you have to delete the old adapter job before installing the new job.

Procedure

  1. Access the APM Connect Administration Center.
  2. In the Menu pane, in the Conductor section, select Job Conductor.

    The Job Conductor workspace appears.

  3. In the Job Conductor workspace, select the job you want to delete, and then, at the top of the workspace, select .

Results

The job is deleted.

Access the APM Connect Page

Procedure

In the module navigation menu, select Admin > Operations Manager > Connections., and then select APM Connect.
The APM Connect workspace appears.

Establish Connection from GE Digital APM

About this task

To load data into GE Digital APM using the APM Connect Data Loaders or the EAM Adapters. You must establish the connection between your APM Connect component and GE Digital APM.

Procedure

  1. Access the APM Connect page.

    The APM Connect Configuration workspace appears.

  2. In the APM Connect Configuration workspace, configure the parameters on the APM Connect Connection record in the following sections.
    • General Settings: Established the connection between the APM Connect server and GE Digital APM.
      Important: The General Settings section must be configured if you are using either the Data Loaders or the EAM adapters.
    • Data Loaders Settings: Stores the staging database parameters and the remote file server settings.
    • EAM Settings : Used to schedule work orders, which determine how frequently work orders will be transferred to your SAP.
      Note: These settings are only required for the SAP adapters.
  3. Select Save.

Results

The connection between APM Connect and GE Digital APM is established.

Determine Logging Level

Procedure

  1. Access the APM Connect page, and then select Data Loaders settings.

    The Data Loaders Settings workspace appears.

  2. In the Logging Level box, use the drop-down to select one of the following logging levels:
    • Debug: The default logging level, and the highest level of logging. Selecting debug will return the most details and is helpful when trying to debug the application.
    • Info: Returns information message indicating the progress of the application, and is the second highest level of logging.
    • Warn: Returns warnings detected during the loading process.
    • Error: The lowest level of logging returning errors only.
    Notes:
    • Logging levels are hierarchical. For example, if you select Info, you will see all warnings and errors. If you select Error, you will only see errors.
    • If you are loading a large amount of data, you should use logging level Warn or Error to improve performance, unless debugging a problem.
  3. Select Save.

    The record is saved.

Results

Once the record is saved, subsequent data loads will return log files with the logging level you determined. The logging level will only apply to future data loads. Meaning if you change the level from Error to Warn historic log files will not be updated with more details. It will only apply to new data loads.