Table Of Contents
Working With Software Center
Performing Software Updates
Performing Device Update
Deleting Packages
Scheduling Device Package Downloads
Viewing Activity Logs
Using the Software Center CLI Utility
Querying Updates on the CiscoWorks Server
Installing Device Packages
Uninstalling Device Packages
Downloading Software Updates
Downloading Device Updates
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, and command line interface, wherever possible.
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 command line utility.
For details, see Using the Software Center CLI Utility.
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 in the respective Readme files.
You may also uninstall a device support package. Software Center does not support installation and 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.
Performing Software Updates
The Software Updates link under Software Center takes you to the Software Updates page.
Enter your Cisco.com username and password to connect to Cisco.com, for software updates. If you have configured proxy settings under
Common Services > Server > Security > Cisco.com Connection Management > Proxy Server Setup, you must enter the Proxy server username and password.
The Software Updates 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 select updates and download updates.
To select updates from Software Center:
Step 1
Go to the CiscoWorks Homepage and select Common Services > Software Center > Software Updates.
The Software Updates page appears.
Step 2
Go to the Products Installed dialog box and select the check box corresponding to the product for which you want to select update.
You can select multiple products by selecting the corresponding checkboxes.
Step 3
Click Select Updates.
The Cisco.com and Proxy Server Credentials dialog box appears.
Step 4
Enter your Cisco.com username and password.
Both are mandatory if you have configured proxy settings under Common Services > Server > Security > Cisco.com Connection Management > Proxy Server Setup
Step 5
Click Next.
A list of available Software Updates for the selected product appears.
Step 6
Select the Software Update you need to download and click Next.
Step 7
Select a destination location or browse to the location and click Next.
The destination location should not be the location where CiscoWorks is installed or OS directories. Software Center does not support downloading device or software updates in the same directory where you have installed CiscoWorks Common Services, or any of its sub- directories.
By default, the destination location is:
•
/opt/psu_download (On Solaris)
•
System Drive:\psu_download (On Windows)
The Download Summary window appears.
Step 8
Click Finish to confirm download of the selected packages.
If you do not want to add the selected packages, click Back to reselect packages or click Cancel to exit.
You can download the selected updates from Software Center.
Enter your Cisco.com username and password to connect to Cisco.com, for software updates.
If you have configured proxy settings under Common Services > Server > Security > Cisco.com Connection Management > Proxy Server Setup, you must enter the Proxy server username and password.
To download updates from Software Center:
Step 1
Go to the CiscoWorks Homepage and select Common Services > Software Center > Software Updates.
The Software Updates page appears.
Step 2
Go to the Products Installed table and select the check box corresponding to the product for which you want to download the update.
You can select multiple products by selecting the corresponding checkboxes.
Step 3
Click Download Updates.
The Cisco.com and Proxy Server Credentials dialog box appears.
Step 4
Enter your Cisco.com username and password. Both are mandatory.
If you have configured proxy settings under Common Services > Server > Security >
Cisco.com Connection Management > Proxy Server Setup, you must enter Proxy server username and password.
Step 5
Select a destination location or browse to the location and click Next.
The destination location should not be the location where CiscoWorks is installed or OS directories. Software Center does not support downloading device or software updates in the same directory where you have installed CiscoWorks Common Services, or any of its sub- directories.
By default, the destination location is:
•
/opt/psu_download (On Solaris)
•
System Drive:\psu_download (On Windows)
Step 6
Click Finish to confirm the download operation.
To return to the Software Update page click Cancel .
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.
You have to enter your Cisco.com username and password to connect to Cisco.com.
If you have configured proxy settings under Common Services > Server > Security > Cisco.com Connection Management > Proxy Server Setup, you must enter the Proxy server username and password.
To check for the updates:
Step 1
Go to the CiscoWorks Homepage and select Common Services > Software Center > Device Update.
The Device Updates page appears.
Step 2
Select the check box corresponding to the product for which you want to check for updates and click Check for Updates.
The Source Location page appears. You can check for updates at Cisco.com or a server.
•
To check for updates at Cisco.com, select the Cisco.com radio button.
•
To check for updates from a server, select the Enter Server Path radio button and enter the path or browse to the location using the Browse tab.
Step 3
Click Next.
The Cisco.com and Proxy Server Credentials dialog box appears.
Step 4
Enter your Cisco.com username and password.
If you have configured proxy settings under Common Services > Server > Security >
Cisco.com Connection Management > Proxy Server Setup, you must enter Proxy server username and password.
Step 5
Click Next.
The Available Packages and Installed Packages page appears. It displays:
•
Package Name: Name of the package.
•
Type: Type of the update. For example, whether the update is a device package or IDU package.
•
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 6
Select the check box corresponding to the package that you wish to update and click Next.
The Device Update page appears. You can either install the device packages or download them.
•
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 destination directory.
By default, the destination location is:
–
/opt/psu_download (On Solaris)
–
System Drive:\psu_download (On Windows)
b.
Set the frequency of downloads, select the run type from the Run Type drop-down list. The options are:
–
Immediate
–
Once
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.
Enter a description for the download job in the Job Description field. 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 Finish.
A message that the daemons are restarted, appears.
Step 7
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
Go to the CiscoWorks Homepage and select Common Services > Software Center > Device Updates.
The Device Update page appears.
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 appears with 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.
If you have configured proxy settings under Common Services > Server >Security > Cisco.com Connection Management > Proxy Server Setup, you must enter the Proxy server username and password.
To schedule device package downloads:
Step 1
Select Common Services > Software Center > Schedule Device Downloads.
The Schedule Device Downloads dialog box appears.
Step 2
Enter your Cisco.com username and password.
Enter the Proxy server username and password only if you have configured proxy settings under Common Services > Server > Security > Cisco.com Connection Management > Proxy Server Setup.
Step 3
Click Next.
Step 4
Enter the destination location, or browse to the location using the Browse tab.
By default, the destination location is:
•
/opt/psu_download (On Solaris)
•
System Drive:\psu_download (On Windows)
Step 5
Specify the download policy you require.
•
To set the frequency of downloads, select the run type from the Run Type drop-down list.
•
To set the date and time, select the date from the drop-down calendar, and specify the time using the drop-down lists.
Step 6
Enter a description for the download job in the Job Description field. This is mandatory.
Step 7
Enter the E-mail ID in the E-mail field.
Step 8
Click Accept in the confirmation popup dialog box.
Or
Click Cancel to exit without making changes.
Note
You can schedule only one download at a time.
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). Click on the Status link to get more details on the operation.
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.
This section has the following sub sections:
•
Querying Updates on the CiscoWorks Server
•
Installing Device Packages
•
Uninstalling Device Packages
•
Downloading Software Updates
•
Downloading Device Updates
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 package names.
•
-p product —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
•
PackageNames—Names of the device packages, for example Cat5000, Cat6000, AS5850
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 {-all |PackageNames} (On Windows)
NMSROOT/bin/PSUCli.sh -p product -install {-all |PackageNames} (On Solaris)
You have use either the -all option or specify the package names.
•
-p product —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).
•
-all—Selects all packages available at the source location.
•
-src dir—source location of the packages
•
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 package names.
•
-p product —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 -i—Uninstalls packages (from user specified directory).
•
-all—Selects all packages available at the source location.
•
-src dir—source location of the 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 Software Updates
To download the Software Updates, enter:
NMSROOT\bin\PSUCli.bat -p product -software -dst download directory {-all |PackageNames} (On Windows)
NMSROOT/bin/PSUCli.bat -p product -software -dst download directory {-all |PackageNames} (On Solaris)
•
-p product—Specify the Product for which you want to download the Software Update. Invoking CLI with -h option lists the valid product names.
•
-software (-s) —Download Software packages for the specified product or products.
•
-dst download directory—Specify the directory to which you want to download the Software Update.
Do not specify the same directory where you have installed CiscoWorks Common Services, or any of the sub directories in it.
•
-all—Selects all the available software updates on Cisco.com for download.
•
PackageNames—Names of the software update package available on Cisco.com, for example, cwcs3_0_4_win.zip, cwcs3_0_6_sol_k9.zip.
You will be prompted to enter Cisco.com User Name and Password. If you have configured Proxy settings, you will be prompted for Proxy Server User credentials.
The destination location should not be the location where CiscoWorks is installed or OS directories. Software Center does not support downloading device or software updates in the same directory where you have installed CiscoWorks Common Services, or any of its sub- directories.
Downloading Device Updates
To download the Device Updates, enter:
NMSROOT\bin\PSUCli.bat -p product -download -dst download directory {-all |PackageNames} (On Windows).
NMSROOT/bin/PSUCli.sh -p product -download -dst download directory {-all |PackageNames} (On Solaris).
•
-p product—Specify the Product for which you want to download the Device Update. Invoking CLI with -h option lists the valid product names.
•
-download (-d)—Download Device packages for the specified product or products.
•
-dst download directory—Specify the directory to which you want to download the Device Update.
Do not specify the same directory where you have installed CiscoWorks Common Services, or any of the sub directories in it.
•
-all—Selects all the available device packages on Cisco.com for download.
•
PackageNames—Names of the device packages, for example Cat5000, Cat6000, AS5850.
You will be prompted to enter Cisco.com User Name and Password. If you have configured Proxy settings, you will be prompted for Proxy Server User credentials.
The destination location should not be the location where CiscoWorks is installed or OS directories. Software Center does not support downloading device or software updates in the same directory where you have installed CiscoWorks Common Services, or any of its sub- directories.