|
|
This chapter provides the following sections to enable Cisco Enterprise Accounting (CEA) installation:
This section describes the Cisco Enterprise Accounting (CEA) software, hardware, and network requirements.
You must install the following software in order to run CEA:
If SunNet Manager 2.2.2 is used, CEA requires that patches 101953-0, 102469-0, and 102747-0 are installed in the SunNet Manager home directory. These patches are contained in the files 101953-0.tar.Z, 102469-0.tar.Z, and 102747-0.tar.Z and can be obtained via anonymous FTP to zippy.telcom.arizona.edu in the /pub/snm/patches/SunOS4.1.x/ SNM2.2.x directory. Instructions for installing the patches are contained in the files101953-0.readme, 102469-0.readme, and 102747-0.readme, available at the same location.
Each Cisco ISDN router must run Cisco IOS 11.0(7) or later to support the Cisco-call-history MIB required for CEA.
Refer to the Cisco Enterprise Accounting Release Notes (on Cisco Connection Online or the Cisco Connection Documentation CD) for details on routers and Cisco IOS version information.
The minimum hardware requirements for running CEA include the following:
The Sun SPARC workstation used as the data collection engine should be on the same subnetwork as the IBM PC-compatible Pentium running the Windows application. The name and IP address of the workstation should be listed in the C:Windows\hosts file.
Perform the following procedure to install the Cisco Enterprise Accounting (CEA) data collection engine on a Sun SPARC 20 workstation:
Step 1 Insert the CEA UNIX CD-ROM into your CD-ROM drive.
Step 2 Become the superuser by entering su and the root password at the command prompt, or log in as root. The command prompt changes to the pound sign (#).
Step 3 If the /cdrom directory does not already exist, enter the following command to create it:
mkdir /cdrom
Step 4 Mount the CD-ROM drive.
/etc/mount -rt hsfs /dev/device_name /cdrom
Step 5 Change to the /cdrom directory.
cd /cdrom
Step 6 Run the provided install script.
Make sure to include the ./ in the ./install_cea command.
When prompted, enter the directory where the software should be installed. This directory must be readable and writable by the CEA administrator. If the executables already exist in the same directory, the script will ask permission to overwrite them. The installation script will create a /svr directory in the destination directory and the subdirectories described in Table 1-1.
| Directory | Explanation |
|---|---|
| bin | Executables for the CEA server. |
| data | Configuration and datastore files for the CEA server. |
| docs | Documentation for CEA server. |
| include | C header files for the CEA server. |
| install | Install script for reinstalling CEA. |
| log | Log files created by the CEA server while running. |
| man | Man pages for the CEA server in subdirectory man1. |
| snmpatch | Cisco MIB schema files to be loaded into SunNet Manager. |
Step 7 To unmount the CD, enter the following commands:
cd /
umount /cdrom
eject /cdrom
Before starting Cisco Enterprise Accounting (CEA), the SPARC workstation must be properly configured. The following tasks must be done before running CEA:
Set the user's environment variables listed in Table 1-2 to the desired directories. These environment variables should be set in the login profile file, such as a .cshrc or .profile file, for the CEA user. In order for these variables to work, log out and log back in.
For example, to set $SNMHOME to /var/snm, type the following command:
setenv SNMHOME /var/snmTo add the location of the CEA svr/bin executables to your PATH, type the following command:
setenv PATH ${PATH}:${CEAHOME}/svr/binThe $CEAHOME/svr/data/cea_hosts.cnf file identifies the routers CEA monitors.
Include one line in the file for each router. If you include multiple lines for a router, the last line is used. Each entry consists of fields separated by blanks or tabs. Blank lines and those starting with a pound sign (#) are ignored. Do not include peer (remote) hostnames in this file.
The command syntax is:
hostname nwaddr [collector method poll com log]Table 1-3 lists the fields and field descriptions.
For example, to poll the router called server1 every ten minutes, include the following line in your cea_hosts.cnf file:
server1 172.18.1.1 E P 10 public DEach router identified in the cea_hosts.cnf file must be included in the local /etc/hosts file. Check the /etc/hosts file to verify that all routers are present. In order to update the /etc/hosts file, you need to be logged in as root. Using the ping command, check that you can reach each router.
CEA uses SunNet Manager (SNM) to collect the call data from the routers. SNM must be properly configured with a database for the CEA administrator, Cisco MIB schemas, and the IP addresses of the monitored routers.
The Cisco Enterprise Accounting administrator must create an SNM database.
Make sure that you are logged in as the user who will be running CEA, and that the $SNMHOME and $SNMDBDIR environment variables have been set.
Step 1 Change to the SNM home directory.
cd $SNMHOME
snm
Step 3 Select the Basic Start option.
Step 4 Select Quit from the window.
db.<user> will be saved in $SNMDBDIR, where <user> is the user who started SNM.
CEA data collection uses SNMP to gather data from the Cisco ISDN MIB. Therefore, SNM must be loaded with the Cisco MIB schemas.
Step 1 Extract the Cisco MIB schemas from the snm-mibs.tar file located in the $CEAHOME/svr/snmpatch directory into the target directory, $SNMHOME/agents.
cd $SNMHOME/agents
uncompress $CEAHOME/svr/snmpatch/snm-mibs.tar.Z
tar xvf $CEAHOME/svr/snmpatch/snm-mibs.tar
Step 2 Check that the .schema, .oid, and .trap files all have public read and write permissions once they have been moved to the $SNMHOME/agents directory.
Save your current database before reloading Cisco MIB schemas into the SNM database to prevent data loss.
Step 1 Start SNM.
snm
Step 2 Select File from the Home Window.
Step 3 Under the File menu, select Save>Management Database to save the current working database and chose a name for the saved database.
 | Caution Do not skip this step or your current database will be lost. |
Step 4 Exit SNM.
Step 5 Restart SNM with the -i option and the name of the saved database.
snm -i my.saved.db
This causes SNM to reinitialize the database, reloading its schema files in the process. Output similar to the following example should appear if the schemas are loaded properly:
name% snm -i my.saved.db
name% Copyright (c) 1989-1995 Sun Microsystems, Inc.
snm: loading /usr2/snm/sun4/snm/struct/snm.glue
snm: loading /usr2/snm/sun4/snm/struct/elements.schema
.......
snm: loading /usr2/snm/sun4/snm/agents/cischist.mib.schema
snm: loading /usr2/snm/sun4/snm/agents/ciscisdn.mib.schema
snm: loading /usr2/snm/sun4/snm/agents/ciscsmi.mib.schema
snm: loading my.saved.db
name%
Step 6 Exit SNM.
SNM is now configured to recognize the traps and MIBs required by the CEA Data Collector.
All routers to be monitored must appear in the SNM database owned by the user who will run the CEA server.
Adding routers to SNM can be done manually by following the instructions provided with SNM. However, CEA will automatically add the IP addresses of the routers during CEA startup if you set the $CEAAUTOVIEW environment variable to the name of an SNM view.
To instruct CEA to add elements automatically to the view named "cea," type the following command at the command line or in your login profile file:
setenv CEAAUTOVIEW ceaIf $CEAAUTOVIEW is set, CEA will attempt to update the SNM database when reading the cea_hosts.cnf file. Errors can be seen in the $CEAHOME/svr/log/cea_ds_logfile file. The error numbers are explained in the man page for snmerror. To view this man page, type man snmerror.
Configure the routers with a read community string which matches the value configured in the cea_hosts.cnf file. Perform these steps on each monitored router.
Step 1 To set up the community string for read only access, enter the following global configuration command:
snmp-server community community-string ro
Step 2 Remove any access lists which filter SNMP traffic.
Step 3 Save the configuration.
copy running-config startup-config
The Cisco Enterprise Accounting (CEA) installation program installs all the required files.
If you already have a previous version of CEA installed on your machine, manually remove the application before installing the current version.
To install CEA, complete the following steps:
Step 1 Insert the CEA Windows CD-ROM into your CD-ROM drive.
Step 2 In the Program Manager window, select Start>Run, or select Start>Control Panel>Add/Remove Programs and click Install.
Step 3 Enter the letter that indicates the CD-ROM drive followed by a colon (:), a backslash (\), and SetupCEA.exe. For example:
The Welcome dialog boxes appear. Click Next on these two screens; you will see the Licence Agreement screen. Read this screen and select the Yes button if you accept the stated terms and agreements.
Step 4 The User Information dialog box appears. Enter your name and company; then click Next.
Step 5 The installation program automatically defaults to the subdirectory called Program Files on your C drive. Accept the default location; then click Next to continue.
Step 6 The Setup Type screen appears. Select the Typical setup. The Compact setup does not load online help. Custom setup is used for updates once the software is already installed. The Custom setup does not install any new databases. Click Next to continue.
Step 7 In this next screen, accept the program folder default of Cisco Enterprise Accounting; then click Finish to continue.
The setup program will decompress and install all the needed files and ask if you want to restart the system.
Step 8 To use CEA, click Restart to restart your computer.
You should now have the Cisco Enterprise Accounting program group in your Program Manager window.
To start the Cisco Enterprise Accounting (CEA) data collection engine, enter the following command:
cea_startdsErrors can be seen in the $CEAHOME/svr/log/cea_ds_logfile file. To check the status of the data collection engine, use the cea_chkds command.
To exit the CEA data collection engine, enter the following command:
cea_killdsThe Program Manager window contains the following icons:
In order to run Cisco Enterprise Accounting applications, complete the following tasks:
Step 1 Double-click on the Cisco Enterprise Accounting icon in the Cisco Enterprise Accounting Program Manager group.
The Main Window will appear. See the "Cisco Enterprise Accounting Main Window" section in the "Cisco Enterprise Accounting Overview" chapter for details on this window.
Step 2 Select the Recording Setup command in the Settings Menu to set up the recording information. Provide the information requested on the two screens. When you are done, click Finish.
Step 3 Select the Device and Costing Setup command in the Settings menu to enter the costing information. When you are done, click Finish.
In order to begin the recording processes, you must start the Port Monitor application.
Step 1 Select Start>Programs>Cisco Enterprise Accounting>Port Monitor. This starts the recording process and opens the Port Monitor screen. Once this application is running, do not exit or close Port Monitor.
Step 2 Verify that Port Monitor is recording. The word "Yes" should appear in the "Data" column. If this column says "no," refer to the "Troubleshoot a Recording Problem" section in the "Maintenance and Troubleshooting Procedures" chapter.
See the "Port Monitor Overview" section in the "Cisco Enterprise Accounting Overview" chapter for more information about this application.
|
|