IBM System Storage DS8000 A Quick Code Reference

Software Package for Supported Host Systems

The IBM System Storage DS8000 software package contains program code for the following products and utilities: v CIM agent for the IBM System Storage DS Open Application Programming Interface v IBM System Storage DS Command-Line Interface (CLI) v IBM System Storage DS Storage Manager for Windows v IBM System Storage DS Storage Manager for Linux v IBM System Storage DS8000 License Machine Code Agreement v IBM System Storage DS8000 Statement of Limited Warranty v IBM System Storage Multipath Subsystem Device Driver (SDD) Note: The documentation on the CDs is in portable document format (PDF). You must install the Adobe Acrobat Reader to view PDF documents. You can download a free version from the Adobe Web site at: http://www.adobe.com You might want to print the documentation before performing any of the installation and configuration tasks. For documentation updates, visit the IBM Publications Web site using the following URL: http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi?

Technical Support
Visit the following Web sites for technical support and related information: v IBM System Storage products: http://www.ibm.com/servers/storage v IBM System Storage DS8000 Storage Server Technical Support: http://www.ibm.com/servers/storage/disk/ds8000/index.html v CIM agent for the IBM System Storage DS Open Application Programming Interface Technical Support: http://www.ibm.com/servers/storage/support/software/cimdsoapi/

DS CLI
The DS CLI CD-ROM contains the program code and documentation for the DS CLI. You can use the DS CLI to manage and perform both storage management and advanced copy services functions from the command line as well as manage and monitor basic copy services functions.

Program code
This CDROM contains the following installation files for the DS CLI for all supported host systems.
Table 1. Installation files for DS CLI Supported host systems IBM AIX (5.1, 5.2, 5.3, 6.1) HewlettPackard-UX (11i, v1, v2) Linux (Red Hat 3.0 Advanced Server [AS] and Enterprise Server [ES]), RHEL 4, RHEL 5

Installation file name setupaix.bin setuphp1020.bin or setuphp11x.bin

Default directory for DS CLI /opt/ibm/dscli /opt/ibm/dscli

setuplinux.bin

/opt/ibm/dscli

SUSE Linux SLES setuplinux.bin 8, SLES 9, SUSE 8, SUSE 9, SLES10 Sun Solaris (7, 8, 9) HP Tru64 UNIX (5.1, 5.1A) Novell NetWare 6.5 Windows 2000, Windows Datacenter, and Windows 2003, Windows XP setupsolarisSparc.bin setupgenericunix.sh setupwin32.exe setupwin32.exe

/opt/ibm/dscli

/opt/ibm/dscli /opt/ibm/dscli SYS:\dscli C:\Program Files\IBM\dscli

UNIX users that AIX setupaix.bin do not have an X display Linux setuplinux.bin Note: You must add the -console parameter to these file names: v setupaix.bin -console v setuplinux.bin -console HP OpenVMS 7.3-1 (or later) IBM-AXPVMS-DSCLI-xx-1.PCSI xx represents the CLI release version.

/opt/ibm/dscli

SYS$SYSDEVICE:[VMS$COMMON.IBMDSCLI...] Note: This is the default when logical name PCSI$DESTINATION is not defined.

Notes: 1. For all host systems other than OpenVMS, you must remove any existing CLI (unless you plan to use an existing ESS 2105) from your host system before you install the new CLI code contained on this CD. 2. The DS CLI cannot be installed on a Windows 64-bit system. 3. For all host systems other than OpenVMS, you must have Java 1.4.1 or later installed on your machine. The installation program checks for this requirement during installation and does not install the DS CLI if you do not have Java 1.4.1 or later.

4. You must use the ksh (Korn shell) or bash (Bourne again shell) shell if you are installing on a HP Tru64. Installshield does not support the sh shell. You must perform all HP Tru64 installations using the setupgenericunix.sh file that is located on the installation compact disc.

Documentation
This CD contains the following documentation for installing the DS CLI and using the DS CLI commands:
Table 2. Documentation required for installing the DS CLI Title IBM System Storage DS8000 Command-Line Interface Users Guide CLI readme file for all supported host systems CD directory /cliReadmes/ /cliReadmes/ File name DS8000.pdf README_NOVELL.txt README_OPENVMS.txt README_UNIX.txt README_WINDOWS.txt

Perform the following steps to mount the CD on your host system:

Table 3. Procedure for mounting CDs Host system HP Tru64 UNIX CD mounting procedure 1. Log in to your host system as the root user. 2. Insert the DS CLI CD into the CD drive. 3. For a TRU64 V4.0F host system, enter the following command to mount the CD drive: mount -t cdfs -o noversion /dev/rzxx /mnt where xx represents the number of the CD devices. 4. For a TRU64 V5.0F host system, enter the following command: mount -t cdfs /dev/disk/cdrom0x /mnt where x equals the number of the CD devices HP-UX 1. Mount the CD to the SD_CDROM using the path name for your environment. 2. Type the following command to see the true device path to the CD drive: 3. ioscan -funC disk | more mount /dev/dsk/c?t?d? /SD_CDROM IBM AIX 1. Log on to your host system as a root user or administrator. 2. Insert the DS CLI product CD into the CD drive. If a window pops up for the CD drive, close the window. 3. Mount the CD drive using the mount command according to your system 4. Create a directory for the CD-ROM by entering the following command: mkdir /cdrom -p 5. Create a file system for the CD-ROM by entering the following command:crfs -v cdrfs -p ro -d cd0 -m /cdrom where cd0 presents the CD-ROM drive. 6. At the command prompt, type the following command to mount the CD drive: mount /cdrom Linux 1. At the command prompt, typemount /dev/cdrom to mount the CD drive. 2. Type cd /mnt/cdrom to change to the CD-ROM drive: Novell NetWare Installation is run remotely from Windows. CD mounting is not required.

Table 3. Procedure for mounting CDs (continued) Host system Sun Solaris CD mounting procedure 1. Log in to your host system as the root user. 2. Type the following command to stop the volume manager: /etc/init.d/volmgt stop 3. Type the following command to mount the CD:mnt mount -F hsfs -r /dev/dsk/c0t6d0s2 /mnt. Note: The device name /dev/dsk/c0t6d0s2 is the default name for Sun Solaris. The device name may be different on your system depending on your hardware configuration. Windows 1. Log onto your host system as an administrator user. 2. Insert the IBM System Storage DS8000 CDROM into the CDROM drive. 3. Select from the list of options when the launchpad displays. OpenVMS 1. Log on to your host system as a user with syslck, sysnam, sysprv (or a system UIC), tmpmbx, and cmkrnl privileges. 2. Insert the DS CLI CDROM into the CDROM drive. 3. For an IDE CDROM device DQA0, enter the following command to mount the CD drive: MOUNT /NOASSIST /OVERRIDE=IDENTIFICATION /MEDIA_FORMAT=CDROM DQA0 A message similar to the following is displayed:
%MOUNT-I-WRITELOCK,volume is write locked %MOUNT-I-CDROM_ISO, : (1 of 1) , mounted on VMS1$DQA0:

4. For a SCSI CD device DKAnnn, enter the following command: MOUNT /NOASSIST /OVERRIDE=IDENTIFICATION /MEDIA_FORMAT=CDROM DKAnnn where nnn represents the number that is assigned by the OpenVMS system to your CDROM device.

DS Storage Manager for Linux

The DS Storage Manager CDROM contains the program code and documentation for the DS Storage Manager. You can use the DS Storage Manager to manage and perform both storage management and copy services functions.

Program code
This CD contains an installation wizard that allows you to install the IBM System Storage DS8000 Storage Manager on the Linux (Red Hat AS 2.1) host system. Note: It is strongly recommended that you do not interrupt the program during the installation process by using abnormal methods (such as CTRL-C, closing the launchpad window, which is open behind the installation windows, or shutting down the power source). An interruption other than through the application windows Cancel button can cause unpredictable effects in the system. You can install the DS8000 Storage Manager in one of the following modes: Graphical Allows you to use an online installation wizard that guides you through the installation process. Unattended (also called silent mode) Involves customizing a response file and issuing a command to complete the installation process.

Documentation
The CD contains the following documentation for installing the DS8000 Storage Manager.
Table 4. Documentation required for installing the DS8000 Storage Manager Title IBM System Storage DS8000 Users Guide Installation and usage instructions Readme file for all supported host systems /doc CD directory /doc File name f2jug01.pdf Click the Users Guide link on the launchpad of the CD README.txt

Perform the following steps to install the DS Storage Manager in your Linux environment using the graphical mode: 1. Log on as a user with root authority. 2. Create a mount point or choose an existing mount point. 3. Determine where you want to mount the DS8000 Storage Manager CD. For example, if you mount the CD in drive /dev/cdrom at mount point /mnt/cdrom. 4. Insert the CD in the CD-ROM drive. Type the following command at the command prompt: # mount -o ro /dev/cdrom /mnt/cdrom 5. Choose the destination paths for the DS8000 Storage Manager components and be sure you have enough space available on the chosen destination. The installation program provides a default installation location (/opt/IBM/DS8000StorageManager) for the component. You can override this by using the installer browse function. When you click Next, the installer analyzes the available space for the location you provide. If there is not enough space, you are not able to proceed to the next panel in the installation process. 6. Change the current directory to the mount point for the CD-ROM drive. For example, if the CD was mounted at the /mnt/cdrom mount point, type the following command: # cd /mnt/cdrom . 7. Run the wizard launcher, launchpad_linux, by typing the following command: # ./launchpad_linux. The installation in graphical mode begins with a LaunchPad facility to launch the installation program wizard. 8. Follow the instructions on the wizard to complete the installation process.

DS Storage Manager for Windows

The DS Storage Manager CDROM contains the program code and documentation for the DS Storage Manager. You can use the DS Storage Manager to manage and perform both storage management and copy services functions. Installation is supported on the following Windows operating systems: v Windows 2000 Professional, Server, Advanced Server v Windows 2003 Server, Advanced Server v Windows XP Professional v Linux Red Hat AS 3.0 and 4.0

Program code
This CD contains an installation wizard that allows you to install the IBM System Storage DS8000 Storage Manager on the Windows host system.

Note: It is strongly recommended that you do not interrupt the program during the installation process by using abnormal methods (such as CTRL-C, closing the launchpad window, which is open behind the installation windows, or shutting down the power source). An interruption other than through the application window's Cancel button can cause unpredictable effects in the system. You can install the DS8000 Storage Manager in one of the following modes: Graphical Allows you to use an online installation wizard that guides you through the installation process. Unattended (also called silent mode) Involves customizing a response file and issuing a command to complete the installation process.

Documentation
The CD contains the following documentation for installing the DS8000 Storage Manager.
Table 5. Documentation required for installing the DS8000 Storage Manager Title IBM System Storage DS8000 Users Guide Installation and usage instructions Readme file for all supported host systems /doc CD directory /doc File name f2jug01.pdf Click the Users Guide link on the launchpad of the CD. README.txt

Perform the following steps to install the DS Storage Manager in your Linux environment using the graphical mode: 1. Log on as a user with administrator authority. 2. Insert the IBM System Storage DS Storage Manager CD into the CD-ROM drive. The IBM System Storage DS Storage Manager program starts within 15-30 seconds if you have autorun mode set on your system. The LaunchPad window is displayed. 3. If the LaunchPad window does not display, go to the CD-ROM drive using Windows Explorer or a command prompt and perform one of the following steps: a. Type LaunchPad at the command prompt and press Enter. b. Locate and double-click the LaunchPad.bat reference in Windows Explorer. 4. Follow the instructions on the wizard to complete the installation process.

Windows Server 2003 Virtual Disk Service Support

With Windows Server 2003 Microsoft introduced the Virtual Disk Service (VDS). It unifies storage management and provides a single interface for managing block storage virtualization. This interface is vendor and technology neutral, and is independent of the layer where virtualization is done, operating system software, RAID storage hardware, or other storage virtualization engines. This interface module makes it possible for the DS8000 storage server to interoperate with applications that use the VDS Application Programming Interface, denoted as VDS-aware applications, in a Windows environment.

IBM System Storage DS8000 series DS Open API support for Microsoft Virtual Disk Service
The VDS hardware provider supporting the IBM System Storage DS8000 series enables management of hardware RAID arrays in the Windows environment. Specifically, IBM System Storage DS8000 series customers are able to query vital health and status information at the subsystem, drive, and LUN levels, as well as perform LUN management operations on RAID arrays.

The DS8000 series leverage the Microsoft VDS framework to coordinate with VDS-aware applications like Microsoft Diskraid, Qlogic SANSurfer VDSManager, and SANSurfer Express to also create LUNs in the storage array, unmask LUNs to hosts, or delete LUNs.

Multipath Subsystem Device Driver

The Multipath Subsystem Device Driver (SDD) CD contains the program code and documentation for the Multipath SDD. The Multipath SDD is a pseudo device driver designed to support the multipath configuration environments in the DS8000. It resides in a host system with the native disk device driver and provides enhanced data availability, automatic path failover protection, dynamic I/O load-balancing across paths, and path-selection policies for the host system.

Numbering convention
To comply with the industry standard, Multipath SDD uses the following numbering convention for the Version Release Maintenance Fix (VRMF) naming, which consists of a four position identifier (for example, 1.2.2.0):
Position 1 Position Identifier Major SDD version change Description v Increments with a major change to SDD architecture/design. v Resets Positions 2, 3, and 4 to 0. 2 New SDD functions v Increments when a new device type or operating system is supported. v Increments across all release levels of the platform. v Resets Position 3 and 4 to 0. 3 SDD Maintenance level changes v Indicates new operating system release levels with or without new functions (for example, Windows 2000, Windows 2003) v New function that is not related to a specific operating system (for example, Veritas, APIs, new maintenance). v Device firmware update (for example, San Volume Controller 1.1.0 update to SAN Volume Controller 1.1.1) v Resets Position 4 to 0. 4 SDD Fixes v Increments with changes from maintenance, test, PTFs, SEV 1 and 2 fixes. v Resets to 0 for each SDD release and forces Position 3 to increment. This does not apply to the Sun Solaris platform.

Program code
This CD contains the following installation files for the SDD for all supported host systems:
Program Name Host Attachments Host Attachments Supported Host System(s) Installation File Name AIX with SDD AIX with SDDPCM /usr/sys/inst.images/devices.fcp.disk.ibm.rte /usr/sys/inst.images/devices.fcp.disk.ibm.mpio.rte

Program Name

Supported Host System(s) Installation File Name /usr/sys/inst.images/devices.sdd.52.rte /usr/sys/inst.images/devices.sdd.53.rte /usr/sys/inst.images/devices.sdd.61.rte /win2k/IBMsdd/ /win2k3/i386/IBMsdd /win2k3/IA64/IBMsdd /hp32bit/IBMsdd.depot /hp64bit/IBMsdd.depot /redhat/ /suse/

IBM Multipath AIX 5.2L Subsystem Device Driver AIX 5.3D AIX 6.1. Windows 2000 Windows 2003 HP-UX (11i) HP-UX (11iv2) Red Hat Enterprise Linux SuSE SLES 8 Linux

Miracle Linux, Red Flag or /asianux/ Asianux Sun Solaris 8 and 9 (32-bit) /sun32bit/IBMsdd/ Sun Solaris 8 and 9 (64-bit) /sun64bit/IBMsdd/ Novell Netware 5.1, 6.0, 6.5 IBM AIX MPIO Path Control Module AIX 5.2 AIX 5.3 AIX 6.1 2100Seas (2100 Storage Server SNMP Subagent) /install/INSTALL.NLM /usr/sys/inst.images/SDDPCM/devices.sddpcm.52.rte /usr/sys/inst.images/SDDPCM/devices.sddpcm.53.rte /usr/sys/inst.images/SDDPCM/devices.sddpcm.61.rte /snmp/ibm2100.mib

Note: The Multipath SDD and the DS CLI are two separate programs; they can be installed independently of each other.

Documentation
This CD contains the following documentation for installing and configuring the DS8000 SDD. It also contains documentation for attaching and configuring open-systems hosts to the DS8000:
Table 6. Documentation required for installing the SDD Title CD directory File name f2bsdu08.pdf f2jhsa01.pdf readmexxx.txt Where xxx indicates the operating system /isReadmes/ rd_xxx.txt Where xxx indicates the operating system

IBM System Storage Multipath /sddReadmes/ Subsystem Device Driver Users Guide IBM System Storage DS8000 Host Systems Attachment Guide SDD readme files for supported host systems Installation script readme files for supported host systems /isReadmes/ /sddReadmes/

The IBM System Storage Multipath Subsystem Device Driver Users Guide contains chapters for the Windows 2000, AIX, SUN, HP, Linux and Novell versions of the SDD code. Please read the appropriate chapter and the README file, before attempting to install Subsystem Device Driver.

CIM agent for the IBM System Storage DS Open Application Programming Interface
The CIM agent for the IBM System Storage DS Open Application Programming Interface CD contains the program code and documentation for the CIM agent. The CIM agent is middleware client application that provides a CIM-compliant interface. The CIM API provided by the CIM agent supports CIM Schema 2.11.0 for Storage Management as defined by the SNIA Storage Management Initiative Specification (SMIS). Therefore, it provides support for applications that require or can use it.

Program code
This CD contains the installation files for the CIM agent. You can install the CIM agent using the graphical or unattended mode. Note: Available fixes to the CIM agent can be downloaded from the CIM agent Technical Support Web site: http://www.ibm.com/servers/storage/support/software/cimdsoapi/

Documentation
This CD contains the following documentation for installing and configuring the CIM agent:
Table 7. Documentation required for installing the CIM API Title IBM System Storage DS Open Application Programming Interface CIM Agent readme file for all supported host systems CD directory /doc /doc File name installguide.pdf W2003/README.txt is for Windows AIX/README.aix is for AIX LINUX_SLES9/README.linux and LINUS_RHEL3/REDAME.linux are for Linux licenseinfo.pdf

License Information

/doc

The CIM agent for the IBM System Storage DS Open Application Programming Interface also provides a quick reference for the CIM agent object classes. The description is provided for your reference.

Documentation
The following documentation is available for the DS8000. Find the latest versions on the IBM Publications Web site using the following link: http://www.elink.ibmlink.ibm.com/public/applications/publications/ cgibin/pbi.cgi
Table 8. Documentation available for the DS8000 Title IBM System Storage DS8000 Users Guide IBM System Storage DS8000 Introduction and Planning Guide Description This publication provides instructions for using the DS8000, including Copy Services functions. This publication introduces the DS8000 product and lists the features tjat you can order. It also provides guidelines for planning the installation and configuration of the storage unit. Format PDF File name f2jug01.pdf

PDF

f2jipg04.pdf

Table 8. Documentation available for the DS8000 (continued) Title Description Format PDF PDF File name f2jhsa01.pdf f2jciu02.pdf

IBM System Storage DS8000 This publication provides guidelines for Host Systems Attachment Guide attaching the DS8000 to your host system. IBM System Storage DS8000 This publication describes the commands Command Line Interfaces Users that you can use from the command-line Guide interface (CLI) for managing your DS8000 configuration and Copy Services relationships. IBM System Storage DS Open Application Programming Interface Reference This publication provides reference information for the IBM System Storage DS application programming interface (API) and provides instructions for installing the Common Information Model Agent, which implements the API. This publication provides explanations of error, information, and warning messages that are issued from the DS8000 user interfaces.

PDF

f2jap02.pdf

IBM System Storage DS8000 Messages Reference

PDF

f2jmsg01.pdf

IBM System Storage Multipath This publication describes how to use the Subsystem Device Driver Users IBM Subsystem Device Driver (SDD) on Guide open-systems hosts to enhance performance and availability on the DS8000. SDD balances the workload across paths, and it transparently integrates with applications. IBM System Storage DS8000 Information Center The InfoCenter allows you to browse and search information on the IBM System Storage DS8000 packaged as Eclipse documentation plug-ins.

PDF

f2bsdu08.pdf

HTML

Not applicable

Printed in USA Copyright International Business Machines Corporation 2007. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

(1P) P/N: 17P9935