User Guide for CiscoWorks Common Services 3.1 - Working With Software Center [CiscoWorks Common Services Software]

Table Of Contents

Working With Software Center

Performing Software Updates

Viewing the List of Installed Applications and Packages

Selecting Software Updates

Downloading Software Updates

Performing Device Update

Checking for Updates

Deleting Packages

Scheduling Device Package Downloads

Viewing Activity Logs

Scheduled Job

Event Log

Using the Software Center CLI Utility

Querying Updates on the CiscoWorks Server

Installing Device Packages

Uninstalling Device Packages

Downloading Software Updates

Downloading Device Updates

Listing Dependent Device Packages

Listing Device Packages Version

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.

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.

This chapter explains the following:

•Performing Software Updates

•Performing Device Update

•Scheduling Device Package Downloads

•Viewing Activity Logs

•Using the Software Center CLI Utility

Performing Software Updates

You can view a list of all CiscoWorks related bundles and products currently installed on your system using this option. For software updates the default site is Cisco.com.

The Software Updates link under Software Center takes you to the Software Updates page. 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. See

You can navigate further down for each product to get a detailed list of all individual OS level packages installed on the system, along with the versions.

The Software Updates page provides two options:

•Select Software Updates

•Download Software Updates

This section contains the following:

•Viewing the List of Installed Applications and Packages

•Selecting Software Updates

•Downloading Software Updates

Viewing the List of Installed Applications and Packages

You can view the information on all the applications, patches, and packages installed for a selected product.

To do so:

Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Software Updates.

The Software Updates page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

Step 2 Go to the Products Installed dialog box and click the link provided on a product.

A new window displays the details of:

•Patches Installed—Provides details about the patches installed on the product, the patch version and the date on which the patches were installed.

•Application Installed—Provides details of the applications installed, the application version, and the date on which the applications were installed.

•Packages Installed—Provides details about the packages installed on the product, the package version with patch level, and the date on which the packages were installed.

Selecting Software Updates

You can select new software packages to update the applications or products.To select updates from Software Center:

Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Software Updates.

The Software Updates page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

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 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.

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.

You can filter the required images based on Type, Package Name, Product Name, and Available Version With Patch Level. To filter the images, choose the filter source from the drop-down list and specify the filter pattern in the text box.

For example, If you select the Filter Source as Package Name and Pattern as cmfSw001, all packages with name starting as cmfSw001 will be listed.

Regular expressions are not supported for the patterns. Patterns are case sensitive.
For example, if the list of available packages are CatGL3, Cat4000, Cat3560, Pix, cigesm, and CAT2900XL, then a filter pattern Cat will list the CatGL3, Cat4000 and Cat3560 packages:

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.

Downloading Software Updates

You can download the selected updates from Software Center.

To download updates from Software Center:

Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Software Updates.

The Software Updates page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

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

You can view a list of all CiscoWorks related devices packages on your system using this option. It displays a count of devices supported for each product installed in the system. For device updates the source location could be Cisco.com or the Server Side Directory.

The Device Updates link under Software Center takes you to the Device Updates page. The Device Update page lists the product name and the device type count.

The default summary screen shows the number of devices supported for each product installed in the system. You can view a package map and a device map for each product installed.

You can also check for the device updates and delete the device packages using the Device Update page.

This section contains the following:

•Checking for Updates

•Deleting Packages

Viewing Package Map

A 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.

To view a package map for an installed product, click the product name link. A popup window appears with the information on the packages installed. The package name, version, and description are displayed.

You can filter the device packages based on Package Name and Version. To filter the packages, choose the filter source from the drop-down list and specify the filter pattern in the text box.

For example, if you specify the Filter Source as Package Name and Pattern as Cat, all package names starting with Cat will be listed.

A package name identifies the device package. For example, the package name AP350 represents Cisco Aironet 350 Device Package. You have to use package name while specifying the download policy, and while performing other Software Center operations where you have to specify the package name.

Viewing Device Map

To view a device map for an installed product, click the device type count link. A pop-up window appears with the information on the devices installed. The device map lists the sysObjectID, Device Name, Package Name, and Version.

You can filter the packages based on sysObjectID, DeviceName, Package Name, and Version. To filter the packages, choose the filter source from the drop-down list and specify the filter pattern in the text box.

For example, if you specify the Filter Source as sysObjectID and pattern as 1.3.6.1.4.1.9, details of all devices with SysobjectID starting with 1.3.6.1.4.1.9 will be listed.

Checking for Updates

You can check for updates using this option. To check for the updates:

Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Device Update.

The Device Updates page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

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, if you have selected to check for updates at Cisco.com.

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 an e-mail ID in the E-mail field.

You can enter multiple e-mail addresses separated by comma.

e. Click Next.

The Summary window displays the details.

f. Click Finish to confirm.

If you select Install Device Packages:

a. Click Next.

The Summary window displays the details.

b. Click Finish to confirm.

A message that the daemons are restarted, appears.

Step 7 Click OK to continue.

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 home page and select Common Services > Software Center > Device Updates.

The Device Update page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

Step 2 Select the check box corresponding to the product and 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.

You can filter the available device packages based on Package Name, Product Name, Installed Version. To filter the packages, choose the filter source from the drop-down list and specify the filter pattern in the text box.

For example, If you select the Filter Source as Package Name and Pattern as cmfSw001, all packages with name starting as cmfSw001 will be listed.

Regular expressions are not supported for the patterns. Patterns are case sensitive.

For example, if the list of available packages are CatGL3, Cat4000, Cat3560, Pix, cigesm, and CAT2900XL, then a filter pattern Cat will list the CatGL3, Cat4000 and Cat3560 packages:

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.

If you want make changes in the previous windows, click Back.

To cancel the operation, click Cancel.

After you have confirmed the Delete Packages operation, a message that the daemons are restarted appears.

Step 6 Click OK to continue.

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 device package downloads:

Step 1 Select Common Services > Software Center > Schedule Device Downloads.

The Schedule Device Downloads dialog box appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

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 an e-mail ID in the E-mail field.

You can enter multiple e-mail addresses separated by comma.

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.

You can view the scheduled job status and details from the Job Browser window. See Managing Jobs for more information.

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 home page, select Common Services > Software Center > Activity Log.

The Activity Log page displays:

•Scheduled Job —Displays the details of scheduled jobs in the software center.

•Event Log—Displays the logs of events in the software center.

Scheduled Job

The Scheduled Job page displays the activities that are performed using Software Center. The Scheduled Job table records and displays the downloads to the server. You can view the log from the server or any client workstation.

To view Scheduled Job Details:

Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Activity Log.

The Activity Log page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

Step 2 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 run.

•Applicable Products—Products to which the download is applicable.

You can delete the information on a job from the list. To delete a job, select a job from the list, then click Delete.

Event Log

The Event log page displays the activities that are performed using Software Center. The Event Log table shows the list of immediate downloads, installations and un-installations of device packages carried out. You can view the log from the server or any client workstation.

To view the Event Log:

Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Activity Log.

The Activity Log page appears.

If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page.

Step 2 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.

You can delete either all the event logs or specific event logs from the list.

Select the log entries and click Delete to delete the selected entries.

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.

•List Dependent Device Packages.

•List Device Packages Version.

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 explains the following:

•Querying Updates on the CiscoWorks Server

•Installing Device Packages

•Uninstalling Device Packages

•Downloading Software Updates

•Downloading Device Updates

•Listing Dependent Device Packages

•Listing Device Packages Version

Querying Updates on the CiscoWorks Server

To get a list of installed packages, enter:

NMSROOT\bin\PSUCli.bat -p product -query [-src dir] {-all |PackageNames} (On Windows)

NMSROOT/bin/PSUCli.sh -p product -query [-src dir] {-all |PackageNames} (On Solaris)

You have to 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 the -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 -src dir {-all |PackageNames}[-noprompt] (On Windows)

NMSROOT/bin/PSUCli.sh -p product -install -src dir {-all |PackageNames} [-noprompt] (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 the -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

•-noprompt—Flag to turn off the prompt that appears to restart the daemon services during device packages installation

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} [-noprompt] (On Windows)

NMSROOT/bin/PSUCli.sh -p product -uninstall {-all |PackageNames} [-noprompt](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 (-u) —Uninstalls packages (from user specified directory).

•-all—Selects all packages available at the source location.

•PackageNames—Names of the device packages, for example Cat5000, Cat6000, AS5850

•-noprompt—Flag to turn off the prompt that appears to restart the daemon services during device packages installation

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.

Listing Dependent Device Packages

To list the dependent packages of one or more device packages, or all device packages, enter:

NMSROOT\bin\PSUCli.bat -p product -pkgDependents -src dir {-all |PackageNames} (On Windows)

NMSROOT/bin/PSUCli.sh -p product -pkgDependents -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.

•-pkgDependents (-pdep)—List the base or dependent packages for the specified packages present in the source location.

•-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 -pdep Cat5000

This lists all dependent packages of RME Cat5000 device package installed.

Listing Device Packages Version

To list the versions of one or more device packages, or all device packages, enter:

NMSROOT\bin\PSUCli.bat -p product -pkgVersion -src dir {-all |PackageNames} (On Windows)

NMSROOT/bin/PSUCli.sh -p product -pkgVersion -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.

•-pkgVersion (-pver)—List theversions of all or specified packages present in the source location.

•-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 -pdep Cat5000

This lists the version of RME Cat5000 device package installed.

	User Guide for CiscoWorks Common Services 3.1
	Working With Software Center
User Guide for CiscoWorks Common Services 3.1 Open Source License Acknowledgements Preface Overview of Common Services Interacting With CiscoWorks Home Page Using Common Services Home Configuring the Server Managing Device and Credentials Administering Groups Using LMS Setup Center Using Device Center Working With Software Center Diagnosing Problems With CiscoWorks Server Understanding CiscoWorks Security Acronyms Used in Common Services Documentation Index	Download this chapter Working With Software Center Download the complete book cs31ug.pdf (PDF - 5 MB) Table Of Contents Working With Software Center Performing Software Updates Viewing the List of Installed Applications and Packages Selecting Software Updates Downloading Software Updates Performing Device Update Checking for Updates Deleting Packages Scheduling Device Package Downloads Viewing Activity Logs Scheduled Job Event Log Using the Software Center CLI Utility Querying Updates on the CiscoWorks Server Installing Device Packages Uninstalling Device Packages Downloading Software Updates Downloading Device Updates Listing Dependent Device Packages Listing Device Packages Version 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. 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. This chapter explains the following: •Performing Software Updates •Performing Device Update •Scheduling Device Package Downloads •Viewing Activity Logs •Using the Software Center CLI Utility Performing Software Updates You can view a list of all CiscoWorks related bundles and products currently installed on your system using this option. For software updates the default site is Cisco.com. The Software Updates link under Software Center takes you to the Software Updates page. 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. See You can navigate further down for each product to get a detailed list of all individual OS level packages installed on the system, along with the versions. The Software Updates page provides two options: •Select Software Updates •Download Software Updates This section contains the following: •Viewing the List of Installed Applications and Packages •Selecting Software Updates •Downloading Software Updates Viewing the List of Installed Applications and Packages You can view the information on all the applications, patches, and packages installed for a selected product. To do so: Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Software Updates. The Software Updates page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. Step 2 Go to the Products Installed dialog box and click the link provided on a product. A new window displays the details of: •Patches Installed—Provides details about the patches installed on the product, the patch version and the date on which the patches were installed. •Application Installed—Provides details of the applications installed, the application version, and the date on which the applications were installed. •Packages Installed—Provides details about the packages installed on the product, the package version with patch level, and the date on which the packages were installed. Selecting Software Updates You can select new software packages to update the applications or products.To select updates from Software Center: Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Software Updates. The Software Updates page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. 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 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. 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. You can filter the required images based on Type, Package Name, Product Name, and Available Version With Patch Level. To filter the images, choose the filter source from the drop-down list and specify the filter pattern in the text box. For example, If you select the Filter Source as Package Name and Pattern as cmfSw001, all packages with name starting as cmfSw001 will be listed. Regular expressions are not supported for the patterns. Patterns are case sensitive. For example, if the list of available packages are CatGL3, Cat4000, Cat3560, Pix, cigesm, and CAT2900XL, then a filter pattern Cat will list the CatGL3, Cat4000 and Cat3560 packages: 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. Downloading Software Updates You can download the selected updates from Software Center. To download updates from Software Center: Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Software Updates. The Software Updates page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. 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 You can view a list of all CiscoWorks related devices packages on your system using this option. It displays a count of devices supported for each product installed in the system. For device updates the source location could be Cisco.com or the Server Side Directory. The Device Updates link under Software Center takes you to the Device Updates page. The Device Update page lists the product name and the device type count. The default summary screen shows the number of devices supported for each product installed in the system. You can view a package map and a device map for each product installed. You can also check for the device updates and delete the device packages using the Device Update page. This section contains the following: •Checking for Updates •Deleting Packages Viewing Package Map A 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. To view a package map for an installed product, click the product name link. A popup window appears with the information on the packages installed. The package name, version, and description are displayed. You can filter the device packages based on Package Name and Version. To filter the packages, choose the filter source from the drop-down list and specify the filter pattern in the text box. For example, if you specify the Filter Source as Package Name and Pattern as Cat, all package names starting with Cat will be listed. A package name identifies the device package. For example, the package name AP350 represents Cisco Aironet 350 Device Package. You have to use package name while specifying the download policy, and while performing other Software Center operations where you have to specify the package name. Viewing Device Map To view a device map for an installed product, click the device type count link. A pop-up window appears with the information on the devices installed. The device map lists the sysObjectID, Device Name, Package Name, and Version. You can filter the packages based on sysObjectID, DeviceName, Package Name, and Version. To filter the packages, choose the filter source from the drop-down list and specify the filter pattern in the text box. For example, if you specify the Filter Source as sysObjectID and pattern as 1.3.6.1.4.1.9, details of all devices with SysobjectID starting with 1.3.6.1.4.1.9 will be listed. Checking for Updates You can check for updates using this option. To check for the updates: Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Device Update. The Device Updates page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. 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, if you have selected to check for updates at Cisco.com. 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 an e-mail ID in the E-mail field. You can enter multiple e-mail addresses separated by comma. e. Click Next. The Summary window displays the details. f. Click Finish to confirm. If you select Install Device Packages: a. Click Next. The Summary window displays the details. b. Click Finish to confirm. A message that the daemons are restarted, appears. Step 7 Click OK to continue. 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 home page and select Common Services > Software Center > Device Updates. The Device Update page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. Step 2 Select the check box corresponding to the product and 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. You can filter the available device packages based on Package Name, Product Name, Installed Version. To filter the packages, choose the filter source from the drop-down list and specify the filter pattern in the text box. For example, If you select the Filter Source as Package Name and Pattern as cmfSw001, all packages with name starting as cmfSw001 will be listed. Regular expressions are not supported for the patterns. Patterns are case sensitive. For example, if the list of available packages are CatGL3, Cat4000, Cat3560, Pix, cigesm, and CAT2900XL, then a filter pattern Cat will list the CatGL3, Cat4000 and Cat3560 packages: 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. If you want make changes in the previous windows, click Back. To cancel the operation, click Cancel. After you have confirmed the Delete Packages operation, a message that the daemons are restarted appears. Step 6 Click OK to continue. 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 device package downloads: Step 1 Select Common Services > Software Center > Schedule Device Downloads. The Schedule Device Downloads dialog box appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. 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 an e-mail ID in the E-mail field. You can enter multiple e-mail addresses separated by comma. 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. You can view the scheduled job status and details from the Job Browser window. See Managing Jobs for more information. 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 home page, select Common Services > Software Center > Activity Log. The Activity Log page displays: •Scheduled Job —Displays the details of scheduled jobs in the software center. •Event Log—Displays the logs of events in the software center. Scheduled Job The Scheduled Job page displays the activities that are performed using Software Center. The Scheduled Job table records and displays the downloads to the server. You can view the log from the server or any client workstation. To view Scheduled Job Details: Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Activity Log. The Activity Log page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. Step 2 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 run. •Applicable Products—Products to which the download is applicable. You can delete the information on a job from the list. To delete a job, select a job from the list, then click Delete. Event Log The Event log page displays the activities that are performed using Software Center. The Event Log table shows the list of immediate downloads, installations and un-installations of device packages carried out. You can view the log from the server or any client workstation. To view the Event Log: Step 1 Go to the CiscoWorks home page and select Common Services > Software Center > Activity Log. The Activity Log page appears. If LMS Portal is installed on the CiscoWorks Server, you can also navigate to this page from the LMS Portal home page. Step 2 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. You can delete either all the event logs or specific event logs from the list. Select the log entries and click Delete to delete the selected entries. 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. •List Dependent Device Packages. •List Device Packages Version. 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 explains the following: •Querying Updates on the CiscoWorks Server •Installing Device Packages •Uninstalling Device Packages •Downloading Software Updates •Downloading Device Updates •Listing Dependent Device Packages •Listing Device Packages Version Querying Updates on the CiscoWorks Server To get a list of installed packages, enter: NMSROOT\bin\PSUCli.bat -p product -query `[`-src dir] {-all \|PackageNames} (On Windows) NMSROOT/bin/PSUCli.sh -p product -query `[`-src dir] {-all `\|`PackageNames} (On Solaris) You have to 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 the -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 -src dir {-all \|PackageNames}[-noprompt] (On Windows) NMSROOT/bin/PSUCli.sh -p product -install -src dir {-all `\|`PackageNames} [-noprompt] (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 the -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 •-noprompt—Flag to turn off the prompt that appears to restart the daemon services during device packages installation 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} `[`-noprompt] (On Windows) NMSROOT/bin/PSUCli.sh -p product -uninstall `{`-all `\|`PackageNames} [-noprompt](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 (-u) —Uninstalls packages (from user specified directory). •-all—Selects all packages available at the source location. •PackageNames—Names of the device packages, for example Cat5000, Cat6000, AS5850 •-noprompt—Flag to turn off the prompt that appears to restart the daemon services during device packages installation 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. Listing Dependent Device Packages To list the dependent packages of one or more device packages, or all device packages, enter: NMSROOT\bin\PSUCli.bat -p product -pkgDependents -src dir {-all \|PackageNames} (On Windows) NMSROOT/bin/PSUCli.sh -p product -pkgDependents -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. •-pkgDependents (-pdep)—List the base or dependent packages for the specified packages present in the source location. •-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 -pdep Cat5000 This lists all dependent packages of RME Cat5000 device package installed. Listing Device Packages Version To list the versions of one or more device packages, or all device packages, enter: NMSROOT\bin\PSUCli.bat -p product -pkgVersion -src dir {-all \|PackageNames} (On Windows) NMSROOT/bin/PSUCli.sh -p product -pkgVersion -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. •-pkgVersion (-pver)—List theversions of all or specified packages present in the source location. •-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 -pdep Cat5000 This lists the version of RME Cat5000 device package installed.
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.