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.

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

• method - generic.GenericObject.configureChildInstance

• distinguishedName - svc-mgr

• childConfigInfo - creates and configures the following service parameters:

  • Service object - mirror.Mirror

  • actionMask - specifies the create operation

  • <subscriberPointer> - only subscriber 1 can be assigned

  • <serviceId> - (optional) assigns a unique service ID. If the service ID is not specified, the NFM-P automatically assigns the ID.

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

• method - generic.GenericObject.configureChildInstance

• distinguishedName - svc-mgr:service-${*id}

• childConfigInfo - creates and configures the following service site parameters:

  • Service 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 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

• method - generic.GenericObject.configureChildInstance

• distinguishedName - svc-mgr:service-${*id}

• childConfigInfo - creates and configures the following service site parameters:

  • Service 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

         •   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

• method - generic.GenericObject.configureChildInstance

• 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:

  • Service object - mirror.Mirror

  • actionMask - specifies the create operation

  • <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>