Table Of Contents
Working With Software Center
Performing Software Updates
Performing Device Update
Deleting Packages
Scheduling Device Package Downloads
Using the Software Center CLI Utility
Querying Updates on the CiscoWorks Server
Installing Device Packages
Uninstalling Device Packages
Downloading Device Packages
Downloading Software Packages
Viewing Activity Logs
Working With Software Center
Software Center helps you to check for software and device support updates, download them to their server file system along with the related dependent packages, and install the device updates.
Software Center allows you to look for software and device updates from Cisco.com, and download them to a server location. You can install the updates from this location. In the case of device updates, Software Center helps you to install the updates using a web based user interface, wherever possible.
Most of the device family-based packages can be installed directly from the web interface while the device support packages such as IDU have to be installed based on the installation instructions documented in the respective readme files.
You may also uninstall a device support package. Software Center does not support uninstallation of software updates.
To backup what is installed on the server, Software Center maintains a package and device map in the installed packages directory of the respective applications. The package map is a list of all device packages installed on the server and device map is a list of all the supported devices on the server.
Software Center also provides a Command Line Interface to download device updates and software updates, and install or uninstall device packages.
For downloads from Cisco.com to work, you should have access to Cisco.com. For details on configuring Cisco.com credentials, See "Setting up Cisco.com User Account" section.
Software Center helps in:
•
Performing Software Updates
•
Performing Device Update
•
Scheduling Device Package Downloads
•
Viewing Activity Logs
You can perform some of the Software Center tasks using a commnad line utility.
For details, see Using the Software Center CLI Utility.
Performing Software Updates
The Software Updates link under Software Center takes you to the Software Updates page. This page has two dialog boxes:
•
The Bundles Installed dialog box that lists the bundles installed.
•
Products Installed dialog box that lists the applications installed.
These dialog boxes display the bundle or product name, the version, and the date on which the software was installed. To sort the table by version or date of installation, click on the Version / Installed Date link.
You can click the product name links to view the Applications and Packages Installed with the Product page that gives the details of the installed applications, patches, and packages of the product.
The Software Updates page provides options to download updates and select updates.
To download updates:
Step 1
In the CiscoWorks Homepage, select Common Services > Software Center > Software Updates > Download Updates.
The Software Updates page appears.
Step 2
In the Products Installed dialog box, select the check box corresponding to the product for which you want to download the update.
Step 3
Click Download Update, then click Next.
The Image Destination Location page appears.
Step 4
Enter the location, or browse to the location using the Browse tab, then click Next. The destination location should not be the location where CiscoWorks is installed.
The Summary window shows a summary of your inputs.
Step 5
Click Finish to confirm the download operation.
To change the download location, click Back.
To cancel the download, click Cancel.
To select updates:
Step 1
In the CiscoWorks Homepage, select Common Services > Software Center > Software Updates.
The Software Updates page appears.
Step 2
In the Products Installed dialog box, select the check box corresponding to the product for which you want to select update.
Step 3
Click Select Updates.
Step 4
Select the product you need to update, then click Next.
Step 5
Select a destination location, then click Next. The destination location should not be the location where CiscoWorks is installed.
The Download Summary window appears.
Step 6
Click Finish to confirm installation of the selected packages.
If you do not want to add the selected packages, click Back to reselect packages or click Cancel to exit.
Performing Device Update
The Device Updates link under Software Center takes you to the Device Updates page. It displays a count of devices supported for each product installed in the system.
Click on the product name link to view a Package Map that lists all the installed device support packages of the product, and the version of each package.
Package name identifies the device package. For example, the package name AP350 represents Cisco Aironet350 Device Package.
You have to use the package name while specifying the download policy.
Package map is a snap shot of the currently installed device packages for a Product. The backup-restore framework uses Package map during data backup.
Click on the device type count link to view the Device Map that lists the SysObjectID, Device Name, Package Name, and Version.
To check for updates:
Step 1
In the CiscoWorks Homepage, select Common Services > Software Center > Device Updates.
The Device Updates page appears.
Step 2
Select the check box corresponding to the product for which you want to check for updates, then click Check for Updates.
The Source Location page appears. You can check for updates at Cisco.com or at a Server.
Step 3
Select the Cisco.com radio button to check for updates at Cisco.com.
Or
Check for update from a server:
a.
Select the Enter Server Path radio button.
b.
Enter the path or browse to the location using the Browse.
Step 4
Click Next.
The Available Packages and Installed Packages page appears with the following information:
•
Package Name—Name of the package.
•
Type—Type of the update. For example, whether the update is a device package or IDU patch.
•
Product Name—Product for which the update is available.
•
Installed Version—Current version of that product installed in the server.
•
Available version—Version of the product that is available (Other than the installed version).
•
Readme Details—Links to the Readme files associated with the update.
•
Posted date—Date on which the update was posted on Cisco.com.
•
Size—Size of the update.
Step 5
Select the check box corresponding to the package that you wish to update, then click Next.
The Device Update page appears. You can either install device packages or download device packages.
•
To install device packages, select the Install Device Packages radio button.
•
To download device packages, select the Download Device Packages radio button.
If you select Download Device Packages:
a.
Enter the folder in File Selection field or click Browse to select the folder.
b.
Set the frequency of downloads, select the run type from the Run Type drop-down list. You have the following options:
•
Immediate
•
Once
•
Daily
•
Weekly
•
Monthly
If you choose any of the options other than Immediate, set the date and time.
•
Select the date from the date picker.
•
Specify the time from the drop-down lists.
c.
In the Job Description field, enter a description for the download job. This is mandatory.
d.
Enter the E-mail ID in the E-mail field.
e.
Click Next.
The Summary window displays the details.
f.
Click OK to confirm.
If you select Install Device Packages:
a.
Click Next.
A summary of your inputs is displayed.
b.
Click OK to confirm.
A warning appears informing you that the daemons are restarted.
c.
Click OK to continue with installation.
Deleting Packages
You can also delete packages that are outdated or you no longer use.
To delete a package:
Step 1
In the CiscoWorks Homepage, select Common Services > Software Center > Device Updates.
Step 2
Select the check box corresponding to the product, then click Delete Packages.
The wizard displays a window that has the Package name, the Product name, and the Installed version details.
Step 3
Select the check box corresponding to the Package you want to delete.
Step 4
Click Next.
The Summary window displays the details of the Product and the Packages selected.
Step 5
Click Finish to confirm deletion.
To make changes in the previous windows, click Back.
To cancel the operation, click Cancel.
Scheduling Device Package Downloads
You can schedule device package downloads and specify the time, frequency of the downloads.
You can also specify download policies. Software Center supports the following download policies:
•
Download all latest device packages of products installed in the machine.
•
Download newer versions of currently installed packages.
•
Download the specified packages (comma separated).
You have to provide your Cisco.com credentials and the location to which the packages should be downloaded.
To schedule downloads:
Step 1
In the CiscoWorks Homepage, select Common Services > Software Center > Schedule Device Downloads.
The Schedule Downloads dialog box appears.
Step 2
Specify the Cisco.com user credentials.
Step 3
Enter the location, or browse to the location using the Browse tab.
Step 4
Select the radio button corresponding to the download policy you require.
To set the frequency of downloads, select the run type from the Run Type drop-down list. The options are:
•
Immediate
•
Once
•
Daily
•
Weekly
•
Monthly
If you select any of the options other than Immediate:
a.
Select the date from the date picker.
b.
Specify the time from the drop-down lists.
Step 5
In the Job Description field, enter a description for the download job. This is mandatory.
Step 6
Enter the E-mail ID in the E-mail field.
Step 7
Click Apply.
Step 8
Click Accept in the confirmation popup dialog box, to put your settings into effect.
To exit without making changes, click Cancel.
Using the Software Center CLI Utility
Common Services provides a command line utility that supports most of the Software Center features.
The utility is available at NMSROOT/bin/, as:
•
PSUCli.bat (on Windows)
•
PSUCli.sh (on Solaris)
The utility helps you do the following:
•
Download Software Updates
•
Download Device Package Updates
•
Install Device Packages
•
Uninstall Device packages
•
Query Updates on the CiscoWorks Server
To install new device packages from Cisco.com, you have to first download the packages from Cisco.com, save them to a directory in your computer, and then install them, specifying the directory.
To get help on command usage, enter:
NMSROOT\bin\PSUCli.bat -h (On Windows)
NMSROOT/bin/PSUCli.sh -h (On Solaris)
This lists the commands, options, and valid product names.
Querying Updates on the CiscoWorks Server
To get a list of installed packages, enter:
NMSROOT\bin\PSUCli.bat -p product -q [-src dir] {-all |PackageNames} (On Windows)
NMSROOT/bin/PSUCli.sh -p product -q [-src dir] {-all |PackageNames} (On Solaris)
You have use either the -all option or specify the PackageName.
•
-product (-p)—Product for which packages are to be downloaded. This must be short names of the products. Invoking the CLI utility with -h option lists the valid product names.
•
-query(-q)—Lists the packages (default source location is installed repository of the product).
•
-all—Selects all packages available at the source location.
•
-src <dir>—source location of the packages
Example:
NMSROOT/bin/PSUCli.bat -p rme -q -all
This lists all the installed packages for RME in the installed repository for RME.
To list all packages in the specified directory for RME, enter:
NMSROOT\bin\PSUCli.bat -p rme -src dir -q
Installing Device Packages
To install device packages from the directory you specify, enter:
NMSROOT\bin\PSUCli.bat -p product -install -src dir {-all |PackageNames} (On Windows)
NMSROOT/bin/PSUCli.sh -p product -install -src dir {-all |PackageNames} (On Solaris)
You have use either the -all option or specify the PackageName.
•
-product (-p)—Product for which packages are to be downloaded. This must be short names of the products. Invoking the CLI utility with -h option lists the valid product names.
•
-install (-i)—Installs packages (from user specified directory).
•
-src <dir>—Source location of the packages.
•
-all—Selects all packages available at the source location.
•
PackageNames—Names of the device packages, for example Cat5000, Cat6000, AS5850.
Example:
NMSROOT\bin\PSUCli.bat -p rme -i -src dir Cat6000 Cat4000
This installs the specified packages (Cat6000, Cat4000) for RME, from the specified directory.
Uninstalling Device Packages
To uninstall device packages, enter:
NMSROOT\bin\PSUCli.bat -p product -uninstall {-all|PackageNames}(On Windows)
NMSROOT/bin/PSUCli.sh -p product -uninstall {-all|PackageNames}(On Solaris)
You have use either the -all option or specify the PackageName.
•
-product (-p)—Product for which packages are to be downloaded. This must be short names of the products. Invoking the CLI utility with -h option lists the valid product names.
•
-uninstall (-u)—Uninstalls packages.
•
-all—Selects all installed packages.
•
PackageNames—Names of the device packages, for example Cat5000, Cat6000, AS5850.
Example:
NMSROOT\bin\PSUCli.bat -p rme -u -all
This uninstalls all packages of RME, from the installed repository.
Downloading Device Packages
To download device packages, enter:
NMSROOT\bin\PSUCli.bat -p product -download -dst dir (On Windows)
NMSROOT/bin/PSUCli.sh -p product -download -dst dir (On Solaris)
•
-product (-p)—Product for which packages are to be downloaded. This must be short names of the products. Invoking the CLI utility with -h option lists the valid product names.
•
-download (-s)—Downloads all device packages.
•
-dst <dir>—Directory for downloading.
Example:
NMSROOT\bin\PSUCli.bat -p rme -d -dst dir
This downloads all device packages for RME, to the specified directory.
Downloading Software Packages
To download software updates, enter:
NMSROOT\bin\PSUCli.bat -p product -software -dst dir (On Windows)
NMSROOT/bin/PSUCli.sh -p product -software -dst dir (On Solaris)
•
-product (-p)—Product for which packages are to be downloaded. This must be short names of the products. Invoking the CLI utility with -h option lists the valid product names.
•
-software (-s)—Downloads all device packages.
•
-dst <dir>—Directory for downloading.
Example:
NMSROOT\bin\PSUCli.bat -p rme -s -dst dir
This downloads all software packages for RME, to the specified directory.
Viewing Activity Logs
Activity Log logs the jobs in Scheduled Downloads and Device Updates. It displays the activities that are carried out using Software Center.
In the CiscoWorks Homepage, select Common Services > Software Center > Activity Log.
The Activity Log page displays:
•
Scheduled Job Details—Displays the details of scheduled jobs in the software center.
•
Event Log—Displays the logs of events in the software center.
To view Scheduled Job Details, click Scheduled Job Details in the TOC.
The Scheduled Job Details page appears with the following information:
•
Job—Job ID.
•
Date—Time and the date on which the job was executed.
•
Applicable Products—Products to which the download is applicable.
To view the Event Log, click Event Log in the TOC. The Event Log page appears with the following information:
•
Product Name—Name of the product.
•
Description—Summary of the activity.
•
Date—Date and time when the operations were carried out.
•
Event Type—Shows one of the following:
–
Device Package Downloads
–
Software Download
–
Install Device Packages / Uninstall Device Packages
•
Status—Status of the event (Completed Successfully, Failed or executed).