|
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:
Before you can use the BAC software, read the following list of requirements:
If there are no running processes, then start Oracle. This is an example of what the command above shows if Oracle is running:
When you are asked for password, give password of Oracle account.
Start the SQL*Net listener process:
Note Only the user that installed the BAC software can start the BAC servers. |
To start the BAC software, follow these steps:
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:
Step 3 Start the BAC services.
where <option> can be one of the following:
Step 4 To see all the BAC servers that are up and running, enter:
Step 5 Specify Y or N to drop the Oracle tables.
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. |
The system administrator authentication page displays (Figure 5-1).
Step 2 Enter the default username and password as follows:
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. |
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.
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 2 Run the backup utility, using the following arguments:
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. |
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 2 Run the restore utility, using the following arguments:
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. |
To stop the BAC servers, follow these steps:
where $BAC_HOME points to the BAC installation directory (/opt/CSCObacss is the default).
Step 2 To stop all of the BAC servers, enter:
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. |
To restart all of the BAC servers, follow these steps:
where $BAC_HOME points to the BAC installation directory (/opt/CSCObacss is the default).
Step 2 Start all of the BAC servers:
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:
To uninstall the BAC software, follow these steps:
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.
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. |
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.
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." |
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.
where $BAC_HOME points to the BAC installation directory (/opt/CSCObacss is the default).
Step 7 Click Exit.
The BAC Uninstallation window closes and the terminal window displays.
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.