Understanding the Administrator User Interface
This chapter describes how to access the Cisco Broadband Access Center (Cisco BAC) administrator user interface and explains the interface. The topics covered are:
•Configuring the Administrator User Interface
•Accessing the Administrator User Interface
•Understanding the Administrator User Interface Icons
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 Cisco BAC settings or defined in the adminui.properties file in the BPR_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.EXAMPLE.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 Cisco BAC is enabled or disabled. You use extensions to augment Cisco 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 Cisco 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 /adminui/refresh
option is enabled.
•/adminui/file/extensions
—Specifies the extensions of the files that the user interface supports. The supported extensions are by default .bin, .cm, and .jar.
•/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 11-1 Sample adminui.properties File
/adminui/fqdn=doc.example.com
/adminui/maxReturned=1000
/adminui/refresh=disabled
/adminui/extensions=enabled
/adminui/maxFileSize=40000000
Accessing the Administrator User Interface
You can access the Cisco BAC user interface from any computer that can access the URL corresponding to the Cisco BAC application.
Logging In
You can log in to the Cisco BAC user interface as an administrative user, a Read/Write user, or a Read-Only user. Though each user type has different capabilities, as described in User Management, you access the user interface in the same way.
Complete this procedure to access the Cisco BAC administrator user interface:
Step 1 Launch your web browser.
Table 11-1 lists the browsers supported in this Cisco BAC release.
Table 11-1 Browser Platform Support
|
|
Windows 2000 (Service pack 2) |
Internet Explorer 6.0 and higher Firefox 1.5 and higher |
Red Hat Linux (7.1) |
Firefox 1.5 and higher |
Solaris (2.9) |
Firefox 1.5 and higher |
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/
•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, as shown in Figure 11-1, appears.
Figure 11-1 Login Page
Step 3 Enter the default username (admin) and default password (changeme).
If you are logging in for the first time, the Change Password screen, as shown in Figure 11-2, appears.
Figure 11-2 Change Password Screen
Enter a new password and confirm it. Ensure that the password that you enter has at least 8 characters.
Step 4 Click Login.
The Main Menu page, as shown in Figure 11-3, appears.
Figure 11-3 Main Menu Page
Note You can use the link at the top of the page to add the license file. For details, see Managing Licenses.
Logging Out
Complete this procedure to log out of Cisco BAC:
Step 1 Click the Logout tab at the top-right corner of any page.
A confirmation dialog box appears.
Step 2 Click OK.
The application returns you to the Login page. See Figure 11-1.
Understanding the Administrator User Interface Icons
The Cisco BAC administrator user interface features icons, which you can use to perform specific functions. Table 11-2 defines these icons.
Table 11-2 Administrator User Interface Icons
|
|
|
View Details icon—Enables you to view details of a given device or file. |
|
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 are found in:
•Chapter 12 "Using the Administrator User Interface."
•Chapter 13 "Configuring Cisco Broadband Access Center."