Complete this task to install the DS CLI on your system
using the graphical installation mode. Users of Windows, Novell NetWare, UNIX, Linux, and System i® systems can install the DS CLI
using the graphical mode.
Before you begin
Consider the following requirements before you
install the DS CLI:
About this task
Notes: - From the command line, you can use the -i parameter to
specify any user interface mode when installing 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 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 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, Novell NetWare, or OS/400® installation) Select the target
system (Windows, Novell NetWare, or OS/400) where you want the DS CLI installed,
and then click Next to continue or Cancel to
exit the installation.
- Select Windows as
your target system for all systems except Novell NetWare and OS/400.
When you select Windows and
click Next, the Choose Install Folder window
is displayed.
- When you select Novell NetWare and click Next,
the Novell Location window is displayed. Go to Step 6 to continue
the installation.
- When you select OS/400 and click Next,
the OS/400 System Information
window is displayed. Go to Step 7 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 8 to continue
the installation process.
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
7 to
continue the installation process.
- (Novell NetWare installation) When you select Novell NetWare and click Next,
the Choose Install Folder window is displayed. Click Next to
continue. Complete the information on the Set Novell NetWare Configuration window. You are asked to supply the location where the Windows drive is mapped and
where the Java home directory
that contains the version of Java you
want to use is located. Click Next to continue
the installation. Click Cancel if you want
to exit the installation.
When you click Next to
continue the installation, the Pre-Installation Summary window
is displayed. Go to Step 8 to continue
the installation process.
- (OS400 installation)
On the OS/400 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 8 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 have programmed anything using the output,
you should 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
- HP-UX
- /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
- HP Tru64 UNIX
- /opt/ibm/dscli
- IBM i
- /ibm/dscli
- Novell NetWare
- SYS:\IBM\dscli