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.