Installing Symphonia Licenses
Symphonia (of which Mapper is a part of) changed the licensing system to enable us to better serve our customers. Prior to Symphonia 3.5, Symphonia used keys such as ABCDEFGHIJKLMNOPQRST. Now, licence files such as "mylicence.lic" are provided, and these must be installed before Symphonia will run correctly.

Demonstration Licences: When Symphonia is installed, it automatically installs a 60-day demonstration licence unless a full development licence is provided during the setup process. This allows you to immediately start evaluating Symphonia after the installation process has completed.

Development Licences: Full development licences can be purchased from This e-mail address is being protected from spambots. You need JavaScript enabled to view it . A development licence is e-mailed to the purchaser as a *.lic file. This can then be installed from the About box (from Help menu -> About...) of either EDI Message Designer, or the Symphonia Map Builder.

About EDI Designer
Figure 1: EDI Message Designer About Box

Alternatively, if the demonstration licence has expired, the Symphonia Map Builder will offer to install a licence at startup as shown below.

Mapper Reg
Figure 2: Symphonia Map Builder requesting a licence

Runtime Licences: A runtime licence must be installed on a system before an application using Symphonia will work correctly. Runtime licences can be obtained by contacting This e-mail address is being protected from spambots. You need JavaScript enabled to view it . A utility called RuntimeKeyReg.exe is provided with Symphonia, and is found in \Redistribution. By default this is:

C:\program files\Symphonia\Redistribution

Note: RuntimeKeyReg.exe is missing from the 3.8.1 Install.

Running this application launches a screen like the one shown below:

Runtime Key
Figure 3: Runtime Licence Registration Utility

Alternatively, this may be run via the command line. RuntimeKeyReg.exe expects 1 or 2 parameters. The first parameter is the name of the licence file, and the second (optional) is whether or not to run in silent mode ("/s"). If silent mode is on, then the utility does not pop up any message boxes if the registration was successful. This is particularly useful for including within application setups.

Java Runtime Licences: Since Java does not have access to the registry when running, the Symphonia Java Engine, and the Java Mapper require access to a properties file with the licence information when the application is run. The properties file is created by running the KeyInstall class of either the symphonia3 or mapper packages as follows:

java -jar symphonia3.jar c:\ c:\mylicence.lic /s

This would create the properties file in c:\, and would create it from the licence file c:\mylicence.lic. The optional third parameter, /s, tells the KeyInstall class to run in silent mode, which means that it does not output anything if the registration was successful.

If you have any further questions regarding Symphonia licencing, please contact either This e-mail address is being protected from spambots. You need JavaScript enabled to view it or This e-mail address is being protected from spambots. You need JavaScript enabled to view it .