Linux Installation Instructions

Brief Instructions

After downloading BioTuple, use Terminal to run the BIN and install BioTuple. Then open the installed BioTuple directory and run the BioTuple shell script. If you encounter any issues, please consult the Troubleshooting Common Installation Issues section.

Installer (step 1)

    Detailed Instructions – For those inexperienced with Linux

  1. Download BioTuple for Linux from the following link if you haven’t already done so. BioTuple is supported on any Linux distribution with the official Oracle Java installed. We recommend and test Linux Mint. We also test on OpenSUSE, Debian and Fedora Linux. BioTuple does NOT support OpenJDK, IcedTea, GNU Java, or any other non-Oracle version of Java. With unsupported Java distributions, BioTuple will run slowly, have broken functions and may not even run at all.

    Download BioTuple v for Linux
  2. BioTuple-linux-.bin, a Linux bin, will be downloaded to your computer. You may check the MD5 checksum with the following number to verify your download.

    MD5 checksum:

  3. Open Terminal and change the directory (using the cd command) to the directory you downloaded BioTuple to. Browsers will usually download files to the ~/Downloads folder if you didn’t explicitly set the download path. You can check the contents of a folder using the ls command.
    Installer BIN
  4. After locating the BIN, use the following command to run it. BioTuple will be installed in your present working directory; you can move the BIN to a different location to change where BioTuple will be installed. Or feel free to move the installation folder after the installation completes.

    sh ./BioTuple-linux-.bin

    Installer (step 1)
  5. If you are satisfied with the installation location and are reminded about using the official Oracle Java distribution, press the return key to install BioTuple.
    Installer (step 2)
  6. Now open the newly installed BioTuple folder to see what was installed. The install automatically registers the BioTuple application with GNOME environments, so you should see BioTuple entries in the Linux application menus.
    To place a Launcher for BioTuple in your system tray, just drag the BioTuple application menu item from the Linux application menu onto the system tray. Double-click on the BioTuple shell script or click on the shortcut in the system tray to run BioTuple. Do NOT use the Java JAR, BioTuple.jar, to run BioTuple.
    Drag to the system tray
  7. The first time you open BioTuple, you will be greeted with our software license. Please read and understand it, and then choose to accept it. If BioTuple does not start or you see an error, please consult the Troubleshooting Common Installation Issues section.
    BioTuple Software License
  8. Type or copy and paste the activation code we provided to you when you purchased BioTuple, and then click the Verify button.
    Activation Window
  9. BioTuple will build and a confirmation screen and user’s guide will follow. Congratulations, BioTuple is now activated and ready to use at any time!
  10. Uninstallation Instructions

    1. To uninstall BioTuple, simply drag the entire BioTuple folder to the Trash.


    Troubleshooting Common Installation Issues

    If BioTuple does not start or you see an error popup, then open terminal, change the present working directory to the BioTuple installation folder, and run the shell script using the following command to catch any diagnostic errors. Then check for solutions below. If you encounter an error not addressed below, please copy and paste all text from Terminal and send it to us.

    ./BioTuple

    1. Java is not installed. If you see a message similar to the one in the following image, then BioTuple cannot find Java. Either make sure your classpath is correct and contains Java or go to www.java.com to quickly and easily install Java for free.
      Java not Found
    2. A non-official Java distribution is being used. If you see a popup message similar to the one in the following image, then BioTuple is running with a non-official version of Java. BioTuple does NOT support OpenJDK, IcedTea, GNU Java, or any other non-Oracle version of Java. With unsupported Java distributions, BioTuple will run slowly, have broken functions and may not even run at all. Either make sure your classpath is correct and contains the official Oracle Java distribution or go to www.java.com to quickly and easily install the official Oracle Java for free.
      Unsupported Java Distribution