Patch-ID# 114981-02
Keywords: esm diagnostic expert sunwsade sunwsadev global
Synopsis: Enterprise Storage Manager 1.2 patch
Date: Sep/15/2003


Install Requirements: None                      
                      
Solaris Release: 8 9

SunOS Release: 5.8 5.9

Unbundled Product: Sun Storedge Enterprise Storage Manager

Unbundled Release: 1.2

Xref: 

Topic: 

Relevant Architectures: sparc

BugId's fixed with this patch: 4764134 4816295 4821403 4838025 4843554 4844889 4845029 4845512 4845648 4848206 4850940 4854906 4860835 4891800 4905119

Changes incorporated in this version: 4764134 4860835 4848206 4821403 4844889 4816295 4891800 4905119

Patches accumulated and obsoleted by this patch: 

Patches which conflict with this patch: 

Patches required with this patch: 

Obsoleted by: 

Files included with this patch: 

/opt/SUNWdm/SUNWgre/gre/bin/config
/opt/SUNWdm/SUNWgrui/gre/lib/sscs-ui.jar
/opt/SUNWnsm/lib/libfchbaagent.so
/opt/SUNWnsm/lib/libfchbaagent.so.1
/opt/SUNWnsm/lib/libhostagent.so
/opt/SUNWnsm/lib/libhostagent.so.1
/opt/SUNWnsm/lib/libibfabagent.so
/opt/SUNWnsm/lib/libibfabagent.so.1
/opt/SUNWnsm/lib/libqlcoobagent.so
/opt/SUNWnsm/sbin/slplist
/opt/SUNWnsm/sbin/slplist.jar
/opt/SUNWnsm/util/apache/conf/httpd.conf.default
/opt/SUNWnsm/util/cre/components/discovery-impl.car
/opt/SUNWnsm/util/pgsql/nsm1/ddl/Create_NSM_Functions.ddl
/opt/SUNWnsm/util/pgsql/nsm1/ddl/Create_NSM_GUI_Views.ddl
/opt/SUNWnsm/util/pgsql/nsm1/ddl/Drop_NSM_Functions.ddl
/opt/SUNWnsm/util/pgsql/nsm1/ddl/patchadd-02.sql
/opt/SUNWnsm/util/pgsql/nsm1/ddl/patchrm-02.sql
/opt/SUNWnsm/util/tomcat/webapps/nsm/WEB-INF/lib/nsm.jar
/opt/SUNWsade/lib/jade.jar
/opt/SUNWsade/lib/minnow2600.jar
/opt/SUNWsade/lib/switch.jar

Problem Description:

4764134 StorADE cannot perform automatic discovery of switches when SSTR is running
4860835 vendor/model incorrect for switches not supporting GIEIL command
4848206 Asset Summary>Storage>Details for a 6320 displays the unique identifier as WWN
4821403 cli: asset status -v* t4-1 didn't list hot spare drive 14
4844889 Inrange switch IP format /xxx.xxx.xxx:xxx
4816295 management station doesn't find agents on multihomed machines
4891800 LUN device paths sometimes wrong with 2 mpxio partner pairs on different hosts
4905119 SSCS (ESM1.2) config fails on hosts preinstalled with ESM2.0
 
(from 114981-01)
4843554 info icon tooltip message is "null"
4838025 ESM:  Login is required several times on Netscape 4.7x
4850940 RFE: get rid of SLP dependency when necessary
4845648 I18N - fr: Viewing Components Internal error with server started in ja
4854906 diag97 cannot retrieve asset information from minnow 3510 (diag229)
4845512 I18N-Test Parameters are not displayed in zh/ja starting server in fr locale
4845029 Inaccurate number of seconds in chassis status fields

Patch Installation Instructions:
--------------------------------
For Solaris 7-8 releases, refer to the man pages for instructions
on using 'patchadd' and 'patchrm' scripts provided with Solaris.
Any other special or non-generic installation instructions should be
described below as special instructions.  The following example
installs a patch to a standalone machine:
 
       example# patchadd /var/spool/patch/114981-02
 
The following example removes a patch from a standalone system:
 
       example# patchrm 114981-02
 
For additional examples please see the appropriate man pages.

Special Install Instructions:
-----------------------------
Patch installation and backout stops the ESM processes, so they will need to
be restarted after this patch is installed or backed out.  To restart Topology
Reporter, as root enter this command:
 
	example# /etc/init.d/sstrd start
 
To restart Configuration Service, as root enter these commands:
 
	(if running on Solaris 8 enter this command)
	example# /etc/init.d/prngd start
 
	(for both Solaris 8 and 9 use these commands)
	example# /etc/init.d/sshd start
	example# /etc/init.d/sscs.wbem start
	example# /etc/init.d/sscs start
 
To restart Diagnostic Expert, as root enter this command:
 
	example# /etc/init.d/init.ssde start
 
------------------------------------------------------------------------------
 
TR uses SLP to find agent stations from the management station.  On some
networks agents aren't always successfully found this way.  To determine if the
agents are being discovered properly from the management station, as root enter
this command:
 
example# /opt/SUNWnsm/sbin/slplist
 
on the management station.  You should see output similar to the following:
 
Service URL: service:nws-agent-sun:http://<agent>:1024/fcgi-bin/qlc2-8agent
        Attribute: (agent-type=java.lang.String:zone)
        Attribute: (cim-class=java.lang.String:Sun_NSM_QLC_OOBFAB_Agent)
        Attribute: (supports-events=java.lang.Boolean:false)
        Attribute: (unique-id=java.lang.Integer:0)
        Attribute: (version=java.lang.String:1.0)
        Attribute: (vendor=java.lang.String:Qlogic)
        Attribute: (model=java.lang.String:Sanbox2-8C)
 
Service URL: service:nws-agent-sun:http://<agent>:1024/fcgi-bin/qlcSun1-8agent
        Attribute: (agent-type=java.lang.String:zone)
        Attribute: (cim-class=java.lang.String:Sun_NSM_QLC_OOBFAB_Agent)
        Attribute: (supports-events=java.lang.Boolean:false)
        Attribute: (unique-id=java.lang.Integer:0)
        Attribute: (version=java.lang.String:1.0)
        Attribute: (vendor=java.lang.String:Qlogic)
        Attribute: (model=java.lang.String:Sun SANbox-8)
 
....
(etc. - about 16 services listed for each agent station, with <agent> replaced
by the agent host's name)
 
If you do not see this output, then the agents aren't being discovered.  You
can bypass SLP (4850940) and tell the management station directly what the
agent stations are.  Do this by first creating the file
/opt/SUNWnsm/util/cre/persistence/agents.txt on the management station. In this
file, list each of the TR agent hostname:port values that the management
station should include in its discovery.  An example of what this file should
contain is:
 
# Comment lines start with a '#'.
# Here is an agent station hostname:port value.  The port is the value that the
# TR agent was configured with when esmconfig was run.
agent1:1024
# Here is another agent station, without the port value.  If no port value is
# listed, a default of 1024 will be assumed (1024 is the default esmconfig uses
# when configuring the agent station).
agent2
# Another agent:port value.  In this case, the agent has been configured (using
# esmconfig) with a port other than the default port value of 1024.
agent3:1026
 
 
After the file is edited, restart the management station:
example# /etc/init.d/sstrd stop
example# /etc/init.d/sstrd start
 
The TR management station would then use the three hosts (agent1, agent2, and
agent3) for its asset discovery.  Whenever another agent host is added to the
SAN, it will also need to be added to this file to facilitate TR discovery of
that host and its connections.  The management station does not need to be
restarted when adding or deleting agent hosts in the file;  it only needs to be
restarted when initially creating the file.
 
To ever go back to using SLP for TR agent discovery, remove the file
/opt/SUNWnsm/util/cre/persistence/agents.txt and restart the management station.
 
-----------------------------------------------------------------------------
 
If a TR agent station is on a multihomed machine (4816295), the management
station may not be able to discover the agent host and its assets.  This could
happen if the agent's default interface is different from the management
station's, and its hostname is not recognized by the management station.
 
If you run into this problem, you will need to create the SLP bypass file
(/opt/SUNWnsm/util/cre/persistence/agents.txt) on the management station as 
described above.  You should create this file even if the slplist command works,
since the URLs registered in SLP may have a hostname that is not recognized by 
the management station.  Use the agent hostnames that the management station 
recognizes.  SLP will be bypassed when this file is created, so you will need 
to put all agent hostnames into this file.  Even if some of the agents were 
being discovered before creating this file, they will still need to be listed 
since SLP will no longer be used to find them.
 
-----------------------------------------------------------------------------

README -- Last modified date:  Monday, September 15, 2003

