![Abstract composition of teal triangles floating above a water surface (no text or symbols)](.vortex-cafe-installation-guide/2e156a71a508bb9a5a7590989c554d75ae72bf388c09bc5f40547a4a51cea345.jpg)

# VORTEX

# CAFE

# Installation Guide

# Release 2.4.0

# Contents

# 1 Requirements 1

1.1 Software dependencies .

# 2 Installation 2

2.1 Obtain the Vortex Platform installation file 2
2.2 Run the Vortex Platform Setup Wizard 2
2.3 Vortex Café directories organization 9
2.4 Complete the installation for an Apache Maven build system . . 10
2.5 Uninstalling Vortex Platform . 10

# 3 Licensing Vortex Café 14

3.1 General 14
3.2 Development and Deployment Licenses 14
3.3 Installing the License File 14
3.4 Running the License Manager Daemon 15
3.5 Utilities 16

# 4 Compiling the examples 17

# 5 Troubleshooting 18

# 6 Contacts & Notices 19

6.1 Contacts 19
6.2 Notices 19

# 1

# Requirements

# Software dependencies

# Required before installation

The following software must be installed on your host system before installing Vortex Café:

• An Oracle Java Development Kit (JDK) v7 minimum

(ensure that JAVA\_HOME is defined and that the java executable is in your PATH).

Note that the examples/ishapes project requires JDK v8 to compile since it requires JavaFX v8 (delivered with JDK8).

• (optional) Apache Maven v3.3.x

Only if you want to use Apache Maven as your build system

(ensure that the mvn executable is available in your PATH).

• (optional) The Android SDK Tools only

Only if you want to compile the android-ishapes example.

Make sure that you install the appropriate API level within this tool. (see the property android:targetSdkVersion in the file examples/android-ishapes/AndroidManifest.xml).

You can download it at https://developer.android.com/sdk/index.html#Other .

# Other noteworthy dependencies

Vortex Café uses the following open source libraries, which for convenience are bundled in the installation zip file (you don’t need to install them separately).

• Netty (http://netty.io/)
• Trove4j (http://trove4j.sourceforge.net)
• Apache Commons (http://commons.apache.org/)
• SLF4J (http://www.slf4j.org/)

# Environment

These environment variables must be set:

• PATH (must include JDK bin directory)
• JAVA\_HOME (must point to JDK installation directory)
• any environment variable required to check your license (see std,std-refLicensing Vortex Café)

# 2

# Installation

# Obtain the Vortex Platform installation file

Check that the file that you have obtained (by downloading or other method) is the appropriate one for your system. The name of the file indicates the target platform as well as the Vortex Platform version.

Example installer file names:

```txt
VortexPlatform_v2-linux-x32-installer.run
VortexPlatform_v2-linux-x64-installer.run
VortexPlatform_v2-windows-x32-installer.exe
VortexPlatform_v2-windows-x64-installer.exe
```

(It is possible to install a 32-bit version of Vortex on a 64-bit system, but for the best performance you should install the 64-bit version.)

If you wish to install on another system other than windows or linux, then you can obtain an archive file from ADLINK and unzip that instead of the installer.

# Run the Vortex Platform Setup Wizard

# Start the installer

Navigate to the directory which contains the Vortex installer file.

If you are using a GUI, you can usually just double-click on the installer to run it.

If you are using a console (‘command line’), enter the appropriate command for your platform. (On most versions of Windows and Linux this means typing the file name, excluding the .exe or .run extension, and pressing the &lt;Enter&gt; key.)

# Linux Windows

Once it starts, the operation of the installer is the same on both Windows and Linux platforms; the example screens shown in the following steps are from a Windows system.

The Vortex installer splash screen appears briefly before the Setup Wizard ‘Welcome’ screen is displayed.

# Proceed with the Setup Wizard

Click Next.

![Setup\nSetup - VortexPlatform_v2\nWelcome to the VortexPlatform_v2 Setup Wizard.\nADLINK\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/ed2786d7e8eeff9290ccb4b54bbfe70441ee9307b6cca7271f44fdf0c8aca74b.jpg)

Fig. 2.1: Figure 1 Welcome to the Setup Wizard

![Setup\nLicense Agreement\nPlease read the following License Agreement. You must accept the terms of this\nagreement before continuing with the installation.\nSOFTWARE LICENSE AGREEMENT\nThis license agreement ('Agreement') is a legal agreement between\nyou, a single corporate entity ('Licensee') and the PrismTech\nGroup Limited company with which your purchase order is placed and\naccepted ('Licensor'), for use of Licensor's (and / or its\naffiliates) and / or its licensor's proprietary software products,\nwhich include any computer software, printed materials, 'online'\nor electronic documentation and any upgrades or modifications\nDo you accept this license?\n○ I accept the agreement\n○ I do not accept the agreement\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/509c8b07d95471b091a5140560f4a706a40e6f1406a3447d33a8e5aa0996f85c.jpg)

Fig. 2.2: Figure 2 Accept the License Agreement

# 2.2. Run the Vortex Platform Setup Wizard

# Accept the License Agreement

If you do not accept the terms of the license, the installation is cancelled.

Click Next.

# Choose a location for the Vortex Platform installation

![Setup\nInstallation Directory\nPlease specify the directory where VortexPlatform_v2 will be installed.\nInstallation Directory C:\Program Files\ADLINK\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/49474cca20b322f86c7644524d1b07731e0e495f9c394912e3adc3ad514437fe.jpg)

Fig. 2.3: Figure 3 Choose a location for the Vortex Platform installation

You can either accept the default destination directory or choose a different location by typing its path or by navigating to it using the ‘browse’ button.

# Windows

On Windows, the default installation directory (shown in Figure 3) is:

$\mathsf { C } : \mathsf { \backslash P r o g r a m \mathsf { F i l e s \backslash A D L I N K } }$

(For this example, the Vortex Platform will be installed in C:\apps\ADLINK\Vortex\_v2.)

# Linux

On Linux, the default installation directory is:

$/ \mathrm { h o m e / &lt; u s e r &gt; / \bar { A } D L I N K / V o r t e x \_ v 2 }$

Click Next.

# Choose which components to install

Click on a component name to display a description of the component.

All Vortex Platform components are selected for installation by default.

# 2.2. Run the Vortex Platform Setup Wizard

![Setup\nSelect Components\nSelect the components you want to install; clear the components you do not want to install. Click Next when you are ready to continue.\n✓ Vortex Cafe 2_3_3\n✓ Vortex Cloud 2_1_2\n✓ Vortex Fog 2_1_2\n✓ Vortex Gateway 2_3_1\n✓ Vortex Web 1_2_5\n✓ Vortex Insight 2_1_0\nClick on a component to get a detailed description\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/4156cab4d7a40cf8305176cfbc0fa2b8fb9f17b479ca8b75736d7f4ee6ff524e.jpg)

Fig. 2.4: Figure 4 Choose which components to install

If any Vortex Platform components are already installed in the location chosen at Choose a location for the Vortex Platform installation, their names are greyed-out and they cannot be de-selected. (To remove Vortex Platform components from your system, use the uninstaller described in the Uninstallation chapter std,std-refUninstalling Vortex Platform).

Click Next.

# Enter the location of your license file

If you do not yet have a license file, leave No selected (the default) and click Next. You will have to obtain a license file and install it manually according to the instructions in the separate Vortex Licensing Guide before you can run Vortex.

If you already have a license file, choose Yes; the Setup Wizard will then perform the necessary configuration steps automatically. Information about these changes is saved in the etc directory where Vortex is installed (C:\apps\ADLINK\Vortex\_v2 in this example).

Click Next.

If you chose Yes, a dialog appears where you can enter the path to your license file, or use a browse button to navigate to it; otherwise the Setup Wizard proceeds to the next step.

# Install for current or all users?

# Windows

# WINDOWS ONLY

On Windows platforms, you can choose whether to install Vortex for all users or only for the current logged-in user.

The default is for Vortex to be installed only for the current user.

# 2.2. Run the Vortex Platform Setup Wizard

![Setup\nObtaining a license\nSelect option below to automatically configure your installation with an existing license file.\n○ Yes\n● No\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/97663a1345f56e36e93233c19e283da658f698485cb567c37361933b19afe232.jpg)

Fig. 2.5: Figure 5 Indicate location of existing license file (1)

![Setup\nPlease provide an existing license file (if available ...)\nIf you already received a license file for this release, provide it here to get it installed automatically.\nLicense file to install automatically.](.vortex-cafe-installation-guide/8cdd1c8722703d2067e86fe1a491bf2b64570198b6b8892b5bd3d05ed350e902.jpg)

Fig. 2.6: Figure 6 Indicate location of existing license file (2)

![Setup\nVortex Installation Scope\nDo you wish to install the Vortex Product Suite for only the current user or for all users of\nthe machine?\nPlease note that the current user must have administrative privileges in order to install\nVortex Product Suite for all users.\n● Current user only\n○ All users\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/056da732c072fd6192765a8642be83052fd860b4030b4617dd7d1b60b8357c82.jpg)

Fig. 2.7: Figure 7 Install for current or all Windows users

If Vortex is to be made available to all users, then the current user (performing the installation) must have Administrator privileges.

Click Next.

# Begin installation

The Setup Wizard is now ready to begin the actual installation.

If you want to review or change any of the choices or entries you have made, you can use the Back and Next buttons until you return to this screen.

Click Next to proceed and install Vortex on your system.

Click Cancel if you decide to abandon the installation. No changes will be made to your system, and any information you have entered will be lost. You will have to run the installer again if you decide to install Vortex later.

# Wait whilst installation proceeds

The Setup Wizard displays a progress bar and a slideshow describing the Vortex Suite components whilst files are installed on your system.

If you click the Cancel button during this phase, then you may be left with a partial installation. For those Vortex components installed you will have an uninstaller that can be invoked to remove it.

# Installation completed

When all of the necessary files have been installed and the Vortex components have been configured, the Setup Wizard displays a final dialog.

# 2.2. Run the Vortex Platform Setup Wizard

![Setup\nReady to Install\nSetup is now ready to begin installing VortexPlatform_v2 on your computer.\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/10970066206a54baedffa8f4931894991d07be6910021e1b3822b9f5e0c01d60.jpg)

Fig. 2.8: Figure 8 Proceed or Cancel installation

![Setup\nVORTEX\nCAFÉ\nThe only 'pure' Java DDS implementation\ntargeting Java-centric systems\nSpecifically optimized for Android mobile devices\nplease wait for the installation to complete\nADLINK\nInstalling\nInstalling Vortex Cafe...\nInstallBuilder\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/f15cf4e6d93ccf67c1589fa5d51b097acf1834dbbc417d76da1f1029bdd109e0.jpg)

Fig. 2.9: Figure 9 Progress of installation process

![Setup\nCompleting the VortexPlatform_v2 Setup Wizard\nSetup has finished installing VortexPlatform_v2 on your computer.\nADLINK\n( Back	Finish	Cancel](.vortex-cafe-installation-guide/03783bd3c9085acac604e13a0e6f2d2df57acbb37188b8095a9d02ffcac0b226.jpg)

Fig. 2.10: Figure 10 Finish the Setup Wizard

Documentation for the components of the Vortex Platform is installed in docs directories within the individual component directories. For example, on the Windows system used to illustrate the steps above, the documentation for Vortex Café is installed in C:\apps\ADLINK\Vortex\_v2\Device\VortexCafe\2.2.0\docs.

# Vortex Café directories organization

The Vortex Café installation directory contains the following sub-directories:

• apache-maven/ :
Contains the Vortex Café jars ready to be installed in your Maven local repository (optional if you don’t use Apache Maven).
• bin/ :
Contains the scripts for the idl2j code generator (see the Vortex Café User Guide).
• docs/ :
Contains the documentation set (HTML and PDF) and release notes.
• examples/ :
Contains code examples demonstrating the use of Vortex Café.
• lib/ :
Contains the Vortex Café jars to be used with your Ant or Maven projects.

If you don’t use Apache Maven you can directly use Vortex Café’s jars in your projects, as described in the User Guide.

# Complete the installation for an Apache Maven build system

To install Vortex Café in your local Maven repository, execute the following commands:

```batch
cd VortexCafe/&lt;version&gt;/apache-maven
mvn -f VortexCafe-installation.pom
```

# Uninstalling Vortex Platform

The Vortex Platform includes a convenient uninstallation utility for either complete or partial removal of the software from your system.

# Location of the uninstaller

The Vortex Platform Setup Wizard creates the uninstaller in the VortexPlatform installation directory, which was chosen during the running of the Setup Wizard (see std,std-refChoose a location for the Vortex Platform installation).

# Windows

On Windows, the default installation directory is

```txt
C:\Program Files\ADLINK\VortexPlatform_&lt;version&gt;
```

and the uninstaller is named uninstall-VortexPlatformV&lt;version&gt;.exe.

# Linux

On Linux, the default installation directory is

```txt
/home/&lt;user&gt;/ADLINK/VortexPlatform_&lt;version&gt;
```

and the uninstaller is named uninstall-VortexPlatformV&lt;version&gt;.run.

# Start the uninstaller

# Windows

Start the uninstaller either

• from the Windows Start menu: Start > ADLINK > VortexPlatform &lt;version&gt; > Uninstall VortexPlatform &lt;version&gt;
or
• navigate to the Vortex Platform installation directory (see Location of the uninstaller above) and run uninstall-VortexPlatformV&lt;version&gt;.exe.

# Linux

Navigate to the Vortex Platform installation directory (see Location of the uninstaller above) and run uninstall-VortexPlatformV&lt;version&gt;.run.

# Linux

# Windows

Once it starts, the operation of the uninstaller is the same on both Windows and Linux platforms; the example screens shown in the following steps are from a Windows system.

# 2.4. Complete the installation for an Apache Maven build system

# Choose whether to uninstall VortexPlatform completely or just some components

![The image shows a green arrow pointing to the right on a yellow background.](.vortex-cafe-installation-guide/805daafa953358135ad613fd961a8440ab2215f7dfe65e7e82017354ce015808.jpg)

Setup

Uninstallation mode

![Three vertical white rectangular panels are arranged side-by-side. Each panel contains a single, short, horizontal black line centered vertically and horizontally.](.vortex-cafe-installation-guide/98a6b221c6deb120d91944612c3598bffd65cf4d4dd2d250db605c9d97cc76ad.jpg)

![803119,06](.vortex-cafe-installation-guide/80afe372dbe0217ebf7b94a414c5bca73c7618c0aa15070f7c89679abb5a2990.jpg)

![The image displays a vertical rectangular strip with a light gray background. In the center, there are two black, pixelated 'X' symbols arranged side-by-side. Thin black vertical lines frame the far left and right edges of the image.](.vortex-cafe-installation-guide/dec7992e0f2320a6d2cf80a73ef5f90f5ae5d52d80b88b5b0573005f965750a8.jpg)

![The image displays a red, upward-pointing triangular logo. Inside the lower portion of the triangle are four horizontal white stripes. To the right of the triangle is a small registered trademark symbol (®).](.vortex-cafe-installation-guide/cc9252c552d426ba8243320d88603b362c88d828c91c343fe90214ddef0bb7d3.jpg)

Do you want to uninstall allVortexPlatform\_v2 components or individual components?

O All VortexPlatform\_v2 components

Removes all components and all files installed by VortexPlatform\_v2

Individual components]

Removes individual components while leaving other VortexPlatform\_v2 components installed

Next >

Cancel

Fig. 2.11: Figure 12 Uninstall entire application or individual components

The names of components which are not installed are greyed-out and they cannot be selected.

Click Next.

In case you selected all the components, you’re asked to confirm that you really want to uninstall the full Vortex Platform.

Click Yes to proceed, or No to cancel the operation.

# Click YES

A progress bar is displayed as the uninstallation proceeds.

# Uninstallation completed

Click OK.

![The image displays a blurry, low-resolution icon featuring a green arrow pointing to the right, centered within a yellow square background. It resembles a standard 'next' or 'forward' button interface element.](.vortex-cafe-installation-guide/86a5daae9a84ec60b38d3a1775da343849d87088a0949f4b2019f458c65e11d4.jpg)

Setup

# Select Components To Uninstall

![The image displays a single, black horizontal line centered on a white background, resembling a hyphen or minus sign.](.vortex-cafe-installation-guide/b1a4d252e08af6970f873dec355ed019790e1188e860b1208e6e6d66b9a82f44.jpg)

![The image shows two identical rectangular frames positioned side-by-side against a plain white background. The frame on the right is positioned slightly higher than the frame on the left. Each frame features a thick white outer border, a thinner inner border, and a white center. There is no text in the image.](.vortex-cafe-installation-guide/551707041aae786b9038be1c81b006665d383d4950d3ce27eef058ebf5430faa.jpg)

![The image displays two black, pixelated 'X' shapes arranged horizontally. There is a vertical white gap separating the left 'X' from the right 'X'. The background is white.](.vortex-cafe-installation-guide/48f5be0576e35050959f205d3c2fbe7f7d0efdd5086fd7e4c8a0bcee09b0e81e.jpg)

![The image displays a logo featuring a red, upward-pointing triangle with three horizontal white stripes inside. A small registered trademark symbol (®) is located to the bottom right of the shape.](.vortex-cafe-installation-guide/f0d8e4b539d47985309401be23dfa40e7e37145c949160673d9f0810e7d95bb2.jpg)

Select the components you want to uninstal: clear the components you do not want to remove. Click Next when y ou are read to continue.

Vortex Cafe 2\_3\_3
Vortex Cloud 2\_1\_2
Vortex Fog 2\_1\_2
Vortex Gateway 2\_3\_1
Vortex Web 1\_2\_5
Vortex Insight 2\_1\_0

Click on a component to get a detailed description

&lt; Back

Next &gt;

Cancel

Fig. 2.12: Figure 13 Choose components to uninstall
![A low-resolution, pixelated icon featuring two vertical lines on the left, followed by a yellow square containing a teal arrow pointing to the right.](.vortex-cafe-installation-guide/8c4b08f3b4fc65817022fc7eb9806a281ef038cdd39577c73919bd98ce10fb36.jpg)

Question

![A blue circle containing a white question mark symbol.](.vortex-cafe-installation-guide/4890f0e3b2b4fb4c0b0752dafd1aa35e127f4e5e0de31de595b8603350cdeb02.jpg)

You are about to uninstall VortexPlatform\_v2 - do you wish to continue

Yes

No

Fig. 2.13: Figure 14 Confirm uninstallation

![Setup\nUninstalling VortexPlatform_v2\nUninstall Status\nUninstalling VortexPlatform_v2\nUninstalling Vortex Cloud....\n( Back	Next )	Cancel](.vortex-cafe-installation-guide/1844517d11a4de105157afe1b54883ec59879feb046ecd18eea3b2e759bed628.jpg)

Fig. 2.14: Figure 15 Progress of uninstallation process

![Info\ni Uninstallation completed\nOK](.vortex-cafe-installation-guide/91b7845d307d402be12b257590727b887ef808a5177d4c50c4268b84077fd615.jpg)

Fig. 2.15: Figure 16 Uninstallation completed

# 3

# Licensing Vortex Café

Vortex Café uses Reprise License Manager (RLM) to manage licenses. This section describes how to install a license file for Vortex Café and how to use the license manager.

# General

The licensing software is automatically installed on the host machine as part of the Vortex Café distribution. The software consists of two parts:

• Vortex Café binary files

which are installed in &lt;Vortex\_Café\_Install\_Dir&gt;/bin,

where Vortex\_Café\_Install\_Dir is the directory

where Vortex Café is installed.

• License files

which determine the terms of the license.

These will be supplied by ADLINK.

![The image shows a partial view of a blue lowercase letter 'i' on a white background. The dot of the letter and the upper portion of its stem are visible.](.vortex-cafe-installation-guide/5d134c79859d2cb68d5826043d782e8562229a65e4870281822739bf5b6f6efe.jpg)

Licenses: ADLINK supplies an Vortex Café license file, license.lic. This file is not included in the software distribution, but is sent separately by ADLINK.

# Development and Deployment Licenses

Development licenses are on a per Single Named Developer basis. This means that each developer using the product requires a license. Vortex Café is physically licensed for development purposes. Vortex Café is also physically licensed on enterprise platforms for deployment.

# Installing the License File

Usually you get a license file for multiple Vortex products. The simplest way to install such a license file is to copy this file to the \${VORTEX\_HOME}/license directory. \${VORTEX\_HOME} is an environment variable set by the Vortex Platform installer and pointing to the installation directory of all Vortex products.

This is the recommended location for the license file but you can put the file in any location that can be accessed by the license manager rlm.

If another location is used or the environment has not been setup, then an environment variable, either RLM\_LICENSE or ADLINK\_LICENSE or prismtech\_LICENSE, must be set to the full path and filename of the license file (either variable can be set; there is no need to set both). For example:

ADLINK\_LICENSE=/my/lic/dir/license.lic

If licenses are distributed between multiple license files, the RLM\_LICENSE or ADLINK\_LICENSE or prismtech\_LICENSE variable can be set to point to the directory which contains the license files.

If no valid license file can be found in the above locations, Vortex Café will also search for a valid license file in the following directories:

• \${VORTEX\_HOME}/Device/VortexCafe/&lt;version&gt;/etc
• \${VORTEX\_HOME}/etc
• \${HOME}/etc
• /etc

# Running the License Manager Daemon

It is only necessary to run the License Manager Daemon for floating or counted licenses. In this case, the license manager must be running before Vortex Café can be used. The license manager software is responsible for allocating licenses to developers and ensuring that the allowed number of concurrent licenses is not exceeded.

For node-locked licenses, as is the case with all evaluation licenses, then it is not necessary to run the License Manager Daemon but the RLM\_LICENSE or prismtech\_LICENSE variable must be set to the correct license file location.

To run the license manager, use the following command:

```txt
rlm -c &lt;location&gt;
```

where &lt;location&gt; is the full path and filename of the license file. If licenses are distributed between multiple files, &lt;location&gt; should be the path to the directory that contains the license files.

The rlm command will start the ADLINK vendor daemon prismtech, which controls the licensing of the Vortex Café software.

To obtain a license for Vortex Café from a License Manager Daemon that is running on a different machine, set either the RLM\_LICENSE or prismtech\_LICENSE environment variable to point to the License Manager Daemon, using the following syntax:

```txt
RLM_LICENSE=&lt;port&gt;@&lt;host&gt;
```

where &lt;port&gt; is the port the daemon is running on and &lt;host&gt; is the host the daemon is running on.

The port and host values can be obtained from the information output when the daemon is started. The format of this output is as shown in the following example:

```txt
07/05 12:05 (rlm) License server started on rhel4e
07/05 12:05 (rlm) Server architecture: x86_12
07/05 12:05 (rlm) License files:
07/05 12:05 (rlm) license.lic
07/05 12:05 (rlm)
07/05 12:05 (rlm) Web server starting on port 5054
07/05 12:05 (rlm) Using TCP/IP port 5053
07/05 12:05 (rlm) Starting ISV servers:
07/05 12:05 (rlm) ... prismtech on port 35562
07/05 12:05 (prismtech) RLM License Server Version 9.1BL3 for ISV "prismtech"
07/05 12:05 (prismtech) Server architecture: x86_12

Copyright (C) 2006-2011, Reprise Software, Inc. All rights reserved.

RLM contains software developed by the OpenSSL Project
for use in the OpenSSL Toolkit (http://www.openssl.org)
Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved.
Copyright (c) 1995-1998 Eric Young (eay@cryptsoft.com) All rights reserved.
```

# 3.4. Running the License Manager Daemon

```txt
07/05 12:05 (prismtech)
07/05 12:05 (prismtech) Server started on rhel4e (hostid: 0025643ad2a7) for:
07/05 12:05 (prismtech) Vortex_Cafe_product1 Vortex_Cafe_product2
07/05 12:05 (prismtech)
07/05 12:05 (prismtech) License files:
07/05 12:05 (prismtech) license.lic
07/05 12:05 (prismtech)
```

The &lt;port&gt; value should be taken from the first line of the output. The &lt;server&gt; value should be taken from the last line. From this example, the value for RLM\_LICENSE or prismtech\_LICENSE would be:

35562@rhel4e

# Utilities

A utility program, rlmutil, is available for license server management and administration. One feature of this utility is its ability to gracefully shut down the license manager. To shut down the license manager, preventing the checkout of licenses for the Vortex Café software, run either of the following commands:

```txt
rlmutil rlmdown -vendor prismtech
rlmutil rlmdown -c &lt;location&gt;
```

where &lt;location&gt; is the full path and filename of the license file.

The rlmutil program is also used to generate a host identification code which is used to generate your license key. To generate the code, run the following command on the license server:

# Linux

```txt
rlmutil rlmhostid
```

# Windows

```txt
rlmutil rlmhostid ether
```

This returns an ID code for the server, which will look similar to:

Hostid of this machine: 0025643ad2a7

This ID code must be supplied to ADLINK so that your license key can be generated.

# 4

# Compiling the examples

To compile all the examples using Apache Maven, run the following command in examples/ directory:

mvn package

Note that the Android examples will be compiled only if your ANDROID\_HOME environment variable is set (i.e. if the Android SDK is installed).

If you prefer to use Ant, you need to compile each example individually. Please see instructions for each example in ../examples/examples-list.html

# 5

# Troubleshooting

If you experience any problems with Vortex Café installation or usage then you can contact ADLINK support. Please provide a full description of your platform, including the versions of tools you are using (such as JDK, Ant, Maven, Android SDK, etc... ).

# 6

# Contacts & Notices

# Contacts

# ADLINK Technology Corporation

400 TradeCenter

Suite 5900

Woburn, MA

01801

USA

Tel: +1 781 569 5819

# ADLINK Technology Limited

The Edge

5th Avenue

Team Valley

Gateshead

NE11 0XA

UK

Tel: +44 (0)191 497 9900

# ADLINK Technology SARL

28 rue Jean Rostand

91400 Orsay

France

Tel: +33 (1) 69 015354

Web: http://ist.adlinktech.com

E-mail: ist\_info@adlinktech.com

# Notices

Copyright © 2018 ADLINK Technology Limited. All rights reserved.

This document may be reproduced in whole but not in part. The information contained in this document is subject to change without notice and is made available in good faith without liability on the part of ADLINK Technology Limited or ADLINK Technology Corporation. All trademarks acknowledged.
[🔗 Link to the original document](.vortex-cafe-installation-guide/vortex-cafe-installation-guide.pdf)
