Offline Configurator

The Offline Configurator is an application that provides a way to modify certain properties of an IMG 2020 configuration file. A user can modify certain objects within the IMG 2020 database or move a configuration created on an IMG 2020 to another IMG 2020.

Introduction

The Java application img2020config provides a way to modify certain properties of an IMG 2020 configuration file.

As of Release 2.3, the following properties can be modified:

Installation and Startup

The img2020config application requires the Java Runtime Environment (JRE) Version 8 to be installed on your computer. The JRE can be obtained at: http://java.com/download.

The application is supported on the following operating systems:

• Windows 7 and higher

• Red Hat Enterprise Linux 6

• CentOs 7.x

Windows Installation and Startup

Installation

To install the img2020config application, execute the img2020config_setup.exe installation program. The img2020config_setup.exe installation program can be obtained from the Dialogic Bulletin Board.

Startup

To start the application, perform the following:

• Click on the Start button > All Programs > dialogic > IMG2020 Offline Configurator.

• Double click on the IMG2020 Offline Configurator icon from the desktop.

• Type in cd <Installation Path> then java-cp lib\sqlite-jdbc-3.8.11.2.jar;img2020config.jar img2020config.StartFrame.

Linux Installation and Startup

Installation

To install the img2020config application, obtain the img2020config-2.3.0-XXX.noarch.rpm RPM package from the Dialogic Bulletin Board and perform the following:

• Open a terminal window in superuser mode and change directory to where the RPM package has been downloaded.

• Type in rpm-ivh img2020config-2.3.0-XXX.noarch.rpm. This will install the Offline Configurator files under the /opt/dialogic/img2020config directory. XXX is the build number (i.e., img2020config-2.3.0-28.noarch.rpm). Note that the installation will create a "dialogic" user if it is not already present on the system.

To remove the Offline Configurator, perform the following:

Type in rpm-e img2020config-2.3.0-XXX.noarch. XXX is the build number (i.e., img2020config-2.3.0-28.noarch.rpm).

Startup

To start the application, perform the following:

• Double click on the IMG2020Config icon from the desktop.

• Open a terminal window.

• Type in cd /opt/dialogic/img2020config then java-cp lib/sqlite-jdbc-3.8.11.2.jar:img2020config.jar img2020config.StartFrame.

Operation Instructions

When the application is started for the first time, it will ask to select a working directory. The following should appear:

Open

Using the file dialog box, create or select a directory that will be used to store the internal files used by the application. The application will create three separate subdirectories named config, log and result. The config directory will contain the extracted database files. The log directory will contain log files and the result directory can be used to store the end result configuration file.
Note that this file dialog box is only present when running under the Windows operating system. When running under Linux, the working directory is fixed to /opt/dialogic/img2020config.
The working directory can also be modified later using the “options/Set Working Directory” menu item.
Note: The working directory path name is saved as a registry value under HCU/SOFTWARE/JavaSoft/Prefs/dialogic.img2020config.workdir.

Upon starting the application, the following window appears.

Open

To select an IMG 2020 configuration file (.dat extension), use one of the following methods:

• Enter manually the name of the configuration file in the File Name text box.

• Select File/Open (CTRL-O) from the menu to select an IMG 2020 configuration file using a File Selector dialog.

• Drag and drop a file on the File Name text box or on the Configuration tree window.
  Once the file is selected, the tree structure of the IMG 2020 configuration is shown. Click on one of the objects in the configuration tree.

In the example below, the Node object has been selected. The right hand side is split into two parts: Editable Properties and All Properties. The Editable Properties are the properties that the user can modify. The All Properties show all the properties of the object and cannot be edited.

The Offline Configurator will audit the config_event table. Typically this table is empty but if there are items in it, all unique entries will be shown in the status window.

There will also be a message window notifying to check the names of these objects. It is important to verify these properties because they are triggered by the database when it detects a problem with the _objectName_.

Modification Example

In this example, the OPC of an SS7 stack is modified. Select the SS7 stack object in the configuration tree.

Modify the value in the New Value edit field. In this example, it is set to 0-0-5.

Click on the Commit button.

The configuration tree will then be redrawn with all the modifications as shown in the window below.

Configuration File Save

The name of the configuration file can only be changed by changing the Configuration Name property from the Dialogic object. The example below shows the window after the configuration name has been changed and the Commit button has been clicked.

To save the file, use the File/Save (CTRL-S) menu item. This will bring up a dialog box where you can select a directory where the file is saved. You cannot change the filename. It will use the filename as set by the Configuration Name property of the Dialogic object.

When saving the configuration database, the configuration_history table is cleared. This is necessary because the commands from the configuration_history may conflict with the modifications that have been made to the database.

Admin Database Reset

Use the menu item Operations/Clean Admin database to reset the content of the admin.db database to its default values. This is an efficient way to remove any password protection on the configuration database.

Direct Connect Configuration to EMS Configuration

Use the menu item Operations/Convert to EMS configuration to move from a direct type of configuration to an EMS system without having to create a whole new configuration.

Display Invisible Properties

By default, the Offline Configurator only shows the properties that are visible in the application. There are other properties for a given object that are not used for display. To show these invisible properties, select the Show invisible properties menu item from the Options menu.

Modifying the working directory

The working directory can be modified using the “Options/Set Working Directory” menu item. It is only available when starting up the application. Once a configuration has been loaded then this option is no longer available

Manual SQL Commands

Although the Offline Configurator provides many of the most important modifications to the database, it may occasionally be necessary to send SQL commands to view or modify the configuration database. This is done by selecting the Execute SQL Command menu item from the Operations menu. This will display a dialog box to enter SQL commands. The results will be shown in the results text pane. The content of the LLC table is shown as an example in the window below.

It is also possible to modify the database with the UPDATE and DELETE SQL commands. Do not make any changes to the database unless you have a thorough knowledge of the database. An error in the database can make it unusable for the IMG 2020.

Log Files

The log files are automatically created under the following directory:

• Windows: {WorkingDirectory}\img2020config\log

• Linux: /opt/dialogic/img2020config/log

A new log file is created for each day and these log files show in more detail all the database modifications and any errors that occurred.

There is a decode_log.txt log file (Windows only) that shows the output of the decoding process. Refer to this file when there are errors in opening a new configuration file.

There is an encode_log.txt log file (Windows only) that shows the output of the encoding process. Refer to this file when there are errors when saving the configuration file.

Comments

Comments can be added to a configuration database file for historical tracking purposes. By selecting the menu item Operations/Add comment to configuration, the following window appears:

Enter a comment in the New Comment text area and then click on the Add new comment button. The comment will be saved in the configuration database and also in the log files. The comments saved in the configuration database file are all shown in the Comments text area with the creation date.

By clicking on the Clear comments from database button, this will remove all of comments from the configuration database.