QFLan does not require any installation process, apart for a working installation of Java 11, the latest LTS version,

The tool supports both Oracle JDK and OpenJDK. It has been tested on:

• Oracle JDK:
  • Mac Os Big Sur, Mac Os Catalina (previous versions of the tool)
  • Windows 10 Pro
  • Install it: Download Java 11 here
• OpenJDK: Ubuntu 20.10
  • Install it: The correct version of Java can be installed on ubuntu running in a terminal:
    • sudo apt install openjdk-11-jre-headless

Please, download and uncompress the correct version of QFLan:

• QFLan for MAC OSX machines
• QFLan for Windows machines
• QFLan for Ubuntu machines

1. Fully decompress the downloaded archive (e.g., Mac users should extract the QFLan app within the .dmg file in some appropriate folder)

2. Run the executable contained in the extracted folder.

3. QFLan will suggest a default workspace (i.e., a folder where all the created files will be stored). We suggest to do not use the default suggested folder, but rather to select one which does not require any privileges to be accessed.

4. At first run users will be required to perform a simple extra installation step, as shown in the following screenshot:

   • Download the required jar file by clicking on multivestaQFLan.jar (the file can be found here)
   • Tell QFLan where to find the downloaded jar file by locating it via the "Browse" button

If you have multiple versions of Java installed in your machine, you might experience startup problems. In this case, you should tell QFLan which version to use. These are two examples using Ubuntu or Mac OSx machines.

• NOTE: These are example paths, you might have a slightly different path in your machine

Open QFLan.ini and add:
if using Ubuntu
-vm
/usr/lib/jvm/java-11-openjdk-amd64/bin/java

if using Mac OSx
-vm
/Library/Java/JavaVirtualMachines/jdk-11.0.14.jdk/Contents/Home/bin/java

if using Windows, identify and use the path to the java 11 installation

1. This should be given in two lines, without preceding spaces. If you write '-vm path' in the same line, or if you have spaces before -vm, the option might be ignored
2. The above path is given for a given ubuntu installation. Check if it is correct for your machine.

Upon downloading QFLan you might get error

QFLan is damaged and can't be opened

This is an issue of Mac OS. You can easily solve it by executing the following in a terminal: xattr -cr /Applications/QFLan.app

• You might have to replace QFLan's full path if different
• This is explained in this youtube video.