Mirror service configuration
Workflow
See the “Mirror services” chapter of the NSP NFM-P Classic Management User Guide for information about the prerequisites and workflow to create a mirror service. The following describes the workflow to create a mirror service.
1 |
Create a mirror service. |
2 |
Create a mirror service destination with a source far end and an access interface. This is the mirror destination on router A in Figure 19-13, Remote service mirroring . |
3 |
Create a mirror service source site with a spoke SDP binding and a source port. This is the mirror source on router B in Figure 19-13, Remote service mirroring . |
Examples
The following example shows XML requests to create a remote mirror service that contains a destination site with the far end address of the source and an access interface, and another request to create source site with a spoke SDP binding.
Mirror service creation parameters
Figure 19-14: Simple mirror service creation request example
<generic.GenericObject.configureChildInstance xmlns="xmlapi_1.0"> |
<deployer>immediate</deployer> |
<synchronousDeploy>true</synchronousDeploy> |
<distinguishedName>svc-mgr</distinguishedName> |
<childConfigInfo> |
<mirror.Mirror> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<subscriberPointer>subscriber:1</subscriberPointer> |
.. |
</mirror.Mirror> |
</childConfigInfo> |
</generic.GenericObject.configureChildInstance> |
Mirror service destination site creation parameters
-
childConfigInfo - creates and configures the following service site parameters:
-
<mirrorSiteType> - for a destination site, select destination
<children-Set> - tag to enclose child objects
• Source far end object - mirror.RemoteSource
• actionMask - specifies the create operation
• <remoteSourceSiteId> - IP address of the source NE
• Access interface object- mirror.L2AccessInterface
• actionMask - specifies the create operation
• <portPointer>- assigns a access port. See the Parent Hierarchy of the port or channel object such as equipment.PhysicalPort for the FDN.
• <innerEncapValue>/<outerEncapValue> - assigns encapsulation values
Figure 19-15: Mirror service destination creation request example
<generic.GenericObject.configureChildInstance xmlns="xmlapi_1.0"> |
<deployer>immediate</deployer> |
<synchronousDeploy>true</synchronousDeploy> |
<distinguishedName>svc-mgr:service-732</distinguishedName> |
<childConfigInfo> |
<mirror.Site> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<siteId/> |
<mirrorSiteType>destination</mirrorSiteType> |
<children-Set> |
<mirror.RemoteSource> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<remoteSourceSiteId/> |
</mirror.RemoteSource> |
<mirror.L2AccessInterface> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<portPointer/> |
<innerEncapValue/> |
<outerEncapValue/> |
</mirror.L2AccessInterface> |
</children-Set> |
</mirror.Site> |
</childConfigInfo> |
</generic.GenericObject.configureChildInstance> |
Mirror service source site creation parameters
-
childConfigInfo - creates and configures the following service site parameters:
-
<children-Set> - tag to enclose children objects
• SDP binding object - svt.MirrorSdpBinding
• actionMask - specifies the create operation
• <tunnelSelectionTerminationSiteId> - assigns the termination site ID of the • SDP binding
• Source port object - mirror.SourcePort
• actionMask - specifies the create operation
• <portName> - mirror source port name
Figure 19-16: Mirror service source creation request example
<generic.GenericObject.configureChildInstance xmlns="xmlapi_1.0"> |
<deployer>immediate</deployer> |
<synchronousDeploy>true</synchronousDeploy> |
<distinguishedName>svc-mgr:service-732</distinguishedName> |
<childConfigInfo> |
<mirror.Site> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<siteId/> |
<mirrorSiteType>source</mirrorSiteType> |
<children-Set> |
<svt.MirrorSdpBinding> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<tunnelSelectionTerminationSiteId/> |
</svt.MirrorSdpBinding> |
<mirror.SourcePort> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<portName/> |
</mirror.SourcePort> |
</children-Set> |
</mirror.Site> |
</childConfigInfo> |
</generic.GenericObject.configureChildInstance> |
The following example outlines what is required for an XML request to create a remote mirror service that contains a destination site with the far-end address of the source and an access interface, and a source site with a spoke SDP binding, in one request.
Mirror service creation parameters
-
distinguishedName - svc-mgr. To determine the FDN, check the Parent Hierarchy of the class to be created in the XML API Reference
-
childConfigInfo - creates and configures the following service parameters:
-
<subscriberPointer> - only subscriber 1 can be assigned. See the Parent Hierarchy of the class subscr.Subscriber for the FDN.
-
<serviceId> - (optional) assigns a unique service ID. If the service ID is not specified, the NFM-P automatically assigns the ID.
-
<children-Set> - tag to enclose children objects
• Destination site object - mirror.Site
• actionMask - specifies the create operation
• <siteId> - IP address of the destination NE
• <mirrorSiteType> - for a destination site, select destination
• <children-Set> - tag to enclose children objects
• Source far end object- mirror.RemoteSource
• <remoteSourceSiteId> - IP address of the source NE
• Access interface object - mirror.L2AccessInterface
• <portPointer> - assigns an access port. See the Parent Hierarchy of the port or channel object such as equipment.PhysicalPort for the FDN.
• <innerEncapValue>/<outerEncapValue> - assigns encapsulation values
• Source site object - mirror.Site
• actionMask - specifies the create operation
• <siteId> - IP address of the source NE
• <mirrorSiteType> - for a source site, select source
• <children-Set> - tag to enclose children objects
• SDP binding object - svt.MirrorSdpBinding
• <tunnelSelectionTerminationSiteId> - assigns the termination site ID of the SDP binding
• Source port object - mirror.SourcePort
• <portName> - mirror source port name
The following figure shows an example of a request to create a mirror service, including the source, destination, and SDP binding
Figure 19-17: Complete mirror service creation request example
<generic.GenericObject.configureChildInstance xmlns="xmlapi_1.0"> |
<deployer>immediate</deployer> |
<synchronousDeploy>true</synchronousDeploy> |
<distinguishedName>svc-mgr</distinguishedName> |
<childConfigInfo> |
<mirror.Mirror> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<subscriberPointer>subscriber:1</subscriberPointer> |
<children-Set> |
<mirror.Site> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<siteId/> |
<mirrorSiteType>destination</mirrorSiteType> |
<children-Set> |
<mirror.RemoteSource> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<remoteSourceSiteId/> |
</mirror.RemoteSource> |
<mirror.L2AccessInterface> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<portPointer/> |
<innerEncapValue/> |
<outerEncapValue/> |
</mirror.L2AccessInterface> |
</children-Set> |
</mirror.Site> |
<mirror.Site> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<siteId/> |
<mirrorSiteType>source</mirrorSiteType> |
<children-Set> |
<svt.MirrorSdpBinding> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<tunnelSelectionTerminationSiteId/> |
</svt.MirrorSdpBinding> |
<mirror.SourcePort> |
<actionMask> |
<bit>create</bit> |
</actionMask> |
<portName/> |
</mirror.SourcePort> |
</children-Set> |
</mirror.Site> |
</children-Set> |
</mirror.Mirror> |
</childConfigInfo> |
</generic.GenericObject.configureChildInstance> |