Cisco Software Manager User Guide

Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883

Text Part Number: OL-29903-02

© 2013 Cisco Systems, Inc. All rights reserved.
 CHAPTER 1
Cisco Software Manager User Guide
This document describes how to install and use the Cisco Software Manager that eases the Software
Maintenance Upgrades (SMUs) and Service Packs (SPs) management process on devices running the Cisco
IOS XR Software.

Note The Service Packs are available only for Cisco ASR 9000 device, release 4.3.2 or later versions.

• Introduction, page 2
• Changes to this Document, page 2
• Installing the Cisco Software Manager, page 2
• Icons and Names, page 5
• Pre-Requisite for SMU Recommendation, page 6
• Using the Cisco Software Manager, page 6
• Set Up the Cisco Software Manager, page 7
• Retrieve SMUs or SPs Information from Cisco.com, page 8
• View SMU or SP Details, page 8
• Select SMUs or SPs, page 9
• Execute SMU or SP Tasks, page 9
• Create a Watch List, page 10
• Obtain SMUs or SPs Recommendations, page 10
• Monitor Pane, page 16
• Obtain an Optimized SMU List, page 19
• Uninstalling the Cisco Software Manager, page 20

Cisco Software Manager User Guide

OL-29903-02 1
 Cisco Software Manager User Guide
Introduction

Introduction
The Cisco Software Manager (CSM) provides SMUs and SPs recommendations to users and reduces their
effort in manually searching, identifying, and analyzing SMUs and SPs that are needed for a device. To provide
the recommendations, CSM must be connected through the Internet to the cisco.com domain. The CSM can
connect to multiple devices and provide SMUs and SPs management for multiple Cisco IOS XR platforms
and releases.

Note The Service Packs are available only for Cisco ASR 9000 device, release 4.3.2 or later versions.

The Cisco Software Manager (CSM) is a standalone Java application that can be installed on Windows, MAC,
and UNIX. The CSM supports Cisco CRS and Cisco ASR 9000 devices.

Changes to this Document

Table-1 lists the technical changes made to this document since it was first printed.

Table 1: Changes to This Document

Revision Date Change Summary

OL-29903-02 March 2014 Republished with documentation updates for CSM
version 2.0:
• Support for Service Packs was introduced.
• Watch List tab was introduced.
• Proxy settings in Set Up dialog box was
introduced.
• Download SMUs or SPs option was introduced.
• Transfer files option was introduced.

OL-29903-01 May 2013 Initial release of this document.

Installing the Cisco Software Manager

This section explains the computer requirements, pre-requisites, and software installation procedure on
Windows, MAC, and UNIX.
To download the Cisco Software Manager (CSM), click CSM.

Cisco Software Manager User Guide

2 OL-29903-02
 Cisco Software Manager User Guide
Computer Requirements

Computer Requirements
The following section lists the computer requirements:

Area Requirements Notes

Operating System Use the latest patch/Service Pack released by
• PC: Windows the OS vendor. Check with the vendor for the
• Unix latest patch/Service Pack.

• Apple Mac OS X

Java Runtime Environment To download JRE, click this URL.

• JRE 1.6
• JRE 1.7

Pre-Requisites for Installing the Cisco Software Manager

The installation script (SetupCSM.cmd for Windows or SetupCSM.sh for Unix and MAC) requires JRE to
be in the search path. If JRE is not present in the search path, users can invoke the installer using the direct
path. For information, see Installing CSM on Windows, on page 3, Installing CSM on MAC, on page 4,
or Installing CSM on UNIX, on page 5.
This section contains steps to include JRE in the search path on Windows system:

Procedure

Step 1 Go to Control Panel>System>Advanced System Settings.

Step 2 In the System Properties window, click Environment Variables.
Step 3 In the System Variables section, select Path and click Edit.
Step 4 Append C:\Program Files\java\jre6\bin to the Variable value field.
Step 5 Click OK. JRE is included in the search path.

Installing CSM on Windows

Procedure

Step 1 From cisco.com, download the current version of the installation file CSM-<version>.zip.
Step 2 Unzip the installation file, (CSM-<version>.zip).
Step 3 Double-click the file, SetupCSM.cmd.

Cisco Software Manager User Guide

OL-29903-02 3
 Cisco Software Manager User Guide
Installing CSM on MAC

Cisco Software Manager begins to install.

A shortcut that launches CSM software is created on the desktop.
Note The SetupCSM.cmd script assumes JRE to be in the search path. If that is not the case, users must
include JRE in the search path: double-click SetupCSM.cmd, or execute the “<JREDir>\bin\java"
-jar installer.jar command in the command prompt. The execution of the "<JREDir>\bin\java" -jar
installer.jar command should be done in the directory where the user has unzip the file content. The
user needs to open a DOS window and change to that directory. JREDir is the location at which JRE
is present, which may be C:\Program Files (x86)\java\jre6 for Windows 7 and C:\Program
Files\java\jre6 for Windows XP.
Step 4 Double-click the CSM icon on the desktop to launch the CSM software.

What to Do Next
Users updating from CSM-1.0 version have to manually copy device profiles stored at the location
\Users\<username>\csm\versions\1.0\LoginInformation.xml file to CSM-2.0 location
\Users\<username>\csm\versions\2.0, so that CSM-2.0 can access device profiles.

Installing CSM on MAC

Procedure

Step 1 From cisco.com, download the current version of the installation file CSM-<version>.zip.
Step 2 Double-click the CSM-<version>.zip file, to unzip it.
The CSM-<version>.0 folder is created.

Step 3 Open a terminal window and change to the directory where you extracted the zip file.

Example:
cd /Users/<username>/Desktop/CSM-2.0.
Step 4 Execute these commands on the terminal window to run the installation script:
• chmod 777 SetupCSM.sh
• ./SetupCSM.sh

Cisco Software Manager begins to install. A shortcut that launches CSM software is created on the desktop.
Note The SetupCSM.sh script assumes JRE to be in the search path. If that is not the case, you can invoke
java (JVM) directly using the full path: /usr/bin/java -jar installer.jar.
Step 5 Double-click the CSM icon on the desktop to launch the CSM application.

What to Do Next
Users updating from CSM-1.0 version have to manually copy device profiles stored at the location (base
directory)/csm/versions/1.0/LoginInformation.xml file to CSM-2.0 location (base directory)/csm/versions/2.0,

Cisco Software Manager User Guide

4 OL-29903-02
 Cisco Software Manager User Guide
Installing CSM on UNIX

so that CSM-2.0 can access device profiles. A base directory is the directory where the user has installed the
CSM.

Installing CSM on UNIX

Procedure

Step 1 From cisco.com, download the current version of the installation file CSM-<version>.zip.
Step 2 Open a terminal window and execute these commands:
a) Create a new folder.

Example:
mkdir newfolder
b) Unzip the file, CSM-2.0.zip, at the newly created folder.

Example:
unzip CSM-2.0.zip
c) Change to the directory to where you extracted the zip file.
d) Run the installation script:
• chmod 777 SetupCSM.sh
• ./SetupCSM.sh

Cisco Software Manager begins to install.

Note The SetupCSM.sh script assumes JRE to be in the search path. If that is not the case, you can invoke
java (JVM) directly using the full path: /usr/bin/java -jar installer.jar.
Step 3 To launch the CSM software, execute one of these commands:
• /users/<username>/csm/bin/CSM2.0.cmd
• /users/<username>/CSM2.0

Note If CSM is installed in a location other than /users/<username>, that specific directory location should
be used while executing above commands.

What to Do Next
Users updating from CSM-1.0 version have to manually copy device profiles stored at the location (base
directory)/csm/versions/1.0/LoginInformation.xml file to CSM-2.0 location (base directory)/csm/versions/2.0,
so that CSM-2.0 can access device profiles. A base directory is the directory where the user has installed the
CSM.

Icons and Names

The following table lists the icons and their names:

Cisco Software Manager User Guide

OL-29903-02 5
 Cisco Software Manager User Guide
Pre-Requisite for SMU Recommendation

Icons Names
Set Up

Task

Refresh

Import

Add Network Elements

Remove Network Elements

Pre-Requisite for SMU Recommendation

For SMU recommendation on the Cisco CRS and Cisco ASR 9000 devices, release 4.2.x, 4.3.0 and 4.3.1, it
is mandatory to install SMU for CSCug82278 (Installing New SMU failed due to incorrect package
incompatibilities) on the device prior to any SMU installation from CSM.

Using the Cisco Software Manager

After installing the Cisco Software Manager, users can perform the following tasks:
1 Set Up Cisco Software Manager. See Set Up the Cisco Software Manager, on page 7.
2 Retrieve SMUs or SP Information from Cisco.com. See Retrieve SMUs or SPs Information from Cisco.com,
on page 8. After retrieving SMUs or SP information from cisco.com, users can execute the following
tasks:
• Download SMUs or SPs
• Transfer Files
• Create TAR File
• View/Extract TAR File
• Export SMU or SP Information

Note See Execute SMU or SP Tasks, on page 9 to download SMU or SP, transfer files,
create TAR file, view/extract TAR file, and to export SMU or SP information.

Cisco Software Manager User Guide

6 OL-29903-02
 Cisco Software Manager User Guide
Set Up the Cisco Software Manager

3 Obtain SMUs or SPs Recommendations. See Obtain SMUs or SPs Recommendations, on page 10.
• Identify Superseded SMUs and SPs. See Identify Superseded SMUs and SPs, on page 17.
• Create and Assign Custom Suggested File. See Create and Assign Custom Suggested File, on page
18.
• Generate the Conformance report. See Generate the Conformance Report, on page 18.

• Download SMUs or SPs

• Transfer Files
• Create TAR File
• View/Extract TAR File
• Export SMU or SP Information
• Create a Watch List

Note See Create a Watch List to create a watch list and Execute SMU or SP Tasks, on page
9 to download SMU or SP, transfer files, create TAR file, view/extract TAR file, and
to export SMU or SP information.

4 Obtain an Optimized SMU List. See Obtain an Optimized SMU List, on page 19.

Set Up the Cisco Software Manager

Procedure

Step 1 Launch the CSM software and click the Set Up icon on the main tool bar.
Step 2 Define the following attributes in the Set Up dialog box:
• Repository Directory—Specify the location on the system where the SMUs or SP can be stored. This
is useful first to determine whether the SMU or SP is present at that location or not, and accordingly the
software displays an appropriate graphical icon next to the SMU or SP entry. A tar file can be created
only if the SMUs or SPs are present in this location.
• Polling Interval—Specify how often the CSM software must query cisco.com to retrieve SMU or SP
information. Before the query, the software first polls all the connected devices for an up-to-date package
information.
• Email Notification Settings—Specify the email account where the email notification has to be sent when
new SMUs or SPs are discovered. The Test Email Account Settings can be used to verify if the email
delivery is operational.
• Proxy Settings—Specify the HTTP Proxy and HTTPS Proxy from Proxy tab. The HTTP and HTTPS
Proxy are needed only if CSM requires such settings to connect to the Internet.

Cisco Software Manager User Guide

OL-29903-02 7
 Cisco Software Manager User Guide
Retrieve SMUs or SPs Information from Cisco.com

Retrieve SMUs or SPs Information from Cisco.com

Based on which platform and release is selected, the Cisco Software Manager (CSM) software retrieves
relevant SMUs from cisco.com. The user can view the list of SMUs retrieved at the SMUs tab. Similarly, the
CSM retrieves relevant SPs from cisco.com and the user can view the list of SPs retrieved at the Service Packs
tab .

Procedure

Step 1 Launch the CSM software.

Step 2 Click the Platforms and Releases button and select the desired platform and the release version. The SMUs
and SPs details retrieved from cisco.com are displayed in their respective tabs.
Note • The Service Packs are available only for Cisco ASR 9000 device, release 4.3.2 or later versions.
• If the software fails to retrieve information, a red highlight message is displayed. You must
close the Platforms and Releases tab and reopen the tab to reconnect to cisco.com. Click the
Open Tab button and select Platforms and Releases to reopen the tab.

Step 3 In the SMUs tab or Service Packs tab, click the Filter (Optimal) button and choose an appropriate filter
option:
• Select the Optimal filter option to view only optimal SMUs or SPs. This option excludes all superseded
SMUs or SPs that are not a pre-requisite for other SMUs or SPs.
• Select the ALL filter option to view all SMUs or SPs.

By default, the Optimal filter option is enabled.

View SMU or SP Details

• To view the details of a SMU or SP, click that specific SMU or SP row. A balloon tool tip that contains
the SMU or SP information (pre-requisites, superseded, and superseded by information) is displayed.
To view the information of other related SMUs or SPs (pre-requisites, supersedes, and so on), click the
SMU or SP hyperlink. Use the blue arrow icons to navigate between different SMU or SP details. To
copy SMU or SP information, click Copy to Clipboard icon (blue icon). You can annotate a SMU or SP
by entering the information in the annotation field at the bottom of the tool tip.
• To view the SMU or SP DDTS information:
• Click the DDTS hyperlink. The default browser is launched.
• Enter the Cisco Authentication login details. The DDTS information from the Software Bug Toolkit
web site is displayed.

Cisco Software Manager User Guide

8 OL-29903-02
 Cisco Software Manager User Guide
Select SMUs or SPs

Select SMUs or SPs

The checkbox on the table header is used to select or de-select all SMUs or SPs at once. If all the SMUs or
SPs listed in the SMU or SP table are not selected, the checkbox is displayed as a filled rectangle.

Execute SMU or SP Tasks

Other actions that users can perform after retrieving SMUs or SPs from cisco.com are:
Download SMUs or SPs— Allows users to download SMUs or SPs from cisco.com. If a SMU or SP is
missing from the repository directory, an orange exclamation icon appears.
To download SMUs or SPs, do the following:
1 In the SMUs tab or Service Packs tab, select the SMUs or SPs.
2 Click Tasks icon and select Download Selected SMUs or Download Selected Service Packs. If the
selected SMUs or SPs exist in the repository directory, then user may choose to overwrite or skip existing
SMUs or SPs.
3 Enter Cisco username and password, and then click Ok.
4 Accept the End User License Agreement and click Ok.

After the download is complete, the SMU or SP tar file is untarred and placed in the repository directory. The
tar file contains the SMU or SP and readme file. To view the readme file, right-click on the SMU or SP entry
and click .txt menu option. The SMUs or SPs list will refresh and indicate that the SMU or SP is now locatable
by displaying the green check icon.
Transfer Files—Allows users to transfer selected SMUs or SPs to a remote TFTP or FTP server:
1 In the SMUs tab or Service Packs tab, select the SMUs or SPs.
2 Click Tasks icon and select Transfer Files.
3 Click Selected SMUs or Selected Service Packs, and then click Next. An error message is displayed if
selected SMUs or SPs are not found in the repository directory.
4 Click Select Files Manually to add files other than SMUs or SPs.
5 Select a transfer method, TFTP or FTP and specify connection parameters. Click Transfer.

Create TAR File—The TAR file contains the SMUs or SPs that can be installed on the device:
1 Manually download the SMUs or SPs from cisco.com at your local system in the repository directory.
2 The SMUs and SPs that are stored in the repository directory are indicated by a green check icon in the
ST (status) column.
3 In the SMUs tab or Service Packs tab, select the SMUs or SPs with the green check icon.
4 Click the Task icon and select Create TAR File. The software alerts the user in case of any missing
prerequisites.
View/Extract TAR File—Users can view the contents of a TAR file and selectively extract the desired SMUs
or SPs. Click the Task icon and select View/Extract TAR File to perform this action.

Cisco Software Manager User Guide

OL-29903-02 9
 Cisco Software Manager User Guide
Create a Watch List

Export SMU or SP Information—Export SMU or SP details of the selected SMUs or SPs or those SMUs
or SPs that are not installed on the device to an HTML file, thus:
1 Click the Task icon and select Export SMU Information or Export Service Pack Information.
2 Select the export option. The SMU or SP information is saved in the HTML file.
The SMU or SP details are sorted by the posted date. Any annotation entered will be present in the
Comments column of the HTML file.

Create a Watch List

To create a watch list, do the following:

Procedure

Step 1 Launch the CSM Software.

To create watch list from Monitor Pane go to step 3.

Step 2 Click the Platforms and Releases button and select the desired platform and the release version. Since the
watch list items are tied to a platform and release, the user needs to select the desired platform and release.
Step 3 In the Watch List tab, enter the SMU ID or DDTS and click Add. An alert notification is displayed when
the SMU entered in the watch list for is available during the next query to cisco.com. To delete a watch item,
select the entry and click Delete icon on top right corner.

Obtain SMUs or SPs Recommendations

To obtain SMUs or SPs recommendations for a specific platform and release, users must provide the device
package information to the CSM software for that particular platform and release using one of the three
sources:
• CLI Output (show install active summary) , on page 10
• Import File, on page 11
• Connected Device, on page 11

The CSM software processes the information that is provided using one of the sources above and displays
the SMUs or SPs recommendations in the Software Monitor pane. For Monitor pane details, see Monitor
Pane, on page 16.

CLI Output (show install active summary)

The users can provide the CLI Output (show install active summary) information to the CSM software using
the CLI Source tab.

Cisco Software Manager User Guide

10 OL-29903-02
 Cisco Software Manager User Guide
Import File

Procedure

Step 1 Launch the CSM software.

Step 2 Click the Open Tab button on the main tool bar and select CLI Source. The CLI Source tab is displayed.
Step 3 Enter the device name and copy-paste a complete 'show install active summary' CLI output.
Step 4 Click Next. The Monitor Pane, on page 16 is displayed. The name of the Monitor pane indicates the input
source, platform, and release number.
Whenever the software discovers new SMUs or SPs from cisco.com, an alert message is displayed.

Import File
The CLI Source tab is used to provide the “show install active summary” information for only one device. To
provide package and SMU or SPs information of multiple devices at the same time, an external file that
contains these details can be imported to the CSM software. To import an external text file, do the following:

Procedure

Step 1 Click the Import icon on the main tool bar.

Step 2 Browse to select the external file and click Import. The external file must follow the expected format as
outlined in the Import dialog box.
Once the external file is imported, the devices whose package information was present in the external file
appear as gray icons in the Network Elements pane.

Step 3 Click each device in the Network Elements pane to view the results in the Monitor Pane, on page 16.

Connected Device
To provide package information through a connected device to the software, connectivity must be established
between the device and the computer that hosts the software. Before connecting the device to the software,
users must:
1 Verify device requirements. See Device Requirements, on page 12.
2 Verify mandatory configuration on the device for the required connection type. See Supported Connection
Types, on page 12.
3 Create Login profiles. See Creating Login Profiles, on page 13.

Once the above listed conditions are met, the users can login to the device. See Login to Device, on page 13.
When the software is successfully connected to the device, it retrieves the package information and adds the
connected device into the Network Elements tree pane. Devices with the same platform and release are grouped
under the same sub-tree (for example, ASR9K-PX-4.2.3). Click each device in the Network Elements pane

Cisco Software Manager User Guide

OL-29903-02 11
 Cisco Software Manager User Guide
Connected Device

to view their results in the Monitor pane. The Package table will be updated based on the selection made. For
Monitor pane details, see Monitor Pane, on page 16.
A connected device displayed in the Network Elements pane can have two colors—orange or blue. Orange
indicates failure in establishing connection between the software and the device during the next polling. Blue
indicates successful connection between the software and the device.

Note If the device is in the discovering state for a long time, the user must remove the device using the Remove
Network Element icon and ensure xml agent tty is configured on the device and then login to the device
again.

Supported Connection Types

The following table lists the connection types that Cisco Software Manager supports to establish connectivity
to the device and the mandatory configuration required on the device:

Connection Mandatory Router Configuration

Telnet telnet vrf default ipv4 server max-servers 20
SSHv1 ssh server
hostname <hostname>
domain name <domain>

SSHv2 ssh server v2

Note Install crypto key on the router when the sshv1 or sshv2 connection is used.

Device Requirements
The following section lists the requirements for Cisco CRS and Cisco ASR 9000 routers to establish connectivity
with the CSM software:
• Install manageability PIE:
• (Cisco ASR9K) asr9k-mgbl-p.pie must be loaded
• (Cisco ASR9K) asr9k-k9sec-p.pie must be loaded for SSHv1 and SSHv2
• (Cisco CRS) hfr-mgbl-px.pie must be loaded
• (Cisco CRS) hfr-k9sec-px.pie must be loaded for SSHv1 and SSHv2

• Enable the XML agent— xml agent tty must be configured on the device.

Cisco Software Manager User Guide

12 OL-29903-02
 Cisco Software Manager User Guide
Connected Device

Creating Login Profiles

Users can create login profiles and save the login information in an XML file. During the next consecutive
logins, the software uses the information present in this XML file and allows the user to login without the
need to re-enter the login details again. The XML file (LoginInformation.xml) created is stored at the application
directory (...\csm\versions\1.0) and can be shared with other users.
To create the login profile, do the following:

Procedure

Step 1 Launch the CSM software.

Step 2 Click the Add Network Elements icon on the main tool bar. The Login dialog box is displayed.
Step 3 Right-click Login Information and choose either Add New Device Group or Add New Device.
Add New Device Group creates a device group to which devices can be added later and Add New Device
adds a device.
The attributes present in the Add New Device dialog box are explained below:
• Connection Category—Choose IP if there is direct connectivity between the computer which hosts the
software and the device, else choose Scripted.
• Connection Type —Choose any one of the listed connection types: Telnet/SSHv1/SSHv2
• Device IP/Name—(Only IP connection category) Enter the device management IP address or the Host
Name.
• Node Name/Port—(Only Scripted connection category) Enter the intermediate server name or IP address.
Enter the port number if the server does not use the default Tenet/SSH port number. Click “…” to add
additional script information. For more information on entering details in this field, refer to the Login
Script Steps, on page 14.
• Device Description—Description of the device.

Login to Device
To login to the device, do the following

Procedure

Step 1 Launch the CSM software.

Step 2 Click the Add Network Elements icon on the main tool bar.
Step 3 Select the device and enter the login credentials that are defined for the device. See Direct Login and Scripted
Login to the Device, on page 14.
Note Users can log into multiple devices simultaneously if they share the same user name and password.
To do so, select multiple devices by using the <Ctrl> / <Shift> key or select the entire device group.

Cisco Software Manager User Guide

OL-29903-02 13
 Cisco Software Manager User Guide
Connected Device

Direct Login and Scripted Login to the Device

Connection between the computer that hosts the software and the device can be established in two ways:
• Direct Connection or Direct Login—The computer that hosts the software is directly connected to the
device. In this case, choose IP as the Connection Category in the Login Screen.
• Indirect Connection or Scripted Login—The computer that hosts the software is connected to the device
through an intermediate server. In this case, choose Scripted as the Connection Category in the Login
screen.

The attributes in the Login screen vary depending on the choice of Connection Category (IP or Scripted).

Direct Login
When IP is chosen as the Connection Category, the following attributes are displayed on the Login screen:
• Device User Name—Enter the device user name
• Device Password—Enter the device password
• Connection Type—Choose Telnet, SSHv1, or SSHv2
• Device IP/Name—Enter the device management IP address.

Scripted Login
When Scripted is chosen as the Connection Category, the following attributes are displayed on the Login
screen:
• Scripted User Name—Enter the intermediate server username
• Scripted Password—Enter the intermediate server password
• Device User Name—Enter the device user name
• Device Password—Enter the device password
• Connection Type—Choose Telnet, SSHv1, or SSHv2
• Node Name/Port—Enter the intermediate server name or IP. Choose "..." to add additional script
information. Enter the port number if the server does not use the default Tenet/SSH port number. For
more information, see Login Script Steps, on page 14 .
• Device Description—Enter the device description.

Login Script Steps

Based on the connection type (telnet, sshv1, or sshv2) between the computer that hosts the software and the
intermediate server, and the connection type between the intermediate server and the device, the following
section provides examples of entering additional script information in the Login Script Steps dialog box,
while creating a login profile or while logging into the device. Click "...." to enter the details in the Login
Script Steps dialog box while creating a login profile or while logging into the device. The steps outlined in
the Login Script Steps depict the manual login sequence:

Cisco Software Manager User Guide

14 OL-29903-02
 Cisco Software Manager User Guide
Connected Device

• The “Wait For” data fields contain prompted string returned by the intermediate server.
• When CSM sees the “Wait For” string, it responds by sending the data defined in the “Send” data field.
• Scripted Username and Scripted Password are the intermediate server authentication that can be selected
from the drop down. During the actual login, these credentials must be entered by the user in the login
screen.
• The appearance of the Login prompt (login:) may vary depending on the system (Windows, MAC, or
UNIX) where the CSM software was installed.
Telnet —>Telnet scripted login indicates that the connectivity type between the computer that hosts the
software and the intermediate server is Telnet and the connectivity type between the intermediate server
and the device is Telnet.

Table 2: Telnet —>Telnet Scripted Login

Wait login: Send: Scripted Username

For:
Wait Password: Send: Scripted Password
For:
Wait intermediate server prompt Send: telnet <device host name or ip
For: address>

Telnet —>SSH scripted login indicates that the connectivity type between the computer that hosts the software
and the intermediate server is Telnet and the connectivity type between the intermediate server and the device
is SSH.

Table 3: Telnet —>SSH Scripted Login

Wait For: login: Send: Scripted Username

Wait For: intermediate server prompt Send: ssh -l <device username> <device
password>
Wait For: password: Send: <device password>

SSH—>Telnet scripted login indicates that the connectivity type between the computer that hosts the software
and the intermediate server is SSH and the connectivity type between the intermediate server and the device
is Telnet.

Table 4: SSH —>Telnet Scripted Login

Wait For: login: Send: Scripted Username

Wait For: intermediate server prompt Send: telnet <device host name or ip
address>

Cisco Software Manager User Guide

OL-29903-02 15
 Cisco Software Manager User Guide
Monitor Pane

SSH —>SSH scripted login indicates that the connectivity type between the computer that hosts the software
and the intermediate server is SSH and the connectivity type between the intermediate server and the device
is SSH.

Table 5: SSH —>SSH Scripted Login

Wait For: login: Send: Scripted Username

Wait For: intermediate server prompt Send: ssh -l <device username> <device
password>
Wait For: password: Send: <device password>

Monitor Pane
The Monitor pane contains three tabs:
• SMUs—Displays SMU information retrieved from cisco.com for a specific platform and release in the
SMU table. SMUs that are already installed on the device are highlighted in green. SMUs that are not
applicable to the device are highlighted in gray. For example, a SMU may require the mpls pie which
is not installed on the device. By default, the software uses the Optimal filter option to display SMU
entries in the SMU table. However, the user may select the All filter option to display all SMUs.
• Service Packs—Displays available service pack information for a specific platform and release in the
SP table. The Service Packs tab is applicable only for Cisco ASR 9000 device, release 4.3.2 and later
versions. The latest service pack is displayed at the top of the table. The existing service packs that are
superseded by the latest service pack have a strike-through font.
• Watch List—Displays SMUs that are being tracked for specific platform and release. The Watch List
allows the user to keep track of the new SMUs that might be released for a specific platform and release.
The details of the new SMUs is provided by the Cisco escalation team to the customer/user along with
customer ETA. The Customer ETA date is for reference and should not be considered as the actual
delivery date. To create a watch list, see Create a Watch List.

Package Table—Displays the packages, SMUs and SPs that are currently present on the device in the bottom
window of SMUs tab and Service Packs tab. The packages, SMUs and SPs can have Active, Active Committed,
Inactive, and Inactive Committed state. The Package table displays packages, SMUs and SPs depending on
their state in Active, Active Committed, Inactive, and Inactive Committed tabs.
This table describes the package states:

State Description
Active Packages that are not persistent across system reloads. To be persistent
the user needs to execute the install committed command on the
packages.

Active Committed Active packages that are persistent across system reloads.

Inactive Packages that are committed and persistent across system reloads; but,
deactivated currently.

Cisco Software Manager User Guide

16 OL-29903-02
 Cisco Software Manager User Guide
Identify Superseded SMUs and SPs

State Description
Inactive Committed Packages that are neither active nor committed.

The SMU, SP and the Package tables have the quick search filter. The filter accepts a string pattern and filters
the display list accordingly. The filter can be used to look up for a specific DDTS, SMUs or SPs within a
specific functional area, for example, BGP. Turn off the filter if you suspect the SMU and SP list should have
more entries. Click the cross icon in the filter to turn off the filter.
The Monitor pane automatically refreshes at every polling interval configured in the Setup dialog box. Also,
users can manually refresh by clicking the Refresh icon to retrieve the updated SMU and SP information
from cisco.com. A manual refresh does not poll the latest package information from the device. To manually
poll the device, use the Refresh icon on the Network Elements pane.
After obtaining the SMU and SP recommendation from cisco.com, users can perform the following tasks:
• Identify Superseded SMUs and SPs, on page 17

• Create and Assign Custom Suggested File, on page 18

• Generate the Conformance Report, on page 18

• Download SMU or SP
• Transfer Files
• Create TAR File
• View/Extract TAR File
• Export SMU or SP Information

Note See Execute SMU or SP Tasks, on page 9 to download SMU or SP, transfer files,
create TAR file, view/extract TAR file, and to export SMU or SP information.

Identify Superseded SMUs and SPs

Based on the SMUs and SPs selected in the SMU and SPs table, the software identifies if there are any
superseded SMUs and SPs on the device and applies a strikethrough font on the SMU or SP names in the
package table. The superseded SMUs or SPs can be removed and deactivated once the selected SMUs or SPs
are activated. When the user clicks on the superseded SMU or SP, a balloon tooltip is displayed with information
on superseded SMU or SP.
In addition, if a SMU or SP is superseded by existing SMUs or SPs on the device, it will also take on the
strikethrough front. To identify which SMUs or SPs are superseded by existing SMUs or SPs on the device,
uncheck all the SMU or SPs entries on the SMU or SP table. The quickest way to uncheck all entries is by
unchecking the checkbox on the table column header.

Cisco Software Manager User Guide

OL-29903-02 17
 Cisco Software Manager User Guide
Create and Assign Custom Suggested File

Create and Assign Custom Suggested File

A pre-certified SMU list that is used to validate against all the devices/routers is referred to as Custom Suggested
SMUs. The CSM software allows the users to create a file that contains the Custom Suggested SMUs. Also,
the user can assign an already existing file (external text file) that contains the required SMUs to validate the
device. The custom suggested file contains only the SMU names. Each line in the file contains a SMU name.

Procedure

Step 1 Launch the CSM software.

Step 2 Obtain SMU recommendation from the software using any one of the following sources:
• CLI Output (show install active summary) , on page 10.
• Import File, on page 11.
• Connected Device, on page 11.

The SMU recommendation is displayed on the SMU tab.

Step 3 Select the required SMUs from the SMU table.

Step 4 Click the Suggest button and choose one of the following:
• Create Suggest File—The selected SMUs can be saved to an external text file. Once the file is created
successfully, the software prompts whether the user wants to assign this file for validating the device.
Click Yes to assign or No to quit the action.

• Assign File to Suggest— Browse for an external text file that contains the required SMUs. The SMU
details are displayed in the Assign File to Suggest dialog box. The assignment is saved and assigned to
this particular platform and release.

Step 5 Click the Suggest button and choose Enable Suggest. A green tick mark is displayed against Suggest.
The Monitor pane is refreshed and the new list of suggested SMUs is displayed in the top window (SMU
table) and the bottom window (Package table) is refreshed accordingly.
Note By default, the Suggest button displays a red cross which indicates it is not enabled.

Generate the Conformance Report

The Conformance report contains information about the selected SMUs and their install statuses on the selected
devices. Similarly, the Conformance report contains information about the selected SPs and their install
statuses on the selected devices. To generate the conformance report for SMUs or SPs, do the following:

Cisco Software Manager User Guide

18 OL-29903-02
 Cisco Software Manager User Guide
Obtain an Optimized SMU List

Procedure

Step 1 Launch the CSM software.

Step 2 Obtain SMU or SP recommendation from the software using any one of the following sources:
• CLI Output (show install active summary) , on page 10.
• Import File, on page 11.
• Connected Device, on page 11.

The SMU or SP recommendation is displayed on the Monitor pane within SMUs tabs and Service Packs tabs.

Step 3 Select the SMUs or SPs and click Conformance Report at the bottom right corner. The SMU or SP
conformance report for the selected SMUs or SP is displayed.
The user can choose to copy the report to the system clipboard or save the report as a text file. The results in
the report are tab delimited and can be pasted onto Microsoft Excel spreadsheet or other applications.
Note If there are multiple devices under the same platform and release sub-tree (on the Network Elements
pane), the users can choose to run the Conformance report against the current device or selected
devices.

Obtain an Optimized SMU List

The CSM software can provide an optimized SMU list by identifying missing pre-requisites and superseded
SMUs. To obtain an optimized SMU list do the following:

Procedure

Step 1 Launch the CSM software.

Step 2 Click the Open Tab button on the main tool bar and select Optimize List. The Optimize List tab is displayed.
Step 3 Provide the master SMU list using any one of the two options listed below:
• Copy and paste the master SMU list and click Optimize.
• Click Read from TAR to supply the SMU list using a tar file and click Optimize. The optimized list
of SMUs is obtained.

Once the list is optimized, the users can do the following:

• View Pre-requisite—Click the Pre-requisites button to view the pre-requisite relationships. The
Pre-requisites button will be enabled only if there is any missing pre-requisite.
• Copy the list—Click the Copy button to copy the annotated list or the optimized list.
The Annotated list includes the tagging seen on the window.
The Optimized list includes all the missing pre-requisites and excludes all the superseded SMUs.
• Create a Suggest File—Click the Suggest button to use the optimized list for creating a Suggest file.

Cisco Software Manager User Guide

OL-29903-02 19
 Cisco Software Manager User Guide
Uninstalling the Cisco Software Manager

Uninstalling the Cisco Software Manager

This section explains how to uninstall the Cisco Software Manager:
• Windows—Navigate to the csm\uninstall folder and click the current version's uninstall command file
(CSM<version>_uninstall.cmd).
◦On Windows XP, the CSM folder is located at “C:\Documents and Settings\<username>”
◦On Windows 7, the CSM folder is located at “C:\Users\<username>”

• MAC—Execute the /Users/<username>/csm/uninstall/CSM<version>_uninstall.sh command on the

terminal window.
• UNIX—Execute the rm –R csm on the terminal window.

Cisco Software Manager User Guide

20 OL-29903-02