This chapter describes the Design View in the Cisco Voice Routing Center (VRC) application.
In the Design View you can:
You can open a new design or an existing design. When you open:
Read this information before you begin to use the Design View functions.
This chapter contains the following sections:
This section describes how to open a previously saved dial plan design. The list of previously saved design files can be any of the following file types:
To open an existing dial plan design, follow these steps:
Step 1 From the VRC window, click the Design menu and choose the Open Saved Design option. The Open Stored Design File window appears and displays a list of previously saved dial plans (Figure 5-1).
Step 2 Select the dial plan and click Open Design File. A design session opens and the saved dial plan is displayed.
|Note You receive an error message if you are not authorized to open the selected dial plan. For more information, see "CNS Security Services Administration."|
Step 3 To see the scope of the AD, expand the regions and the elements within the regions.
Step 4 Modify the dial plan design.
Step 5 You can close and save the design session again if you want to complete the dial plan.
VRC uses the Discovery operation to create a new design based on the current actual configuration of the network elements. The discovered dial plan design does not become part of the baseline until it is committed. When you execute a Discovery from the Baseline View, a Design View session opens with the discovered dial plan displayed.
|Note You must execute your first Discovery at the AD level.|
During the Discovery operation, VRC does the following:
Read this information before you begin the Discovery operation.
To discover a dial plan, follow these steps:
Step 1 Select the AD.
Step 2 Right-click the AD and choose Discover from the menu. The Open Discovery Design Session dialog box appears. You are prompted for the CSR route type.
Step 3 From the drop-down menu choose the CSR route type. Values are None (the default), Carrier, and Trunk-Label.
If you choose:
Step 4 Choose a normal or forced Discovery operation. Checking the box results in a forced Discovery.
Step 5 Click Discover. The VRC reads the running configurations for the elements and the dial plan information for the AD. Or click Cancel to cancel the operation.
Step 6 Click Continue to display the dial plan in a discovery design session window.
|Note The running configuration for all discovered elements is stored in the origconfig directory, even if the Discovery is discarded.|
|Note The discovery process produces a design that is comparative, but not identical, to the configuration that is generated by VRC. If you want the configuration stored on the VRC server to exactly reflect the discovered dial plan, use the Distribution process. For more information on Distribution, see Distributing the Dial Plan.|
A new dial plan design allows you to add elements, make administrative changes to a new dial plan, and apply those changes to the elements.
To configure a new dial plan design, follow these steps:
Step 1 Choose the Design From Baseline option from the Design menu. The Open New Design View window appears (Figure 5-2).
Step 2 Select a Design Scope. Choose the AD or a particular region.
Step 3 Click Open. A Design View session opens.
|Note You can close and save the design session if you want to complete the dial plan design.|
You can use the copy and paste command to add certain entities to the dial plan. For example, if you have one gatekeeper group in a region and want to add another gatekeeper group with the same attributes, use copy and paste.
The copy command creates a gatekeeper group with the same attribute information. The paste command adds this new gatekeeper group to the dial plan. After you paste the gatekeeper group, you must change the Name entry field. You cannot have two entities with the same name.
You can only use copy and paste to add like entities to the appropriate parent in the dial plan. For example, you cannot copy a server trigger and paste it into a region, you cannot copy a gatekeeper group and paste it into the AD, or you cannot copy a gatekeeper group and paste it in a region as a directory gatekeeper group.
The following dial plan entities can only be added by using the right-click menu:
|Note You must be in the Design View to copy and paste entities into the dial plan.|
To copy and paste dial plan entities, follow these steps:
Step 1 Expand the AD to view the entities in the dial plan.
Step 2 Select the dial plan entity that you want to duplicate.
Step 3 Right-click and choose Copy from the menu.
Step 4 Select the appropriate parent in the dial plan you want to add this duplicated entity to.
Step 5 Right-click and choose Paste from the menu.
Step 6 Click the Attributes tab.
Step 7 Right-click and choose Edit from the menu.
Step 8 Edit the attribute information. You must edit the Name attribute. You cannot have two dial plan entities with the same attribute information.
Step 9 Choose Refresh Display from the Window menu to update the design session display. The duplicated entity is added to the dial plan.
This section describes how to preview a new dial plan design before you commit the design to the elements.
|Note You must be in the Design View to preview a design and the design must be open.|
To preview a new dial plan design, follow these steps:
Step 1 Choose the Preview option from the Design menu and then choose either the Normal Preview or Forced Preview option.
Step 2 The Creating design preview window appears. Wait until the system is finished loading the design. VRC creates a design preview. The location of the preview files on the VRC server is displayed.
|Note You must Telnet to the VRC server to view the preview files.|
You can export a dial plan for an AD or for a region.
|Note You must be in the Design View to export a design and the design must be open.|
To export a dial plan design for an AD, follow these steps:
Step 1 Locate the AD.
Step 2 Choose the Export Design option from the Design menu.
To export a dial plan design for a region, follow these steps:
Step 1 Expand the AD to view all elements.
Step 2 Select a region to export the dial plan from.
Step 3 Right-click the region and choose Export from the menu.
The Exporting design dial plan window appears during this process. An information message indicates that the operation was successful.
Step 4 Click OK. A browser window opens showing the dial plan in a text format.
Validation is the mechanism by which VRC detects and prevents illegal or inconsistent data from being written to the dial plan or sent to the network elements. This action validates the entire design scope. VRC also validates the dial plan design during the Discovery and Commit operations.
|Note The dial plan design that you want to validate must be open.|
To validate a dial plan design, follow these steps:
Step 1 Choose the Validate option from the Design menu. An information dialog box appears, informing you that the design is being validated.
|Note During the validation process, VRC does not check the state of an element in a foreign region.|
You are returned to the Design View to make any necessary changes.
Validation is the mechanism by which VRC detects and prevents illegal or inconsistent data from being written to the dial plan or sent to the network elements. When errors are detected by validation, messages are produced and presented to the user through the client and through the server logs (system, audit, and internal).
Validation is executed implicitly as part of some design operations and explicitly when Validate is chosen from the Design menu. The appropriate recourse for troubleshooting validation errors and warnings depends on the type of operation being performed.
Certain elements (gateways, gatekeepers, directory gatekeepers, managed regions, foreign regions, managed zones, ingress routes, and egress routes) have "status" attributes which indicate the severity (Fatal, Warning, Ok) of the most significant validation message produced for those components. Those in a "Fatal" or "Warning" state are flagged in the GUI dial plan tree as either red or yellow, respectively.
For network elements, you might only be able to correct certain errors by reactivating the element. For example, if a gateway has the "reactivate" attribute set as "yes", or an element has a required read-only field such as "h323id" not set at all, then an error is produced during validation. In these examples, the failed element must be explicitly reactivated by the user to set these attributes to a state in which they can be committed.
When you encounter validation error messages, use the console to set the debug of the Validation subsystem to On.
Cisco VRC sets a flag next to an element in the client if an error is encountered during the validation process. The status field for that element indicates whether the Cisco VRC server can contact the element during the Validation process. The following flags can be set to an element:
|Note You cannot commit a dial plan design that has red flags.|
|Note You can commit a dial plan design that has yellow flags, but you should modify your design to correct the problem indicated by the warning message before you commit the design to the network.|
|Note You can commit a dial plan design with blue flags.|
Before Cisco VRC can send a dial plan configuration to an element, the software must convert the dial plan model to a format that an element can understand, the command line interface (CLI).
During CLI generation of an element, VRC extracts all dial plan information that is relevant to that element and dynamically creates an XML file for that element. For example, during CLI generation for a particular gateway, VRC must extract all dial plan information that directly affects the configuration of that gateway. This information can include voice class codecs assigned to the region where the gateway resides, translation rules or profiles assigned to the managed zone in which the gateway resides, and voice ports on that gateway.
A static configuration file for each element type, which is located on the VRC server, defines how the information in the XML file is translated to CLI. VRC uses this static configuration file and the information in the XML file to generate the CLI configuration. The generated CLI configuration is used to distribute the dial plan to the running configuration for that element.
VRC distributes the configuration to the network elements in the following order:
3. Directory gatekeepers
Each time you make a change to your dial plan, the CLI-generated configuration for the elements affected by the dial plan changes. To see how changes in your dial plan have affected the CLI-generated configuration, you must generate a new CLI to view.
This section describes how to view a generated CLI of an element. The generated file is displayed in text format. You can view a generated CLI for an element in the Baseline View or the Design View.
To view a CLI, follow these steps:
Step 1 Expand the Administrative Domain (AD) to view all elements.
Step 2 Locate the element that you want to generate a CLI configuration for.
Step 3 Right-click the selected element.
Step 4 Choose View Generated CLI. A generated CLI for the selected element is displayed in a separate browser window.
This section describes how to open a Telnet session from the CLI to communicate with a specific element.
|Note You must be in the Design View to open a CLI session for an element.|
To open a CLI session, follow these steps:
Step 1 Expand the AD to view all elements.
Step 2 Locate the element that you want to open a CLI session for.
Step 3 Right-click the selected element.
Step 4 Choose Open CLI Console from the menu. A CLI console window opens and you are prompted for the password.
The Telnet application registered with your browser presents a standard Telnet session interface to allow you to perform direct administration on the selected network element.
The CLI console window closes.
This section describes how to commit a dial plan design to your network and establish a baseline dial plan.
We recommend that you use the Preview option before you commit a design.
|Note When you commit a design, VRC replaces the existing dial plan configuration for all elements in the design whose dial plan configuration has changed and updates the baseline dial plan. For example, changing a dial plan in one region might affect elements in other regions.|
|Note The dial plan design that you want to validate must be open.|
To commit your dial plan to the network, follow these steps:
Step 1 When your design is complete, choose the Commit This Design option from the Design menu.
A Confirm dialog box appears. When you commit a design, the baseline dial plan is also updated.
Step 2 Click OK to confirm your commit or click Cancel to return to the Design View window.
During the dial plan commit process, the VRC validates the elements and then generates a baseline dial plan for the affected elements.
During the dial plan generation process, VRC:
|Note If you have one or more gateways with the Reactivate field set to Yes, you cannot commit a design. To reactivate a gateway, right-click the selected gateway and choose Reactivate from the menu.|
An information message indicates that the operation has successfully completed.
Step 3 Click OK. The Design View window closes.
This section describes how to delete a dial plan design from the server storage.
|Note You can delete a design file in any view.|
To delete a dial plan design, follow these steps:
Step 1 Choose the Delete This Design option from the Design menu. The Delete Stored Design File window appears.
Step 2 Click the desired dial plan from the list that you want to delete.
Step 3 Click the Delete This Design File button. You are asked to confirm the delete. Click OK.
Use this option to find terminating gateways, for a given dial string, using the baseline dial plan.
To find terminating gateways, follow these steps:
Step 1 From the Baseline menu, choose Find Terminating Gateways.
A dialog box appears (Figure 5-3).
Step 2 Enter the incoming dialed string that you want to find the terminating gateway for. Use only digits in your dial string, leaving out dashes and dots. You can enter only a prefix for your string.
Step 3 If the CSR route type for the AD is set to carrier or trunk-label, select a target carrier. Choose a target carrier from the drop-down menu.
Step 4 Click OK. VRC displays the gateways used to terminate routed calls for this dial string.
Step 5 Click Cancel to return to the VRC window.
When you finish working on a dial plan design, you can either store the design or discard the design.
|Note You must be in the Design View and have a design open to perform this procedure.|
To close a dial plan design, follow these steps:
Step 1 Choose the Close This Design option from the Design menu.
The Closing Design dialog box appears.
Step 2 Choose one of the following closing methods:
|Note If your Design session originated using the Discovery operation, you cannot save the design.|
A message appears to indicate that the operation was successful.
Step 3 Click OK to close the Design View window.
Posted: Mon Oct 14 09:54:25 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.