|
|
The Cisco AccessPath Integrated Access System is a scalable, high-density dial system designed to terminate a large number of mixed digital and analog calls. Cisco AccessPath Manager (APM) provides management functions for your Cisco AccessPath system.
This chapter describes the procedures for installing and removing APM and configuring the Netscape FastTrack Server software. You can install the APM software before or after you install the AccessPath hardware. If you use APM to configure your AccessPath system, you may not need to use the software configuration guide that shipped with your AccessPath hardware.
Topics covered in this chapter include:
To install APM, you must have:
For information on approximate disk space requirements for upgrades from previous versions of APM, see Table 1-1.
| APM Release | Maximum Number of Ports | Disk Space | Upgrade Space | DATA Tablespace | INDEX Tablespace |
|---|---|---|---|---|---|
This section describes first-time installation of APM on local or remote workstations. If you are upgrading from a previous release of APM, refer to the instructions in the section "Software Upgrade Procedure."
There are two ways that you can install APM:
Prior to installing APM, the Oracle database and the optional HP OpenView software (if you will be using it) must be installed and running. To install these products, refer to your Oracle database and HP OpenView documentation and Appendix A, "Oracle Installation Guidelines."
During the APM installation, you will need to know:
Note APM requires a clean UNIX login account for the APM
Administrator. It is recommended that, before starting the installation, you create a new,
dedicated account that has no startup files (that is, .cshrc or .profile). Additionally, for APM
to operate correctly, the APM Administrator account and password
must be registered with the AAA server. Both the APM Administrator and the Oracle user
require rights to run cron jobs. The default username is APMadmin.
The Netscape Navigator port number is 80. The Netscape FastTrack web server port
number is 8887. (If another web server is using this port number, change it so that this web
server can use 8887. Refer to the Netscape online help for instructions.)
The APM installation process will install and run a copy of the Netscape FastTrack web server. Prior to installing APM, you must shut down any web server that is currently installed on the APM workstation.
To install APM software, take the following steps. Refer to the release notes that accompanied your software if you receive unexpected warning messages or otherwise need to troubleshoot this procedure.
Note Oracle Enterprise Server 7.3.3 must be installed and running for the installation of APM software to be successful.
Step 2 Place the APM 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 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:
Step 3 Enter the pkgadd command to load APM software:
where device is the device name of the CD-ROM drive.
The optional -a none parameter allows you to install APM in a location other than the default (/opt/CSCOapm); a link (/opt/CSCOapm) to the actual location will be created automatically.
After a few moments, you are prompted for information regarding your particular environment.
Step 4 Select the number of the package you want to install from the list.
Step 5 You will be reminded of the disk space required for automatic configuration of the table space required for the APM database to support 1000- or 8400-port AccessPath systems.
Note If you are using CSCOapmdb to install APM on a remote workstation, you will also be reminded that your Oracle database administrator will have to guide you through the configuration of Oracle's SQL*NET after the APM installation has been completed.
Step 6 If you answered y to have the APM installation script automatically configure your APM Oracle database, you will be prompted to choose the size of your database.
Note In the following steps, default values are displayed in square brackets [ ]. To accept the default values, press Enter.
Step 7 Enter the installed location of Oracle.
where $ORACLE_HOME is the Oracle home directory.
For example: /mount/app/oracle/product/7.3.3
Oracle must be installed before APM can be installed. If Oracle is not installed, quit the installation process with Ctrl-C and install Oracle before continuing.
Step 8 Enter the Oracle username.
Step 9 Enter the Oracle group name.
Step 10 Enter the location of the APM database directory.
where $ORACLE_HOME is the Oracle home directory.
Step 11 Enter the APM database username.
Step 12 Enter the APM database user password.
Depending on which installation (local or remote) you are performing, proceed as follows:
Step 13 Enter the APM Administrator login name created prior to starting the APM software installation.
Note APM requires a clean UNIX login account for the APM Administrator. We recommend that you create a new, dedicated account that has no startup files (that is, .cshrc or .profile). Additionally, for APM to operate correctly, the APM Administrator account must be registered with the AAA server using this password. Both the APM Administrator and the Oracle user require rights to run cron jobs.
Step 14 Add the APM Administrator account to the local /etc/passwd directory.
Step 15 Enter the APM Administrator login password. The default is changeme. Change the default password to a password of your choice.
Step 16 Enter the APM Administrator AAA shelf login password. The default is changeme. Change the default password to a password of your choice.
Step 17 Indicate whether you want to install HP OpenView integration.
Note HP OpenView integration can be performed manually after installation. To manually integrate HP OpenView, as the root user, enter /opt/CSCOapm/etc/updateHPOV.sh.
Note HP OpenView daemons must be running for successful integration. To verify the daemons are running, enter /opt/OV/bin/ovstatus in a separate window. To start HP OpenView, enter /opt/OV/bin/ovstart in a separate window.
Step 18 If you answered y to HP OpenView integration, you will be prompted to enter the directory location for HP OpenView.
Step 19 A summary of your selection settings will appear. Review these settings. Enter y if the selections are acceptable; n if any of them are unacceptable.
If you answer n, the installation process will be repeated and you may make any necessary corrections.
Following this package-specific section, the installation will continue processing and may ask additional workstation-specific questions. If you used the [-a none] parameter to install APM in an alternate directory, enter the path of this directory when prompted to do so. If this directory does not already exist, the installation script will ask you if you want the directory to be created.
The installation process now installs APM onto your workstation. No additional APM-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, the Oracle APM database and schema will be created, HP OpenView integration will occur (if you requested it), and the Netscape FastTrack web server will be configured and started.
The installation takes 10 to 15 minutes. When the installation of APM is complete, continue with the section "Netscape FastTrack Configuration".
You can upgrade APM 1.x installations to APM 2.0 software using this procedure. This upgrade preserves all of the APM stack configurations, any FastTrack web server settings, and the Oracle APM database files and settings.
This section describes the upgrade procedure for APM executables and (optionally) the APM Oracle database on local workstations using the CSCOapm command and installing the APM Oracle database on remote workstations using the CSCOapmdb command.
Note In this procedure, the path to the APM Oracle database is assumed to be $ORACLE_HOME/dbs. If you installed the APM Oracle database in a different directory, substitute that directory.
We strongly recommend that you back up your existing APM installation prior to upgrading. You should back up both the APM filesystem and the Oracle database files. Follow the appropriate procedure, local or remote.
| Type | Procedure |
|---|---|
To upgrade APM software, take the following steps.
Note APM 1.0 or APM 1.1 must be installed and functional for the upgrade of APM software to be successful. Any installed web servers must not be running. All database clients (SQL sessions) should be shut down prior to beginning the following procedures.
where $ORACLEHOME/dbs/APMDB is the location of your APM Oracle database.
The disk space requirements for upgrades are as follows:
Step 2 Place the APM 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 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 as root to manually mount the CD-ROM:
Step 3 Enter the pkgadd command to load APM software:
If you are upgrading from APM 1.0, you will be reminded that the upgrade will erase all historical data and told to run and save reports on any data you want to keep a record of.
Step 4 Enter y if you want to continue with the upgrade.
You will be reminded to back up APM and given the steps to do this backup.
Step 5 If a backup of the APM data has been performed, enter y. (If you enter n, the upgrade procedure will quit so that you can perform the recommended backup.)
Step 6 For remote database upgrades, you must supply some additional information:
A summary of the selection settings will appear.
Step 7 Review these settings and, if the selections are acceptable, enter y, if they are unacceptable, enter n. (If you answer n, the installation process will quit and you must run it again to make any necessary corrections.)
Step 8 Enter y when the installation script warns you that it will execute scripts with superuser privilege during the installation.
where package is either CSCOapm (local) or CSCOapmdb (remote), depending on your previous installation.
You will be told how much additional disk space will be required for this upgrade.
Step 9 Decide whether or not to upgrade the APM Oracle database tablespaces:
The upgrade of APM is complete. Continue with the next section, "Netscape FastTrack Configuration."
This section describes how to configure the included Netscape FastTrack web server to support login authentication to the APM server. By default, there is no list of valid users for the APM server. Configuring the FastTrack web server allows you to specify the users and groups who may access the APM server.
Netscape FastTrack is the web server included with and used by default with APM. Normal APM interaction requires only a Java-enabled web browser. However, if you want to customize FastTrack, you will need a Javascript-enabled browser.
APM includes the Netscape Navigator for Solaris browser that has both Java and Javascript capabilities enabled.
The following are key file locations for FastTrack:
Netscape FastTrack has two servers that are important for APM:
By default, only the APM server will be allowed to access the FastTrack Admin Server. For information on allowing other hosts access to the 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 APM machine name is apm_server_name, you would use the following URLs for access:
Note You may need to provide the full domain name for your environment instead of just the host name. For example, apm_server_name.your_company.com in place of apm_server_name.
Using the FastTrack Admin Server, several web security measures can be used. The following are recommended for APM web security:
Note By default, only browsers supporting Javascript and running on the APM workstation can access the FastTrack Admin Server. A suitable browser is installed with the package at /opt/CSCOapm/browser/netscape.
To change the APM default settings for the FastTrack Admin Server, take these steps:
Step 2 Click Configure Administration.
Step 3 Select Daemon Configuration.
Step 4 Change the 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. Select 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 FastTrack Admin Server. As root, enter:
This completes the procedure for editing the APM default settings for the FastTrack Admin Server. Continue with the next section, "Enabling Netscape FastTrack Web Server Access Control."
Take the following steps to enable web security for APM monitoring or APM configuration screens:
Step 2 Select the workstation name in the Netscape FastTrack Server area (next to the ON/OFF switch).
If you receive a "Manual edits not loaded" error when you initially attempt to enable access control:
(a). Click OK in the warning dialog.
(b). Click Apply in the upper right corner.
Step 3 Click Access Control in the top frame.
Step 4 Select Manage User Databases in the left frame.
Step 5 Create a new database (for example, APM_default) by entering a name in the New Database field. Click Create New Database.
Step 6 Create a new group (for example, APM_config) in your database. Select Create Group in the left frame and enter a new name in the New Group field.
Step 7 Create as many users as you want, preferably some in the APM_config group and others with no group assignment at all.
(a). Select Create User in the left frame.
(b). Use the Group drop-down menu to specify a group assignment or none.
Step 8 Configure security for the APM monitor screens. Click Browse and move to the /opt/CSCOapm/ns-home/docs/apm/monitor directory.
Step 9 Set access controls for this function.
(a). Click Turn on Access Control.
(b). Select Deny for the read access type.
(d). Select the APM_default database.
(e). Select Allow Everyone in this User Database. Click Done.
Step 10 Configure security for the APM report screens. Click Browse and move to the /opt/CSCOapm/ns-home/docs/apm/reports directory. Repeat Step 9.
Step 11 Configure security for the APM configuration screens. Click Browse and move to the /opt/CSCOapm/ns-home/docs/apm/config directory.
Step 12 Set access controls for this function.
(a). Click Turn on Access Control.
(b). Select Deny for the read access type.
(d). From User Allowed Access at Specified Hosts, select the APM_default database.
(e). Select Allow These Users and Groups.
(f). Enter APM_config into the Groups text field. Click Done.
Step 13 Configure security for the APM home page. Click Browse and move to the /opt/CSCOapm/ns-home/docs/apm/mcc directory. Repeat Step 12.
Step 14 Configure security for the APM results directory. Click Browse and move to the /opt/CSCOapm/ns-home/docs/apm/results directory. Repeat Step 12. Click OK. (In some cases, you may need to click Save and Apply, and then click OK to make the changes effective.)
This completes the procedure for enabling web security for APM monitoring or APM configuration screens. Continue with the next section, "Using Customized Web Security Failure Messages."
Take the following steps to use the customized web security failure messages (provided you have enabled FastTrack web server access control in the previous section).
Step 2 Select the workstation name in the Netscape FastTrack Server area (next to the ON/OFF switch).
Step 3 Customize the configuration error messages.
(a). Click System Settings in the top region.
(b). Click Error Responses in the left region.
(c). Click Editing in the Unauthorized message area.
(d). Click Editing in the Forbidden message area.
(e). Click Editing in the Not Found message area.
(g). Enter /opt/CSCOapm/www/docs/config_fail.html.
(h). Click OK. Click Save and Apply. Click OK in the alert dialog box.
Step 4 Customize the configuration error messages that appear on the APM home page.
(a). Click Editing in the Unauthorized message area. Select mcc.
(b). Enter /opt/CSCOapm/www/docs/config_fail.html.
(c). Click OK. Click Save and Apply. Click OK in the alert dialog box.
Step 5 Customize the monitor error messages.
(a). Click Editing in the Unauthorized message area. Select monitor.
(b). Enter /opt/CSCOapm/www/docs/monitor_fail.html.
(c). Click OK. Click Save and Apply. Click OK in the alert dialog box.
Step 6 Customize the monitor error messages that appear in reports.
(a). Click Editing in the Unauthorized message area. Select reports.
(b). Enter /opt/CSCOapm/www/docs/monitor_fail.html.
(c). Click OK. Click Save and Apply. Click OK in the alert dialog box.
This completes the procedure for using customized web security failure messages.
Note Netscape FastTrack is the web server included with and used by default with APM. To customize FastTrack, you will need a Java- and Javascript-enabled browser.
Take the following steps to disable web security for monitoring, configuration, report, and APM home page screens:
Step 2 Select the server name (next to the ON/OFF switch).
Step 3 Prepare to turn off access control.
Step 4 Turn off access control for the monitor screens.
(a). Select /opt/CSCOapm/ns-home/docs/apm/monitor under Editing.
(b). Click Turn off Access Control. Click OK. Click Save and Apply.
Step 5 Turn off access control for the configuration screens.
(a). Select /opt/CSCOapm/ns-home/docs/apm/configuration under Editing.
(b). Click Turn off Access Control. Click OK. Click Save and Apply.
Step 6 Turn off access control for the report screens.
(a). Select /opt/CSCOapm/ns-home/docs/apm/report under Editing.
(b). Click Turn off Access Control. Click OK. Click Save and Apply.
Step 7 Turn off access control for the APM home page.
(a). Select /opt/CSCOapm/ns-home/docs/apm/mcc under Editing.
(b). Click Turn off Access Control. Click OK. Click Save and Apply.
This completes the procedure for disabling Netscape FastTrack web server security.
The following sections describe the procedures for removing the APM software packages.
Note These procedures only remove files and directories in the APM_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 APM Oracle database), you will have to remove the other files and directories manually.
Take the following steps to remove the CSCOapm package.
Note In this procedure, the path to the APM Oracle database is assumed to be $ORACLE_HOME/dbs. If you installed APM in a different directory, substitute that directory.
The pkgrm command automatically performs the following tasks:
Step 2 If you are sure you want to remove the CSCOapm package, enter y.
Step 3 You will be reminded that this uninstallation will execute scripts with superuser permissions. If you still want to remove APM, enter y.
Step 4 After removing the APM software package, some files will still remain. Files remaining include the files in the dir/data/ directory (where dir is the APM home directory), and in the $ORACLE_HOME/dbs directory.
To remove these files, as the root user, enter the following command:
Take the following steps to remove the CSCOapmdb package:
Step 2 If you are sure you want to remove the CSCOapm package, enter y.
Step 3 You will be reminded that this uninstallation will execute scripts with superuser permissions. If you still want to remove APM, enter y.
Step 4 After removing the APM software package, some files will still remain. Files remaining include the files in the dir/data/ directory (where dir is the APM home directory), and in the $ORACLE_HOME/dbs directory.
To remove these files, as the root user, enter the following command:
This completes the procedure for removing APM. If you need additional documentation, refer to the next section, "Additional Documentation."
Cisco documentation and additional literature are available on a CD-ROM, 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 is available as a single item 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.
Posted: Fri Jan 24 18:06:39 PST 2003
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.