Install RisQFLan - RisQFLan/RisQFLan GitHub Wiki

RisQFLan is a multi-platform applicatioƒn that runs on Linux and Mac machines.

Installation

RisQFLan 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

Download RisQFLan

Download and decompress the correct version of RisQFLan:

First run

  • Fully decompress the downloaded archive (e.g., Mac users should extract the app within the .dmg file in some appropriate folder)
  • Run the executable contained in the extracted folder
  • RisQFLan will propose 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 selecting one which does not require any privileges to be accessed.
  • At first run users will be required to perform a simple extra installation step
    • Download the required jar file by clicking on multivestaRisQFLan.jar (the file is available here)
    • Tell RisQFLan where to find the downloaded jar file by locating it via the "Browse" button

Troubleshooting

In case of problems at startup due to missing/wrong JVM

If you have multiple versions of Java installed in your machine, you might experience startup problems. In this case, you should tell RisQFLan 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 RisQFLan.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

  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.

Mac OSX specific issues

Upon downloading RisQFLan you might get error

RisQFLan 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/RisQFLan.app

  • You might have to replace RisQFLan's full path if different
  • This is explained in this youtube video.
⚠️ **GitHub.com Fallback** ⚠️