|
|
The Cisco AccessPath Integrated Access System and the Cisco AS5800 Universal Access Server are scalable, high-density dial systems designed to terminate a large number of mixed digital and analog calls. Cisco Access Manager (CAM) provides configuration and management functions for your Cisco AS5800 or Cisco AccessPath system.
This chapter describes the procedures for installing and removing CAM and configuring the Netscape FastTrack web server software. You can install the CAM software before or after you install your hardware.
 | TimeSaver If you use CAM to configure your Cisco AccessPath system or Cisco AS5800, you might not need to use the software configuration guide that shipped with your hardware. |
Topics covered in this chapter include:
To install CAM, you must have the following:
| Number of Ports CAM Will Support | System | Number of CPUs | RAM | CPU Speed | Disk Space | Swap Space | Oracle Database Tablespace |
|---|---|---|---|---|---|---|---|
12,000 | Ultra 60 | 2 | 512 MB | 360 MHz | 8 GB | 512 MB | 3.9 GB |
This section describes first-time installation of CAM on local or remote workstations.
CAM installation involves two packages:
| Package | Requirements/Description | To install | To Remove | ||||
|---|---|---|---|---|---|---|---|
Must be installed on the same machine as the Oracle server software.
| Run camdb_pkgadd | Run camdb_pkgrm | |||||
Before you can install the CSCOcam package, the CAM database (CSCOcamdb) must be installed and the database instance must be up and running.
| Run cam_pkgadd | Run cam_pkgrm |
CAM can be set up in one of two ways:
In either case, however, the CAM database instance can serve only one CAM system, locally or remotely.
Prior to installing CAM, the Oracle database must be installed and running. To install Oracle, refer to your Oracle database documentation and Appendix A, "Installing Oracle Software."
During the CAM installation, you will need to know the following information:
The CAM installation process will install and run a copy of the Netscape FastTrack web server. Prior to installing CAM, you must shut down any other web server that is already installed on the CAM workstation.
To install CAM software:
After the installation, continue with the "Configure the Netscape FastTrack Server and Install Additional Instances of Netscape Navigator (Optional)" section.
Step 1 Log in as root.
Step 2 Place the CAM CD-ROM in your CD-ROM drive and mount the drive.
CD-ROM mount policies vary with different systems. In some systems, the CD-ROM is automounted or managed by the Solaris void process. In such cases, you will have a standard mount point for the CD-ROM such as /cdrom/cdrom0.
If your CD-ROM is not automounted, enter the following command to manually mount the CD-ROM:
where:
If you will be installing the CSCOcamdb database on the same machine as the CSCOcam executables, Cisco recommends that you run camdb_pkgadd first.
Step 1 Run the camdb_pkgadd script to create the CSCOcamdb database:
where device is the device name of the CD-ROM drive.
The script will allow you to install CAM in a location other than the default location (/opt/CSCOcam). A symbolic link (/opt/CSCOcam) to the actual location will be created automatically.
For example:
You can terminate the script by typing Ctrl-c.
Step 2 Verify that the package is being installed on the machine where the Oracle server software is installed:
Step 3 Verify that you have the disk space required for automatic configuration of the tablespace required for the CAM database to support 1000-, 10,000-, or 15,000-port networks:
For instructions on manual database installation, refer to the file /opt/CSCOcamdb/README.database.
By default, the installation will automatically configure the
Cisco Access Manager Oracle database. Automatic configuration
creates the needed table space sufficient to support:
1,000 port Cisco Access Manager system (requiring 1GB of disk space)
10,000 port Cisco Access Manager system (requiring 2.9GB of disk space)
15,000 port Cisco Access Manager system (requiring 3.9GB of disk space) If your Oracle server and Cisco Access Manager will run on different machines, you must configure the Oracle server as a remote database server. Remote Oracle database for Cisco Access Manager support is divided into two sections: setting up the database and configuring SQL*NET. This installation will cover the section of setting up the database. Manually configuration SQL*NET for both the local and remote workstations is needed. Contact your Oracle administrator for site-specific information on configuring SQL*NET. For more information on manual database configuration, refer to /opt/CSCOcamdb/README.database. Proceed with Automatic configuration of Cisco Access Manager Database (y/n)? [y]
Step 4 Choose the size of your database:
Step 5 Enter the installed location of the Oracle software:
where $ORACLE_HOME is the Oracle home directory.
For example: /oracle/db/product/7.3.4
Oracle must be installed before CAM can be installed. If Oracle is not installed, quit the installation process with Ctrl-c, and install Oracle before continuing.
Step 6 Enter the Oracle username:
Step 7 Enter the Oracle group name:
Step 8 Enter the Oracle database instance name:
Step 9 Enter the location of the CAM database directory (ORACLE_BASE). (By default, database administration scripts will be placed in $ORACLE_BASE/admin/CAMDB, and data files will be placed in $ORACLE_BASE/oradata/CAMDB.)
Step 10 Enter the CAM system user password:
Step 11 Enter the CAM database username:
Step 12 Enter the CAM database user password:
Step 13 A summary of your selection settings will appear. Review these settings and enter one of the following:
Step 14 Enter the path of the CSCOcamdb package base directory. (If this directory does not already exist, the installation script will ask you if you want the directory to be created.) Confirm the creation of the CSCOcamdb base directory:
Step 15 Confirm that the package can perform scripts requiring superuser privileges:
The installation process now installs the CSCOcamdb database on your workstation. No additional CAM-specific intervention should be required for the package installation and configuration to complete.
During the final steps of the installation process, file ownerships and permissions will be set, and the Oracle CAM database will be created and started up. The installation takes 10 to 20 minutes.
If you will run Cisco Access Manager on a machine other than the one on which you have installed the CSCOcamdb Oracle database, you will need to manually configure SQL*NET for both the local and remote workstations. Contact your Oracle administrator for site-specific information on configuring SQL*NET. In addition, you will need to restart the listener for the new CAMDB database instance.
Step 1 Make sure that /etc/system has been modified to accommodate for the new database that you will be adding. (If you modify /etc/system, you must reboot the system after you make this modification.)
Step 2 Log in as the Oracle user:
Step 3 Change to the /opt/CSCOcamdb/db/admin directory:
Step 4 Run the add_dbinstance.sh command:
Step 5 Enter the Oracle user password, or press Return to accept the default in square brackets [ ]:
Step 6 Enter the name of the Oracle database instance you would like to create:
Step 7 Enter the Oracle base location, or press Return to accept the default in square brackets [ ]:
Step 8 Enter the database instance size (1k, 10k, or 15k):
Step 9 Enter the Oracle username and password:
Step 10 A summary of your selection settings will appear. Review these settings.
To install the CSCOcam package:
Step 1 Run the cam_pkgadd script to install the CSCOcam software:
where device is the device name of the CD-ROM drive.
The script will allow you to install CAM in a location other than the default location (/opt/CSCOcam). A symbolic link (/opt/CSCOcam) to the actual location will be created automatically.
For example:
You can terminate the script by typing Ctrl-c.
Step 2 Specify whether CSCOcam will be using a local or a remote database. (Distributed databases where part of the database is on another machine are considered remote databases.)
Continue as follows:
Step 3 For remote Oracle database installations only. Enter the installed location of the Oracle software:
where $ORACLE_HOME is the Oracle home directory.
For example: /oracle/db/product/7.3.4
Oracle must be installed before CAM can be installed. If Oracle is not installed, quit the installation process with Ctrl-c, and install Oracle before continuing.
Step 4 Enter the remote Oracle database alias. This alias must match the alias configured for the remote database in the /var/opt/oracle/tnsnames.ora file:
Step 5 Indicate whether you want to retain the data in the CAM database. (If this is a new installation, you must answer n.)
Continue as follows:
Step 6 Enter the Oracle database user name and password:
Step 7 Enter the tftpd root directory:
Step 8 Enter the device username (required by the AAA server):
Step 9 Enter the device password (registered with the AAA server):
Step 10 Enter the password for the CAM administrator:
Step 11 A summary of your selection settings will appear. Review these settings and enter one of the following:
Step 12 Enter the path of the CSCOcam base directory. If this directory does not exist, the installation script will ask you if you want the directory to be created. Confirm the creation of the CSCOcam directory:
Step 13 Confirm that the package can perform scripts requiring superuser privileges:
The installation process now installs the CSCOcam executables on your workstation. No additional CAM-specific intervention should be required for the package installation and configuration to complete.
During the final steps of the installation process, file ownerships and permissions will be set, and the Netscape FastTrack web server will be configured and started. The installation takes 10 to 20 minutes.
When the installation of CAM is complete, you can change Netscape FastTrack configuration items, such as the Admin password. For instructions, see the next section, "Configure the Netscape FastTrack Server and Install Additional Instances of Netscape Navigator (Optional)."
Normal CAM interaction requires only a Java-enabled web browser. However, to customize the Netscape FastTrack Server, you will need a Javascript-enabled browser. CAM includes the Netscape Navigator for Solaris browser that has both Java and Javascript capabilities enabled.
The following are key file locations used by Netscape FastTrack Server software:
| Software | Directory Location |
|---|---|
CAM | /opt/CSCOcam |
Netscape FastTrack web server | /opt/CSCOcam/ns-home |
Netscape Navigator installation executables: ---UNIX ---Windows 95 or Windows NT |
/opt/CSCOcam/navigator-v405/netscape /opt/CSCOcam/win/cp32e405.exe |
Netscape FastTrack Server software includes two servers that are important for CAM:
By default, both of these servers are started during installation and the workstation boot procedure.
By default, only the CAM server will be allowed to access the Netscape FastTrack Admin Server. For information on allowing other hosts access to the Netscape FastTrack Admin Server, see the Netscape online documentation on editing the ns-admin.conf file.
For example, if your CAM machine name is cam_server_name, you would use the following URLs for access:
Using the Netscape FastTrack Admin Server, several web security measures can be used. The following are recommended for CAM web security:
The procedure for making these changes is described in the following section.
To change the CAM default settings for the Netscape FastTrack Admin Server:
Step 1 Open http://cam_server_name:8887 with a Javascript-enabled browser, where cam_server_name is the name of your CAM server. Enter a user ID of admin and a password of CAM in the password dialog box.
Step 2 Click Configure Administration.
Step 3 Select Daemon Configuration.
Step 4 Change the Netscape FastTrack Admin Server port from 8887 to an unused port number of your choice. Click OK.
Step 5 Select Return to Administrative Configuration.
Step 6 Select Access Control.
Step 7 Change the authentication username and password. Click OK.
Step 8 Click Shut it down. Click OK in the Authorization Failed Retry dialog box.
Step 9 Enter your new username and password in the Authentication dialog box.
Step 10 Click Shutdown the Administrative Server.
Step 11 Restart the Netscape FastTrack Admin Server. As root, enter the following:
This completes the procedure for editing the CAM default settings for the Netscape FastTrack Admin Server.
To back up your CAM installation, back up both the CAM filesystem and the Oracle database files. Follow the appropriate procedure: local or remote.
| Type | Procedure | ||||
|---|---|---|---|---|---|
# /tmp/CAM_shutdown
# /opt/CSCOcam # /usr1/app/oracle/product/7.3.4/dbs/initCAMDB.ora # /usr1/app/oracle/product/7.3.4/dbs/CAM_dump # /usr1/app/oracle/product/7.3.4/dbs/CAMDB | |||||
% /opt/CSCOcamdb/oracle/admin/database_stop.sh
% /opt/CSCOcamdb % /usr1/app/oracle/product/7.3.4/dbs/initCAMDB.ora/usr1/app/oracle/product/7.3.4/ dbs/CAM_dump % /usr1/app/oracle/product/7.3.4/dbs/CAMDB | |||||
To remove the CAM software:
2. Remove Any Additional CAM Database Instances
3. Remove the CSCOcamdb Files and the Primary Database Instance
To remove the CSCOcam package:
Step 1 As root, enter the following to remove the CAM product package:
where device is the device name of the CD-ROM drive.
For example:
The cam_pkgrm command automatically does the following:
Step 2 If you are sure you want to remove the CSCOcam package, enter y:
Step 3 You will be reminded that this uninstallation will execute scripts with superuser permissions. If you still want to remove CAM, enter y:
Step 1 Log in as the oracle user:
Step 2 Change to the /opt/CSCOcamdb/db/admin directory:
Step 3 Run the remove_dbinstance.sh script:
Step 4 Enter the name of the Oracle instance you want to remove:
Step 5 Enter the Oracle base directory for the instance you want to remove, or press Return to accept the default in square brackets [ ]:
Step 6 Confirm that you want to remove this database instance:
Step 1 As root, enter the following to remove the CAM product package:
where device is the device name of the CD-ROM drive.
For example:
Step 2 If you are sure you want to remove the CSCOcam package, enter y:
Step 3 You will be reminded that this uninstallation will execute scripts with superuser permissions. If you still want to remove CAM, enter y:
Step 4 After removing the CAM database files, the primary CAM database instance will remain. To remove these files, as the root user, enter the following:
This completes the procedure for removing CAM.
If you need additional documentation, see the "Related and Referenced Documents" section.
|
|