This chapter describes the software requirements and instructions for installing and integrating Oracle Communications Network Service Orchestration Solution components.
Before you implement the Network Service Orchestration solution, you must identify the required software, ensure that the required network infrastructure is available and ready, and identify the third-party software that you want to use with the solution. Your choices are based on the network services you want to deliver on your network.
Use the following list of tasks as a checklist to ensure that you have all the required components for a successful implementation of the solution:
Install the required software. See "Configuring UIM for the Network Service Orchestration Solution".
Integrate the VIM. See "Integrating the Network Service Orchestration Solution Components".
Integrate the SDN Controller. See "Integrating the SDN Controller With the Solution".
Onboard Network Services and VNFs. See "Designing and Onboarding Network Services and VNFs".
Write extensions for extending the core functionality and integrate third-party software with the solution. See "Using Extension Points and Java Interface Extensions to Extend the Solution".
Integrate client applications with the solution for using the RESTful APIs. For details about the solution's RESTful APIs, see "Network Service Orchestration RESTful API Reference".
To implement the Network Service Orchestration solution, you require the following software:
Oracle Communications Unified Inventory Management 7.3.2.
See UIM 7.3.2 Installation Guide for installation instructions.
Oracle Communications Design Studio 7.3.1.
See Design Studio 7.3.1 Installation Guide for installation instructions.
To configure UIM for the Network Service Orchestration Solution:
Install UIM on a WebLogic server. See UIM 7.3.2 Installation Guide for UIM installation instructions.
Note:
If you are upgrading to UIM 7.3.2 from UIM 7.3.0 or UIM 7.3.1, follow the steps for upgrading from UIM 7.3.x to UIM 7.3.2 in the UIM 7.3.2 Installation Guide.In UIM, deploy the base UIM cartridges in the following order:
ora_uim_baseextpts
ora_uim_basemeasurements
ora_uim_basetechnologies
ora_uim_basespecifications
(Optional) ora_uim_common. Deploy this cartridge if you want to implement a network protection service by using the sample cartridges.
See UIM Cartridge Guide for instructions about deploying cartridges into UIM.
Download the gson-2.2.4.jar file from the following website and copy it to the UIM_Home/lib folder, where UIM_Home is the directory into which UIM is installed:
http://repo1.maven.org/maven2/com/google/code/gson/gson/2.2.4/
Open the Domain_Home/bin/setUIMEnv.sh file and add the following entry, where Domain_Home is the directory that contains the configuration for the domain into which UIM is typically installed:
CLASSPATH="${CLASSPATH}:${UIM_HOME}/lib/gson-2.2.4.jar"
export CLASSPATH
Restart the server on which UIM is installed.
In WebLogic server, deploy the WL_HOME/common/deployable-libraries/jersey-bundle-1.9.war file as a library and specify the target as the server on which UIM is installed.
Go to deploy/individualJarsForSuperJar and deploy the following Network Service Orchestration solution cartridges into UIM in the order they are listed:
OracleComms_NSO_Common
OracleComms_NSO_NFVIAdapter
OracleComms_NSO_BaseCartridge
(Optional) If you want to use the sample cartridges that are provided with the solution, deploy the following sample cartridges into UIM in the order they are listed:
NPaaS_NetworkService
This sample cartridge contains the functionality to implement Network Protection as a network service.
Checkpoint_NG_FW_VNF
This sample cartridge contains the Checkpoint firewall VNF to use with the Network Protection service.
Juniper_vSRX_VNF
This sample cartridge contains the Juniper vSRX firewall VNF to use with the Network Protection service.
In the WebLogic server on which UIM is installed, deploy the deploy/applications/OracleComms_NSO_WebServices.war file as a web application.
To deploy the .war file into WebLogic server:
Copy the custom.ear file from Domain_Home/UIM/app/7_3_2/ to a temporary directory.
Navigate to the temporary directory and expand the custom.ear archive file by running the following command:
jar xvf custom.ear
Delete the custom.ear file and copy the deploy/applications/OracleComms_NSO_WebServices.war file to the temporary directory.
Open the META_INF/application.xml file in a text editor and add the following text:
<module>
<web>
<web-uri>OracleComms_NSO_WebServices.war</web-uri>
<context-root>/ocnso/1.1</context-root>
</web>
</module>
Rebuild the custom.ear file by running the following command:
jar cvf custom.ear *
Log in to Oracle WebLogic Server Console.
Click Lock and Edit.
Click Deployments.
In the Summary of Deployments section, select custom and click Update.
Select Redeploy this application using the following deployment files and click Change Path.
Browse and select the custom.ear file, which is created in the temporary directory.
Click Next.
Click Finish.
Click Activate Changes.
After you install the required software, integrate the solution components. See "Integrating the Network Service Orchestration Solution Components" for more information.
This section describes the steps that you follow to integrate the Network Service Orchestration solution components.
Integrating the solution components involves the following tasks:
Before you integrate the VIM with the solution, ensure that you set up and configure the VIM to use with the solution. After your VIM infrastructure is set up, you register the VIM and discover the VIM resources into the solution.
To register a VIM with the solution:
Ensure that UIM is started and running.
Ensure that the Network Service Orchestration solution cartridges are deployed into UIM.
Start the VIM and ensure that you have the IP address, username, and password of the VIM instance.
In a RESTful API client, call the following RESTful API using the POST method:
http://nso_host:port/ocnso/1.1/vim
where:
nso_host is the IP address of the machine on which UIM is installed
port is the port number of the machine on which UIM is installed
Specify the VIM details in the request. For details about the request parameters, see "Register a VIM" in the "Network Service Orchestration RESTful API Reference" chapter.
The RESTful API client returns a response.
In UIM, verify that a custom object with the details of the VIM is created.
Note:
Register your VIM with the solution only once. Do not register a VIM that you have already registered. In UIM, if there are multiple VIM custom objects that refer to the same VIM, resource orchestration may return errors.You discover VIM resources into UIM so that the solution contains information about the current status and availability of all the required virtual resources on the network. When you discover a VIM, the details of the virtual resources are populated into UIM. In UIM, the VIM is represented as a custom object.
To discover VIM resources into UIM:
In a RESTful API client, call the following RESTful API using the POST method:
http://nso_host:port/ocnso/1.1/vim/discover/vimName
where:
nso_host is the IP address or the domain name of the machine on which UIM is installed
port is the port number of the machine on which UIM is installed
vimName is the name of the VIM that you registered with the solution and whose resources you want to discover
For more details about the request parameters, see "Discover VIM Resources" in the "Network Service Orchestration RESTful API Reference" chapter.
The RESTful API client returns a response.
In UIM, verify that the following entities are created as Custom Objects:
Availability zone
Flavor
Host
VDC
Note:
Whenever you add, upgrade, modify, or delete the compute, memory, and network resources in your NFV Infrastructure (NFVI), run the VIM discovery RESTful API to ensure that details about the currently available resources on your NFVI are reflected correctly in the solution.The Network Service Orchestration solution supports OpenDaylight and provides integration points for integrating other third-party SDN Controllers. See "Implementing a Custom SDN Controller", for more information about implementing a custom SDN Controller.
To integrate your SDN Controller with the solution:
In UIM, create a custom object based on the SDN specification and specify the following details about the SDN Controller that you want to use:
Host
Port number
Username of the SDN Controller
Password of the SDN Controller
Type of the SDN Controller
Associate the VIM custom object as a parent custom object to the SDN Controller custom object.
The Network Service Orchestration solution supports the following southbound integrations:
For VNF management:
VNF Manager, with the ability to manage VNFs through direct integration or by integration with an Element Management System (EMS)
Framework to integrate with external VNF Managers
For Virtual Infrastructure Management
Integration to OpenStack Kilo and Oracle OpenStack for Oracle Linux Release 2
Sample integration to VMware vCloud Director
Framework to integrate to other Virtual Infrastructure Managers
For Network and SDN Controllers:
Integration to OpenStack Neutron (Kilo release)
Sample integration to OpenDaylight