Professional Documents
Culture Documents
Memotec Inc.
7755 Henri Bourassa Blvd. West Montreal, Quebec Canada H4S 1P7 Tel.: (514) 738-4781 FAX: (514) 738-4436 www.memotec.com
Contents
Chapter 1: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1. 1 Using CXTool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1.1.1 1.1.2 1.1.3 1.1.4 1. 2 CXTool Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Organization of this User Guide . . . . . . . . . . . . . . . . . . . . . . . 1-3
Preparing your PC for Installing CXTool . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 1.2.1 1.2.2 1.2.3 Removing a Previous Version of CXTool . . . . . . . . . . . . . . . . 1-4 Uninstalling CXTool in Windows Vista . . . . . . . . . . . . . . . . . . 1-5 Uninstalling using CXTool . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
1. 3
1. 4
Configuring your CXTool Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 1.4.1 Configuring Global Information Options . . . . . . . . . . . . . . . . . 1-8
Chapter 2: CXTool User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 2. 1 2. 2 2. 3 2. 4 2. 5 Product Configuration dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Main CXTool Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 Toolbar Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 The Three Main Window Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 2.5.1 2. 6 Using the Stack Navigation Panel . . . . . . . . . . . . . . . . . . . . 2-19
About the CXTool Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20 2.6.1 2.6.2 2.6.3 2.6.4 2.6.5 2.6.6 2.6.7 2.6.8 2.6.9 2.6.10 Generate Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20 Generate Multiple Configurations . . . . . . . . . . . . . . . . . . . . . 2-20 Upgrade Multiple Configuration Revisions . . . . . . . . . . . . . . 2-20 Modify Multiple Configurations . . . . . . . . . . . . . . . . . . . . . . . 2-21 Display Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21 Download Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22 Check Script Execution Results . . . . . . . . . . . . . . . . . . . . . 2-26 Configuration Revision Upgrade . . . . . . . . . . . . . . . . . . . . . 2-28 Device Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29 Voice Capability Migration . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29
Memotec Inc.
2.6.11 2.6.12
Safe Update Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30 Recommended Use of the Safe Update feature . . . . . . . . . . 2-33
Chapter 3: Working with Scripts in CXTool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1 3. 1 Generating Configuration Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2 3.1.1 3.1.2 3.1.3 3.1.4 3.1.5 3.1.6 3. 2 3. 3 Generate Multiple Configurations . . . . . . . . . . . . . . . . . . . . . . 3-2 Modify Multiple Configurations . . . . . . . . . . . . . . . . . . . . . . . . 3-4 Changing the Software Revision in the Configuration File . . . 3-6 Upgrade Multiple Configuration Revisions . . . . . . . . . . . . . . . 3-7 Changing the Device Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Changing the Voice Capability of a Configuration File . . . . . . 3-9
Viewing a Configuration Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10 Downloading a Configuration Script to a Device . . . . . . . . . . . . . . . . . .3-11 3.3.1 Check Script Execution Results . . . . . . . . . . . . . . . . . . . . . . 3-14
3. 4 3. 5
Memotec Inc.
List of Tables
Table 1-1: User Guide chapter structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Table 1-2: Global Options fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Table 2-1: Hardware Configuration fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Table 2-2: File menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 Table 2-3: View menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 Table 2-4: 'Edit' menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 Table 2-5: Tools' menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 Table 2-6: Window' menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14 Table 2-7: 'Help' menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14 Table 2-8: CXTool toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15 Table 2-9: Configuration Download fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23 Table 2-10: Supported Device Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29 Table 2-11: Supported Voice Capability Migration . . . . . . . . . . . . . . . . . . . . . . . . . 2-29 Table 2-12: Safe Update panel fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-31 Table 3-1: Modify Multiple Configurations dialog box . . . . . . . . . . . . . . . . . . . . . . . . 3-4 Table 3-2: Modify Multiple Configurations dialog box fields. . . . . . . . . . . . . . . . . . . . 3-5 Table 3-3: Upgrade Multiple Configurations dialog box. . . . . . . . . . . . . . . . . . . . . . . 3-7 Table 3-4: Upgrade Multiple Configurations dialog box fields . . . . . . . . . . . . . . . . . . 3-7 Table 3-5: Supported Device Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Table 3-6: Supported Voice Capability Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Table 3-7: Safe Update panel fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Memotec Inc.
List of Figures
Figure 1-1: Add/Remove Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Figure 1-2: Customer Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Figure 1-3: Global Options panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Figure 2-1: Product Configuration dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Figure 2-2: CX900s/CX950e/CX960e HW Configuration . . . . . . . . . . . . . . . . . . . . . . 2-3 Figure 2-3: CX2000 HW Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Figure 2-4: CX-U HW Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Figure 2-5: Opening an Existing Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Figure 2-6: Opening a Recently opened file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Figure 2-7: Converting the CXTool file version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9 Figure 2-8: Conversion Error message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9 Figure 2-9: CXTool Main Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 Figure 2-10: Empty Main panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 Figure 2-11: Opening a module in the Module Navigation panel . . . . . . . . . . . . . . . 2-17 Figure 2-12: 24 IP Module Configuration panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18 Figure 2-13: Main panel with the new entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19 Figure 2-14: Stack Navigation panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19 Figure 2-15: Progression of the configuration creation. . . . . . . . . . . . . . . . . . . . . . . 2-20 Figure 2-16: Commands from the configuration script . . . . . . . . . . . . . . . . . . . . . . . 2-21 Figure 2-17: Error when showing configuration script . . . . . . . . . . . . . . . . . . . . . . . 2-22 Figure 2-18: Connection type when downloading. . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22 Figure 2-19: Downloading Configuration panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23 Figure 2-20: Configuration Download in progress . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24 Figure 2-21: Configuration Download Completed Message . . . . . . . . . . . . . . . . . . . 2-25 Figure 2-22: Connection Type for Check Execution Script. . . . . . . . . . . . . . . . . . . . 2-26 Figure 2-23: Check Execution Completed Message . . . . . . . . . . . . . . . . . . . . . . . . 2-27 Figure 2-24: Script Execution Result Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27 Figure 2-25: Configuration Revision Upgrade panel. . . . . . . . . . . . . . . . . . . . . . . . . 2-28 Figure 2-26: Software Revision in the Card Module . . . . . . . . . . . . . . . . . . . . . . . . . 2-28
Memotec Inc.
xvii
Figure 2-27: Safe Update Configuration panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30 Figure 2-28: Validation Reminder after Configuration Download . . . . . . . . . . . . . . . 2-31 Figure 2-29: Accessing the CX Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32 Figure 3-1: Progression of the configuration creation. . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Figure 3-2: Multiple Generation panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 Figure 3-3: Configuration Revision Upgrade panel. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6 Figure 3-4: Software Revision in the Card Module . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6 Figure 3-5: Commands from the configuration script . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Figure 3-6: Connection type when downloading. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Figure 3-7: Downloading Configuration dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 Figure 3-8: Configuration Download in progress . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 Figure 3-9: Connection Type for Check Execution Script. . . . . . . . . . . . . . . . . . . . . 3-14 Figure 3-10: Check Execution Completed Message . . . . . . . . . . . . . . . . . . . . . . . . 3-15 Figure 3-11: Script Execution Result Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15 Figure 3-12: Safe Update Configuration panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16 Figure 3-13: Validation Reminder after Configuration Download . . . . . . . . . . . . . . . 3-17 Figure 3-14: Accessing the CX Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18 Figure 3-15: Connection Type for Check Execution Script. . . . . . . . . . . . . . . . . . . . 3-20 Figure 3-16: Check Execution Completed Message . . . . . . . . . . . . . . . . . . . . . . . . 3-21 Figure 3-17: Script Execution Result Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21 Figure 4-1: Configuring a CX900s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2 Figure 4-2: Creating the IP Station . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Figure 4-3: Creating the IP Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 Figure 4-4: Creating IP Static Route. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5 Figure 4-5: Selection the connection type for download. . . . . . . . . . . . . . . . . . . . . . . 4-6 Figure 4-6: Downloading the configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Figure 4-7: Connecting to the CX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
1
Overview
This chapter provides an overview of the features of CXTool, the system requirements, and any limitations. It also explains how to install CXTool on your PC.
Memotec Inc.
1-1
1.1
Using CXTool
CXTool provides a graphic interface for configuring CX devices for GSM Abis/Ater and DCME networks. Once CXTool is installed, it can be launched directly from the Start Menu. CXTool will validate the configuration you are creating and stop you from making certain mistakes. You can work on more than one configuration at the same time. When the configuration is completed, CXTool will help you transfer it to your CX device, using an IP connection or a serial port of your computer. The steps needed to configured a CX device are as follows:
1. 2. 3. 4. 5.
Create a new configuraiton or edit an existing configuration. Generate a configuration. Download the configuration. Verifiy the script. Start the device and view the results.
1.1.1
CXTool Features
The CXTool configuration tool makes it easy to configure all aspects of the CX devices. The main CXTool features are: Application based: CXTool interface is separated in different applications (DCME, GSM, WAN) to facilitate the configuration process. Rule driven: A complex set of rules ensures that the resulting configuration is valid. Easy configuration migration: CXTool can handle changes between firmware releases, making it easy to migrate a network to a newer firmware revision. Online help: All panels and dialog are linked to the online help, making it easy to find specific information.
1.1.2
System Requirements
In order to successfully install and run CXTool, the following system requirements must be met: Intel Pentium processor 266 MHz minimum required (PIII 350 MHz or higher strongly recommended). Windows 98, Windows Me, Windows NT 4 (service pack 4 or above), Windows 2000, Windows XP, Windows Server 2003, or Windows Vista (*).
1-2
Memotec Inc.
Overview
CXTool has been tested on the English versions of Microsoft Windows software. Problems have been reported and fixed with CXTool running on non-English versions of Microsoft Windows software. There are no plans to test CXTool on non-English version of software. Problems reported with CXTool running on these versions of Windows software will be fixed as they are reported from the field 512 MB of RAM minimum required. 30 MB of free disk space for the application. Note that each configuration made uses from 2 MB to 5 MB of disk space, depending on the complexity of the configuration. SVGA color monitor supporting 800 x 600 minimum screen resolution (1024 x 768 is recommended for optimum readability). Serial COM port (for access to the Memotec device using the console port). Note that some computers do not have a serial COM port installed: some additional hardware may be needed. Ethernet interface (optional, for IP access to the Memotec device).
1.1.3
Limitations
It is not possible to run more than one CXTool application at the same time but you can open more than one configuration file simultaneously. It is not possible to install more than one version of CXTool on the same PC. Note that you can create configuration files using the latest CXTool for all the previous firmware revisions.
1.1.4
Memotec Inc.
1-3
1.2
1.2.1
Open the Control panel. Select Add /Remove Programs. Select the currently installed CXTool (look for Memotec CXTool) and click Remove.
1-4
Memotec Inc.
Overview
1.2.2
Open the Control Panel. Select Programs and Features. Select the currently installed CXTool (look for Memotec CXTool) and click Uninstall. Follow the instructions to remove the currently installed CXTool.
4.
1.2.3
Use the File Explorer to select the CXTool package to install. If installing from the CD-ROM provided by Memotec, CXTool can be found in the \CXTool folder. Double-click the CXToolSetup#.#.##.exe where #.#.## is the CXTool version. This will launch the installation package. Note that older CXTool installation packages are named setup.exe. The Welcome screen will be displayed first: click Next to remove the currently installed CXTool. The next dialog will confirm the CXTool removal: click Remove to start the removal procedure. Follow the instructions to complete the removal process.
2.
3.
4.
5.
Once the previous CXTool is removed, you can proceed with installing the newer CXTool.
Memotec Inc.
1-5
1.3
Installing CXTool
1.
From the CD-ROM provided by Memotec, run the file CXToolSetup#.#.##.exe (where #.#.## is the CXTool version) located in the \CXTool folder. Note that older CXTool installation packages are named setup.exe. After a few seconds, the welcome dialog is displayed. When clicking the Next, you will be shown the License Agreement screen. After reading the license, select I accept and click Next to go to the next panel.
2. 3.
The next panel will prompt you for your name and the name of your organization. When done, you will have to select if CXTool will be available to anyone who uses this computer (preferred choice) or only the current user installing CXTool. When done, click Next. The next panel will prompt you for the destination folder where CXTool will be installed. By default, the installation program will install itself in the C:\Program Files\Memotec\CXTool\ folder. When done, click Next. The next panel shows the ready to install dialog. Click Install to start installing the files for CXTool.
5.
6. 7.
When the installation is done, the Installshield Wizard Completed panel is displayed.
1-6
Memotec Inc.
Overview
1.3.1
Memotec Inc.
1-7
1.4
1.4.1
Select View > Options. The Global Options dialog box appears.
When checked, the Product Configuration panel is automatically opened after CXTool is launched
1-8
Memotec Inc.
Overview
Field
Description
Show VR DAMA
When checked, the VR DAMA module will be visible in the Navigation panel. This module is needed to configure the DAMA protocol, used to manage bandwidth on demand with some satellite modems.
Configure CX2000 Backplane Bandwidth Management: Allow all the available vocoders Synchronize Multiple Navigation panel
When checked, CXTool will configure the backplane management if the device type is a CX2000 Maximum time allowed for an operation to a CX device to be answered. When checked, the Module Navigation panel of all the open configuration files will be synchronized automatically (set to the same module or sub-module). This feature help set similar settings in different configuration files (ex: the central and a remote configuration).
When checked, the backup files created by the migration process will be deleted. These files are created in case the migration fails but are not deleted by default.
When checked, dynamically changing the configuration of the device will be possible. Dynamic changes do not require a restart of the device for the changes to take effect. To do dynamic configuration changes, you will also need to check the Dynamic Mode, at the bottom of the configuration window.
When checked, CXTool will not check if the 'device type' selected in the configuration script matches the actual hardware unit that the script is being downloaded to. This feature is useful when checking a script but the same exact device is not available. This option should be used with caution, since each device type has different functions and limitations.
Memotec Inc.
1-9
Field
Description
When checked, when you enter a value in a field, CXTool will apply that value across multiple features within the same folder.
Note:
Use this feature with caution since it can make blanket changes to the configuration, which can lead to errors if use incorrectly. You should backup your files before making these blanket changes.
Click Apply when done, or click Cancel to discard your changes to the Global Options dialog box.
1-10
Memotec Inc.
2
CXTool User Interface
This chapter presents an overview of the CXTool interface, explaining how each section works.
Memotec Inc.
2-1
2.1
When creating a new configuration, the choices are the following: New Configuration Offline Configuration: The user selects the type of CX device he wants to configure. After clicking Next, he will need to indicate to CXTool the hardware present within the CX device (cards, DSP, etc). New Configuration Learn Hardware from serial port: CXTool will probe the COM port selected by the user to determine the type of CX device present. CXTool will also detect the hardware present within the CX. The default access password (supervisor) is put in the Password field automatically: if the access password in the device was changed, you will need to enter the new value in this field. New Configuration Learn Hardware from IP Connection: CXTool will probe the IP address entered by the user to determine the type of CX device present.
2-2
Memotec Inc.
CXTool will also detect the hardware present within the CX. The default community string (public) is put in the AdminCommunity field automatically: if the community string in the device was changed, you will need to enter the new value in this field. When learning hardware is performed (Serial or IP), CXTool can also learn the CXTool configuration from the CX device itself, if the option Learn Configuration is selected. Once the learning process is done, the user can modify the CX configuration as if a local CXTool configuration file was opened. The modified CX configuration can also be saved in a local file. The learning process will be successful only if the CX device was previously configured using CXTool and if the CXTool database was sent to the CX with the configuration. See the Download Configuration on page 2-22 for more information. Note that even if the database is sent to the CX device with the configuration, it is recommended to always save the CX configuration in a local file and keep this file in a safe place. If a new configuration is selected in the Product Configuration panel, clicking Next will bring you to the I/O panel for the selected (or learned) device type. This panel is used to set the type of hardware present in the CX. Its appearance is slightly different for each device type but the same fields are set in each of them. For a CX900s/ CX950e/CX960e, the I/O panel is like the next figure:
Memotec Inc.
2-3
The CX2000 uses a different panel because the CX2000 is a multi CPU device and all the CPU must be configured. A single CX2000 configuration file will include the configuration of all the CPUs in a CX2000 chassis.
The CX-U1000 series also has its own Hardware Configuration panel, mainly because the CX-U has no slots and very few hardware options.
2-4
Memotec Inc.
The Hardware Configuration panel has some very important fields that should be set carefully. The table below lists all the fields to set in the various panels. Note that some fields only apply to some device types.
Field CX Type Description
Device Type
All CX types
Device type that was selected (offline configuration) or learned (serial or IP). This field is not editable. The firmware revision in the CX device to be configured. If the HW was learned, then this field is non-editable and will show the firmware revision currently in the CX. For an offline configuration, the software revision can be changed to match the one in the CX device.
Software Revision
All CX types
Memotec Inc.
2-5
Field
CX Type
Description
Hardware Revision
CX-U only
The hardware revision of the CXU device to be configured. Some features are only available with some hardware revision. Here are a few examples: GPS Clock: rev 4 and up CXU1010 with 2 DSP, up to 2 DLP: rev 1/2/3 CXU1010 with 1 DSP, up to 3 DLP: rev 4 and up
The Voice Capability sets the type of application that can be configured on the CX device. If the HW was learned, then this field is non-editable and will show the application currently available in the CX. Choices are: GSM/G729/G711/VoIP: Legacy Abis/Ater, DCME and H.323 VoIP. Firmware version has the format XXX0XXX (ex: XP50435Z). GSM_withEDGEPlus: Abis/Ater using EDGEPlus. Firmware version has the format XXXFXXX (ex: CXSF5114). GSM_withEDGEPlus/DCME/ATM: Abis/Ater using EDGEPlus, DCME and ATM/TDM. Firmware version has the format XXXCXXX (ex: CXUC5406). AbisXpress/EDGEPlus/ DCME/ATM: Abis/Ater using AbisXpress, Abis/Ater using EDGEPlus, DCME and ATM/TDM. Firmware version has the format XXXC2XX (ex: CXUC200K).
Note:
It is important to select the voice capability that matches what is supported by the firmware in the CX device. The module swrev command, when connected to a CX device using CXAccess, will show the firmware version.
Module/CPU
CX2000 only
The CPU(s) present in the CX2000 chassis. The choices are: M1/CX2000: First CPU. M2/CX2000: Second CPU. M3/CX2000: Third CPU. M4/CX2000: Fourth CPU.
Slot
CX950e, CX960e, The list of available I/O slots present in the CX is CX2000 shown on the left. The number of slots present depends on the type of hardware.
Table 2-1: Hardware Configuration fields
2-6
Memotec Inc.
Field
CX Type
Description
I/O Card
CX950e, CX960e, For each slot value, you can select the type of I/O CX2000 card in this location. Note that some restrictions may prevent you from putting some cards in a slot or some combinations of cards in a CX. Because some cards are supported only with specific software revision, CXTool will prevent you from selecting them.
Note:
The card Digital Interface Card is populated with DVP modules while the Digital Interface Card (DLP) can only be populated with DLP modules. Both cards can also have no modules (for data applications).
CX2000 only
Set it if the CX2000 CPU has an onboard Ethernet present. Note that while other CX types have an onboard Ethernet, this field doesnt apply to them. Number of Ethernet ports present (read-only). V35 serial port (read-only, always present). Number of T1/E1 Ports (read-only, based on type of CX-U selected). Number of soldered DSP Modules present on the CX-U (values available is based on type of CX-U selected and hardware revision). Number of DLP Modules present on the CX-U (values available is based on type of CX-U selected and hardware revision). Number of DDLP Modules present on the CX-U (values available is based on type of CX-U selected and hardware revision).
Ethernet Ports CX-U only Serial interface T1/E1 Ports CX-U only CX-U only
DLP Modules
CX-U only
DDLP Modules
CX-U only
The Product Configuration panel will also let the user open a CXTool file done previously. The Existing Configuration tab will let the user select the file to open, using a regular Windows File Selector. The File Selector will show the files with a CXT file extension, which is the extension of CXTool configuration files.
Memotec Inc.
2-7
The Recent Configuration tab gives a quick access to the last few CXTool files opened.
2-8
Memotec Inc.
When opening an existing configuration file, CXTool may display a warning message indicating that a file conversion is needed. This message will be displayed only if the configuration file was done with a previous version of CXTool.
You can click OK and CXTool will then convert the file format. This process can last up to a few minutes. Remember that converting the file format will not change the software revision within the configuration file.
Memotec Inc.
2-9
2.2
Quick access to the most often used features. List all the different modules and sub-modules. of the currently selected module or sub-module in the
Main panel: Show the entries Module Navigation panel. Stack panel:
5.
time.
6. Status Bar: Display errors and messages during the step-by-step configuration. They explain errors and provide the range of appropriate values for the selected parameter.
2-10
Memotec Inc.
2.3
Menu Bar
The menu bar gives access to all the CXTool functions. The File menu gives access to the configuration file operations (open, save).
File Menu Description
New
Creates a new configuration file. The Product Configuration panel will be displayed. The toolbar icon is .
Open
Opens an existing configuration file. A standard Window File selector dialog will be displayed. The toolbar icon is .
Opens a recently opened configuration file. A dialog with the list of recent configuration files will be displayed Closes the currently active configuration file. If needed, you will be prompted to save the file. Saves the currently active configuration file. If needed, you will be prompted to enter a file name. The toolbar icon is .
Save As
Saves the currently active configuration file opened in CXTool under a different name. You will be prompted to enter a file name. Saves all the configuration files opened in CXTool. If needed, you will be prompted to enter a file name. Up to 4 recent configuration files are quickly available from the menu. Ends the execution of CXTool. If needed, you will be prompted to save the files that have been modified.
Table 2-2: File menu
The View menu includes the items to show/hide window elements and to set the global options of CXTool.
View Menu Description
Toolbar Options
Display/Hide the toolbar Opens the Global Options panel. For more information, refer to Download Configuration on page 2-22.
Table 2-3: View menu
The Edit menu include functions to Add, Modify and Delete entries for the selected module or sub-module.
Memotec Inc.
2-11
Edit Menu
Description
Add New
Add a new entry in the currently selected module in the Module Navigation panel. If it is not possible to add an entry, the menu item will be grayed out and unavailable. The toolbar icon is .
Modify
Delete
Delete the currently selected module in the Module Navigation panel. If it is not possible to remove the current entry, the menu item will be grayed out and unavailable. The toolbar icon is
Table 2-4: 'Edit' menu
The Tool menu includes very many important functions like generating the configuration script and downloading the script to the CX. Because of its importance, the different choices of this menu are explained in greater details elsewhere in this guide. Note that some tools are available only in some conditions.
Tools Menu
Description
Generate the configuration script for the current configuration file. This step is required before downloading the configuration to a CX device. For more information, see Generate Configuration on page 220. Generate the configuration script for multiple configuration files. The files could be already opened in CXTool or located in a local folder. This step is required before downloading the configuration to a CX device. For more information, see Generate Multiple Configurations on page 2-20.
Upgrade Multiple Config- Allows you to upgrade the revision number of multiple configuuration Revisions ration files. For more information, see Upgrade Multiple Configuration Revisions on page 2-20.
Table 2-5: Tools' menu
2-12
Memotec Inc.
Tools Menu
Description
Allows you to change the value of an object and its conditions across multiple configuration files. This features saves you from manually opening each configuration file and making the same change over and over. For more information, see Modify Multiple Configurations on page 2-21.
Display the configuration script generated previously. The configuration script includes all the commands to configure the CX device. For more information, see Upgrade Multiple Configuration Revisions on page 2-20.
Download the current active configuration to a CX device. If the configuration script was not generated before, CXTool will prompt you to do it. For more information, see Download Configuration on page 2-22. Verify the result of the configuration download. This will indicate if any command(s) caused errors when applied to the CX. Command errors may cause the CX device to malfunction. For more information, see Check Script Execution Results on page 2-26.
Upgrade the firmware revision set in the configuration file. This feature is needed when a CX device is upgraded to a newer firmware revision. By performing a Configuration Revision Upgrade, you can easily upgrade your existing configuration file without having to redo them.
Note:
The firmware revision must always match the actual firmware revision in the CX device.
For more information, see Configuration Revision Upgrade on page 2-28. Device Migration Change the device type set in the configuration file. This option offers an upgrade path when replacing a device with a more powerful version, without having to completely repeat the configuration steps. Note that the device type must always match the actual device type of the CX device. For more information, see Device Migration on page 2-29.
Table 2-5: Tools' menu
Memotec Inc.
2-13
Tools Menu
Description
Change the Voice Capability in the configuration file. Each Voice Capability has a specific set of applications.
Note:
The voice capability must always match the actual voice capability of the CX device. Some capabilities are not available in all firmware flavor or build.
For more information, see Voice Capability Migration on page 2-29. Safe Update Utilities The toolbar icon is . Manage the Safe Update feature of the CX, ensuring that connectivity to a remote CX is never lost. For more information, see Safe Update Utilities on page 230. Set options related to configuration download. For more information, see Download Configuration on page 2-22.
Table 2-5: Tools' menu
Upload/Download Settings
Window Menu
Description
Cascade all the open configuration files. List of currently opened configuration files. You can select one in order to switch to this configuration.
Table 2-6: Window' menu
Help Menu
Description
Open the online help. Show information about the CXTool version. The version format is always X.X.XX where X.X is the major and minor version while XX is the build number.
Table 2-7: 'Help' menu
2-14
Memotec Inc.
2.4
Toolbar Buttons
The Toolbar gives quick access to the most common CXTool functions. Some toolbar icons are available only in some conditions.
Tool Description
Create a new configuration. The Product Configuration panel will then be displayed. Open an existing configuration. Save the current active configuration. Add a new entry in the currently selected module in the Module Navigation panel. Modify the currently selected module in the Module Navigation panel. Delete the currently selected module in the Module Navigation panel. Download the current active configuration to a CX device. Generate the configuration script for the current configuration file. Display the configuration script. Upgrade the firmware revision set in the configuration file. Manage the Safe Update feature of the CX.
Table 2-8: CXTool toolbar
Memotec Inc.
2-15
2.5
The Module Navigation panel (top left) The Main panel (right) The Stack Navigation panel (bottom left). For more information, see Using the Stack Navigation Panel on page 2-19. The Module Navigation panel displays the hierarchy of the modules within CXTool. When configuring a CX device, the modules appropriate for the network application required must be configured. Sub-modules that are logically linked to a protocol or service or application are organized within their respective module folder. For instance, Port, DLCI, Switch, Simplex, Multicast, and Bundle sub-modules are in the Frame Relay module folder. Clicking on an item in the Module Navigation panel is the
2-16
Memotec Inc.
The navigation inside the module navigation panel is easy. To open a particular module, you just need to click the + sign before the module name. This will show the sub-modules for the corresponding module. In the example above, the IP module is made of many sub-modules. To configure a particular module, you must first click the module name. The Main panel display will change to show the current configuration of this module, if there is any. In the above example, the IP > Station module has no configuration. To add a configuration for this specific module, you can perform one of the following: Select the Edit > Add New. Click Add .
Double-click the Station module name in the Module Navigation panel and select Add new. Right-click the Main Module panel and select Add new.
Memotec Inc.
2-17
All module configuration panels have the same elements: One or more sub-panels, accessed using the tab at the top. Click Cancel to stop configuring this module. Everything done since the panel was opened will be discarded. Click Finish to close the panel. Click Help to access the online help on this panel. All fields of the panel are explained in the Help. Click Back and Next (available only for some modules) to move between the various panels. When you are done, click Finish to close the panel. The Main panel will then be updated to show the changes made. Notice also that the icon in the Navigation Module panel for the Station module is no longer empty, indicating that a configuration is present for this module.
2-18
Memotec Inc.
Selecting the entry to modify in the Main panel. Select Edit > Modify. Click Modify .
Select the entry to delete in the Main panel. Select Edit > Delete. Click Delete .
2.5.1
Navigation is performed by clicking the Up Layer or Down Layer entries: the same entry will immediately be displayed in the Module panel.
Memotec Inc.
2-19
2.6
2.6.1
Generate Configuration
This tool will generate the configuration script, from the configuration made within CXTool. The script generation process can take between a few seconds for a simple configuration to several minutes for a complex configuration. Note that the speed of the computer can also have an impact on the duration of this process. During script generation, a dialog is displayed.
To launch this dialog box, select Tools > Generate Configuration or click
Configuration.
Generate
2.6.2
2.6.3
2-20
Memotec Inc.
2.6.4
NOTE:
This features is only for advanced users. Be sure that you have permission and proper understand the full scope of the modification you are making. If you use this feature incorrectly, it can produce errors in the configuration rules.
To open this dialog box, select Tools > Modify Multiple Configurations.For more information, see Modify Multiple Configurations on page 3-4.
2.6.5
Display Script
The Display Script tool quickly displays the contents of the configuration script generated. This tool allows you to see the actual commands in the configuration script. You can find help on all the commands in the file in the Command line help on the Memotec CD. To launch this dialog box, select Tools > Display Script or click
Display Script.
When you select this tool (from the menu or the toolbar), the configuration script will be opened with the application set to handle text files (.TXT file extension). This application is usually the Notepad program.
Memotec Inc.
2-21
If the configuration script was not generated previously, CXTool displays this message:
If you see this message, you should generate the configuration script of the current configuration file. You will then be able to open the configuration script.
NOTE:
If no applications are registered in Windows to open files with the TXT file extension (or if the application registered is no longer present), the same error message will be displayed. You should ask your network administrator for assistance in resolving this issue.
2.6.6
Download Configuration
When the configuration script is generated, you can then proceed with downloading the configuration to the CX device. When this tool is selected, CXTool will first let you choose the connection method: Serial or IP connections.
Serial Connection: The configuration script will be transferred using the COM port of the computer. A console cable must be connected between the COM port
2-22
Memotec Inc.
selected in CXTool and the console port on the CX device. CXTool will automatically set the speed of the serial port to the highest speed possible. You should make sure that no other applications (CXAccess, HyperTerminal) are currently using the same serial connection. After selecting the desired COM port, click Next. If the password was changed on the CX device, you should enter the new password in the Password field. IP Connection: The configuration will be sent using an IP connection between the PC with CXTool and the CX device. The CX device must have an IP address configured for this type of connection to work. After selecting the entering the IP address of the CX device, click Next. If the admin community was changed on the CX device, you should enter the new value in the AdminCommunity field. After clicking Next, the Download Script dialog box will perform some tests to make sure the configuration done is compatible with the CX device. When all the tests are completed successfully, the Full Download and the Include Database checkbox will be made available.
Start Download
Memotec Inc.
2-23
Include Database
Make CXTool to also send the configuration database to the CX device. The configuration database can be retrieved later by CXTool, making it easy to get the configuration file. The main drawback of including the database is the total time required to download the files will be longer. Please note that even if you are downloading the database to the CX device, you should carefully manage all the configuration files (keep them organize, keep a backup copy, etc). Make CXTool to restart the device after the configuration download is completed. This will immediately apply the new configuration, but it will also create a small service interruption (less than 1 minute usually). When this option is not checked, the configuration is not applied immediately. To apply the configuration at a later time, you will need to use the sysmgt restore=2 command from the command-line. This option is useful when changing both the configuration and the firmware revision at the same time. First you download the configuration without restarting the unit and then you download the new firmware. Show/Hide the status text at the bottom of the dialog. This section shows information about the tasks being performed by CXTool.
Table 2-9: Configuration Download fields
Restart
Details
After clicking Download, CXTool will start the download and the dialog will also show the progress.
2-24
Memotec Inc.
When the transfer is completed, CXTool will display a dialog to inform you:
The device will reset twice in order to apply the new configuration. You can then click OK to close the message. You can also close the Download Script dialog by clicking Finish. Immediately after, CXTool will prompt you to check the execution results of the script. If you click No, the download script operation is completed. Note that you can still check the execution results of the script at any time, by selecting Tools > Check Script Execution Result. If you click Yes, CXTool will try to verify if the commands in the configuration script were all accepted. For more information on this operation, refer to the Check Script Execution Result section.
Memotec Inc.
2-25
2.6.7
You must first select the method for accessing the CX device. Serial Connection: The configuration script will be sent using the COM port of the computer. A console cable must be connected between the COM port selected in CXTool and the console port on the CX device. CXTool will automatically set the speed of the serial port to the highest speed possible. You should make sure that no other applications (CXAccess, HyperTerminal) are currently using the same serial connection. After selecting the desired COM port, click Next. If the password was changed on the CX device, you should enter the new password in the Password field. IP Connection: The configuration will be sent using an IP connection between the PC with CXTool and the CX device. The CX device must have an IP address configured for this type of connection to work. After entering the IP address of the CX device, click Next. If the admin community was changed on the CX device, you should enter the new value in the AdminCommunity field. When done, click Next to connect to the CX device and retrieve the scripts errors, if any. When done, CXTool will indicate that the result of the script execution is now available.
2-26
Memotec Inc.
To immediately view the results, click Yes. The results window will then be presented, indicating the configuration script lines with errors, if any.
You should now try to correct the errors. The command line help can be useful when trying to find the reason behind the errors.
Memotec Inc.
2-27
2.6.8
The upgrade software revision choices may not have all the software revision supported by CXTool: it will change for each device type. Also, it is not possible to downgrade (revert back to an older software revision). You must select the new software revision and click Apply. CXTool will change the software revision and create a backup of the configuration file with the older software revision. You will then see in Hardware > Card module the new software revision:
The software revision in a configuration file must always match the software revision of the actual CX device.
2-28
Memotec Inc.
2.6.9
Device Migration
The device migration tool will change the device type associated with the configuration file. Without this tool, the user must create a new configuration file for the desired device type and redo the complete configuration. The following device migrations are currently supported:
Original Device Type New Device Type
You will have to upgrade the software revision for the original device type, using the Configuration Revision Upgrade tool, if it is not the same as in the table above. After the device migration, the same tool will be needed to change the software revision in the new device type to the most recent available version. The device type in a configuration file must always match the device type of the actual CX device.
2.6.10
GSM/G729/G711/VoIP
The voice capability in a configuration file must always match the voice capability of the actual CX device.
Memotec Inc.
2-29
2.6.11
2-30
Memotec Inc.
Some fields must be set by the user for this functionality to work:
Field Description
When checked, the validation process will be activated after the configuration download. Allowed time for the user to validate the IP connectivity in the downloaded script. The default period is 20 minutes. IP Port used to access the CX device remotely. If you have multiple IP ports configured, be sure to select the one required to remotely access the CX device.
IP Static route for connectivity Static route needed to allow remote IP connectivity. If no route is needed, you can leave this field blank.
Table 2-12: Safe Update panel fields
When the configuration of the CX device is completed, you can proceed with generating the configuration script and downloading it to the CX device. When safe update is enabled, CXTool will warn you that you must validate the IP connectivity.
To generate the configuration script and download it to the CX device, follow these steps:
1. 2.
Select Tools > Safe Update Utilities. The Safe Update Utilities dialog box appears. Enter the IP address of the CX device to validate and click Access. CXTool will try to connect to the CX device and verify the status on the Safe Update options.
Memotec Inc.
2-31
If CXTool can access the CX device, the IP connectivity is correctly set. You can therefore click Approve. This will indicate to the CX device that the IP connectivity is working fine. This step is important because the CX device will wait for 20 minutes (default) for this validation. After this period, the CX will consider that a problem is present with the current configuration and try to reapply the configuration script. If this is failing also (no validation done), the CX will apply ONLY the IP connectivity portion on the configuration script. If this step is failing, then the CX will keep the IP only configuration. Each time a validation fails, a CX device restart will be performed.
4.
Click Commit.
When you are confident about the configuration script in the CX device, you can make it a fallback script. If you ever download a script that causes the CX to lose its IP connection, the CX will try correcting this situation using the fallback script.
2-32
Memotec Inc.
2.6.12
Fill the IP configuration (IP Port, Static Route, etc) only of the remote CX device. Everything needed to remotely access the device should be set. Download the configuration script. Test IP access and approve the configuration, using the Safe Update Utilities. Note that the approval should be performed from the Central Site where future IP access is required. Create the Fallback script file by using the Commit option. Complete the full configuration. Download the configuration script. Test IP access and approve the configuration, using the Safe Update Utilities. Once the CX device configuration is considered complete and operational, update the Fallback script file by using the Commit option again.
2. 3.
4. 5. 6. 7. 8.
Memotec Inc.
2-33
2-34
Memotec Inc.
3
Working with Scripts in CXTool
Memotec Inc.
3-1
3.1
3.1.1
3-2
Memotec Inc.
This process can also be very long, depending on the number of configuration files selected and the complexity of each configuration. This tool can save you a lot of time, especially when you must update many configurations files to a newer software revision. To generate multiple configuration files, follow these steps:
1.
Select Tools > Generate Multiple Configurations. The Generate Multiple Configurations dialog box appears.
2.
Select where the source files reside: From Root Directory: use the Browse button to select the path where the source files reside. From Opened Files: all the currently opened files in CXTool will be loaded in this dialog box.
3.
Click Load File. CXTool adds the names of the source files into the Available panel. All the files shown in the Available list are selected by default: configuration scripts will be generated for all of them. You can select the files you wish to keep using Ctrl or Shift and clicking the files you need.
4.
When the file list is correct, click Generate to start the script generation procedure. If some changes were made to the opened configuration files, CXTool will prompt you to save them before continuing.
5.
CXTool will then generate the configuration script for each of the selected files. The configuration file being processed appears below the Finished panel. When a configuration script of a specific configuration file is completed, its name appears in the Finished panel.
6.
When all the configuration files are processed, the following message will appear:
The generation process has been completed.
7.
Memotec Inc.
3-3
3.1.2
NOTE:
This features is only for advanced users. Be sure that you have permission and proper understand the full scope of the modification you are making. If you use this feature incorrectly, it can produce errors in the configuration rules. Before proceding, you really should make a backup copy of your configuration files in case anything goes wrong.
To open this dialog box, select Tools > Modify Multiple Configurations.
Once you select the files you wish to modify and specify the changes you wish to make, click Set Value. The status bar will display the progress of the changes being applied and a message box will inform you when this process is completed. You can also add a filter to affect only certain objects using conditions. You can specify that for a specific module and object, only those value that meet specific criteria should be changed. To do this, you would use the fields in the Setting Condition panel. If you leave the fields in the Setting Condition panel blank, then there are no conditions and all the values in the object selected in the Object Selection panel will be affected.
3-4
Memotec Inc.
Field
Description
Path of Configuration Files This field lists the path where the configuration files you wish to modify are stored. Use the Browse button to select the path and click Load File to make these files available for modification (these files will appear in the Available Configuration Files list Available Configuration Files These are the configuration files that are found in the path listed in the Path of Configuration Files field. It is these files that will be modified according to the Object and Conditions specified in the Object Selection and Setting Conditions panels. Object Selection panel Module Object Select the module in which the object you wish to modify is located. Select the object that you wish to modify. The objects that appear in this list depends upon what you select in the Module drop-down list. Enter the new value to wish to assign to the object selected in the Object drop-down list.
Select the module in which the object is located. The modules in this field depend on what you selected from the Module drop list in the Object Selection panel.
Object
Select the object that you wish to modify. The objects that appear in this list depends upon what you select in the Module drop-down list in the Setting Condition panel.
Logic Operator
Select the mathematical condition that will filter out values that should or should not be modified. For example, if you want to only change the values that are greater than 250, then you would select the greater than operator ( > ).
Value
Enter the value that will be used as the criteria to filter out objects that should be modified. For example, if you want to only change the values that are greater than 250, then you would select the greater than operator ( > ) from the Logic Operator field and enter 250 in this field.
Table 3-2: Modify Multiple Configurations dialog box fields
Memotec Inc.
3-5
3.1.3
Select Tools > Configuration Revision Update. The Upgrade Software Revision dialog box appears.
Select the new software revision from the Upgrade Revision drop-list and click Apply. CXTool changes the software revision and creates a backup of the configuration file with the older software revision.
The software revision in a configuration file must always match the software revision of the actual CX device.
3-6
Memotec Inc.
3.1.4
Once you select the file(s) you wish to upgrade, you can select the revision number to apply from the Upgrade Revision from the drop-down list and click Upgrade. It is not necessary to redo the configuration of the device. When you click Apply, CXTool revises the appropriate files in accordance with the selected Upgrade Revision.
Field Description
Upgrade Revision
This drop-down list allows you to select the revision number to apply to the files that appear in the Available list.
Memotec Inc.
3-7
This panel allows you to select the file or files that are to upgraded. To select these files click Browse to select a path on your PC and click Load File. The files that are found will be listed in the Available list. When you click Upgrade, the generated files will appear in the Finished list.
Available
Displays the list of opened configuration files. These are the files that were found in the directory selected in the Configurations to be upgarded panel.
Note:
Although the names of unsaved files may appear on this list, only files which have been SAVED can have their scripts upgraded.
When you click Upgrade, the upgraded files will appear in the Finished list. Finished Displays the list of configuration files that have been upgraded when you clicked Upgrade. The list of available files for upgrading appear in the Available list.
Table 3-4: Upgrade Multiple Configurations dialog box fields
3-8
Memotec Inc.
3.1.5
You must upgrade the software revision for the original device type, using Tools > Configuration Revision Upgrade (see Changing the Software Revision in the Configuration File on page 3-6), if it is not the same as in the table above. After the device migration, you will use this tool to change the software revision in the new device type to the most recent available version. The device type in a configuration file must always match the device type of the actual CX device.
3.1.6
NOTE:
Changing voice capability in a configuration file requires a different firmware to be downloaded to the CX device.
GSM/G729/G711/VoIP
The voice capability in a configuration file must always match the voice capability of the actual CX device.
Memotec Inc.
3-9
3.2
NOTE:
You can find help on all the commands in the file in the Command line help on the Memotec CD.
When you select this tool (from the menu or the toolbar), the configuration script will be opened with the application set to handle text files (.TXT file extension). This application is usually Notepad.
If the configuration script was not generated previously, CXTool displays this message:
Warning: the script file or Notepad.exe is not found.
If you see this message, you should generate the configuration script of the current configuration file. You will then be able to open the configuration script.
NOTE:
If no applications are registered in Windows to open files with the TXT file extension (or if the application registered is no longer present), the same error message will be displayed. You should ask your network administrator for assistance in resolving this issue.
3-10
Memotec Inc.
3.3
Select Tools > Download Configuration. The Choose Connection dialog box prompts you to choose the connection method:
Serial Connection: The configuration script will be transferred using the COM port of the computer. A console cable must be connected between the COM port selected in CXTool and the console port on the CX device. CXTool will automatically set the speed of the serial port to the highest speed possible. You should make sure that no other applications (CXAccess, HyperTerminal) are currently using the same serial connection. After selecting the desired COM port, click Next. If the password was changed on the CX device, you should enter the new password in the Password field. IP Connection: The configuration will be sent using an IP connection between the PC with CXTool and the CX device. The CX device must have an IP address configured for this type of connection to work. After selecting the entering the IP address of the CX device, click Next. If the admin community was changed on the CX device, you should enter the new value in the AdminCommunity field.
2.
After clicking Next, CXTool displays the Download Script dialog box. It performs some tests to make sure the configuration is compatible with the CX device. When all the tests are completed successfully, the Include Database and Restart
Memotec Inc.
3-11
Select the options to activate before you start downloading: Include Database: Sends the configuration database to the CX device. The configuration database can be retrieved later by CXTool, making it easy to get the configuration file. The main drawback of including the database is the total time required to download the files will be longer.
NOTE:
Even if you are downloading the database to the CX device, you should carefully manage all the configuration files (keep them organize, keep a backup copy, etc).
Restart: Restarts the device after the configuration download is completed. This immediately applies the new configuration, but it also creates a small service interruption. When this option is not enabled, the configuration is not applied immediately. To apply the configuration at a later time, you will need to use the sysmgt restore=2 command from the command-line. This option is useful when changing both the configuration and the firmware revision at the same time. If you do not do this, you must: - Download the configuration without restarting the unit - Download the new firmware.
3-12
Memotec Inc.
4.
Click Start Download. CXTool starts the download and the dialog box displays the progress.
You can click Details to show/hide the status of the download in the panel at the bottom of the dialog box. When the transfer is completed, CXTool displays a confirmation message.
5.
Click Finish when done. CXTool prompts you to check the execution results of the script. If you click No, the download script operation is completed.
NOTE:
You can still check the execution results of the script at any time, by selecting Tools > Check Script Execution Result.
If you click Yes, CXTool will try to verify if the commands in the configuration script were all accepted. For more information on this operation, see Check Script Execution Results on page 3-14.
Memotec Inc.
3-13
3.3.1
Select Tools > Check Script Execution Results. The Online Check of Script Execution Results dialog box appears.
Select the method for accessing the CX device. Serial Connection: The configuration script will be sent using the COM port of the computer. A console cable must be connected between the COM port selected in CXTool and the console port on the CX device. CXTool will automatically set the speed of the serial port to the highest speed possible. You should make sure that no other applications (CXAccess, HyperTerminal) are currently using the same serial connection. After selecting the desired COM port, click Next. If the password was changed on the CX device, you should enter the new password in the Password field. IP Connection: The configuration will be sent using an IP connection between the PC with CXTool and the CX device. The CX device must have an IP address configured for this type of connection to work. After entering the IP address of the CX device, click Next. If the admin community was changed on the CX device, you should enter the new value in the AdminCommunity field.
3-14
Memotec Inc.
3.
Click Next to connect to the CX device and retrieve the scripts errors, if any. When done, CXTool will indicate that the result of the script execution is now available.
To immediately view the results, click Yes. The results window will then be presented, indicating the configuration script lines with errors, if any.
The Command line help can be useful when trying to find the reason behind the errors.
5.
Memotec Inc.
3-15
3.4
3-16
Memotec Inc.
Some fields must be set by the user for this functionality to work:
Field Description
When checked, the validation process will be activated after the configuration download. Allowed time for the user to validate the IP connectivity in the downloaded script. The default period is 20 minutes. IP Port used to access the CX device remotely. If you have multiple IP ports configured, be sure to select the one required to remotely access the CX device.
IP Static route for connectivity Static route needed to allow remote IP connectivity. If no route is needed, you can leave this field blank.
Table 3-7: Safe Update panel fields
When the configuration of the CX device is completed, you can proceed with generating the configuration script and downloading it to the CX device (select Tools > Generate Configuration). When safe update is enabled, CXTool will warn you that you must validate the IP connectivity.
Immediately after, select Tools > Safe Update Utilities. The Safe Update Utilities dialog box appears. Enter the IP address of the CX device to validate and click Access. CXTool will try to connect to the CX device and verify the status on the Safe Update options.
Memotec Inc.
3-17
If CXTool can access the CX device, the IP connectivity is correctly set. You can therefore click Approve. This will indicate to the CX device that the IP connectivity is working fine. This step is important because the CX device will wait for 20 minutes (default) for this validation. After this period, the CX will consider that a problem is present with the current configuration and try to reapply the configuration script. If this is failing also (no validation done), the CX will apply ONLY the IP connectivity portion on the configuration script. If this step is failing, then the CX will keep the IP only configuration. Each time a validation fails, a CX device restart will be performed. The last step in the safe update tool is to click Commit. When you are confident about the configuration script in the CX device, you can make it a fallback script. If you ever download a script that causes the CX to lose its IP connection, the CX will try correcting this situation using the fallback script.
3-18
Memotec Inc.
Fill the IP configuration (IP Port, Static Route, etc) only of the remote CX device. Everything needed to remotely access the device should be set. Download the configuration script. Test IP access and approve the configuration, using the Safe Update Utilities. Note that the approval should be performed from the Central Site where future IP access is required. Create the Fallback script file by using the Commit option. Complete the full configuration. Download the configuration script. Test IP access and approve the configuration, using the Safe Update Utilities. Once the CX device configuration is considered complete and operational, update the Fallback script file by using the Commit option again.
2. 3.
4. 5. 6. 7. 8.
Memotec Inc.
3-19
3.5
You must first select the method for accessing the CX device. Serial Connection: The configuration script will be sent using the COM port of the computer. A console cable must be connected between the COM port selected in CXTool and the console port on the CX device. CXTool will automatically set the speed of the serial port to the highest speed possible. You should make sure that no other applications (CXAccess, HyperTerminal) are currently using the same serial connection. After selecting the desired COM port, click Next. If the password was changed on the CX device, you should enter the new password in the Password field. IP Connection: The configuration will be sent using an IP connection between the PC with CXTool and the CX device. The CX device must have an IP address configured for this type of connection to work. After entering the IP address of the CX device, click Next. If the admin community was changed on the CX device, you should enter the new value in the AdminCommunity field. When done, click Next to connect to the CX device and retrieve the scripts errors, if any.
3-20
Memotec Inc.
When done, CXTool will indicate that the result of the script execution is now available.
To immediately view the results, click Yes. The results window will then be presented, indicating the configuration script lines with errors, if any.
You should now try to correct the errors. The Command line help can be useful when trying to find the reason behind the errors.
Memotec Inc.
3-21
3-22
Memotec Inc.
4
Configuring a CX device
This chapter presents a few step-by-step examples on configuring a CX device. It also explains how to generate a script, download the configuration, and check the execution result.
Memotec Inc.
4-1
4.1
Configuring an IP connection
This configuration will set an IP address and the needed IP route to access a CX900s using an IP connection. This configuration is very useful when a CX needs to have its firmware updated: downloading the new firmware through an IP connection is a lot faster than using the COM port.
1. 2.
Launch CXTool and select Offline Configuration in the Product Configuration panel. In the Offline Configuration section, select CX900s and click Next.
Since the goal is to only configure the IP connection, we will not set the cards present in the slot. In the CX900s panel, we only need to set the software revision and the voice capability. Because the CX has software revision 5.1, we select the same revision. We also select the voice capability GSM_with_EDGEPlus because the firmware in our CX900s supports this application. You should make sure that the firmware in your CX supports the voice capability selected. For more information, refer to Product Configuration dialog box on page 2-2. When done in this panel, click Finish. The main window appears with the devices default configuration.
4-2
Memotec Inc.
Configuring a CX device
4.
In the Module Navigation panel on the left, double-click the IP > Station module and select Add New. The IpStation dialog box appears.
Since there is nothing to configure in the panel for this configuration, click Finish.
Memotec Inc.
4-3
6.
In the Module Navigation panel, double-click IP > Port and select Add New. The IP Port dialog box appears so that you can configure the IP address assigned to the CX.
In the panel, you need to: Configure the IP address on the CX. Here, we use the IP address 192.168.1.1. Configure the IP mask on the CX. Here, we use the mask 255.255.255.0. Select the ONBOARD_FETH_1 link in the Available list and move it in the Chosen list, by clicking the left arrow. When done, click Finish.
7.
In the Module Navigation panel, double-click the IP > Static Route module and select Add New. We will configure the route needed to access the CX device. In our example, we access the CX device from a PC in a 10.11.11.0 network, through a gateway known by the CX as 192.168.1.254.
4-4
Memotec Inc.
Configuring a CX device
NOTE:
In the panel, you need to: Select the IP port (the port 192.168.1.1 should already be selected) Configure the destination network that can be reached with this route. Here, it is the network 10.11.11.0. Configure the destination IP mask for this route. Here, we use the mask 255.255.255.0. Configure the next hop IP address, the IP address of the gateway in this example. We use the IP address 192.168.1.254. When done, click Finish.
8. 9.
The configuration is complete: we should save it in a local file now. Generate the configuration script, using Tools > Generate Configuration. After a few second, the configuration script will be ready to download. You can see it by selecting Tools > Display Script.
Memotec Inc.
4-5
10.
Download the configuration script to the CX900s connected to the console port. To start the download process, select Tools > Download Configuration. Since COM1 is connected to the console cable (your PC may use a different COM port), we select it in the Choose Connection panel.
The Download Script panel validates that the configuration is compatible with the targeted CX900s. Because this configuration will be replaced eventually, we do not check the Include Database option. This will make the download slightly faster. When the validation is done, click Full Download to start the file transfer.
12.
After the message indicating that the download was successful and the CX is restarting, CXTool will query if you want to verify the script execution.
4-6
Memotec Inc.
Configuring a CX device
We need to connect again to the CX900s. We select the same connection type as before and click Next.
After a few seconds (a few minutes at most), CXTool will indicate that a report on the script execution is ready. Since we want to see the report, we select Yes. When no errors are present, the report will only indicate the number of lines loaded.
16.
Congratulations! You have configured the IP connection to access the CX device. You can use CXAccess or telnet to verify that the IP connection is working fine.
Memotec Inc.
4-7