- Preface
- Introduction to the Prime Provisioning API
- Getting Started
- Common APIs
- Using Templates
- Monitoring APIs
- MPLS Provisioning
- L2VPN Provisioning
- VPLS Provisioning
- EVC Provisioning
- Traffic Engineering Management Provisioning
- RAN Backhaul Provisioning
- MPLS Transport Profile Provisioning
- GUI to API Mapping
- Implementing a Notification Server
- Scripts
- Prime Provisioning XDE SDK
Prime Provisioning XDE SDK
This appendix gives a brief overview of the Cisco Prime Provisioning XDE SDK (XDE SDK) and explains how to use it. The XDE SDK makes it possible to extend the Prime Provisioning feature set to customize it to meet your needs.
Introduction
The Prime Provisioning XDE SDK is an Eclipse-based plug-in that enables you to extend and test the existing provisioning functionality supplied in Prime Provisioning.
The XDE SDK provides a complete integrated development environment for
System Recommendations
General system requirements for running the XDE SDK are synonymous with those for Eclipse. See eclipse.org.
Java information for Eclipse: http://www.eclipse.org/downloads/moreinfo/jre.php
Installing and Setting Up the Prime Provisioning XDE SDK
To make the Prime Provisioning XDE SDK work as intended, the following steps are recommended in the installation process:
Step 1 Set up your environment.
Before installing Eclipse, you need to make sure that your environment will support Eclipse and the XDE package. This includes:
- Checking the system recommendations: System Recommendations.
- Ensuring that a supported version of Java is installed For this, use the latest version of JRE or JDK.
Step 2 Install the latest Eclipse version.
Go to eclipse.org/downloads/ and look for Eclipse for RCP and RAP developers. This page also contains a link to the Eclipse installation documentation.
Once you have Java and Eclipse installed, it is recommended that you ensure adequate memory is allocated to Eclipse (see System Recommendations).
You can do this by editing the eclipse.ini file
<eclipse-install>/eclipse/eclipse.ini
and changing the last two lines to:
Step 3 Install the XDE SDK Eclipse plug-in.
Step 4 Go to the Prime server:
<isc-install>/resources/xde/packages/std
and copy the provisioning logic files onto the server on which you are running Eclipse/XDE.
Step 5 Import the provisioning logic files into the XDE SDK.
For information about how to import packages into the Eclipse SDK, go to
http://www.eclipse.org/downloads/moreinfo/jre.php
Process Overview
The Prime Provisioning functionality has four main parts:
1. Query phase: The devices involved in the provisioning operation are queried for their current configuration. This determines what configuration is already provisioned on the network.
XDE parses the device profiles and configurations into a set of XML files that can be processed by the provisioning logic.
2. Logic phase: The provisioning logic runs within XDE. XDE processes the existing device configurations and requested service design to create device configuration.
The required device configuration templates are run to generate the actual device configuration.
3. Provisioning phase: XDE creates the minimal required set of commands to provision the service and pushes the configuration to the devices.
4. Audit: The configuration pushed to the devices are audited to make sure it has been applied correctly.
Creating or Modifying Provisioning Logic
It is important to understand the difference between the two basic ways in which the provisioning logic can be changed. It will help you make informed choices, which can reduce risk of introducing errors in the logic.
The provisioning logic can be modified in the following two ways:
Note Cisco Prime Provisioning 6.8 does not support changing the existing provisioning logic.
Note Itβs important to note that direct editing of the provisioning logic may cause Prime Provisioning to fail. This may also put the system into a state where upgrades can no longer be obtains for the product. If in doubt, please contact Cisco.
XDE SDK Functional Tests
The Prime Provisioning XDE SDK includes a range of standardized regression tests that can be used to test whether the new extension point logic has broken the existing provisioning logic.
New tests can also be written to exercise any new provisioning logic and to validate that it works correctly.
With the XDE Eclipse plug-in installed, navigate to the ProvTest package, which contains all the of the functional tests for provisioning. Use this to test what you have developed to make sure that no existing functionality has been broken. It currently contains some 1800 tests and additional tests can be added.