Preparing for the DS CLI installation

The IBM System Storage™ DS CLI program enables open systems hosts to invoke and manage FlashCopy and Metro and Global Mirror functions through batch processes and scripts. You can choose to install the DS CLI interface using the unattended (silent) mode, console mode, or graphic mode. The mode of installation that you choose is often dependent on the configuration of your system.

Before you use the DS CLI commands, be aware of the following requirements:

Your management console must be equipped with the DS Storage Manager graphical user interface (GUI).
The GUI must have been installed as a Full Management Console installation.
Your storage unit must be configured. The DS Storage Manager is used for this initial configuration. The configuration process includes the following tasks:
- Selecting your storage complex
- Assigning your storage unit to the storage complex
- Designating network information for the storage unit
Before you can use the CLI commands that are associated with Copy Services functions, you must activate your license activation codes (part of DS Storage Manager postinstallation instructions).

The DS CLI can be installed on only one of the following supported operating systems:

Supported Host Systems	Installation File Name
IBM AIX (5.1, 5.2, 5.3)	setupaix.bin
Hewlett-Packard-UX (11.0, 11i, v1, v2)	setuphp1020.bin or setuphp11x.bin
Linux (Red Hat 3.0 Advanced Server [AS] and Enterprise Server [ES])	setuplinux.bin for xSeries setupgenericunix.sh for pSeries
SUSE Linux SLES 8, SLES 9, SUSE 8, SUSE 9	setuplinux.bin for xSeries setupgenericunix.sh for pSeries
Sun Solaris (7, 8, 9)	setupsolarisSparc.bin
HP Tru64 (5.1, 5.1A)	setupgenericunix.sh
Novell Netware 6.5	setupwin32.exe
System i system i5/OS 5.3	Add -os400 at a command line after the name of the installation file. For example, `setupaix.bin -os400`
OpenVMS 7.3-1 (or newer)	See the topic group that describes how to install, use, and remove the DS CLI application in an OpenVMS environment.
Windows 2000, Windows Datacenter, Windows 2003, and Windows XP	setupwin32.exe
UNIX users that do not have an X display Note: Use the same installation file name for your host operating system as shown in the previous rows, but add the -console parameter after the installation file name. For example: setupaix.bin -console setuplinux.bin -console	setupos.bin -console Where os represents the name of your operating system as shown in the previous rows.

The DS CLI cannot be installed on a Windows 64-bit system.
You must have Java 1.4.1 or later installed on your machine. The installation program checks for this requirement during installation and does not install the DS CLI if you do not have Java 1.4.1 or later. The DS CLI installation CD-ROM contains Java 1.4.2, which you can install if your system is not equipped with this version of Java.
You must use the ksh (Korn shell) or bash (Bourne again shell) shell if you are installing on a HP Tru64. Installshield does not support the sh shell. You must perform all HP Tru64 installations using the setupgenericunix.sh file that is located on the installation compact disc.
AIX installation:
- The LIBPATH environment variable can interfere with the installation of the DS CLI and can result in the display of the JVM-not-found error. To avoid this interference, disable the LIBPATH environment variable before you install the DS CLI. After the installation of the DS CLI, enable the LIBPATH environment variable so that it can be used with other applications.
- Run the following commands to sequentially disable the LIBPATH environment variable, install the DS CLI, and restore the LIBPATH environment variable:
```
export LIBSAVE=$LIBPATH
		unset LIBPATH
		setupaix.bin -is:javahome /opt/ibm-Java-whatever/java/bin
		export LIBPATH=$LIBSAVE
		unset LIBSAVE
```
System i system installation:
Note: The installation of DS CLI on a System i system is done remotely from a Windows, AIX or some other system platform. You cannot install the DS CLI directly on a System i system.
The System i system and i5/OS must meet the following requirements before the DS CLI can be installed:
- Prerequisites
  - The latest Java group program temporary fixes (PTF)
  - i5/OS 5722-SS1 option 34 - Digital certificate manager
  - Licensed product 5722-AC3 option *base - Crypto Access Provider 128 bit
  - Licensed product 5722-DG1option *base - IBM HTTP Server for iSeries
  - Licensed product 5722-JV1 options 6 - Java Developer Kit 1.4
  - The latest cumulative PTF package that is installed on the i5/OS
- If you are installing onto a System i system, ensure that the machine that you are installing from is network-attached to the iSeries machine.
- During the installation of the DS CLI application onto a System i system, you must provide the following information:
  - The name of the iSeries machine to which you are installing the DS CLI application.
  - The user name and password that is used to access the designated iSeries machine.

The installation process installs the DS CLI in the following default directory:

AIX: /opt/ibm/dscli
HPUX: /opt/ibm/dscli
Linux: /opt/ibm/dscli
Sun Solaris: /opt/ibm/dscli
Windows: C:\Program Files\IBM\dscli
HP Tru64: /opt/ibm/dscli
iSeries: /ibm/dscli
Novell Netware: SYS:\dscli

Perform the following steps in preparation for the DS CLI installation:

Log on to your host system as a root user or administrator.
Insert the DS CLI product CD into the CD drive. If a window opens for the CD drive, close the window.
Mount the CD drive using the mount command according to your system. You can mount your CD drive using the following examples:
AIX
Create a directory for the CD-ROM by issuing the following command:
```
mkdir /cdrom -p
```
Create a file system for the CD-ROM by issuing the following command:
```
crfs -v cdrfs -p ro -d cd0 -m /cdrom
```
where cd0 represents the CD-ROM drive.
Mount the CD-ROM file system by issuing the following command:
```
mount /cdrom
```
HPUX
Mount the CD-ROM file system using the path name for your environment by issuing the following commands:
```
ioscan -funC disk | more
mount /dev/dsk/c?t?d? /<cdrom>
```
Linux
Issue the following command on Red Hat systems:
```
mount /dev/cdrom
```
Sun Solaris
Issue the following command:
```
mkdir /mnt
mount -F hsfs -r /dev/dsk/c0t6d0s2 /mnt
```
Note: The device name /dev/dsk/c0t6d0s2 is the default name for Sun Solaris. The device name might be different on your system depending on your hardware configuration.
Windows

You are not required to mount the CD if you are using this operating system.

HP Tru64
Issue the following command:
```
mount -t cdfs -o noversion /dev/rznn /mnt
```
where nn represents the number of CD-ROM drives.
Novell Netware

You are not required to mount the CD if you are using this operating system.
Navigate to your CD drive and proceed with either the unattended (silent), console, or graphic installation.