4 Using the Cartridge
This chapter explains how to use the Oracle Communications Network Integrity RESTCONF Network Discovery and UIM Integration cartridge.
Creating a Discover RESTCONF Devices scan
The RESTCONF Network Discovery and UIM Integration cartridge allows you to create a Discover Restconf Devices scan.
To create a Discover Restconf Devices scan:
-
Create a new scan.
See Network Integrity Online Help for more information about creating a new scan.
-
On the General tab, do the following, select Discover Restconf Devices from the Scan Action list.
The Scan Type field displays Discovery.
-
In the Scan Action Parameters section, configure the scan with the following parameters:
-
In the Device Type field, select type of device to discover.
-
In the Authentication field, select type of HTTP Authentication protocol.
- In the SSL field, enable or disable SSL. If you enable SSL, then import the certificate of the RESTCONF server (device) into either Java's trust store or the server's trust store.
- In the Username field, enter username for the authentication protocol.
- In the Password field, enter password for the authentication protocol.
- In the Restconf Port field, provide the port for connection.
- In the Context root field, provide the leading url for Restconf call.
- In the Connect Timeout field, provide the connection timeout value in milliseconds.
- In the Read Timeout field, provide the read timeout value in milliseconds.
- In the Field Filtering field, enable or disable field filtering for REST response.
-
- Provide device IP Address in the Scope field.
- Save and run the scan.
The scan discovers and models logical and physical devices. It also creates a device model for each logical and physical device.
Populating UIM with Discovered Data
The RESTCONF Network Discovery and UIM Integration cartridge allows you to populate UIM with network data discovered by the Discover Restconf Devices discovery action.
To populate UIM with discovered network data:
-
Create a new scan.
See Network Integrity Online Help for more information about creating a new scan.
-
On the General tab of the Create Scan page:
- From the Scan Action list, select Discover Restconf
Devices.
The Scan Type field displays Discovery.
- Select Detect Discrepancies.
- In the Scan Action Parameters area, make any necessary configurations.
- From the Scan Action list, select Discover Restconf
Devices.
- Provide device IP Address in the Scope field.
- Run the discovery scan.
The scan generates Entity+ discrepancies for each discovered device.
- Right-click on the discrepancies you want to populate into UIM and select Correct Restconf Device Discrepancies in UIM.
- Click Submit.
Import Reconciled Data from UIM
To create an Import Restconf Device from UIM scan:
-
Create a new scan.
See Network Integrity Online Help for more information.
-
On the General tab of the Create Scan page, do the following:
- From the Scan Action list, select Import Restconf Device
from UIM.
The Scan Type field displays Import.
- In the Scan Action Parameters, add any filters if required.
- From the Scan Action list, select Import Restconf Device
from UIM.
-
Make any other required configurations.
-
Save and run the scan.
The logical and physical device models are created for each device.