Installing only the command-line interface on a remote Distributed system

You can install the Copy Services Manager CLI to run on a remote Distributed system.

1. Download the Copy Services Manager installation package (csm-setup) for your version and system type to the remote Distributed server where you want to run the command line.
   This file package is the same file package used to install the Copy Services Manager server. The available package types and associated file names are listed in the following table:

   Table 1. Copy Services Manager installation package file names by operating system

   Operating system	Copy Services Manager installation package file name
   Windows	csm-setup-6.3.x-win.exe
   AIX®	csm-setup-6.3.x-aix.bin
   Linux® 64-bit PowerPC® and Power Architecture®	csm-setup-6.3.x-linux-ppcle.bin
   Linux on z Systems	csm-setup-6.3.x-linux-s390x.bin
   RedHat or SuSE Linux	csm-setup-6.3.x-linux-x86_64.bin

2. Run the installation setup file downloaded in the previous step.
   Note: The install can be run in a graphical or silent installation. To install the CLI only via silent install, specify the parameters -i silent -DLICENSE_ACCEPTED=true and -DCLI_ONLY_INSTALL=true on the command line when running the setup file.

   Example: cmd /c csm-setup-6.3.x-win.exe -i silent -DLICENSE_ACCEPTED=true -DSCLI_ONLY_INSTALL=true

3. Steps 3-5 are only for when installing via the graphical interface.

   Read and accept the license agreement and then on the Select Installation Type screen choose the Install CLI Only option.

4. Optionally choose the install directory. The default installation directory for the graphical installer is C:\Program Files\IBM\CSMCLI for Windows and /opt/IBM/CMCLI for Linux and AIX.
5. On the Server Configuration screen, enter the server information for the server which the CLI will manage.
   1. Server Name - The IP or hostname for the remote Copy Services Manager server.
   2. CLI Port - The port used by the server for CLI connections. Default is 9560.
   3. Username (Optional) - The username that can be used for connecting to the remove Copy Services Manager server.
   4. Password (Optional) - The password that can be used for connecting to the remove Copy Services Manager server.
   5. Confirm password (Optional) - Confirm the password that can be used for connecting to the remove Copy Services Manager server.
      Note: The username and password is optional and can be entered to allow automation running on the remote server to invoke the CSMCLI.
6. Steps 6 and 7 can be run if you installed the CLI via the silent installation or need to update the CLI configuration after the installation.

   Open the CSM_CLI_DIR/csm/CLI directory.

7. Edit the repcli.properties file by typing the server name and port of your Copy Services Manager server. The default setting in the file is shown:

   server=localhost
   port=9560

   The updated setting in the file appears as follows:

   server=myCSMserver.domain.com
   port=9560

   Where myCSMserver.domain.com correlates to the Copy Services Manager server name in your environment.

   Note: Port 9560 is the default port that is used during Copy Services Manager installation. If you used a custom port, you must change the port setting.
8. To run the CSMCLI, start the Copy Services Manager CLI by entering the csmcli.bat command for Windows, or the csmcli.sh command on AIX, or Linuxsystems. If prompted, enter the associated Copy Services Manager user name and password. See the following example:

   C:\temp\csm-CLI-6.2-win\csm\CLI>csmcli.bat
   Please enter a username for logging onto the server
   csmadmin
   Please enter a password for logging onto the server
   >
   IBM Copy Services Manager Command Line Interface (CLI)
    Copyright 2007, 2012 IBM Corporation
    Version: 6.2
    Build: a20150818-0519
    Server: csmwin2k12     Port: 9560   UseREST: false
    Authentication file: csmcli-auth.properties
   
   csmcli>