You are on page 1of 17

MARBEN

ASN.1 Tools

ASN.1 Tools
CDR Converter
Installation Guide for UNIX Platform

(Version 2.1 - November 2018)

- Confidential -
MARBEN ASN.1 Tools - ii - CDR Converter - Installation Guide for UNIX

The information in this document is subject to change without notice and should not be construed as a commitment by
Marben Products company. Marben Products company assumes no responsibility for any consequences resulting from errors
that may appear in this document.

The software described in this document is provided under a license and non-disclosure agreement. The software and
documentation may be used or copied only in accordance with the terms of such license and non-disclosure agreement.

This document is proprietary and confidential. No part of this document may be disclosed in any manner to a third party
without the prior written consent of Marben Products.

No part of this document may be copied or reproduced in any form or by any means.

All company, brand and product names are trademarks or registered trademarks of their respective holders.

Copyright © Marben Products. All Rights Reserved.

Document version history:

Version Date Comments Ref #


1.0 01/2010 First issue
2.0 09/2012 Update for v2.0
2.1 11/2018 Update for v2.1

Commercial information on products: Document reference:


mailto:sales@marben-products.com
http://www.marben-products.com ASN1TOOLS/CDR/CONV-UNIX/ING/A
Version: 2.1
Support & technical information on products: November 2018 - 17 pages
mailto:support@marben-products.com Documentation Ref #

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools - iii - CDR Converter - Installation Guide for UNIX

TABLE OF CONTENTS

1. INTRODUCTION ............................................................................................................. 1
1.1 PRESENTATION ......................................................................................................... 1
1.2 PURPOSE OF THIS DOCUMENT ............................................................................. 1
1.3 INTENDED AUDIENCE ............................................................................................. 1
1.4 HOW TO READ THIS DOCUMENT ......................................................................... 1
1.5 REFERENCES ............................................................................................................. 2
1.5.1 Marben Products documentation .......................................................................... 2
1.5.2 Other documentation ............................................................................................ 2
1.6 GLOSSARY ................................................................................................................. 3

2. INSTALLATION OF THE DELIVERY ........................................................................ 4


2.1 PREREQUISITES FOR THE INSTALLATION ......................................................... 4
2.2 DELIVERY FORMATS AND COPY PROTECTION ............................................... 4
2.3 INSTALLATION PROCEDURE ................................................................................. 5

3. SAMPLES .......................................................................................................................... 7
3.1 SAMPLE FOR GENERATING OUTPUT IN XML FORMAT .................................. 7
3.1.1 Using the sample .................................................................................................. 7
3.2 SAMPLE WITH DEFAULT MAPPING OPTIONS ................................................... 8
3.2.1 Using the sample .................................................................................................. 8
3.3 SAMPLE WITH CUSTOMIZED MAPPING OPTIONS ............................................ 9
3.3.1 Using the sample .................................................................................................. 9

4. DESCRIPTION OF THE DELIVERY ......................................................................... 11

5. LICENSE KEY ................................................................................................................ 12


5.1 TEMPORARY LICENSE .......................................................................................... 12
5.2 ASKING A PERMANENT LICENSE ....................................................................... 12
5.3 DEALING WITH THE PERMANENT LICENSE .................................................... 12
5.4 LICENSE TROUBLESHOOTINGS .......................................................................... 12

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools - iv - CDR Converter - Installation Guide for UNIX

(this page intentionally left blank)

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -1- CDR Converter - Installation Guide for UNIX

1. INTRODUCTION

1.1 PRESENTATION
ASN.1 (Abstract Syntax Notation One), a powerful technology defined to exchange data between
heterogeneous systems, is widely used in various telecommunication applications and other emerging
technologies, where efficient data communication is required.
CDR (Call Detail Record) gathers accounting data from the various switches of the telephone network
and is used by the billing system or any other applications of the telecom carrier information system.
CDRs are often described in ASN.1 but applications dealing with the CDRs can need them in other
formats, in particular in XML and Comma Separated Value (CSV) files.
The MARBEN CDR Converter is a standalone tool that allows to easily convert ASN.1 encoded values
to a XML or CSV format, without developing any line of source code. The XML format is a structured
format, widely-used and very easy to parse. The CSV format is a common format for storage of data,
supported in many applications. Especially, it is suitable for most database loader utilities.
The MARBEN CDR Converter is compliant with ASN.1:2008 for the description of the CDR.

1.2 PURPOSE OF THIS DOCUMENT


This document describes the procedure to install the MARBEN CDR Converter on UNIX platform.

1.3 INTENDED AUDIENCE


This document is intended for anybody installing the MARBEN CDR Converter on a UNIX platform.

1.4 HOW TO READ THIS DOCUMENT


Chapter [2] describes the installation of the software from the delivery media on UNIX platform.
Chapter [3] gives some basic hints for the use of the converter.
Chapter [4] is a brief description of the directory tree organization.
Chapter [5] answers to all questions related to the license key.

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -2- CDR Converter - Installation Guide for UNIX

1.5 REFERENCES

1.5.1 Marben Products documentation


[USG] CDR Converter – User’s Guide
ASN1TOOLS/CDR/CONV/USG/A
CDR-CONV-USG.pdf

[ING] CDR Converter – Installation Guide for Windows Platform


ASN1TOOLS/CDR/CONV-WIN/ING/A
CDR-CONV-INGW.pdf
CDR Converter – Installation Guide for Unix Platform (This document)
ASN1TOOLS/CDR/CONV-UNIX/ING/A
CDR-CONV-ING.pdf
[RLN] CDR Converter - Release Notes
ASN1TOOLS/CDR/V2.1/RLN/A
CDR-V21-RLN.pdf

1.5.2 Other documentation

[X.680] ISO/IEC 8824-1: 2008  ITU-T Rec. X.680 (11/2008)


Information Technology - Abstract Syntax Notation One (ASN.1):
Specification of basic notation
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.680
[X.681] ISO/IEC 8824-2: 2008  ITU-T Rec. X.681 (11/2008)
Information Technology - Abstract Syntax Notation One (ASN.1):
Information object specification
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.681
[X.682] ISO/IEC 8824-3: 2008  ITU-T Rec. X.682 (11/2008)
Information Technology - Abstract Syntax Notation One (ASN.1):
Constraint specification
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.682
[X.683] ISO/IEC 8824-4: 2008  ITU-T Rec. X.683 (11/2008)
Information Technology - Abstract Syntax Notation One (ASN.1):
Parameterization of ASN.1 specifications
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.683
[X.690] ISO/IEC 8825-1: 2008  ITU-T Rec. X.690 (11/2008)
Information Technology - ASN.1 encoding rules:
Specification of Basic Encoding Rules (BER), Canonical Encoding Rules (CER)
and Distinguished Encoding Rules (DER)
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.690
[X.691] ISO/IEC 8825-2: 2008  ITU-T Rec. X.691 (11/2008)
Information Technology - ASN.1 encoding rules:
Specification of Packed Encoding Rules (PER)
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.691

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -3- CDR Converter - Installation Guide for UNIX

[X.693] ISO/IEC 8825-4: 2008  ITU-T Rec. X.693 (11/2008)


Information Technology – ASN.1 encoding rules:
XML Encoding Rules (XER)
http://www.itu.int/rec/recommendation.asp?type=folders&parent=T-REC-X.693
[ISO-10646-1] ISO/IEC 10646-1:2000
Information Technology – Universal Multiple-Octet Character Set (UCS)
Part 1: Architecture and Basic Multilingual Plane
[RFC-4180] IETF RFC 4180 - Common Format and MIME Type for Comma-Separated Values
(CSV) Files
[W3C-XML] W3C Recommendation (6 October 2000)
Extensible Markup Language (XML) 1.0 (Second Edition)
http://www.w3.org/TR/2000/REC-xml-20001006

1.6 GLOSSARY
ASN.1 - Abstract Syntax Notation One
The Abstract Syntax Notation One is used to describe information as data types (see [X.680],
[X.681], [X.682], [X.683]).
BCD – Binary Coded Data
4-bit encoding for numbers 0-9 (see http://en.wikipedia.org/wiki/Binary-coded_decimal).
BER - Basic Encoding Rules
ASN.1 encoding rules, as specified by [X.690].
CDR – Call Detail Record
A record generated by a telephone network equipment containing details of a call that passed
through it.
CSV – Comma Separated Value
A text file format which uses a delimiter specific character, as comma or semi-colon, to separate
values (see [RFC-4180]).
DER - Distinguished Encoding Rules
ASN.1 encoding rules, as specified by [X.690].
PDU – Protocol Data Unit
An ASN.1 message is composed of One or Several PDU. One PDU contains several values.
PER - Packed Encoding Rules
ASN.1 encoding rules, as specified by [X.691].
TBCD – Telephony Binary Coded Data
Extension of BCD, adding additional characters (see http://en.wikipedia.org/wiki/Binary-
coded_decimal#Telephony_Binary_Coded_Decimal_.28TBCD.29).
XER – XML Encoding Rules
ASN.1 encoding rules, as specified by [X.693].
XML - Extended Markup Language
Structured data format, as specified in the XML 1.0 W3C Recommendations [W3C-XML].

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -4- CDR Converter - Installation Guide for UNIX

2. INSTALLATION OF THE DELIVERY


The delivery media is a zip file downloaded from MARBEN web server.
Please read carefully the prerequisites before proceeding with the installation.

2.1 PREREQUISITES FOR THE INSTALLATION


Before beginning the installation, it is assumed that the following products are already installed on the
target platform:
 the Apache Ant tool (version 1.5 or higher) to build the samples,
 an Oracle Java Runtime Environment, version 1.4 minimum; the latest is recommended for best
performance,
 a tool like gunzip to expand the tar.gz files,
If the delivery media is a zip file, a tool like unzip is also necessary to expand it.
The average sizing requirements are shown hereafter:

Component Required space


CDR Converter 8.5 MB
Documentation 1.5 MB
TOTAL 10.0 MB

Table 1: Required disk space

Note The Java Runtime environment can be freely downloaded from http://java.com

2.2 DELIVERY FORMATS AND COPY PROTECTION


The CDR Converter is delivered in binary format and is copy protected using a license key mechanism,
see chapter [5].

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -5- CDR Converter - Installation Guide for UNIX

2.3 INSTALLATION PROCEDURE


The steps required to install the delivery on the target platform are listed hereafter.

1. Install the 2. Set the user’s 3. Install the


software from the environment license file
delivery

Figure 1: CDR Converter installation procedure

Step 1. Install the software from the delivery media


On the delivery media, all the needed data are settled in a directory named ASN1TOOLS-
CDRCONVERTER-XXX, where XXX identifies the platform and the operating system.
a. Create the directory where you want to install the CDR Converter.
It may be installed wherever there is enough free space on the platform. For instance, this
document considers that it has to be installed in
/opt/marben/asn1tools/CDRConverter_VXX, where XX stands for the product version:
mkdir –p /opt/marben/asn1tools/CDRConverter_VXX
b. Copy the ASN1TOOLS-CDRCONVERT-XXX/delivery-CONVERTER-XX.tar.gz file
from the delivery media to a temporary directory.
It may be copied wherever there is enough free space, for example in the /tmp directory.
You will get a /tmp/delivery-CONVERTER-XX.tar.gz archive file.
c. Unpack the sources from the delivery-CONVERTER-XX.tar.gz file.
For instance, assuming that the file has been copied in the /tmp directory, enter the
following command at the shell prompt:
cd /opt/marben/asn1tools/CDRConverter_VXX
gunzip /tmp/delivery-CONVERTER-XX.tar.gz
tar xvf /tmp/delivery-CONVERTER-XX.tar
rm /tmp/delivery-CONVERTER-XX.tar
Step 2. Set the environment for the users of the CDR Converter
This can be achieved, either in the environment of each user, or in a common place like
/etc/profile (for sh or ksh).
a. Define the CDRCONVERT_DIR environment variable with the location of the
<installation_directory>/Converter directory.
For instance, assuming that the delivery has been installed in
/opt/marben/asn1tools/CDRConverter_VXX and that your shell is either sh or ksh, enter
the following command:
export
CDRCONVERT_DIR=/opt/marben/asn1tools/CDRConverter_VXX/Converter
b. Add the ASN.1 compiler path to the $PATH environment variable.
For instance, assuming that your shell is either sh or ksh, enter the following command:

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -6- CDR Converter - Installation Guide for UNIX

export PATH=$CDRCONVERT_DIR/bin:$PATH
c. Define the CDRASNC_DIR environment variable with the location of the
<installation_directory>/Compiler directory.
For instance, assuming that the delivery has been installed in
/opt/marben/asn1tools/CDRConverter_VXX and that your shell is either sh or ksh, enter
the following command:
export CDRASNC_DIR=/opt/marben/asn1tools/CDRConverter_VXX/Compiler
d. Add the ASN.1 compiler path to the $PATH environment variable.
For instance, assuming that your shell is either sh or ksh, enter the following command:
export PATH=$CDRASNC_DIR/bin:$PATH
e. Add the Java Runtime Environment path to the $PATH environment variable.
For instance, assuming that the Java Runtime Environment is available in /opt/jre/bin and
that your shell is either sh or ksh, enter the following command:
export PATH=/opt/jre/bin:$PATH
Step 3. Install the license file
The CDR Converter is copy protected using a key based on the host-id of the computer on which
it is to be used. In this delivery, the CDR Converter is supplied with a temporary key. In order to
obtain a permanent key, refer to the chapter [5.2].
a. Check that the license file named license.dat is well installed under
$CDRASNC_DIR/license and $CDRCONVERT_DIR/license directories.
b. Check the compiler and converter versions. To achieve this, execute the commands:
cdrconvert –version
cdrasnc -version

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -7- CDR Converter - Installation Guide for UNIX

3. SAMPLES
The directory Sample contains the following sub-directories:
 cdr_xml: a sample for generating output in xml format,
 cdr_defaultMapping: a sample without mapping options,
 cdr_customMapping: a sample with customized mapping options,
 tools: the tools (file comparison, automatic mapping option adding) used to run the samples.

3.1 SAMPLE FOR GENERATING OUTPUT IN XML FORMAT


The cdr_xml sample provides an example of how to output in xml format.
The cdr_xml delivery consists of the following files:
 src/cdr_xml.asn contains the ASN.1 description of the BER values,
 src/cdr_xml 1.ber contains the encoded BER values to convert,
 src/cdr_xml.xml is the reference result XML file for the conversion of cdr_xml.ber
 build.xml allows the user to run the sample with ant.

3.1.1 Using the sample

1. Convert the BER file cdr_xml.ber


and check the result.

Figure 2: CDR Converter sample cdr_xml procedure

Step 1. Conversion of the BER encoded file src/cdr_xml.ber


The –asn cdr_xml.asn option is used by the CDR Converter to generate the Mapping and
Table files needed for decoding process. The CDR Converter uses the cdrasnc compiler to
generate the files. Once decoding is done the Mapping and Table files will be deleted
automatically.
In order to generate in xml format the –f xml is specified. However, if –f xml option is not
specified the default output format is xml.
The CDR Converter decodes the file src/cdr_xml.ber and generates the XML file
test/cdr_xml.xml.
The generated file test/cdr_xml.xml is compared with the result file given as reference
src/cdr_xml.xml.
The sample can be automatically run using:
ant
The command ant –projecthelp displays help about the main targets.

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -8- CDR Converter - Installation Guide for UNIX

3.2 SAMPLE WITH DEFAULT MAPPING OPTIONS


The cdr_defaultMapping sample provides a basic sample of how to convert a BER encoded file into a
CSV file. No mapping options are set.
The cdr_defaultMapping delivery consists in the following files:
 src/cdrSample1.asn contains the ASN.1 description of the BER values,
 src/cdrSample1.ber contains the encoded BER values to convert,
 src/cdrSample1.csv is the result CSV file given as reference,
 test/cdrSample1_table.dat is the Information table generated from the ASN.1 syntax by the
ASN.1 Compiler,
 test/cdrSample1_mapping.txt is the Mapping file generated from the ASN.1 syntax by the
ASN.1 Compiler,
 build.xml allows the user to run the sample with ant.

3.2.1 Using the sample

1. Convert the BER file


sample.ber and check the
result.

Figure 3: CDR Converter sample procedure for default mapping

The following chapter is a step-by-step procedure for using the sample.

Step 1. Conversion of the BER encoded file src/cdrSample1.ber.


The CDR Converter uses files generated by the CDR Converter Compiler:
- the Information table test/cdrSample1_table.dat,
- the Mapping file test/cdrSample1_mapping.txt.
The CDR Converter decodes the file src/cdrSample1.ber and generates the CVS file
test/cdrSample1.csv.
The generated file test/cdrSample1.csv is compared with the reference result file
src/cdrSample1.csv.
This step is run with:
ant
The command ant –projecthelp displays help about the main targets.

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools -9- CDR Converter - Installation Guide for UNIX

3.3 SAMPLE WITH CUSTOMIZED MAPPING OPTIONS


The cdr_customMapping sample provides an example of how to deal with customized mapping
options for csv as well as xml outputs.
The cdr_customMapping delivery consists of the following files:
 src/cdrSample2.asn contains the ASN.1 description of the BER values
 src/cdrSample2.ber contains the encoded BER values to convert
 src/cdrSample2.csv is the result CSV file given as reference for the conversion of
cdrSample2.ber
 test/cdrSample2_table.dat is the Information table generated from the ASN.1 syntax by the
ASN.1 Compiler
 test/cdrSample2_mapping.txt is the Mapping file generated from the ASN.1 syntax by the
ASN.1 Compiler
 src/cdrSample3.ber contains other encoded BER values to convert
 src/cdrSample3Size.csv is the result CSV file given as reference for the conversion of
cdrSample3.ber when the option size is used
 src/cdrSample3AllInACell.csv is the result CSV file given as reference for the conversion of
cdrSample3.ber when the option AllInACell is used
 test/cdrSample3_mappingSize.txt is the Mapping file generated from the ASN.1 syntax by the
ASN.1 Compiler, and updated with the size option
 test/cdrSample3_mappingAllInACell.txt is the Mapping file generated from the ASN.1 syntax
by the ASN.1 Compiler, and updated with the AllInACell option
 src/cdrSampleXmlMap.xml is the result XML file given as a reference for the conversion of
cdrSample3.ber
 test/cdrSample4_mappingXmlMap.txt is the Mapping file generated from the ASN.1 syntax
by the ASN.1 Compiler and updated with the ASCII, TBCD and TBCD-1 options
 build.xml allows the user to run the sample with ant

3.3.1 Using the sample

1. Convert the BER file 2. Convert the BER file 3. Convert the BER file 4. Convert the BER file
sample2.ber using sample3.ber using sample3.ber using sample3.ber using
the Mapping file the Mapping file the Mapping file the Mapping file
cdrSample2_mappi cdrSample3_mappi cdrSample3_mappin cdrSample4_mappin
ng.txt and check the ngSize.txt and check gAllInACell.txt and gXmlMap.txt and
result. the result. check the result. check the result.

Figure 4: CDR Converter sample procedure for customized mapping

Step 1. Conversion of the BER encoded file src/cdrSample2.ber without mapping options
The CDR Converter uses the Information table test/cdrSample2_table.dat and the Mapping file
test/cdrSample2_mapping.txt.

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools - 10 - CDR Converter - Installation Guide for UNIX

The CDR Converter decodes the file src/cdrSample2.ber and generates the CVS file
test/cdrSample2.csv.
The generated file test/cdrSample2Size.csv is compared with the reference result file
src/cdrSample2Size.csv.
This step is implemented by the target convNoopt in the file build.xml, and is run with:
ant convNoopt
Step 2. Conversion of the BER encoded file src/cdrSample3.ber using the mapping option size
The CDR Converter uses the Information table test/cdrSample2_table.dat and the Mapping file
test/cdrSample3_mappingSize.txt .
The CDR Converter decodes the file src/cdrSample3.ber and generates the CVS file
test/cdrSample3Size.csv.
The generated file test/cdrSample3size.csv is compared with the reference result file
src/cdrSample3size.csv.
This step is implemented by the target convSize in the file build.xml, and is run with:
ant convSize
Step 3. Conversion of the BER encoded file src/cdrSample3.ber using the mapping option
AllInACell
The CDR Converter uses the Information table test/cdrSample2_table.dat and the Mapping file
test/cdrSample3_mappingAllInACell.txt.
The CDR Converter decodes the file src/cdrSample3.ber and generates the CVS file
test/cdrSample3AllInACell.csv.
The generated file test/cdrSample3AllInACell.csv is compared with the reference result file
src/cdrSample3AllInACell.csv.
This step is implemented by the target convAllInACell in the file build.xml, and is run with:
ant convAllInACell
Step 4. Conversion of the BER encoded file src/cdrSample3.ber using the mapping options ASCII,
TBCD and TBCD-1 with the XML output format.
The CDR Converter uses the Information table test/cdrSample2_table.dat and the Mapping file
test/cdrSample4_mappingXmlMap.txt.
The CDR Converter decodes the file src/cdrSample3.ber and generates the XML file test/
cdrSampleXmlMap.xml
The generated file test/cdrSampleXmlMap.xml is compared with the reference result file src/
cdrSampleXmlMap.xml.
This step is implemented by the target convXmlMap in the file build.xml, and is run with:
ant convXmlMap

All the steps 1 to 4 described above, can be automatically run doing:


ant
The command ant –projecthelp displays help about the main targets.

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools - 11 - CDR Converter - Installation Guide for UNIX

4. DESCRIPTION OF THE DELIVERY

bin binary files


/opt/marben/asn1tools/CDRConverter_VXX Compiler
($CDRCONVERT_DIR)
license license file

bin binary files


Converter
($CDRASNC_DIR)
license license file

Doc

Sample
Figure 5: General overview of the CDR Converter delivery

The delivery consists in the following directories:


 The Compiler/bin directory contains the compiler executables (Java archives, command files).
 The Compiler/license directory contains the copyright and license files. The license file has to
be copied in this directory with the name license.dat if it has not been installed during the
delivery installation.
 The Converter/bin directory contains the CDR Converter executable files.
 The Converter/license directory contains the copyright and license files. The license file has to
be copied in this directory with the name license.dat if it has not been installed during the
delivery installation.
 The Doc directory contains the delivered documentation ([USG], [ING] and [RLN]) in PDF
format.
 The Sample directory contains samples to see how to use the CDR Converter (please refer to
[USG] for more information).

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools - 12 - CDR Converter - Installation Guide for UNIX

5. LICENSE KEY
The CDR Converter is copy protected using a key based on the host-id of the host computer on which
it is used.

5.1 TEMPORARY LICENSE


The CDR Converter is supplied with a temporary key set in the ASN1TOOLS-CDRCONVERTER-
XXX directory of the delivery media. This key is copied in the
<installation_directory>/Compiler/license and <installation_directory>/Converter/license
directories during the installation (See [2.3]).

5.2 ASKING A PERMANENT LICENSE


In order to get a permanent license file, the Licensee shall send the host-id by e-mail to the following
address: support@marben-products.com. The host-id can be obtained by launching the lmutil utility
file (located in the root directory of the delivery media) with lmhostid option. The permanent license
key (license.dat file) will be sent back to you by e-mail.

5.3 DEALING WITH THE PERMANENT LICENSE


The permanent license key (license.dat file) has to be copied to the license directory i.e.
<installation_directory>/Compiler/license and <installation_directory>/Converter/license (See [4]).

5.4 LICENSE TROUBLESHOOTINGS


If you have trouble with your license, you may get the message: "License Request
Failed:<failure message>". This message implies that:
 You have no license file (or not at the right place).
 Your temporary license has expired.
 You are running the Converter on a machine that does not match the license.

First of all, you must check you have a license file. Have a look at the
<installation_directory>/Compiler/license and <installation_directory>/Converter/license directory.
It must contain a file with the name license.dat.
You must then verify your expiration date. You have to edit the license.dat file. On the first line, you
will see either permanent, if you have a permanent key or a date that is the expiration date. If this date
is too old, contact the MARBEN support (support@marben-products.com).
You can also check your host-id. The license.dat permanent file contains a number that is based on the
host-id of your machine. If the license request failure persists, it perhaps means that you are not
running the converter on the machine for which you requested the permanent license key (See [5.2]).
To get more help to deal with license, contact the MARBEN support at support@marben-
products.com.

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)


MARBEN ASN.1 Tools - 13 - CDR Converter - Installation Guide for UNIX

MARBEN
ASN.1 Tools

© Marben Products - Confidential - ASN1TOOLS/CDR/CONV-UNIX/ING/A (2.1)

You might also like