Understanding the Administrator User Interface
This chapter describes how to access the Broadband Access Center (BAC) administrator user interface and explains the interface. The topics covered are:
•Configuring the Administrator User Interface
•Accessing the Administrator User Interface
•Studying the Administrator User Interface
Configuring the Administrator User Interface
Before you use the administrator user interface, examine the adminui.properties file. This file contains a variety of controls that specify the behavior of the interface.
You can open this file using any text editor, and change its content to perform the functions that you want. After you save the changes, restart the user interface so that the changes take effect.
To start the administrator user interface, enter:
# etc/init.d/bprAgent start tomcat
To stop the administrator user interface, enter:
# etc/init.d/bprAgent stop tomcat
To restart the administrator user interface, enter:
# /etc/init.d/bprAgent restart tomcat
You can configure the user interface by using the options available in the adminui.properties file. These options are controlled by BAC settings or defined in the adminui.properties file in the BAC_home/rdu/conf directory. The configuration parameters are:
•/adminui/port
—Specifies the listening port of the RDU. The default port number is 49187.
•/adminui/fqdn
—Specifies the fully qualified domain name of the host on which the RDU is running. The default value is the FQDN of the host; for example, bac_test.ACME.COM.
•/adminui/maxReturned
—Specifies the maximum number of search results. The default value is 1000.
•/adminui/pageSize
—Specifies the number of search results displayed per page. You can set this number at 25, 50, or 75. The default value is 25.
•/adminui/refresh
—Specifies if the refresh function is enabled or disabled. This option is, by default, disabled.
•/adminui/extensions
—Specifies if the use of extensions in BAC is enabled or disabled. You use extensions to augment BAC behavior or add support for new device technologies. The use of extensions is, by default, enabled.
•/adminui/maxFileSize
—Specifies the maximum size of a file uploaded to BAC. The default file size is 4 MB.
•/adminui/refreshRate
—Specifies the duration (in seconds) after which a screen is refreshed. The default value is 90 seconds. Before setting a value for this option, ensure that the /adminu/refresh
option is enabled.
•/adminui/timeout
—Specifies the length of time (in seconds) after which an idle session times out. The default period is set as 300 seconds.
•/adminui/noOfLines
—Specifies the last number of lines from rdu.log or dpe.log that appear on the user interface. The default number of lines that appear is 250.
Example 9-1 Sample adminui.properties File
/adminui/fqdn=doc.cisco.com
/adminui/maxReturned=1000
/adminui/refresh=disabled
/adminui/extensions=enabled
/adminui/maxFileSize=10000000
Accessing the Administrator User Interface
You can access the BAC user interface from any computer that can access the URL corresponding to the BAC application.
Logging In
You can log in to the BAC user interface as an administrative user, a Read/Write user, or a Read-Only user. Although each user type has different capabilities, as described in User Management, page 10-1, you access the user interface in the same way.
Complete this procedure to access the BAC administrator user interface:
Step 1 Launch your web browser.
Table 9-1 lists the browsers supported in this BAC release.
Table 9-1 Browser Platform Support
|
|
Windows 2000 (Service Pack 2) |
Internet Explorer 6.0 and above Netscape 4.7 and above |
Red Hat Linux (7.1) |
Netscape 4.7 and above |
Solaris (2.9) |
Netscape 4.7 and above |
Step 2 Enter the administrator's location using this syntax:
http://machine_name:port_number/
•machine_name—Identifies the computer on which the RDU is running.
Note To access the administrator user interface via HTTP over SSL, also known as HTTPS, enter: https://machine_name/
•port number—Identifies the computer port on which the server side of the administrator application runs. The default port number is:
–8100 for HTTP over TCP
–8443 for HTTP over SSL
The main login page, shown in Figure 9-1, appears.
Figure 9-1 Login Page
Step 3 Enter the default username (admin) and password (changeme).
If you are logging in for the first time, the Change Password screen appears. Enter a new password and confirm it.
Note Note that the FQDN of the RDU server you are logged in to appears in the User Login area.
Step 4 Click Login.
The Main Menu page, shown in Figure 9-2, appears.
Figure 9-2 Main Menu Page
Note You can use the link at the top of the page to add the license keys for each technology that you are authorized to use. For details, see Configuring Broadband Access Center, page 11-1.
Logging Out
Complete this procedure to log out of BAC:
Step 1 Click the Logout tab at the top right corner of any page.
Step 2 A confirmation dialog appears. Click OK.
This returns you to the User Login page. See Figure 9-1.
Studying the Administrator User Interface
The BAC administrator user interface, as shown in Figure 9-3, is divided into three separate areas:
•Banner area—Contains all menu options including: a Logout button, the Primary Navigation bar, and the Secondary Navigation bar.
•Content area—Contains all BAC data resulting from the functions performed from the Primary and Secondary Navigation bars.
•Results area—Indicates how many pages of information are available. This is particularly useful when reviewing the results of searches.
Some BAC administrator pages may also contain View, Delete, Submit, or Reset controls.
Figure 9-3 Administrator User Interface
Understanding the Icons
The BAC administrator user interface features icons, which you can use to perform specific functions. Table 9-2 defines these icons.
Table 9-2 Administrator User Interface Icons
|
|
|
This icon serves as: •View Details icon—Enables you to view details of a given device or file. •Operations icon—Enables you to execute operations on a given device. |
|
Delete icon—Deletes a specific object. |
|
Export icon—Exports the contents of a specific file to the client computer. |
These icons are used in sections describing procedures that you perform via the administrator user interface. These sections include:
•Using the Administrator User Interface, page 10-1
•Configuring Broadband Access Center, page 11-1