Configuring WebSphere Extreme Scale monitoring in stand-alone environment

Learn how to configure the WebSphere® Applications agent when your WebSphere Extreme Scale is installed in an environment that does not have WebSphere Application Server.

1. Stop the WebSphere Applications agent.
   1. Go to the directory install_dirwhere you install the WebSphere Applications agent.
   2. Run command bin/was-agent.sh stop.
2. Run the configuration script.

   install_dir/platform_code/yn/bin/wxs-agent-config.sh config

   Where

   • install_dir is the installation directory of the WebSphere Applications agent.
   • platform_code is the platform code where you install the agent, for example, lx8266 represents Linux® x86_64 R2.6 (64 bit), aix536 represents AIX® R5.3 (64 bit).

   Example command:

   /opt/ibm/apm/agent/lx8266/yn/bin/wxs-agent-config.sh config

   /opt/ibm/apm/agent/aix536/yn/bin/wxs-agent-config.sh config

3. When prompted for the agent installation path, specify the home directory of WebSphere Applications agent.
   Note: The script looks for the configuration file name based on the installation path you specify. The default is install_dir/config/${hostname}_yn.xml. If prompted that the file does not exist, it might be because you did not start WebSphere Applications agent before you do this configuration. Start the WebSphere Applications agent and then stop it at least once.
4. When prompted for WebSphere Extreme Scale Catalog Server connector type, enter 1 to continue.
5. When prompted to Input a node name to identify this agent node on UI, enter the node name.
   The node name is used to identify the monitored WebSphere Extreme Scale zone and it is displayed in the instance name that you can see in the Application Performance Dashboard UI.
6. When prompted for WebSphere Extreme Scale Catalog Server security enabled?, enter 1 if there is enabled security. Then, enter the user name and password. If there is no enabled security, enter 2.
7. Specify the host name and port number of the catalog server. If there are multiple catalog servers, you can add them one by one. You can also add multiple zones one after another.
   • The host name is the name of the system where the catalog server is located. Make sure the host name can be accessed. If not, use the IP address as the host name.
   • The port number is the JMXServicePort number of the WebSphere Extreme Scale catalog server. The default value is 1099. More details about the port number can be found in WebSphere Extreme Scale Knowledge Center.
8. To start the agent, run the following command.

   install_dir/bin/was-agent.sh start

   Note:

   • Agent configuration is stored in install_dir/config/${hostname}_yn.xml. If you want to change any configuration, run this script again or modify the .xml file directly.
   • Previous configuration is backed up as install_dir/config/${hostname}_yn.xml.bak. You can restore previous configuration if necessary.
   • You can press Ctrl-C to exit the script when you run install_dir/platform_code/yn/bin/wxs-agent-config.sh config. Your existing configuration is not changed.