Cisco Provisioning Center User's Guide, 4.2
The Cisco Provisioning Center Interface
Downloads: This chapterpdf (PDF - 361.0 KB) | Feedback

The Cisco Provisioning Center Interface

Table Of Contents

The Cisco Provisioning Center Interface

Getting Started

Logging in to Cisco Provisioning Center

Logging Out of Cisco Provisioning Center

Layout of the Cisco Provisioning Center Interface

Navigation Bar

Tree View

Content Area

Action Bar

Lister View

Group Lister

Object Versions

Sorting and Filtering Lists

Find and Choose

Lister Popup Menu

Object View

Provisioning View

Provisioning Result Page

Service View

Tabular View

Dynamic Views

Ordered List View

The Cisco Provisioning Center Interface

The Cisco Provisioning Center GUI interface is a series of HTML pages viewed in a standard Web browser. The GUI provides an easy to use interface to accomplish your tasks.

The "Getting Started" section describes how to log in and log out of the Cisco Provisioning Center interface

The "Layout of the Cisco Provisioning Center Interface" section describes the following features of the interface:

Navigation Bar

Tree View

Content Area

For detailed information about the tasks you can perform using Cisco Provisioning Center, see Chapter 5, "Common Tasks", or the relevant Equipment Module or Service Application documentation.

Getting Started

To open the login page of the Cisco Provisioning Center interface, enter the following address in your Web browser:



host is the Cisco Provisioning Center host machine. If DNS is not enabled, use an IP address.

portNumber is the Web server port number. The default value is 8080.

If you have enabled the SSL security feature, type https: instead of http:

Note If the Cisco Provisioning Center server has the virtual host configured, ask your Cisco Provisioning Center System Administrator for the exact address.

The Log In page is displayed. See Figure 4-1.

Figure 4-1 Cisco Provisioning Center Log In Page

Logging in to Cisco Provisioning Center

To log in to Cisco Provisioning Center, follow these steps:

Step 1 Enter your user name in the User Name field.

Step 2 Enter your password in the Password field.

Step 3 Click the log in button.

If Cisco Provisioning Center prompts you for certification, see your Cisco Provisioning Center system administrator for a certification number.

Note If SSL has been enabled, it must be configured correctly on all servers before you can use Cisco Provisioning Center. Refer to the CPC Administration Guide for more information.

Cisco Provisioning Center validates your user name and password. If the user name and password are valid, the Cisco Provisioning Center main page appears. See Figure 4-2.

Note Your password may expire at pre-defined intervals, refer to your system administrator for details on entering a new password or changing the expiration interval

Logging Out of Cisco Provisioning Center

To log out of Cisco Provisioning Center, click the log out button.

Note If you remain logged in to Cisco Provisioning Center without performing any tasks, you are eventually logged out after a pre-defined timeout period (default=30 minutes). Contact your Cisco Provisioning Center System Administrator for details on modifying this timeout period.

Layout of the Cisco Provisioning Center Interface

The Cisco Provisioning Center interface is composed of the following:

Title Bar—A frame at the top of the interface that displays a product name.

Navigation Bar—A set of buttons that change the Tree View.

Tree View—A list of available objects, utilities and functions.

Action Bar—A set of buttons that changes depending on the view in the Content Area.

Content Area—An area that changes depending on the item selected in the Tree View.

See Figure 4-2 for the layout of the Cisco Provisioning Center interface. The initial Log In screen does not have a Tree View or Content Area.

Figure 4-2 Cisco Provisioning Center Interface

Navigation Bar

The Navigation Bar consists of a set of buttons that change the Tree View or Content View when selected. The buttons are described in Table 4-1.

Table 4-1 Navigation Bar Buttons


Log In

Logs you into the Cisco Provisioning Center client session.

Log Out

Logs you out of the Cisco Provisioning Center client session.


Displays network objects in the Tree View (Networks Tree View) and enables network operations. See the "Working with Networks" section.


Displays service objects in the Tree View (Service Tree View) and enables service operations. See the "Working with Services" section.


Displays transactions, Upload transactions, and other utilities in the Tree View (Administration Tree View). It enables Cisco Provisioning Center administration operations. It also contains utilities to create users and roles. Refer to the CPC Administration Guide for more details.


Displays a hyperlink to the Cisco Provisioning Center Reporter application.


Provides access to the Support pages of the Cisco Web site.


Provides access to Cisco Provisioning Center help files.

Login Details

Displays the current user account information in the Content Area.

Transaction Details

Information for the currently selected transaction is displayed in the Content Area. This button is used to apply transactions that contain multiple operations.

Tree View

The Tree View section displays expandable folders that contain Cisco Provisioning Center utilities, objects and functions. The Tree View contents change depending on the option selected in the Navigation Bar. The Tree View includes the following:

Objects—Shown as hyperlinks, objects are labelled with their class name. Clicking on a hyperlink displays the object's Lister in the in the Content Area. For more information on the Lister View, see the "Lister View" section.

Functions and Utilities—Shown as hyperlinks, these items trigger an action or a change in the Content Area.

Table 4-2 contains a brief description of all the Tree Views and their folder contents.

Table 4-2 Tree Views and Folder Content Description

Tree View
Description and Folder Contents
Tree View

The Networks Tree View appears when you log in. It contains folders with all the installed Resource Models and Equipment Module. The Networks Tree View includes the following folders:

Resource Models and Equipment Modules

Each Resource Model and Equipment Module folder includes two subfolders: Elements and Profiles. The Elements folder contains network elements defined for the Resource Model or Equipment Module. The Profiles folder contains the available profiles for the network and service elements.

Tree View

The Services Tree View contains folders with all the installed Service Application components. The Services Tree View includes the following folders:

Service Applications

Each Service Application folder includes two subfolders: Services and Profiles. The Services folder contains service objects defined for the Service Application. The Profiles folder contains the available profiles for the service objects in the Service Application.

Tree View

The Reports Tree View contains a link to Cisco Provisioning Center Reporter, if this application has been installed.

Tree View

The Support Tree View contains a link to the Cisco website and a Support link that provides access to the Cisco support email address.

Tree View

The Help Tree View contains online documentation for installed Cisco Provisioning Center products.

Login details

There is no related tree view for this navigation object.

transaction details

There is no related tree view for this navigation object.

Administration Tree View

The Administration Tree View contains folders with utilities for Cisco Provisioning Center administrators to monitor processes and transactions. The Administration Tree View includes the following folders:


The Transactions folder contains access to Provisioning and Upload Transactions. Selecting these items changes the Content Area to display the transaction Lister View.


The Monitoring folder contains access to processes and running Provisioning and Upload transactions. Selecting these items changes the Content Area to display transaction and Progress Lister Views.


The Maintenance folder contains utilities to start and stop the Cisco Provisioning Center server.


The Security folder contains information pertaining to Cisco Provisioning Center users and roles. Selecting these items changes the Content Area to User and Role Lister Views.


The Troubleshooting folder contains utilities to help determine certain problems that occur while using the Cisco Provisioning Center.

When you resize your browser window, your location in the tree and the corresponding view are now retained. However this feature is dependent on your browser. The following table lists the behavior available on different platforms for different browsers.

Table 4-3 Retained Tree State Feature

IE in Windows
Netscape in Windows
Netscape in Solaris

Retaining Tree State

No redraw on tree view after resizing the browser window, WEB GUI system doesn't need to specially handle to retain the tree state.

Redraw of tree view will be triggered after resizing the browser window, WEB GUI system need to retain the tree state.

Same as Netscape in Windows.

Content Area

The Content Area contains a combination of views and action buttons. Several views can appear in the Content Area, depending on the object selected in the Tree View and any buttons clicked on the action bar.

When you are configuring equipment or provisioning services you will most commonly use the Lister View, Object View, and the Provisioning View. For more information on these views, see the "Object View" section.

Action Bar

The Action Bar, in the Content Area, contains a set of actions available in a particular view. The actions available from the Action bar change depending on the view selected, on the type of access you have and on which actions are supported by the selected object.

If you are unsure of the action that is associated with an icon, move your mouse over the icon. A description of the action will pop-up.

Table 4-4 lists actions available through the Action Bar.

Table 4-4 Actions Available in the Action Bar  

Common Actions

Get List

Retrieves a list of objects based on any criteria set in the Lister View.

Get Count

Retrieves the number of objects that fit the criteria set in the Lister View, but not the objects themselves.

Export to File

Captures the data displayed in the Lister or Object View in a static HTML page that can be saved.

Select All

Use this button to select all of the items in the displayed lister view.

De-select All

Use this button to de-select all of the items in the displayed lister view.


Opens a Provisioning View in edit mode, to create a new object instance.


Opens an Provisioning View in edit mode, to modify the selected object.


Deletes the object(s) selected from the Lister View, or the object displayed in the Object View.

Service Application Specific Actions


Verifies that the root service component points to the correct service components in the Cisco Provisioning Center database after upload. If it does not, Cisco Provisioning Center attempts to fix the pointers. Any changes are made in the Cisco Provisioning Center database only and do not affect the end-to-end service in the network.


Repairs end-to-end services in the network.

Single Import

Associates a single service object with existing service elements in the database.


Opens a Details View which displays the Service elements make up the Service object.


Opens a Service View to show the selected Service object.

User Defined Method

Opens a provisioning page for a user-defined method.

Equipment Module Specific Actions

NNI fail

Marks NNI links as failed.

NNI recover

Recovers failed NNI links and makes them operational again within Cisco Provisioning Center.

NNI rebalance

Redistributes the load across links in the same link group.

UNI fail

Marks UNI links as failed.

UNI recover

Recovers failed UNI links and makes them operational again within Cisco Provisioning Center.


Initiates the upload process. This applies to the network elements that have upload capability, such as Network and Node objects.

Transaction/Upload Actions

Log Info

Shows an audit log of the transaction or Upload Request.

Modified Object Info

Shows all of the objects that have been modified in the selected transaction.


Abandons the selected transaction.


Shows transaction details for the selected transaction.


Allows you to schedule a transaction to be processed at a later time.


Allows you to un-schedule a transaction.


Allows you to re-schedule a transaction.


Applies the selected transaction immediately.


Deselects the transaction and allows you to select another transaction.

Security User specific actions

Kick Out

Disconnects users that are logged in to the Cisco Provisioning Center. Only users with administrative privileges can disconnect users. This action applies to the User Views.

Find/Choose specific actions

Choose Object

Populates the Provisioning View with data from the objects selected in the Choose Page.


Use the Erase button to erase values that are set automatically when you select an object from a Find to Choose window.

For example if you have used Find to Choose to select an ATM physical port, the GUI system fills in the values for Network and Node fields automatically when the port is selected from the Find/Choose window. In this example, you need to click the Find/Choose button for the physical port and in that window click the Erase button to close the Find/Choose lister and clear the three fields on the provisioning page.


You can use this button to clear the value in the selected Find/Choose Only field, on the provisioning page.

Lister View

Selecting an object class in the Tree View displays the object-specific Lister View. Lister Views display lists of objects and their attributes in the Content Area. Different attribute columns appear depending on the type of object being displayed.

The initial Lister view is empty. Click the Get List button on the Action Bar to populate the Lister view. The label above the Action bar defines the object to be displayed in the Lister.

You can page through the listers when there are more records than will fit on one page.

When the total number of records exceeds the page size, then a row of hyper-linked pages will be at the top and bottom of the lister. Click the page number to go to that page.

You can select individual items from the list by clicking on the selection box for the desired object. You can use the same method to select multiple items. To select all of the items in the list, click on the Select all button. Use the de-select all button, to de-select list items.

A typical Node Lister is shown in Figure 4-3.

Figure 4-3 Node Lister View

Group Lister

A group lister is available for some equipment modules. The group lister allows you to view all types of a specific service or fabric element. For example, the Group PVC lister for a WAN EM typically allows you to view all types of PVCs. All of the PVCs (ATM, FR and IW) are listed in the Content Area.

Object Versions

In addition to object attributes, populated Lister Views also display object Item Numbers and Versions in the Item# and Version columns.

Item Numbers simply assign a numerical value to objects in the list (beginning with one). You can click an object's item number to bring up an Object View for that item.

When a change is requested, Cisco Provisioning Center creates a pending version of the affected objects, in the database. When the changes are delivered to the network and committed, the pending version replaces the current existing object in the database.

When you click on the apply now button, the selected objects will not be pending since the requested changes are made immediately. However, when you click on the save button you are creating a pending version of the selected object, that will remain in the database until the transaction is applied. The pending version of an object is always associated with a particular transaction.

Note Some objects do not support a pending version. The save button is not available for these objects.

The version icons provide details about the object's version (i.e. pending or current). If the object is pending, you can position the mouse pointer over the version icon and the name of the user who created the object will be displayed as well as its transaction number. Table 4-5 lists the possible version information that can appear in this column.

Table 4-5 Object Version Icons


The object is pending in the transaction, that is currently selected.

The object is pending in a the transaction, that is not currently selected.

No Icon

There is no pending version of the object, only the current version exists.

Sorting and Filtering Lists

You can sort and filter lists by using the Sort dropdown list and the Filter fields. These allow you to re-arrange and limit the data that is displayed in the Lister. You can sort on up to five columns. For more information on sorting and filtering lists, see Chapter 5, "Common Tasks".

Find and Choose

The Lister also contains a Find and Choose feature that is available to certain columns of the Listers. See Table 4-6.

Table 4-6 Actions Available in the Lister



The Find button appears beside attribute fields that can be populated by attributes from the database. When you click the Find button, a list of available objects for that attribute is displayed if autolist has been enabled, otherwise, press the GetList button to generate the list.


The selected object in this list is placed in the attribute field when you click the Choose button (see Table 4-4).

For more information on using the Find and Choose function, see Chapter 5, "Common Tasks".

Lister Popup Menu

The action bar, column headers, search input form and the jump-to box are fixed on the top of the Lister page. These tools disappear as you scroll down the lister page.

Step 1 Move your mouse to the right-hand side of the item for which you want a popup box. The mouse pointer will change to a hand and an indicator box will be displayed, containing the column header and search criteria.

Figure 4-4 Lister Popup Indicator

Step 2 Click the left mouse button. A popup action bar will be displayed. The popup menu is displayed on the very left of the visible area of the content frame regardless of the location of your mouse click. This is done to maximize the view of the popup menu within the content frame.

Step 3 You can then select the desired action to perform, on the object contained in the current row. If you are creating an object, the currently selected row is used as the template. The create operation always uses the currently selected row as a template. It is not possible to create an object without a template when you are using the popup menu.

Figure 4-5 Lister Popup

Once the popup menu is displayed, any operations that are performed through the popup menu, are applied only to the object in the current row, even if other rows have been selected using their selection boxes. To de-select the object, in the current row, close the popup menu. When you are using the popup action bar, the selection box, in the current row does not need to be selected in order to perform an operation on the object.

The menu bar on top of the lister is used to perform operations to the objects selected with the selection check boxes. It is not possible to use a popup menu to perform operations on multiple objects at the same time.

The default value of DB_Max_Rows has been set to 200 in the GUI configuration file. This means the lister page will display a maximum of 200 rows in each page. This configuration allows your browser to display a list of 200 rows with 22 columns, within a reasonable time. Lister performance may be degraded if you increase the value of DB_Max_Rows.

If you have a lister that contains more than 22 columns, you may need to reduce the DB_Max_Rows to 140 in order to maintain performance. Use the following formula to determine the value of DB_Max_Rows for optimum performance: DB_Max_Rows = 44000/max_number_of_columns in the lister. If the maximum number of columns of all of your listers is 40, then DB_MAX_Rows should be set to 110.

Object View

Clicking a hyperlink in the Lister View displays the Object View. The Object View contains all of the attributes (and their values) for a particular object. The Object View also contains an Action Bar that includes actions for use on the selected object.

Initially, the fields in the Object View of an object cannot be edited. Click the create or modify button in the Action Bar to edit the fields in the Object View. Clicking either of these buttons brings up a Provisioning View in the Content Area.

Figure 4-6 Object View

Note The width of the Object View table, is not set dynamically. Only the width of the action bar and the title bar are set dynamically according to the width of the browser window.

Provisioning View

The Provisioning View allows you to enter or modify attribute values thus creating new objects or modifying existing ones.

The Provisioning View contains icons indicating attribute behavior, as shown in Table 4-7.

Table 4-7 Cisco Provisioning Center Attribute Behavior Icons

Cisco Provisioning Center Attribute Behavior


A value for this attribute is mandatory.


A value for this attribute can be supplied by the objects profile.

Read Only

This attribute is read only.


This attribute, if modified, will affect other object attributes (i.e., they may become read-only, read-write, etc).

Find to Choose Only

A value for this attribute cannot be entered manually. You must obtain the value using the Find/Choose feature.

The Provisioning View also contains a Find and Choose function (identical to the one that is used in the Lister View) that is available for certain Object Views.

Once you are finished entering all of the required attributes, or confirmed the object to be deleted, click Apply button. The system will create and open a transaction, perform the required provisioning operation and apply the transaction through the COBRA interface to Cisco Provisioning Center. The transaction result will be returned to the GUI.

If you click the Save button, then the system will create and open the transaction if no approved transaction is already selected. If an approved transaction has been selected, the GUI will just open the transaction. In either case, Cisco Provisioning Center will save the corresponding operation and close the transaction, but not apply it. If no approved transaction is currently selected, then the newly created transaction will be the selected transaction, after finishing the save operation. The save operation can either succeed or fail. The transaction may remain CURRENT. It can also be abandoned, if the service objects involved in that transaction fail.

The Apply Now button applies the transaction in one step, whether or not you have selected an approved transaction.

Provisioning requests made through the GUI are associated with the user that is logged into the GUI session, rather than the application server. This information is useful when you are reviewing log information. In addition, the system can limit the concurrency of provisioning per user. It prevents one user from consuming all of the provisioning sessions in the session pool. This limit can be configured in the default configuration file.

Provisioning Result Page

Once you have applied or saved the provisioning operation, the Provisioning Result page will be displayed. The top section of the page will show the transaction number and whether or not the transaction succeeded.

Below the transaction information, there is a hyperlink back to the provisioning page. If the transaction failed, you can correct the information and try again. If provisioning succeeded, you can use the information on the provisioning page to complete another similar transaction, using the existing information as a template.

An action bar containing the following options is also displayed:

Table 4-8 Provisioning Results Page Action Bar  


Log Info

Shows an audit log of the transaction or Upload Request.

Modified Object Info

Shows all of the objects that have been modified in the selected transaction.

Delete Transaction

Deletes the displayed transaction object.

If the operation has succeeded, the created or modified objects will be shown on the page. If the transaction has failed, then an error message will be shown. There are hyperlinks to show more error messages. These additional error messages are provided by the CORBA call from the GUI to the Cisco Provisioning Center engine.

Service View

The Service Viewer can be invoked from the Service Lister (select only one service object) or from a Service Object Viewer by clicking the Graphics button on the Action Bar. Once the Service Viewer is displayed, you can click on any object to see either the object viewer, tabular viewer or graphical viewer for the selected object instance.

The operations that can be performed (Create/Modify/Delete) on this service will be displayed on the Action Bar. See the "Viewing Service Objects Through the Service View" section for more details.

Tabular View

The tabular viewer allows you to view the details of a service object in a tabular format. The details of the service object include all of the service elements, such as network, node, ports, PVCs, links, etc., which make up the service. A series of the object instances with their own object ID from the starting point of the service object to the end point are listed.

The object view for each service element is customized by each equipment module. Since the tabular view is intended to provide information only, no attribute information is available in the tabular view for each service element.

To invoke the tabular viewer for a particular service object, click the Detail button on the Action bar. See the "Retrieving Service Object Details Through the Details View" section for more details.

Dynamic Views

A dynamic view allows you to see a GUI view that is determined by certain attributes values in the object viewer. It is dynamic because it changes, depending on the type of operation that you are performing and the attribute values that you have set.

This inter-attribute dependency allows you to switch the GUI view of an object by selecting certain attribute values. When you change the value of one of these attributes, either by entering a value, selecting one of the enumerated values, or using the find/choose feature, it will trigger a new GUI view. Some fields will be become read only, others will be hidden, etc.

A Refresh icon is displayed beside the attribute name of those attributes that trigger changes to the GUI view.

Ordered List View

The ordered list viewer uses a composite view. For ordered lists, the embedded lister is used to displayed a lister view of the ordered list items, which are the members of the ordered list that is being displayed in the object viewer.

Once the object viewer page is loaded, the embedded lister will be displayed automatically, if it is required. When you perform a Get List or Get Count operation from the embedded lister, the whole object viewer page is reloaded.

Within the embedded lister, you have Get List and Get Count buttons. The layout of this lister is basically the same as the standard lister. Two operations, Insert Before and Insert After, are available specifically for ordered list entries. These buttons will be displayed together with the modify and delete buttons for the embedded lister.

Table 4-9 Ordered List Icons


Insert Before

Create an ordered list entry and insert it before the selected entry.

Insert After

Create an ordered list entry and insert it after the selected entry.