Installing agents in silent mode

Edit online

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

Before you begin

  • For production environments, create a user account that is dedicated to running the agent on the computer where the agent is installed.

  • Ensure that each computer where you are installing an agent has a supported version of the Java™ Runtime Environment (JRE) or Java developer kit. For more information, see SPCR for Deploy.

  • If the target computer has an IBM® JRE or Java developer kit, update to a supported version of the IBM JRE or Java developer kit.

  • Set the JAVA_HOME system variable to the location of the JRE or JDK that you are using.
  • Your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
  • Ensured that there is no limit on the maximum memory size and virtual memory size. For example, on most Linux® systems, you can run the ulimit -m and ulimit -v commands and ensure that both return the value unlimited. To find out how to remove the limit on the maximum memory size and virtual memory size, refer to the documentation for the operating system.

About this task

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 devops-deploy-agent.zip archive.

Procedure

  1. Copy the following file from the Deploy server to the target system: installation_folder/opt/tomcat/webapps/ROOT/tools/devops-deploy-agent.zip.
  2. Extract the devops-deploy-agent-version.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 devops-deploy-agent-version.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.

  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 agent installation 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.
  5. 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
    To install agent on a FIPS-compliant system, add the -fips-semeru parameter to the command, such as ./install-agent-from-file.sh -fips-semeru.
    Note: Deploy supports only IBM Semeru versions 11.0.24, 17.0.12, 21.0.4 or higher.

Results

The installation program installs the agent.

What to do next

Start the agent. See Starting agents.