Configuring a WebSphere Application Server 7.x to Work with the eG Agent

To monitor a WebSphere Application server 6.x (and above), a specific WebSphere monitoring eG component has to be installed on it. If the WebSphere server to be monitored uses a SOAP connector port for its internal communications, then the egurkha6.ear component will have to be installed on the server. On the other hand, if the target WebSphere server uses an RMI port for communicating internally, then the egurkha6rmi.ear component should be installed on the server. Before installing either of these components on a WebSphere server, do the following:

• Copy the egurkha6.ear (or egurkha6rmi.ear) file from the <EG_INSTALL_DIR>\lib directoy (on Windows; on Unix, this will be /opt/egurkha/lib) to any temporary location on the eG agent host.
• Rename the file in the temporary folder as egurkha.ear.
• Copy the egurkha.ear file back to the <EG_INSTALL_DIR>\lib directoy (on Windows; on Unix, this will be /opt/egurkha/lib). 

Then, follow the steps given below to perform the installation.

1. Login to the WebSphere Administrative Console by first accessing the URL: http://<IP/hostname of the WebSphere server>:<WebSpherePort>/, and then providing a valid User ID and Password.

   

   Figure 1 : Logging into the WebSphere administrative console

2. The WebSphere Administrative Console will then appear as depicted by Figure 2.

   

   Figure 2 : The WebSphere Administrative Console

3. Expand the Applications node in the tree-structure in the left pane of Figure 3, and then click on the New Application sub-node within. Then, from the list of links displayed in the right panel, pick the New Enterprise Application link.

   

   Figure 3 : Installing a new application

4. Figure 4 will then appear. If the egurkha.ear file to be deployed is on the local host, then, select the Local file system option, and then specify the full path to the egurkha.ear application in the Full path text box. On the other hand, if the egurkha.ear file is available on a remote host in the environment, then, pick the Remote file system option and specify the full path to the remote egurkha.ear file in the Full path text box below. Typically, the 'ear' file will be available in the /opt/egurkha/lib directory (on Unix; on Windows, it will be the <EG_INSTALL_DIR>\lib directory). Then, click the Next button in Figure 4.

   

   Figure 4 : Specifying the full path to the 'egurkha.ear' file

5. When Figure 5 appears, select the Fast Path option, and click the Next button.

   

   Figure 5 : Indicating how to install the egurkha application

6. Using Figure 6 that appears next, view the Installation Options, and select the options that you want to enable for your application deployment. Since the default installation settings apply to the egurkha.ear deployment, you need not enable/disable any additional options in this page. Therefore, simply scroll down the page and click the Next button therein.

   

   Figure 6 : Viewing the installation options

7. When Figure 7 appears, map the egurkha module to the displayed Server, by selecting the check box corresponding to the egurkha module and clicking the Next button.

   

   Figure 7 : Mapping the egurkha module with a server

8. Then, to map the egurkha web module to the default selection in the Virtual Host drop-down, select the check box corresponding to the egurkha module in Figure 9, and click the Next button. This will ensure that the egurkha web module is installed on the default virtual host.

   

   Figure 8 : Mapping the egurkha web module with a virtual host

9. Next, a summary of your specifications for egurkha.ear deployment will appear (see Figure 10). Scroll down the summary to click the Finish button. 

   

   Figure 9 : Viewing a summary of your installation specifications

   

   Figure 10 : Scrolling down the summary and clicking the Next button

10. This will trigger the deployment of the egurkha application. Figure 11 indicates the status of the installation.

    

    Figure 11 : Status of the egurkha installation

11. Scroll down Figure 11 to determine whether the egurkha application was successfully deployed or not. If application deployment is successful, a message to that effect will appear here (see Figure 12).

    

    Figure 12 : A message indicating that the egurkha application has been successfully installed

12. Then, proceed to save the egurkha application. The first step towards this is to save the changes to the master configuration. Before saving the master configuration, you may want to review the changes effected on it. For this, click the Review link in Figure 12.

13. Figure 13 will then appear displaying the Total number of changed documents. To view the list of documents that changed, expand the Total changed documents node (see Figure 14).

    

    Figure 13 : Viewing the total number of changed documents

    

    Figure 14 : Reviewing the changes to the documents

14. Scroll down Figure 15 to review the complete list of changes. Finally, click the Save button in Figure 15 to save the changes.

    

    Figure 15 : Saving the changes

15. Now, proceed to start the egurkha application. For that, follow the Applications -> Application Types -> WebSphere enterprise applications node sequence in the tree-structure in the left panel of Figure 16. The list of installed applications will then appear in the right panel. Select the check box corresponding to the egurkha application and click the Start button therein to start it.

    

    Figure 16 : Selecting the Save to Master Configuration link

16. Once the application is started, a message to that effect will appear as depicted by Figure 17 below.

    

    Figure 17 : A message indicating that the egurkha application has started successfully

17. Finally, log out of the admin console.