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:

  1. Use Ets_Nt_Import_Model_Create() to create a “skeleton” model in memory.
  2. Read topology information from some source (for example, a router configuration file).
  3. 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.
  4. Import the model from memory into an existing network model with Ets_Nt_Import_Model_Convert().
  5. 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.