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
•Dynamic inventory updates: when Prime Central receives physical device change notifications from domain managers, it sends notifications to all subscribing domain managers, including Prime Performance Manager, so the Prime Performance Manager device inventory is kept synchronized with the Prime Central inventory.
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.
After you integrate Prime Performance Manager with Prime Central, the following Prime Performance Manager changes occur:
•Users and user logins—Prime Performance Manager users are removed. All logins and user management operations are performed in 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.2 User Guide. Should you later decide to remove Prime Performance Manager from integration with Prime Central, you must enable SSL and recreate the Prime Performance Manager users.
•Alarm management—The following alarm actions are not available in Prime Performance Manager:
–Assign Owner
–Acknowledge/Unacknowledge
–Clear
–Delete
–Clear/Delete
–Change Severity
Note You can only integrate one Prime Performance Manager gateway with Prime Central.
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:
Step 7 Wait two minutes, then start the Prime Central integration layer:
Step 8 Verify the integration,
a. Log into Prime Central. (For Prime Central login procedures, see theCisco Prime Central 1.2 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 "Enabling 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.2 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.2 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 "Enabling 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.2 User Guide for procedures.
The Prime Central Integration tool changes to Import inventory after Prime Performance Manager is integrated with Prime Central. The inventory is imported about fifteen minutes after you complete the integration and restart Prime Performance Manager. You can update the inventory after the Prime Central after the Prime Central Integration Layer is restarted.
Note If you try to import the inventory while the Prime Central Integration Layer is down, the import will fail.
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:
5. Wait around two minutes, then start the integration layer:
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, from selected devices and interfaces in the Prime Central inventory view, and from selected alarms in the Fault Management window.
Following integration, you will likely want to perform other procedures, for example, import devices and begin generating reports.
Table 4-2 Post Integration Commands and Procedures
Task
|
Command or Procedure
|
Remove Prime Performance Manager from Prime Central and return it to a standalone domain manager.
|
ppm primecentralintegration remove
|
Change Prime Performance Manager trap destination from Prime Fault Management to Prime Network.
|
ppm setpctrapdestination
See ppm setpctrapdestination, for command options.
|
Update the device inventory from Prime Central.
|
Using the GUI:
1. From the Administration menu, choose Prime Central Integration.
2. From the Prime Central Integration toolbar, choose Import Inventory.
Note The Prime Central Integration Layer must be running. If not, the import will fail.
Using the CLI:
ppm inventoryimport command.
See ppm inventoryimport, for command options.
|
Adds cross-launch capability to Cisco Prime Network.
|
ppm crosslaunch
See ppm crosslaunch, for command options.
|
Feedback
