|
|
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 AccessPath or Cisco AS5800 system.
This booklet describes the procedures for installing and removing CAM and configuring the Netscape FastTrack Server software. You can install the CAM software before or after you install your hardware. If you use CAM to configure your Cisco AccessPath system or Cisco AS5800, you may not need to use the software configuration guide that shipped with your hardware.
If you need additional documentation, refer to the document Cisco Access Manager Software Installation and Configuration Guide, which shipped with CAM in hard copy form. You can also access it electronically on the Cisco Documentation CD-ROM or on Cisco Connection Online (CCO). See the section "Additional Documentation" for more information.
To install CAM, you must have the following:
| System | CPUs | RAM | CPU Speed | Disk Space | Swap Space | Oracle Software and CAM Database Tablespace |
|---|---|---|---|---|---|---|
Ultra-60 | 2 | 1 GB | 360 MHz | 4 GB | 512 MB | 4 GB |
This section describes first-time installation of CAM 3.1 on local or remote workstations. For instructions on upgrading CAM 3.0 or Cisco AccessPath Manager (APM) 2.0 to CAM 3.1, refer to the Update to Cisco Access Manager Software Installation and Configuration Guide document packaged with CAM 3.1.
CAM installation involves two packages:
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" in the Cisco Access Manager Software Installation and Configuration Guide.
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 web server that is already installed on the CAM workstation.
To install CAM software:
2. "Install the CSCOcamdb Oracle Database"
After the installation, continue with the "Configure the Netscape FastTrack Server and Install Additional Instances of Netscape Navigator (Optional)" section.
1. Log in as root.
#su
CD-ROM mount policies vary with different systems. In some systems, the CD-ROM is automounted or managed by the Solaris vold 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:
# mount -F hsfs -r /dev/dsk/cddevice /cdpath
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.
1. Run the camdb_pkgadd script to create the CSCOcamdb database:
# cd /device # ./camdb_pkgadd
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:
# cd /cdrom/cdrom0 # ./camdb_pkgadd
You can terminate the script by typing Ctrl-c.
2. Verify that the package is being installed on the machine where the Oracle server software is installed, and that the server has sufficient available space:
Continue with CSCOcamdb installation? (y/n) [y]
The CSCOcamdb package requires Oracle server software on this machine.
By default, the installation will automatically configure the Cisco Access Manager Oracle database. Automatic configuration creates the needed spaces and tables, and requires 2 GB disk space to be available on a single file system. If your system does not meet this requirement or you want the table space to be spread over several file systems, DO NOT choose Automatic Configuration in step 4.
For more information on manual database configuration, refer to /opt/CSCOcamdb/README.database.
If your Oracle Server and Cisco Access Manager will run on different machines, you need to configure the Oracle server as a remote database server. Remote Oracle database setup for Cisco Access Manager is divided into two phases: Database setup and SQL*NET configuration. This installation will setup the database. SQL*NET has to be set up manually on both the local and remote workstations. Contact your Oracle Administrator for site-specific information on configuring SQL*NET.
3. Enter the base directory for the CSCOcamdb installation:
Enter the Base Directory for CSCOcamdb installation ? [/opt]
The CSCOcamdb will be installed under the directory basedir/CSCOcamdb.
4. Verify that you have the necessary 2 gigabytes of disk space required for automatic configuration of the tablespace required for the CAM database:
Auto configure Cisco AccessManager Database (y/n)? [y]
5. Enter the installed location of the Oracle software:
Please enter Oracle Home location? [$ORACLE_HOME]
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.
6. Enter the Oracle username:
Please enter Oracle user name? [oracle]
7. Enter the Oracle group name:
Please enter Oracle group name? [dba]
8. Enter the Oracle database instance name:
Please enter Oracle DB instance name: ? [CAMDB]
Please enter Oracle Base location ? [/oracle/db]
10. Enter the Oracle system user password:
Please enter Oracle default 'system' user password: ? [manager]
11. Enter the CAM database username:
Please enter CAM DB user name? [cam]
12. Enter the CAM database user password:
Please enter CAM DB user password? [cam]
13. A summary of your selection settings will appear. Review these settings and enter one of the following:
The following settings will be used: CSCOcamdb Installation Location:/opt/CSCOcamdb Oracle's Home Location: /oracle/product/7.3.4 Oracle's unix user name:oracle Group name for unix user 'oracle' :dba Automatic Database configuration:YES CAM DB Oracle SID: CAMDB CAM DB user name: cam CAM DB user password:cam CAM DB Data files' Location: /extra/oradata/CAMDB CAM DB Admin files' Location: /extra/admin/CAMDB Password for oracle user 'system':manager Are these acceptable, continue install (y/n)? y
14. If the CSCOcamdb package base 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:
The selected base directory </opt/CSCOcamdb> must exist before installation is attempted. Do you want this directory created now [y,n,?,q] y Using <opt/CSCOcamdb> as the package base directory.
If you do not confirm the directory creation, the installation script will terminate.
15. Confirm that the package can perform scripts requiring superuser privileges:
This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of <CSCOcamdb> [y,n,?] y
The installation process now installs the CSCOcamdb database on your workstation. No additional CAM-specific intervention is 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.
1. Make sure that /etc/system has been modified to accommodate the new database that you will be adding. (If you modify /etc/system, you must reboot the system after you make this modification.)
2. Become the Oracle user:
# su oracle
3. Change to the /opt/CSCOcamdb/db/admin directory:
# cd /opt/CSCOcamdb/db/admin
4. Run the add_dbinstance.sh command:
# ./add_dbinstance.sh
5. Enter the Oracle user password, or press Return to accept the default in square brackets [ ]:
Please enter Oracle default 'system' user password: ? [manager]
6. Enter the name of the Oracle database instance you would like to create:
Please enter Oracle DB instance name: ?
7. Enter the Oracle base location, or press Return to accept the default in square brackets [ ]:
By default, database admin scripts will be placed in <Oracle Base>/admin/MYDB, and data files will be placed in <Oracle Base>/oradata/MYDB. Please enter Oracle Base location ? [/oracle/db]
8. Enter the Oracle username and password:
Please enter Oracle DB user name ? Please enter Oracle DB user password ?
9. A summary of your selection settings will appear. Review these settings and enter one of the following:
CAMHOME=/opt/CSCOcamdb ORACLE_HOME=/oracle/db/product/7.3.4 ORA_SYSTEMPWD=manager ORACLE_SID=MYDB ORACLE_BASE=/oracle/db CAM_DBADMIN=/oracle/db/admin/MYDB CAM_DBDATA=/oracle/db/oradata/MYDB CAM_DBUSER=oracle CAM_DBPASSWORD=password Create a database for up to 1,000 ports Please review that the environment variables are correct and enter 'y' to continue or 'n' to enter new value (default n) y
10. Run the ApmSchema.sh script, as the root user.
# cd /opt/CSCOcamdb/db/schema # ./ApmSchema.sh APM_DBUSER APM_DBPASSWORD \ ORACLE_SID ORACLE_HOME
11. Load the default data into this additional database, from the CAM server machine that will use this database.
# cd /opt/CSCOcam/db/schema # ./ApmData.sh APM_DBUSER APM_DBPASSWORD ORACLE_SID
To install the CSCOcam package:
1. Run the cam_pkgadd script to install the CSCOcam software:
# cd /device # ./cam_pkgadd
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:
# cd /cdrom/cdrom0 # ./cam_pkgadd
You can terminate the script by typing Ctrl-c.
2. Specify whether CSCOcam will be using a local or a remote database. (Remote databases are located on a different machine than the one running CSCOcam.)
Cisco Access Manager can use either a local Oracle database or a remote Oracle database. Will Cisco Access Manager use a local Oracle database. (y/n)? [y] y
3. If you chose a local Oracle database in step 2, CSCOcam will by default install under the directory used for the CSCOcamdb installation:
CSCOcam will be installed under the directory
<base directory>/CSCOcam Enter the base directory for CSCOcam installation ? [/opt]
Continue as follows:
4. For remote Oracle database installations only, enter the installed location of the Oracle software:
Please enter Oracle Home location? [$ORACLE_HOME]
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.
5. 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:
Remote Oracle DB alias is needed for Cisco Access Manager to connect to the database and it has to match the name setup in /var/opt/oracle/tnsnames.ora in this machine. Please enter remote Oracle DB alias?
6. Enter the Oracle database username and password:
Please enter the Oracle DB user name ? [cam] Please enter the Oracle DB password ? [cam]
7. Enter the tftpd root directory:
Please enter tftpd root directory ? [/opt/CSCOcam/tftpboot]
8. Enter the device username (required by the AAA server):
Please enter the device username ? [CAMadmin]
9. Enter the device password (registered with the AAA server):
Please enter the device password ? [cam]
10. Enter the password for the CAM administrator:
Please enter the CAM admin user (CAMadmin) password ? [cam]
11. A summary of your selection settings will appear. Review these settings and enter one of the following:
The following settings will be used: CSCOcam Installation location:/opt/CSCOcam CAM Oracle Database SID (Local):CAMDB Oracle Home location: /oracle/product/7.3.4 CAM DB user name:cam CAM DB user password:cam tftpd root directory: /opt/CSCOcam/tftpboot Device login username:CAMadmin Device login password:lab CAM administrator password:cam Are these acceptable, continue install (y/n)? [y] y
12. If the CSCOcam base 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:
The selected base directory </opt/CSCOcam> must exist before installation is attempted. Do you want this directory created now [y,n,?,q] y
13. Confirm that the package can perform scripts requiring superuser privileges:
This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of <CSCOcam> [y,n,?] y
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 Administrator's password. For instructions, see the next section, "Configure the Netscape FastTrack Server and Install Additional Instances of Netscape Navigator (Optional)."
Netscape FastTrack is the web server included with CAM and is used by default. It is installed and configured during the CAM installation, however, if you want to customize its installation, use this section.
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 and 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, 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.
By default, both of these servers are started during installation and the workstation boot procedure.
For example, if your CAM machine name is cam_server_name, you would use the following URLs for access:
http://cam_server_name/cam
http://cam_server_name:8887
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, take these steps:
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.
2. Click Configure Administration.
3. Select Daemon Configuration.
4. Change the Netscape FastTrack Admin Server port from 8887 to an unused port number of your choice. Click OK.
5. Select Return to Administrative Configuration.
6. Select Access Control.
7. Change the authentication username and password. Click OK.
8. Click Shut it down. Click OK in the Authorization Failed Retry dialog box.
9. Enter your new username and password in the Authentication dialog box.
10. Click Shutdown the Administrative Server.
11. Restart the Netscape FastTrack Admin Server. As root, enter the following:
# /opt/CSCOcam/ns-home/start-admin
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 file system and the Oracle database files. Follow the appropriate procedure: CSCOcam or CSCOcamdb.
| Package | Procedure | ||||
|---|---|---|---|---|---|
# /opt/CSCOcam/admin/CAM_shutdown
# /opt/CSCOcam | |||||
% /opt/CSCOcamdb/oracle/admin/database_stop.s h
% /opt/CSCOcamdb % $ORACLE_HOME/dbs/init $ORACLE_SID.oraCAM % $ORACLE_BASE/oradata % $ORACLE_BASE admin | |||||
To remove the CAM software:
1. "Remove CSCOcam Executables".
2. "Remove Any Additional CAM Database Instances".
3. "Remove the CSCOcamdb Files and the Primary Database Instance".
To remove the CSCOcam package:
1. As root, enter the following to remove the CAM product package:
# cd /device # ./cam_pkgrm
where device is the device name of the CD-ROM drive.
For example:
# cd /cdrom/cdrom0 # ./cam_pkgrm
The cam_pkgrm command automatically does the following:
2. If you are sure you want to remove the CSCOcam package, enter y:
Do you want to remove this package? y
3. You will be reminded that this uninstallation will execute scripts with superuser permissions. If you still want to remove CAM, enter y:
This package contains scripts which will be executed with super-user permission during the process of removing this package. Do you want to continue with the removal of this package [y,n,?,q] y
1. Log in as the Oracle user:
# su oracle %
2. Change to the /opt/CSCOcamdb/db/admin directory:
% cd /opt/CSCOcamdb/db/admin
3. Run the remove_dbinstance.sh script:
% ./remove_dbinstance.sh
4. Enter the name of the Oracle instance you want to remove:
Please enter the ORACLE_SID which you want to take action: MYDB
5. Enter the Oracle base directory for the instance you want to remove, or press Return to accept the default in square brackets [ ]:
Please enter the ORACLE_BASE for MYDB:[/oracle/db]
6. Confirm that you want to remove this database instance:
Database MYDB about to be removed from server. Enter 'y' to continue or 'n' to abort removal (default n) y
1. As root, enter the following to remove the CAM product package:
# cd /device # ./camdb_pkgrm
where device is the device name of the CD-ROM drive.
For example:
# cd /cdrom/cdrom0 # ./camdb_pkgrm
2. If you are sure you want to remove the CSCOcam package, enter y:
Do you want to remove this package? y
3. You will be reminded that this uninstallation will execute scripts with superuser permissions. If you still want to remove CAM, enter y:
This package contains scripts which will be executed with super-user permission during the process of removing this package. Do you want to continue with the removal of this package? [y,n,?,q] y
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:
# /tmp/camdb_remove.sh
This completes the procedure for removing CAM.
If you need additional documentation, refer to the document Cisco Access Manager Software Installation and Configuration Guide, which shipped with CAM 3.1 in hard copy form. You can also access it electronically on the Cisco Documentation CD-ROM or on Cisco Connection Online (CCO). See the section "Additional Documentation" for more information.
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more up to date than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.
The Cisco Access Manager Software Installation and Configuration Guide is available on the Web at http://www.cisco.com/univercd/cc/td/ doc/product/access/ap/apm/cam_31/sw_gd/index.htm.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Wed Jun 9 12:15:34 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.