Installing the DS CLI using the console mode

Complete this task to install the DS CLI application on your system using the console mode. The console mode is primarily used for installations on a Linux operating system or on a UNIX operating system without an X display. Users can run the installer from a command prompt on a Windows operating system.

Consider the following before you perform the installation of the DS CLI application:

You cannot install the DS CLI on a computer that contains the ESS CLI.
You cannot install the DS CLI on a Windows 64-bit operating system.
You must have a version of Java 1.4.1 or higher that is installed on your system in a standard directory. The DS CLI installer checks the standard directories to determine if a version of Java 1.4.1 or higher exists on your system. If this version is not found in the standard directories, the installation fails. If the installation fails because the correct version of Java is not found, see Correcting the JVM-not-found error.
The DS CLI installation CD contains the Java 1.4.2 version. You can install this version from the CD and continue with the installation of the DS CLI application.
If the DS CLI application was installed on your client or host machine in the past, ensure that you end any active sessions of the DS CLI before you run the DS CLI installation CD.
If you are installing onto a Novell system, you are directed to provide the following information:
- The directory where your Windows drive is mapped
- The directory where the JAVA HOME is located
If you are installing the DS CLI onto an OS/400 system, ensure that the machine that you are installing from is network-attached to the OS/400 machine.
During the installation of the DS CLI application onto an OS/400 system, you must provide the following information:
- The name of the OS/400 machine to which you are installing the DS CLI application.
- The user name and password that is used to access the designated OS/400 machine.

The console mode is primarily used for installations on a Linux operating system or on a UNIX operating system that does not have an X display. Users can run the installer from a command prompt on a Windows operating system. The console mode installer displays its various screens as text.

Before you can use the DS CLI, some operating systems require that you restart your system after the installation is complete. Or, you might be required to open a new command prompt window to start a DS CLI session.

Perform the following steps to install the DS CLI using the console mode:

Insert the DS CLI installation CD into the CD drive. If the Installshield starts, click the Exit selection to exit.
Open a command prompt and locate the setupwin32console.exe or the setuplinux.bin file on the DS CLI CD.

Type the following command on the command line (unless you are installing onto an OS/400 system): setup platform<.exe | .bin | .sh> -console. The Welcome screen is displayed.

For example, for Windows, type: setupwin32console.exe or, for Linux, type: setuplinux.bin -console

For an installation onto an OS/400 system from a Windows operating system, type: setupwin32console.exe -os400

Notes:

When you issue the setupwin32console.exe command on a Windows operating system, you do not need to include the -console parameter as part of your command.
Initially the DS CLI installer checks your standard directories for the correct version of Java. If the correct version of Java is not found, you receive the following message:
```
A suitable JVM could not be found. Please run the program 
again using the option -is:javahome <JAVA HOME DIR>
```

Initializing InstallShield Wizard...
Searching for Java(tm) Virtual Machine...
.
Searching for Java 1.4.1 by IBM Corporation
Verifying Java 1.4.1 by IBM Corporation
.......
-------------------------------------------------------------------------------
Welcome to the InstallShield Wizard for IBM System Storage™ DS Command-Line
Interface (CLI)
The InstallShield Wizard installs IBM System Storage DS Command-Line Interface 
on your computer.

 To continue, choose Next.


    DS Command-Line Interface
    IBM Corporation

Users are encouraged to read the User's Guide PDF and the README file before
installing. Both files are located in the cliReadmes/ directory of this 
CD-ROM.


Press 1 for Next, 3 to Cancel or 4 to Redisplay [1]

Press 1 for Next. The License agreement screen is displayed. You can also press 3 to Cancel, or 4 to Redisplay.

Please read the following license agreement carefully.

Use of the IBM System Storage DS Command-Line Interface (CLI) is governed by the
IBM Agreement for Licensed Internal Code, a copy of which has been provided
with your DS Machine.

 (C) Copyright 2004, 2005 International Business Machines
     Corporation All rights reserved.


Please choose from the following options:

[ ] 1 - I accept the terms of the license agreement.
[ ] 2 - I do not accept the terms of the license agreement.

To select an item enter its number, or 0 when you are finished: [0] 1


[X] 1 - I accept the terms of the license agreement.
[ ] 2 - I do not accept the terms of the license agreement.

To select an item enter its number, or 0 when you are finished: [0] 1


Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

Press 1 to accept the terms of the license agreement. A confirmation prompt is returned with an "X" next to the acceptance line and a 0 in the finished line.
1. Press Enter to notify the installer that you are finished with this section. The next action line of instructions is displayed.
2. Press 1 for Next. One of the following results occurs depending on the system that you are using to install the DS CLI:
  - The Windows User's screen is displayed if you are installing on a Windows operating system or are pointing to a Novell system. Continue with the next step.
  - The Install Location screen is displayed if you are installing on a Linux operating system. Continue with Step 10.
  You can also press 3 to Cancel, or 4 to Redisplay.
```
Please select the appropriate target system:

[X] 1 - Windows
[ ] 2 - Novell Netware

To select an item enter its number, or 0 when you are finished: [0]

Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
```
If you want the Windows operating system, press 1. If you want the Novell operating system, press 2. If you choose 1 or 2, a confirmation prompt is returned with an "X" next to the system that you choose and with a 0 in the finished line.
1. Press Enter to notify the installer that you are finished with this section.
2. Press 1 to continue. The Install Location screen is displayed. This screen can be different depending whether you choose Windows, Novell, or are installing for an OS/400.
  - Continue to Step 7 if you choose Windows.
  - Continue to Step 8 if you choose Novell.
  - Continue to Step 9 if you are installing for an OS/400.
You can also press 2 to go to the previous screen, 3 to Cancel, or 4 to Redisplay.
(Windows and Linux only) Observe the default directory path that is displayed in the Install Location screen and take the following action (example: the Install Location screen at the end of this step):
1. Press 1 to continue if you are satisfied with the default directory.
2. Change the directory path where you want to install the CLI (do not use blank spaces in the path) if you are not satisfied, and press 1 to continue.
3. Go to Step 10 after pressing 1.
  The Install Location screen is displayed after pressing 1.
You can also press 2 to go to the previous screen, 3 to Cancel, or 4 to Redisplay.
```
IBM System Storage DS Command-Line Interface Install Location

Please specify a directory or press Enter to accept the default directory.

Directory Name: [C:\Program Files\ibm\dscli]or [opt/ibm/dscli]

Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
```
(Novell only) Observe the default directory paths that are displayed in the Installation Location screen for Novell and perform the following action (example: the Install Location screen at the end of this step):
Notes:
1. SYS represents where the Windows drive is mapped in a Novell system. However, this could also be SYS:\DS\CLI or a volume other than SYS:
2. J: (could be any drive letter)
1. Press 1 to continue if you are satisfied with the default values.
2. Enter the applicable value if you are not satisfied with the default, and press 1 to continue.
3. Go to Step 10 after you press 1.
  The Install Location screen is displayed after you press 1.
You can also press 2 to go to the previous screen, 3 to Cancel, or 4 to Redisplay.
```
IBM System Storage DS Command-Line Interface Install Location

Please indicate the Novell location (volume:\directory) where this window J:
drive is mapped:

Enter a value: [SYS:]

Please indicate the JAVA HOME location on Novell: (JVM 1.4.1 or above is
required)

Enter a value: [SYS:\JAVA]

Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
```
(Windows and OS/400 only) Record the default directory path that is displayed in the Install Location screen for OS/400 and perform the following action (example: the Install Location screen shown at the end of this step):
1. Press 1 to continue if you are satisfied with the default value.
2. Enter the applicable value if you are not satisfied with the default, and press 1 to continue.
3. Go to Step 10 after you press 1.
  The Install Location screen is displayed after you press 1.
You can also press 2 to go to the previous screen, 3 to Cancel, or 4 to Redisplay.
```
Please indicate the directory where Java is installed on the OS/400

Enter a value: [/QOpenSys]

Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
```
Verify that the installation directory shown on the Install Location screen is the one you want the DS CLI application installed in. Press 1 to continue. The Installation Progress screen is displayed.
Note: Depending on the current configuration of your system, the total size of the installation can vary.

You can also press 2 to go to the previous screen, 3 to Cancel, or 4 to Redisplay.
```
IBM System Storage DS Command-Line Interface will be installed in the following
location:

C:\Program Files\ibm\dscli





for a total size:

 16.6 MB
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
```

Observe the installation progress and wait until the DS CLI installation is completed before pressing 1. Press 1 after the installation completes (there is no reminder to press 1 when the installation is completed). The Install Completed screen is displayed after you press 1.

Installing command-line Interface. Please wait...

Installing IBM System Storage DS Command-Line Interface. Please wait...



|-----------|-----------|-----------|------------|
0%         25%         50%         75%        100%
||||||||||||||||||||||||||||||||||||||||||||


|-----------|-----------|-----------|------------|
0%         25%         50%         75%        100%
||||||||||||||||||||||||||||||||||||||||||||||||||



Creating uninstaller...

Press 1 to continue if you are satisfied with the installation. The Readme screen is displayed (not shown).

You can also press 3 to Cancel, or 4 to Redisplay.

The InstallShield Wizard has successfully installed IBM System Storage DS
Command-Line Interface. Choose Next to continue the wizard.

Press 1 for Next, 3 to Cancel or 4 to Redisplay [1]

Press Enter to read the readme information or press 3 to finish the installation process. If you press Enter, you must press q to quit the readme file and then press 3 to finish the installation process. The Readme screen contains specific information about the DS CLI for your operating system.
Note: If you are installing on a Windows operating system, you might have to restart your system. If this is the case, the following screen is displayed and you must complete the next step.
```
To complete the installation you must restart your computer.
 
      [X] 1 - Yes, restart my computer.

      [ ] 2 - No, I will restart my computer at a later time.

 
 To select an item enter its number, or 0 when you are finished:
```
Select the restart computer item that you want and press 3 to finish the installation process. Use of the DS CLI application becomes effective with a reboot of your system.

You can verify that the command-line interface has installed correctly by reviewing the CLI.CFG file in the lib subdirectory of the install directory that you defined in Step 6.