Setting up a Liberty server directory and a working directory for the Configuration Tool

You must set up a Liberty server directory to contain the configuration of the Configuration Tool server, and a working directory to store the policy definition files. A setup script ( is provided to automate this process.

About this task

User ID criteria for running the setup script
To run the setup script, you must be logged in to the z/OS® system with a user ID that has the UID 0 attribute.


  1. Enter the directory that contains the setup script.
    cd /usr/lpp/IBM/zcdp/v5r1m0/UI/LIB/
  2. Run the following command to start the setup script. Only the default z/OS shell is supported.
    Important: Before you run the script, make sure that the /tmp directory has at least 1 MB free space.
  3. Follow the prompts of the script to provide necessary values.
    To accept the default value that is shown in the parentheses, enter a blank value.
    1. When you are prompted to choose if you are deploying the Configuration Tool on z/OSMF or Liberty, enter 2 to select Liberty.
    2. When you are prompted to specify the full path of directory where the Configuration Tool server is installed, accept the default value, or specify the directory that you want to use.
      • The directory must be readable by the STC_USRID and STC_GROUP that are specified in the /var/cdp-uiconfig/ file that is created in Configuring user IDs, group IDs, and security product.
      • To avoid possible conflicts, do not use a directory that is defined as the Data Streamer working directory (CDP_HOME) or the Log Forwarder working directory (ZLF_WORK).
    3. If you specify an existing directory, you are prompted for confirmation because the files in the existing directory might be replaced. Enter y to continue with the directory, or enter n to specify another directory.
    4. When you are prompted to specify the Java™ home directory, accept the default value, or specify the Java home directory for your system.
    5. When you are prompted to specify the Configuration Tool Source Script Directory, accept the default value, or specify a directory that is allowed on your system.


The directory config_tool_server_install_dir/servers/cdp_ui_server is created as the Liberty server directory, and the directory config_tool_server_install_dir/cdpConfig is created as the working directory, where config_tool_server_install_dir is the full path of directory where the Configuration Tool server is installed that you specify in 3.b.

What to do next

The Configuration Tool server uses 17977 as the default port number. If you want to change the port number, complete the following steps:
  1. Open the file server.xml under the Liberty server directory of the Configuration Tool. By default, you can find this file under /var/local/CDPServer/servers/cdp_ui_server/.
  2. Change the value of the variable httpsPort to the port number you want to use.

Next, you need to copy the configuration files from the IBM Z® Operational Log and Data Analytics installation directory to the working directory for the Z Common Data Provider Configuration Tool.