|
|
This chapter describes how to install and configure CiscoWorks software on Solaris systems.
Before installing CiscoWorks, you must complete the prerequisite steps described in the "Preparing to Install CiscoWorks" chapter. To install and configure CiscoWorks, you need to perform the following general tasks:
To perform the tasks associated with installing and configuring CiscoWorks, you must log in to your system as the superuser (root). Superusers can perform functions that normal users cannot.
 | Caution If you are a relatively inexperienced UNIX user, limit your activities as the superuser to the tasks described in this publication. As the superuser, you can adversely affect your operating environment if you are unaware of the effects of the commands you use. |
To become the superuser, you must know the root password. In the following examples, the root password is shown as rootpassword. You must substitute your real password wherever you see rootpassword.
If you are not logged in, enter the following commands to log in as the superuser:
login:rootPassword:rootpassword
Make sure that you start an X Window Manager session.
The UNIX prompt is a pound sign (#), indicating that you are logged in as the superuser.
If you are already logged in, but not as root, enter the following commands to change your login:
%suPassword:rootpassword
The C shell prompt changes from a percent sign (%) to a pound sign (#), indicating that you are logged in as the superuser.
If you are not upgrading, skip this section and go to "Mounting the CiscoWorks CD-ROM from a Local or Remote Drive".
Before you upgrade, you must perform the following tasks:
| Caution If you are running Sybase, it is extremely important to back up each Sybase version separately. |
To prevent possible data loss, back up your system and database before installing CiscoWorks. If your system fails during the upgrade, it could corrupt the Sybase database.
Since CiscoWorks uses the Sybase database, you must close all database files and shut down your database before starting the backup process.
To shut down the database, perform the following steps:
Step 1 Log in to your system as the superuser.
For information on how to become the superuser, refer to the section "Becoming the Superuser," earlier in this chapter.
Step 2 To ensure that your Sybase environment variable is set, enter the following:
setenv SYBASE $NMSROOT/sybase
Step 3 Execute the isql binary by entering the following:
$SYBASE/bin/isql -Usa -P <sa_password>
Enter the password, if you created one, for the Sybase SA account at your site. If you do not supply a password, the script assumes the value for password is null.
After isql starts, the prompt 1> appears.
Step 4 Enter the shutdown command as follows:
shutdown
go
The database shuts down, and the root prompt reappears.
Back up your entire CiscoWorks system, including the $NMSROOT directory, current database(s) and map files, as well as any additional Sybase data files. For information on backing up UNIX files, refer to the UNIX manual pages on tar(1) or cpio(1).
| Caution To prevent possible data loss, back up your system and database before installing CiscoWorks. |
After you shut down the Sybase database and back up your existing CiscoWorks software, verify that you are running the supported operating systems and network management software versions.
To verify your current operating system, enter the following command:
uname -r.
To verify that you are using Solstice Site/SunNet/Domain Manager, enter the following:
$SNMHOME/bin/snm_version.
To verify that you are using HP OpenView, enter the following:
/opt/OV/ReleaseNotes/NNM
To verify that you are using Solstice Enterprise Manager, enter the following:
/opt/SUNWconn/em/bin/snm_version
If you are not running the supported versions, follow the instructions to upgrade your operating system and the network management platform software. If you are using Solaris, follow the instructions in the Sun documentation to upgrade your version of Solaris to Version 2.4 or 2.5.1.
After you install your operating system, follow the instructions in your NMS documentation to install Site/SunNet/Domain Manager, Version 2.3, HP OpenView 4.1, or Enterprise Manager 2.0, if it is not already installed
Before you install CiscoWorks from a CD-ROM drive attached to your system or a remote system, connect a CD-ROM drive either to your workstation or to the remote workstation.
Retain the device number used by the CD-ROM drive for later use in installing CiscoWorks. After you log in as the superuser, the installation script prompts you to supply the device name of the local or the remote CD-ROM drive or the name of the remote system and the device name of the remote drive.
The installation and configuration process takes a minimum of 20 to 30 minutes. Depending on your system performance and installation method, installation from a remote CD-ROM drive may take longer than 30 minutes.
| Caution Avoid exposing the CiscoWorks CD-ROM to direct sunlight because it might damage the CD. |
If you are using a CD-ROM drive that is connected to your workstation, refer to the following section, "Mounting from a Local Drive." If you are using a CD-ROM drive that is connected to a remote workstation, refer to the section "Mounting from a Remote Drive." These instructions are also provided in the CiscoWorks CD-ROM insert booklet shipped with the product.
To install the CD-ROM from a local CD-ROM drive, perform the following steps:
Step 1 Log in as the superuser by entering su and the root password.
Step 2 If a /cdrom directory does not already exist, enter:
# mkdir /cdrom
Step 3 Insert the CD-ROM in the drive.
The CD is automatically mounted onto the /cdrom directory. If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.
Step 4 If the /cdrom directory is empty because the CD was not mounted, or if File Manager did not open a window displaying the contents of the CD, check if the vold daemon is running by entering:
# ps -e | grep vold | grep -v grep
Step 5 If the system does not display anything, enter:
# /usr/sbin/vold &
The vold daemon manages the CD-ROM device and performs the mounting.
If you use a CD-ROM drive attached to a remote system, CiscoWorks does not consume disk space on the remote system because the software is copied across the network to the local workstation.
The root .rhosts file on the remote system must contain the host name of your local system and an entry for the user root. Otherwise, you cannot access the remote system to download software from its CD-ROM drive. For more information, refer to the rhosts UNIX manual page.
To install CiscoWorks from a remote host, acquire the appropriate login account to mount the CD-ROM remotely.
To install the CD-ROM from a remote CD-ROM drive, perform the following steps on the remote machine:
Step 1 Log in as the superuser by entering su and the root password.
Step 2 If a /cdrom directory does not already exist, enter:
mkdir /cdrom
Step 3 Place the CD-ROM in the drive.
Step 4 Enter the following command:
# share -F nfs -o ro /cdrom/cdrom0
Step 5 Check NFS server status by entering:
ps -ef | grep nfs | grep -v grep
Step 6 If your machine is enabled as an NFS server, the daemons /usr/lib/nfs/nfsd and /usr/lib/nfs/mountd should be running. If these daemons are not running, enable your machine as an NFS server by entering:
/etc/init.d/nfs.server start
The CD is automatically mounted onto the /cdrom directory. If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.
Step 7 If the /cdrom directory is empty because the CD was not mounted, or if File Manager did not open a window displaying the contents of the CD, check if the vold daemon is running by entering:
ps -e | grep vold | grep -v grep
Step 8 If the system does not display anything, enter:
/usr/sbin/vold &
The vold daemon manages the CD-ROM device and performs the mounting.
Step 9 Go to the local machine and become the superuser by entering su and the root password.
Step 10 If a /cdrom directory does not already exist, enter:
mkdir /cdrom
Step 11 To mount the CD-ROM, enter:
/usr/sbin/mount -r remote_machinename:/cdrom/cdrom0 /cdrom
You do not have to create the directory for the CiscoWorks files. By default, CiscoWorks is installed in the following directories:
/opt/CSCOcws Site/Sun Net/Domain Manager version
/opt/CSCOcwh HP OpenView version
/opt/CSCOsyb All Sybase modules
You may need to install or remove CWSI from your system before or after installing CiscoWorks. The following scenarios are described in this section:
The system on which you are installing or upgrading CiscoWorks may already have CWSI 1.1 or 1.3 installed.
If CWSI 1.1 is already installed on your system and you are using Site/SunNet/Domain Manager, you must do the following:
Step 1 Remove the links created by CWSI 1.1 in the Site/SunNet/Domain Manager directories by entering the following shell script:
#!/bin/sh
for file in /opt/SUNWconn/snm/agents/* /opt/SUNWconn/snm/struct/* /opt/SUNWconn/
snm/icons/*
do
FILE=`ls -l $file`
echo $FILE | /usr/xpg4/bin/grep -q CSCO
STAT=$?
if [ -h $file -a $STAT -eq 0 ]; then
ls -l $file
rm $file
fi
done
Step 2 Remove $SNMHOME/struct/cw.schema, if it exists.
Step 3 Install CiscoWorks as described in the section "Installing or Upgrading CiscoWorks" later in this chapter.
If CWSI 1.3 is already installed, install CiscoWorks as described in the section "Installing or Upgrading CiscoWorks" later in this chapter.
If you are installing CWSI 1.1 on a system that has CiscoWorks installed, follow the procedure outlined in the CWSI 1.1 Installation Guide.
If you are installing CWSI 1.3 on a system that already has CiscoWorks installed, follow the procedure outlined in the CWSI 1.3 Installation Guide.
The system on which you are installing CWSI 1.1 or 1.3, may already have CiscoWorks and CiscoView already installed.
If the system on which you are installing CWSI 1.1 already has CiscoWorks and CiscoView 4.0 installed, do the following:
Step 1 Uninstall CiscoView 4.0 as described in the CiscoView Installation Guide.
Step 2 Install CWSI 1.1 as described in the CWSI 1.1 Installation Guide.
If the system on which you are installing CWSI 1.3 already has CiscoWorks and CiscoView 4.0 installed, do the following:
Step 1 Uninstall CiscoView 4.0 as described in the CiscoView Installation Guide.
Step 2 Install CWSI 1.3 as described in the CWSI 1.3 Installation Guide.
The system on which you are removing CWSI 1.1 or 1.3 may have CiscoWorks installed.
If you are removing CWSI 1.1 from a system that has CiscoWorks installed and you are using HP OpenView, follow the instructions in the CWSI 1.1 Installation Guide.
If you are removing CWSI 1.1 from a system that has CiscoWorks installed, and you are using Site/SunNet/Domain Manager, do the following:
Step 1 Remove CWSI 1.1 as described in the CWSI 1.1 Installation Guide.
Step 2 Remove the links created by CWSI 1.1 in the Site/SunNet/Domain Manager directories by entering the following shell script:
#!/bin/sh
for file in /opt/SUNWconn/snm/agents/* /opt/SUNWconn/snm/struct/* /opt/SUNWconn/
snm/icons/*
do
FILE=`ls -l $file`
echo $FILE | /usr/xpg4/bin/grep -q CSCO
STAT=$?
if [ -h $file -a $STAT -eq 0 ]; then
ls -l $file
rm $file
fi
done
Step 3 Remove $SNMHOME/struct/cw.schema, if it exists.
Step 4 Enter the following command:
/opt/CSCOcws/etc/cw_install_snm
Step 5 Reinitialize Site/SunNet/Domain Manager by entering the following command:
snm -i
If you are removing CWSI 1.3 from a system that has CiscoWorks installed, follow the instructions in the CWSI 1.3 Installation Guide.
The installation process on Solaris requires you to install the CiscoWorks packages, reboot the system, if necessary, and run the configuration scripts.
To install CiscoWorks on a Solaris 2.4 or 2.5.1 platform, perform the following steps:
Step 1 If you are installing for the first time, extract the files from the CD-ROM by entering the following command:
# pkgadd -d /cdromdir all
Where cdromdir is one of the following CD-ROM directories:
/cdrom/cdrom0 if the CD-ROM is mounted on your local machine
/cdrom if the CD-ROM is mounted on a remote machine
Step 2 If you are upgrading from CiscoWorks 3.2, extract the files from the CD-ROM by entering the following command:
# pkgadd -a /cdromdir/cwadmin -d /cdromdir all
Where cdromdir is one of the following CD-ROM directories:
/cdrom/cdrom0 if the CD-ROM is mounted on your local machine
/cdrom if the CD-ROM is mounted on a remote machine
Step 3 Answer yes each time pkgadd prompts whether you want to upgrade a package.
Step 4 If you are prompted to reboot your system, enter:
reboot
This ensures that your system is configured for running Sybase.
Step 5 After your computer reboots, log into your system as superuser (root), as follows:
root
password:rootpassword
Step 6 If OpenView is running, exit the interface by selecting Map>Exit.
Step 7 If Site/SunNet/Domain Manager is running, exit the interface by selecting Close from the System Menu.
Step 8 If any tools have been started from the Enterprise Manager Viewer, exit by selecting File>Exit.
Step 9 If you are upgrading from a previous version of CiscoWorks, shut down the CiscoWorks processes by entering:
source $NMSROOT/etc/install.cshrc
shutdown_nms
Step 10 Change directories and run the cwconfigure script:
cd $NMSROOT/install
./cwconfigure
Step 11 To unmount and eject the CD-ROM from your local machine, enter:
cd /
# eject
Step 12 To unmount and eject the CD-ROM from a remote machine, do the following:
cd /
# unmount /cdrom
cd /
# eject
Step 13 Remove the CD-ROM from the drive and store it in a safe place.
Refer to the chapter "Validating CiscoWorks Installation" for installation verification procedures and customizing information.
All Sun workstations contain a kernel. The kernel is the heart of the UNIX system that is read when your system is started; it is the part of the operating system that allocates resources and controls processing.
If you are using a Sun workstation and selected to manually update the kernel instead of having the installation script perform the changes, perform the following procedure. In order for Sybase Version 10.0.2 software to work on your Sun system, you must modify the kernel.
Kernel modifications must be completed after you run your installation and before you run your configuration scripts.
To modify the kernel manually (as the superuser), add these three lines to your /etc/system file:
set shmsys:shminfo_shmmax=131072000
set rlim_fd_max+1024
set rlim_fd_max=1024
This ensures that there will be enough shared memory and file descriptors for Sybase to function properly. You must reboot your system for the kernel modifications to take effect.
To ensure that CiscoWorks runs successfully, you may need to perform several post-installation tasks. The following sections contain instructions for these tasks:
During install, log files (described in Table 2-1) are created to track the installation process and provide diagnostic information if a problem arises.
When you are satisfied that CiscoWorks is properly installed and operating, you can remove each log file by entering the following command:
# rm $NMSROOT/install/cwconfigure.log
rm *.log to remove the CiscoWorks log files because other applications can put log files in these directories and you may need to keep those application's log files.
| Log Filename | Contents |
|---|---|
| $NMSROOT/install/scripts/.install/config.defs | Your responses to the prompts during the configuration. (This file is not removed because you may want to use the same answers if you need to reinstall CiscoWorks. The software will use these answers as the defaults when you next install CiscoWorks.) |
| $NMSROOT/install/cwconfigure.log | Configuration log messages. |
CiscoWorks is based on the OSF/Motif windowing system and requires Motif key mapping. During installation, you are alerted that you need Motif key mapping. The installation script then offers to update the XKeysymDB (key mapping) file for you in case you are using a different platform, such as OPEN LOOK. If necessary, you can also manually update the XKeysymDB file by appending $NMSROOT/etc/XKeysymDB to your XKeysymDB file.
You can customize certain features of your CiscoWorks and NMS environments by modifying the X Windows resource files. X resources are listed in each user's .Xdefaults file or in the system X resource files located in the /usr/lib/X11/app-defaults directory. For example, you can change the window display colors, fonts, or sizes, or specify certain ways for CiscoWorks to run in your X Windows environment.
This section provides information on the following topics:
You can customize any X resource that CiscoWorks applications use, including colors, fonts, and sizes in CiscoWorks windows. To use your own colors, fonts, and sizes for CiscoWorks, perform one of the following procedures:
When working with CiscoWorks applications, you may notice that the window sizes vary from application to application. The layout of the window and the size of its text and graphics is preset to be large enough to contain all the elements that define the window. However, you can resize the window without obscuring the text.
To save the default CiscoWorks window size, perform the following steps:
Step 1 Use a text editor such as vi to open the $HOME/XCiscoWorks file.
Step 2 Add the following line to your $HOME/XCiscoWorks file:
XCiscoWorks*geometry:500x400+0+0
Step 3 Save the $HOME/XCiscoWorks file and quit the text editor.
Step 4 Enter the following command at the UNIX prompt:
xrdb -merge ~/XCiscoWorks
CiscoWorks features an expanded Help system with hyperlinks (jumps to other help windows) to help you learn more about your CiscoWorks applications.
By default, hyperlinks display link text in forest green. To change the color, you can modify the X resource HyperHelp*LinkColor.
The current default help settings are modeled after Microsoft Help's color scheme. To change the default setting for windows, fonts, and other options, modify lines in your X resource HyperHelp file.
To modify the X resources for your Help windows, perform the following steps:
Step 1 Change to the directory where the HyperHelp X resource file is located:
cd /usr/lib/X11/app-defaults
You may have put the HyperHelp file in a different directory; if so, change to the appropriate directory path.
Step 2 Use a text editor such as vi to alter any of the following X resources in the HyperHelp file:
Step 3 Save the HyperHelp file and exit.
Step 4 Restart the online help system to allow the new HyperHelp system changes to take effect.
To define the look of your text editor window, perform the following steps, substituting the appropriate options:
Step 1 Confirm that X Windows is running.
To start an X window session, enter x11start or xinit at the UNIX command line.
Step 2 Use a text editor such as vi to open the .Xdefaults file.
Step 3 Add a line with the following format to the .Xdefaults file:
EditorFormat:command_string %s
Where command_string is the value or name of the X resource. For example, to specify the vi editor located in /usr/local/bin, add the following line to the .Xdefaults file:
EditorFormat:/usr/local/bin/vi %s
For example, to specify the vuepad editor located in /usr/vue/bin, add the following line to the .Xdefaults file:
EditorFormat:/usr/vue/bin/vuepad %s
Step 4 Save the .Xdefaults file and quit the text editor.
To enable boot file generation, edit the .Xdefaults file to specify the on state by performing the following steps:
Step 1 Confirm that X Windows is running.
To start an X window enter x11start or xinit at the UNIX command line.
Step 2 Use a text editor such as vi to open the .Xdefaults file.
Step 3 Add the following line to the .Xdefaults file:
Bootfile:on
Step 4 Save the .Xdefaults file and quit the text editor.
After you install CiscoWorks for the first time, you may need to reinstall it. For example, some files on your workstation might become damaged or corrupted. Reinstalling means that you delete all of the existing CiscoWorks files and reinstall them from the same version of CiscoWorks. When you reinstall CiscoWorks, you can do a new or upgrade install, as appropriate.
|
|