Usage Notes for the CiscoWorks NCM 1.3 End of Sale/End of Life Report Tool

These usage notes provide information on using the End of Sale/End of Life Report tool that is available with Cisco Network Compliance Manager (NCM), Release 1.3. You can use the End of Sale/End of Life Report tool to ascertain the End of Sale or End of Life details that impact the devices and modules in your network.

The End of Sale/End of Life Report tool retrieves information about the impacted devices and modules in your network, and then generates an End of Sale/End of Life report that lists the devices that have reached their End of Sale or End of Life date. You can tell at a glance the status of a device: End of Sale information appears in yellow and End of life information appears in red.

The End of Sale information for a device refers to announcements made in Cisco.com regarding the ending of sales of a device or hardware.

The End of Life information refers to announcements made in Cisco.com regarding the ending of service and support of a device or hardware.

Starting the End of Sale/End of Life Report Tool

You can generate End of Sale/End of Life reports in either HTML or Comma Separated Values (CSV) format.

Note You can not generate an End of Sale/End of Life report in both HTML and CSV formats at the same time.

You can also generate End of Sale/End of Life reports using the Cisco IOS Command Line Interface (CLI). To use generate a report using the CLI, navigate to <install_dir>\addins\cisco\eox and then run the appropriate script with desired command options. For example:

•

For Windows enter: EoxReportGenerator.bat -u admin-p admin -cu catos -cp catpass

•

For Solaris and Linux enter:EoxReportGenerator.sh -u admin-p admin -cu catos -cp catpass

Step 2

Navigate Tasks > New Task > Run External Application. The New Task-Run External Application window is displayed.

Step 3

Enter the optional Task Name and Start Date. Include comments in the Comments field, if desired.

Step 4

In the Run field, enter the appropriate script for the End of Sale/End of Life Report tool that is appropriate for the platform on which CiscoWorks NCM is running:

Step 5

Enter any desired command options after the script in the Run field. For example:

–

For Windows—<install_dir>\addins\cisco\eox\EoxReportGenerator.bat -u admin-p admin -cu catos -cp catpass

–

For Solaris and Linux—<install_dir>\addins\cisco\eox\EoxReportGenerator.sh -u admin-p admin -cu catos -cp catpass

See Table 1for a complete listing of the End of Sale/End of Life Report Command Options.

Step 6

In the Start in field, enter the path to the directory where the script resides:

The End of Sale/End of Life report in either HTML or CSV format is saved under <install_dir>/addins/cisco/eox/reports/<username>/eoxReport.<html/csv>.

End of Sale/End of Life Report Command Options

You can use the End of Sale/End of Life Report Command Options to generate a report that meets your needs.

Table 1 End of Sale/End of Life Report Command Options
Option Name	Short Form	Long Form	Argument Name	Optional	Dependency	Description
CWNCM Username	-u	cwncmUsername	username	No		Username used to log in to CiscoWorks NCM.
CWNCM Password	-p	cwncmPassword	password	No		Password used to log in to CiscoWorks NCM.
Cisco.com Username	-cu	ciscoComUsername	username	No		Username used to log in to http://www.cisco.com.
Cisco.com Password	-cp	ciscoComPassword	password	No		Password used to log in to http://www.cisco.com.
Proxy Server IPAddress	-psi	proxyServer	ipaddress	Yes		Proxy Server IP Address to connect to external web-sites, such as http://www.cisco.com.
Proxy Server Username	-pu	proxyServerUsername	username	Yes		Username to connect to Proxy Server.
Proxy Server Password	-pp	proxyServerPassword	password	Yes		Password to authenticate with the Proxy Server.
Proxy Server IPAddress	-psp	proxyPort	port no.	Yes		Proxy Server Port.
Sort Report by IPAddress	-s	sortIPAddress		Yes		Sort report by IPAddress. Default: Sort by Device Name.
CSV Report format	-csv	csvReport	filename	Yes		Create report in CSV format. You can optionally give the CSV filename. Default: Create report in HTML format.
Email report	-e	emailTo	emailTo	Yes		Send email to the given email address.
Attach report in the email	-a			Yes	-e and -csv	Attach the report in the email. Option available only for CSV format reports. (-csv).
Display Help	-h			N/A		Display the command help.
Encrypted password	-encrypt			Yes	-p , -cp , and -pp	All passwords given are encrypted. NOTE: all the passwords are considered encrypted. (-p , -cp, -pp)

Step 1

Change to client directory under RENDITION_HOME($CWNCM_HOME/client).

$CWNCM_HOME/jre/bin/java -cp truecontrol- client.jar com.rendition.tools.ConnectorTool -encrypt xxxxxxx

The following example on a Windows platform shows how to encrypt the rendition password:

c:/$CWNCM_HOME/jre/bin/java -cp truecontrol-client.jar com.rendition.tools.ConnectorTool -encrypt $CWNCM_HOME

The string $CWNCM_HOME is encrypted in single quotation marks. For example, 'K2IGjPQjw6/k3 tKNW9KFLg=='

Sample Output from the End of Sale/End of Life Report Tool

The following is a sample of the output from running the End of Sale/End of Life Report tool. See Figure 1. You can tell at a glance the status of a device: End of Sale information appears in yellow and End of life information appears in red.

The generated End of Sale/End of Life Report tool output contains the following:

•

Total Cisco Devices—The total number of Cisco devices managed by CiscoWorks NCM.

•

Affected Devices Table—Contains information on devices with End of Sale/End of Life announcements. This information is based on the number of devices, with each device counted only once.

•

Affected Modules Table —Contains information on modules with End of Sale/End of Life announcements.

•

Affected Device Inventory Table—Contains information on each device and module with End of Sale/End of Life announcements. A single device can contain multiple modules, some of which might impacted by End of Sale/End of Life announcements.

For information regarding the fields in the End of Sale/End of Life report tables, see the following section.

Fields in the End of Sale/End of Life Report Tables

Table 2 provides descriptions for the fields in the End of Sales / End of Life report Affected Devices table.

Table 2 Affected Devices Table Fields
Field	Description
Bulletin Number	Bulletin number of End of Sale / End of Life Announcement for a device in Cisco.com. Click on the bulletin number link for more information of End of Sale / End of Life Announcement for that device in Cisco.com. There maybe multiple announcements for a device. The same bulletin can apply to multiple devices.
Device Model	Model of the device. For instance, the device model can be Cisco Catalyst 4507R Switch.
Device Count	The number of affected devices.
EOS Date	Last date to order the product through Cisco point-of-sale mechanisms. The product is no longer for sale after this date.
EOL Date	Last date to receive service and support for the product. After this date, all support services for the product are unavailable, and the product becomes obsolete.
Notes	Displays important information about the affected device.

Table 3 provides descriptions for the fields in the End of Sales / End of Life report Affected Modules table.

Table 3 Affected Modules Table Fields
Field	Description
Bulletin Number	Bulletin number of End of Sale / End of Life Announcement for a module in Cisco.com. Click on the bulletin number link for more information of End of Sale / End of Life Announcement for that module in Cisco.com. There maybe multiple announcements for a module.The same bulletin can apply to multiple modules.
Module Type	Module type information consisting of the End of Sale product part number.
Module Count	The number of affected modules.
EOS Date	Last date to order the product through Cisco point-of-sale mechanisms. The product is no longer for sale after this date.
EOL Date	Last date to receive service and support for the product. After this date, all support services for the product are unavailable, and the product becomes obsolete.
Notes	Displays important information about the affected module.

Table 4 provides descriptions for the fields in the End of Sales / End of Life report Affected Device Inventory table.

Table 4 Affected Device Inventory Table Fields
Field	Description
Device Name	Name of the device. Click on the device name for more information about the device.
IP Address	IP address of the device.
Device Model	Model of the device. For example, Cisco Catalyst 6513 Switch.
Module Type	Type of the module.
Module Model	Model of the module.
Location	Physical location of the devices on the network.
Bulletin Number	Bulletin number of End of Sale / End of Life Announcement for a module in Cisco.com. Click on the bulletin number link for more information of End of Sale / End of Life Announcement for that module in Cisco.com. There maybe multiple announcements for a module.The same bulletin can apply to multiple modules.

Table Of Contents