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
- From the catalog, select Containers and choose the
ibm-websphere-extreme-scale image to start building your container.
- Select the version of the ibm-websphere-extreme-scale image that you
want to use from the TAG/Version drop-down menu.
- Choose to create a single container:
- 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.
- For Size, specify the size of the containers used for starting the
ibm-eXtreme-scale image.
- For Public IP address, specify Request and Bind Public
IP.
- 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 imageVariable 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.
- 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:
- Create a Docker volume to store IBM Websphere eXtremeScale persistent data. For example, enter
the following command:
cf ic volume create vol-wxs1
- 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
- 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
- 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
- Enter the following command to verify that the wxs1 container status is
Running:
cf ic ps -a
- 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.
- 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.