Mapping Network Element Processors

To map network elements (NEs) to network element processors (NEPs), you create a new NEP Map entity and configure the entity using the NEP Map editor.

Note:

NEs are packaged with cartridges but are deployed and managed separately.

When mapping NEPs, see the following topics:

• Creating New NEP Map Entities

• Configuring NEP Maps

Creating New NEP Map Entities

You create new NEP Map entities using the NEP Map entity wizard.

To create a new NEP Map entity:

1. Create a Studio Environment project. See "Creating Environment Projects" for more information.

2. In the Studio Projects view, right-click and select New, select Environment, then select NEP Map.

   The NEP Map Wizard appears.

3. Select a Studio Environment project from the list.

4. Select an environment from the Studio Environment list.

   The Studio Environment list contains all of the .sceEnvironment objects in the workspace. By associating the NEP Map entity with the selected Studio environment, the entity can obtain from the environment the ASAP JMX server:port information and the ENV_ID, among other properties.

5. Specify an entity name.

   The system applies a default entity name prefix of M_.

6. (Optional) Select a location for the entity.

   By default, Design Studio saves the entity to your default workspace location. You can enter a folder name in the Folder field or select a location different from the system-provided default. To select a different location:

   1. Click the Folder field Browse button.

   2. Navigate to the directory in which to save the entity.

   3. Click OK.

7. Click Finish to create the entity in the specified location of the project.

   The system creates a new .nepMap object and opens the new entity in the NEP Map editor.

Related Topics

Mapping Network Element Processors

Packaging and Deploying Activation Cartridges

NEP Map Editor

Configuring NEP Maps

You configure NEP maps using the NEP Map editor, which displays a list of all network elements that you have added. After connecting to the environment, you can select a default NEP from the available list for the environment to which the elements will be sent.

When configuring NEP maps, you first connect to your ASAP environment to retrieve the NEP server names. After retrieving the server names, you can configure your NEP maps (in the Mapping Detail area of the NEP Map editor) while connected to the ASAP environment or by working offline in Design Studio.

To retrieve NEP server names:

1. Click Connect to connect to your ASAP environment using your WebLogic Server user name and password.

   Note:

   To connect to your ASAP environment, you must define your connection settings. See "Studio Environment Editor Activation Connection Details Area" for more information. The NEP Map editor retrieves all NEP server names and adds them to the Default NEP list.

2. From the Default NEP list, select an NEP.

3. Click Refresh to retrieve new NEP server names from ASAP that you added while connected to the ASAP system.

   Note:

   Disconnecting and reconnecting also refreshes the NEP list. After you retrieve the NEP list you can disconnect from ASAP and configure the NEP map in Design Studio. However, if you intend to deploy or undeploy network elements after configuring, do not disconnect from ASAP.

To map network elements:

1. In the Network Element Processor Map grid, select a network element.

2. In the Mapping Detail area, select a value from the NEP Server list.

   Your selection determines the value that displays in the NEP column in the Network Element Processor Map grid.

3. Select File, then select Save.

4. Select the element and click Deploy.

   Note:

   You must define the ENV_ID and ASAP_VERSION properties for the ASAP JMX service in the Studio Environment editor. These properties are required for the NEP Map entity to generate JMX-required JNDI context strings. See "Studio Environment Editor Activation Connection Details Area" for more information.

   You can also optionally enable the RESTART_ASAP_SERVERS variable in the Studio Environment editor. Enabling this variable automatically restarts the ASAP servers when you deploy a cartridge. See "Studio Environment Editor Cartridge Management Variables Tab" for more information.

5. Do any one of the following (if you have not enabled the RESTART_ASAP_SERVERS variable):

   • Restart ASAP.

   • Restart the NEP server to which the network element is mapped.

   • Execute the following command:

     asap_utils -option 113
     

Related Topics

Mapping Network Element Processors

Packaging and Deploying Activation Cartridges

NEP Map Editor