Requisitions
In order to monitor the Velocloud gateways, edges, and links, you need to import these entities into OpenNMS. To do so, create a requisition for a given connection alias. A connection alias can represent a customer connection or a partner connection. While a customer connection only allows you to query for entities associated with the customer itself, a partner connection has access to top-level entities that are shared by customers. All nodes created by a requisition are assigned to the same location controlled by the `location' parameter, which uses the default location if not specified.
Furthermore, a partner connection can also be used to import customer entities by providing the customer’s enterpriseId
as an additional parameter.
Specify the requisition type velocloud-customer
to import all entities of a customer connection:
opennms:import-requisition velocloud-customer alias=aCustomerAlias location=atlantis
Specify the requisition type velocloud-partner
to import all entities of a partner connection:
opennms:import-requisition velocloud-partner alias=aPartnerAlias location=utopia
A customer requisition can be created using a partner connection alias by providing the enterpriseId
as an additional parameter.
The following example demonstrates the creation of a customer requisition by using a partner alias and an additional ´enterpriseId` parameter with the value set to 123
.
opennms:import-requisition velocloud-customer alias=aPartnerAlias,enterpriseId=123
You can specify an additional parameter, foreignSource
, to set the foreign source and requisition name.
The following example creates a customer requisition named My-Customer-Requisition
.
opennms:import-requisition velocloud-customer alias=aCustomerAlias foreignSource=My-Customer-Requisition