KB 085 – SAP PowerConnect Java installation instructions v1.2
SAP PowerConnect Java Installation Instructions
Introduction
This document details the installation instructions for the SAP PowerConnect Java monitoring agent.
Prerequisites
SAP PowerConnect Java has the following requirements:
- SAP NetWeaver 7.3 and above
- 100 MB free disk space
- Administrator access to the SAP NetWeaver system
Installation
The installation has the following high level steps:
- Installation of the software
- Sap PowerConnect Java monitoring agent
- Sap PowerConnect configuration GUI
- Configuration of Splunk
- Initialization of database table to store configuration
- Granting JMX security permissions
- Configuration of Sap PowerConnect Agent
Installing the Sap PowerConnect Java monitoring agent
To install the Sap PowerConnect Java monitoring agent perform the following steps:
- Acquire the PowerConnect agent from file from sap-powerconnect-java-X.X.sca BNW
Consulting - Deploy the .SCA using SAP Software Update Manager (SUM)and ensure its listening
on port 1129
Open a browser and connect to theJava SUM control page
https://<host>:1129/lmsl/sumjava/P75/index.html
Enter <sid>adm credentials
Point SUM to the directory containing the PowerConnect for Java code
Enter J2EE administrator credentials
3. Once deployed the application should be visible in the SAP Netweaver console:
http://<host>:5###00/nwa
Search for bbramley
And start the service
Configuration of Splunk
The SAP PowerConnect monitoring agent sends its metrics and events to Splunk using the
Splunk HTTP Event Collector.
To configure the Splunk HTTP Event Collector (HEC) follow the documentation on the Splunk
website here:
http://docs.splunk.com/Documentation/SplunkCloud/6.6.0/Data/UsetheHTTPEventCollector
This should result in creating a HEC token for the SAP PowerConnect monitoring agent to
use in the next section.
Granting JMX security permissions to the Sap PowerConnect Agent (NetWeaver 7.5)
If you are using NetWeaver 7.5 the Guest user account needs to have read permissions to JMX in order to consume metrics from SAP specific JMX beans.
To do this use the User Management section in the SAP Netweaver UI:
In the Search Criteria dropdown choose Role then enter Guest and click Go:
Click on the Guest user in the table and click on the Assigned Actions tab:
Click Modify and in the Get text box enter “JmxManageAll” then click Go.
Select the JmxManageAll action at the top of the table and click Add, then Save.
Create JMXManageAll role
1. Create a role called JMXManageAll
2. Add all the actions under jmxmanageall that you can find
3. Click Save
Create User
Make it a technical user *important*
Add the following 5 roles to the user
- SAP_XI_API_DEVELOP_J2EE (PI only)
- SAP_XI_API_DISPLAY_J2EE (PI only)
- NWA_READONLY (all)
- SAP_XI_MONITOR_J2EE (PI only)
- JmxManageAll
Configuration of Sap PowerConnect Agent
The final step is to use the Sap PowerConnect UI to configure the agent.
The URL to view the UI is:
http://<server>:<port>/webdynpro/resources/com.powerconnect5/spcj_wd/SapPowerCon nectJava
The UI should look like this:
If you get ERROR returned check that the Java services are running
1. Restart the application
General Tab
The configuration under the General tab can normally be left as default options.
Splunk Tab
Click the Splunk tab and configure the Splunk HEC details:
Configuration Key | Description |
Splunk HEC Key | The token that you generated when configuring Splunk |
Splunk HEC URL | The host and port of where the Splunk HEC is listening e.g. http://localhost:8088/ |
Splunk Index | The name of the index where you would like to store the SAP PowerConnect monitoring data |
Splunk Sourcetype | The name you would like give to identify the SAP PowerConnect monitoring events (should usually be left as default) |
Click the Save button.
Click the JMX tab to pick the events you would like to collect from the SAP Netweaver system. By default the java.lang domain beans are collected.
Once configured events should start to appear in the JVM tab of the SAP PowerConnect for
Splunk app:
JMX Tab
Here you can define the JMX beans you want to monitor, search for an select the bean in the top table,
and then use the down triangle to move it to the list of Enabled Mbeans
JMX Tab
To enable monitoring ofa specific JMX object simply search for the object and once you have it in the top table, click on the down triangle to move it to the list of monitored jmx objects and click save.
PI Monitoring Tab
To monitor a specific PI channel in the PI monitoring tab you can enter the following information
direction – “OUTBOUND,”INBOUND” or leave as NOT_CONFIGURED to monitor both directions
onlyFaultyMessages – <leave cleared>
recieverName – Enter the receiver name, or leave NOT_CONFIGURED to monitor all receivers
recieverParty – Enter the receiver party name, or leave NOT_CONFIGURED to monitor all receivers
senderName – Enter the sender name, or leave NOT_CONFIGURED to monitor all senders
senderParty – Enter the sender party name, or leave NOT_CONFIGURED to monitor all senders
status – Can be one of the following values “success”, “toBeDelivered”, “waiting”, “holding”, “delivering”, “systemError”, “canceled”, or leave NOT_CONFIGURED to monitor all statuses
messageType – Enter the message type name, or leave NOT_CONFIGURED to monitor all senders
Use the simple monitor for specifying a single filter (1 only). NOT_CONFIGURED means no filter and equals ‘*’ or match anything. The below filter matches all messages, as there is no filter. Enter a matching string for filtering by one of the below fields, wildcards are supported i.e. ReceiverName = “testReceiver*”.
Use the advanced filter for multiple filters.
The default format is below. For a single filter
<?xml version=”1.0″ encoding=”UTF-8″?> <PIFilters>
<PIFilter>
<direction></direction>
<interfacename></interfacename> <namespace></namespace> <messagetype></messagetype> <onlyfaultymessages>false</onlyfaultymessages> <receivername></receivername> <receiverparty></receiverparty> <sendername></sendername> <senderparty></senderparty>
<status></status>
</PIFilter>
</PIFilters>
For multiple filters you can repeat the <PIFilter> section multiple times.
<?xml version=”1.0″ <PIFilters>
encoding=”UTF-8″?>
<PIFilter> <direction></direction>
<interfacename></interfacename> <namespace></namespace> <messagetype>messageType</messagetype> <onlyfaultymessages>false</onlyfaultymessages> <receivername>receiverName</receivername> <receiverparty>receiverParty</receiverparty> <sendername>senderName</sendername> <senderparty>senderParty</senderparty> <status>statusText</status>
</PIFilter> <PIFilter>
<direction></direction> <interfacename></interfacename> <namespace></namespace> <messagetype></messagetype> <onlyfaultymessages>false</onlyfaultymessages> <receivername></receivername> <receiverparty></receiverparty> <sendername></sendername> <senderparty></senderparty>
<status></status> </PIFilter>
</PIFilters>
Edit this filter, and save it in a document as an .xml file and then upload it, once uploaded it will look like the screen capture below. Click on Choose File -> select the file -> click Import
Filters are inclusive – you can include anything in the filter, but you can not set a filter to exclude anything.
The configuration tab allows you to specify
Collect message logs – Collects the PI/PO processing logs connected to each message
Collect message payload – Collects the PI/PO message payload
Max number of messages per minutes – Maximum number of messages per server nodes (there may be more than 1 server node per SAP instance. If you have 2 instances, with 2 server nodes each, then this is 100 messages / min / node which in this case is 2 x 2 x 100 = 200 messages per minute.
Log Monitoring
This tab allows you to enable SAP Java log monitoring for
Portal Activity – This allows you to read and ingest the Portal Activity data which feeds the portal Page Hits/ and Page response time dashboards
Default Trace – This ingests the SAP Java defaultTrace logs
Application Trace – This ingests the SAP Java defaultTrace logs
These logs are read and any changes to these files (similar to a unix tail command) are identified and sent to Splunk.
The input for these is variable, these is generally no need to adjust these.
Log File Directory – The directory the log file is written to by SAP
Log Filename Filter – The filename mask for the log file written to by SAP
Log File Header – These are the headers to assign the columns that are contained in the
logfile. These are pre-mapped but you can change them, they are comma delimited, and are
mapped to the fields in the file in the sequence they appear in this field.
Portal Activity: TimeRequest,LoggedOnUser HASH,iView PCD HASH,Header of Request HSSH,HURL Query String HASH,Time to Process Request,ServerNode,TimeToProcessRequest,HTTPSessionID,NavigationPath,ObjectType,ServerHost,Un iqueID,URLQueryString
Default Trace:
Unknown1,Time,Timezone,Severity,SourceName,Unknown2,CSNComponent,DCComponent,Unknown3,Correla tionID,Application,Location,User,Session,Transaction,DSRRootContextID,DSRTransaction,DSRConne ction,DSRCounter,ThreadName,Unknown4,Unknown5,Text
Application Trace:
Unknown1,Time,Timezone,Severity,SourceName,Unknown2,CSNComponent,DCComponent,Unknown3,Correla tionID,Application,Location,User,Session,Transaction,DSRRootContextID,DSRTransaction,DSRConne ction,DSRCounter,ThreadName,Unknown4,Unknown5,Text
Admin Tab
This tab shows the license key, license validity volume of data sent to Splunk today. The 3 test buttons should be used to confirm these 3 functions can be successfully executed.
JMX – Checks that the user specified in the General tab has the necessary permissions to read the JMX data.
Splunk – Checks and confirms connectivity from SAP Java to Splunk.
PI – Checks that the user specified in the General tab has the necessary permissions to read the JMX data from the J2EE engine.
The Show Log button will display the powerconnect log which is written to the same directory as the defaultTrace/applicationTrace directory, and there is 1 log per server node.