Installing and Configuring CiscoWorks

To complete the installation process on your Sun workstation, perform the following steps:

Step 1 Extract the files from the CD-ROM by entering the following commands:

# cd /cdrom

# ./extract_unbundled -c /cdrom_install_directory

If you do not specify the -c option, the /cdrom directory is used as the default.

While the ./extract_unbundled script runs, answer the questions it displays according to the information you entered on your CiscoWorks Installation Worksheet.

Step 2 Reboot your system to ensure that the new kernel is used by entering the following command:

# reboot


If you answered no to the automatic kernel modification during the installation, you must manually update the kernel by performing the steps in the "Manually Entered Sybase Modifications to the Kernel Configuration File" section later in this chapter.

Step 3 Log into your system as the superuser after your computer reboots.

login: root
password: rootpassword

#

Step 4 Begin the CiscoWorks configuration process by entering the following command:

# /usr/tmp/unbundled/cwconfigure

While the cwconfigure script runs, answer the questions it displays according to the information you entered on the CiscoWorks Configuration Worksheet.

Step 5 After configuring CiscoWorks, you can remove the installation log files by following the instructions in "Removing Log Files" later in this chapter.

Step 6 To eject the CD-ROM, enter the following commands:

# cd /

# umount /cdrom

# eject /dev/device_filename

Step 7 Remove the CD-ROM caddy from the drive and put the CD-ROM away.

If you are using Network Information Service (NIS) at your site, the configuration script saves NIS-related information to the following files during the configuration:

• /usr/tmp/CW.group
  

• /usr/tmp/CW.prod
  

• /usr/tmp/CW.sybase
  

After completing the CiscoWorks configuration, use the information in these files to update your NIS server.

Your installation and configuration is complete.

If you need to create additional space for the databases and transaction log, enter the following command:

# /usr/nms/etc/cw_enlarge

While the cw_enlarge script runs, answer the questions it displays. This script sets database thresholds for disk space based on your database size.

Manually Entered Sybase Modifications to the Kernel Configuration File

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 an HP-UX system, you can skip this section. HP-UX recommends you use the system administrator manager, or SAM, to update your configuration.

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.1 software to work on your Sun system, you must modify the kernel. The kernel is built from a configuration file in either the /usr/share/$ARCH/conf directory (where $ARCH could be defined as sun4c, sun4m, or sun4n) or the /usr/sys/$ARCH /conf directory.

Kernel modifications must be completed after you run your installation and before you run your configuration scripts.

Most systems use a generic kernel stored in a configuration file called GENERIC. If the kernel is customized for your system, it may be stored in a configuration file with a different name.

If you choose to allow the installation script to build the new kernel, it uses your current system configuration and automatically saves the old kernel configuration file as vmunix.syb_inst.

To modify the kernel manually (as the superuser), perform the following steps:

Step 1 Back up your existing configuration file by entering the following command:

# cp /vmunix /vmunix.bak

Step 2 Change directories by entering the following command:

# cd /usr/share/$ARCH/conf
OR
cd /usr/sys/$ARCH/conf

Step 3 Copy the base kernel configuration file (usually called GENERIC) to filename by entering the following command, where filename is the new name you assign to the kernel configuration file:

# cp GENERIC filename

Step 4 Add the following lines anywhere in the /usr/share/$ARCH/conf/filename file or /usr/sys/$ARCH/conf/filename file:

options "SHMSIZE=0x20000"
options "SEMMNS=640"
options "SHMMNI=256"

Step 5 Start the configuration process by entering the following command:

# config directoryname

This command executes the configuration process and builds a directory called /usr/share/$ARCH/conf//directoryname or /usr/sys/$ARCH/conf/directoryname.

Step 6 Create the vmunix or vmunix_small file by entering the following command:

# cd ../directoryname

# make

Step 7 Copy the vmunix or vmunix_small file, created in the previous step, by entering the following command:

# cp ./vmunix /vmunix

OR

# cp ./vmunix_small /vmunix

Step 8 Restart your system.

The modified kernel is now loaded and ready to use with Sybase.

For more information on modifying the kernel, refer to the Sun Workstation and Network Administration publication.

Installing CiscoWorks on an HP System

To complete the installation process on your HP system, perform the following steps:

Step 1 Copy the installation and configuration scripts to the new CiscoWorks directory by entering the following command:

# /etc/update -s /cdrom/cw.tar -d /usr/nms CWIC


-s is the source file to be copied and -d is the destination directory where the software is downloaded.

Step 2 Install the CiscoWorks software by entering the following command:

# /usr/nms/install/bin/cwinstall -s /cdrom/cw.tar -d /usr/nms


This causes the cwinstall script to prompt you for responses to key questions. While the cwinstall script runs, answer the questions it displays according to the information you entered on the CiscoWorks Installation Worksheet.

The cwinstall script takes the following options:

-s Source
-d Destination
-help Print the usage
-f filesets CiscoWorks software to install

Step 3 Use the configuration script to configure CiscoWorks by entering the following command:

# /usr/nms/install/bin/cwconfigure


While the cwconfigure script runs, answer the questions it displays according to the information you entered on the CiscoWorks Configuration Worksheet in the "Preparing to Install CiscoWorks" chapter. Table 3-6 "Configuration Descriptions for Sun and HP Systems" explains the CiscoWorks Configuration Worksheet.

# rm /usr/tmp/unbundled/log/filename.log        

# rm /usr/nms/install/bin/log/filename.log