Using Silent installation on distributed systems

Edit online

You can install Copy Services Manager using a Silent installation. A silent installation is useful when remotely accessing a Linux or AIX system without a graphical user interface. The silent install can be done using the response file, silent_CSMInstall.properties, provided with the installation image or via command line parameters.

About this task

Note: Installing the product via -i console is not supported.
To install the product via silent installation, launch the install executable on the desired platform specifying -i silent as a parameter. 
Example on Windows:  cmd /c copy_services_manager_setup.exe -i silent

When performing a silent install the following values may need to be provided via the silent_CSMInstall.properties or via a command line parameter when launching the silent installer.

Evaluate the following values in order to determine if they should be modified.

License Acceptance (Required):

This parameter is required and must be set to true to confirm that you accept the terms of the licensing agreement.

To specify in the silent_CSMInstall.properties file modify the following value:
 LICENSE_ACCEPTED=true

To specify from the command line:

-DLICENSE_ACCEPTED=true

Enablement Zip File (Optional):

If you have the license file, you can define the path where the license file is located.

To specify in the silent_CSMInstall.properties file modify the following value:
CSM_LICENSE_FILE=<path to license .zip file>
To specify from the command line:
-DCSM_LICENSE_FILE=<path to license .zip file>

Port Definitions (Optional):

The ports used by the server can be modified from the defaults. The following are the default ports. Ports only need to be modified if a non-default port is required.

To specify in the silent_CSMInstall.properties file modify the following values:
CSM_GUIPORT=9559
CSM_CLIPORT=9560
CSM_HAPORT=9561
CSM_AUTHPORT=9562
To specify from the command line:
-DCSM_GUIPORT=9559
-DCSM_CLIPORT=9560
-DCSM_HAPORT=9561
-DCSM_AUTHPORT=9562

Installation location (Optional):

The installation location can be modified from the default. The following are the default directory paths. The installation location only needs to be modified if a location other than the default is required.

Default Installation directory path:
  • Windows: C:/Program Files/IBM/CSM
  • Linux/AIX: /opt/IBM/CSM
To specify in the silent_CSMInstall.properties file modify the following values:
USER_INSTALL_DIR=
To specify from the command line:
-DUSER_INSTALL_DIR=

Default Username and Password (Optional)

A default username and password will be used during the installation. It is recommended that you use the following defaults. When you login to the server the first time you will then be prompted to modify the default password and can setup other users and security for the server. 
CSM_USER=csmadmin
CSM_USER_PASSWORD=passw0rd

The following example is for a silent installation on Windows.

Procedure

  1. Open a command prompt.
  2. Change directories to where the setup.exe file is located. Or, you can point to the relevant directory.
  3. Enter the following command (where the installer executable would be provided in the install image for the release being installed):
    When using the silent_CSMInstall.properties file, issue the command:
    cmd /c csm-setup-6.3.x-win.exe -i silent -f silent_CSMInstall.properties
    When specifying any values via the command line, issue the command:
    cmd /c csm-setup-6.3.x-win.exe -i silent -DLICENSE_ACCEPTED=true
    Notes:
    1. When you issue a silent installation in a Windows command prompt, the command line returns immediately. To pause a return to the command line until the installation completes, prefix the silent installation command string with cmd /c.
    2. Failure messages are printed to the screen on Linux systems but not on Windows. However, for Windows, you can modify the value for LOG_LOCATION=a_directory in the silent_CSMInstall.properties file to record failure information for Windows. Or specify the -DLOG_LOCATION=a_directory on the command line.
    3. On Linux systems, you can direct messages to a .txt file. For example, append > name_of_install_log.txt to the command string in step 3.
    4. To migrate from an exported backup created on another Copy Services Manager server using silent install, include the following property in the silent install properties. This property should include the full path to a Copy Services Manager backup zip file. For example, CSM_BACKUP=/path/to/csm_backup.zip or CSM_BACKUP=C:\\path\\to\\csm_backup.zip for Windows. Or if using the command line specify -DCSM_BACKUP=/path/to/csm_backup.zip or -DCSM_BACKUP=C:\\path\\to\\csm_backup.zip for Windows. Keep in mind that if the property is not specified, it will default to not using any backup, and a new database will be created if one was not already present.