IBM®
Skip to main content
    Country/region [select]      Terms of use
 
 
     Home      Products      Services & solutions      Support & downloads      My account     
  IBM Wikis > AIX > Home > FAQ IBM DS8000 Device Driver and Command Line Client Installation on AIX v5
AIX Log In | Sign Up   View a printable version of the current page.
FAQ IBM DS8000 Device Driver and Command Line Client Installation on AIX v5
Added by Frank Kraemer, last edited by Frank Kraemer on Mar 29, 2006  (view change)
Labels: 
(None)

Still a draft version....sorry for the formatting

1) Download DS8000 Command Line Client from IBM ftp Server

/work> ftp ftp.software.ibm.com

ftp> cd /storage/ds8000/updates/DS8K_Customer_Download_Files/CLI
ftp> bin
ftp> hash
ftp> get DSCLI-5.1.600.196.tar.gz
ftp> quit

2) Unpack/tar Zip File to working directory (60 MB free space)

/work> zcat DSCLI-5.1.600.196.tar.gz | tar -xvf - ; cd ./cd_image

x ./cd_image
x ./cd_image/cliReadmes
x ./cd_image/cliReadmes/DS6000.pdf, 5764909 bytes, 11260 media blocks.
x ./cd_image/cliReadmes/DS8000.pdf, 6108185 bytes, 11931 media blocks.
x ./cd_image/cliReadmes/example_options_unix.txt, 3176 bytes, 7 media blocks.
x ./cd_image/cliReadmes/example_options_windows.txt, 3542 bytes, 7 media blocks.
x ./cd_image/cliReadmes/README_UNIX.txt, 7274 bytes, 15 media blocks.
x ./cd_image/cliReadmes/README_WINDOWS.txt, 7359 bytes, 15 media blocks.
x ./cd_image/cliReadmes/README_NOVELL.txt, 490 bytes, 1 media blocks.
x ./cd_image/media.inf, 12 bytes, 1 media blocks.
x ./cd_image/setup.jar, 22804977 bytes, 44541 media blocks.
x ./cd_image/setupaix.bin, 1378 bytes, 3 media blocks.
x ./cd_image/setupgenericunix.sh, 65536 bytes, 128 media blocks.
x ./cd_image/setuphp1020.bin, 94 bytes, 1 media blocks.
x ./cd_image/setuphp11x.bin, 94 bytes, 1 media blocks.
x ./cd_image/setuplinux.bin, 321 bytes, 1 media blocks.
x ./cd_image/setupsolarisSparc.bin, 843362 bytes, 1648 media blocks.
x ./cd_image/setupwin32.exe, 307963 bytes, 602 media blocks.
x ./cd_image/setupwin32console.exe, 279218 bytes, 546 media blocks.
x ./cd_image/README.txt, 5903 bytes, 12 media blocks.
x ./cd_image/README_OPENVMS.txt, 8016 bytes, 16 media blocks.
x ./cd_image/usr
x ./cd_image/usr/sys
x ./cd_image/usr/sys/inst.images
x ./cd_image/usr/sys/inst.images/ibmFCP_readme.txt, 16817 bytes, 33 media blocks.
x ./cd_image/usr/sys/inst.images/ibm2105_readme.txt, 24917 bytes, 49 media blocks.
x ./cd_image/usr/sys/inst.images/devices.scsi.disk.ibm2105.rte, 31744 bytes, 62 media blocks.
x ./cd_image/usr/sys/inst.images/devices.fcp.disk.ibm2105.rte, 31744 bytes, 62 media blocks.
x ./cd_image/usr/sys/inst.images/devices.fcp.disk.ibm.rte, 31744 bytes, 62 media blocks.
x ./cd_image/usr/sys/inst.images/.toc, 753 bytes, 2 media blocks.
x ./cd_image/snmp
x ./cd_image/snmp/ibm2100.mib, 13261 bytes, 26 media blocks.
x ./cd_image/snmp/SNMP_README.txt, 27825 bytes, 55 media blocks.
x ./cd_image/sl_internal.bin, 654991 bytes, 1280 media blocks.

2) Verify if Java 1.4.1 or later is installed

/work/cd_image>lslpp -l "Java.*"

Fileset Level State Description
----------------------------------------------------------------------------
Java14.license 1.4.2.0 COMMITTED Java SDK 32-bit License
Java14.samples 1.4.2.0 COMMITTED Java SDK 32-bit Samples
Java14.sdk 1.4.2.52 COMMITTED Java SDK 32-bit
Java14.source 1.4.2.52 COMMITTED Java SDK 32-bit Source
Java14_64.ext.commapi 1.4.2.0 COMMITTED Java SDK 64-bit Comm API Extension
Java14_64.ext.javahelp 1.4.2.0 COMMITTED Java SDK 64-bit JavaHelp
Java14_64.license 1.4.2.0 COMMITTED Java SDK 64-bit License
Java14_64.samples 1.4.2.0 COMMITTED Java SDK 64-bit Samples
Java14_64.sdk 1.4.2.51 COMMITTED Java SDK 64-bit
Java14_64.source 1.4.2.51 COMMITTED Java SDK 64-bit Source

3) /work/cd_image> ls -la

rw-rw-r- 1 root system 5903 Jul 28 2005 README.txt
rw-rw--- 1 root system 8016 Jul 28 2005 README_OPENVMS.txt
drwxrwx--- 2 root system 4096 Feb 17 20:17 cliReadmes
rw-rw--- 1 root system 12 Feb 17 20:17 media.inf
rw-rw--- 1 root system 22804977 Feb 17 20:17 setup.jar
-rwxrwxr-x 1 root system 1378 Aug 14 2004 setupaix.bin
rwxrwx-x 1 root system 65536 Feb 17 20:17 setupgenericunix.sh
-rwxr-xr-x 1 root system 94 Feb 17 20:16 setuphp1020.bin
-rwxr-xr-x 1 root system 94 Feb 17 20:16 setuphp11x.bin
rwxrw--- 1 root system 321 Feb 17 20:16 setuplinux.bin
rwxrwx-x 1 root system 843362 Feb 17 20:17 setupsolarisSparc.bin
rwxrwx-x 1 root system 307963 Feb 17 20:17 setupwin32.exe
rwxrwx-x 1 root system 279218 Feb 17 20:17 setupwin32console.exe
rwxrwx-x 1 root system 654991 Feb 17 20:17 sl_internal.bin
drwxr-xr-x 2 root system 256 Feb 17 20:16 snmp
drwxrwx--- 3 root system 256 Feb 17 20:17 usr

4) Installation of DS8000 Device Driver

This step is required if your AIX installation is attached via Fibre Channel (FC) / SAN
or SCSI to one or more DS8000 storage subsystems. This step is independent of step 5).

4.1) /work/cd_image> cd usr/sys/inst.images

4.2) /work/cd_image/usr/sys/inst.images> smitty install

4.3) Select AIX installp Filesets and apply/commit:

  • devices.fcp.disk.ibm.1.0.0.0.I
  • devices.fcp.disk.ibm2105.32.6.100.24.I
  • devices.scsi.disk.ibm2105.32.6.100.24.I

5) Installation of DS8000 Command Line Client (cli)

This step is required if your AIX installation is attached via TCP/IP to one or more DS8000
storage subsystems. This step is independent of step 4).

/work/cd_image> ./setupaix.bin -console

Passing these arguments to the generic installer: -console

Initializing InstallShield Wizard........
Verifying JVM.
Launching InstallShield Wizard........

-------------------------------------------------------------------------------
Welcome to the InstallShield Wizard for IBM TotalStorage DS Command-line Interface (CLI)
The InstallShield Wizard installs IBM TotalStorage 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 cliReames/ directory of this CD-ROM.

Press 1 for Next, 3 to Cancel or 4 to Redisplay [1] 1
-------------------------------------------------------------------------------
Please read the following license agreement carefully.

Use of the IBM TotalStorage 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 2006 International Business Machines Corporation All rights reserved.

Please choose from the following options:

[ ] 1 - I accept the terms of the license agreement.
[X] 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]

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

-------------------------------------------------------------------------------
IBM TotalStorage DS Command-line Interface Install Location

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

Directory Name: [/opt/ibm/dscli]

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

-------------------------------------------------------------------------------
IBM TotalStorage DS Command-line Interface will be installed in the following location:

/opt/ibm/dscli

for a total size: 30.1 MB

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

Installing IBM TotalStorage DS Command-line Interface. Please wait...

----------- ----------- ----------- ------------

0% 25% 50% 75% 100%

Updating the inventory ...
Creating uninstaller...

-------------------------------------------------------------------------------
The InstallShield Wizard has successfully installed IBM TotalStorage DS
Command-line Interface. Choose Next to continue the wizard.

Press 1 for Next, 3 to Cancel or 4 to Redisplay [1]
-------------------------------------------------------------------------------
Please read the information below.

IBM(R) TotalStorage(R) DS Command-Line Interface
for UNIX(R) or Linux(R) Host Systems

README
----------------------------------------------------------------
Contents

1.0 About this README file
1.1 Who should read this README file
1.2 Help contacts
2.0 Where to find more information
3.0 Contents of UNIX/Linux CLI package
4.0 Notices
5.0 Trademarks and service marks

---------------------------------------------------------------
1.0 About this README file

This README file tells you where to find user information
about the IBM TotalStorage DS Command-Line

Press ENTER to read the text [Type q to quit] q

Press 3 to Finish or 4 to Redisplay [3]

6) Verifiy Installation of DS8000 Command Line Client

6.1) /work/cd_image> find /opt/ibm/dscli -print

/opt/ibm/dscli
/opt/ibm/dscli/DS6000.pdf
/opt/ibm/dscli/DS8000.pdf
/opt/ibm/dscli/OSinfo.txt
/opt/ibm/dscli/README_UNIX.txt
/opt/ibm/dscli/_uninst
/opt/ibm/dscli/_uninst/uninstall.dat
/opt/ibm/dscli/_uninst/uninstall.jar
/opt/ibm/dscli/_uninst/uninstaller.bin
/opt/ibm/dscli/bin
/opt/ibm/dscli/bin/lshostvol.sh
/opt/ibm/dscli/bin/lshostvolSDD.sh
/opt/ibm/dscli/deinstl
/opt/ibm/dscli/deinstl/b7009594c1cc43f7830090d0380efe9e.inventory
/opt/ibm/dscli/deinstl/e7b8032d4fd4c66c7d9d12863d0967b6.inventory
/opt/ibm/dscli/dscli
/opt/ibm/dscli/lib
/opt/ibm/dscli/lib/CLI.CFG
/opt/ibm/dscli/lib/ESSNIClient.jar
/opt/ibm/dscli/lib/dscli.jar
/opt/ibm/dscli/lib/dsclihelp.jar
/opt/ibm/dscli/lib/hwmcaapi.jar
/opt/ibm/dscli/lib/ibmjsse.jar
/opt/ibm/dscli/lib/logger.jar
/opt/ibm/dscli/lib/rmcapi.jar
/opt/ibm/dscli/lib/ssgclihelp.jar
/opt/ibm/dscli/lib/ssgfrmwk.jar
/opt/ibm/dscli/lib/xalan.jar
/opt/ibm/dscli/lib/xerces.jar
/opt/ibm/dscli/profile
/opt/ibm/dscli/profile/dscli.profile

6.2) /work/cd_image> cat /opt/ibm/dscli/dscli

[...]

    1. Filename: dscli
      ##
    2. Subsystem: Software-cli
      ##
    3. usage dscli [
      Unknown macro: { -ver|-overview|-script file_name|command }
      ] [
      Unknown macro: { -help|-h|-? }
      ]
      ##
    4. Description: Execute DS Config/CopyServices commands.
      [...]

6.3) /work/cd_image> /opt/ibm/dscli/dscli -ver

> IBM DSCLI Version: 5.1.600.196

6.4) /work/cd_image> /opt/ibm/dscli/dscli -help > dscli-help.txt
/work/cd_image> more dscli-help.txt

The dscli command starts the command-line interface (CLI) program. Use
this command to run CLI commands in interactive mode, to run a single
command, or to run a set of commands from a script. For more information
about how to use this command, see "Completing DS CLI postinstallation."

>>- dscli------------------------------------------->
'- h---------' '- cfg- profile-'

- help
'- ?---'

- ver-------------
- overview--------
- script file_name
'- command-----------'

>--------------------------------------------------->
'- hmc1- HMC1-' '- hmc2- HMC2-'

>--------------------------------------------------->
'- user- user_name-' '- passwd- password-'

>--------------------------------------------------------><
'- pwfile- passwordfile-'

Parameters

-help | -h | -?
Displays a help screen about how to use the DS CLI program.

-ver
Displays the DS command-line interface version.

-overview
Provides overview information about the DS CLI application.

-script file_name
Initiates the script mode so that multiple dscli program commands can
be issued consecutively using a saved file.

file_name
(Required) Specifies the file with the stored program
commands to be executed.

Format options that are specified using the framework setoutput
command apply to all commands in the file. Output from successful
commands routes to stdout, and output from failed commands routes to
stderr. If an error occurs during the processing of one of the
commands in the file, the script exits at the point of failure and
returns to the system prompt.

command
Specifies the single command that you want to run.

-cfg profile
Specifies a profile file. This parameter is not required if you are
using default profiles. The default profile is the dscli.profile, and
it is provided as part of the DS CLI package under the profile directory.

-hmc1 HMC1
Specifies the primary management console IP address or the host name.

HMC1 (Required) The IP address for the primary management console.

-hmc2 HMC2
Specifies the secondary management console IP address or the host name.

HMC2 (Required) The IP address for the secondary management console.

-user user_name
Specifies your user name for issuing DS CLI commands on the command-line.

user_name
(Required) Your user name.

-passwd password
Specifies the password that you use for issuing DS CLI commands on the command line.

password
(Required) Your password.

This parameter is not required or recommended. If you use this method
to designate your password, the password is displayed on the screen.
Another option is to specify a password file (see the next parameter)
that is used when you start the DS CLI application.

-pwfile passwordfile
Specifies the password file that contains your password.

passwordfile
Specifies a password file as an alternative to the -passwd parameter.

7) Update default configuration profile for DS8000 Command Line Client

7.1) /work/cd_image> vi /opt/ibm/dscli/profile/dscli.profile

In order to ease the usage of the dslci command pre-define variables in the dscli.profile

7.2) DS CLI Profile

  1. Management Console/Node IP Address(es)
    hmc1: 9.155.xxx.xxx
  1. Default target Storage Image ID
    devid: IBM.2107-75ABTV1
  1. Define User and password
    username: admin
    password: password
  1. Output settings
    fullid: off
  1. Paging and Rows per page.
    paging: off
  1. Display banner message. "banner" is equivalent to option "-bnr on|off".
    banner: on
  1. Display table header for ls commands. "header" is equivalent to option "-hdr on|off".
    header: on
  1. Display verbose information. "verbose" is equivalent to option "-v on|off".
    verbose: off
  1. End of Profile

8) Generic Shell Script for AIX to run DS8000 cli scripts

8.1) Define Scripts

$ mkdir -p /opt/ibm/dscli/etc
$ cp file.sh /opt/ibm/dscli/etc/ds8k-run.sh
$ vi /opt/ibm/dscli/etc/ds8k-run.cmd

8.2) Listing of Script

( Script will follow soon ! )

8.3) Create and run new Scripts

$ ln -s /opt/ibm/dscli/etc/ds8k-run.sh /opt/ibm/dscli/etc/ds8k-new2.sh
$ vi /opt/ibm/dscli/etc/ds8k-new2.cmd
$ /opt/ibm/dscli/etc/ds8k-new2.sh

frank

Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.2.10 Build:#528 Nov 29, 2006)
    About IBM Privacy Contact