Installing the DS CLI using the graphical mode

Complete this task to install the DS CLI application on your system using the graphical installation mode.

Users of Windows, Novell, UNIX, and System i systems can install the DS CLI using the graphical mode. 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.
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 JAVA HOME directory where the version of Java that you want to use is located.
System i and i5/OS installation considerations:
- 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 installed on the i5/OS
- The machine that you are installing from must be connected to the i5/OS through an IP connection.

You can install the DS CLI application using the graphical mode with the help of an installation wizard. 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.

Note: After you install the new version of DS CLI, your old DS CLI sessions might be unusable.

Perform the following steps to install the DS CLI application using the graphical mode:

Start the setup file that is appropriate for your operating system.
If you are ultimately installing the DS CLI onto a System i system, add -os400 to your command that includes the setup file. For example, setupwin32.exe -os400
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>
```
Go to Step 2 if you are installing for a System i system.

Go to Step 3 for all installations other than System i.
The installation wizard displays a sign-on panel that directs you to provide the name of the System i system to which you are installing the DS CLI application. You must provide the IP address or the DNS name of the i5/OS server. In addition, you must also supply the user name and password that is used to access the designated System i system. Click OK.
The Welcome window opens. Click Next to continue or Cancel to exit the installation.
The License Agreement window opens. Select "I accept the terms of this license agreement" to continue. Click "I do not accept the terms of this license agreement" or Cancel to exit the installation.
The Target System window opens. Select the appropriate target system where you want the DS CLI installed, and then click Next to continue or Cancel to exit the installation.
The Installation Location window (Windows has been selected as your operating system) opens. If you selected Novell, go to Step 7. If you are installing on a Linux system, go to Step 9. If you are satisfied with the Windows default directory, click Next. If not, type the directory path where you want to install the DS CLI and click Next. Do not use blank spaces in the installation path. Click Cancel if you want to exit the installation.

Note: If you are installing onto a System i system, a window that asks for the directory where Java is installed on the i5/OS is displayed when you click Next. Go to Step 8.
The Novell Location window opens. Complete the information for where the Windows drive is installed and where the JAVA HOME directory that contains the version of Java you want to use is located. Click Cancel if you want to exit the installation.
The Java directory window for the System i system opens. Insert the directory information. Click Next to continue or Cancel to exit the installation.
The Installation Preview window opens. This window provides the location where the command-line interface will be installed and specifies how much space it will occupy on your drive. Click Next to continue or Cancel to exit the installation. You can change the installation directory by clicking Back.
The Installation Progress window opens. This window provides the progress of the command-line interface installation. Click Next to continue or Cancel to exit the installation.
The Installation Summary window opens. This window provides the installation summary information. Click Next to continue or Cancel to exit the installation.
The Installation Complete window opens. A reminder is provided in text to read the Readme file. Click Finish to complete the installation.

Notes:

You can verify that the command-line interface has installed correctly by reviewing the CLI.CFG file in the lib/ directory.
The DS CLI application is installed in the following two places in i5/OS:
- IFS directory IBM/DS_CLI. This directory contains the profiles, exe files, java jars, readme files, and so forth.
- The QDSCLI library. This library contains executable code.
Before you can invoke the DS CLI application from the i5/OS, you must add the QDSCLI library to the i5/OS library list.