Installing only the command-line interface on a remote z/OS system

You can install the Copy Services Manager CLI to run on a remote z/OS system.

1. In order to install the CLI on the z/OS server, a minimum of the following values are required for the size of the ZFS mount.

   Table 1. Minimum values for ZFS mount to accommodate the Copy Services Manager CLI

   File System Requirement	Size
   Block size	1024
   Total blocks	2784240
   Available blocks	1593727

2. Download the Copy Services Manager CLI installation package (csm-CLI) for your version and system type to the remote z/OS server where you want to run the command line.
   This file package can be obtained from the same location as the other Copy Services Manager installation files. The available package types and associated file names are listed in the following table:

   Table 2. Copy Services Manager CLI installation package file name

   Operating system	Copy Services Manager CLI installation package file name
   z/OS®	csm-CLI-6.2.x-zos.pax

3. Extract the csm-CLI file package to a directory on the remote z/OS system, referred to in the following steps as the CSM_CLI_DIR directory: For z/OS, extract the files by using the pax command.
4. After extracting files using the pax command, there is an additional step to set file attributes on Java™ libraries that the CLI uses:

   extattr +a CSM_CLI_DIR/csm/Java/lib/default/libj9ifa29.so

5. Open the CSM_CLI_DIR/csm/CLI directory.
6. 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.
7. Start the Copy Services Manager CLI by entering the csmcli.sh command. Enter the associated Copy Services Manager user name and password. See the following example:

   ./opt/IBM/CSM/csmcli.sh
   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>