PowerConnect for SAP Data Services Agent Configuration

Configuration Steps

The agent configuration is stored a properties file located in the directory configured during the installation steps e.g.

$BOBJ_HOME/tomcat/conf/powerconnect.properties

The configuration file can be modified using the PowerConnect for SAP Data Services UI. The steps to configure the agent consist of:

• Applying a license key for the agent to start collecting data

• Applying the PowerConnect user credentials created during the pre-installation steps

• Setting the JMX RMI URL from the pre-installation steps

• Configuring an outbound connection

• Enabling the various extractors to collect data

These can be achieved by following the steps below:

Applying a License Key

• Login to the PowerConnect Agent UI by browing to: http(s)://cmchost:port/powerconnect-java/index.html
  e.g. http://localhost:8080/powerconnect-java/index.html

• Click Administration in the menu on the left and enter the License key
  

  

• Click Save

• The license details should be displayed

• The license key is now applied

• Restart the PowerConnect Agent (only required the first time the license is applied)

Applying the PowerConnect user credentials

• In the PowerConnect Agent UI click Overview in the menu on the left

• Under the Authentication section enter the PowerConnect username and password created in the pre-installation steps
  

  

  Note - The CMS System and CMS Authentication should be left at default values unless there is a problem with authentication

• Click Save

• The PowerConnect credentials have now been applied

Setting the JMX RMI URL

• In the PowerConnect Agent UI click JVM under the Extractors menu on the left

• Enter the JMX RMI URL
  

  

• Click Save

• Click Administration in the menu on the left and click the Health tab
  

  

• Under Test Connections click JMX

• The JMX Connection test should be successful
  

  

  Note - If the test fails it means the JMX RMI URL is incorrect or the PowerConnect user credentials are incorrect

• The JMX RMI URL is now configured

Creating an Outbound Connection

• To configure an outbound connection follow the configuration guide for the target platform

Enabling Extractors

• In the PowerConnect Agent UI click Overview in the menu on the left

• In the Extractors section there are various extractors that can be enabled:

  • Data Services - Job Logs: Collects Data Services batch job status and logs

  • JVM - JMX: Collects various JMX MBean metrics such as CPU usage, Heap usage, Garbage Collection and various Data Services specific metrics

  • JVM - Threads: Collects thread states, cpu usage and stack traces

  • Operating System: CPU - Operating system CPU usage (Linux only)

  • Operating System: Memory - Operating system Memory usage (Linux only)

  • Operating System: Disk Space - Operating system Disk space usage (Linux only)

  • Operating System: Network IO - Operating system Network Interface IO (Windows and Linux only)

  • Operating System: Disk IO - Operating system Disk Device IO (Windows and Linux only)

• Check the extractors required

• Click Save

• The Extractors are now enabled

Configuration Options