|
|
New device support can be added to CiscoView incrementally any time after the initial installation of CiscoView. To add incremental device support, go to Cisco Connection Online (CCO). CCO is the Cisco Systems online support channel.
If you do not have Internet access, you can skip this chapter. To receive updated packages, you can order the Cisco Network Management Support CD-ROM. The support CD contains the latest Cisco network management device and application support files. These files are organized into product packages and provide up-to-date management support for the latest Cisco devices for all supported platforms. For ordering information, see your product catalog.
A quick reference version of the instructions in this chapter appears in the CD installation booklet that accompanied the software CD. You can use the booklet if you are familiar with the process of downloading device packages from CCO to the CiscoView platform.
This chapter describes the download process in greater detail than the quick reference and includes the following sections:
CiscoView device support on CCO consists of packages that are bundles containing application upgrades, graphics, device descriptions, Management Information Base (MIB) files and other supporting files. Each package has a README file that goes with it. The README file should be read prior to downloading to ensure that the file works with your current configuration. After you add the package file to CiscoView, you can view and manage the hardware device using CiscoView.
There are many device packages bundled in CiscoView. Device packages are upgraded frequently. To ensure that you have the most recent upgrade, verify the version number through CCO. Always check for updated device packages on CCO and make sure that you have the latest device package. The CCO directory contains the latest device code, a README file, and the help code for the device. CCO is updated dynamically as changes occur.
| Caution Ensure that for new device or application support, you select CiscoView 4.0 or CiscoView 4.1 release packages. You can use existing CiscoView 3.1.1 packages, but they do not support new CiscoView 4.0 features such as stackable device functionality, which are available only with CiscoView 4.0 and later versions. |
From the Internet there are two ways to access Cisco device package files: from CCO or from the anonymous FTP service. This section describes how to download from CCO incrementally released device package files for use with CiscoView.
Before adding the Cisco device package file to CiscoView, make sure of the following:
The following is an overview of the steps necessary for downloading a device file from CCO. Details about these steps are in the sections that follow.
Follow these steps to check the version of CiscoView and device packages:
Step 1 From any directory on your workstation, open CiscoView by entering the CiscoView install directory path and nmcview.
Step 2 Select Help>About CiscoView. Make sure the version number is 4.0 or later.
To check packages, select Help>About CiscoView, click Packages. After you have verified the package version, compare it with the CCO version to ensure you have the latest upgrade.
Step 3 Proceed to the next section, "Close CiscoView."
| Caution Closing CiscoView is important! The device package does not install correctly if CiscoView is running during the installation. |
To close CiscoView, select File>Exit from the CiscoView Main window.
Before you download device packages from CCO, create a cv_pkgs directory as a destination directory for the device files. We suggest you download these files to a permanent location, or you can copy them to the CiscoView install directory.
Step 1 Change to the directory containing the CiscoView application files, for example:
cd /usr/nms
This guide refers to this directory as install_directory.
Step 2 Create a cv_pkgs directory.
mkdir /usr/nms/cv_pkgs
This creates the directory cv_pkgs for storing your package files.
Step 3 Change to the cv_pkgs directory.
cd /usr/nms/cv_pkgs
Use a Web browser to access CCO and review the README file to ensure you have the right file. Depending on the type of network access you have, you can log in as either of the following:
Guest users are limited to seeing only files available to the public, such as Cisco Management Information Base (MIB) files. Operating system software such as Cisco IOS releases generally are not available to guest users. To download these types of files, you must be granted special file access.
Log in as either a guest or registered user as described in the next sections.
If you are not registered on CCO, you can be granted a special access code to access the device file. Follow these steps to log in as a guest and download the device file:
Step 1 To get a special access code, contact the Cisco Technical Assistance Center (TAC):
For customers outside the US, you can call the 408 526-7209 number or get contact information at the following URL:
http://www.cisco.com/warp/public/687/Directory/DirTAC.html
When you call, select the telephone menu option for Technical Support. TAC is part of Technical Support.
State the product you are downloading and you are transferred to the appropriate person to obtain your special access code.
You can also send email to tac@cisco.com. Ask for a special access code for downloading the device file.
Step 2 From a Web browser, access CCO by entering the following URL:
http://www.cisco.com/public/sw-center/spc_req.shtml
Step 3 Enter your special access code at the prompt.
Step 4 Click Execute to pass the security warning message. The Execute button is located at the top of the page.
Step 5 Select the device tar file by clicking the button to the left of the device file you want to download.
The device file contains the package file (*.pkg) and associated README file.
Step 6 Click Execute.
Step 7 Follow the instructions on the screen to confirm the transfer. Select the server nearest you.
Step 8 Depending on your browser, click Save File, or select File>Save As. You might be prompted to save the file to your workstation, with a message "Choose How to Handle" or "Save As." Again, depending on your browser, a Filter window might appear with Directories, Files, and Selection sections.
Step 9 Reenter your password if you are prompted to do so.
By default, your home directory is selected as the target directory for the device file download. We recommend that you download the device file to the cv_pkgs directory on your workstation.
Step 10 If the Filter window appears, complete this step. In the Selection section of the Filter window, enter the complete destination path and filename of the device file to be downloaded, for example:
/usr/nms/cv_pkgs/device_name.cvxxx.Px-x.tar
where xxx is the version number of CiscoView.
Step 11 After the file is downloaded, close the Web browser window.
Step 12 Proceed to the section, "Untar the Downloaded Device File (in Tar Format)."
Follow these steps to log in as a registered user:
Step 1 From a Web browser, go to the Software Center on CCO by entering the following URL:
http://www.cisco.com/kobayashi/sw-center/
Step 2 At the prompts, enter your CCO user ID and password.
Step 3 On the Software Center page, click on the link to Network Mgmt Products.
Step 4 Proceed to the next section, "Download the Device Package File and Save it to the Temporary Location."
This section applies only to registered users. Follow these steps to download the device file from the CCO Software Center.
Step 1 From the Software Center page, Network Management Products section, select the CiscoView Upgrade Planner pointer to the CiscoView packages.
Links to CiscoView packages can be accessed from the CiscoView Upgrade Planner page. From the planner page, select a link to CiscoView packages.
Step 2 Optionally, read the README file, if one is available. To view the README, click on the README filename and select a download option.
To select a device tar file, click on the device filename and select a download option.
Step 3 Reenter your password if required.
Step 4 Depending on your browser, click Save File, or select File>Save As. You might be prompted to save the file to your workstation, with a message such as "Choose How to Handle" or "Save As." Again, depending on your browser, a Filter window might appear, with Directories, Files, and Selection sections.
Download the device file to the cv_pkgs directory on your workstation.
Step 5 If the Filter window appears, complete this step. In the Selection section of the Filter window, enter the complete destination path and filename of the device file of the device you are downloading, for example:
/usr/nms/cv_pkgs/device_name
Step 6 After the file is downloaded, close the Web browser window.
To untar the device tar file, enter the following in the cv_pkgs directory on your workstation:
tar -xvf tar_file_name
where tar_file_name is the name of your device file, for example:
The package file (*.pkg) and the associated README file are extracted.
Follow these steps to add the package file (*.pkg) to CiscoView:
Step 1 Check the environment variable by entering the following from any directory:
env
The reply should include NMSROOT.
Step 2 If NMSROOT does not appear in the reply, set the NMSROOT environment variable by entering the following from any directory:
setenv NMSROOT /opt/CSCOcv
/opt/CSCOcv is the directory containing the recommended cv_pkgs subdirectory and the CiscoView application files, for example: /usr/nms.
Step 3 Log in as root. One way to do this is to enter the following:
su root
A prompt for your password appears; enter the root password.
To check that you are properly logged in, enter the following:
whoami
If the response is root, you are logged in as root, and you are a superuser.
Step 4 Add the package file to CiscoView by entering the following in the cv_pkgs directory:
$NMSROOT/bin/cvinstall /usr/nms/cv_pkgs/device_name.pkg
device_name.pkg is the name of the package file.
This cvinstall install script installs the Cisco device package file from the cv_pkgs directory.
If errors appear, see "Installation Troubleshooting."
You are finished with the installation. Optionally, you can check the log file as described in the section, "Check the cvinstall.log File for Errors."
The following errors might appear if CiscoView is running while attempting to add the package file to CiscoView:
Error in creating file mib.dat ERROR: xxxxx ciscoProducts: no such object xxxx
If these errors appear or errors similar to these errors, close CiscoView and add the package file again.
If problems occur during the installation, you can check the log file (cvinstall.log) in your install_directory, which contains the application files, for example: /opt/CSCOcv.
After you check the log file, go to the appendixes for information on launching devices or see the "Using CiscoView" chapter to learn more about CiscoView features.
This section describes another way to download the device tar file to a UNIX workstation using FTP service.
Before adding the Cisco device package file to CiscoView, make sure of the following:
The following is a quick-reference overview of the steps necessary for downloading a device file. Details about these steps are in the sections that follow.
You must complete the following steps to properly download using the FTP service:
Follow these steps to check the version of CiscoView and device packages:
Step 1 From any directory on your workstation, open CiscoView by entering nmcview.
Step 2 Select Help>About CiscoView. Make sure the version number is 4.0 or later.
To check packages, select Help>About CiscoView, then click Packages. After you have verified the version of the package, compare it with the CCO version to ensure you have the latest upgrade.
Step 3 Proceed to the next section, "Close CiscoView."
| Caution Closing CiscoView is important! The device package does not install correctly if CiscoView is running during the installation. |
To close CiscoView, select File>Exit from the CiscoView Main window.
Before you download device packages from CCO, create a cv_pkgs directory as a destination directory for the device files. We suggest you download these files to a permanent location, or you can copy them to the CiscoView install directory.
Step 1 Change to the directory containing the CiscoView application files, for example, cd /usr/nms.
This guide refers to this directory as install_directory.
Step 2 Create a cv_pkgs directory:
mkdir /usr/nms/cv_pkgs
This creates the directory cv_pkgs for storing your package files.
Step 3 Change to the cv_pkgs directory:
cd /usr/nms/cv_pkgs
This section applies only to registered users of CCO. Follow these steps to download the device file from the Cisco Software Center FTP site.
Step 1 Begin an FTP session with ftp.cisco.com. There are several ways to use FTP to access device packages. Three methods are described below.
When prompted for your user ID and password, enter your registered CCO user ID and password. Do not connect as an anonymous user; CiscoView device packages are not available to anonymous login users.
ftp://userid:password@cco.cisco.com.
Step 2 After you have established an FTP session, navigate to the top-level CiscoView directory (/cisco/netmgmt/ciscoview), select a CiscoView version, and proceed to the device packages subdirectory.
For example, the CiscoView 4.0 packages and README files are located in:
cisco/netmgmt/ciscoview/4.0/packages
Step 3 Optionally, read the README file, if one is available. If you are using a Web browser, click on the README filename and select a download option to view the file.
Step 4 through Step 7 assume you are using a Web browser. If you are not, use FTP commands or your FTP client user interface to download the device tar file(s).
Step 4 To select a device tar file, click on the device filename and select a download option.
Step 5 Reenter your password if required.
Step 6 Depending on your browser, click Save File, or select File>Save As. You might be prompted to save the file to your workstation, with a message such as "Choose How to Handle" or "Save As." Again, depending on your browser, a Filter window might appear, with Directories, Files, and Selection sections.
Download the device file to the cv_pkgs directory on your workstation.
Step 7 If the Filter window appears, complete this step. In the Selection section of the Filter window, enter the complete destination path and filename of the device file of the device you are downloading, for example:
/usr/nms/cv_pkgs/device_name
Step 8 After the file is downloaded, close the Web browser window.
To untar the device tar file, enter the following in the cv_pkgs directory on your workstation:
tar -xvftar_file_name
Where tar_file_name is the name of your device file, for example:
The package file (*.pkg) and the associated README file are untarred.
Follow these steps to add the package file (*.pkg) to CiscoView:
Step 1 Check the environment variable by entering the following from any directory:
The reply should include NMSROOT.
Step 2 If NMSROOT does not appear in the reply, set the NMSROOT environment variable by entering the following from any directory:
setenv NMSROOT /opt/CSCOcv
/opt/CSCOcv is the directory containing the recommended cv_pkgs subdirectory and the CiscoView application files. Example: /usr/nms.
Step 3 Log in as root. One way to do this is to enter the following:
su root
A prompt for your password appears; enter the root password.
To check that you are properly logged in, enter the following:
whoami
If the response is root, you are logged in as root, and you are a superuser.
Step 4 Add the package file to CiscoView by entering the following in the cv_pkgs directory:
$NMSROOT/bin/cvinstall /usr/nms/cv_pkgs/device_name.pkg
device_name.pkg is the name of the package file.
This cvinstall install script installs the Cisco device package file from the cv_pkgs directory.
If errors appear, see "Installation Troubleshooting."
You are finished with the installation. Optionally, you can check the log file as described in the section, "Check the cvinstall.log File."
The following errors might appear if CiscoView is running while you are attempting to add the package file to CiscoView:
Error in creating file mib.dat ERROR: xxxxx ciscoProducts: no such object xxxx
If these errors appear or errors similar to these errors, close CiscoView, and add the package file again.
If problems occur during installation, you can check the log file (cvinstall.log) in your install_directory, which contains the CiscoView application files, for example: /usr/nms.
The cvinstall.log file can point to situations that might be resolved by reinstalling. You should resolve installation errors before attempting to use CiscoView.
After you check the log file, go to the appendixes for information on launching devices.
You can uninstall one or more device packages. To uninstall a device package, perform the following steps:
Step 1 Login to the machine as root. You can do this by logging in as root from the login prompt or by changing user to root (su root). Enter the root password when prompted for a password.
Step 2 Check if the environment variable NMSROOT is set. It should be set to the location where CiscoView is installed. If the variable is not set, enter the following command to set it. The commands below assume that CiscoView is installed in /opt/CSCOcv. Substitute your actual location if it is not /opt/CSCOcv.
setenv NMSROOT /opt/CSCOcv
If your shell is the Korn or Bourne shell, run the following command:
NMSROOT=/opt/CSCOcv; export NMSROOT
Step 3 Remove the device package from CiscoView by using the following command:
$NMSROOT/bin/uninstallpkg pkg_name
Where pkg_name is the device package name.
You can specify more than one device package (for example, $NMSROOT/bin/uninstallpkg pkg_name1 pkg_name2 pkg_name3...)
If you encounter problems during installation or at some other time, you might want to remove or reinstall Ciscoview. If you want to reinstall CiscoView, you must first remove it.
To remove CiscoView, follow the steps below, depending on your platform, Solaris/HP-UX or AIX.
To remove CiscoView from a Solaris workstation, enter the following command:
# pkgrm CSCOcv
To remove CiscoView from an HP-UX 10.x workstation, enter the following command:
# swremove -v CISCOVIEW
To clean up CiscoView standalone files on either a Solaris or HP-UX workstation, verify whether any user files exist in the directory tree. If you do not find any user files, you can delete the directory. For example, enter the following to determine that no user files exist, and delete the directory tree:
# find /opt/CSCOcv -type f -print # rm -rf /opt/CSCOcv
where /opt/CSCOcv is the location of the CiscoView files.
To uninstall CiscoView on AIX, perform these steps:
Step 1 Log in as the root user.
Step 2 Start the System Management Interface Tool (SMIT) by entering the following command:
Step 3 On the System Management menu, select Communications Applications and Services.
Step 4 Select Cisco Network-Management Applications for AIX.
Step 5 Select CiscoView.
Step 6 Select Maintenance.
Step 7 Select Remove CiscoView for AIX program.
Step 8 In response to the ARE YOU SURE? prompt, click OK.
While the animated man is running, SMIT uninstalls the CiscoView product. If the man raises his hands and SMIT displays OK, the uninstallation process has succeeded. If the man falls down, uninstallation has failed, and you should contact the TAC.
Step 9 Terminate SMIT by pressing F12 or selecting Exit>Exit SMIT.
|
|