Release Notes for TM v3.10

Release 3.10 (released January 2006) contained the following new features:

Units of Measure Conversion

Transformation Manager (TM) includes an automatic unit of measure (UOM) conversion system for all numeric data types and for string types, if this is appropriate.

The conversion system is based on the principles of Class and Unit. Example Classes are length, volume, etc. For each Class (e.g. length) there will be a number of defined Units (e.g. metre, centimetre, inch, mile etc).

For each UOM Class an international standard (SI) Unit is defined (e.g. metre for Class length). All units within the same class are defined in terms of this standard unit. Thus, conversion between any two units within the same class is possible, by converting to and from the standard unit.

The standard classification system is defined in an XML file si_uom.xml and is provided with TM. This file is loaded when TM is launched. If UOM conversions are required during the transformation process the rules specified by this file are applied.

To specify the Class and Unit for attributes in a particular model the model is exported to an XML file. This file is edited by the user to specify each attribute’s Class and Unit. The file is then re-imported. The UOM attribute information is stored in the repository.

Users may extend known UOM Classes by adding new Units to the model export file. The new unit must be defined in terms of the standard unit of the class that is being extended. These non-standard units, and their conversions to other units within the same class, will be available for TM projects that use that model.

A built-in UOM Conversion function is provided, to be called explicitly when the source is a local variable, an expression, or the result of a UDF.

For further information on Units of Measure Conversion, please refer to the TM Advanced Features Guide.

TM Installation Procedure

The procedure for installing TM has changed.

To install TM, it is necessary to download the installer and install the licence file.

Downloading TM Installer

ETL’s TM Installers are available from the Resource Centre of the ETL web site www.etlsolutions.com. To access the Resource Centre you will need to register as a user and be given sufficient privilege to access the web downloads.

Once you have downloaded TM, the installation will begin automatically. If it does not, start the installer by opening the directory containing the TM installer (C:\IA_Installers\TM\install.exe) and double- click install.exe program in that directory. ETL’s TM Installer uses InstallAnywhere by Zero G (www.zerog.com), recently acquired by Macrovision.

Follow the instructions, remembering in particular to:

1. Read and Accept the licence terms.

2. Choose an install folder – the default is C:\Program Files\TM – and click on the Finish… button when complete.

Installing the Licence File

A valid licence file must be installed before TM can be used.

All ETL products use FlexLM licensing from Macrovision.

TM product suite is divided into a range of products, each of which can be licensed as shown in the table below.

In version 3.8 of TM, the Development Kit Licence includes TM Design Tool and TM Test Tool licences. For this release only it also includes TM Debugger, TM Deployment Tool and TM Runtime. In version 3.8 only TM Runtime can be run without a licence and a warning is displayed.

Three licence types are supported by ETL:

• Floating (also known as Concurrent or Counted) Licence
• Node-Locked (also known as Named) Licence. i.e. locked to a specific machine or username
• Demonstration (Time-expired) Licence

1. Floating (or Concurrent or Counted) Licence

This is the recommended approach since Macrovision recommend that end users use a FlexLM licence server system.

This can control a licence for single or multiple users. Where there are multiple users, the same licence file is used by all users. Users may either point at the same file, or can have their own copies of the file locally, as the server location is specified in the licence file.

The issued floating licence(s) is tied to the hostID and may optionally be tied to:

• Named user(s), or
• IP address

System administrators should download and install the licence server, if necessary, then configure the licence server, which must be running lmgrd and pointing at the supplied licence file.

The address of the server is required before a floating licence can be generated.

To find out the Host ID of your server:

• Go to http://www.macrovision.com/services/support/fnp_utilities.shtml
• On that page select your operating system, and click on its lmutil.
• Run lmutil lmhostid

The output should be as shown below:

Send the FLEXlm host ID of your machine (circled in red) to us at ETL.

2. Node-Locked Licence

If you are not using a FlexLM licence server it may be possible to use a node-locked licence. This allows for single host licences that are locked to a specific node (IP Address) to be issued, since counted licences are not supported if not using a FlexLM licence server. In some cases where the user is unable to restrict the IP address, a time-expired IP Address range licence may be provided.

The customer must supply the IP address before the licence file can be generated.

The generated file should then be put in C:/Program Files/TM/etc/

This is where TM Design time and run-time looks by default. The file can be put in another location if required, in which case, the user should use the TM Properties Editor to edit the Design Time.lax file (and all other relevant files) and specify the location on the licence page.

A single licence file can give permissions for multiple components – i.e. the design time and run-time.

3. Demo (Time-expired) Licence

In addition a demo licence can be issued which permits all products to be used on any platform for a limited time period – usually one month.

Upgrading From a Previous Release

Before upgrading an existing installation to the latest release:

1. Make backups of any repositories before installation.

2. After installation, copy the LastFiles.properties from C:\TransMan to
C:\Project Files\TM
This will ensure that your environment settings and repository connection details appear in the new installation.
If your repositories were contained in C:\TransMan\repositories, it is recommended that you copy the repositories over to C:\Program Files\TM\repositories.

3. Edit the start-menu shortcuts. Go to
Start->All Programs->Transformation Manager. There should be 5 items present:

• TM Design Tool
• TM Test Tool
• TM Deployment Tool
• TM Properties Editor
• Docs

All other menu items should be deleted (by right-clicking on the menu item).

If you have difficulties with installation, please contact support@etlsolutions.com.