Installation on Linux

There are 2 options for installing Ancestor Tree Manager:

  • with an installation script (recommended)
  • with a jar file
The script will search for the best Java version available in /usr/lib/jvm.

Installation

  1. Make sure the correct Java version (see Download page) is installed in /usr/lib/jvm
  2. If ATM is already installed the program must be closed before installing a new version
  3. Open a Terminal
  4. Go to the folder where the installation file is downloaded by entering the following command:
    cd ~/Downloads (if the file is downloaded in the default download folder)
    or:
    cd /xxx/yyy (replace /xxx/yyy by the actual path to the download folder)
    and press Enter
  5. Start the installer (this must be done as super user) with the command:
    sudo sh AncestorTreeManager-<version>.sh
    or:
    sudo java -jar AncestorTreeManager-<version>.jar
    and press Enter
  6. Enter the password and press Enter
  7. Install ATM preferably in /usr/local/AncestorTreeManager

If you have a High DPI screen, the installer will appear unreadably small on the screen. You can solve this by starting the installer differently:
sudo GDK_SCALE=2 sh AncestorTreeManager-<version>.sh
or:
sudo GDK_SCALE=2 java -jar AncestorTreeManager-<version>.jar

When the installer is started in this special way, a provision is made to ensure AncestorTreeManager behaves correctly too.

It is possible to manually switch between a normal screen and a High DPI screen. A file called Normal-DPI is included by default in the folder /usr/local/AncestorTreeManager/options. If the file name is changed to High-DPI this indicates that AncestorTreeManager is running on a High DPI screen. After changing the file name, AncestorTreeManager must be restarted.

Starting the program

Via the desktop shortcut:

Uninstallation

From version 9.2 an Uninstaller is available, located in the program folder.

  1. Open a Terminal
  2. Start the Uninstaller (this must be done as super user) with the command:
    sudo sh /usr/local/AncestorTreeManager/Uninstaller.sh
    and press Enter
  3. Enter the password and press Enter