Cisco Prime Performance Manager User Guide, 1.3
Integrating Prime Performance Manager with Prime Central

Table Of Contents

Prime Central Integration

Integrating Prime Performance Manager with Prime Central

Prime Central Integration Considerations and Next Steps


Prime Central Integration


Cisco Prime Central is the presentation tier for the Cisco Prime Carrier Management suite, which includes Cisco Prime Performance Manager, Cisco Prime Network, Cisco Prime Optical, and other domain managers. Prime Central provides a number of centralized features and functions including:

A single point of access (single sign-on) to the Prime Central domain managers.

Central access to the experience lifecycle tasks.

Support for LDAP, TACACS+, and RADIUS authentication plug-ins.

Virtualization on VMware configurations.

Common user management with role-based access control (RBAC).

Grouping-to-domain manager mapping.

Common adopted installation framework.

Database and application monitoring.

Common physical inventory management

Integrating Prime Performance Manager with Prime Central involves the following general tasks:

Running the Prime Central integration (required)

Creating users (required)

Importing Prime Network credentials (optional)

Importing trap destinations (optional)

Procedures are provided in the following topics:

Integrating Prime Performance Manager with Prime Central

Prime Central Integration Considerations and Next Steps

Integrating Prime Performance Manager with Prime Central

Prime Performance Manager can be integrated with Prime Central during Prime Performance Manager installation. If you did not integrate Prime Central with Prime Performance Manager during installation, you can run the integration from the Prime Performance Manager GUI or CLI.

Before You Begin

Verify that Prime Central is installed and running on a server to which you have access.

Verify that you have the Prime Central server database IP address or hostname, port, username, system ID, and password.

Because you must restart the Prime Central integration layer and Prime Performance Manager after the integration, make sure you perform the procedure at a time when restarts can occur.


Note Only one Prime Performance Manager gateway can be integrated with Prime Central.



Note After you integrate Prime Performance Manager with Prime Central, all logins and user management operations are performed from Prime Central. The Prime Performance Manager User Management window is visible with reduced functionality. For information about logins and user management, see the Cisco Prime Central 1.1 User Guide.



Step 1 Log into the Prime Performance Manager GUI as a System Administrator user.

Step 2 From the Administration menu, choose Prime Central Integration.

Step 3 In the Prime Central Integration window, enter the following:

Database Host—Enter the Prime Central database hostname or IP address.

Database SID—Enter the Prime Central database service name, which is primedb by default.

Database User—Enter the Prime Central database username, which is primedba by default.

Database Password—Enter the Prime Central database user password; for example, Test456!

Database Port—Enter the Prime Central database port number, which is 1521 by default.

Step 4 Click the Prime Central Integration Setup tool on the System Prime Central Integration window toolbar.

If the integration information you entered is valid, you are prompted to restart the Prime Central integration layer. If not, an error is returned.

Step 5 Restart Prime Performance Manager gateways and unit(s) by executing the ppm restart command. For information, see Restarting Gateways and Units.

Step 6 Log into the Prime Central server and stop the Prime Central Integration Layer:

itgctl stop

Step 7 Wait two minutes, then start the Prime Central integration layer:

itgctl start

Step 8 Verify the integration,

a. Log into Prime Central. (For Prime Central login procedures, see theCisco Prime Central 1.1 User Guide.)

b. From the Prime Central Administration menu, choose Suite Monitoring.

c. Verify that Prime Performance Manager is listed under Applications and has an Up state.

If Prime Performance Manager is not shown, complete the steps in "Prime Performance Manager Does not Appear in Prime Central" in Table 4-1.

If Prime Performance Manager is shown, but its state is Down, complete the steps in"Prime Performance Manager is Displayed in Prime Central with a Down State" in Table 4-1.

d. From the Prime Central Assure menu, verify that Prime Performance Manager is listed. If not, complete the steps in "Prime Performance Manager Menu Option is Missing" in Table 4-1.

e. From the Prime Central Assure menu, choose Prime Performance Manager. Prime Performance Manager should be cross launched. If not, complete the steps in "Cannot Launch Prime Performance Manager from Prime Central" in Table 4-1.

Step 9 If remote units are connected to the gateway, complete the "Enable SSL on Remote Units" procedure to enable SSL on the remote units.

Step 10 After Prime Performance Manager is integrated with Prime Central, use the Prime Central portal to create new users, even if they already existed in Prime Performance Manager. See the Cisco Prime Central 1.1 User Guide for procedures.


Note When you create a user who previously existed in Prime Performance Manager, Prime Central advises you that the user already exists in Prime Performance Manager, retrieves the user properties, and applies them to the new Prime Central user. For more information, see Managing Users and User Security.



To integrate Prime Performance Manager with Prime Central using the Prime Performance Manager CLI:


Step 1 Log into the Prime Performance Manager gateway server as a System Administrator user.

Step 2 Enter the following command:

ppm primecentralintegration

Step 3 At the prompts, enter the Prime Central server information:

Database Hose—Enter the Prime Central database server IP address or hostname.

Database SID [primedb]—Enter the Prime Central database service name, which is primedb by default.

Database User [primedba]—Enter the Prime Central database username, which is primedba by default.

Database Password [*****]—Enter the Prime Central database user password; for example, Test456!

Database Port [1521]—Enter the Prime Central database port number, which is 1521 by default.

Allow a few minutes for the integration layer restart to complete, then continue with the next step.

Step 4 Restart the Prime Performance Manager gateway and unit(s). See Restarting Gateways and Units.

Step 5 Verify the integration:

a. Log into Prime Central. (For Prime Central login procedures, see theCisco Prime Central 1.1 User Guide.)

b. From the Prime Central Administration menu, choose Suite Monitoring.

c. Verify that Prime Performance Manager is listed under Applications and has an Up state.

If Prime Performance Manager is not shown, complete the steps in "Prime Performance Manager Does not Appear in Prime Central" in Table 4-1.

If Prime Performance Manager is shown, but its state is Down, complete the steps in"Prime Performance Manager is Displayed in Prime Central with a Down State" in Table 4-1.

d. From the Prime Central Assure menu, verify that Prime Performance Manager is listed. If not, complete the steps in "Prime Performance Manager Menu Option is Missing" in Table 4-1.

e. From the Prime Central Assure menu, choose Prime Performance Manager. Prime Performance Manager should be cross launched. If not, complete the steps in "Cannot Launch Prime Performance Manager from Prime Central" in Table 4-1.

Step 6 If remote units are connected to the gateway, complete the "Enable SSL on Remote Units" procedure to enable SSL on the remote units.

Step 7 After Prime Performance Manager is integrated with Prime Central, use the Prime Central portal to create new users, even if they already existed in Prime Performance Manager. See the Cisco Prime Central 1.1 User Guide for procedures.


Table 4-1 lists Prime Central integration issues and resolutions.

Table 4-1 Prime Central Integration Issues and Resolutions 

Problem
Resolution

Prime Performance Manager Does not Appear in Prime Central

1. Log into the Prime Performance Manager gateway as the root user. (See Root User Login.)

2. Display the DMIntegrator log:

/opt/CSCOppm-gw/prime-integrator/DMIntegrator.log

3. In the log, check to see:

Whether Prime Performance Manager registration status, either succeeded or failed.

If registration was successful, whether the Prime Central database server hostname or IP address located in the log [SERVER:] property is correct.

4. If the Prime Central Suite Monitoring table contains a Prime Performance Manager instance, select the row and press the Delete.

5. Wait a few minutes for Prime Central to delete the Prime Performance Manager instance, then complete the "Integrating Prime Performance Manager with Prime Central" procedure, making sure to enter the correct Prime Central database server information.

6. If this does not resolve the problem, call Cisco TAC.

Prime Performance Manager is Displayed in Prime Central with a Down State

1. Restart the Prime Performance Manager gateway and all remote units that are connected to it. See the "Restarting Gateways and Units" procedure.

2. Check the Prime Performance Manager operational status. See the "Displaying Gateway and Unit Status" procedure.

3. Log into the Prime Central workstation as the primeusr UNIX OS user.

4. Stop the Prime Central Integration Layer by entering:

itgctl stop

5. Wait around two minutes, then start the integration layer:

itgctl start

6. After a few minutes, check to see if the Prime Performance Manager state changes to Up in the Suite Monitoring > Applications window.

7. If this does not resolve the problem, call Cisco TAC.

Prime Performance Manager Menu Option is Missing

1. From the Prime Central Administration menu, choose Users.

2. Verify that the logged-in user has Prime Performance Manager in the domain manager access privileges.

3. If not, select the user, click Edit and add Prime Performance Manager to the user's domain privileges. For detailed procedures, see "Edit a User" in the Cisco Prime Central 1.1 User Guide.

4. Log out and then log back in

Cannot Launch Prime Performance Manager from Prime Central

1. Verify that the Prime Performance Manager gateway is up and running. See the "Displaying Gateway and Unit Status" procedure. All services should be running.

2. If not, restart the gateway. See the "Displaying Gateway and Unit Status" procedure.

3. If the problem persists, contact the Cisco TAC.


Prime Central Integration Considerations and Next Steps

After you integrate Prime Performance Manager with Prime Central, keep in mind that all user logins and management—adding, editing, removing—are performed from Prime Central. See the Cisco Prime Central 1.1 User Guide for login and user management procedures, as well as general information about using Prime Performance Manager in the Cisco IP NGN Suite.

When Prime Performance Manager is integrated with Prime Central, Prime Fault Management is imported as a trap destination (if it exists.) If you want to send traps to Prime Network instead, you can use the ppm setpctrapdestination command to send traps to Prime Network instead of Prime Fault Management.

After you integrate Prime Performance Manager with Prime Central, you can launch Prime Performance Manager from the Prime Central menu, selected devices and interfaces in the Prime Central inventory view, and from selected alarms in the Fault Management.

Following integration, you will likely want to perform other procedures, for example, import devices from Cisco Prime Network and begin generating reports.

Table 4-2 Post Integration Commands and Procedures

Command or Procedure
Description

ppm primecentralintegration remove

Removes Prime Performance Manager from Prime Central and returns it to a standalone domain manager.

ppm setpctrapdestination

Changes Prime Performance Manager trap destination from Prime Fault Management to Prime Network. See ppm inventoryimport, for command options.

ppm inventoryimport

Imports the device inventory from Prime Network. See ppm inventoryimport, for command options. To import devices using the Prime Performance Manager GUI, see Importing Devices From Prime Network.

ppm crosslaunch

Adds cross-launch capability to Cisco Prime Network. See ppm inventoryimport, for command options. To install cross-launch capability on Prime Network using the Prime Performance Manager GUI, see Enabling Prime Network Cross-Launching.