Deploying to test and production systems

Ibex runtime keys

Applications should be installed into production environments using a runtime key. Developer licenses should not be installed on test or production systems.

An Ibex developer license file (called xmlpdf.lic) is in XML format and contains an attribute called "runtimekey". This is a string looking something like this "000200507288C93A81CCXTTRCTRDZMYVZEJK7RPA==".

Runtime key usage - Ibex .NET

To activate the key, pass it to the ibex4.licensing.Generator.setRuntimeKey() API before any FODocument objects are created, like this:

using System;
using System.IO;
using ibex4;
using ibex4.logging;

public class test {

 static void Main( string[] args ) {

 string key = "000200507288C93VZEJK7RPA==";

 ibex4.licensing.Generator.setRuntimeKey( key );

 FODocument gen = new FODocument();

 gen.generate( "", "test.pdf" );


To build the above code from the command line, create a file called ibex.cs, cut and paste the code into ibex.cs, save the file, then compile it using the command:

csc /r:ibex20.dll test.cs	

Note the r:/ibex20.dll creates a reference to the ibex20.dll file, so if this is not in the current directory you need to use the full path, like this:

csc /r:c:\ibex\ibex20.dll test.cs	

You may also need to copy ibex20.dll into the directory from which the program is run.

Obviously the key in the code above is not a real runtime key, you will need to insert your own key.

Ibex checks whether the runtime key is in use the first time an FODocument object is created. If you deploy your application to IIS you may need to restart IIS the first time you use the runtime key.

Set the runtime key only once

The runtime key sets a static variable in memory within your application. It only needs to be set once when the application starts running, not once for every FODocument object created.

Copyright (c) 2002-2021 Visual Programming Limited