Professional Documents
Culture Documents
Readme
302-001-893
Rev 01
Copyright 1996 - 2015 EMC Corporation. All rights reserved. Published in the USA.
Published March 2015
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 9.4.0 Patch 1 Readme
Contents
The document contains information about the EMC Smarts Version 9.4.0 Patch 1
release (EMC Smarts 9.4.0.1).
Revision history ..................................................................................................... 5
Scope .................................................................................................................... 5
Patch description ................................................................................................... 5
Enhancements and changes .................................................................................. 8
Known problems and limitations .......................................................................... 15
Number of fixed defects and certified devices ...................................................... 16
Fixed Defects ....................................................................................................... 17
Certified devices .................................................................................................. 26
Environment and system requirements ................................................................ 29
Installation........................................................................................................... 32
Log files ............................................................................................................... 38
Reconcile user-modifiable files ............................................................................ 39
Uninstallation ...................................................................................................... 42
Troubleshooting and getting help ......................................................................... 44
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).
Contents
Revision history
Scope
Revision history
Revision
Release Date
Description
01
Mar 2015
This section presents the product scope for this patch release.
Table 2.
Patch Release
Release date
Mar 2015
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: Not all EMC Smarts 9.4.0 products are released when a patch becomes
available as it may apply only to a subset of products. For example, a patch
release may only apply to SAM and IP and not the rest of the products that
comprise Smarts.
Installation directory
In this document, the term BASEDIR represents the location where EMC Smarts
software is installed.
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 the
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:
Patch description
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.
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:
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>.
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.
Patch description
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-9_4_0_1-20150325-64BIT.bin
setup-IP-win-9_4_0_1-20150325-64BIT.exe
SAM:
setup-SAM-linux-9_4_0_1-20150324-64BIT.bin
setup-SAM-win-9_4_0_1-20150325-64BIT.exe
CONSOLE:
setup-CONSOLE-linux-9_4_0_1-20150324.bin
setup-CONSOLE-win-9_4_0_1-20150325.exe
ESM:
setup-ESM-linux-9_4_0_1-20150324-64BIT.bin
setup-ESM-win-9_4_0_1-20150325-64BIT.exe
MPLS:
setup-MPLS-linux-9_4_0_1-20150324-64BIT.bin
setup-MPLS-win-9_4_0_1-20150325-64BIT.exe
NPM:
setup-NPM-linux-9_4_0_1-20150324-64BIT.bin
setup-NPM-win-9_4_0_1-20150325-64BIT.exe
VoIP:
setup-VOIP-linux-9_4_0_1-20150324-64BIT.bin
setup-VOIP-win-9_4_0_1-20150325-64BIT.exe
OTM:
setup-OTM-linux-9_4_0_1-20150324-64BIT.bin
setup-OTM-win-9_4_0_1-20150325-64BIT.exe
This patch release does not contain any enhancement and changes.
This patch release does not contain any enhancement and changes.
ESM 9.3 release onwards Server Manager provides EMC M&R specific filters and
properties in the XML configuration files for Brocade, Cisco, VNX and VMAX
SolutionPacks where it can fetch data from EMC M&R through web service API in
order to discover and monitor only those Storage devices that belong to a specific
customer defined in M&R instead of importing the entire M&R storage topology.
In order to configure ESM Manager to import devices assigned to a specific customer
in M&R, users need to specify the customer group name in <name>-sp-config.xml file
under $SM_HOME\conf\w4n\sp-xml-conf directory where Server Manager is
installed. The directory contains a configuration file for each SolutionPack: brocadesp-config.xml, vnx-sp-config.xml, vmax-sp-config.xml, cisco-sp-config.xml
For example: If there is a customer group name Pepsi under Groups Management
in EMC M&R, then entityFilter XML tags value inside <name>-sp-config.xml files
should be post-appended with & customer = '%Pepsi% string. Make
modifications to brocade-sp-config.xml, vnx-sp-config.xml, vmax-sp-config.xml,
cisco-sp-config.xml based on these devices being present in your environment.
Before:
<entityFilter>devtype =='FabricSwitch' & name=='OperStatus' & vendor ==
'Brocade' & isps = 'yes ' & (!vstatus | vstatus=='active')</entityFilter>
After:
<entityFilter>devtype =='FabricSwitch' & name=='OperStatus' & vendor ==
'Brocade' & isps = 'yes ' & (!vstatus | vstatus=='active') & customer =
'%Pepsi%</entityFilter>.
Note: Loading of these files from <BASEDIR>/local is not supported. Editing these files
via sm_edit is discouraged. These files are only present under
<SMARTS_BASE_DIR>\conf\w4n\sp-xml-conf. Make a manual copy of the files before
making any modifications.
Note: ESM Server needs to be restarted in order to load changes to these xml files.
Changing polling frequency for Brocade, Cisco, VNX and VMAX SolutionPacks
in EMC M&R 6.5u2
Server Manager (ESM) queries/polls device data from EMC M&R installation through
webservices for both discovery and monitoring. There are scenarios where user
wants to poll device data frequently i.e. less than the default polling interval that is
configured on EMC M&R SolutionPack. In such scenarios user need to modify the
required configuration files as given below.
Steps for frequent polling in VNX SolutionPack
Pre-requisite: VNX SolutionPack should be installed.
Procedure
1. Log in to the EMC M&R platform with your user name and password.
2. Select Administration.
3. Select Centralized Management.
4. Select Logical Overview> Collecting
5. Select Text-Collector::<VNX SolutionPack instance>
6. Edit the conf/textoutputcollector-vnxblock-frequentpoll.xml file under the
Configuration Files + Schemas section.
7. Look for the polling-interval tag:
<simultaneous-collecting>1</simultaneous-collecting>
<polling-interval>300</polling-interval>
<refresh>3600</refresh>
<collecting-group >group</collecting-group>
<source>VNXBlock-Collector</source>
Default value for polling-interval is 300 seconds. Change it to required polling
interval.
8. For each collecting-configuration in same file you will have to set timeout with
polling interval value which was set in previous step.
For example:
<collecting-configuration name="VNXBLOCK-FREQUENTPOLL-DISKS"
timeout="120">
Set the timeout=120 if you had chosen the polling interval as 120.
9. Click on Save.
10. Under Logical Overview> Collecting, Select Collector-Manager::< VNX
SolutionPack instance>.
11. Edit the conf/collecting.xml, as below
Go to line
<collector enabled="false" name="VNXBlock-FrequentPoll" next="VNXCRFSERIALNB" config="Text-Collector/emc-vnx/conf/textoutputcollectorvnxblock-frequentpoll.xml" />
Set enabled='true'.
12. Click on Save.
13. Restart the collector, by clicking on Restart button.
Steps for frequent polling in VMAX SolutionPack
Pre-requisite: VMAX SolutionPack should be installed.
Procedure
1. Log in to the EMC M&R platform with your user name and password.
2. Select Administration.
3. Select Centralized Management.
4. Select Logical Overview> Collecting
5. Select XML-Collector:: <VMAX SolutionPack instance>
11
13
This patch release does not contain any enhancement and changes.
Patch installer throws two error message boxes if Install Shield cannot find a suitable JVM.
15
This section lists the number of defects fixed and devices certified (new and
updated) for this patch:
Table 3.
Product
Number of
fixed defects
Number of new
certifications
Number of updated
certifications
Patch release
DMT/Foundation
9.4.0.1
IP
15
73
9.4.0.1
SAM
9.4.0.1
NPM
9.4.0.1
ESM
9.4.0.1
MPLS
9.4.0.1
VoIP
9.4.0.1
OTM
9.4.0.1
Fixed Defects
Fixed Defects
Symptom
Security vulnerability
reported for FlexNet
License Manager
v11.9.0.0.
Description of Fix
CVE-2011-1389 and
bin/system/lmgrd (.exe)
Patch
Release
9.4.0.1
bin/system/lmutil (.exe)
bin/system/sm_lmgrd92
(.exe)
lib/libsm_license.so Linux
CVE-2011-4135.
lib/libsm_dmtlic.so - Linux
lib\sm_license.dll Windows
lib\sm_dmtlic.dll -Windows
IS-144
64470330
lib/libsm_repos.so - Linux
9.4.0.1
lib/sm_repos.dll Windows
17
Fixed Defects
CQ/JIRA or SR
Ticket Number
Symptom
Description of Fix
Patch
Release
Symptom
Description of Fix
9.4.0.1
NetworkConnection is
not built between
AggregatePorts
A new class
AggregateInterface was
introduced that is derived
from Interface. ITwill retain
the underlying IP relationship
which will be used for
creating a
NetworkConnection.
Patch
Release
rules/devstat/settings/thrsetting.asl
9.4.0.1
rules/discovery/ic-clearinterface-layering.asl
rules/Discovery/adapter/icetherChannel-perfInst.asl
rules/discovery/adapter/iclag-dot3ad.asl
rules/discovery/ic-post-stptrunk.asl
rules/Discovery/cisco/iclag-cisco-pagp.asl
conf/discovery/discovery/c
isco/DISCOVERY_CISCO.im
port
conf/health/settings.conf
lib/ sm_health.dll
Windows
lib/ libsm_health.so
Linux
lib/sm_icim.dll -- Windows
lib/libsm_icim.so Linux
IS-2572
68914338
IS-2698
IS-2177
Even though an IP
domain was started in
conf/discovery/DISCOVERY
_CISCO.import
conf/discovery/DISCOVERY
_CISCO.import
9.4.0.1
rules/discovery/ic-ciscofind-context.asl
9.4.0.1
Fixed Defects
CQ/JIRA or SR
Ticket Number
67289066
Patch
Release
Symptom
Description of Fix
Availability Mode
(AMONLY),it generated
discovery errors related
to performance
discovery.
rules/discovery/ic-ciscoend-device-CPUProc.asl
IP domain is alerting on
unused Power Supplies
rules/discovery/ic-huaweiH3C-health.asl
9.4.0.1
conf/discovery/DISCOVERY
_CISCO.import
9.4.0.1
Example error:
SWFE-E-EGETNEXT-While
getting next of OID
.1.3.6.1.4.1.9.9.109.1.1.
1.1.2, SNMPERESPONSE-No response
from 167.84.168.18,
port 161 SNMPETIMEOUT-Timed out; in
file
"/work/tancurrent/DMT9.3.0.0/116/smarts/snm
p/lib/SNMP_RequestsSe
nder.c" at line 1337
IS-2807
69545606
IS-2744
69368428
rules/discovery/ic-nexushealth.asl
rules/discovery/discoveryinit.asl
9.4.0.1
19
Fixed Defects
CQ/JIRA or SR
Ticket Number
Symptom
Description of Fix
Patch
Release
9.4.0.1
components such
WirelessController,
WirelessAccessPoints,
AuthenticationServer and
WirelessClients.
IS-2843
69214978
IS-2540
68892656
The TemperatureSensor
is showing as
"UNKNOWN" for status
for a Ciena Switches
lib/sm_health_ciena.dll -Windows
StateNotNormal alarm is
not generated for a
Juniper device when a
Power Supply is out of
chassis.
PowerSupply_Fault_JuniperE
nvMon instrumentation
class has been changed to
map NOSUCHINSTANCE to
CRITICAL status resulting in
StateNotNormal alarm. The
fix applies to all Juniper
devices using
PowerSupply_Fault_JuniperE
nvMon instrumentation
lib/libsm_health_juniper.so
Linux
lib/libsm_health_ciena.so
-- Linux
9.4.0.1
IS-2433
68025616
rules/discovery/ic-cisco-postprocessor.asl
9.4.0.1
IS-1870
65823972
conf/discovery/DISCOVERY_CI
SCO.import
conf/discovery/oid2Type_Cisc
o.conf
9.4.0.1
IS-2474
68548850
Smarts IP Configuration
Manager will not push the
ProcessorUtilizationAlertMo
de setting to IP domain
conf/icf-c/push.conf
9.4.0.1
Fixed Defects
CQ/JIRA or SR
Ticket Number
Symptom
Description of Fix
Patch
Release
lib/sm_auto_discovery.dll
Windows
9.4.0.1
lib/libsm_auto_discovery.so
Linux
IS-2708
CQ654354
62996904
lib/libsm_auto_discovery.so - Linux
lib/sm_auto_discovery.dll -Windows
9.4.0.1
IS-2657
68568216
rules/discovery/ic-ciscocdp.asl
rules/discovery/ic-cisco-postprocessor.asl
rules/discovery/ic-preprocessor.asl
9.4.0.1
21
Fixed Defects
CQ/JIRA or SR
Ticket Number
IS-2856
69578978
Symptom
Description of Fix
Warning messages in
discovery logs
Example:
[February 27, 2015 7:40:37
AM CST +920ms]
t@102284 Discovery #3
ASL_MSG-*-ASLPdiscovery/ic-teamedifhostvendorinfo.asl: ***
WARNING *** *** DEFAULT
*** line:
.1.3.6.1.4.1.232.11.2.2.12.
0|4956522D53384D502D4
34647505032|
Patch
Release
local/rules/discovery/icteamedif-hostvendorinfo.asl
9.4.0.1
Symptom
Description of Fix
9.4.0.1
IS-2107
67325824
IS-2720
69106668
Patch
Release
masterpiece.jar
9.4.0.1
icoi-trapd/
trap_mgr_parse.asl
9.4.0.1
lib/libsm_ics_ems.so Linux
9.4.0.1
lib\sm_ics_ems.dll Windows
Fixed Defects
CQ/JIRA or SR
Ticket Number
Symptom
Description of Fix
Patch
Release
lib/libsm_storage_ext.so
Linux
9.4.0.1
lib\sm_storage_ext.dll
Windows
lib/libsm_otm_sam.so Linux
lib\libsm_otm_sam.dll Windows
Symptom
Description of Fix
The Fixed Foundation Defects
table lists issues fixed in the
patch.
Patch
Release
9.4.0.1
Symptom
Description of Fix
Patch
Release
9.4.0.1
Symptom
Description of Fix
The Fixed Foundation Defects
table lists issues fixed in the
patch.
Patch
Release
9.4.0.1
23
Fixed Defects
Symptom
Description of Fix
Patch
Release
local/rules/esm/esm-post.asl
9.4.0.1
IS-2882
classes/esm_vcenter.jar
9.4.0.1
Fixed Defects
CQ/JIRA or SR
Ticket Number
Symptom
Description of Fix
Patch
Release
iscovery(W4NDiscoveryMa
nager.java:117)
at
com.smarts.w4n.discovery
.common.W4NDiscoveryM
anager.initiateDiscovery(W
4NDiscoveryManager.java:
96)
at
com.smarts.w4n.discovery
.common.W4NDiscoveryPr
obe.invoke(W4NDiscovery
Probe.java:134)
at
com.smarts.java_probe.Pr
obeRunner.invoke(ProbeR
unner.java:69)
SND-1990
classes/esm_vcenter.jar
9.4.0.1
rules/f5/ic-f5_esm-pools.asl
conf/esm/DISCOVERY_f5_ES
M.import
9.4.0.1
MemberPort
MemberPortLink
TraversedBy
In case of ESM and M&R
integration the following
relationships may not be
discovered for Brocade
Fabric: MemberPort,
MemberPortLink,
TraversedBy
IS-2838
69573044
25
Certified devices
CQ/JIRA or SR
Ticket Number
Symptom
Description of Fix
Patch
Release
Patch
Release
members.
Symptom
Description of Fix
9.4.0.1
The TopologicalLink
Down problem does not
have the PTP LosEvent
as its impact.
Certified devices
lib/libsm_wdm_ng.so
Linux
9.4.0.1
lib\sm_wdm_ng.so
Windows
This section describes the devices certified and the certification impact in this patch:
Table 2.
CQ/JIRA or SR
Ticket
Number
Product
Symptom
Description of Fix
Patch
Release
N/A
N/A
N/A
N/A
N/A
N/A
Certification impact
This section lists the impacted drivers and SysOIDs as a result of certification
changes.
Table 3.
Certification impact
CQ/JIRA or SR
Ticket Number
Product
Impacted drivers
Impacted SysOIDs
Patch
Release
IS-2540
IP
Environment =
JuniperEnvMon:DeviceID
.1.3.6.1.4.1.2636.1.1.1.2.5
9.4.0.1
.1.3.6.1.4.1.2636.1.1.1.2.4
.1.3.6.1.4.1.2636.1.1.1.2.2
.1.3.6.1.4.1.2636.1.1.1.2.1
.1.3.6.1.4.1.2636.1.1.1.2.3
.1.3.6.1.4.1.2636.1.1.1.2.8
.1.3.6.1.4.1.2636.1.1.1.2.6
Certified devices
CQ/JIRA or SR
Ticket Number
Product
Impacted drivers
Impacted SysOIDs
Patch
Release
.1.3.6.1.4.1.2636.1.1.1.2.7
.1.3.6.1.4.1.2636.1.1.1.2.11
.1.3.6.1.4.1.2636.1.1.1.2.9
.1.3.6.1.4.1.2636.1.1.1.2.10
.1.3.6.1.4.1.2636.1.1.1.2.14
.1.3.6.1.4.1.2636.1.1.1.2.15
.1.3.6.1.4.1.2636.1.1.1.2.13
.1.3.6.1.4.1.2636.1.1.1.2.17
.1.3.6.1.4.1.2636.1.1.1.2.17.1
.1.3.6.1.4.1.2636.1.1.1.2.17.2
.1.3.6.1.4.1.2636.1.1.1.2.17.3
.1.3.6.1.4.1.2636.1.1.1.2.17.4
.1.3.6.1.4.1.2636.1.1.1.2.20
.1.3.6.1.4.1.2636.1.1.1.2.19
.1.3.6.1.4.1.2636.1.1.1.2.18
.1.3.6.1.4.1.2636.1.1.1.2.23
.1.3.6.1.4.1.2636.1.1.1.2.27
.1.3.6.1.4.1.2636.1.1.1.2.24
.1.3.6.1.4.1.2636.1.1.1.2.25
.1.3.6.1.4.1.2636.1.1.1.2.21
.1.3.6.1.4.1.2636.1.1.1.2.29
.1.3.6.1.4.1.2636.1.1.1.2.30
.1.3.6.1.4.1.2636.1.1.1.2.31
.1.3.6.1.4.1.2636.1.1.1.2.26
.1.3.6.1.4.1.2636.1.1.1.2.28
.1.3.6.1.4.1.2636.1.1.1.2.32
.1.3.6.1.4.1.2636.1.1.1.2.36
.1.3.6.1.4.1.2636.1.1.1.2.35
.1.3.6.1.4.1.2636.1.1.1.2.34
.1.3.6.1.4.1.2636.1.1.1.2.40
.1.3.6.1.4.1.2636.1.1.1.2.39
.1.3.6.1.4.1.2636.1.1.1.2.41
.1.3.6.1.4.1.2636.1.1.1.2.43
.1.3.6.1.4.1.2636.1.1.1.2.33
.1.3.6.1.4.1.2636.1.1.1.2.44
.1.3.6.1.4.1.2636.1.1.1.2.49
.1.3.6.1.4.1.2636.1.1.1.2.57
.1.3.6.1.4.1.2636.1.1.1.2.73
.1.3.6.1.4.1.2636.1.1.1.4.82.1
27
Certified devices
CQ/JIRA or SR
Ticket Number
Product
Impacted drivers
Impacted SysOIDs
Patch
Release
.1.3.6.1.4.1.2636.1.1.1.2.84
.1.3.6.1.4.1.2636.1.1.1.2.67
.1.3.6.1.4.1.2636.1.1.1.2.59
.1.3.6.1.4.1.2636.1.1.1.2.69
.1.3.6.1.4.1.2636.1.1.1.4.84.1
.1.3.6.1.4.1.2636.1.1.1.4.84.2
.1.3.6.1.4.1.2636.1.1.1.2.90
.1.3.6.1.4.1.2636.1.1.1.2.64
.1.3.6.1.4.1.2636.1.1.1.2.76
.1.3.6.1.4.1.2636.1.1.1.2.58
.1.3.6.1.4.1.2636.1.1.1.4.82.2
.1.3.6.1.4.1.2636.1.1.1.2.92
.1.3.6.1.4.1.2636.1.1.1.2.89
.1.3.6.1.4.1.2636.1.1.1.2.88
.1.3.6.1.4.1.2636.1.1.1.2.93
.1.3.6.1.4.1.2636.1.1.1.2.86
.1.3.6.1.4.1.2636.1.1.1.2.102
.1.3.6.1.4.1.2636.1.1.1.2.104
.1.3.6.1.4.1.2636.1.1.1.2.98
.1.3.6.1.4.1.2636.1.1.1.2.63
.1.3.6.1.4.1.2636.1.1.1.4.82.5
IS-2744
IP
HEALTH = Nexus-Entity
.1.3.6.1.4.1.9.12.3.1.3.377
9.4.0.1
.1.3.6.1.4.1.9.12.3.1.3.1060
IS-2843
IP
Environment
=
CienaLEOSChassis:Device
ID
.1.3.6.1.4.1.6141.1.78
.1.3.6.1.4.1.6141.1.79
.1.3.6.1.4.1.6141.1.77
.1.3.6.1.4.1.6141.1.80
9.4.0.1
This section lists the supported operating systems and describes how to verify the
version number.
VOIP
linux_rhAS50-x86-64/206320000
linux_rhAS50-x86-64/206320000
SAM
sm_server:
IP
29
MPLS
Console
sm_server:
linux_rhAS50-x86-32/206180000
SAM_CONSOLE_SUITE: V9.4.0.1(140754), 24-Mar2015 07:21:47 Copyright 1995-2015, EMC
Corporation - Build 8
Foundation V9.4.0.1(140746), 23-Mar-2015
23:14:20 Copyright 1995-2015, EMC
Corporation - Build 5
NPM
ESM
Product
OTM
31
Installation
Installation
Run the appropriate setup command listed in Table 5. Replace xx with the
relevant product name, for example, IP, SAM, ESM, VOIP, MPLS, and NPM.
For exact name, check the Patch Installation Files section.
Table 5.
Operating
system
Linux
./setup-XX-linux9_4_0_1-2015032464BIT.bin
./setup-CONSOLE-linux9_4_0_1-20150324.bin
Windows
setup-XX-win-9_4_0_120150325-64BIT.exe
setup-CONSOLE-win9_4_0_1-20150325.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.
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.
Installation
4.
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.
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.
33
Installation
8.
9.
Reconcile the files with conflicts and review successfully merged files as
described in Reconcile user-modifiable files.
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.
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 6 and then press Enter. Replace
xx with the relevant product name, for example, IP, SAM, ESM, VOIP,
MPLS and NPM. For exact name, check the Patch Installation Files section.
Table 6.
Operating
system
Linux
./setup-XX-linux-9_4_0_120150324-64BIT.bin -console
./setup-CONSOLE-linux9_4_0_1-20150324.bin console
Windows
setup-XX-win-9_4_0_120150325-64BIT.exe -console
setup-CONSOLE-win-9_4_0_120150325.exe -console
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 7 and then press
Enter.
34 EMC Smarts Version 9.4.0 Patch 1 Readme
Installation
Table 7.
Key
Operation
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.
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 8 or Table 9 for SAM Console and then press Enter. Replace xx
with the relevant product name, for example, IP, SAM, ESM, VOIP, MPLS and NPM. For
exact name, check the Patch Installation Files section.
35
Installation
Table 8.
Operating
system
Linux
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}
setup-XX-win-9_4_0_1-20150325-64BIT.exe -silent
-G replaceNewerResponse="Yes to All"
Windows
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}
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.
Linux
Windows
setup-CONSOLE-win-9_4_0_1-20150325.exe -silent
-G replaceNewerResponse="Yes to All"
-P rpProduct.installLocation=<BASEDIR>
-W mergeSummaryPanel.choiceMergeResult={auto|manual}
Installation
Operating
system
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.
37
Log files
Log files
Table 10 lists the files that the Installation software creates during the install process.
Table 10. Patch report and log file locations
Name
Install log
Path
File Name
<BASEDIR>/smarts/setup/logs
Install.<patch
version>.log
install.merge.<patch
version>.log
Where <patch version> is the complete version number for the patch, for example,
9.4.0.1
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.
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.
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.
39
/local/<directory>/.<filename>.<
patch version>
/local/conf/.discovery.conf.9.4.0.1
/.local.bkp.<patch
version>/<directory>/<filename>
/.local.bkp.9.4.0.1/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, 9.4.0.1
Determine which files require action by reviewing the merged files log generated by
the install process:
1.
BASEDIR/smarts/setup/log/Install.Merge.9.4.0.1.log.
2.
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.
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:.
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>.9.4.0.1.)
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:
Delete the incorrect sections from the conflict and ensure that the correct
section is uncommented.
4.
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.
3.
4.
Note: A backup version of the unmerged user-modifiable file from the patch is at
.<standard filename>.9.4.0.1.
41
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.
For example, to revert from Patch 20 to Patch 19, uninstall Patch 20, and then
reinstall Patch 19.
For Windows Server 2012, Right-click at the screens bottom-left corner and
from the pop-up menu choose Control Panel
2.
3.
4.
Change the directory or use the file navigator to find the _rpuninst directory.
For example:
2.
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.
2.
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.
43