cc/td/doc/product/rtrmgmt/bacbba/bacbba25
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Managing the Cisco Broadband Access Center System
Starting the Cisco Broadband Access Center Software
Launching the Cisco Broadband Access Center Web UI
Performing Cisco Broadband Access Center Backup and Restore
Stopping the Cisco Broadband Access Center Servers
Restarting All Cisco Broadband Access Center Servers
Uninstalling the Cisco Broadband Access Center Software

Managing the Cisco Broadband Access Center System


This chapter provides information about how to start, launch, stop, backup, restore, and remove the Cisco Broadband Access Center for Broadband Aggregation software (herein referred to as BAC).

This chapter includes the following sections:

Starting the Cisco Broadband Access Center Software

Before you can use the BAC software, read the following list of requirements:

INSM-280# ps -ef | grep ora_
root 3773 3768 0 09:50:30 pts/2 0:00 grep ora_

If there are no running processes, then start Oracle. This is an example of what the command above shows if Oracle is running:

oracle 1108 1 0 Oct 04 ? 0:00 ora_pmon_PLUTO
oracle 1110 1 0 Oct 04 ? 0:00 ora_dbw0_PLUTO
oracle 1112 1 0 Oct 04 ? 0:00 ora_lgwr_PLUTO
oracle 1114 1 0 Oct 04 ? 0:29 ora_ckpt_PLUTO
oracle 1116 1 0 Oct 04 ? 0:00 ora_smon_PLUTO
oracle 1118 1 0 Oct 04 ? 0:00 ora_reco_PLUTO
oracle 1120 1 0 Oct 04 ? 0:00 ora_snp0_PLUTO
oracle 1122 1 0 Oct 04 ? 0:00 ora_snp1_PLUTO
oracle 1124 1 0 Oct 04 ? 0:00 ora_snp2_PLUTO
oracle 1126 1 0 Oct 04 ? 0:00 ora_snp3_PLUTO
oracle 1128 1 0 Oct 04 ? 0:00 ora_s000_PLUTO
oracle 1130 1 0 Oct 04 ? 0:00 ora_d000_PLUTO

To start Oracle, enter:

svrmgrl

When you are asked for password, give password of Oracle account.

startup
quit

Start the SQL*Net listener process:

lsnrctl start

Note   Only the user that installed the BAC software can start the BAC servers.

To start the BAC software, follow these steps:


Step 1   Change directory to the BAC product installation directory.

% cd $BAC_HOME/scripts

where $BAC_HOME points to the BAC installation directory or change to the default directory, cd /opt/CSCObacss

Step 2   Before you run bacStartUp Initial make sure that no Oracle apache server processes are running. Otherwise bacStartUp initial will fail when you setup Configuration Engine. Immediately kill all Apache server processors brought up by Oracle after installation, then run the Setup program (You run the Setup program when you start the system for the first time) again.


Note    You only use setup on a Linux machine. You are not required to setup manually with the Solaris package.

To stop the Oracle httpd server, follow these steps:

    a. Enter the following script:

ps -ef | grep httpd

    b. If the Oracle httpd server is running, enter the following command to stop it:

-cd $ORACLE_HOME/Apache/Apache/bin
su root
./apachectl {start | stop}

Step 3   Start the BAC services.

% ./bacStartUp <option>

where <option> can be one of the following:

Step 4   To see all the BAC servers that are up and running, enter:

% source global.csh
% psit

Note    If you are running the bash shell, then type the following command: ../global.sh

Step 5   Specify Y or N to drop the Oracle tables.

The default is N.


Note    The servers may take several minutes to start.



Launching the Cisco Broadband Access Center Web UI

To launch the BAC Web user interface (UI) follow these steps:


Note   Before you begin, you must have Internet Explorer 6.0 installed on your system.


Step 1   Enter the following URL:

http://<hostname>:8888/bac

The system administrator authentication page displays (Figure 5-1).


Figure 5-1   BAC Web UI Log On Page


Step 2   Enter the default username and password as follows:

Username: BACAdmin
Password: cisco

For security purposes, once you log in successfully, you should immediately change the default password as described in the the Cisco Convergent Network Solution Center: Subscriber Provisioning User Guide.

Also, refer to the Cisco Broadband Access Center for Broadband Aggregation User Guide for more information about using the Web UI.


Note   If the Java Virtual Machine is installed as a plugin for the browser, you must disable the Java Virtual Machine so that the UI displays properly.



Performing Cisco Broadband Access Center Backup and Restore

The section describes the following BAC utilities:

The back up and restore scripts s are located in the /opt/CSCObacss/scripts directory.

To ensure the integrity of your BAC provisioning data, you should perform regular backups. If your provisioning data becomes unavailable, such as through damage to a disk drive, you can restore this data from the backup copy.

In planning your backup strategy, be aware that you can choose to backup:

How often you select each of these options depends on how dynamic the associated data is.

Backing Up BAC

The backup utility allows you to back up your database at any time. In case of database corruption, the backup utility allows you to use the backed up data to restore your database. before it was corrupted.

To run the backup utility, follow these steps:


Step 1   From the UNIX command line, change (cd) to the /opt/CSCObacss/scripts directory. Type:

> cd /opt/CSCObacss/scripts

Step 2   Run the backup utility, using the following arguments:

> cd /opt/CSCObacss/scripts/bacBackUP.sh [{all|profile|template|validation|XMLProperties|db}] {backup directory}

The first parameter specifies what you want to back and the second parameter specifies the full path for the backup directory.

The first parameter: all will backup profile, template and BAC db, or you can specify an individual category.


Caution   Make certain that there is enough disk space to store the file in the backup directory, otherwise the backup will not be successful.


Note    Do not specify the /opt/CSCObacss directory for your backups. Using this directory would result in losing the backup file if you uninstall the software.



Restoring BAC

This section describes the restore utility when there is an existing BAC database, when there is a newly installed BAC with no tables created, and when there is a newly installed BAC with an existing database. The restore utility is used when:

You can perform a restore after you install BAC; but before you run the bacInstall initial script. To perform a restore, the database must have no BAC tables created. The restore utility creates the tables and populates the data.

In the event you need to restore data, follow these steps:


Step 1   From the UNIX command line, change (cd) to the /opt/CSCObacss/scripts directory. For example:

> cd /opt/CSCObacss/scripts

Step 2   Run the restore utility, using the following arguments:

> bacRestore.sh [{all|profile|template|validation|XMLProperties|db}] {backup directory}

The first parameter specifies what you want to restore and the second argument specifies the full path of the backup file.

The first parameter, all restores profile, template and BAC db, or you can specify individual an category.


Note    The restore command should be called after the BAC installation and before calling bacStartUp initial. When you call bacStartUp intial, choose not to drop the tables.



Stopping the Cisco Broadband Access Center Servers

To stop the BAC servers, follow these steps:


Step 1   Change to the BAC installation directory:

% cd $BAC_HOME/scripts

where $BAC_HOME points to the BAC installation directory (/opt/CSCObacss is the default).

Step 2   To stop all of the BAC servers, enter:

% ./bacShutDown all

Wait while the process starts. Several messages display notifying you that servers (service provisioning manager, inventory manager, resource manager, and so on) are shutting down.

When the servers are all shut down, a Shutdown completed message displays.


Note    You must stop all BAC servers before you uninstall the BAC software. For more information about uninstalling the BAC software, see "Uninstalling the Cisco Broadband Access Center Software" section.



Restarting All Cisco Broadband Access Center Servers

To restart all of the BAC servers, follow these steps:


Step 1   Change to the BAC installation directory:

% cd $BAC_HOME/scripts

where $BAC_HOME points to the BAC installation directory (/opt/CSCObacss is the default).

Step 2   Start all of the BAC servers:

% ./bacStartUp all



Uninstalling the Cisco Broadband Access Center Software

The BAC software provides an uninstall script that detects existing installed products and displays the proper options to uninstall these products. During uninstallation, if you have a complete BAC system installed, then you can remove:

Before you begin:

To uninstall the BAC software, follow these steps:


Step 1   Locate the bacUninstall script in that directory and run the bacUninstall script:

% cd /opt
% ./bacUninstall
% cd /cdrom/cdrom0/Uninstall

The system detects existing installed products and displays the proper options to uninstall those products. For example the following screen (Figure 5-2) displays the options that you can uninstall because BAC detects that a complete BAC provisioning system is currently installed.


Figure 5-2   Available Uninstallation Options Example



Note    The uninstall script allows you to uninstall the BAC software from a local or remote location. The symbolic link to the actual location will be removed automatically.


Note    To terminate the script at any time, enter Ctrl-C or exit.

Step 2   Select the appropriate option (corresponding to the option that was originally installed on this machine), then click Return.

The BAC Uninstallation window appears, as shown in Figure 5-3.


Figure 5-3   BAC Uninstallation Window


Step 3   Specify the UNIX root password.

Step 4   If you want to check which BAC options are currently installed, click the Installed Product button.

A pop-up window informs the user which BAC components are installed on this machine.


Note    It is highly recommended that you backup your database. For BAC database backup information, see the Cisco Broadband Access Center User Guide.

Step 5   Click Start. The BAC components initially selected are removed from the machine.


Note    Error messages (Figure 5-4) indicating that some applications are still running may display. In that case, you must shut down all servers. (see next section, If that does not solve the problem, kill these processes manually, in which case you may need run the bacUninstall script again. See "Troubleshooting."


Figure 5-4   Error Message Servers Running


Step 6   If you receive an error message about the servers still running, perform these steps to stop the servers. If not then go to Step 7.

    a. Change to the BAC installation directory:

% cd $BAC_HOME/scripts

where $BAC_HOME points to the BAC installation directory (/opt/CSCObacss is the default).

    b. Stop all of the BAC servers:

% ./bacShutDown all

Step 7   Click Exit.

The BAC Uninstallation window closes and the terminal window displays.




hometocprevnextglossaryfeedbacksearchhelp
Posted: Thu May 22 14:26:18 PDT 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.