Configuring Engineering Lifecycle Management on a stand-alone WebSphere Liberty server

Engineering Lifecycle Management includes an embedded WebSphere® Liberty server to ease the installation process. However, you can also configure Engineering Lifecycle Management to deploy Engineering Lifecycle Management applications on a stand-alone WebSphere Liberty server.

Before you begin

Ensure that the WebSphere Liberty server and Engineering Lifecycle Management are already installed in your environment. For more information, see Installing Liberty.
Important: You must use the IBM Java that is bundled with Engineering Lifecycle Management or a later version.

Procedure

  1. Navigate to the Server folder.
    For example:
    • For Windows operating systemIf the Engineering Lifecycle Management applications are installed in the C:\ELM_Liberty_Setup\JazzTeamServer_1 directory, then the Server folder is available in the JazzTeamServer_1 folder.
    • For Unix operating systemsIf the Engineering Lifecycle Management applications are installed in the /opt/IBM/JazzTeamServer_1 directory, then the Server folder is available in the JazzTeamServer_1 folder.
  2. In the For Windows operating systemliberty.server.bat or the For Unix operating systemsliberty.server.sh file, update the values of the following properties:
    For Windows operating system
    • The CLM_LIBERTY_HOME property must contain the file path of the Liberty folder of the WebSphere Liberty server. For example, if the IWebSphere Liberty server is installed in the C:\Program Files\IBM\WebSphere\Liberty directory, then the value of the property must be

      CLM_LIBERTY_HOME=C:\Program Files\IBM\WebSphere\Liberty

    • The CLM_LIBERTY_SERVER_DIR property must contain the file path of the servers folder in the IBM® WebSphere Liberty server that you recently installed, for example:

      CLM_LIBERTY_SERVER_DIR=C:\Program Files\IBM\WebSphere\Liberty\usr\servers\%CLM_LIBERTY_SERVER_NAME%

    • The WLP_USER_DIR property must point to the IBM WebSphere Liberty server user directory, for example:

      WLP_USER_DIR=C:\Program Files\IBM\WebSphere\Liberty\usr

    • Optionally, you can use the CLM_LIBERTY_SERVER_NAME property to change the name of the server, for example:

      CLM_LIBERTY_SERVER_NAME=clm

    For Unix operating systems
    • The CLM_LIBERTY_HOME property must contain the file path of the Liberty folder of the IBM WebSphere Liberty server. For example, if the IBM WebSphere Liberty server is installed in the /opt/IBM/WebSphere/Liberty directory, then the value of the property must be

      CLM_LIBERTY_HOME=/opt/IBM/WebSphere/Liberty

    • The CLM_LIBERTY_SERVER_DIR property must contain the file path of the servers folder in the IBM WebSphere Liberty server that you recently installed, for example:

      CLM_LIBERTY_SERVER_DIR=/opt/IBM/WebSphere/Liberty/usr/servers/$CLM_LIBERTY_SERVER_NAME

    • The WLP_USER_DIR property must point to the IBM WebSphere Liberty server user directory, for example:

      WLP_USER_DIR=/opt/IBM/WebSphere/Liberty/usr

    • The CLM_LIBERTY_SERVER_TEMPLATE property must point to the server template directory of Engineering Lifecycle Management, for example:

      CML_LIBERTY_SERVER_TEMPLATE=/opt/IBM/JazzTeamServer/server/liberty/clmServerTemplate

    • Optionally, you can use the CLM_LIBERTY_SERVER_NAME property to change the name of the server, for example:

      CLM_LIBERTY_SERVER_NAME=clm

  3. Start the Engineering Lifecycle Management server directory.
    1. Open the command prompt and navigate to the Engineering Lifecycle Management server directory.
    2. Run the For Windows operating systemserver.startup.bat or the For Unix operating systemsserver.startup.sh file.
    After the server starts, a new folder for the clm server is created in the servers directory of the IBM WebSphere Liberty server.
    For example:
    • For Windows operating systemIf the IBM WebSphere Liberty server is installed in the C:\Program Files\IBM\WebSphere\Liberty directory, the clm folder is created at C:\Program Files\IBM\WebSphere\Liberty\usr\servers\clm.
    • For Unix operating systemsIf the IBM WebSphere Liberty server is installed in the /opt/IBM/WebSphere/Liberty directory, the clm folder is created at /opt/IBM/WebSphere/Liberty/usr/servers/clm.
  4. Open a browser and navigate to the Engineering Lifecycle Management server Jazz® Team Server setup to complete the Engineering Lifecycle Management deployment.