Working with Prime Central for HCS Portal
The following sections help you get started with the Prime Central for HCS portal:
•Configuring Your IE Setting for Prime Central for HCS
•Logging Into the Prime Central for HCS Portal
•Customizing the Prime Central for HCS Portal
•Understanding the Menu Structure
•Filtering and Searching
•Viewing the Prime Central for HCS Version
•Logging Out of the Prime Central for HCS Portal
Configuring Your IE Setting for Prime Central for HCS
To use Internet Explorer to run your Prime Central for HCS, follow the procedure outlined below:
Step 1 Launch IE. Add PC4HCS as a trusted site using Tools -- Internet Options -- Privacy -- Sites. Add https://pc_host:8443 (uses PC hostname) and https://pc_host_fqdn:8443 (uses PC FQDN (fully qualified domain name) ) to the trusted sites list.
Step 2 Add cookies. If you do not allow the cookies, you will run into an Authorization Failure error.
Step 3 Allow pop-ups.
Step 4 Repeat Step 1for the Service Visualizer to make it a trusted site. Use the following URLs:
https://service_visualizer_hostname:16316 (hostname) and https://service_visualizer_fqdn:16316 (fully qualified domain name) for the Service Visualizer.
Step 5 Vist Prime Central for HCS at https://server-hostname:https-port-number.
Step 6 Accept the security warning.
You can now launch Prime Central for HCS.
Configuring IE 8.0 for Prime Central for HCS
Configure IE 8.0 the first time you are trying to launch Prime Central for HCS. This lets you use the application without running into errors.
Step 1 Launch IE 8.0, and go to Tools > Internet Options.
Step 2 Under the Security tab, click Intranet Zone. Now click Sites > Advanced. Add (one at a time) the following to names to the zone:
–Prime Central Server Host Name with domain name
–Prime Central Server Host Name without domain name
–Service Visualizer Server Host Name with domain name
–Service Visualizer Server Host Name without domain name
Step 3 Click Add and then click OK.
Logging Into the Prime Central for HCS Portal
Prime Central for HCS features single sign-on (SSO), meaning that when you log into the Prime Central for HCS portal, you do not have to log in separately to each domain manager within your domain. Currently, SSO is supported for domain managers CUOM and DCNM SAN.
Figure 2-1 Prime Central for HCS - Login Screen
To log into the Prime Central for HCS portal:
Step 1 Open your default web browser and enter https://server-hostname:https-port-number, where:
•server-hostname is the hostname of the Prime Central for HCS server.
•https-port-number is the SSL port number that was configured during installation. The default SSL port is 8443.
Note The recommended browsers are Mozilla Firefox 3.6.24 and Internet Explorer 8.0 with Java update 1.6.30.
The login screen opens.
Step 2 Enter your username and password.
If you are an administrator logging in for the first time, enter the username centraladmin and the password that you configured during installation.
Step 3 Click Login.
Step 4 The first time you log in, accept the self-signed, untrusted security certificates. The certificates do not appear upon subsequent logins.
Understanding the Menu Structure
When you log into Prime Central for HCS, the menu structure that you can access depends on your user privileges and which domain managers are installed and available. The following menus are visible to users with administrator-level privileges.
Note We recommend that you launch the portlets by accessing them through the menu bar. Using the Add Portlet icon is not recommended.
Table 2-1 Prime Central Menu Structure
Takes you to the Prime Central for HCS home page.
Contains the following menu options:
•Fault Management—Cross-launches the following portlets that let you locate, diagnose, and report network problems: For more information, see Understanding Events
Contains the following menu options:
•User and Group Management—Lets you perform user management operations, including defining users and passwords and configuring role-based access control. For more information, see Managing Users and Configuring Role-Based Access Control
Customizing the Prime Central for HCS Portal
When you log into Prime Central for HCS, the portlets that you see on the home page depend on your user privileges and which domain managers are installed and available.
Figure 2-2 Prime Central for HCS - Home Page
Content area, with content that depends on your portlet selections
Menu bar, with main menu choices
Refresh Current Page icon
Home menu and icon
Change Layout icon
Logged-in user link
Add Applications icon
Log Out link
The following sections describe the customization options that are available on the Prime Central for HCS home page.
Adding a Portlet
In Prime Central for HCS, you can invoke most of the portlets from the options provided in the top menu bar. This section describes the steps required to add any other portlets that are not available from the top menu bar, such as My Accounts and User Preferences Portlets.
Note the following portlet management constraints:
•By default, administrators can see all available portlets.
•Administrators can assign different portlets and layouts for each user role. The portlets are added automatically to the user's Prime Central for HCS home page.
•When a user first logs in, the user sees a set of portlets in a particular layout based on the role. The user can then customize the layout.
Step 1 On the Prime Central for HCS home page, click the Add Applications icon.
On all pages other than the home page, the Add Applications icon is dimmed.
Step 2 In the Add Application dialog box, click Cisco Prime.
Step 3 Select the desired portlet and click Add. Alternatively, drag and drop the portlet to the desired location on the home page.
Step 4 Click the Close (X) icon to close the Add Application dialog box.
Step 5 Click Refresh.
Note It is important to refresh once immediately after adding the portlet using either the browser's refresh button or the refresh icon in Prime Central for HCS.
Maximizing or Minimizing a Portlet
Step 1 To maximize a portlet, click the Maximize icon in the top right corner of the portlet.
Step 2 To exit the maximized view, click the Minimize icon in the top right corner.
Step 3 To minimize a portlet, click the Minimize icon in the top right corner of the portlet.
Step 4 To exit the minimized view, click the Maximize icon in the top right corner.
Removing a Portlet
Step 1 In the top right corner of the portlet, click the Remove icon.
Step 2 At the confirmation prompt, click OK.
Changing the Layout of the Home Page
Step 1 On the Prime Central for HCS home page, click the Change Layout icon.
On all pages other than the home page, the Change Layout icon is dimmed.
Step 2 Click the radio button that corresponds to the desired layout (one column, 50/50, and so on).
Step 3 Click Save.
Note the following layout constraints:
•Large portlets cannot be positioned together in a single row.
•Portlets are not rearranged automatically, unless you choose one of the following options:
–1 col (1 column)
•When a window is minimized or maximized, you cannot drag and drop portlets to rearrange them.
•If you choose the Free layout option, portlets are not aligned automatically; instead, you must rearrange them manually. In contrast with other layouts, the Free layout takes up the entire browser window instead of only the content area.
Managing a Session Timeout
By default, the Prime Central for HCS session times out after 60 minutes of inactivity; you will be prompted to extend the session before your current session terminates. Click the Extend button to extend your session. If you do not extend the session, you will be logged out automatically from Prime Central for HCS and from any domain managers that you are currently logged in.
When a session times out, the login screen appears. When you log back in, you return to the page you were on before the session timed out. It is recommended that you clear your browser cache and delete cookies before logging in again.
To change the session timeout value:
Step 1 Log in as root user.
Step 2 Change directories to the installation-directory/XMP_Platform/apache-tomcat-6.0.32/webapps/SSO/WEB-INF/spring-configuration folder.
Step 3 Use a standard text editor such as vi to open the ticketExpirationPolicies.xml file and configure the timeout value shown in bold in the following xml tag. The range is from 0 to 9223372036854775807 milliseconds.
<!-- This argument is the time a ticket can exist before its considered
Step 4 Save and close the ticketExpirationPolicies.xml file.
Step 5 Log out of the session.
Step 6 As the primeusr user, log into the Prime Central for HCS server with the primeusr password that you specified during the installation.
Step 7 Enter the following commands to restart the Prime Central for HCS server:
Filtering and Searching
Using the filtering and searching option, you can quickly locate the data you require. Filtering helps eliminate unnecessary details, while searching helps you quickly locate data that you want to examine further. This feature can be helpful when working with tables that contain many entries.
Using the Quick Filter
The User Management and Alarm Browser have a Show drop-down list and a Quick Filter option.
Use the Quick Filter to narrow the data in a table:
Step 1 From the Show drop-down list, choose Quick Filter.
Step 2 In the text field for each column, enter the search criteria.
The table data is displayed based on your Quick Filter search criteria.
Using the Advanced Filter
The User Management portlet has a Show drop-down list and an Advanced Filter option.
Figure 2-3 Advanced Filter
To use the Advanced Filter:
Step 1 From the Show drop-down list, choose Advanced Filter.
Step 2 From the Match drop-down list, choose the rule for including items that meet the specified criteria:
•Any—Any of the following criteria must be met.
•All—All of the following criteria must be met.
Step 3 For each criterion, specify the following information:
a. From the first drop-down list, choose the primary match category. The drop-down list contains all columns in the current table.
b. From the second drop-down list, choose the rule to use for this criterion. The options are:
–Contains—The attribute value is returned if it contains the string you entered. The string can be located at the start, end, or middle of the attribute for the match to succeed. For example, if the string is cle, the following values match it in the contains mode: clean, nucleus, circle.
–Does not contain—In this mode, only those attributes that do not contain the given string match. The results are opposite to that of the contains mode. For example, if you enter cle in this mode, clean, nucleus, and circle are rejected, but foot is deemed to match, because it does not contain cle.
–Starts with—The value of the attribute must start with the string you entered. For example, if the string is foot, footwork matches, but afoot does not.
–Ends with—This is the reverse of the starts with case, when a given attribute matches only if the specified string is at the end of the attribute value. In this mode, for example, the string foot matches afoot but not footwork.
–Is empty—Lists the result where there is no value in the field.
–Is not empty—Lists the result where the value is not missing from the field.
–Is exactly (or equals)—This is the most generic mode, in which you can enter a full or partial expression that defines which nodes you are interested in.
–Does not equal—Lists the result that does not equal the specified value.
–Is greater than—Lists the result that is greater than the specified value.
–Is less than—Lists the result that is less than the specified value.
–Is greater than or equal to—Lists the result that is greater than or equal to the specified value.
–Is less than or equal to—Lists the result that is less than or equal to the specified value.
c. The third field either lists the available values or allows you to enter text:
–If a drop-down list is displayed, choose the required entry.
–If an entry field is displayed, enter a string or regular expression for the criterion.
Any entry that is not a regular expression is treated as a string.
Step 4 Click the + icon to add another criterion for this filter.
Step 5 Add additional criteria as required. To remove a criterion, click the - icon.
Step 6 When you have specified all criteria for the filter, click Go.
The table data is displayed using the defined filter.
Step 7 To save the filter parameters for reuse during the current session, click the Save icon. (Filter parameters are not saved for the next time you log into Prime Central for HCS.)
Step 8 To clear a filter, click Clear Filter.
The table is refreshed and all entries are displayed.
To sort data in a table, simply click a column heading. By clicking on the column heading, you can toggle between ascending and descending sort order. The column tooltip indicates whether the column is sortable, not sortable, or currently sorted.
Note You can sort only one column at a time.
A triangle next to the column heading indicates the sort order:
• indicates the column is sorted in ascending order.
• indicates the column is sorted in descending order.
Viewing the Prime Central for HCS Version
To view the Prime Central for HCS version you are running, click the About link on the portal home page.
The About dialog box displays the Prime Central for HCS version. Use the vertical scroll bar to view the Prime Central for HCS build and patch numbers.
Logging Out of the Prime Central for HCS Portal
When you log out of Prime Central for HCS, you are logged out of only Prime Central for HCS and not of the domain managers. You will continue to remain logged in to all domain managers to which you had established a connection. To log out:
Step 1 Click Log Out on the portal home page.
Step 2 At the confirmation prompt, click OK.