Import Sub-Package
The Import sub-package contains functions that can be used to import a full or partial topology into a network model. Partial (or incremental) import means that you can use this sub-package to add sites to an existing network or even modify existing sites in a network. Thus, the Import sub-package is more versatile than an XML topology import (performed using the “ETS XML Package“), which replaces everything in the target network.
The general workflow for using this sub-package involves the following steps:
- Use
Ets_Nt_Import_Model_Create()to create a “skeleton” model in memory. - Read topology information from some source (for example, a router configuration file).
- Using the functions in this sub-package, populate the model in memory with objects that represent those in the source. Assign ports, attributes, and characteristics as needed.
- Import the model from memory into an existing network model with
Ets_Nt_Import_Model_Convert(). - Destroy the model in memory with
Ets_Nt_Import_Model_Destroy().
After the model has been imported into a network model, you can use other ETS packages to further configure it (setting attributes and so on).
When Ets_Nt_Import_Model_Convert() imports a model into a Riverbed Modeler network, it searches the available node models to find a match for each object being converted. During this model matching phase, Modeler looks at each characteristic of a given object. If a characteristic matches the model's self-description, that characteristic's value is added to the model's score. If a model meets or exceeds the cutoff score for the object, the model is selected for use in the network model. A characteristic can have the value EtsC_Nt_Characteristic_Score_Required, in which case the model is not used unless the specified characteristic matches.