cc/td/doc/product/access/ap/apm/cam_31
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Cisco Access Manager
Install the Software
Configure the Netscape FastTrack Server and Install Additional Instances of Netscape Navigator (Optional)
Backing Up the CAM Installation
Removing CAM Software
Additional Documentation

Cisco Access Manager

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.

System Requirements

To install CAM, you must have the following:

Install the Software

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 Packages and Remote or Local Database Installation

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.

Perform Preinstallation Tasks

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:


Note CAM requires that a
device account and a CAM Administrator account and password be registered with the AAA server. The default username is CAMadmin.

CAM installation includes Netscape FastTrack web server software. The Netscape Navigator FastTrack Web Server (httpd) port number is 80. The Netscape FastTrack Admin Server port number is 8887. (Make sure that ports 80 and 8887 are available for the Netscape FastTrack Server. Refer to the Netscape online help for instructions.)

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.

Software Installation Procedure

To install CAM software:

    1. "Mount the CD-ROM"

    2. "Install the CSCOcamdb Oracle Database"

    3. "Create an Additional CAM Database Instance (Optional)"

    4. "Install the CSCOcam Executables"


Note See the sections "System Requirements" and "Perform Preinstallation Tasks" before beginning the CAM installation.

Note Refer to the release notes that accompanied your software if you receive unexpected warning messages or otherwise need to troubleshoot this procedure.

After the installation, continue with the "Configure the Netscape FastTrack Server and Install Additional Instances of Netscape Navigator (Optional)" section.

Mount the CD-ROM

    1. Log in as root.

#su
 

    2. Place the CAM CD-ROM in your CD-ROM drive and mount the drive.

# mount -F hsfs -r /dev/dsk/cddevice /cdpath
 

Install the CSCOcamdb Oracle Database

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
 
# cd /cdrom/cdrom0
# ./camdb_pkgadd
 

    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]
       
      

    3. Enter the base directory for the CSCOcamdb installation:

      Enter the Base Directory for CSCOcamdb installation ? [/opt]
       
      

    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]
       
      

    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] 
       
      

    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. $ORACLE_BASE should reside on a file system with 2GB of available disk space.

      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.
      

    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.

Create an Additional CAM Database Instance (Optional)

    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
      

Install the CSCOcam Executables

To install the CSCOcam package:

    1. Run the cam_pkgadd script to install the CSCOcam software:

      # cd /device
      # ./cam_pkgadd
       
      

    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]

    4. For remote Oracle database installations only, enter the installed location of the Oracle software:

      Please enter Oracle Home location? [$ORACLE_HOME]
      

    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
       
      

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.


Note Netscape Navigator is installed on the CSCOcam server during the installation of the CSCOcam package. If you need to install Netscape Communicator on additional UNIX or Windows machines, use the installation executables listed in the following table of file locations. Refer to Netscape's documentation, available on the World Wide Web at http://www.netscape.com, for further instructions.

File Locations

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

Web Access

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:


Note You might need to provide the full domain name for your environment instead of just the host name. For example, cam_server_name.your_company.com in place of cam_server_name.

Web Security

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.

Changing Netscape FastTrack Admin Server Port, User ID, and Password


Note By default, only browsers supporting JavaScript and running on the CAM workstation can access the Netscape FastTrack Admin Server. A suitable browser is installed with the package at /opt/CSCOcam/navigator-v405/netscape.

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.

Backing Up the CAM Installation

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

CSCOcam

1 .Shut down CAM processes. As the root user, enter the following:

# /opt/CSCOcam/admin/CAM_shutdown

2 .Back up the CAM directory.

# /opt/CSCOcam 

CSCOcamdb

1 .Shut down the CAM Oracle database. As the Oracle user, enter the following:

% 
/opt/CSCOcamdb/oracle/admin/database_stop.s
h

 

2 .Back up the CAM directory and database files.

% /opt/CSCOcamdb

% $ORACLE_HOME/dbs/init $ORACLE_SID.oraCAM

% $ORACLE_BASE/oradata

% $ORACLE_BASE admin 

Removing CAM Software

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".


Note These procedures only remove files and directories in the CAM_DBPATH database directory. If you split the database into multiple directories (for example, if you added tablespace files in a different directory than the one you configured as the location of your CAM Oracle database), you will have to remove the other files and directories manually.

Remove CSCOcam Executables

To remove the CSCOcam package:

    1. As root, enter the following to remove the CAM product package:

      # cd /device
      # ./cam_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
       
      

Remove Any Additional CAM Database Instances

    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
      

Remove the CSCOcamdb Files and the Primary Database Instance

    1. As root, enter the following to remove the CAM product package:

      # cd /device
      # ./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.

Additional Documentation

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.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jun 9 12:15:34 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.