Chapter 5. Managing the Cisco BACBA System

Table Of Contents

Managing the Cisco BACBA System

Starting the Cisco BACBA Software

Launching the Cisco BACBA Web UI

Disabling the Java Virtual Machine

Performing Backup and Restore

Backing Up BACBA

Restoring BACBA

Stopping the Cisco BACBA Servers

Restarting All BACBA Servers

Uninstalling the BACBA Software

Uninstalling BACBA in Silent Mode

Managing the Cisco BACBA System

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

This chapter includes the following sections:

• "Starting the Cisco BACBA Software" section

• "Launching the Cisco BACBA Web UI" section

• "Performing Backup and Restore" section

• "Uninstalling the BACBA Software" section.

Starting the Cisco BACBA Software

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

•Ensure that all system requirements described in Chapter 1, "Overview and System Requirements."

•Ensure that all preinstallation tasks described in the Chapter 2, "Pre-installation Tasks," have been been completed.

•You must have successfully installed the software, as described in Chapter 3, "Installing the Cisco Broadband Access Center Software."

•Oracle must be running when you start BACBA. To make certain that Oracle is running, enter the following command:

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 BACBA software can start the BACBA servers.

To start the BACBA software, follow these steps:

Step 1 Change directory to the BACBA product installation directory.

% cd $BAC_HOME/scripts

where $BAC_HOME points to the BACBA 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 BACBA services.

% ./bacStartUp
To see all the BACBA servers that are up and running, enter:
% source global.csh
% bacStartUp -status

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

Step 4 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 BACBA Web UI

To launch the BACBA Web 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 BACBA 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 Cisco Broadband Access Center for Broadband Aggregation.

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

Disabling the Java Virtual Machine

When you install the BACBAserver, you are also installing a Web server. The server starts automatically when you run ./bacStartup all. Before you can access the Web UI, however, if you have installed the Java Virtual Machine, you might need to reconfigure Internet Explorer as follows:

Step 1 Open Internet Explorer.

Step 2 From the Tools menu, select Internet Options. The browser displays the Internet Options dialog box.

Step 3 Click Advanced. The browser displays a list of advanced settings.

Step 4 Scroll through the list to determine if this setting is checked:

Java (Sun): Use Java <some version number> for <applet> (requires restart)
Step 5 If it is checked, then click to disable this setting.

Step 6 Click Apply and OK.

Step 7 Close Internet Explorer, then reopen it.

Step 8 To access the Web UI, in the Address field of the browser enter the URL for BACBA; for example, enter the following:

http://<web_servername>:8888/bac

Performing Backup and Restore

The section describes the following BACBA utilities:

•Backup

•Restore

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:

•Profiles associated with BAC templates

•BACBA templates

•Database

•All (backs up profiles, templates, and your database)

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

Backing Up BACBA

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 Shutdown all servers before performing a backup:

> ./bacShutDown
Step 3 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 BACBA 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 BACBA

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

•The database is empty and you want to populate the database with your data

•A database corruption occurs and the database requires a clean up

You can perform a restore after you install BACBA; but before you run the bacStartUp script. To perform a restore, the database must have no BACBA 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 BACBA db, or you can specify individual an category.

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

Stopping the Cisco BACBA Servers

To stop the BACBA servers, follow these steps:

Step 1 Change to the BACBA installation directory:

% cd $BAC_HOME/scripts

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

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

% ./bacShutDown

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 BACBA servers before you uninstall the BACBA software. For more information about uninstalling the BACBA software, see "Uninstalling the BACBA Software" section.

Restarting All BACBA Servers

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

Step 1 Change to the BACBA installation directory:

% cd $BAC_HOME/scripts

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

Step 2 Start all of the BACBA servers:

% ./bacStartUp

Uninstalling the BACBA Software

The BACBA 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 BACBA system installed, then you can remove:

•The complete BACBA product

•BACBA only

•Configuration Engine only

•Web server

Note To remove a BACBA component, you must have installed that component.

Note The BACBA uninstallation script always resides under the /opt/directory, regardless of where you installed your BACBA product.

Before you begin:

•Determine which BACBA components you want to uninstall.

•If you select the Complete Provisioning System option, you must first shut down all of the BACBA servers as described in "Performing Backup and Restore" section.

To uninstall the BACBA 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 BACBA detects that a complete BACBA provisioning system is currently installed.

Figure 5-2 Available Uninstallation Options Example

Note The uninstall script allows you to uninstall the BACBA 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 BACBA Uninstallation window appears, as shown in Figure 5-3.

Figure 5-3 BACBA Uninstallation Window

Step 3 Specify the UNIX root password.

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

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

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

Step 5 Click Start. The BACBA 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 BACBA installation directory:

% cd $BAC_HOME/scripts

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

b. Stop all of the BACBA servers:

% ./bacShutDown
c. Run the bacUninstall script again, as described in Step 1.

Step 7 Click Exit.

The BACBA Uninstallation window closes and the terminal window displays.

Uninstalling BACBA in Silent Mode

Just as you can choose to install BACBA with a text-based script, you can also choose to uninstall the product this way. This is called silent mode.

Before you begin to uninstall the product in silent mode, review the "Uninstalling the BACBA Software" section. The system displays a series of prompts that are text-based but the same as the GUI script.

To run the uninstall script in silent mode, at the command line enter the following:

cd /opt
/bacUninstall -silent
When the uninstallation script is finished, the system displays a completion message, as shown in Figure 5-5.

Figure 5-5 Uninstallation Completion Message