Instalação JAVA

O Ancestris precisa de Java e é compatível com Java 8 (também chamado de 1.8) e Java 11. Recomendamos que você use Java 8.

Se o Ancestris não iniciar, ou mostrar a tela inicial do Ancestris e parar, geralmente está relacionado a um problema com a instalação do Java. O Java não está instalado ou o Ancestris não o encontra, encontra uma versão incompatível ou encontra uma versão corrompida.

The following sections offer a step-by-step check to ensure Ancestris is using a valid Java 8 version.

 

Identifique qual versão do Java está configurada por padrão

Se você não souber se o Java está instalado ou qual versão está instalada, visite a página de explicação detalhada oficial ou abra diretamente um terminal de linha de comando e digite na linha de comando:

java -version

Existem métodos alternativos para MacOS e Windows.
- para sistemas MacOS, verifique as instruções passo a passo.
- para sistemas Windows, verifique as instruções passo a passo.

 

• Se você vir uma mensagem de erro no terminal, o Java não está instalado no seu sistema. Ancestris não pode ser executado. Siga a seção Instalar abaixo para instalar o Java 1.8 e, em seguida, inicie o Ancestris.

 

• Se você vir algo assim em que o Java 1.8 é exibido, significa que você tem a versão correta instalada e definida por padrão.

java version "1.8.0_251"
Java(TM) SE Runtime Environment (build 1.8.0_251-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)

De acordo com a exibição acima, podemos ver que a versão Java instalada definida por padrão é a versão 1.8, também conhecida como versão 8.

Se o Ancestris não iniciar, o Ancestris não o encontra, encontra uma versão incompatível ou encontra uma versão corrompida. Siga as instruções para identificar qual versão Java o Ancestris encontra.

 

• Se você vir uma versão Java diferente da 1.8 ou 11, significa que você tem outra versão Java por padrão.

java version "10.0.1" 2018-04-17
Java(TM) SE Runtime Environment 18.3 (build 10.0.1+10)
Java HotSpot(TM) 64-Bit Server VM 18.3 (build 10.0.1+10, mixed mode)

De acordo com a exibição acima, podemos ver que a versão Java instalada definida por padrão é a versão 10. O Ancestris não será executado. Siga a seção Instalar abaixo para instalar o Java 8.

Depois de concluído, você terá várias versões Java instaladas no seu sistema.

Se você deseja definir o Java 8 como a versão padrão, siga as instruções para definir a versão java padrão no seu sistema e inicie o Ancestris.

Se você preferir manter a versão Java definida, é necessário dizer ao Ancestris para não usar a versão Java padrão. Siga as instruções para forçar o Ancestris a usar uma versão java específica e, em seguida, inicie o Ancestris.

 

Identifique qual versão Java o Ancestris encontra

Para saber qual versão Java o Ancestris encontra, você precisará verificar o arquivo de configuração do Ancestris.

1. Verifique a linha que define default_options

Esta linha deve ficar assim:

default_options="--branding ancestris -J-Xms96m -J-Xmx1g --laf javax.swing.plaf.nimbus.NimbusLookAndFeel"

Se uma das opções nesta linha incluir --jdkhome="/path/to/java, verifique se o caminho especificado nesta opção é o caminho para o Java versão 1.8. Caso contrário, edite o arquivo de configuração e altere-o. Então inicie o Ancestris.

Se esta linha não incluir um caminho java, siga as instruções abaixo.

2. Verifique a linha que define jdkhome

Se a linha parecer jdkhome="/path/to/java", verifique se o caminho especificado nesta opção é o caminho para o Java versão 8. Caso contrário, edite o arquivo de configuração e altere-o. Então inicie o Ancestris.

Se a linha começar com "#" ou se a linha não existir, significa que a linha não é usada pelo Ancestris e que o Ancestris usa a versão Java padrão definida no seu sistema.

Se a versão padrão verificada acima for Java 8, significa que a versão instalada do Java 8 pode estar corrompida. Tente reinstalá-lo usando as instruções de instalação e reinicie o Ancestris.

 

---

Install Java

To install version Java 8 on your system, you can get it from the Oracle's main page, or more precisely, directly from the download page.

• If you need to know if your device can run Java, go to this configuration page to learn the minimum needed configuration.

 

• If you want to choose from all the available Oracle Java versions, check this available versions page.
  • Java Version 8 is recommended as it supports all Ancestris features.
    • For full details on how to install version 8
      • For MacOS, see JRE 8 Installation for MacOS.
      • For Windows, see JRE Installation for Windows.
      • For Linux, see JRE Installation for Linux.

• • Java Version 11 support most Ancestris features. 
    • Download and install Java Development Kit (JDK) Version 11
      • For MacOS, choose the .dmg file.
    • For full details on how to install version 11
      • For MacOS, see Installation of the JDK for MacOS.
      • For windows, see Installation of the JDK for Windows.
      • For Linux, see Installation of the JDK on Linux.

 

• If you prefer an Open Source Java version, it is possible to use OpenJDK and you can also install Java from the free AdoptopenJDK solution.

 

Set the default Java version

The procedures depend on your operative system.

• For MacOS
• For Windows
• For Linux

 

Set default version for MacOS

The version of Java running on your system may be incompatible with Ancestris, so it will not run. You will get a message like the following in a terminal when Ancestris starts.

If you want to keep your current Java version and, for instance, run Java Version 8 (aka 1.8) at the same time, you need to swap Java versions.

To swap between different Java versions, open a Terminal window and follow the steps below.

In the following example, the instructions let you set Version 8 (aka 1.8) by default, without removing Java Version 10:

1/6 - Check which version of Java is set by default

java -version
echo $jdkhome

We can see Version 10. Ancestris will not work. You need Version 8 (aka 1.8) for Ancestris.

2/6 - Get a list of all installed versions on your system and check Version 8 (aka 1.8) is among them

/usr/libexec/java_home -V

OK, we can see Version 8 (aka 1.8) is installed.
If it were not, then install it as explained in this section.

3/6 - Type in the following 2 lines in the Terminal

echo 'export JAVA_HOME=`/usr/libexec/java_home -v 1.8`' >>~/.bash_profile
echo 'export jdkhome==`/usr/libexec/java_home -v 1.8`' >>~/.bash_profile

These two lines will add the command to set your default Java version in your personal profile.

The first line defines the default Java version for all programs (JAVA_HOME, in uppercase).

The second line defines the default Java version to use for Ancestris (jdkhome, lowercase).

4/6 - Close the Terminal

exit

5/6 - Reopen a Terminal and check that the running Java is Version 8 (aka 1.8)

java -version
echo $jdkhome

OK, it is. We can see Version 8 (aka 1.8). You can now start Ancestris.

6/6 - Start Ancestris

When Ancestris starts, a Terminal window opens at the same time.

You can see in the title bar that Version 8 (aka 1.8) of Java is being used by Ancestris.

 

Set default version for Windows

You have to create a BAT file per Java version you wish to keep.

Use your favourite text editor to create those files, using the code below, and place them in a folder available from your PATH.

JAVA8.BAT

@echo off
echo Setting JAVA_HOME
set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_12
echo setting PATH
set PATH=C:\Program Files\Java\jdk1.8.0_12\bin;%PATH%
echo Display java version
java -version

JAVA11.BAT

@echo off
echo Setting JAVA_HOME
set JAVA_HOME=C:\Program Files\Java\jdk1.11.0_11
echo setting PATH
set PATH=C:\Program Files\Java\jdk1.11.0_11\bin;%PATH%
echo Display java version
java -version

While creating these files, make sure you specify the correct name for the Java files for the lines JAVA_HOME, depending on your Java installation

When you decide to change the Java version, just run the corresponding BAT file: JAVA8 for version 1.8, or JAVA11 for version 11. The Java version at use will be shown on the terminal.

To check if the change is really in effect, type java -version on a console or check this page.

If you wish to keep your latest Java version and force the use of another version of Java for Ancestris, you have to change the configuration file, line jdkhome="C:\path\to\java"

 

Set default version for Linux

Type the following on a console :

sudo update-alternatives --config java

 

Select from the list the version needed.

If you wish to keep your latest Java version and force the use of another version of Java for Ancestris, you have to change the configuration file, line jdkhome="/path/to/java"

To get help using this tool :

sudo update-alternatives -l

 

 

Force Ancestris to use a specific Java version

Whatever your operating system is, if the default active Java version is different from the one to be used with Ancestris, you have to modify Ancestris's configuration file like this:

jdkhome="/path/to/java"