IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
Configure WebSphere XD Cell monitoring
Overview
You can configure a WebSphere agent to monitor WebSphere XD cells. To add an XD cell to the Tivoli Enterprise Portal, run the take action option....
Add_XD_Cell
Then the XD cell subnode displays in Tivoli Enterprise Portal and you can configure all connection settings using configuration workspace.
See: WebSphere XD Cell Monitoring Prerequisites.
Configure the agent to monitor the XD cell
- This step is optional, but if you want to see any data in the jobs workspace you will need to install ITCAM CG Monitor enterprise application using itcam.cg.py wsadmin script described in the next section.
- From the Tivoli Enterprise Portal, run the ADD_XD_Cell take action command from the WebSphere agent node.
- Refresh the navigation tree, the XD Cell subnode displays under WebSphere agent node.
- Click the XD Cell subnode and follow the link at the bottom, to open the configuration workspace.
- In the configuration workspace, specify connection settings and optionally update monitoring settings.
Convert WebSphere keystores to JKS format
To connect the WebSphere XD cell with enabled security specify the SSL truststore and keystore files in the configuration workspace on the Connection configuration tab. If you use JKS stores in your WebSphere configuration, you can specify them directly in the connection settings. If you use PKCS12 stores, you will need to create JKS stores and import keys from PKCS12 stores into JKS stores. T complete the import.
- In a Windows environment, start <WebSphere Location>\bin\ikeyman.bat. In a UNIX environment, start <WebSphere Location>/bin/ikeyman.sh.
- In the IBM Key Manager main menu, select Key Database File>Open.
- From the Key Database Type, select PKCS12.
- Click the Browse button next to the File Name field, and select the <WebSphere Location>\profiles\<Deployment Manager Name>\etc\key.p12 file. Click OK.
- In the Password Prompt dialog box that displays, type WebAS then click OK.
- In the Key Database Content drop-down menu, select Personal Certificates.
- Select the default key and click the Extract Certificate button.
- From the Data Type drop-down menu, select Binary DER data.
Pay attention to the Certificate file name and Location fields, you can change the values or leave the default values.
Click OK.
- From the IBM Key Manager main menu, click Key Database File >Open.
- From the Key Database Type drop-down menu, select JKS.
- Click the Browse button next to the File Name field and select the <WebSphere Location>\profiles\<Deployment Manager Name>\etc\DummyClientTrustFile.jks file. Click OK.
- In the Password Prompt dialog box, type WebAS then click OK.
- In the Key Database Content drop-down menu, select Signer Certificates.
- Click Add and specify the certificate file name extracted in steps 7 and 8. Click OK.
- In the Enter a Label dialog box, type imported label and click OK.
- Select Key Database File > Exit in the IBM Key Manager main menu to exit.
Install “ITCAM CG Monitor” enterprise application
To see details on the executing jobs (Jobs workspace), an optional ITCAM CG Monitor enterprise application can be deployed to the Job Scheduler deployment target (server or cluster). This application can be deployed using the supplied wsadmin script or through the admin console. /opt/IBM/WebSphere_6.1_ND_XD/AppServer/bin/wsadmin.sh --lang jython -f ./itcam.cg.py deploy ./itcam.cg.ear.
ITCAM CG monitoring enterprise application can be deployed and started on the Job Scheduler without any interruption to the Job Scheduler.
In order to deploy the ITCAM CG Monitor application using wsadmin, run the following command:
On Windows: From <ITM root>/TMAITM6/kynlib run: wsadmin -lang jython [connection settings] -f itcam.cg.py deploy
On UNIX or Linux: From <ITM root>/<platform>/yn/lib run: wsadmin.sh -lang jython [connection settings] -f itcam.cg.py deploy
Where [connection settings] depends on environment and typically are: -user wasuser -password waspassword.
Run Add XD Cell
- In the Tivoli Enterprise Portal, click...
WebSphere Agent - WebSphere | Take Action (right-click) | Select | Add_XD_Cell | cellname | OK
- Wait for the refresh icon to appear in the navigation tree toolbar.
- Click the XD Cell node, then click the link at the bottom to open the configuration workspace.
Configure the deployment manager Connection
The configuration workspace specifies connection settings and monitoring settings.
- Click WebSphere XD Cell
- Click the link at the bottom to open the configuration workspace.
The configuration workspace displays the following tabs:
- Connection Settings
- Connection Security Settings
- Collection Settings
- Job Filter Settings
- Complete the fields in the tabs using the hover help as a guide.
You can also use the configuration options following these steps as a guide.
- When the connection settings are saved, refresh the workspace and check the cell connection status. If all settings are correct then status changes to Connected if not the status changes to Error. For details on the connection error see the WebSphere Agent event log in the WebSphere Agent status workspace.
SOAP Connection to WebSphere XD cell with enabled security
Connector Host Address or host name that the deployment manager is listening on. Connector port SOAP port that the deployment manager is listening on. Connector type SOAP or RMI. In this case use SOAP. Connector Security Enabled Set to True to enable security User name Add the WebSphere user name. User password Add the WebSphere user password. SSL Trust Store File Store of keys trusted by SOAP client. It stores deployment manager public SSL key. After install WebSphere creates such file in the following path -- <WAS home>/etc/DummyClientTrustFile.jks. a WebSphere administrator can customize this file. SSL Trust Store Password Password for the SSL Trust Store file. The default WebSphere password is WebAS. SSL Key Store File Store of SOAP client public and private keys. After installation WebSphere creates this file in the following path -- <WAS home>/etc/ DummyClientKeyFile.jks. A WebSphere administrator can customize this file. SSL Key Store Password Password for the SSL Key Store file. The default WebSphere password is WebAS.
Simple configuration with SOAP connection and no security configured
Connector Host The address or host name that the deployment manager is listening on. Connector Port The SOAP port that the deployment manager is listening on. Connector Type This can be SOAP or RMI. In this case use SOAP. Connector Security Enabled Set to False to disable security.
See also WebSphere XD Overview for ITCAM Agent for WebSphere Applications.
Parent topic:
WebSphere XD Overview for ITCAM Agent for WebSphere Applications