Installing the DS CLI by using the graphical mode

Complete this task to install the DS CLI on your system by using the graphical installation mode. Users of Windows, UNIX, Linux, and IBM i systems can install the DS CLI using the graphical mode.

Before you begin

Consider the following requirements before you install the DS CLI:

You must have a version of Java™ 6 or later that is installed on your system in a standard directory. The DS CLI installer checks the standard directories to determine whether a version of Java 6 or later exists on your system. If this version is not found in the standard directories, the installation fails.
Note: Ensure that you use Java 6 or later.
If the DS CLI is installed on your client or host system, you must end any active sessions of the DS CLI before you run the DS CLI installation CD.
IBM and i5/OS™ installations have the following requirements:
- The latest Java group program temporary fixes (PTF)
- The i5/OS 5722-SS1 option 34 - Digital certificate manager
- The workstation that you are installing from must be connected to the i5/OS through an IP connection.

About this task

Notes:

From the command line, you can use the -i parameter to specify any user interface mode when you install the DS CLI: -i [swing | console | silent]. The default mode for installing Windows is swing. The default for UNIX and Linux is console mode. You do not have to specify the mode in the command unless you want to use something other than the default mode.
While in console mode, you can type back to return to the previous screen, or quit to exit the installation.

You can install the DS CLI by 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. You might also be required to open a new command prompt window to start a DS CLI session.

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

Complete the following steps to install the DS CLI by using the graphical mode:

Procedure

Start the setup file that is appropriate for your operating system. You can find the setup file on the installation CD by navigating to images/HMC\Disk1\InstData, and then selecting your platform to find the appropriate setup file. For example, in Windows the path would be images/HMC\Disk1\InstData\Windows\NoVM\dsclisetup.exe.
The Introduction window is displayed.
Initially (for all types of installation), 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 one of the following messages:
- If you are using Windows, the following message is displayed:
```
LaunchAnywhere Error: Could not find a valid Java virtual machine to load.

You may need to reinstall a supported Java virtual machine.
```
- If you are using Unix or Linux, the following message is displayed:
```
No Java virtual machine could be found from your PATH
environment variable.  You must install a VM prior to
running this program.
```
The manner in which you respond to this message depends on your operating system and your installation environment settings. If the installation fails because the correct version of Java is not found, see Correcting the Java Virtual Machine Not Found Error.
Click Next on the Introduction window to continue or Cancel to exit the installation. When you click Next the License Agreement window is displayed.
Select I accept the terms of the License Agreement and click Next to continue. Select I do not accept the terms of the License Agreement and Cancel to exit the installation.
In Windows, when you accept the agreement and click Next, the SelectTarget System window is displayed(See Step 4. Otherwise, proceed to step 5.
(Windows or IBM i installation) Select the target system ( Windows or IBM i) where you want the DS CLI installed, and then click Next to continue or Cancel to exit the installation.
1. Select Windows as your target system for Windows or IBM i. When you select Windows and click Next, the Choose Install Folder window is displayed.
2. When you select IBM i and click Next, the IBM i System Information window is displayed. Go to Step 6 to continue the installation process.
Verify that the directory name that is shown in the Choose Install Folder window is the directory where you want to install the DS CLI. If it is not the correct directory, enter the directory path in the input field. Click Next to continue the installation. Click Cancel to exit the installation.
When you click Next to continue the installation, the Pre-Installation Summary window is displayed. Go to Step 7 to continue the installation process.

Note: If you are installing onto an IBM 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 6 to continue the installation process.
(IBM i installation) On the IBM i System Information window, confirm that any previous versions of the CLI have been uninstalled and then click Next. On the Enter Sign On Credentials window, enter the iSeries system name, user name, and password. Click Next to continue. The Pre-Installation Summary window is displayed. Go to Step 7 to continue the installation process.
(Pre-Installation Summary window) Verify that the displayed information is accurate. 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 Install to continue or Cancel to exit the installation. You can change the installation directory by clicking the Previous button.
When you click Install to continue the installation process, the Installation progress window is displayed.
(Installation progress window) This window provides the progress bar that reflects the progress of the installation as the files are installed. After the installation is complete, click Next to continue or Cancel to exit the installation.
When you click Next to continue the installation process, the Important Information window is displayed.
(Important Information window) This window provides you with the opportunity to read the readme file. Click Done to complete the installation.

What to do next

Notes:

The DS CLI is installed in the following two places in i5/OS:
- IFS directory IBM/DS_CLI. This directory contains the profiles, .EXE files, Java .JAR files, readme files, and so on.
- The QDSCLI library. This library contains executable code.
  Note: Beginning in Version 6 Release 1, the QDSCLI library output is stored in the output file that you specified in the DS CLI. Errors will be stored in a file of the same name with .error appended to it. If you programmed anything using the output, update your programs to look in both the specified file and the .error file to get a complete view of the results.
Before you can start the DS CLI from the i5/OS, you must add the QDSCLI library to the i5/OS library list.
You can check the following directories to verify that the DS CLI has been installed for your operating system:
AIX®

/opt/ibm/dscli

Linux

/opt/ibm/dscli

Oracle Solaris

/opt/ibm/dscli

Windows

(32-bit) C:\Program Files\IBM\dscli

(64-bit) C:\Program Files (x86)\IBM\dscli

IBM i

/ibm/dscli

z/OS

/opt/IBM/CSMDSCLI/dscli