IMS AAA Server Release 1.1 Administration Guide > Request Routing Rules > Administering Explicit Routing

Administering Explicit Routing

The following section provides step-by-step instructions for administering explicit routing.

• Select Request Routing from the main Administrator panel and select the expansion tool to expose the sub-panels. Figure 90 shows the Request Routing main dialog.

Figure 90: Request Routing Main Dialog

From this dialog you can:

• Click Refresh to refresh the list of explicit routing rules.
• Click Apply to apply the changes you have made to the explicit routing rules.
• Click Reset to reset any changes you have made to the explicit routing rules. This feature operates only before you have applied the changes using the Apply button.
• Click Add to add an explicit routing rule.
• Click Edit to edit an explicit routing rule.
• Click Remove to remove the selected explicit routing rule.
• Click the Up/Down arrow buttons to move the selected rule up or down in the priority order.
  

  NOTE: After Adding, Editing, or Removing a routing rule, you must click Apply to save your configuration. You can reset the changes you have made by clicking Reset, only if you have not applied the changes yet by clicking Apply. Once you Reset or Apply your changes, you can click Refresh to refresh the list of explicit routing rules.

  
  

Adding Explicit Routing Rules

1. From the Request Routing main dialog, select the routing rules for which you want to define an explicit route.

Referring to Figure 90, the content frame will display any explicit routing rules already defined for the request type in the upper half of the dialog, any implicit routing rules are displayed in the lower half of the dialog.

2. Click Add to add a new routing rule.

The Add Explicit Routing Rule dialog opens for the selected routing rules. Figure 91 shows this dialog for authorization requests. The dialog is the same for all requests, only the respective target varies.

Figure 91: Add Explicit Routing Rule Dialog

3. Use the pulldown menu in the Target field to select the target for the rule.

Table 27 shows the targets for each request type.

Table 27: Request Type and Target

Request Type	Target
Authentication	HSS Downstream (RADIUS or Diameter server)
Authorization	Downstream (Diameter server)
Accounting	CDF
WAG	WAG

4. Click Add to add the rule condition.

The Add Condition dialog opens (Figure 92).

Figure 92: Add Rule Condition Dialog

5. Select the Condition you want to test for.

The following sections explain the dialogs for each condition. Proceed to one of the following sections:

• Configuring Standard Application Identifier Conditions
• Configuring Customized Application Identifier Conditions
• Configuring User Identity Conditions
• Configuring Realm Name Conditions
• Configuring Service Scenario Conditions
• Configuring Dictionary Attribute Conditions

Configuring Standard Application Identifier Conditions

Refer to Standard Application Identifier for a description of this option.

1. Select Standard Application Identifier from the Add Condition dialog and click Next.

The Add Condition dialog for Standard Application Identifier Condition opens (Figure 93).

Figure 93: Add Condition Dialog for Standard Application Identifiers

2. Select either is equal to or is not equal to in the Condition Test field.
3. Select the Application Identifier by using the pulldown in the Value field.
4. Click Finish.

The condition rule is added to the list of conditions.

5. Click OK to add the routing rule to the explicit routing rules and return to the Request Routing main dialog (Figure 90) where the condition rule is now displayed in the list of explicit routes.
6. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
7. Click Apply to save the configuration to the server.

Configuring Customized Application Identifier Conditions

Refer to Customized Application Identifier for a description of this option.

1. Select Customized Application Identifier from the Add Condition dialog and click Next.

The Add Condition dialog for Customized Application Identifier Condition opens (Figure 94).

Figure 94: Add Condition Dialog for Customized Application Identifier Conditions

2. Select either is equal to or is not equal to in the Condition Test field.
3. Enter the Application Identifier in the Value field.
   

   NOTE: You must enter a valid Application Identifier.

   
   
4. Click Finish.

The condition rule is added to the list of conditions.

5. Click OK to add the rule to the explicit routing rules and return to the Request Routing main dialog (Figure 90) where the condition rule is now displayed in the list of explicit routes.
6. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
7. Click Apply to save the configuration to the server.

Configuring User Identity Conditions

This option allows you to specify the route based on the user identity, for example the IMSI or User Name value contained in the request. Refer to User Identity for a description of this option.

1. Select User Identity from the Add Condition dialog and click Next.

The Add Condition dialog for User Identity opens (Figure 95).

Figure 95: Add Condition Dialog for User Identity Conditions

2. Select the condition to test for in the Condition Test field.
3. Enter the identity to test for in the Value field.
4. Click Finish.

The condition rule is added to the list of conditions.

5. Click OK to add the rule to the explicit routing rules and return to the Request Routing main dialog (Figure 90) where the condition rule is now displayed in the list of explicit routes.
6. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
7. Click Apply to save the configuration to the server.

Configuring Realm Name Conditions

Refer to Realm Name for a description of this option.

1. Select Realm from the dialog and click Next.

The Add Condition dialog for Realm opens (Figure 96).

Figure 96: Add Condition Dialog for Realm Conditions

2. Select the condition to test for in the Condition Test field.
3. Enter the Realm value to test for in the Value field.
4. Click Finish.

The condition rule is added to the list of conditions.

5. Click OK to add the rule to the explicit routing rules and return to the Request Routing main dialog (Figure 90) where the condition rule is now displayed in the list of explicit routes.
6. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
7. Click Apply to save the configuration to the server.

Configuring Service Scenario Conditions

Refer to Service Scenario for a description of this option.

1. Select Service Scenario from the Add Condition dialog and click Next.

The Add Condition dialog for Service Scenario Condition opens (Figure 97).

Figure 97: Add Condition Dialog for Service Scenario Conditions

2. Select the condition to test for in the Condition Test field.
3. Select the Service Scenario to test for by using the pulldown in the Value field.
4. Click Finish.

The condition rule is added to the list of conditions.

5. Click OK to add the rule to the explicit routing rules and return to the Request Routing main dialog (Figure 90) where the condition rule is now displayed in the list of explicit routes.
6. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
7. Click Apply to save the configuration to the server.

Configuring Dictionary Attribute Conditions

Refer to Dictionary Attribute for a description of this option.

1. Select Dictionary Attribute from the Add Condition dialog and click Next.

The Add Condition dialog for Dictionary Attribute conditions opens (Figure 98).

Figure 98: Add Condition Dialog for Dictionary Attribute Conditions

2. Select the attribute to test for by using the pulldown in the Attribute field.
3. Select the condition to test for in the Condition Test field.
4. Enter the value of the attribute to test for in the Value field.
5. Click Finish.

The condition rule is added to the list of conditions.

6. Click OK to add the rule to the explicit routing rules and return to the Request Routing main dialog (Figure 90) where the condition rule is now displayed in the list of explicit routes.
7. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
8. Click Apply to save the configuration to the server.

Editing Explicit Routing Rules

To edit an explicit routing rule:

1. From the Request Routing main dialog (Figure 90), select the Routing Rules you want to edit.
2. Select the explicit routing rule to be edited.
3. Click Edit.

The Edit Explicit Routing Rule dialog opens for the request type, either authentication, authorization, accounting or WAG. Figure 99 shows the dialog for authentication request explicit routing rules.

Figure 99: Example Edit Explicit Routing Rule Dialog

4. Select the condition to be edited and click Edit.

An edit dialog appropriate for the condition opens. As an example, Figure 100 shows the edit dialog for the Standard Application Identifier condition. The condition specific edit dialogs display all the same fields as when adding a condition. Refer to the specific condition procedures under Adding Explicit Routing Rules for details of these fields.

Figure 100: Example Edit Explicit Routing Rule Dialog- Condition Specific

5. Make your changes according to the procedures described in Adding Explicit Routing Rules.
6. Click OK to add the edited routing rule to the list of explicit routing rules.

The edited rule is displayed in the list of explicit routes.

7. To re-order the list of explicit routing rules, select each route and use the Up/Down arrows to place the rules in the desired order.
8. Click Apply to save the configuration to the server.

Removing Explicit Routing Rules

To remove an explicit routing rule:

1. From the Request Routing main dialog (Figure 90), select the routing rules you want to edit.
2. Select the explicit routing rule to be deleted.
3. Click Remove.

The explicit routing rule is removed from the list.

4. Click Apply to save your changes.