Installing agents in silent mode#

In silent mode, you specify the installation properties in a text file and then run the installation without command-line prompts.

You specify the installation properties in a properties file. The example.agent.install.properties file is provided as an example of a properties file. The example.agent.install.properties file is in the ucd-agent.zip archive.

  1. Copy the following file from the HCL Launch server to the target system: installation_folder/opt/tomcat/webapps/ROOT/tools/ucd-agent.zip.

  2. Extract the ucd-agent.zip archive file.

    Note: If you are installing the agent on IBM z/OS® by extracting files to the UNIX file system, you must convert the character encoding for several text-type files in the installation package to IBM-1047 encoding. If you are installing the agent by using SMP/E, you do not have to convert the character encoding. Move the installation files to the z/OS computer, and then extract the files. If the unzip program is not installed on the z/OS computer, use the jar command to extract the files. For instance, type the following text on the command line:

    JAVA_HOME/bin/jar xvf ucd-agent.zip

    Run the convertFilesForZos.sh script to convert the character encoding of the relevant files to IBM-1047 encoding. After you convert the files, continue with installation.

    If you used the jar command to extract files, add execute permission to convertFilesForZos.sh script first.

    Note: If you are installing the agent on IBM i, you must run the commands through the IBM Portable Application Solutions Environment for i (PASE for i) shell. Move the installation files to the i system, and then extract the files. Run the ibmi-compatability-fix.sh script to update the installer to use the PASE for i shell. After you run the script, continue with installation.

  3. Open the example.agent.install.properties file for editing, or copy the example.agent.install.properties file to a new properties file.

  4. Customize the installation by editing the properties file.

    If you do not specify a property, the default value is used. Some properties in the example file are commented out by default. For a list of these properties, see Agent installation properties.

  5. Save the file.

  6. Run the installation file with the install-agent-from-file.bat command on Windows™ or the ./install-agent-from-file.sh command on Linux. Provide the properties file as a command-line argument.

    On Windows, if the properties file is named install.properties, type the following command:

    install-agent-from-file install.properties

The installation program installs the agent.

Start the agent. See Starting agents.

Parent topic: Installing agents