How-To Create A New Liberty Node (Linux)

 

Audience

This How To document is intended for Linux administrators whom manage HSIT Linux servers.

 

Overview

This article will describe the steps required to create a Liberty Linux Node and configure the system for proper operations. There are four (4) tiers for the back-end Liberty application servers (Production=hsitjavapd.hs.pitt.edu, Stage=hsitjavast.hs.pitt.edu, Test=hsitjavats.hs.pitt.edu, Development=hsitjavadv.hs.pitt.edu).

 

Verifying the Linux Server is Prepared for Application Nodes

Check if Liberty is installed & identify new application

Verifying the Server is prepared for the new Liberty Node.

  1. The first step in creating a new Liberty Node is to identify the server you are working on. In most cases this will begin in the Development environment. For reference the server for development is "HSITJAVADV.HS.PITT.EDU".
    1. It is assumed that the Liberty Application software has been installed on the server already.
  2. Identify the Application Full name, Abbreviation, and DNS name. In all cases this information is provided by the development team. See below for the normal aspects of the Applications
    1. Full name = Anatomic Specimens
    2. Abbreviated name = AS
    3. ASDEV.HS.PITT.EDU

 

Creating the Liberty Node

With the environment ready we can begin the creation process.

    We now have the environment and node names to continue creating the node. Below are the steps in order:
    1. Access the server in questions - SSH into the server as Pitt credentials. You can use any SSH tool that provides access and allows for running command line actions.
    2. Upon accessing the server you will need to change to ROOT. For HSIT Linux servers this would be "dzdo". The command to use dzdo is below:
      1. "dzdo su -"
      2. This will prompt you for your Pitt credential password.
      3. After successfully entering your Pitt password you will be provided the ROOT working directory. To verify the directory you are in type  "pwd"
      4. You will notice that your working directory has now changed to the root working directory.
  2. In order to create a new Liberty Node you must perform the creation steps from a specific directory within the Liberty application server. Below explains the steps:
    1. Change directory to the correct Liberty director for creating
      1. cd /opt/IBM/WebSphere/Liberty/bin
    2. From the Liberty bin folder type the below command.
      1. Replace the node abbreviation with the one you are creating. NOTE keep in mind that Linux is case sensitive so always use lower case letters when creating nodes.
      2. ./server create as
      3. This process takes only a minute or so. When complete you will have the below folder structure
        1. Navigate to the correct directory to verify:  cd /opt/IBM/WebSphere/Liberty/usr/servers/as
        2. Sub-folders are:
          1. apps
          2. dropins
          3. workarea
        3. In addition to the folders created you will see two files:
          1. server.env
          2. server.xml
        4. We need two additional directories for the Liberty Node to be fully created. The below commands will create the additional folders.
        5. Type the below commands to create the folders.
          1. mkdir config
          2. mkdir resources
  3. After the new Liberty Node & all folders are created we can notify the developer of the new Application that the back-end is ready for deployment of files.
  4. Some folders are not created until the Application node is started for the first time. These folders are logs, & tranlog.

REFERENCES:

 

 

Feedback and Concerns:

If you have any feedback regarding this article, please reach out to hsitkb@pitt.edu.  Please provide feedback by selecting the Feedback Yes/No option and leave a comment.

Print Article