Understanding the Administrator User Interface

Table Of Contents

Understanding the Administrator User Interface

Configuring the Administrator User Interface

Accessing the Administrator User Interface

Logging In

Logging Out

Understanding the Administrator User Interface Icons

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

• Understanding the Administrator User Interface Icons

Using the Administrator User Interface, page 16-1, explains how to use the user interface to perform administrative activities. In addition, the Cisco Broadband Access Center DPE CLI Reference, Release 3.0, contains descriptions of the CLI commands used to access, monitor, and control the Device Provisioning Engines (DPEs).

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 by using any text editor, and change its content to perform the functions that you want. After your changes are complete and saved, restart the user interface so that all the changes to take effect.

To start the administrator user interface, enter:

# etc/init.d/bprAgent tomcat start

To stop the administrator user interface, enter:

# etc/init.d/bprAgent tomcat stop

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 BPR_HOME/rdu/conf directory.

The configuration parameters are:

•/adminui/port—Specifies the listening port of the RDU. This port number is, by default, 49187.

•/adminui/fqdn—Specifies the fully qualified domain name of the host on which the RDU is running. This value is, by default, the FQDN of the host; for example, bac_test.ACME.COM.

•/adminui/maxReturned—Specifies the maximum number of search results. This number is, by default, 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. This file size is, by default, 10 MB.

•/adminui/refreshRate—Specifies the duration (in seconds) after which a screen is refreshed. This value is, by default, 90 seconds. Before setting a value for this option, ensure that the /adminu/refresh option is enabled.

•/adminui/timeout—Specifies the duration (in seconds) after which an idle session is timed out. This period is, by default, set as 300 seconds.

•/adminui/noOfLines—Specifies the last number of lines from the rdu.log or the dpe.log that will be displayed on the user interface. The number of lines that appear, by default, is 250.

•/adminui/noOfFiles—Specifies the number of troubleshooting log files that you can view. The number of files you can view is, by default, 1. The maximum number of files that you can view at a given time is 5.

Example 15-1 Sample adminui.properties File

/adminui/port=49187
/adminui/fqdn=doc.cisco.com
/adminui/maxReturned=1000
/adminui/pageSize=25
/adminui/refresh=disabled
/adminui/extensions=enabled
/adminui/maxFileSize=10000000
/adminui/refreshRate=90
/adminui/timeout=300
/adminui/noOfLines=250
/adminui/noOfFiles=1

Accessing the Administrator User Interface

You can access the administrator user interface from any computer that can access the URL corresponding to the BAC application.

Logging In

You can log into the 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 16-1, you access the user interface in the same way.

Complete this procedure to access the administrator user interface:

Step 1 Launch your web browser.

Table 15-1 lists the browsers supported in this BAC release.

Table 15-1 Browser Platform Support

Platform

Supported Browsers

Windows 2000 (Service pack 2)

Internet Explorer 6.0 and above

Windows 2000, Windows XP, Solaris, Linux

Mozilla 1.7.3

Step 2 Enter the administrator's location using this syntax:

http://machine_name/

•machine_name—Identifies the computer on which the Regional Distribution Unit (RDU) is running.

Note To access the administrator user interface by using HTTP over SSL, also known as HTTPS, enter: https://machine_name/

The server-side of the administrator application runs on a computer port. By default, this port number is:

•80 for HTTP over TCP

•443 for HTTP over SSL

The main login page, shown in Figure 15-1, appears.

Figure 15-1 Login Page

Step 3 Enter the default username (admin) and password (changeme).

a. If 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 into appears in the User Login area.

Step 4 Click Login, and the Main Menu page, shown in Figure 15-2, appears.

Note Use the link at the top of the page to add new BAC licenses. From this page, you can enter the technology licenses that you are authorized to use. Refer to Configuring Broadband Access Center, page 17-1, for more information.

Figure 15-2 Main Menu Page

Logging Out

Complete this procedure to log out of BAC:

Step 1 Click Logout 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 15-1).

Understanding the Administrator User Interface Icons

The BAC administrator user interface features icons, which you can use to perform specific functions. Table 15-2 defines these icons.

Table 15-2 Administrator User Interface Icons

Icon

Description

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's 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 16-1

• Configuring Broadband Access Center, page 17-1

Platform	Supported Browsers
Windows 2000 (Service pack 2)	Internet Explorer 6.0 and above
Windows 2000, Windows XP, Solaris, Linux	Mozilla 1.7.3