Configuring the installation images

Complete these steps to download and configure the installation images:

1. Download the agent or Hybrid Gateway images (or both) to a Performance Management server (see Download instructions).
2. Create the configuration package files by running the make configuration package script in interactive mode or batch mode:
   • Run the make configuration package script in interactive mode:
     1. On the system where the Performance Management server is installed, navigate to the default /opt/ibm/ccm directory or to the /custom/path/ccm directory that you specified during installation, and enter the following command:

        ./make_configuration_packages.sh

     2. Enter the directory where you want to store the configuration package after you create it or accept the default value of /tmp/mkcustpkg_workdir.process_ID_of_script.
     3. Enter the IP address or fully qualified domain name of the Performance Management server that you want the agent or Hybrid Gateway to connect to or accept the default value.
     4. If you want secure communications between the server and agents or Hybrid Gateway, select the HTTPS protocol. Select the HTTP protocol for non-secure communications. The communications protocol between server and agents must be the same. For more information, see Setting HTTP or HTTPS communications.
   • Run the script in batch mode by entering the following command:

     ./make_configuration_packages.sh -s server_ip 
     [-d config_packages_dir] [-p {http|https}][-n]

     server_ip

     IP address or fully qualified domain name of the server.

     config_packages_dir

     Optional. Path to the directory where you want to store the configuration package after you create it.

     http or https

     Optional. The default communication protocol between the server and agents is HTTP. If you set the protocol before installing the server to secure HTTPS, enter -p https to change the protocol for the agents to HTTPS so that it matches what was set for the server. For more information, see Setting HTTP or HTTPS communications.

     -n

     Optional. Do not validate input parameters that are used in the agent configuration, for example, server host name.

   A configuration package file, onprem_config.tar, is created in the default directory or where you specified.
3. Configure the installation images (agent or Hybrid Gateway) on Linux system interactively or in batch mode. You can configure the image before or after you extract the installation files. For AIX® systems, run the script on a Linux system, preferably the Performance Management server and copy the configured image archive file to your AIX® system.
   • Run the configure agent images script in interactive mode:

     1. ./configure_agent_images.sh

        
        
     2. If you unpacked the installation images, enter the path to the directory where you unpacked the image.
     3. If you did not unpack the installation images, enter the path to the directory where you downloaded the archive file.
     4. If you did not unpack the installation images, enter the path to the directory where you want to store the configured agent images archive file. Use the following default path or specify a different path:

        /opt/ibm/ccm/depot

     5. If you run the script in an environment where the agent framework is not available in the default location, <server_install_dir>/ccm/AgentFrameworks, enter the path to the directory with the unpacked agent offering frameworks.
   • Run the configure agent images script in batch mode by entering the following command:
     

     ./configure_agent_images.sh -p configuration_package_dir 
     
     -s agent_images_dir [-a agent_frameworks_dir] [-d pre-configured_images_dir]

     configuration_package_dir

     If you did not unpack the configuration package, enter the path to the directory where the configuration package is located.

     agent_images_dir

     Path to the directory where you downloaded the installation images archive file. If you unpacked the installation images, this variable is the path to the directory where the unpacked agent images are located.

     agent_frameworks_dir

     Directory that contains unpacked agent offering frameworks packages. These files are available in the <server_installation_dir>ccm/AgentFrameworks directory, on the Performance Management server, by default. If default agent offering frameworks packages are used, this variable is not required.

     pre-configured_images_dir

     If you did not unpack the images archive file, this variable is the path to the directory where you want to store the configured agent images archive file.

     -h

     Displays help for the configure_agent_images.sh command.