Because of it's simplicity, light-weight, and scalability, popularity and adoption of WebSphere Application Server Liberty Profile (WLP) server is growing. Recently, I was involved in one of the projects, that utilised the WLP Collective and Clustering capabilities. In order to share the knowledge, I'm writing a series of blog posts on How to Create and Configure WebSphere Liberty Cluster End-to-End. This particular post focuses on setting up a WebSpere Liberty Collective and a Cluster. Below listed are all the posts in this series:
- How to Create and Configure WebSphere Liberty Cluster End-to-End
- How to Deploy Application in WebSphere Liberty Cluster
- How to Setup Front-End Web Server for WebSphere Liberty Cluster
Diagram 1.0 Example Topology: WLP Collective with Front-End & Deployment Server |
WLP Installation
There are several ways to install WLP. If you like to explore and compare best ways for your particular situation, take a look at IBM Knowledge Center documentation.Check WLP System Requirements:
First, you need to decide what version of WLP is needed for your particular situation. I'm using version 17.0.2 to implement this example topology. System requirement for WLP 17.0.2 can be found here. For this exercise, I will be using Virtual Machines with CentOS Linux release 7.3.1611.
Note: Before proceeding with the WLP installation, make sure you have supported version of Java installed in the machine.
Here is what I have for this exercise:
$> cat /etc/redhat-release
|
Let's start with the WLP installation.
Important: first, I will install WLP in Machine: 02 by using downloaded WLP Jar installer, add all the required features and then package it and distribute to other servers.
This IBM Knowledge Center documentation explains in detail how to download and extract the WLP installer Jar. As shown below, I'm installing it under
Important: first, I will install WLP in Machine: 02 by using downloaded WLP Jar installer, add all the required features and then package it and distribute to other servers.
This IBM Knowledge Center documentation explains in detail how to download and extract the WLP installer Jar. As shown below, I'm installing it under
/opt/ibm
directory:
# Create directory /opt/ibm |
Note: If you have multiple Java/JRE installed on your machine and you need to setup proper Java/JRE for your WLP environment, there are few ways that you can accomplished this. See Customizing the Liberty environment.
Once WLP is intalled and Java Runtime is configured, then check the version.
Once WLP is intalled and Java Runtime is configured, then check the version.
$> cd /opt/ibm/wlp/bin
|
Install Features
Here, I'm installing features required for Collective, Cluster, SSL, restConnector, and localConnector. All the required features can be installed once or one at a time. For all available features refer to Liberty Features at IBM Knowledge Center.
$> ./installUtility install collectiveController-1.0 collectiveMember-1.0 clusterMember-1.0 websocket-1.1 restConnector-2.0 ssl-1.0 localConnector-1.0 adminCenter-1.0
|
Since, all required features are installed, it's time to package the installation as server package and distribute to other servers for installation. In order to do this, I'm going to create a default WLP server and create a package. For more information about server packaging, refer to IBM Knowledge Center documentation. Below, I'm showing server packaging as a Jar file, because it preserves (mostly) the execute permission for the scripts in bin directory.
$> cd /opt/ibm/wlp/bin
|
Now, copy the generated
wlp_install.jar
to other machines (Machine: 03, and Machine: 04 for this exercise) where WLP installation is required. Once wlp_install.jar is copied, proceed with installation. As shown below, we have copied the wlp_install.jar
into /tmp
and going to install WLP under /opt/ibm
directory.If you need to see the installation options, you can just run the
--help
as shown below:
java -jar wlp_install.jar --help
|
Let's launch the installation on Machine: 03 and Machine: 04
# Create /opt/ibm directory and assign ownership to proper user:group
|
Once the installation is completed, verify the version and validate the product as shown below:
# Verify version
|
Troubleshooting: If you get message ./productInfo: line 187: /opt/ibm/wlp/java/java/bin/java: Permission denied while executing script, check and make sure the script files have execute permission. Jar packaging usually preserves the permission, but if you have Java that is installed under ${wlp.install.dir}/java directory and packaged as part of the installer, files under /java/bin and java/jre/bin may not preserve their execute permission. So, go ahead and add execute permission.
|
Setup Collective Controller
Once the WLP is installed on all servers that will be part of WLP Collective, let's start setting up Collective Controller. If you need to understand the concept of Liberty Collective, refer to IBM Knowledge Center article: Liberty: Collective architecture
Note: in given example topology (diagram 1.0), Collective Controller is setup on Machine: 02.
As per our
1) Open
2) Open
3) Open generated include file. In our case it is
If you need more explanation about WLP Collective Controller configuration, refer to Configuring a Liberty collective chapter in IBM Knowledge Center.
Note: I've also added following features in WLP Collective Controller server configuration:
server.xml:
Note: in given example topology (diagram 1.0), Collective Controller is setup on Machine: 02.
# Create server wlpCntlr, which will be configured as Collective Controller.
Creating required certificates to establish a collective...
|
As per our
collective create ...
command, /opt/ibm/wlp/usr/servers/wlpCntlr/wlpcntlr_include.xml
is created with all required configuration for WLP Collective Controller. There are few manual updates required, before we can start our wlpCntlr
server. Here they are:1) Open
server.xml
and include wlpcntlr_include.xml
in it:
# Here I'm using ${server.config.dir}/wlpcntlr_include.xml instead of /opt/ibm/wlp/usr/servers/wlpCntlr/wlpcntlr_include.xml
|
2) Open
server.xml
and make sure to specify host
attribute with proper value for httpEndPoint
element. See below for example.
<httpEndpoint id="defaultHttpEndpoint"
|
3) Open generated include file. In our case it is
wlpcntlr_include.xml
and update quickStartSecurity
element with correct values for userName
and userPassword
.
<quickStartSecurity userName="<replace-with-your-userName>" userPassword="<replace-with-your-password>" />
|
If you need more explanation about WLP Collective Controller configuration, refer to Configuring a Liberty collective chapter in IBM Knowledge Center.
Note: I've also added following features in WLP Collective Controller server configuration:
- adminCenter-1.0: provides Web Based GUI for collective/cluster/server and application management and monitoring. See Administering Liberty using Admin Center
- websocket-1.1: protocol that enables a client and a server application to communicate by using one full duplex connection. See WebSocker for details.
- restConnector-1.0: provides a secure JMX connector that can be used locally/remotely. Refer to Connecting to Liberty by using JMX for details.
- localConnector-1.0: provides a local JMX connector that is built into the JVM.
Below is complete listing of
server.xml
and wlpcntlr_include.xml
for wlpCntlr
(Collective Controller) server.server.xml:
<?xml version="1.0" encoding="UTF-8"?>
|
wlpcntlr_include.xml
<?xml version="1.0" encoding="UTF-8" ?>
|
Based on from where and how you are accessing your Collective Controller server and how many firewall(s) in between, you may need to open firewall port(s) to allow communication. Below is command that I needed to run to open ports 9080 and 9443 so that CentOS allowed the incoming requests.
# Check to see if port 9443 and 9080 open
|
Start WLP Collective Controller server & Verify
Start:
#Start the server
|
Check the
messages.log
. By default, it is located under ${server.config.dir}/logs
directory. Make sure log file doesn't have any error and you see the message something like 'CWWKX6011I: The collective controller is ready, and can accept requests...
".If you have added feature adminCenter-1.0, you should also see a message something like '
CWWKT0016I: Web application available (default_host): http://waslibctlr01:9080/adminCenter/
, in the log fileAccess the Admin Center. Launch your browser and type the Admin Center URL seen on your log file. If it is http port, it will be redirected to https port automatically. Use the same userName and userPassword that you defined above in the
quickStartSecurity
element. See below screen shot of Admin Center landing pageAdmin Center landing page |
Create & Configure Collective and Cluster Member
You can have one or more WLP Collective and/or Cluster member server(s) in the same host (Vertical clustering/scaling) or different host (Horizontal clustering/scaling) or mix of Vertical and Horizontal clustering/scaling. In this exercise, as defined in the diagram 1.0, I'm doing Horizontal clustering/scaling with two member servers residing on two separate hosts.
Create 1st Collective and Cluster Member
Below commands are executed in Machine: 03
# Create member server wlpSrv01:
|
Troubleshooting: If you encounter issues like one of these (below) while joining the WLP server to the Collective:
OR
For detail refer to Setting up BasicRegistry and role mapping on Liberty. |
If
collective join ...
commands completes successfully, (as per our command input) it generates /opt/ibm/wlp/usr/servers/wlpSrv01/wlpsrv01_include.xml
with all required configuration for WLP Collective Member. There are few manual updates required, before we can start our wlpSrv01
server. Here they are:1) Open
server.xml
for wlpSrv01
and include wlpsrv01_include.xml
in it:
<include location="${server.config.dir}/wlpsrv01_include.xml" />
|
2) Define Cluster and Cluster Member:
Open
server.xml
for Collective Member server, and add the following:
<-- Declares this server as a member of defined cluster -->
|
For more information on setting WLP Cluster, refer to Configuring a Liberty server cluster.
Below is complete listing of
server.xml
and wlpsrv01_include.xml
for wlpSrv01
(Collective and Cluster Member server) server.server.xml
<?xml version="1.0" encoding="UTF-8"?>
|
wlpSrv01_include.xml
<?xml version="1.0" encoding="UTF-8" ?>
|
Note:
1) Make sure both HTTP and HTTPS ports that server listens are open on firewall(s).
2) In order to avoid port conflict, if you have more than one WLP server running on same host, make sure listen ports are unique for each of them. Usually by default WLP assigns 9080 (http), and 9443 (https).
Create 2nd Collective and Cluster Member
Below commands are executed in Machine: 04Follow the same steps outlined in creating 1st Collective and Cluster Member . Here, I'm assigning name
wlpSrv02
for my 2nd server.Below is complete listing of
server.xml
and wlpsrv02_include.xml
for wlpSrv02
(Collective and Cluster Member server) server.Server.xml
<?xml version="1.0" encoding="UTF-8"?> |
wlpSrv02_include.xml
<?xml version="1.0" encoding="UTF-8" ?>
|
Note: Make sure all members in the cluster use the same LTPA keys.
For secure applications to function properly in a WLP clustered environment, each member of a given cluster must use the same LTPA key. For simplicity, Choose the LTPA key file from one of the cluster members and copy it to all of the other members in the cluster. The default LTPA key file is ${server.ouput.dir}/resources/security/ltpa.keys. For more information, refer to Creating a Liberty cluster with security considerations.
Start Member Server(s)
#Start wlpSrv01 on Machine: 03
|
Make sure member servers started without any issue and joined the Collective and Cluster. Easy way to do it is to check the
messages.log
. Check and make sure no errors there and verify messages something like below:Successful start:
... A CWWKF0011I: The server wlpSrv02 is ready to run a smarter planet.
Successfully joined the Collective:
... I CWWKX8112I: The server's host information was successfully published to the collective repository.
Successfully joined the Cluster:
... CWWKX7400I: The ClusterMember MBean is available.
Once the collective member successfully join the collective and successfully started, further administrative work can be carried out using Admin Center Console.
Troubleshooting: If you are enabling <feature>javaee-7.0</feature> which along with other services also supports Enterprise JavaBeans (EJB) Lite, and Java Message Service (JMS). You may see following errors depending upon your configuration: 1) CWWKS9582E:
... ibm.ws.transport.iiop.security.AbstractCsiv2SubsystemFactory E CWWKS9582E: The [defaultSSLConfig] sslRef attributes required by the orb element with the defaultOrb id have not been resolved within 10 seconds. As a result, the applications will not start. Ensure that you have included a keyStore element and that Secure Sockets Layer (SSL) is configured correctly.
Root cause: Usually SSL key is not available for secure iiop listener.Resolution: Define SSL config: If using default key store ${server.config.dir}/resources/security/key.jks, configure as follows:
<keyStore password="{xor}LTovMz48OgAoNis3ACYwKi0ALz4sLCgwLTs="/> OR, if defining custom key.jks and trust.jks, configure as follows:
<ssl id="defaultSSLConfig"
2) CWWKO0221E:
... com.ibm.ws.tcpchannel.internal.TCPPort E CWWKO0221E: TCP Channel wasJmsEndpoint329 initialization did not succeed. The socket bind did not succeed for host localhost and port 7276. The port might already be in use. Root cause: default port for JMS listener is in use. Most probably you have more than one WLP instances running on the same host and both listening on same listener port for JMS. Resolution: Change the default wasJmsPort as follows:
<wasJmsEndpoint id="InboundJmsCommsEndpoint" host="*" wasJmsPort="9011" wasJmsSSLPort="9100" /> Refer to https://www.ibm.com/support/knowledgecenter/en/SSEQTP_8.5.5/com.ibm.websphere.wlp.doc/ae/twlp_msg_multi_server.html for details. 3) CWWKS9580E:
... ibm.ws.transport.iiop.security.config.ssl.yoko.SocketFactory E CWWKS9580E: The server socket could not be opened on localhost:2,809. The exception message is Address already in use. Root cause: default port for iiop is in use. Most probably you have more than one WLP instances running on the same host and both listening on same port for IIOP. Resolution: change iiop ports as follows:
<iiopEndpoint host="*" id="defaultIiopEndpoint" iiopPort="2709"> <iiopsOptions iiopsPort="2815" /> </iiopEndpoint>
|
Next: proceed to application deployment -->
Looks like you're really interested in WebSphere Liberty Profile, see my other related blog posts below:
- How to Create and Configure WebSphere Liberty Cluster End-to-End (this post)
- How to Deploy Application in WebSphere Liberty Cluster
- How to Setup Front-End Web Server for WebSphere Liberty Cluster
- Using Docker Secrets with IBM WebSphere Liberty Profile Application Server
- How to use WLP passwordUtilities feature for encryption/decryption
Thanks, this was helpful for me. I'm new to Liberty profile.
ReplyDeletegood documentation, helpful, THANKS.
ReplyDeleteThis blog provide useful information .you can also connect get for quizbooks solution at Quickbooks Customer Service
ReplyDeleteIts useful article for me please continue keep going on . you can get also QuickBooks get solution at
ReplyDeleteQuickBooks Phone Number
This is very informative information. If you have facing problems with QuickBooks software then you van connect me at quickbooks customer service
ReplyDeletehi i have followed above steps but still i am getting below error.Pls help..
ReplyDelete0000002b s.collective.member.internal.publisher.MemberJMXEndpointImpl W CWWKX8129W: Unable to determine the JMX endpoint information within the expected time of 2 minutes. The HTTP endpoint for the default_host virtual host was not detected. Ensure that there is a configured HTTP endpoint for the default_host virtual host.