When you first start MiddleVR, you will see the following screen :

If you don't have a valid license, you can run the Free version of MiddleVR Config by pressing the "Use 'Free' edition" button.

You can get a valid trial license for 30 days by pressing the "Start 30 days 'Pro' trial" or "Start 30 days 'Academic' trial" button.

Getting a license with an Activation Key

You can download a permanent or temporary license after having received an "Activation Key" from us, by pressing the "Get a license" button.

You can load a valid license that you have received by pressing the "Load a license" button.

Note: Before trying to get a valid license, make sure that you have received an "Activation Key".

After pressing the "Get a license" button, you will see this window :

Enter your activation key and the license should be automatically obtained.

Getting a license manually

If you get an error, you still have the option of trying to manually activate your key :

You can also get a valid license either through the web, or via an automatic e-mail. Choose the option that best suits your situation.

Getting a valid license via the Web

When you press the "License via Web" button, you will get the following window :

The "HostID" is a string that uniquely identifies your computer. This string will be used to generate a valid license for this particular computer.

Start by copying the HostID to the clipboard by pressing the first button.

Then access the License Activation website by pressing the second button or opening your favorite web browser to the following address :

If the first page you see looks like the following one, please click on the "Enter your activation key to get your license." link just under the "Log In" button :

You should then enter your Activation Key :

Once you have entered a valid Activation Key, you will get access to the following form :

Simply paste the HostID in the relevant text input and press the "Activate" button :

Once the license has been generated, you can download the license file :

Store the license anywhere.

Note: You can download again the license file from the license website simply by entering the same Activation Key. You don't need to enter the HostID again.

Come back to the MiddleVR configuration tool and press "Load license file". Next, read the "Load license file" section.

License via e-mail

After pressing the "License via e-mail" button you should get the following form :

After entering your Activation Key, your form should look like that :

The content of the second text-box is automatically filled with the content of the mail that you should send to get your license file.

After pressing the "Send by e-mail" button, if you have correctly configured your default e-mail application, MiddleVR should create an e-mail that you just have to send :

You should soon after receive an e-mail containing your license. Store the attached liencese anywhere and press "Load license file".

You can also manually send an e-mail, from a webmail for example. Simply copy the content of the second text-box by pressing the "Only copy to clipboard" button and paste the text in the body of the email. The subject of the e-mail does not matter. The e-mail recipient should be :

Loading the license file

Once you have store your license file, you can load it via the "License > Add license file ..." menu.

Locate the license file that you've just downloaded. You should get the following message :

At this point you can remove or backup the downloaded license file :

MiddleVR will automatically copy this file to the %appdata%/MiddleVR folder, typically : C:\Users\<current user>\AppData\Roaming\MiddleVR\

Note: If you log in as a different user, MiddleVR will not find the license. You can go in the "License > Add license file ..." menu and load the license file again, or manually copy it to the %appdata%/MiddleVR folder corresponding to the current user.

Floating / network licenses

License server

When dealing with a floating/network license, don't load the license file into the configuration editor. The following steps describe how to easily install a license server on Windows using the LM-X End-user Tools (Windows only).

  1. Download and run "lmx-enduser-tools_win32_x86.msi".

  2. During the installation process, make sure that "Install LM-X server" is checked.

    Browse to find our "liblmxvendor.dll" in the MiddleVR installation path /bin/licensing

    Keep "Install LM-X license server as a service" checked.

After the installation, open the configuration file "lmx-serv.cfg" from the LM-X tool installation folder (for example "C:\Program Files (x86)\X-Formation\LM-X End-user Tools 4.5.4\lmx-serv.cfg").

Set the value LICENSE_FILE to the path leading to your floating/network license file.

You can choose your TCP_LISTEN_PORT if needed.

Make sure to open this port (TCP and UDP) in your firewall, both on the license server machine and the client machines.

If there are any problems running the license server, the log file will indicate the cause of the problem. You can find the log file at the path indicated in the configuration file value LOG_FILE. If still not found, check to make sure that the path is correct.

You also can manage the license server through a web GUI:

Open a web browser to the right machine IP address and the right license server port, for example: "http://localhost:6200/".

The administrator password is the one defined in the license server configuration file at REMOTE_ACCESS_PASSWORD.

Configuring clients

On the client machines, you can either:

  • use the License configuration tool lmxconfigtool.exe from the MiddleVR folder in the Start menu:

    In the Client Application License Path tab, specify the network license server in the form of : 6200@ You can also use a network name instead of an IP address.

  • or, set the LMX_LICENSE_PATH environment variable to the network license server, in the same form.

Storing your license in a different folder

You can store your license in a different folder and set the LMX_LICENSE_PATH environment variable to the full path of the license.