Quick Start: VPN Service Model

This Quick Start chapter describes the general usage of the VPN Service Model (VSM). Apply this basic process when using the VSM elements in your client-source code.

Step 1 Plan your VPN implementation scheme and the corresponding functionality in the user interface.

Step 2 Compile the CiscoVpnServiceModel.idl, CiscoVsmExceptions.idl, CiscoVsmBrowser.idl, CiscoVsmFWCreator.idl, CiscoVsmFWModifier.idl, and CiscoVsmSRCreator.idl files with your IDL compiler to produce the respective versions of the CiscoVpnServiceModel, CiscoVsmExceptions, CiscoVsmBrowser, CiscoVsmFWCreator, CiscoVsmFWModifier, CiscoVsmSRCreator modules that are compatible with the target language of your client-source code.

Step 3 Use include or import directives, as appropriate, to ensure the target-language contents generated from your IDL files are available to your executable client-code for its VSM usage.

Step 4 Using the process described in the "Binding to Servers" section and, more specifically, the "VpnInvServer" section, add code to your client-application code that contacts the CORBA Naming Service to bind to the CORBA VpnInvServer object. This returns an object reference to the CiscoVpnServiceModel::VsmServer interface, which is assigned to the vsmServerPtr variable in the sample code. The CORBA context tree is described in "Context Tree" section.

Step 5 With the CiscoVpnServiceModel::VsmServer object, execute either the getVpnInvMrg() or getVpnInvMrgWithAuthentication() operation to get an instance of the VpnInvMgr interface.

Step 6 With the VpnInvMgr constructor operations, construct VSM creator or modifier elements as needed to support the VPN implementation scheme chosen for your client application and add them to or update them in the VPN Inventory repository.

Step 7 With the necessary VSM elements defined, execute the VpnInvMgr::newVPNConnectivityCreator() operation to get a CiscoVsmSRCreator::VsmVPNConnectivityCreator object, or execute the VpnInvMgr::newVPNServiceModifier() to get a CiscoVsmSRCreator::VsmVPNServiceModifier object. With these objects you can, respectively, create a new CiscoVsmBrowser::VsmSRVC object or modify an existing one to create or modify a VPN service.

Note Creator and modifier objects are generally supported by a pair of constructor and destructor operations to manage memory usage, as well as repository-removal operations. Use these operations to manage the usage of all VSM elements. Do not forget to execute to the object-release operations as a matter of standard practice to prevent memory leaks on the server.

Table of Contents

Quick Start: VPN Service Model

Quick Start: VPN Service Model