Chapter 6. Troubleshooting and maintenance

6.1. Installing Fanurio

6.1.1. Requirements

Fanurio runs on Windows (Windows 7 or later), Mac OS X (10.8 or later), Linux (including Debian-based distributions like Ubuntu) and other flavors of Unix.

Fanurio requires Java 8 to run on Linux and other flavors of Unix but we recommend Java 11. If your system doesn't have Java 11, you can get it for free from AdoptOpenJDK or Azul. The Windows and macOS versions are already bundled with Java so you don't have to install it.

How to install AdoptOpenJDK version 11 on Linux

#Download the tar.gz file for Linux.
#Depending on which version you download, the file may have a different name.
wget https://github.com/AdoptOpenJDK/openjdk11-binaries/releases/download/jdk-11.0.11%2B9/OpenJDK11U-jdk_x64_linux_hotspot_11.0.11_9.tar.gz

#Untar and copy it to /usr/lib/jvm/ where Java is installed.
sudo tar -zxvf OpenJDK11U-jdk_x64_linux_hotspot_11.0.11_9.tar.gz -C /usr/lib/jvm/

#Add the new Java installation to the Java alternative list.
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-11.0.11+9/bin/java 1

#Make the new Java installation the default one. Choose the option that points to the new Java installation.
sudo update-alternatives --config java

#Test it.
java -version

How to install Azul's Zulu OpenJDK version 11 on Linux

#Download the tar.gz file for Linux.
#Depending on which version you download, the file may have a different name.
wget https://cdn.azul.com/zulu/bin/zulu11.48.21-ca-jdk11.0.11-linux_x64.tar.gz

#Untar and copy it to /usr/lib/jvm/ where Java is installed.
sudo tar -zxvf zulu11.48.21-ca-jdk11.0.11-linux_x64.tar.gz -C /usr/lib/jvm/

#Add the new Java installation to the Java alternative list.
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/zulu11.48.21-ca-jdk11.0.11-linux_x64/bin/java 1

#Make the new Java installation the default one. Choose the option that points to the new Java installation.
sudo update-alternatives --config java

#Test it.
java -version

6.1.2. Registering a license key

Here's what you need to do to register a license key:

  1. Save the license file you received by email (license.dat) on your Desktop.

    IMPORTANT: Don't try to open the license file as there is nothing meaningful there. Just save it on your computer. Fanurio knows how to read its contents.

  2. Make sure Fanurio is running. If it isn't, start it.

  3. If it asks you for a valid license file, click the Enter License button at the bottom. If it doesn't, go to Help » Enter License... to enter it. Once you click Enter License..., Fanurio will display the License Registration dialog.

  4. Click the Browse button to locate the license file on your Desktop.

  5. Enter the email address where you received the license file in the Email field.

  6. Click OK to register the license key.

6.1.3. The cross-platform version

The cross-platform version requires Java 8 available from AdoptOpenJDK.

To install and run Fanurio from a USB stick, please follow these instructions:

  1. Get the cross-platform version (.tar.gz)

  2. Install it on the USB stick by unzipping it

  3. Start Fanurio from the stick by running:

    • fanuriolocal.applescript on Mac OS X

    • fanuriolocal.exe on Windows

    • fanuriolocal.sh on Linux and other flavors of Unix

Note: It's important to start Fanurio using the local scripts. The other scripts (without local in their name) will start Fanurio but will not keep the data on the stick.

6.1.4. Uninstalling Fanurio

Please follow these steps to uninstall Fanurio from your computer. If you've had problems using it, we would appreciate it if you could tell us more about it.

  • Mac OS X

    In the Finder sidebar, click Applications. Drag the app from the Applications folder to the Trash (located at the end of the Dock), then choose Finder > Empty Trash.

    If you change your mind, before emptying the Trash, select the app in the Trash, then choose File > Put Back.

    Learn more

  • Linux

    If you're using Ubuntu, open Ubuntu Software Center and search for fanurio. Then click the Remove button.

    On other Debian-based distributions, open a Terminal window and run the following command:

    sudo apt-get remove fanurio

    Learn more

  • Windows 10

    1. Open the Start menu.

    2. Click Settings.

    3. Click System on the Settings menu.

    4. Select Apps & features from the left pane.

    5. Select an app you wish to uninstall.

    6. Click the Uninstall button that appears. If it is grayed out, this is a system app you cannot remove.

    7. Click the Uninstall pop-up button to confirm.

    Learn more

  • Windows 8.1

    1. Point to the upper-right corner of the screen, move the mouse pointer down, and then click Search.

    2. Enter control panel in the search box, and then click Control Panel.

    3. Under View by:, select Large Icons, and then click Programs and features.

    4. Click the program, and then click Uninstall.

    5. Follow the instructions on the screen.

    Learn more

  • Windows 7

    1. Open Programs and Features by clicking the Start button, clicking Control Panel, clicking Programs, and then clicking Programs and Features.

    2. Select a program, and then click Uninstall.

    Learn more

  • Cross-platform

    Delete the fanurio folder. Please make sure you backup all data from the local subfolder first.