AtmDirector Installation Instructions

Installing from a Local CD-ROM

Installing from a Remote CD-ROM

Installing AtmDirector

Licensing Agreement and Copyright Information

This booklet provides instructions on installing the AtmDirector` CD-ROM from either a local or a remote machine. Also included is a step-by-step procedure for installing the AtmDirector software.

Note Perform all tasks as the superuser.

Installing from a Local CD-ROM

To install the CD-ROM from a local CD-ROM drive, perform the following steps:

Log in as the superuser by entering su and the root password.
Create a /cdrom directory, if one does not exist, by entering the following command:

# mkdir /cdrom

If the /cdrom directory already exists, proceed to the next step.

Place the CDROM in its caddy and insert it into the CD-ROM 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. 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-ROM, check if the vold daemon is running by entering the following command:

# ps -e | grep vold | grep -v grep

If the system does not display anything, enter the following command:

# /usr/sbin/vold &

The vold daemon manages the CD-ROM device and performs the mounting.

Installing from a Remote CD-ROM

To install the CD-ROM from a remote CD-ROM drive, perform the following steps on the remote machine:

Log in as the superuser by entering su and the root password.
Create a /cdrom directory, if one does not exist, by entering the following command:

# mkdir /cdrom

If the /cdrom directory already exists, proceed to the next step.

Place the CD-ROM in its caddy and insert it into the CD-ROM drive.
Use a text editor to create an /etc/dfs/dfstab file on Solaris, if one does not exist.
Add the following line to the /etc/dfs/dfstab file:

share -F nfs -o ro /cdrom

Ensure that your workstation is enabled as an NFS server. To do so, first check the status of your NFS server by entering the following command:

# ps -ef | grep nfs | grep -v grep

If your machine is enabled as an NFS server, the following daemons should be running: /usr/lib/nfs/nfsd and /usr/lib/nfs/mountd.
If these daemons are not running, enable your machine as an NFS server with the following command:

# /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. 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-ROM, check if the vold daemon is running by entering the following command:

# ps -e | grep vold | grep -v grep

If the system does not display anything, enter the following command:

# /usr/sbin/vold &

The vold daemon manages the CD-ROM device and performs the mounting.

Go to the local machine.
Become the superuser by entering the following command:

% su root

Create a /cdrom directory, if one does not already exist, by entering the following command:

# mkdir /cdrom

To mount the CD-ROM, enter the following command:

# /usr/sbin/mount remote_machinename:/cdrom /cdrom

Installing AtmDirector

To install the AtmDirector software, perform the following steps:

Note You can terminate the installation at any time by answering q to a system prompt. To return to the previous question at any time, enter ^.

Install the Cisco Sybase package by entering the following command:

# pkgadd ---d /cdrom/cdrom0 CSCOsyb

The Cisco Sybase package is installed in the directory /opt. If you want to install the package in a different directory, enter the following command:

# pkgadd ---a none ---d /cdrom/cdrom0 CSCOsyb

The system prompts you with the following:

Do you want to continue with the installation of this 
package [y, n?] y

Enter y to continue with the installation.
The system installs the Cisco Sybase package and notifies you of the completion:

Installation of <CSCOsyb> was successful.

You are then prompted with the following notice:

***IMPORTANT NOTICE***
This machine must now be rebooted to ensure sane 
operation. Execute
shutdown ---y ---i6 ---g0
and wait for the "Console Login:" prompt.

Reboot your system by entering the following command:

shutdown ---y ---i6 ---g0

Log in to your system.
Become the superuser by entering the following command:

% su root

Install the Cisco AtmDirector package by entering the following command:

# pkgadd ---d /cdrom/cdrom0 CSCOatmd

You are prompted to enter the Sybase home directory:

Enter the home directory of Sybase? [/opt/CSCOsyb] 
/opt/CSCOsyb

Press the Return key to accept the default location of /opt/CSCOsyb. If you installed Sybase in an alternate location (using the ---a none option), enter that location.
The Cisco AtmDirector package is installed in the specified directory. The following additional values are used, by default, for this install:


AtmDirector UDP port: 5889
AtmDirector log file /opt/CSCOatmd/data/log/logfile
Sybase data server: CW_SYBASE
Sybase backup server: CW_BACKUP_SERVER

Note You can accept these standard values and proceed with the installation, or you can customize one or more values when prompted.

Answer y to install AtmDirector with the specified values.
The system displays the location where AtmDirector will be installed and the values you have chosen for this installation.
If you answer n, the system prompts you with a series of questions for each value and then prompts you again:

Do you want to continue with the installation of this 
package [y, n?] y

Answer y to continue with the installation of AtmDirector.
The system installs the AtmDirector package and notifies you of the completion:

Installation of <CSCOatmd> was successful.

To configure the Sybase database for AtmDirector, run the database setup script by entering the following command:

# /opt/CSCOatmd/etc/atmd_setupdb

Note If you installed AtmDirector in a directory other than CSCOatmd, enter that directory name.

The sytem prompts you with the following:

Do you wish to configure Sybase? y

Answer y to configure Sybase.
You are prompted to enter and then reenter the system administrator password for the configured Sybase data server:

Enter the Sybase `sa' password?
Reenter the password to verify?

Enter the system administrator password.
You are prompted to enter the size of the database:

Enter the database size in MB.

Enter the size of the database. You may use the following guidelines to choose a size:

For a network of 0-50 nodes, enter 20.
For a network of 50-200 nodes, specify 50.
For a network of over 200 nodes, specify 75.

The system creates a new Sybase physical device that will be used to store data for AtmDirector. This can either be a regular file or a raw partition. If you wish to enlarge the database at a later time, refer to the AtmDirector Getting Started Guide.
You are prompted to enter the database filename:

Enter the database filename.

Enter the database filename, or press the Return key to accept the default value. The default is /opt/CSCOsyb/data/atmd_datadevice.
You are prompted to enter the log filename:

Enter the log filename.

Enter the log filename or press the Return key to accept the default value. The default is /opt/CSCOsyb/data/atmd_logdevice.
The system runs the database setup script. The following additional values are used, by default, for configuring Sybase:

AtmDirector log size: 12
Data server TCP port: 5988
Backup server TCP port: 6088
Master database device: /opt/CSCOsyb/data/atmd_master
Master database size: 17
Sybsysprocs device: opt/CSCOsyb/data/atmd_sybsysprocs
Sybsysprocs size: 14
Temp database device: /opt/CSCOsyb/data/atmd_tempdevice
Temp database size: 20

Note You can accept these standard values and proceed with the setup, or you may customize one or more values when prompted.

Answer y to run the setup script with the specified values.
If you answer n, the system prompts you with a series of questions for each value.
Answer y to run the setup script.
The system runs the setup script and notifies you of the completion:

atmd_setupdb successfully completed!

Log in to your system.
Bring up your window manager.
Open an xterm window.
Become the superuser by entering the following command:

% su root

Enter the following command to start the AtmDirector daemons:

# /opt/CSCOatmd/etc/atmd_startup

Note If you installed AtmDirector in a directory other than CSCOatmd, enter that directory name.

Exit from your system to become a regular user.
Change directory by entering the following command:

% cd /opt/CSCOatmd/bin

Note If you installed AtmDirector in a directory other than CSCOatmd, enter that directory name.

Enter the following command to start AtmDirector:

% atmdirector

The system displays the AtmDirector main window. Select Options>Global Options and fill in the seed IP Address to start Discovery. For further information, refer to the AtmDirector Getting Started Guide and the online help that ships with the product.

Note Installation log files are located in the /opt/CSCOatmd/data/log directory.

Table of Contents