Sei sulla pagina 1di 50

EMC Smarts

Version 8.1.4 Patch 10 Readme


for
IP, Multicast and SAM Adapters

Readme
P/N 302-001-129
Rev 02

Copyright 1996 - 2014 EMC Corporation. All rights reserved. Published in the USA.
Published August, 2014
EMC believes the information in this publication is accurate as of its publication date. The
information is subject to change without notice.
The information in this publication is provided as is. EMC Corporation makes no representations or
warranties of any kind with respect to the information in this publication, and specifically disclaims
implied warranties of merchantability or fitness for a particular purpose. Use, copying, and
distribution of any EMC software described in this publication requires an applicable software
license.
EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the
United States and other countries. All other trademarks used herein are the property of their
respective owners.
For the most up-to-date regulatory document for your product line, go to EMC Online Support
(https://support.emc.com).
EMC Smarts Version 8.1.4 Patch 10 Readme

EMC Smarts Version 8.1.4 Patch 10 Readme

Contents

The document contains information about the EMC Smarts Version 8.1.4 Patch 10
release (EMC Smarts 8.1.4.10).
Revision history ..................................................................................................... 5
Scope .................................................................................................................... 5
Patch description ................................................................................................... 5
Enhancements and changes .................................................................................. 9
Known problems and limitations .......................................................................... 11
Number of fixed defects and certified devices ...................................................... 16
Fixed Defects ....................................................................................................... 17
Certified devices .................................................................................................. 30
Environment and system requirements ................................................................ 37
Installation........................................................................................................... 38
Log files ............................................................................................................... 44
Reconcile user-modifiable files ............................................................................ 45
Uninstallation ...................................................................................................... 48
Troubleshooting and getting help ......................................................................... 50
Note: Patch Readme documents for a specific release are now consolidated into a
single document. Patch Readme documents as well as product
documentation for all releases are available as a download from EMC Online
Support (https://support.emc.com).

EMC Smarts Version 8.1.4 Patch 10 Readme

Contents

4 EMC Smarts Version 8.1.4 Patch 10 Readme

Revision history

Revision history

This section presents the revision history of this document.


Table 1.

Scope

Revision history

Revision

Release Date

Description

01

July, 2014

First release of EMC Smarts Version 8.1.4 Patch 10 Readme.

02

August, 2014

Second release of EMC Smarts Version 8.1.4 Patch 10 Readme.


Added Red Hat 6 setup file to the list of MCAST Patch Installation
files on page 7.

This section presents the product scope for this patch release.
Table 2.

Products released in this patch

Patch Release

Release date

Product (s) released in this patch

EMC Smarts Version


8.1.4 Patch 10

July, 2014

IP, Multicast and SAM Adapters

EMC Smarts Version


8.1.4 Patch 7

Dec, 2013

Multicast and SAM Adapters

EMC Smarts Version


8.1.4 Patch 6

July, 2013

IP and SAM

EMC Smarts Version


8.1.4 Patch 5

May, 2013

IP, SAM, SAM Adapters, VoIP, MPLS, Multicast, and


NPM

EMC Smarts Version


8.1.4 Patch 4

April, 2013

IP, SAM, SAM Adapters and VoIP

EMC Smarts Version


8.1.4 Patch 3

March, 2013

IP, SAM, SAM Adapters, VoIP, MPLS, Multicast, and


NPM

Patch description

A patch provides one or more fixes to an EMC Smarts product. A patch can only be
applied to the specific major or minor release and Service Pack of the particular
product for which it is intended; this is called the products baseline.
Note: All EMC Smarts 8.1.x products will not be released for every patch release. A
patch may apply only to a subset of products, for example, the next patch
release may be only for SAM and IP. Also, if the latest patch version for all
products is 4 and patch 5 is only for SAM and IP, the next patch number
irrespective of which product is released will be patch 6.

EMC Smarts Version 8.1.4 Patch 10 Readme

Patch description

Installation directory
In this document, the term BASEDIR represents the location where EMC Smarts
software is installed.

For UNIX, the default location is: /opt/InCharge/<productsuite>.

For Windows, the default location is: C:\InCharge\<productsuite>.

The <productsuite> represents the EMC Smarts product suite to which the product
belongs.
Optionally, you can specify the root of BASEDIR to be something other than
/opt/InCharge (on UNIX) or C:\InCharge (on Windows), but you cannot change name
of the <productsuite> that is part of the BASEDIR.
The System Administration Guide provides additional information about the directory
structure of EMC Smarts software.

Installation overview
A patch installs files to the BASEDIR/smarts/local directory of the product. The
Installation software performs the following actions:

Backs up all files that are being replaced or merged.

Merges changes from your current, user-modifiable configuration files into the
new versions of the files from the patch.

Displays a list of files that were merged and files that could not be merged due
to conflicts.

Displays the location of a log file that lists the results of merging the files.

Leaves user-modifiable files that are not updated by the patch untouched.

Note: If the original product was installed on one computer and then was copied to
another computer, the patch cannot be applied to the copied installation. You
must apply the patch to the computer with the original installation, and then
the results can be copied to another computer.

JRE requirement for Installation software


If the patch Installation software cannot find the correct version of the JRE, it displays
the message: A suitable JVM could not be found.
If this occurs, use the is:javahome option to specify the absolute path of the JRE
installed with the EMC Smarts software on one line. For example:
./setup-IP-linux-rhAS50-8_1_4_10-20140626-64BIT.bin -is:javahome BASEDIR/IP/_jvm
./setup-MCAST-linux-rhAS50-8_1_4_10-20140623-64BIT.bin -is:javahome BASEDIR/IP/_jvm
./setup-SAMADP-linux-rhAS50-8_1_4_10-20140626.bin -is:javahome BASEDIR/SAM/_jvm

6 EMC Smarts Version 8.1.4 Patch 10 Readme

Patch description

Or, if software is being installed in Wizard mode and an error message is thrown
saying Cannot find a compatible JVM. Select the java.exe file of the JVM from the
<BASEDIR>/_jvm/bin directory.
Note: The term BASEDIR represents the location where EMC Smarts software is
installed; for example, C:/InCharge/<productsuite>.

Install a new patch over an older patch

Patches are cumulative; each successive patch includes all of the fixes from any
previous patches. As a result, a newer patch can be installed on top of an older
patch. The patch number, which increments itself for each successive patch,
indicates the version. A patch with higher version number can be installed over a
patch with a lower version number.
The Installation software checks the version of the installed product and the version
to be installed at the beginning of its process. It will not allow an older version to be
installed on top of a newer version.

Upgrade after applying a patch

During an upgrade, the Installation software automatically uninstalls any applied


patches. Patch files, which are installed to BASEDIR/smarts/local, are removed if the
files are not modified by the user. The files that are modified are not removed and are
copied to <BASEDIR>/smarts/.local.bkp.<patch version> directory for manual
reconciliation.
Note: <patch version> is the complete version number for the patch, for example,
8.1.4.10

Patch installation files

Install the patch on each host where the EMC Smarts product is running. Choose the
appropriate Installation software based on the operating system of the host.
IP

setup-IP-linux-8_1_4_10-20140626-64BIT.bin

setup-IP-linux-rhAS50-8_1_4_10-20140626-64BIT.bin

setup-IP-solaris-8_1_4_10-20140626-64BIT.bin

setup-IP-win-8_1_4_10-20140626-64BIT.exe

Multicast

setup-MCAST-linux-8_1_4_10-20140623-64BIT.bin

setup-MCAST-linux-rhAS50-8_1_4_10-20140623-64BIT.bin

EMC Smarts Version 8.1.4 Patch 10 Readme

Patch description

setup-MCAST-linux-rhAS60-8_1_4_10-20140806-64BIT.bin

setup-MCAST-solaris-8_1_4_10-20140623-64BIT.bin

setup-MCAST-win-8_1_4_10-20140623-64BIT.exe

SAM Adapter:

setup-SAMADP-linux-8_1_4_10-20140626.bin

setup-SAMADP-linux-rhAS50-8_1_4_10-20140626.bin

setup-SAMADP-solaris-8_1_4_10-20140626.bin

setup-SAMADP-win-8_1_4_10-20140626.exe

8 EMC Smarts Version 8.1.4 Patch 10 Readme

Enhancements and changes

Enhancements and changes

This patch release contains the following enhancements and changes:

Enhancements and changes in IP

Enhancements and changes in SAM

Enhancements and changes in SAM Adapters

Enhancements and changes in VoIP

Enhancements and changes in MPLS

Enhancements and changes in MCAST

Enhancements and changes in NPM

Enhancements and changes in IP

This patch release contains the following enhancements and changes:

Card redundancy Group was not created for Juniper ERX 1440
CQ 654585
Issue
Card redundancy Group was not created for Juniper ERX 1440
.1.3.6.1.4.1.4874.1.1.1.1.3
Resolution
Modified the driver to identify the cards participating in the redundancy group based
on redundancy slot information and create the card redundancy group.
Modified Files
local/conf/discovery/DISCOVERY_UNISPHERE.import
local/rules/discovery/ic-unisphere-erx-cont.asl
local/lib/libsm_devstat_unisphere.so

Certification for Juniper PTX3000 .1.3.6.1.4.1.2636.1.1.1.2.98


CQ 616116
Issue
Certification for Juniper PTX3000 .1.3.6.1.4.1.2636.1.1.1.2.98
Resolution
This device is certified in IP.
Modified Files
local/conf/discovery/oid2type_Juniper.conf
local/conf/discovery/JuniperPowerType.conf
local/rules/discovery/ic-juniper-chassis-ptx.asl
local/rules/discovery/ic-juniper-health-ptx.asl

EMC Smarts Version 8.1.4 Patch 10 Readme

Enhancements and changes

Enhancements and changes in SAM


This patch release does not contain any enhancement and changes.

Enhancements and changes in SAM Adapters


Additional fields available in SCOM mapped to fields in the SAM Adapter OpsManager
SAM Adapter OpsManager has been enhanced to get additional attributes from
SCOM to SAM Adapter.
The following 4 attributes are added to fetch from SCOM based on user request. The
user can enable FETCH_OPS_MGR_ADDITIONAL_FIELDS=true flag in adapter.conf file
to get these additional attributes. By default these flag is set to false.
4 Attributes are:
Context
IsMonitorAlert
MonitoringObjectId
MonitoringRuleId
If a user wants to fetch the values for these attributes and see it in OI or SAM, then
they need to customize AlertMapper.conf file to access these attributes and define
the attributes to be mapped for that they want to see.
For Example, modify DefaultOpsMgrTemplate like this below
Template DefaultOpsMgrTemplate extends GenericTemplate { ClassName = "Host"
EventName = "${E_ClassName} - ${E_EventName}"
EventDisplayName = E_EventName
EventText = E_Description
# Use the alert GUID to make each corresponding # notification instance name
unique by default.
# Although the instance name contains a GUID, the # notification log console
displays the computer # name in the Name column, and the notification # is properly
posted against the unitary computer # system object with that name.
InstanceName = "${ComputerName}/${E_GUID}"
InstanceDisplayName = ComputerName
CreateInstanceName = ComputerName
UserDefined2 = "${E_Context}"
UserDefined3 = "${E_IsMonitorAlert}"
UserDefined4 = "${E_MonitoringObjectId}"
UserDefined5 = "${E_MonitoringRuleId}"
}
UDF 2-4 is mapped to new attributes fetched from SCOM will be mapped.

10 EMC Smarts Version 8.1.4 Patch 10 Readme

Known problems and limitations

SAM Adapter OpsManager provides option to connect to different AD user and Password
SAM Adapter OpsManager has been enhanced to connect to a remote OpsManager
using different AD user and password. This can be achieved by configuring the
remote OpsManager in the adapter.conf.
By default this functionality is disabled by setting the below flag to false. If needed, a
user can enable CONNECT_OPS_MGR_FROM_EXT_DOMAIN = true flag in
adapter.conf.
Apart from enabling the flag a user also need to provide the AD username, domain
name, and password as below in the adapter.conf.
OPS_MGR_HOST_USERNAME = "username";
OPS_MGR_HOST_DOMAIN_NAME = "localhost";
OPS_MGR_HOST_PASSWORD = "changeme";

Enhancements and changes in VoIP

This patch release does not contain any enhancement and changes.

Enhancements and changes in MPLS

This patch release does not contain any enhancement and changes.

Enhancements and changes in MCAST

This patch release does not contain any enhancement and changes.

Enhancements and changes in NPM

This patch release does not contain any enhancement and changes.

Known problems and limitations

This patch release contains the following known problems and limitations:

General Known problems and limitations

Known problems and limitations in IP

Known problems and limitations in SAM

Known problems and limitations in SAM Adapters

Known problems and limitations in VoIP

Known problems and limitations in MPLS

Known problems and limitations in MCAST

Known problems and limitations in NPM

General Known problems and limitations


The following problems and limitations are known for Foundation and Installation in
this release:

EMC Smarts Version 8.1.4 Patch 10 Readme

11

Known problems and limitations

Issue with build number in the 8.1.4.10 server log


CQ 654947
Issue
In the server logs of 8.1.4.10 domain managers, the build number is shown ending
with Build UNSET-build.
C:/814/IP/smarts/local/bin/system/sm_server.exe -n IP814 -b localhost:5260 -c icf -bootstrap=bootstrap-am-pm.conf --output
Foundation: V9.0.4.1/64(133694), 03-Jun-2014 03:35:09 Copyright 1995-2014, EMC
Corporation - Build 7
RSA BSAFE: MES 3.2.4 26-November-2010/64(0),
sm_clsapi.dll: V9.0.4.0/64(119064), 01-Oct-2012 12:22:59 Copyright 1995-2012, EMC
Corporation - Build UNSET-build
sm_rclt.dll: V9.0.4.0/64(119065), 01-Oct-2012 12:38:40 Copyright 1995-2012, EMC
Corporation - Build UNSET-build
sm_servif.dll: V9.0.4.0/64(119065), 01-Oct-2012 12:38:46 Copyright 1995-2012, EMC
Corporation - Build UNSET-build
sm_server.exe: V9.0.4.1/64(133699), 03-Jun-2014 06:58:45 Copyright 1995-2014,
EMC Corporation - Build UNSET-build

Resolution
This log in the 8.1.4.10 domain manager logs can be ignored. This text is seen only in
the logging and has no impact on any of the functionality of the product. However,
the sm_server version will show the proper version of the patch.
Domain Manager crashes due to interchange of environment variables when started as a service
CQ 567780
Issue
Environment variables set in one installation, if propagated to another installation
through sm_serviced, can cause the Domain Manager service to crash.
Resolution
Domain manager can crash when multiple versions of EMC Smarts products are
installed on the same machine and are started as a service. This happens as the
environment variables set in one installation get propagated to another installation.
To avoid this, maintain a common base, that is, the version of the application same,
for example, SAM 8.1.4. The installed IP version should also be then IP 8.1.4. This
way we can avoid using other products environment variable getting populated to
another installation.
Another option is to use the environment variable SM_AUTHORITY="<STD>" which will
force the application not to read the environment variables from other installations.
Patch installer displays two error messages if InstallShield cannot find a suitable JVM
CQ 638701
Issue

12 EMC Smarts Version 8.1.4 Patch 10 Readme

Known problems and limitations

If InstallShield cannot find a suitable JVM version when the Patch installer is run, two
error messages are displayed instead of one.
Resolution
The two messages are just redundant error messages and can be ignored. Click OK on
both the messages and proceed as indicated in the JRE requirement for InstallShield
software.

Known problems and limitations in IP


The following problems and limitations are known for IP Manager 8.1.4.10:
Errors are observed in the log during discovery
CQ 638625
Issue
The following errors are observed in the log during discovery.
MON-E-EXTERNAL_ERROR-Error encountered by the monitoring system when calling
MON_MonitoringInterface::stopMonitoring on variable
NetworkAdapter_PerformanceData_ifMIB::I-NetworkAdapter_PerformanceData_ifMIB-IFnavi-tcschenm.clrcase.lab.emc.com/1073741973::ifHCOutOctets ACCPROPERTY_NOT_MONITORED-Property 'NetworkAdapter_PerformanceData_ifMIB::INetworkAdapter_PerformanceData_ifMIB-IF-navitcschenm.clrcase.lab.emc.com/1073741973::ifHCOutOctets is not monitored; in file
t:/DMT-9.0.2.X/7/smarts/repos/accessors/MR_Accessor.c at line 2222.

Resolution
There is no impact on the functionality and can be ignored. This issue has been fixed
in SAM 9.2. CQ 577224 provides more information.

Known problems and limitations in SAM

The following problems and limitations are known for Service Assurance Manager
8.1.4.10:

High value set for Audit Trail Size Limit could cause performance degradation
CQ 639620 / SR 48928556
Issue
Increasing the audit trail size limit more than the default value may result in longer
archival durations which could result in degradation of server performance.
Resolution
Retain a default value of 100.
ASL errors during topology synchronization in the SAM log
CQ 636309
Issue

EMC Smarts Version 8.1.4 Patch 10 Readme

13

Known problems and limitations

The following ASL errors are observed in the SAM domain log during topology
synchronization with the IP server.
Error description:
[March 6, 2012 1:10:27 AM PST +750ms] t@6292 IP9001_Topo-Driver
ASL-W-ERROR_RULE_SOURCE-While executing rule set
'C:\InCharge\SAM\smarts\rules\ics\ics-topology-sync.asl'
ASL-ERROR_ACTION-While executing action at:
ASL-CALL_STACK_RULE- RuleName: IgnoreThisType, Line: 2803
ASL-CALL_STACK_RULE- RuleName: PROCESS_ATTRIBUTES_FOR_NEXT_INSTANCE, Line: 2167
ASL-CALL_STACK_RULE- RuleName: PROCESS_ATTRIBUTES_FOR_NEXT_CLASS,
ASL-CALL_STACK_RULE- RuleName: ProcessOneClass, Line: 1979
ASL-CALL_STACK_RULE- RuleName: FastEOF, Line: 2961
ASL-CALL_STACK_RULE- RuleName: EOF, Line: 796
ASL-ERROR_GET-While attempting to get property 'Type' of object
'MR_Object::CHASSIS-APM000648055820006'
MR-PROPERTY_NOT_FOUND-Specified property 'Type' not found in class; in file

These errors appear because of the subscription entry for attribute "Type" of
NASChassis in the dxa-conn-perf.conf file. However, this attribute does not exist in IP.
Resolution
Remove line attr Type for class NASChassis from the /conf/ics/dxa-conn-perf.conf
file which corresponds to this subscription, that is, remove the following entry using
the sm_edit utility:
attr Type

--line 46

Warning message in console output for migrate utility


CQ 635372
Issue
An error message sm_merge could not take the backup appears in the console
output when merging a file which was modified earlier, and is also a part of the
patch.
Resolution
The error is benign in nature. There is no impact on the functionality and can be
ignored.
Webconsole may not launch on a machine with multiple hostnames
CQ 636269
Issue
Webconsole may fail when it is launched using JNLP, if Tomcat is running on a server
configured with multiple hostnames.
Resolution

14 EMC Smarts Version 8.1.4 Patch 10 Readme

Known problems and limitations

This can happen if the tomcat_host mentioned in the URL


http://<tomcat_host>:8080/webconsole/globalConsoleCached.html is different from
the one mentioned in the JNLP file.
1. Use a text editor to open the
BASEDIR/smarts/tomcat/webapps/webconsole/globalConsoleApp.jnlp file.
2. Locate the following line:codebase=http://<tomcat_host>:8080
3. Change tomcat_host in the above line to its corresponding IP Address
4. Save and close the file
5. Point your browser to
http://<IP_Address>:8080/webconsole/globalConsoleCached.html
6. Click on Launch Global Console and proceed.
Webconsole may not launch when Tomcat server is started on a non-default port
CQ 636269
Issue
Webconsole may fail when it is launched using JNLP and the Tomcat server is started
on a non-default port.
Resolution
If the Tomcat server is started on a non-default port, do the following along with
Changing the Port number of Tomcat as mentioned in the Dashboard Configuration
Guide:
1. Use a text editor to open the
BASEDIR/smarts/tomcat/webapps/webconsole/globalConsoleApp.jnlp file.
2. Locate the following line: codebase=http://<tomcat_host>:8080
3. Change the port number in the above line to the non-default port which is used to
start the Tomcat server.
4. Save and close the file.
5. Point your browser to http://<tomcat_host>:<non
default_port>/webconsole/globalConsoleCached.html
6. Click on Launch Global Console and proceed.

Known problems and limitations in SAM Adapters


The following problems and limitations are known for SAM Adapters 8.1.4.10:
SCOM files and folders continue to have 2007 suffix
CQ 637479
Issue

EMC Smarts Version 8.1.4 Patch 10 Readme

15

Number of fixed defects and certified devices

The version also has support for SCOM2012, but the files, Server, Logs, and Folder
names in OpsManager adapter installation still has 2007 suffix.
Resolution
This issue will be fixed by renaming the folder to OpsMgr instead of OpsMgr2007 in a
future release.

Known problems and limitations in VoIP

This patch release does not include any known issues.

Known problems and limitations in MPLS


This patch release does not include any known issues.

Known problems and limitations in MCAST


This patch release does not include any known issues.

Known problems and limitations in NPM


This patch release does not include any known issues.

Number of fixed defects and certified devices

This section lists the number of defects fixed and devices certified (new and
updated) for this patch:
Table 3.

Number of fixed defects and certified devices

Product

Number of
fixed defects

Number of new
certifications

Number of updated
certifications

Patch release

IP

16

10

8.1.4.10

VoIP

8.1.4.5

SAM

Not Applicable

Not Applicable

8.1.4.6

SAM Adapters

Not Applicable

Not Applicable

8.1.4.10

Foundation

Not Applicable

Not Applicable

8.1.4.5

MPLS

8.1.4.5

NPM

8.1.4.5

MCAST

8.1.4.10

16 EMC Smarts Version 8.1.4 Patch 10 Readme

Fixed Defects

Fixed Defects

This section describes the defect fixes in this patch:

Fixed Foundation defects applicable for all products in 8.1.4.10 and earlier
patches

Fixed IP specific defects

Fixed SAM specific defects

Fixed SAM Adapters specific defects

Fixed VoIP specific defects

Fixed MPLS specific defects

Fixed MCAST specific defects

Fixed NPM specific defects

Fixed Foundation defects applicable for all products in 8.1.4.10 and earlier patches
Table 4.
CQ or SR Ticket
Number

Fixed Foundation defects applicable for all products in 8.1.4.10 and


earlier patches
Modified Files (all files in
BASEDIR/smarts/local/)

Patch
Release

Symptom

Description of Fix

CQ 644612

SAM BMC Adapter


keeps on crashing

Code change to not call


panic, from invalid
parameter handling,
only when called from
get_osfhandle
(Windows)

libsm_sms.dll

NA

NA

NA

NA

8.1.4.7

NA

NA

NA

NA

8.1.4.6

CQ 577011

Cross-site scripting
(XSS) vulnerability
detected on the domain
manager/broker
HTTP port. This can lead
to javascript execution
or cookie injection
attacks on
the user browser.

Encode the URL for


HTML before putting it
into the error message
body.

sm_httpd

8.1.4.5

NA

NA

NA

NA

8.1.4.4

CQ 567460

sm_serviced was
observed to be doing
unexpected state
transitions such as
STARTING -> NOT

The stale event caused


the sm_serviced main
thread into a blocking
"waitpid" call to wait for
the process which it

sm_serviced

8.1.4.3

SR 48965488

8.1.4.10

EMC Smarts Version 8.1.4 Patch 10 Readme

17

Fixed Defects
CQ or SR Ticket
Number

CQ 642186
CQ 640746
SR 50939472

SR 50401868

Patch
Release

The reason is that the


accessor compared the
time elapsed since the
agent timed out with
the polling period, and
did not poll the agent if
the elapsed time was
less than the polling
period. However, due to
the polling scheduling
scheme, it is possible
for some attributes to
be polled somewhat
earlier, which makes
the comparison invalid.
The fix was to make the
accessor aware if this is
the beginning of the
polling cycle, and skip
polling only if the
timeout was seen in the
current polling cycle.

Windows:

8.1.4.3

Fixed the expression to


compute the value of
model-generated
attributes from the
value of the source
attribute.

Windows:

Description of Fix

RUNNING for a service


followed by messages
indicating that the
service started up
successfully. This was
caused by stale
TERMINATION events
that got accumulated
from a previous service
stop, because the event
queue got blocked for
some reason for a long
time.

mistakenly thought had


terminated, causing a
hang.

The SNMPAgent Not


Responding event did
not clear even when the
Agent was responding.
On certain occasions,
when an SNMP agent
times out, the SNMP
accessor skips polling
from this agent on the
next polling cycle.

CQ 576691

Modified Files (all files in


BASEDIR/smarts/local/)

Symptom

Incorrect notifications
for dynamic-model
computed attributes
depending on
built-in functions
errnum, errstr, and no
response.

A "timestamp" is
attached to every event,
which is used to
determine if the event is
stale and discard it.

sm_repos.dll
Unix:
libsm_repos.so

8.1.4.2

lib\sm_repos.dll
Unix:
lib\libsm_repos.so

Fixed IP specific defects


Table 5.
CQ or SR Ticket
Number

Fixed IP specific defects

Symptom

18 EMC Smarts Version 8.1.4 Patch 10 Readme

Description of Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Original
Patch
Release

Fixed Defects
CQ or SR Ticket
Number

Modified Files (all files in


BASEDIR/smarts/local/)

Original
Patch
Release

Symptom

Description of Fix

CQ 609628

Autodiscovery process
will hang indefinitely
since the closure
counter
increment/decrement
methods are not thread
safe.

Made closure counter


increment/decrement
methods thread-safe.

local/lib/sm_auto_discove
ry.so

8.1.4.10

CQ 651462

IFTypePattern set in
tpmgr-param.conf was
not taking effect

The variable name


(IfTypePattern) used in the icmib2-hyper-data.asl was in
different case than that
specified in tpmgrparam.conf. Fixed the same

ic-mib2-hyper-data.asl

8.1.4.10

CQ 614448

ic-cisco-vlan-br-stp.asl
runs in a loop during
bridge probing due to a
agent bug.

Have put a condition to break


the bridge probing when the
loopounter reaches 2000.

local/rules/discovery/iccisco-vlan-br-stp.asl

8.1.4.10

CQ 654354

snmpv3 device pending


discovery fails, if the
device is added in to
pending list using dmctl
addPending command.

Fix is provided to handle


error condition in autodiscovery manager.

libsm_auto_discovery.so

8.1.4.10

NA

NA

NA

NA

8.1.4.7

CQ 602076

Some IP addresses are


not created for
Netscreen firewall
device with OS greater
than or equal to 6.3

Modified the code to create


the IP addresses and layering
relation with corresponding
interfaces.

rules/discovery/ic-ns-contact.asl

8.1.4.6

IPV6 was not


discovering Unisphere
Virtual routers.

IPV6 support is now provided


for Virtual Router device
Juniper Unisphere E320.

rules/discovery/icunisphere-vr-data.asl

sm_snmpwalk was
walking vlans that did
not exist.

This utility was parsing


cviRoutedVlanIfIndex twice
and parsed ifIndex and
walked these ifIndex as
Vlans. The fix is to remove
the getVLANIDfromValue call
to the cviRoutedVlanIfIndex.

Sm_snmpwalk.exe
(windows)

Card redundancy group


created based on unitID
and peerUnitID from

Based on the logic given by


the vendor, the modules from
entPhysicalMIB with

rules/discovery/ic-ciscomodule-pre-card.asl

CQ 602647

CQ 601929

CQ 602390

libsm_auto_discovery.dll

rules/discovery/ic-nsdata.asl
8.1.4.5

conf/discovery/DISCOVERY
_UNISPHERE.import
8.1.4.5

Sm_snmpwalk
(linux/solaris).

8.1.4.5

EMC Smarts Version 8.1.4 Patch 10 Readme

19

Fixed Defects
CQ or SR Ticket
Number

Modified Files (all files in


BASEDIR/smarts/local/)

Original
Patch
Release

Symptom

Description of Fix

Cisco-RF MIB did not


reflect the set of cards
in entPhysical MIB.

description as RP0 and RP1


has been mapped to having
standby status from unitID
.32 and .33 in the Cisco-RF
MIB

CQ641530

Wrong VlanID was


associated with the
Voice vlans.

Fixed the code to associate


the right vlanID with the Vlan
key thus avoiding creating
vlan with old vlan names.

rules/discovery/ic-vlancisco-membership.asl

8.1.4.4

CQ 576914

NetworkAdapter
OperStatus/AdminStatu
s initial value was
Unknown even though
the initial value was set
as UP in Polling and
Threshold settings. This
happened only when
Connectivity Polling was
set as External Poller.

Loopback Accessor suspends


an attribute with
ACC_LOOP_NO_PUT no put
yet error, even though there
was a put, if the attribute has
been subscribed with
acceptable delay that is less
than the time passed since
the put.

Windows:

8.1.4.3

Connection was not


formed between Cisco
CDP devices, if
cdpCacheAddress is
0.0.0.0 and
cdpCacheDeviceID was
not FQDN (Fully
Qualified Domain
Name).

Modified CDP functionality to


use FQDN as device ID for
CDP connections.

rules/discovery/ic-ciscopost-processor.asl

8.1.4.3

Generation of port high


utilization and
validation of alarms in
SAM consoles for Fore
ASX-4000
.1.3.6.1.4.1.326.2.2
device.

Code added to monitor Port


performance using vendor
specific MIBs for the
device Fore ASX-4000
.1.3.6.1.4.1.326.2.2

rules/health/adaptersettings.asl

8.1.4.3

SR 50738604

CQ 567685
SR 49923046

CQ 596595

lib\sm_repos.dll
Unix:
lib\libsm_repos.so

Fixed the accessor not to


invalidate the cache if this is
the LoopbackAccessor.

rules/discovery/ic-foreasx1000.asl
conf/discovery/DISCOVERY
_FORE.import
conf/discovery/oid2Type_
Misc.conf
conf/icf/
HEALTH_FORE.import
Windows:
lib/sm_health_fore.dll
Unix:

20 EMC Smarts Version 8.1.4 Patch 10 Readme

Fixed Defects
CQ or SR Ticket
Number

Symptom

Modified Files (all files in


BASEDIR/smarts/local/)

Description of Fix

Original
Patch
Release

lib/libsm_health_fore.so
CQ 599629

CQ 599463
CQ 641086
SR 52831400

CQ 640503
SR 50196456

CQ 576854
CQ 576969
SR 50940772
SR 51604840-1

FORE switch Temperature Sensor OID used for monitoring


status
(envTempSensorState)
was used for
CurrentUtilization as
well.

The fix now uses


envTempSensorState OID for
monitoring only the
Temperature sensor status
and not for
CurrentUtilization.

Windows:

Out Of Range alarm was


not generated for a valid
scenario for Cisco 6500
Switch with device OID
.1.3.6.1.4.1.9.1.283

Modified the event


computation of OutOfRange
on
TemperatureSensor_Fault_C
iscoEntitySensor and on
VoltageSensor_Fault_CiscoE
ntitySensor where the
entitySensor value is
converted to the scale as
represented by the
entSensorPrecision and
entSensorScale.

Windows:

Interface (without
underlying IP in the
topology) did not get
deleted from the
topology after
rediscovery, when
deleted from the device.

Modified the history table


mechanism to process all
interfaces irrespective of the
underlying IP.

rules/discovery/ic-createinterface.asl

8.1.4.2

The following errors


were observed in the
log file:

The errors do not impact the


functionality but a NULL
check is now added to avoid
these ASL errors.

rules/discovery/ic-ciscovlan-br-stp.asl

8.1.4.2

ic-cisco-vlan-br-stp.asl:
ASL-ERROR_GET-While
attempting to get
property 'PortNumber'
of object '::'

8.1.4.3

lib/sm_health_marconi.dll
Unix:
lib/libsm_health_marconi.
so

8.1.4.3

sm_health_cisco.dll
Unix:
sm_health_cisco.so

rules/discovery/ic-ciscocrs-entity.asl
rules/devstat/syssettings.asl

ic-cisco-crs-entity.asl:
ASLERROR_UNDEFINED_VA
RIABLE_ACCESSVariable 'entPhycardId'
has not been assigned a
value
sys-settings.asl:
ASL-ERROR_PUT-While

EMC Smarts Version 8.1.4 Patch 10 Readme

21

Fixed Defects
CQ or SR Ticket
Number

Symptom

Original
Patch
Release

Modified Files (all files in


BASEDIR/smarts/local/)

Description of Fix

attempting to set
property
'DataProvidedBy' of
object '::'

Fixed SAM specific defects


Table 6.

Fixed SAM specific defects

CQ or SR Ticket
Number

Symptom

Description of Fix

NA

NA

NA

NA

8.1.4.10

NA

NA

NA

NA

8.1.4.7

CQ 643518

When relationships
change (swap) between
devices in IP Topology,
SAM does not sync
topology properly
resulting in discrepancy
between IP and SAM
topology.

Additional condition
added to handle the
scenario where the
relationship instances
get exchanged between
devices.

Windows:
lib/sm_sam_common.dll

8.1.4.6

Map Icon Tooltip did not


display the contact
attribute.

Wrong attribute was


queried to populate the
contact information.
This is now fixed by
querying the correct
attribute.

Windows:

CQ 642034

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

Unix:
lib/libsm_sam_common.so

8.1.4.5

libsm_map_base.dll
Unix
libsm_map_base.so

CQ 642471

Notif GUI version did


not show the Patch
version.

Class path in
NotifGui.bat is now
updated to pick up the
new jar with latest
version information.

CONSOLE\smarts\notif\e
ditor\NotifGui.bat

8.1.4.5

CQ 577625

Error in the SAM domain


log:

Getexplains is called
only for the problem
events which resolved
the issue.

rules/ics/ics-eventprocessing.asl

8.1.4.5

PROCESS_DISCONNECT
rule was processing for

rules/ics/ics-eventprocessing.asl

8.1.4.4

ASLERROR_GETEXPLAINSWhile attempting to get


explained events of
'CallServer::lwqav022.ls
s.emc.com::DiscoveryEr
ror'
CQ 577495
SR 52286818

In a fail-over setup, after


the manual fail-over

22 EMC Smarts Version 8.1.4 Patch 10 Readme

Fixed Defects
CQ or SR Ticket
Number

CQ 567853
SR 53037290

CQ 567776
SR 52749378

CQ 641038
SR 51612984

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

lastClearedAt was not


getting a numeric value
before clearing , due to
which events were not
cleared in OI/SAM.
Corrected the same.

rules/ics/ics-nlprocessing.asl

8.1.4.4

Connections disappear
on the map in SAM
domain during topology
synchronization with
underlying domains
attached.

Classes
VirtualSwitchSystem
and VSSChassis were
not defined which are
now defined in the dxa
files

conf/ics/dxa-oi.conf

8.1.4.4

Aggregate SAM NLDriver threads are stuck


when multiple NL-Driver
instances are created by
specifying "sub
NLName/n4, in the dxa
file" for notification list
subscription between
Presentation and
Aggregate SAM. When
aggregate SAM is
disabled and
reconfigured, the NLDriver instances were
not stopped resulting in
errors present in the log
file. Further, dmdebug -threads output shows
NL-Driver state as
RUNNING and ASL errors
are logged in the SAM
log.

As part of the fix, the


driver instances will be
stopped when domain
is disabled and
reconfigured. Hence,
the errors will not be
observed and dmdebug
--threads will not list
these thread instances
as running.

Windows:

Symptom

Description of Fix

from Primary IP domain


to the Secondary IP
domain, there is no
topo-sync seen between
SAM and secondary IP
domain.

all values of
DISCONNECT_SMOOTHI
NG_INTERVAL. Added a
condition to continue
only if

Events in MSSCOM
which have been
cleared, still shows as
active in the attached OI
and SAM.

DISCONNECT_SMOOTHI
NG_INTERVAL is greater
than zero.

The Fixed Foundation


Defects table lists
issues fixed in the
patch.

conf/icoi/dxa-oi-fromam-pm.conf
conf/icoi/bootstrap.conf

8.1.4.3

lib\ libsm_ics_ems.dll
Unix:
lib\ libsm_ics_ems.so

8.1.4.2

EMC Smarts Version 8.1.4 Patch 10 Readme

23

Fixed Defects

Fixed SAM Adapters specific defects


Table 7.
CQ or SR Ticket
Number
CQ 615117

CQ 654965

CQ 615560
CQ 616615

CQ 653359
CQ 654680

Fixed SAM Adapters specific defects


Modified Files (all files in
BASEDIR/smarts/local/)

Patch
Release

The SAM Adapter


OpsManager was
enhanced with ability to
fetch additional
attributes from SCOM
Application. See
Enhancements and
changes in SAM
Adapters for details.

bin/sm_OpsMgrOAO.exe

8.1.4.10

SAM Adapter
OpsManager provides
option to connect to
different AD user and
Password

User can provide option


to configure remote AD
user credentials to
connect to a SCOM
Application. See
Enhancements and
changes in SAM
Adapters for details.

bin/sm_OpsMgrOAO.exe

NetIQ notifications are


not getting cleared
automatically when resync happens from
NetIQ AM

The notification status


of a NetIQ event in SAM
OI are turned from
ACTIVE to INACTIVE by
the adapter when the
corresponding StatusChange event is
received at the adapter
that indicates the
original event is no
longer active. Also, if
NetIQ events, are
manually closed from
AppMgr, the adapter
will turn the
corresponding
notifications in SAM OI
from ACTIVE to
INACTIVE.

rules/niqam/importEvent.
asl (main.asl)

8.1.4.10

UpdateTopology
function stops when it
hit an error condition,
internally it is stopping
processing of other
entries from SAM to SDI
adapter

Fix is provided to
handle error condition
in the asl file

rules/sdi/sdi.asl

8.1.4.10

Symptom

Description of Fix

SAM Adapter
OpsManager is not
fetching all needed
attributes from SCOM
Server

24 EMC Smarts Version 8.1.4 Patch 10 Readme

conf/OpsMgr2007/adapt
er.conf
rules/OpsMgr2007/adapt
erConfImport.asl

8.1.4.10

conf/OpsMgr2007/adapt
er.conf
rules/OpsMgr2007/adapt
erConfImport.asl

Fixed Defects
CQ or SR Ticket
Number

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

Archive job is revisited


to handle the large data
and break the job into
multiple units to get it
executed smoothly

sdi-archival/sdiarchive.cmd

8.1.4.10

BMC Session
Disconnect Notification
disappears after
Acknowledge and
reappear as
Unacknowledge.

The BMC Session


Disconnect notification
by default having
ClearOnAcknowledge
attribute set to TRUE
has been changed to
FALSE.

bmc-events-parse.asl

8.1.4.10

NA

SAM Adapters 8.1.4


cant be installed on
Linux Red Hat 6 system

There are new RedHat 6


specific SAM Adapters
8.1.4 base installation
and patch 7 files that
provide support for
Linux Red Hat 6

NA

8.1.4.7

NA

NA

NA

NA

8.1.4.6

CQ 642702

Alarms are not flowing


to SCOM adapter from
SAM.

Fix is to avoid the


findComputerSystem
call, based on the flag
defined.

/conf/opsmgr2007/adapt
er.conf

8.1.4.5

The issue is that


whenever there is a new
event coming from
SCOM trying to lookup
for the object, and if the
object is not in the
cache maintained in the
adapter, it will invoke
the find computer
system call to find the
object on SAM and in
turn it will try to look up
from its underlying
domains. Due to this,
delay is seen in
notifications reaching
late from SCOM to SAM
through the adapter.
The fix here is to avoid
the
findComputerSystem
call as we already
maintain the list of
objects in the cache at
the adapter and synced

/rules/opsmgr2007/event
Mgr.asl

CQ 651629
CQ 615876

CQ 615948
CQ 616634

SR 54189790

Symptom

Description of Fix

Archival job is failing


when the amount of
data to be archived is
huge.

/rules/opsmgr2007/adap
terConfImport.asl

EMC Smarts Version 8.1.4 Patch 10 Readme

25

Fixed Defects
CQ or SR Ticket
Number

Symptom

Description of Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

with SAM in periodic


time intervals. Going
forward we will not
findComputerSystem
call by default, only to
check the object
directly and create a
notification. In any
specific case, if you
want to enable, you
can, based on your
requirement.
CQ 642817

eHealth Adapter
support on Linux.
Note: This is an
enhancement.

CQ 586445

CQ 640983
SR 51597922

CQ 577034
CQ 503271

8.1.4.5

From 8.1.4.5, you can


install eHealth Adapter
on Linux (RHEL 5/6).
Environment and
system requirements
section lists steps to
install eHealthAdapter
on RHEL6.

OAS disconnects from


OAO constantly.

timeout value added in


the block create proxy
for server in
createThread method.

rules/OpsManager2007/r
estartableThreadMgr.asl

SAM Remedy Adapters


crashed due to memory
exception.

SAM Remedy adapter


crashed in Linux when
GetEntry query was
issued from the
command line for
sm_arclient executable.
The crash is due to free
up memory while
completing the
command execution
after printing the
content of the ticket.
The free command
should not be directly
called, instead it needs
to use Remedy provided
library to free up the
memory taken by the
sm_arclient application.

bin/system/sm_arclient7
64

Code is added to detect


the Primary key
violation error from the
error string. Once the
error is detected,

Windows :

The SDI adapter


completely stops if it
detects any duplicate
entry to be added into
the database.

26 EMC Smarts Version 8.1.4 Patch 10 Readme

8.1.4.4

8.1.4.3

bin/system/sm_arclient7
01
bin/system/sm_arclient6
30
bin/system/sm_arclient

local/lib/sm_sdi_core.dll
local/lib/sm_sdi_core.lib
local/lib/sm_sdi.dll
local/lib/sm_sdi.lib

8.1.4.2

Fixed Defects
CQ or SR Ticket
Number

Modified Files (all files in


BASEDIR/smarts/local/)

Symptom

Description of Fix

The reason behind this


is due to the tables in
Oracle and SQL Server
being created with
Primary Key constraint
enabled.

adapter logs the error


message and moves on
with the next statement
in the batch instead of
stopping the whole
adapter.

Patch
Release

local/lib/sm_sdi.po
local/bin/system/sm_sdi.
exe
Linux/Solaris :
local/lib/libsm_sdi_core.
so
local/lib/libsm_sdi.so
local/bin/system/sm_sdi

Fixed VoIP specific defects


Table 8.

Fixed VoIP specific defects

CQ or SR Ticket
Number

Symptom

Description of Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

NA

NA

NA

NA

8.1.4.10

NA

NA

NA

NA

8.1.4.7

NA

NA

NA

NA

8.1.4.6

CQ 577638

VoIP-AM generated core


file during reconfigure.

Introduced configurable
ReadTimeout for
protocol handler used
by
java.net.URLConnection
underlying SOAP client.
This timeout will be
effective reading from
input stream, hence
avoiding the chance on
pooling thread hand in
case connected SOAP
service on CUCM fails to
respond to SOAP
requests by VoIP-AM.

voip_cisco_axl.jar

8.1.4.5

NA

NA

rules/voip/cisco/iccisco-detector.asl
rules/voip/cisco/voipcisco-settings.asl
conf/voip/voip.conf
lib/sm_voip (dll/so)

The Description of
devices certified in the
patch table contains
description of changes
in this patch.

8.1.4.4

The Fixed Foundation


Defects table lists
issues fixed in the
patch.

8.1.4.3

NA

NA

8.1.4.2

EMC Smarts Version 8.1.4 Patch 10 Readme

27

Fixed Defects

Fixed MPLS specific defects


Table 9.

Fixed MPLS specific defects

CQ or SR Ticket
Number

Symptom

Description of Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

NA

NA

NA

NA

8.1.4.10

NA

NA

NA

NA

8.1.4.7

NA

NA

NA

NA

8.1.4.6

The Fixed Foundation


Defects table lists issues
fixed in the patch.
NA

NA

NA

8.1.4.5

NA

The Fixed Foundation


Defects table lists issues
fixed in the patch.
NA

NA

NA

8.1.4.4

8.1.4.3
NA

8.1.4.2

Fixed MCAST specific defects


Table 10.
CQ or SR Ticket
Number

Fixed MCAST specific defects

Symptom

Description of Fix

CQ 651311

Multicast Manager GUI


freezes and dmctl fails.

Fixed the computation


logic for
IGMPInterface::LatestIgm
pInterfaceQuerier to
understand the SNMP
IpAddress type and
convert it directly into an
IP address literal without
requiring any hostname
lookups. The
LatestIgmpInterfaceQuerie
r&
CurrentIgmpInterfaceQueri
er attributes will show
proper IP addresses in the
console.

NA

MCAST 8.1.4 cant be


installed on Linux Red
Hat 6 system

There are new RedHat 6


specific MCAST 8.1.4
base installation and
patch 7 files that

28 EMC Smarts Version 8.1.4 Patch 10 Readme

Modified Files (all files in


BASEDIR/smarts/local/)
libsm_mcast.so

Please include the list of


files here

Patch
Release
8.1.4.10

8.1.4.7

Fixed Defects
CQ or SR Ticket
Number

Symptom

Description of Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

NA

8.1.4.6

provide support for


Linux Red Hat 6
NA

NA

NA

8.1.4.5

The Fixed Foundation


Defects table lists
issues fixed in the
patch.
NA

NA

NA

NA

8.1.4.4

CQ 576931

Multicast Manager
experienced rapid
memory consumption
due to growth of
SubscriberFE queue.

The growth was caused


by a condition in the
model code that set the
IGMP Instrumentation
Polling interval to "-1"
which was causing the
memory growth. This is
now fixed.

mcast.mdl

8.1.4.3

SR 50887122

Windows:
libsm_mcast.dll
Linux/Solaris:
libsm_mcast.so

NA

NA

NA

NA

8.1.4.2

Fixed NPM specific defects


Table 11.
CQ or SR Ticket
Number

Fixed NPM specific defects

Symptom

Description of Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Original
Patch
Release

NA

NA

NA

NA

8.1.4.10

NA

NA

NA

NA

8.1.4.7

NA

NA

NA

NA

8.1.4.6
8.1.4.5

The Fixed Foundation


Defects table lists
issues fixed in the
patch.
NA

NA

NA

NA

8.1.4.4

CQ 567687

BGPSession disconnect
events raised
incorrectly.

The root cause for this


BGPSession disconnect
event is that one
endpoint states session
was established but for
other end point,

Windows:

8.1.4.3

SR 51346218

libsm_rpsm_bgp.dll
Unix:
libsm_rpsm_bgp.so

EMC Smarts Version 8.1.4 Patch 10 Readme

29

Certified devices
CQ or SR Ticket
Number

Symptom

Description of Fix

Original
Patch
Release

Modified Files (all files in


BASEDIR/smarts/local/)

instrumentation never
occurred.
NA

NA

Certified devices

NA

NA

8.1.4.2

This section describes the devices certified and the certification impact in this patch:
Table 12.

Description of devices certified in the patch

CQ or SR
Ticket
Number

Product

Symptom

Description of
Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

CQ 616116

IP

Certification for
Juniper PTX3000
.1.3.6.1.4.1.2636.1.
1.1.2.98

This device is
certifed in IP

local/conf/discovery/oid2type_J
uniper.conf

8.1.4.10

local/conf/discovery/JuniperPow
erType.conf
local/rules/discovery/ic-juniperchassis-ptx.asl
local/rules/discovery/ic-juniperhealth-ptx.asl

CQ 654585

CQ 604508

IP

IP

Card redundancy
Group was not
created for Juniper
ERX 1440
.1.3.6.1.4.1.4874.1.
1.1.1.3

Modified the
driver to identify
the cards
participating in
the redundancy
group based on
redundacy slot
information and
create the card
redundancy
group.

local/conf/discovery/DISCOVER
Y_UNISPHERE.import

For Sonus
GSX9000HD
.1.3.6.1.4.1.2879.1.
1.2Layering
relationship is not
formed between
DSX1 and DSX3
Interfaces.

Modified the
code to create
layered over
relationship
between DSX1
and DSX3
interfaces.

rules/discovery/ic-sonus-createinterface.asl

30 EMC Smarts Version 8.1.4 Patch 10 Readme

8.1.4.10

local/rules/discovery/icunisphere-erx-cont.asl
local/lib/libsm_devstat_unisphe
re.so

8.1.4.6

Certified devices
CQ or SR
Ticket
Number

Product

Symptom

Description of
Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

CQ 602647

IP

IPV6 is not
discovering
Unisphere Virtual
routers

IPV6 support
provided for
Virtual Router
device Juniper
Unisphere E320

rules/discovery/ic-unisphere-vrdata.asl

8.1.4.5

conf/discovery/DISCOVERY_UNI
SPHERE.import

CQ 602390

IP

Card redundancy
group created based
on unitID and
peerUnitID from
Cisco-RF MIB did not
reflect the set of
cards in entPhysical
MIB

Based on the
logic given by
the vendor, the
modules from
entPhysicalMIB
with description
as RP0 and RP1
has been
mapped to
having standby
status from
unitID .32 and
.33 in the CiscoRF MIB

ic-cisco-module-pre-card.asl

8.1.4.5

CQ 642178

IP

Memory instances of
Cisco GSR Router do
not show location
information. SYS OID
of the device is
.1.3.6.1.4.1.9.1.385

Enhancement to
additionally
display Memory
location
information in
display name
for Memory for
Cisco GSR
Router
(.1.3.6.1.4.1.9.
1.385)

conf/discovery/DISCOVERY_Cisc
o.import

8.1.4.4

Memory instances of
Cisco CRS MCC
Router do not show
location information

Enhancement to
additionally
display Memory
location
information in
display name
for Memory
instances for
Cisco CRS
Router
(.1.3.6.1.4.1.9.
1.613).

conf/discovery/DISCOVERY_Cisc
o.import

CQ 600619

IP

SYS OID of the


device is
.1.3.6.1.4.1.9.1.613

rules/discovery/ic-cisco-createiosxr-health.asl

8.1.4.4

rules/discovery/ic-cisco-createcrsiosxr-health.asl

EMC Smarts Version 8.1.4 Patch 10 Readme

31

Certified devices
CQ or SR
Ticket
Number

Product

Symptom

Description of
Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

CQ 642182

IP

Cards discovered
from OLD-CiscoChassis MIB were
showing
NOTPRESENT state
as it was polling
cefcModuleOperStat
us OID from EntityFRU MIB to get the
status instead of
using
OldCiscoChassis MIB
for instrumentation.
SYS OID of the
device is Cisco1941
.1.3.6.1.4.1.9.1.104
7

Modified
discovery code
to instrument
cards from
OldCiscoChassi
s MIB when
data from
Entity-FRU MIB
is unavailable.

rules/ic-cisco-router-card.asl

8.1.4.4

OIDs for Operstatus


of DSX1 and DSX2
interfaces were using
incorrect OIDs sonusDsx1AdmnMod
e

Modified the
instrumentation
class of DSX1
and DSX2
interfaces to
use OIDs
sonusDsx1Stat
OperStatus and
sonusDsx3Stat
OperStatus for
OperStatus

lib/ libsm_devstat_sonus.so

8.1.4.4

New
Containment
and
Performance
Drivers.
Discovered
Ports(.1.3.6.1.4.
1.23022.2.8.1.
1.6),
PowerSupply(.1
.3.6.1.4.1.2302
2.2.8.1.1.12.1.
2),
CPU(.1.3.6.1.4.
1.23022.2.8.1.
1.21.1.5)

rules/discovery/ic-netopticsport.asl

8.1.4.4

CQ 600620

IP

and
sonusDsx2AdmnMod
e
This is for SONUS
GSX 9000HD
(.1.3.6.1.4.1.2879.1.
1.2)
CQ 642184

IP

New Drivers for the


Netoptics Device.
SYS OID of the
device is
.1.3.6.1.4.1.23022.2
.8

SYS OID of the


device is
Cisco1941
.1.3.6.1.4.1.9.1
.1047

rules/discovery/ic-netopticshealth.asl
conf/discovery/DISCOVERY_NET
OPTICS.import
conf/discovery/oid2type_Netopt
ics.conf
lib/libsm_devstat_netoptics.so
lib/libsm_health_netoptics.so

32 EMC Smarts Version 8.1.4 Patch 10 Readme

Certified devices
CQ or SR
Ticket
Number

Product

Symptom

Description of
Fix

Modified Files (all files in


BASEDIR/smarts/local/)

Patch
Release

CQ 642248

IP

IPv6 support missing


for Juniper E320.

Modified driver
to create IPV6
addresses. IPV6
created using
oid
inetCidrRouteIfI
ndex
(.1.3.6.1.2.1.4.
24.7.1.7.2)

conf/discovery/DISCOVERY_UNI
SPHERE.import

8.1.4.4

Added a
certification
code for AES.
Added AES trap
definitions in
trap manager
configuration
file for
Avaya. VoIP AM
will generate
notifications if
AES
server/processe
s goes down

conf/voip/discovery/certavaya.conf

Implemented
code to
discover and
monitor all
missing
components
and
relationships.

conf/discovery/DISCOVERY_ALC
ATEL.import

CQ577654

CQ 597811

VoIP

IP

SMARTS does not


generate any alerts
when Avaya AES
server goes down.

The device with SysOID


1.3.6.1.4.1.6527.1.3
.3 was partially
certified.
Cards, Card
Redundancy Group,
TemperatureSensors,
CPU, Memory, and
relationship between
interfaces/cards

rules/discovery/ic-unispheredata.asl

8.14.4

conf/voip/icoi/avaya_trap_mgr.
conf
conf/voip/avaya/avayatrapd.conf
rules/voip/icoi/avaya/avayaaes-trap-rules.asl

8.1.4.2

conf/discovery/oid2type_Alcatel
.conf
rules/discovery/ic-alcatel-timexcont.asl
rules/discovery/ic-alcatel-timexhealth.asl

EMC Smarts Version 8.1.4 Patch 10 Readme

33

Certified devices
CQ or SR
Ticket
Number

Product

Description of
Fix

Symptom

were missing.

Modified Files (all files in


BASEDIR/smarts/local/)
Unix:
lib/libsm_devstat_alcatel.so
lib/libsm_health_alcatel.so
Windows:
lib/sm_devstat_alcatel.dll
lib/sm_health_alcatel.dll

Certification impact
This section lists the impacted drivers and SysOIDs as a result of certification
changes.
Table 13.
CQ or SR
Ticket Number

Product

CQ 616116

IP

CQ 654585

IP

Certification impact
Impacted drivers

Performance-JuniperPTX-Driver
Containment-JuniperPTX-Driver

ContainmentUnisphere-ERXDriver

Impacted SysOIDs
.1.3.6.1.4.1.2636.1.1.1.2.98
.1.3.6.1.4.1.2636.1.1.1.2.69

.1.3.6.1.4.1.4874.1.1.1.1.1

Patch Release
8.1.4.10

8.1.4.10

.1.3.6.1.4.1.4874.1.1.1.1.2
.1.3.6.1.4.1.4874.1.1.1.1.3
.1.3.6.1.4.1.4874.1.1.1.1.4
.1.3.6.1.4.1.4874.1.1.1.6.1
.1.3.6.1.4.1.4874.1.1.1.1.5

CQ 604508

IP

Containment-SonusGSX-Driver

.1.3.6.1.4.1.2879.1.1.2

8.1.4.6

CQ 602647

IP

Containment-ERXVRF-Data-Driver

.1.3.6.1.4.1.4874.1.1.1.1.1
.1.3.6.1.4.1.4874.1.1.1.1.2
.1.3.6.1.4.1.4874.1.1.1.1.3
.1.3.6.1.4.1.4874.1.1.1.1.4
.1.3.6.1.4.1.4874.1.1.1.1.5
.1.3.6.1.4.1.4874.1.1.1.6.1
.1.3.6.1.4.1.4874.1.1.1.1.5.1
.1.3.6.1.4.1.4874.1.1.1.6.1.1

8.1.4.5

CQ 602390

IP

Cisco-Entity-FRU-RF

.1.3.6.1.4.1.9.1.643

8.1.4.5

34 EMC Smarts Version 8.1.4 Patch 10 Readme

Patch
Release

Certified devices
CQ or SR
Ticket Number

Product

CQ 642178

IP

HEALTH = CiscoIOSXR

.1.3.6.1.4.1.9.1.385

8.1.4.4

CQ 600619

IP

HEALTH = CiscoCRSIOSXREntSensor

.1.3.6.1.4.1.9.1.613

8.1.4.4

Impacted drivers

Impacted SysOIDs

Patch Release

.1.3.6.1.4.1.9.1.643
.1.3.6.1.4.1.9.1.394
.1.3.6.1.4.1.9.1.388
.1.3.6.1.4.1.9.1.1331

CQ 642182

IP

CONT = CiscoRouter-Entity

.1.3.6.1.4.1.9.1.223

8.1.4.4

.1.3.6.1.4.1.9.1.648
.1.3.6.1.4.1.9.1.1215
.1.3.6.1.4.1.9.1.1172
.1.3.6.1.4.1.9.1.1166
.1.3.6.1.4.1.9.1.1191
.1.3.6.1.4.1.9.1.1174
.1.3.6.1.4.1.9.12.3.1.9.2.180
.1.3.6.1.4.1.9.1.743
.1.3.6.1.4.1.9.1.1044
.1.3.6.1.4.1.9.1.1042
.1.3.6.1.4.1.9.1.1041
.1.3.6.1.4.1.9.1.1047
.1.3.6.1.4.1.9.1.1046
.1.3.6.1.4.1.9.1.1045
.1.3.6.1.4.1.9.1.388
.1.3.6.1.4.1.9.1.1096
.1.3.6.1.4.1.9.1.1095
.1.3.6.1.4.1.9.1.1355
.1.3.6.1.4.1.9.1.1389
.1.3.6.1.4.1.9.1.1386
.1.3.6.1.4.1.9.1.1383
.1.3.6.1.4.1.9.1.1392
.1.3.6.1.4.1.9.1.1376
.1.3.6.1.4.1.9.1.1380
.1.3.6.1.4.1.9.1.830
.1.3.6.1.4.1.9.1.598
.1.3.6.1.4.1.9.1.577
.1.3.6.1.4.1.9.1.1341
.1.3.6.1.4.1.9.1.1249
.1.3.6.1.4.1.9.1.945

EMC Smarts Version 8.1.4 Patch 10 Readme

35

Certified devices
CQ or SR
Ticket Number

Product

CQ 600620

IP

Impacted drivers
Interface_Fault_Son
usInterface_Dsx1

Impacted SysOIDs

Patch Release

.1.3.6.1.4.1.2879.1.1.2

8.1.4.4

.1.3.6.1.4.1.4874.1.1.1.1.1

8.1.4.4

Interface_Fault_Son
usInterface_Dsx3
CQ 642248

IP

ADNR = UnisphereAccess

.1.3.6.1.4.1.4874.1.1.1.1.2
.1.3.6.1.4.1.4874.1.1.1.1.3
.1.3.6.1.4.1.4874.1.1.1.1.4
.1.3.6.1.4.1.4874.1.1.1.1.5
.1.3.6.1.4.1.4874.1.1.1.6.1
.1.3.6.1.4.1.4874.1.1.1.1.5.1
.1.3.6.1.4.1.4874.1.1.1.6.1.1

36 EMC Smarts Version 8.1.4 Patch 10 Readme

Environment and system requirements

Environment and system requirements

This section lists the supported operating systems and describes how to verify the
version number.

Supported operating systems and version number details


Table 14.
Product

IP

Supported operating systems

Multicast

Supported operating systems and version number details

Solaris 10 (64-bit operating system


version only; for ultrasparc/Niagara
chipset)
Red Hat Enterprise Linux AS 4
and AS 5 (64-bit operating system
version only; for AMD64/EM64T
chipsets)

Microsoft Windows Server 2008


Enterprise Edition SP1, SP2, and R2,
(x64)

Microsoft Windows Server 2003


Enterprise Edition (x64) SP1, SP2,
and R2 (does not include support
for Windows Server 2003 Enterprise
Edition for Itanium)

VMS: Solaris 10 Sun Zones,


(Ultrasparc/Niagara chipset)

VMware ESX Version 3.5 and


vSphere 4 installed directly on
physical server running the
following operating systems for
virtual machines:
o

Windows Server 2003


Enterprise Edition, SP1,
SP2, and R2, (x64)

Windows Server 2008


Enterprise Edition, SP1, SP2,
and R2, (x64)

Red Hat Enterprise Linux AS


4 and AS 5, 64-bit

Red Hat Enterprise Linux AS 4,


AS 5 and AS6 (64-bit operating
system version only; for
AMD64/EM64T chipsets)

Solaris 9, 10 (64-bit operating


system version only; for
ultrasparc/Niagara chipset)

VMS: Solaris 10 Sun Zones,


(Ultrasparc/Niagara chipset)

Version number details

From <BASEDIR>/smarts/bin/, type the following command:


./sm_server --version (Linux and Solaris)
sm_server --version (Windows)
The following output is displayed:
solaris8-sparc-64/21000
IP_NETWORK_SUITE: V8.1.4.10/64(134221), 25Jun-2014 02:04:31 Copyright 1995-2014, EMC
Corporation - Build 32
Foundation V9.0.4.1/64(133680), 02-Jun-2014
13:36:28 Copyright 1995-2014, EMC
Corporation - Build 7

From <BASEDIR>/smarts/bin/, type the following command:


./sm_server --version
The following output is displayed:
linux_rhAS50-x86-64/206180000
MCAST_SUITE: V8.1.4.10/64(134105), 20-Jun2014 05:58:43 Copyright 1995-2014, EMC
Corporation - Build 15

EMC Smarts Version 8.1.4 Patch 10 Readme

37

Product

SAM
Adapter

Supported operating systems

Microsoft Windows Server 2008


Enterprise Edition R2, (x64)

Microsoft Windows Server 2003


Enterprise Edition (x64) SP2, and R2

VMware ESX Server 3.5 and 4.0


installed directly on the physical
server running Red Hat Enterprise
Linux AS6, 64-bit

Solaris 9 and 10

Red Hat Enterprise Linux AS 4

Red Hat Enterprise Linux AS 5

Red Hat Enterprise Linux AS 6

Windows 2003 SP1

Windows 2003 SP2

Windows 2003 R2

WIndows 2008 R2

Red Hat Enterprise Linux AS6


(64-bit operating system version
only; for AMD64/EM64T chipsets)

VMware ESX Server 3.5 and 4.0


installed directly on the physical
server running Red Hat Enterprise
Linux AS6, 64-bit

Installation

Version number details

Foundation V9.0.4.1/64(133680), 02-Jun-2014


13:31:50 Copyright 1995-2014, EMC
Corporation - Build 7

From <BASEDIR>/smarts/bin/, type the following command:


./sm_server --version
The following output is displayed:
winnt-x86-32/206110
SAM_ADAPTERS_SUITE: V8.1.4.10/32(134243),
26-Jun-2014 00:01:11 Copyright 1995-20
14, EMC Corporation - Build 27
Foundation V9.0.4.1/32(133697), 03-Jun-2014
05:58:02 Copyright 1995-2014, EMC
Corporation - Build 7

Install the patch using one of the following methods:

Apply patch using Wizard mode

Apply patch using CLI mode

Apply patch using Unattended (Silent) mode

Note: Administrative privileges are required to install a patch.

Apply patch using Wizard mode

Wizard mode provides a graphical interface to the patch Installation software.


Wizard mode requirements for UNIX systems
On UNIX systems, Wizard mode uses the X Window System to display the installation
wizard. The host on which you install the EMC Smarts software and the host where
you log on must be configured to run the X Window System. Before starting the
Installation software using the Wizard mode, verify that the X Window System is
running.

38 EMC Smarts Version 8.1.4 Patch 10 Readme

Installation

Run Wizard mode


1.

Run the appropriate setup command listed in Table 15. Replace xx with the
relevant product name, for example, IP, SAM, SAMADP, VOIP, MPLS, MCAST,
and NPM. For exact name, check the Patch Installation Files section.

Table 15.

Setup command syntax for Wizard mode

Operating
system

Wizard setup command syntax

Linux

./setup-xx-linux-8_1_4_10-2014062664BIT.bin

Linux AS 5
&6

IP & SAM Adapters for Linux AS 5 & 6:


./setup-xx-linux-rhAS50-8_1_4_1020140626-64BIT.bin
MCAST for Linux AS 5:
./setup-MCAST-linux-rhAS50-8_1_4_1020140623-64BIT.bin
MCAST for Linux AS 6:
./setup-MCAST-linux-rhAS60-8_1_4_1020140806-64BIT.bin

Solaris
Windows

./setup-xx-solaris-8_1_4_10-2014062664BIT.bin
setup-xx-win-8_1_4_10-2014062664BIT.exe

The Installation Wizard dialog box appears and closes. The Shutdown EMC
Smarts Programs dialog box and the Welcome screen appear.
You may need to point the Patch installer to the java location. (Click here for
more details).
2.

Click Next in the Welcome screen.


If you do not have administrative privileges, Next is disabled and a message
appears. Exit and restart the installation with administrative privileges.

3.

Read the license agreement, select I accept the terms of the license
agreement, and click Next. If you do not accept the terms, you cannot
complete the installation and must exit.
The Installation software detects all existing installations of the particular
product and displays them in the upgrade screen.

4.

Select the product to patch and click Next.


If there is only a single installation of the product, it is selected. The Installed
EMC Smarts services screen appears.

5.

If the Installation software detects services running from the install area, a list
of services that the Installation software has detected is displayed. Stop each
running service by pressing any key. Then click Next.

EMC Smarts Version 8.1.4 Patch 10 Readme

39

Installation

The Installation software then checks for any changes made to usermodifiable files. This check is performed only on files that will be updated
with new versions in the patch and the results are displayed in the Merge
Files screen. If there are no changes to user-modifiable files, this screen is not
displayed.
The Installation software will attempt to merge changes from the existing
user-modifiable files into the new versions of the files that are in the patch.
The Merge Files screen lists the files that were changed so that you are aware
of the scope of the merge:

A red x-mark indicates that a file was modified after the previous patch was
installed.

An orange exclamation point indicates that a file was modified before the
previous patch was installed.

6.

Choose whether to use merged files or the new files from the patch:

Select Merge and use the files to merge changes from existing versions of
the user-modifiable files into the new versions from the patch. These
merged files will be used when the products are restarted.
Unchanged versions of the new patch files are also installed, but they are
named with an extension that corresponds to the patch number. This
prevents the files from being used when the products are restarted.
The existing files are backed up into a directory that is named using the
version number of the previous patch release that was installed
(<BASEDIR>/smarts/.local.bkp.<previous_version_number>).

Select Merge but do not use the files to merge changes from existing
versions of the user-modifiable files into the new versions from the patch.
These merged files will be named with the extension .automerge and will
not be used when the products are restarted.
New, unmerged versions of the user-modifiable files from patch are also
installed and are named so that they will be used by the products when
they are restarted.
The existing files are backed up into a directory that is named using the
version number of the previous patch release that was installed
(<BASEDIR>/smarts/.local.bkp.<previous_version_number>).
Click Next.

7.

Verify the target installation directory and click Next.


The list of products to be installed will contain only the patch. At the bottom
of this screen, the total amount of disk space required for the patch is
provided so that you can verify that adequate disk space is available.

8.

Upon completion, the Installation Summary displays informational messages


including the confirmation of a successful installation and the location of the
log file for the automatic reconciliation and file merge. The names of all
merged files that contain conflicts are also displayed. Click Finish to exit the
installation.

9.

Reconcile the files with conflicts and review successfully merged files as
described in Reconcile user-modifiable files.

40 EMC Smarts Version 8.1.4 Patch 10 Readme

Installation

Apply patch using CLI mode


CLI mode provides a text-based method for invoking the Installation software. This
mode is intended for UNIX platforms with non-graphic (text-only) consoles. The CLI
mode installation follows the same process as the wizard mode but displays text on
the terminal screen and requires user responses on the keyboard.
Run CLI mode
1.

Change directory to the directory where you typically store patches, for
example, <BASEDIR> for your product suite.

2.

Type the setup command listed in Table 16 and then press Enter. Replace
xx with the relevant product name, for example, IP, SAM, SAMADP, VOIP,
MPLS, MCAST, and NPM. For exact name, check the Patch Installation Files
section.

Table 16.

Setup command syntax for CLI mode

Operating
system

CLI setup command syntax

Linux

./setup-xx-linux-8_1_4_10-20140626-64BIT.bin
-console

Linux AS 5
&6

IP & SAM Adapters for Linux AS 5 & 6:


./setup-xx-linux-rhAS50-8_1_4_10-2014062664BIT.bin -console
MCAST for Linux AS 5:
./setup-MCAST-linux-rhAS50-8_1_4_10-2014062364BIT.bin -console
MCAST for Linux AS 6:
./setup-MCAST-linux-rhAS60-8_1_4_10-2014080664BIT.bin -console

Solaris

./setup-xx-solaris-8_1_4_10-2014062664BIT.bin -console

Windows

setup-xx-win-8_1_4_10-20140626-64BIT.exe console

A welcome message with information about the installation appears.


You may need to point the Patch installer to the java location. (Click here for
more details)
User selections and navigation in CLI mode
During the patch installation process, at the end of each screen of text, you are
prompted with a set of options. For example:
Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay
[1]

Select a choice by typing its number and pressing Enter.

EMC Smarts Version 8.1.4 Patch 10 Readme

41

Installation

Accept the default choice, indicated in brackets ([1] in the above example), by
pressing Enter.

To navigate between the steps, type a number key as listed in Table 17 and then
press Enter.
Table 17.

CLI mode navigation keys

Key

Operation

Next, continue to the next step

Previous, go back to the previous step

Cancel, terminates the install program

Redisplay, repeats the step

Accept the marked ([X]) menu choice

Other screens have different choices. For example when the license agreement is
displayed, the following prompt appears:
Press ENTER to read the text [Type q to quit]

Press Enter after reading each page. At the end of the license agreement, the
installation process displays the first of several menus.
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]

Each choice is numbered and has a pair of brackets. The default menu choice (2 in
this example) has an X in the brackets. Type the number of the desired selection and
press Enter. In the case of the license agreement, you must accept the agreement by
typing 1 and pressing Enter.
The screen is redisplayed with an X in the brackets next to the selected item. When
you are satisfied with the indicated selection, type 0 (zero) and press Enter.
The rest of the installation follows the same steps as the Wizard Mode but uses the
above method for selecting choices and navigating through the installation steps.
When the patch installation is complete, reconcile the configuration files as
described in Reconcile user-modifiable files.

Apply patch using Unattended (Silent) mode


Unattended mode installs the patch without user input or a response file. When
invoking the install program, specify the location of the product suite to be patched.
In order to invoke an unattended installation of the patch, type the appropriate setup
command from Table 18 or Table 19 for SAM Console and then press Enter. Replace

42 EMC Smarts Version 8.1.4 Patch 10 Readme

Installation

xx with the relevant product name, for example, IP, SAM, SAMADP, VOIP, MPLS,
MCAST, and NPM. For exact name, check the Patch Installation Files section.
Table 18.

Setup command syntax for unattended mode

Operating
system

Unattended setup command syntax

Linux

./setup-xx-linux-8_1_4_10-20140626-64BIT.bin silent
-G replaceNewerResponse="Yes to All"
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}

Linux AS 5
&6

IP & SAM Adapters for Linux AS 5 & 6:


./setup-xx-linux-rhAS50-8_1_4_10-20140626-64BIT.bin
silent
MCAST for Linux AS 5:
./setup-MCAST-linux-rhAS50-8_1_4_10-2014062364BIT.bin silent
MCAST for Linux AS 6:
./setup-MCAST-linux-rhAS60-8_1_4_10-2014080664BIT.bin silent
-G replaceNewerResponse="Yes to All"
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}

Solaris

./setup-xx-solaris-8_1_4_10-20140626-64BIT.bin
silent
-G replaceNewerResponse="Yes to All"
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}

Windows

setup-xx-win-8_1_4_10-20140626-64BIT.exe silent
-G replaceNewerResponse="Yes to All"
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}

<BASEDIR> is the location where the EMC Smarts software is installed.


{auto|manual} specifies the merge operation. You must choose either:

auto will merge existing versions of the user-modifiable files with new versions that
are included in the patch. These merged files will be used when the products are
restarted. This is equivalent to Select Merge and use the files in Wizard mode.

manual will install and use the new versions of the user-modifiable files included in
the patch. Merged versions of the files will also be created and saved for review. This

EMC Smarts Version 8.1.4 Patch 10 Readme

43

Log files
Operating
system

Unattended setup command syntax

is equivalent to Select Merge but do not use the files in Wizard mode.

When the patch installation is complete, reconcile the configuration files as


described in Reconcile user-modifiable files.
You may need to point the Patch installer to the java location. (Click here for more
details).
Table 19.

Setup command syntax for unattended mode for SAM Console

Operating
system

Unattended setup command syntax

NA

NA

<BASEDIR> is the location where the EMC Smarts software is installed.


{auto|manual} specifies the merge operation. You must choose either:
auto will merge existing versions of the user-modifiable files with new versions that are
included in the patch. These merged files will be used when the products are restarted.
This is equivalent to Select Merge and use the files in Wizard mode.
manual will install and use the new versions of the user-modifiable files included in the
patch. Merged versions of the files will also be created and saved for review. This is
equivalent to Select Merge but do not use the files in Wizard mode.

When the patch installation is complete, reconcile the configuration files as


described in Reconcile user-modifiable files.

Log files

Table 20 lists the files that the Installation software creates during the install
process.
Table 20.

Patch report and log file locations

Name
Install log

Merged files log

Path

File Name

<BASEDIR>/smarts/setup/logs

Install.<patch
version>.log

C:\tmp (if install fails)


BASEDIR/smarts/setup/logs

install.merge.<patch
version>.log

Where <patch version> is the complete version number for the patch, for example,
8.1.4.10

Install log

The installer creates an Install log file listing all actions performed by the installation.
You need not read this file unless you suspect an installation failure.
If the installation process fails, the log files are located in a temporary directory, for
example /tmp or C:\temp. A non-zero status indicates a failure.

44 EMC Smarts Version 8.1.4 Patch 10 Readme

Reconcile user-modifiable files

Merged files Log


This log lists the files in the BASEDIR/smarts/local directory structure that were
merged. For each merged file, the log lists the location and name of the file. If any file
cannot be merged due to conflicts, this is also noted. In addition, the log lists the
name and location for unmerged versions of all user-modifiable files that are
included in the patch.

Reconcile user-modifiable files

The Installation software is designed to preserve your changes to user-modifiable


files when installing new versions of these files. The Installation software does this by
analyzing the user modifiable-files to answer these questions:

For each new user-modifiable file in a patch, has the current version of the file
been changed?

If the current version was changed, do the changes conflict with changes in the
new version in the patch?

Existing changes to user-modifiable files are always automatically merged into new
files, but you control whether or not the files are used by making one of these
selections during installation:

Merge and use the files: If there are no conflicts between the changes in the
new file and the changes in the current version, the Installation software
combines the changes in to merged version of the user-modifiable file. The
merged version is named and placed in the location where the Manager can
load and use it.
If there are conflicts between changes in the new file and the changes in the
current version, then a conflict file (.<filename>.<patch version>.conflict)is
created that clearly indicates the issues so that you can evaluate them. In
addition, an unchanged version of the file from the patch is placed in the
location where the Manager can load and use it. Resolve issues in conflict files
section provides a procedure to resolve the conflicts.

Merge but do not use the files: All the new user-modifiable files included in the
patch are placed in the location where the Manager can load and use them.
These files do not include any changes from your current files.
The Installation software does combine changes from the current files with the
new files, but the changes are saved into merged versions that are named
using an extension (.automerge) so that the Manager will not use the merged
files. You can then review these automerge files and decide when to make
merged changes operational. See Rename and use Automerge files for this
procedure.
If there are conflicts between changes in the new file and the changes in the
current file, then a conflict file is created that clearly indicates the issues so
that you can evaluate them. See Resolve issues in conflict files for a procedure
to resolve the conflicts and use the files.

EMC Smarts Version 8.1.4 Patch 10 Readme

45

Reconcile user-modifiable files

The Installation software also creates a backup of all the versions of the usermodifiable files to ensure that you will not lose any configuration data. See Backup
versions of user-modifiable files for a description of the backup files.
Note: In UNIX, the conflict and automerge versions of the user-modifiable files are
hidden files.

Backup versions of user-modifiable files


The Installation software always creates backup versions of user-modifiable files
included in the patch and all current versions of the files. Table 21 lists the purpose
and location of all user-modifiable files that the Installation software creates during
the install process and their locations.
Table 21.

Purpose and location of backup files

Purpose of back up file

Path (from BASEDIR/smarts)

Example (from BASEDIR/smarts)

Preserve settings of the new


user-modifiable file in patch

/local/<directory>/.<filename>.<
patch version>

/local/conf/.discovery.conf.8.1.4.10

Preserve your changes in the


current user-modifiable file, if a
new version of the same file is in
the patch

/.local.bkp.<patch
version>/<directory>/<filename>

/.local.bkp.8.1.4.0/conf/discovery.c
onf

Where:
<directory> is the standard location for the file
<filename> is the standard name of the file
<patch version> is the complete version number for the patch, for example, 8.1.4.10

Review the results of the reconciliation process

The results of the reconciliation analysis performed during the installation and all
actions taken are included in the merged files log located in
<BASEDIR>/smarts/setup/logs. The name of the log file is
install.merge.<patch version>.log

Determine which files require action by reviewing the merged files log generated by
the install process:
1.

Using any editor, open and review the log:

BASEDIR/smarts/setup/log/Install.Merge.8.1.4.10.log.

2.

Review the log:

Resolve conflicts in files manually. See Resolve issues in conflict files.

If you chose the Merge and do not use option during the installation, note
the entries that indicate file merges without conflicts that resulted in
automerge files. The automerge file can be reviewed and then manually
renamed for use. See Rename and use Automerge files.

46 EMC Smarts Version 8.1.4 Patch 10 Readme

Reconcile user-modifiable files

Resolve issues in conflict files


If a conflict occurs, the Installation software creates conflict files that indicate which
portions of the file are an issue.
Review the conflict files and resolve issues using the following procedure:
1.

Open the user-modifiable file where the conflict occurs using sm_edit.
Conflict files are named using the following convention:.

.<filename>.<patch version>.conflict

For example, the conflict file for discovery.conf is named


.discovery.conf.8.1.4.10.conflict. In UNIX, conflict files are hidden files.
2.

Save the file using the same file name, but without the .conflict extension.
This will overwrite the unmerged version of the file included with the patch.
(Note that a backup version of the unmerged file is at .<standard
filename>.8.1.4.10.)

3.

Review and resolve the conflict. The file shows each conflict with applicable
sections from the various versions of the file: a section from the userconfigurable file in the patch (hotfix.txt), another section from the base
release (original.txt), and one from the modified version of the file (local.txt).
The following is an example of a conflict:

<!-- -------- FROM hotfix.txt : ------ -->


# ServerName = "INCHARGE-<Product>"
<!-- --------FROM original.txt -------------------- -->
serverName = "INCHARGE-<Product>"
<!-- --------FROM local.txt -------------------- -->
serverName = "TESTINCHARGE-<Product>"
<!-- ------ END CONFLICT ------ -->

Delete the incorrect sections from the conflict and ensure that the correct
section is uncommented.
4.

Save and close the file.

Rename and use Automerge files

Automerge files are only created if you choose the Merge but do not use the files
option during installation, and no conflicts had occurred during the merge process.
1.

Open and review merged files using sm_edit. Merged files are named as
.<filename>.automerge. For example, the merged version of discovery.conf will
be named .discovery.conf.automerge. In UNIX, automerge files are hidden
files.

2.

If necessary, make changes in the file to reflect your desired configuration.

3.

To use the automerge file, rename the file from .<filename>.automerge to


<filename> and save the file. For example, change the name of the merged file
from .discovery.conf.automerge to discovery.conf and save the file.

4.

Save and close the file.

Note: A backup version of the unmerged user-modifiable file from the patch is at
.<standard filename>.8.1.4.10.

EMC Smarts Version 8.1.4 Patch 10 Readme

47

Uninstallation

Uninstallation

Uninstalling a patch removes all previously applied patches and returns the EMC
Smarts software to the baseline product version.
Note: Administrative privileges are required to uninstall a patch.
Note: Use either the uninstaller program or, for Windows, Add/Remove Programs to
uninstall a patch. Failure to use one of these methods can result in an
unstable system and/or inconsistent product directories.

Roll back to a previous patch


If you want to revert to a previous patch, you must:

Uninstall the currently installed patch to return to the baseline version.

Reinstall the previous patch.

For example, to revert from Patch 20 to Patch 19, uninstall Patch 20, and then
reinstall Patch 19.

Uninstall patch using the Control Panel (Windows only)

Note: If you installed a patch to two different installations of the product on the
same system, use the uninstaller program to remove the patch. Do not use
the Add/Remove Programs because it does not support multiple instances of
the same software.
Use the Windows Control Panel to uninstall a patch:
1.

Click Start > Settings > Control Panel.

2.

Open the list of programs.

For Windows Server 2008, double-click Programs and Features.

For Windows Server 2003, double-click Add/Remove Programs.

3.

From the programs window, select <Product>.

4.

Click Change/Remove.

The uninstaller program proceeds as described in Uninstall steps.

Uninstall patch using the uninstaller program

Use the uninstaller program to uninstall a patch:


Note: Do not to use the uninstaller program in the _uninst directory because it will
remove the entire product.
1.

Change the directory or use the file navigator to find the _rpuninst directory.
For example:

/opt/InCharge/<Product>/_rpuninst on UNIX systems

C:\InCharge\<Product>\_rpuninst on Windows systems

2.

Invoke the uninstaller program. For example:

./uninstaller.bin on UNIX systems

48 EMC Smarts Version 8.1.4 Patch 10 Readme

Uninstallation

C:\uninstaller.exe on Windows

Note: To run the uninstaller program in CLI mode, specify the console option after
the uninstall command.
The uninstall proceeds as described in Uninstall steps.

Uninstall steps
1.

The Welcome screen appears. Click Next.


The patch to be uninstalled is displayed with its location.

2.

Review the patch number and the directory path.

3.

Click Next and the Uninstallation Progress screen appears. After you click
Next, you cannot cancel the uninstallation process.
Upon completion, the Uninstallation Summary displays informational
messages such as successful completions, error messages, and warnings.

4.

Click Next and, if necessary, restart your system. Otherwise, click Finish to
exit the uninstaller program.

The uninstaller program creates a log file with the naming convention
Uninstall.RP.<maj>.<min>.<sp>.log.
<maj> is the major release version number.
<min> is the minor release version number.
<sp> is the service pack release number.
<patch> is the patch number.
The log file is located in the <BASEDIR>/smarts/setup/logs directory.

EMC Smarts Version 8.1.4 Patch 10 Readme

49

Troubleshooting and getting help

Troubleshooting and getting help

EMC support, product, and licensing information can be obtained as follows.


Product information - For documentation, release notes, software updates, or for
information about EMC products, go to EMC Online Support at:
https://support.emc.com
Technical support - Go to EMC Online Support and click Service Center. You will see
several options for contacting EMC Technical Support. To open a service request, you
must have a valid support agreement. Contact your EMC sales representative for
details about obtaining a valid support agreement or with questions about your
account.

50 EMC Smarts Version 8.1.4 Patch 10 Readme

Potrebbero piacerti anche