IBM System Storage CIM Agent for the DS Open API 5.4.0 Readme for Linux ---------------------------------------------------------------- Contents 1.0 ABOUT THIS README FILE 1.1 Who should read this readme file 1.2 Where to find more information 1.3 How to get help 2.0 CONTENTS OF THE CIM AGENT PACKAGE 3.0 LAST-MINUTE TECHNICAL UPDATES 4.0 SERVICE LOCATION PROTOCOL INSTALLATION --------------------------------------------------------------- 1.0 ABOUT THIS README FILE This readme file tells you where to obtain information about the IBM System Storage CIM Agent for the DS Open API 5.4.0 and how to get help. It also lists the contents of the installation package for the Linux host system. 1.1 Who should read this readme file This readme file is intended for system administrators who are familiar with the Linux environment and will install and configure the IBM System Storage CIM Agent. 1.2 Where to find more information See the "IBM System Storage CIM Agent for the DS Open API Installation and Configuration Guide" for complete information about installing and configuring the IBM System Storage CIM agent for the DS Open API. You can find the guide in the doc directory at the root of the IBM System Storage CIM Agent CD. The Adobe Acrobat Reader version 4.0 or later is required to read this document. The Adobe Acrobat Reader can be downloaded from the following Web site: http://www.adobe.com/support/downloads/main.html For additional information, visit the CIM Agent for DS Open API support Web site: http://www.ibm.com/servers/storage/support/software/cimdsoapi/ A Frequently Asked Questions page is available by navigating to Troubleshooting -> Technical notes -> IBM CIM Agent for DS Open API FAQ 1.3 How to get help * Administrative or non-technical support: 1-877-426-6006 (Listen to voice prompts) You can call this number if you have questions about hardware or software orders, hardware maintenance, services contracts of entitlement, invoices, or commercial, state, or local support operations. * Business Partner Support Operations: 1-800-426-9990 * Federal Government Support Operations: 1-800-333-6705 --------------------------------------------------------------- 2.0 CONTENTS OF THE CIM AGENT PACKAGE _uninst - Contains uninstallation program bin - Contains user scripts certificate - Contains SSL certificates and keys config - Contains configuration files java - Contains the Java Runtime Environment lib - Contains various xml, java libraries license - Contains license agreement files log - Contains logs mof - Contains CIM 2.11 + IBM MOF files pegasus - Contains internal Pegasus CIMOM files slp - Contains SLP ssl - Contains SSL startup - Contains startup scripts used by the installer --------------------------------------------------------------- 3.0 LAST-MINUTE TECHNICAL UPDATES 3.1 ****** LINUX Specific ****** NA 3.2 ****** General ****** * When upgrading from CIM Agent Release 5.1, it is suggested that you uninstall the 5.1 CIM Agent before installing a 5.2.x, 5.3.x, or 5.4.x CIM Agent. When upgrading from a 5.2.1 CIM Agent to a newer 5.2.x, 5.3.x, or 5.4.x CIM Agent, it is safe to do a normal upgrade. * Only superuser can create/modify other users. superuser cannot be deleted. Its password can be changed with dscimcli chuser. * The DS6000/DS8000 firmware keeps audit logs to keep track of configuration activity on the storage device. In order to distinguish what activity was generated through the CIM Agent, it is suggested that you use DS Storage Manager to create a user account specifically for the CIM Agent. * If you create a fixed block volume on a CKD LCU, or a CKD volume on a FB LSS, the volume will get created on another valid LSS or LCU instead of returning an error. * FCPort.Speed shows as 0 for DS6k and DS8k devices. * When adding a dual-HMC device using dscimcli mkdev, if you specify the -ip2 parameter, and the second HMC is not responding, you may still see a connection error returned, even if the primary HMC is healthy. * If you use dscimcli mkdev to add a device and you use the wrong password, the DS6K and DS8K devices have a setting that allows the storage administrator to disable the account after too many unsuccessful attempts. The default behaivior is to lock the account after three attempts. However, this behavior is managed by the storage administrator and can be set to anything from -never lock system to 1 to 9 attempts before locking the account, * IBMTSDS_Volume.ExtentStatus currently does not reflect whether or not it is currently mapped to a host (In-Band Access Granted). * When you create or delete a FlashCopy (UnSyncAssoc) relationship for ESS, you will receive duplicate events for the creation and deletion of IBMTSDS_StorageSynchronized. 3.3 ****** NEW FEATURES IN THIS RELEASE ****** * Correlatable and Durable Volume Names available. 3.4 ****** ISSUES FIXED SINCE LAST RELEASE ****** * Issue where connections to ESS Copy Services would not recover after the device fails has been resolved. --------------------------------------------------------------- 4.0 SERVICE LOCATION PROTOCOL INSTALLATION If a Service Location Protocol Linux service was detected on the system at the time of installation of the IBM System Storage CIM Agent for DS Open API, the Service Location Protocol files included with the IBM System Storage CIM Agent for DS Open API will be copied to disk. However, the Service Location Protocol associated with these files will not be installed as a Linux service. In the event you uninstall the product associated with the Service Location Protocol, the Service Location Protocol Linux Service will be uninstalled. You can establish a new Service Location Protocol Linux Service by launching the following command: 1. cp /startup/dsslpd /etc/init.d/dsslpd 2. /sbin/chkconfig -add dsslpd where is the directory where the IBM System Storage CIM Agent for the DS Open API is installed. --------------------------------------------------------------- (c) Copyright 2006 International Business Machines Corp. All rights reserved. Note to U.S. Government Users Restricted Rights--Use duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.