Establishing a JMX MBean Liberty server connection

You can use Jython-based scripts to establish a Java™ Management Extensions (JMX) MBean Liberty server connection.

Before you begin

You must obtain and install the Jython version of your choice before you can perform this procedure. Without a Jython runtime, the instructions will fail.

Procedure

  1. From the catalog, select Containers and choose the ibm-websphere-extreme-scale image to start building your container.
  2. Select the version of the ibm-websphere-extreme-scale image that you want to use from the TAG/Version drop-down menu.
  3. Choose to create a single container:
    1. From the Create a Container panel, specify a Container name; for example, wxs1. No spaces or other non-printable characters are allowed in the container name.
    2. For Size, specify the size of the containers used for starting the ibm-eXtreme-scale image.
    3. For Public IP address, specify Request and Bind Public IP.
    4. Open the Advanced Options panel. Create a volume so that the eXtreme Scale configuration data can be persisted when installing a rolling upgrade at a later time; for example:
      • Click Create a volume from Advanced Options, and specify the Volume name. For example, type vol-wxs1.
      • Click Add a new environment variable. The ibm-websphere-extreme-scale image requires environment variables that are stored within the container and accessed by authorized users.
        Table 1. Environment variables for the ibm-websphere-extreme-scale image
        Variable Name Value to be Specified
        SECRET_KEY The value of the secret key; for example, s3cretKey!. This is the secret key used by eXtreme Scale servers to send internal communication across the multiple members in a cache member group. For more information, see the Cache member group section.
        XSADMIN_PWD The password of the xsadmin user that logs on to the eXtremeScale dashboard UI; for example, xsadmin4Me!.
        Note: You can change the password and secret key after the eXtreme Scale container starts. Both the secret key and password have the following password rules. Be sure to enter them both based on the following rule:

        The password and secret key must contain at least one number [0-9], one upper case character [A-Z], one special character [~!@#$%^&*()_-+=:;'[]{}|<>,.?/] and be at least 10 characters.

        For more information about how to change the password, see the Administering documentation.

  4. Create a container from the IBM Cloud Dashboard. The port is added in the Public Port field by default.

Complete the following cf command steps to create a container from the command line:

  1. Create a Docker volume to store IBM Websphere eXtremeScale persistent data. For example, enter the following command:
    cf ic volume create vol-wxs1
  2. Enter the following command to start your IBM WebSphere eXtremeScale container in IBM Cloud:
    cf ic run -itdP --volume vol-wxs1:/vol --name wxs1 -m 1024 -e SECRET_KEY=s3cretKey! -e XSADMIN_PWD=xsadmin4Me! registry.ng.bluemix.net/ibm-websphere-extreme-scale:latest 
  3. Request a public IP to be used for your first IBM Websphere eXtreme Scale container. Enter the following command to write the IP address:
    cf ic ip request
  4. Enter the following command to bind your WebSphere eXtreme Scale container to the public IP address that you requested:
    cf ic ip bind REQUESTED_IP wxs1
  5. Enter the following command to verify that the wxs1 container status is Running:
    cf ic ps -a
  6. Enter the following command to connect to the wxs1 container and monitor the nanny log:
    cf ic exec -it wxs1 bash; cd /opt/ibm/websphere/wlp/startscripts/nanny/log/; more nanny.log
    Note: It can take anywhere from 5-10 minutes for the server to completely start.

  1. After the container and eXtreme Scale servers are fully started, log on to the eXtreme Scale dashboard UI, and verify the deployment: https://REQUESTED_IP:9443

    For samples and for recent updates, visit Websphere eXtreme Scale in GitHub. Also, see the following supporting documentation and videos for more help with deploying eXtreme Scale:

What to do next

After a connection to the MBean server is established, you can make calls to the MBean server by using the invoke(...) method.

Note: A library of Jython scripts is available for you to download from the Liberty Repository.

Icon that indicates the type of topic Task topic

File name: twlp_admin_serverconnection.html