You are on page 1of 82

CXTool User Guide

COPYRIGHTS AND DISCLAIMERS


Published Date: February 2009 This publication contains information proprietary and confidential to Memotec Inc. Any reproduction, disclosure or unauthorized use of this publication is expressly prohibited except as Memotec Inc. may otherwise authorize in writing. Memotec Inc. reserves the right to make changes without notice in product or component design as warranted by evolution in user needs or progress in engineering or manufacturing technology. Changes which affect the operation of the unit will be documented in the next revision of the manual. We have made every effort to ensure the accuracy of the information presented in our documentation. However, Memotec assumes no responsibility for the accuracy of the information published. Product documentation is subject to change without notice. Changes, if any, will be incorporated in new editions of these documents. Memotec may make improvements or changes in the products or programs described within the documents at any time without notice. Mention of products or services not manufactured or sold by Memotec is for informational purposes only and constitutes neither an endorsement nor a recommendation for such products or services. Memotec Inc. is a wholly owned subsidiary of Comtech EF Data Corp., and its parent company Comtech Telecommunications Corp (NASDAQ: CMTL). CXTool, CXTool, CX-U Series, CX-UA Series, and AbisXpress are either registered trademarks or trademarks of Memotec Inc.in Canada, the United States of America, and in other countries. Belden is a registered trademark of Belden Inc.in the United States of America and in other countries. Windows is a registered trademark of Microsoft Corporation in the United States and other countries. Whatsup and WhatsupGold are registered trademarks of Ipswitch Inc. in the United States and other countries. Any other trademarks are the property of their respective companies. Copyright 2009 Memotec Inc.

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

Installing CXTool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 1.3.1 Windows Vista Users Only . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

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

Preventing a Loss of IP Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16 Check Script Execution Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20

Chapter 4: Configuring a CX device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-1 4. 1 Configuring an IP connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2

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

CXTool User Guide

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

Organization of this User Guide


This user guide includes the following sections:
Chapter 1: Overview and Installation Provides a list of the requirements for running CXTool. Provides a step-by-step explanation on how to install CXTool. Provides a full explanation of the menus, navigation tree, and the applied CXTool concepts. Also contains a detailed explanation of all the tools needed to configure CX devices. Chapter 3: Configuring CXTool Chapter 4: Configuring a CX device Explains how to configure the CXTool application. Provides a step-by-step example on how to configure a CX device.
Table 1-1: User Guide chapter structure

Chapter 2: CXTool User Interface

Memotec Inc.

1-3

CXTool User Guide

1.2

Preparing your PC for Installing CXTool


If CXTool is already installed, you need to remove it before installing the new version. Note that removing the previous version will not remove the configurations files done with it. There are two (2) methods for removing a previous CXTool installation: using the Control panel or launching the new CXTool installation package.

1.2.1

Removing a Previous Version of CXTool


The following steps are used to uninstall CXTool from Windows 2003 R2 Server, Windows XP, 2000, and previous versions except for Windows Vista. For information on how to install on Windows Vista, see Windows Vista Users Only on page 1-7.
1. 2. 3.

Open the Control panel. Select Add /Remove Programs. Select the currently installed CXTool (look for Memotec CXTool) and click Remove.

Figure 1-1: Add/Remove Programs


4.

Follow the instructions to remove the currently installed CXTool.

1-4

Memotec Inc.

Overview

1.2.2

Uninstalling CXTool in Windows Vista


To uninstall CXTool in Windows Vista, follow these steps:
1. 2. 3.

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

Uninstalling using CXTool


To uninstall CXTool using the CXTool Installation Package Remove options, follow these steps:
1.

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

CXTool User Guide

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.

Figure 1-2: Customer Information


4.

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

Windows Vista Users Only


In order for CXTool to function correctly in Windows Vista, the application needs to have administrator rights. This can be accomplished by right-clicking on the CXTool.exe executable file and clicking on Properties. Select the Compatibility tab and enable the Run this program as an administrator checkbox. Then click OK to save this setting for CXTool.exe.

Memotec Inc.

1-7

CXTool User Guide

1.4

Configuring your CXTool Window


The are two types of options you can configure for your CXTool, one that displays or hides the toolbar and one that that allows you to select the level of information to display in the application. To display or hide the toolbar, select View > Toolbar. To configure the information display options, select View > Options. For more information, see Configuring Global Information Options on page 1-8).

1.4.1

Configuring Global Information Options


The CXTool Global Options determines the level of information that is displayed during your session. It also controls some automatic features within CXTool. To configure the Global Options, follow these steps:
1.

Select View > Options. The Global Options dialog box appears.

Figure 1-3: Global Options panel 2.

Configure the options as follows:


Field Description

Show the configuration when CXTool is launched

When checked, the Product Configuration panel is automatically opened after CXTool is launched

Table 1-2: Global Options fields

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).

Delete backup files after migration

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.

Allow Dynamic Configuration

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.

Allow Download to any Device

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.

Table 1-2: Global Options fields

Memotec Inc.

1-9

CXTool User Guide

Field

Description

Allow Modification of Multiple Files

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.

For more information, see Modify Multiple Configurations on page 3-4


Show Remote Routing When checked, Remote Routing appears as an option in the GSM/DCME folder, allowing you configure the mobile to mobile remote routing options.
Table 1-2: Global Options fields 3.

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

CXTool User Guide

2.1

Product Configuration dialog box


After launching CXTool, the main CXTool window is shown and the Product Configuration dialog box is automatically displayed. This dialog box is the starting point of every new configuration. The user has many choices, which includes starting a new configuration or opening an existing configuration.

Figure 2-1: Product Configuration dialog box

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 User Interface

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:

Figure 2-2: CX900s/CX950e/CX960e HW Configuration

Memotec Inc.

2-3

CXTool User Guide

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.

Figure 2-3: CX2000 HW Configuration

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.

CXTool User Interface

Figure 2-4: CX-U HW Configuration

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

Table 2-1: Hardware Configuration fields

Memotec Inc.

2-5

CXTool User Guide

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

Voice Capabil- All CX types ity

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.

CXTool User Interface

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).

Onboard Ethernet Enable

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

DSP Modules CX-U only

DLP Modules

CX-U only

DDLP Modules

CX-U only

Table 2-1: Hardware Configuration fields

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

CXTool User Guide

Figure 2-5: Opening an Existing Configuration

The Recent Configuration tab gives a quick access to the last few CXTool files opened.

Figure 2-6: Opening a Recently opened file

2-8

Memotec Inc.

CXTool User Interface

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.

Figure 2-7: Converting the CXTool file version

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.

Figure 2-8: Conversion Error message

Memotec Inc.

2-9

CXTool User Guide

2.2

Main CXTool Window


After starting CXTool, you will be presented with the main window.

Figure 2-9: CXTool Main Window

The CXTool user interface is separated in six distinct sections:


1. 2. 3. 4. Menu Bar: Toolbar:

Giving access to all the features of CXTool.

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

Module Navigation panel:

Main panel: Show the entries Module Navigation panel. Stack panel:

5.

show the link association between protocols or modules one level at a

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.

CXTool User Interface

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 .

Open Recent File Close Save

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

Save All Recent Files Exit

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

CXTool User Guide

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

Modify the currently selected module in the Module Navigation


panel. The toolbar icon is

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 Configuration The toolbar icon is .

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.

Generate Multiple Configurations

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.

CXTool User Interface

Tools Menu

Description

Modify Multiple Configurations

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 Script The toolbar icon is .

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 Configuration The toolbar icon is .

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.

Check Script Execution Results

Configuration Revision Upgrade The toolbar icon is .

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

CXTool User Guide

Tools Menu

Description

Voice Capability Migration

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 Open Configuration file list

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

CXTool Help About CXTool

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.

CXTool User Interface

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

CXTool User Guide

2.5

The Three Main Window Panels


The main window is divided into three main panels:

Figure 2-10: Empty Main panel

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.

CXTool User Interface

first step of software configuration process for a given module.

Figure 2-11: Opening a module in the Module Navigation panel

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

CXTool User Guide

The module configuration panel will then be shown.

Figure 2-12: 24 IP Module Configuration panel

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.

CXTool User Interface

Figure 2-13: Main panel with the new entry

To modify the configuration of a module, follow these steps:


1. 2. 3. 4.

Selecting the entry to modify in the Main panel. Select Edit > Modify. Click Modify .

Right-click the entry and select Modify.

To completely delete the configuration of a module, follow these steps:


1. 2. 3. 4.

Select the entry to delete in the Main panel. Select Edit > Delete. Click Delete .

Right-click the entry and select Delete.

2.5.1

Using the Stack Navigation Panel


The Stack Navigation panel is used to show the link association between protocols or module one level at a time. It can also be used to change the selected module in the Module Navigation panel.

Figure 2-14: Stack Navigation panel

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

CXTool User Guide

2.6

About the CXTool Tools


The tools available in CXTool are needed when the configuration of the CX is done.

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.

Figure 2-15: Progression of the configuration creation

To launch this dialog box, select Tools > Generate Configuration or click
Configuration.

Generate

2.6.2

Generate Multiple Configurations


This tool has the same function as the Generate Configuration tool. The only difference is that you can launch the generation process on more than one configuration file. CXTool will then generate the scripts of each file, one by one. 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 the user a lot of time, especially when many configurations files need to be updated to a newer software revision. To launch this dialog box, select Tools > Generate Multiple Configurations. For more information on this dialog box, see Generate Multiple Configurations on page 3-2.

2.6.3

Upgrade Multiple Configuration Revisions


When a CX device is installed, the CXTool software that configures the device remembers the software revision that was used. However, when a CX device is upgraded, that is when the firmware revision is changed, the software revision used to configure the upgraded device may need to be changed. To do this, select Tools > Upgrade Multiple Configurations. For more information, see Upgrade Multiple Configuration Revisions on page 3-7.

2-20

Memotec Inc.

CXTool User Interface

2.6.4

Modify Multiple Configurations


This dialog box 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.

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.

Figure 2-16: Commands from the configuration script

Memotec Inc.

2-21

CXTool User Guide

If the configuration script was not generated previously, CXTool displays this message:

Figure 2-17: Error when showing configuration script

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.

Figure 2-18: Connection type when downloading

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.

CXTool User Interface

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.

Figure 2-19: Downloading Configuration panel


Field Description

Start Download

Start the download of the configuration script to the CX device


Table 2-9: Configuration Download fields

Memotec Inc.

2-23

CXTool User Guide

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.

Figure 2-20: Configuration Download in progress

2-24

Memotec Inc.

CXTool User Interface

When the transfer is completed, CXTool will display a dialog to inform you:

Figure 2-21: Configuration Download Completed Message

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

CXTool User Guide

2.6.7

Check Script Execution Results


CXTool can verify if the commands in the configuration script were all accepted. Command errors can cause the CX device to misbehave so they must be detected and corrected promptly. When the tool is selected, a connection dialog, similar to the one used when downloading the configuration, will be displayed.

Figure 2-22: Connection Type for Check Execution Script

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.

CXTool User Interface

Figure 2-23: Check Execution Completed Message

To immediately view the results, click Yes. The results window will then be presented, indicating the configuration script lines with errors, if any.

Figure 2-24: Script Execution Result Window

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

CXTool User Guide

2.6.8

Configuration Revision Upgrade


The configuration revision upgrade tool will change the software revision in the configuration file. When selected, a dialog will show the current software revision and the available upgraded software revision.

Figure 2-25: Configuration Revision Upgrade panel

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:

Figure 2-26: Software Revision in the Card Module

The software revision in a configuration file must always match the software revision of the actual CX device.

2-28

Memotec Inc.

CXTool User Interface

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

CX900e (software revision 4.2.5)

CX900s (software revision 4.2.5)

Table 2-10: Supported Device Migration

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

Voice Capability Migration


The voice capability migration tool is used to change the voice capability of a configuration file. The voice capability has a specific set of applications supported and it is sometime necessary to change it in order to use different applications. Note that changing voice capability in a configuration file will require a different firmware to be downloaded to the CX device. The following voice capability migrations are currently supported:
Original voice capability New voice capability

GSM/G729/G711/VoIP

GSM_with_EDGEPlus (CX900s, CX960e, CX2000 only)

Table 2-11: Supported Voice Capability Migration

The voice capability in a configuration file must always match the voice capability of the actual CX device.

Memotec Inc.

2-29

CXTool User Guide

2.6.11

Safe Update Utilities


This tool works in conjunction with the Safe Update module in the System folder. The Safe Update module implements a failsafe mechanism that prevents the loss of IP connection to a remote CX device. It introduces 2 new concepts: A portion of the configuration script is to establish the IP connection to the CX. A validation procedure is required to confirm the IP connectivity. After downloading the configuration script to a CX, the user is required to validate the IP connectivity. This validation is performed within the Safe Update Utilities tool. When the IP connectivity is validated, the CX will keep a copy of the configuration script. If for some reason, a new script is downloaded to the CX device, which causes the CX to malfunction, the CX device itself will revert to the saved copy of the validated configuration script. Since the IP connectivity is working in the validated configuration, the user will be able to access the CX and correct the malfunction. When an entry is created, the configuration dialog appears:

Figure 2-27: Safe Update Configuration panel

2-30

Memotec Inc.

CXTool User Interface

Some fields must be set by the user for this functionality to work:
Field Description

Enable Approval Process Validation Timeout (ms) IP Port for connectivity

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.

Figure 2-28: Validation Reminder after Configuration Download

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

CXTool User Guide

Figure 2-29: Accessing the CX Device 3.

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.

CXTool User Interface

2.6.12

Recommended Use of the Safe Update feature


1.

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

CXTool User Guide

2-34

Memotec Inc.

3
Working with Scripts in CXTool

Memotec Inc.

3-1

CXTool User Guide

3.1

Generating Configuration Scripts


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. During script generation, a dialog is displayed.

Figure 3-1: Progression of the configuration creation

3.1.1

Generate Multiple Configurations


If you need to generate configuration files from multiple source files, you do not need to open each file separately to generate them. You can open a folder where the source files reside, select the files you wish to use, and generate the configuration scripts.

Figure 3-2: Multiple Generation panel

3-2

Memotec Inc.

Working with Scripts in CXTool

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.

Click Finish when done.

Memotec Inc.

3-3

CXTool User Guide

3.1.2

Modify Multiple Configurations


This dialog box 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.

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.

Table 3-1: Modify Multiple Configurations dialog box

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.

Working with Scripts in CXTool

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.

Object Value Setting Condition panel Module

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

CXTool User Guide

3.1.3

Changing the Software Revision in the Configuration File


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). The configuration revision upgrade tool changes the software revision in the configuration file. To change the software revision in the configuration file, follow these steps:
1.

Select Tools > Configuration Revision Update. The Upgrade Software Revision dialog box appears.

Figure 3-3: Configuration Revision Upgrade panel

The current revision number appears in the Current Revision field.


2.

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 Hardware/Card module now displays the new software revision:

Figure 3-4: Software Revision in the Card Module

The software revision in a configuration file must always match the software revision of the actual CX device.

3-6

Memotec Inc.

Working with Scripts in CXTool

3.1.4

Upgrade Multiple Configuration Revisions


When a CX device is installed, the CXTool software that configures the device remembers the software revision that was used. However, when a CX device is upgraded, that is when the firmware revision is changed, the software revision used to configure the upgraded device may need to be changed. To do this, select Tools > Upgrade Multiple Configurations.

Table 3-3: Upgrade Multiple Configurations dialog box

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.

Table 3-4: Upgrade Multiple Configurations dialog box fields

Memotec Inc.

3-7

CXTool User Guide

Configurations to be upgraded panel

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.

Working with Scripts in CXTool

3.1.5

Changing the Device Type


The device migration tool changes the device type associated with the configuration file. Without this tool, you 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

CX900e (software revision 4.2.5)

CX900s (software revision 4.2.5)

Table 3-5: Supported Device Migration

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

Changing the Voice Capability of a Configuration File


Voice capability has a specific set of supported applications and it is sometimes necessary to change it to use different applications.

NOTE:

Changing voice capability in a configuration file requires a different firmware to be downloaded to the CX device.

The following voice capability migrations are currently supported:


Original voice capability New voice capability

GSM/G729/G711/VoIP

GSM_with_EDGEPlus (CX900s, CX960e, CX2000 only)


Table 3-6: Supported Voice Capability Migration

The voice capability in a configuration file must always match the voice capability of the actual CX device.

Memotec Inc.

3-9

CXTool User Guide

3.2

Viewing a Configuration 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.

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.

Figure 3-5: Commands from the configuration script

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.

Working with Scripts in CXTool

3.3

Downloading a Configuration Script to a Device


When the configuration script is generated, you can upload the configuration to the CX device. To upload a configuration script to a device, follow these steps:
1.

Select Tools > Download Configuration. The Choose Connection dialog box prompts you to choose the connection method:

Figure 3-6: Connection type when downloading

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

CXTool User Guide

checkboxes become available.

Figure 3-7: Downloading Configuration dialog box


3.

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.

Working with Scripts in CXTool

4.

Click Start Download. CXTool starts the download and the dialog box displays the progress.

Figure 3-8: Configuration Download in 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

CXTool User Guide

3.3.1

Check Script Execution Results


CXTool can verify if the commands in the configuration script were all accepted. Command errors can cause the CX device to generate errors, so they must be detected and corrected promptly. To check the script execution results, follow these steps:
1.

Select Tools > Check Script Execution Results. The Online Check of Script Execution Results dialog box appears.

Figure 3-9: Connection Type for Check Execution Script 2.

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.

Working with Scripts in CXTool

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.

Figure 3-10: Check Execution Completed Message 4.

To immediately view the results, click Yes. The results window will then be presented, indicating the configuration script lines with errors, if any.

Figure 3-11: Script Execution Result Window

The Command line help can be useful when trying to find the reason behind the errors.
5.

Click Close when done.

Memotec Inc.

3-15

CXTool User Guide

3.4

Preventing a Loss of IP Connection


This tool works in conjunction with the Safe Update module in the System folder. The Safe Update module implements a failsafe mechanism that prevents the loss of IP connection to a remote CX device. It accomplishes this as follows: The configuration script establishes the IP connection to the CX You must complete a validation procedure to confirm the IP connectivity After downloading the configuration script to a CX, you must validate the IP connectivity using the Safe Update Utilities tool. When the IP connectivity is validated, the CX will keep a copy of the configuration script. If a new script is downloaded to the CX device, which causes the CX to malfunction, the CX device itself will revert to the saved copy of the validated configuration script. Since the IP connectivity is working in the validated configuration, the user will be able to access the CX and correct the malfunction. When an entry is created, the configuration dialog is shown:

Figure 3-12: Safe Update Configuration panel

3-16

Memotec Inc.

Working with Scripts in CXTool

Some fields must be set by the user for this functionality to work:
Field Description

Enable Approval Process Validation Timeout (ms) IP Port for connectivity

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.

Figure 3-13: Validation Reminder after Configuration Download

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

CXTool User Guide

Figure 3-14: Accessing the CX Device

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.

Working with Scripts in CXTool

To use the Safe Update feature, follow these steps:


1.

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

CXTool User Guide

3.5

Check Script Execution Results


CXTool can verify if the commands in the configuration script were all accepted. Command errors can cause the CX device to misbehave so they must be detected and corrected promptly. When the tool is selected, a connection dialog, similar to the one used when downloading the configuration, will be displayed.

Figure 3-15: Connection Type for Check Execution Script

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.

Working with Scripts in CXTool

When done, CXTool will indicate that the result of the script execution is now available.

Figure 3-16: Check Execution Completed Message

To immediately view the results, click Yes. The results window will then be presented, indicating the configuration script lines with errors, if any.

Figure 3-17: Script Execution Result Window

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

CXTool User Guide

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

CXTool User Guide

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.

Figure 4-1: Configuring a CX900s 3.

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.

Figure 4-2: Creating the IP Station 5.

Since there is nothing to configure in the panel for this configuration, click Finish.

Memotec Inc.

4-3

CXTool User Guide

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.

Figure 4-3: Creating the IP Port

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 your network, you may not need to create a static route.

Figure 4-4: Creating IP Static Route

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

CXTool User Guide

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.

Figure 4-5: Selection the connection type for download

When done, click Next.


11.

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.

Figure 4-6: Downloading the configuration 13.

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

Since it is important to ensure that no script errors occurred, select Yes.


14.

We need to connect again to the CX900s. We select the same connection type as before and click Next.

Figure 4-7: Connecting to the CX 15.

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

REACH FURTHER. OFFER MORE.


Contact Memotec: tel.: +1-514-738-4781 e-mail: COE@memotec.com 7755 Henri Bourassa Blvd. West Montreal, Quebec | Canada H4S 1P7 www.memotec.com

You might also like