|
|
The Y2K Compliance Assessment Tool is based on the CiscoWorks2000 Resource Manager Essentials product. The Y2K Compliance Assessment Tool helps to discover Cisco devices in your network and provides inventory tools that help you analyze whether your Cisco network is year 2000 compliant. It is a set of web-based tools integrated with a network desktop. It includes a web-server component, web-based tools, and web browser capability. The kit is based on a client/server network architecture that connects multiple web-based clients to a network server.
This chapter consists of the following sections:
The system requirements for Y2K Compliance Assessment Tool are summarized in Table 2-1. The requirements listed are for the server system only. For client system requirements, refer to the "Client Requirements" section.
| Requirement Type | Y2K Compliance Assessment Tool Server |
|---|---|
System hardware | Sun Ultra1 or later |
Memory (RAM) | 160 MB minimum |
Available drive space1 |
|
System software2 | Solaris 2.5.1 or Solaris 2.6 |
Browser | None3 |
Additional required software | None |
| 1See the "Server Requirements" section for information about checking the available disk space on your system. 2Solaris 2.5.1 and 2.6 require patches. See the "Server Requirements" section for detailed information. 3No browser is required for the Y2K Compliance Assessment Tool server system. Client systems must have a supported browser installed. Refer to the "Client Requirements" section for more information. |
Files thatY2K Compliance Assessment Tool downloads to the server are stored in the /tmp directory or its subdirectories. Make sure that there is sufficient available space in the /tmp directory for all files that you plan to download.
Table 2-2 provides an overview of Y2K Compliance Assessment Tool installation, and references to more detailed information about each task. The information in the rest of this chapter follows the same order as the quick reference.
| Task | Steps | References | ||
|---|---|---|---|---|
| Step 1 Verify that server requirements are met. | "Server Requirements" section "System Requirements" section | ||
Step 2 Verify that client requirements are met. | "Client Requirements" section | |||
Step 3 (Optional) Verify that your intended device import software is supported. | "Using Server IP Address" section | |||
Step 4 Note that theY2K Compliance Assessment Tool uses the server's IP address to communicate with clients. | "Using Server IP Address" section | |||
Step 5 Note the TCP ports that the Y2K Compliance Assessment Tool uses and check for conflicts with existing applications. | "TCP and UDP Ports Used" section | |||
Step 6 Note the system files that are modified during installation. | ||||
| Step 1 Install and run the installation program. | |||
Step 2 Answer any questions that result from the installation program's checks. | ||||
Step 3 Select the Express or Custom installation option. | ||||
Step 4 (Custom only) Select the installation directory. | "Custom Installation" section | |||
| Step 1 Verify that the correct files and directories are installed. | "Troubleshooting" chapter, "Checking Files and Directories After Installation" section | ||
Step 2 Analyze installation error messages. | "Troubleshooting" chapter, "Understanding Installation Error Messages" section | |||
Step 3 Collect the server information to determine if the installation is complete. | "Troubleshooting" chapter, "Gathering Server Information" section |
Before you install, make sure your server and client environments meet the hardware and software requirements described in the following sections:
Make sure your server meets the following hardware and software requirements and software compatibility recommendations.
The Y2K Compliance Assessment Tool hardware and software requirements are given in the "System Requirements" section.
To verify the amount of available disk space in each of the specified partitions and directories, enter the following command:
# df -k directory
Where directory is the partition or directory for which you want to check the available disk space.
The software required for the Y2K Compliance Assessment Tool server is Solaris 2.5.1 (with patches 103566-25 and 103640-17) or Solaris 2.6. (with patch 105490-04).
Use the showrev -p command to make sure the patches are applied.You can find additional information about the Sun patches at the following location:
http://www.sun.com/solaris/jre
Clients use a web browser running on a UNIX workstation or PC to access the Y2K Compliance Assessment Tool server. The hardware and software requirements for client workstations or PCs are as follows:
The Y2K Compliance Assessment Tool supports clients running the browsers shown in Table 2-3.
| Browser | Version |
|---|---|
Netscape Navigator | 4.5 on Solaris 2.5.1 or 2.6, Windows NT 4.0, Windows 95, AIX 4.2.1 or 4.3, and HP-UX 10.20 or 11.0 |
Microsoft Internet Explorer | 4.01 with Internet Explorer Service Pack 1 on Windows NT 4.0 and Windows 95 |
To configure a client system to use with theY2K Compliance Assessment Tool, follow these steps:
Step 1 On Microsoft Windows systems, set the display to use small fonts.
(a) Select Start > Settings > Control Panel. The Control Panel window appears.
(b) Double-click the Display icon. The Display Properties dialog box appears.
(c) Click the Settings tab. If Small Fonts is selected in the Font Size list, your display font is set correctly; go to Step 2.
(d) Select Small Fonts from the Font Size list, then click OK. The System Settings Change dialog box appears.
(e) Click Yes to restart your system. Windows restarts using the small display font.
Step 2 Configure the Web browser.
(a) Enable Java and JavaScript.
(b) Set your browser cache to at least 4 MB.
(c) Configure your browser to accept all cookies.
(d) Configure your browser to compare each page with its cached version every time it loads a page.
(e) (Internet Explorer only) Set the security level to Medium. Select View > Internet Options > Security, then select the Medium (more secure) radio button and click OK.
(f) (Internet Explorer only) Change the default timeout value to 20 minutes. Instructions are provided on the Microsoft Support Web site at the following URL:
http://support.microsoft.com/support/kb/articles/q181/0/50.asp
(g) Enable style sheets.
(h) Change the default font to a sans serif font for easier readability.
If you experience browser problems after configuring your browser as described above, increase your disk cache settings.
After the web browser is installed on the client machine, there are no additional disk space requirements. However, because the browser uses the local machine's disk to store cached information, make sure you have enough disk space for the amount of cached information you want to store. All theY2K Compliance Assessment Tool information is stored on the Y2K Compliance Assessment Tool server.
Set the following environment variables for theY2K Compliance Assessment Tool system administrators. These variables are not required for tasks that users perform using the web interface.
TheY2K Compliance Assessment Tool includes manual (man) pages for its command line commands. You can view these man pages in the following ways:
1. Set the MANPATH variable to include the path /opt/CSCOpx/man (where /opt/CSCOpx is the directory in which theY2K Compliance Assessment Tool was installed). Then you can view the man pages from any directory using the following command:
$ man pagename
Where pagename is the name of the man page. Refer to the section "Setting Environmental Variables" for information about setting up administrator systems.
2. If the MANPATH variable is not set, you can view the man pages while you are in the directory /opt/CSCOpx/man (where /opt/CSCOpx is the directory in which theY2K Compliance Assessment Tool was installed) using the following command:
man -M . pagename
Where pagename is the name of the man page.
3. If the MANPATH variable is not set, you can view the man pages from any directory using the following command:
man -M /opt/CSCOpx/man pagename
Where /opt/CSCOpx is the directory in which theY2K Compliance Assessment Tool was installed and pagename is the name of the man page.
To avoid inconsistencies in how domain names are used in networks, theY2K Compliance Assessment Tool uses the IP address of the server on which you installed the kit when it interacts with web browsers. By using the IP address of the server, the Y2K Compliance Assessment Tool reduces the likelihood of name lookup failures between the server and the client machines that run web browsers.
# /etc/init.d/dmgtd stop
# /etc/init.d/dmgtd start
In addition to the standard network ports (telnet, tftp, etc.) the Y2K Compliance Assessment Tool uses the following TCP and UDP ports. These ports are added to /etc/services when you install the Y2K Compliance Assessment Tool:
http://server_name:1741
The Y2K Compliance Assessment Tool installation program detects whether any of the default TCP ports are already in use on your system and prompts you to enter an available TCP port number for each port that has a conflict.
Refer to the "Setting Up the Y2K Compliance Assessment Tool" chapter for more information about accessing the server. Refer to the "Troubleshooting" chapter if you encounter problems.
The following system files are modified during Y2K Compliance Assessment Tool installation:
This section describes how to install the Y2K Compliance Assessment Tool. The installation program takes approximately 20 minutes to complete if you use the express installation option on an Ultra 1.
 | Caution If you have CiscoWorks2000 Resource Manager Essentials on your system, you must uninstall it before installing the Y2K Compliance Assessment Tool. |
If you do not specify the express installation option, the installation takes longer because you must respond to questions asked by the installation tool. See the "Custom Installation" section to see the questions asked.
To run the Y2K Compliance Assessment Tool installation program, follow these steps:
Step 1 To download the executable file from CCO:
(a) Follow the directions on CCO to download the installation program and the readme file.
(b) As root, copy or ftp the installation program to the destination machine.
(c) Unzip the file by entering the following commands:
# gzip -d filename.tar.gz
# tar -xf filename.tar
(d) To install, enter the following commands:
# cd Essentials
# ./setup.sh
Step 2 To install the program from CD-ROM:
(a) Mount the CD-ROM on:
Refer to the appendix "Mounting and Unmounting on Solaris" for detailed instructions on mounting the CD-ROM.
(b) Run the installation program.
For a local CD installation, enter the following commands:
# cd /cdrom/cdrom0
# sh ./setup.sh
For a remote installation, enter the following commands:
# cd remotedir
# sh ./setup.sh
where remotedir is the remote location wher the CD-ROM is mounted.
The following message is displayed:
Software Install Tool Started.
These preinstallation checks can generate two types of results:
Step 3 Answer any questions that result from the preinstallation checks. These questions could include one or more of the following:
If the preinstallation checks generate any of these questions, the installation program automatically selects the custom installation option. Go to the section "Custom Installation" to continue with the installation.
The express install takes all defaults and places the product into /opt/CSCOpx. No more questions will be asked of you.
Do you want the Express Install (y/n)? [Y]
Step 4 Select one of the two options for continuing with the Y2K Compliance Assessment Tool installation:
If you entered Y when asked if you want the express installation, theY2K Compliance Assessment Tool is installed using the default TCP ports specified in the "TCP and UDP Ports Used" section and you do not need to answer any additional questions. The installation program keeps you updated on the status of the installation as it installs theY2K Compliance Assessment Tool and displays any error or warning messages on your screen. When the install completes, any error messages that appeared during the installation appear on the screen again, followed by the following message:
Software Install Tool Completed.
You have now completed the installation program. If you encountered any errors, check the installation log file /opt/CSCOpx/ciscoinstall.log (where /opt/CSCOpx is the directory in which you installed theY2K Compliance Assessment Tool). For troubleshooting information, or to verify the directories installed on your system, refer to the "Troubleshooting" chapter.
If you entered N when asked if you want the express installation, or if you had to answer any questions that resulted from the installation program's preinstallation checks, the installation tool begins the custom installation option by asking a question similar to the following:
Where should the product be installed? [/opt/CSCOpx]
To accept the default, which is shown in square brackets, press Return or enter a new path where you want theY2K Compliance Assessment Tool to be installed.
The installation program installs theY2K Compliance Assessment Tool using the default TCP ports specified in the "TCP and UDP Ports Used" section. Any error or warning messages are displayed on your screen. When the install completes, any error messages that appeared during the installation appear on the screen again. The following message appears when the installation is complete:
Software Install Tool Completed.
You have now completed the Y2K Compliance Assessment Tool installation. If you encountered any errors, check the installation log file /opt/CSCOpx/ciscoinstall.log (where /opt/CSCOpx is the directory in which you installed theY2K Compliance Assessment Tool). For troubleshooting information, or to verify the directories installed on your system, refer to the "Troubleshooting" chapter.
| Caution You must use the Y2K Compliance Assessment Tool uninstallation program to remove the product. If you attempt to remove the Y2K Compliance Assessment Tool manually, you can damage your system. |
To remove the Y2K Compliance Assessment Tool, follow these steps:
Step 1 Enter the following commands as root to start the uninstall script:
# cd Essentials
# ./uninstall.sh
A list of all installed Y2K Compliance Assessment Tool packages appears, followed by this prompt:
INFO:Delete all the above listed Y2K Compliance Assessment Tool pkgs from the system? [yes]
Step 2 To remove all the Y2K Compliance Assessment Tool packages, press Return or enter Y (yes). The specified packages are removed and a verification message appears. To cancel the removal of the Y2K Compliance Assessment Tool, enter N (no).
When you remove the Y2K Compliance Assessment Tool, the uninstall script removes the changes made to the /etc/services file. The /etc directory still contains all system file changes. The uninstall messages are written to the /var/tmp/ciscouninstall.log file.
When the uninstall script completes, two lists of packages appear on the screen: packages that were removed, and packages that could not be removed.
Step 3 Check /etc/syslog.conf for syslog changes. Check /etc/services to make sure port assignments for the Daemon Manager and web server have been removed. See the "Troubleshooting" chapter for more information.
To reinstall the Y2K Compliance Assessment Tool, follow the instructions in the "Running the Installation Program" section.
If you have CCO access, you can refer to the Y2K Compliance Assessment Tool web page at the following URL to download any available software enhancements:
http://www.cisco.com/kobayashi/sw-center/netmgmt/y2k/y2k-cat.shtml
If you do not have CCO access, you can refer to the Y2K Compliance Assessment Tool web page at the following URL to download any available software enhancements:
http://www.cisco.com/public/sw-center/netmgmt/y2k/y2k-cat.shtml
Posted: Thu Sep 30 16:06:09 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.