Instal·lació de Java (TSL)

Ancestris necessita Java i és compatible amb Java 8 (també anomenat 1,8) i Java 11. Us recomanem que utilitzeu Java 8.

Si Ancestris no s'inicia o mostra la pantalla defectuosa i s'atura, generalment es relaciona amb un problema amb la instal·lació Java. O bé Java no està instal·lat o Ancestris no el troba o troba una versió incompatible o troba una versió danyada.

Les següents seccions ofereixen una comprovació pas a pas per assegurar que Ancestris està utilitzant una versió vàlida de Java 8.

 

Identifica quina versió de Java està establerta per defecte

Si no sabeu si hi ha instal·lada Java o quina versió està instal·lada, visiteu la pàgina detallada d'explicació oficial o obriu directament un terminal de línia d’ordres i escriviu a la línia d’ordres:

java -version

Hi ha mètodes alternatius per a MacOS i Windows.
   - per MacOS, consulteu les instruccions pas-a-pas.
   - per Windows, consulteu les instruccions pas-a-pas.

 

• Si veieu un missatge d'error al terminal, Java no està instal·lat al sistema. Ancestris no podrà funcionar.
  Si us plau, seguiu la secció d'instal·lació de sota per instal lar Java 1,8 i després iniciar Ancestris

• Si veieu una cosa així on es mostra Java 1.8, vol dir que teniu la versió adequada instal·lada i configurada de manera predeterminada.

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)

Segons la visualització anterior, podem veure que la versió de Java instal·lada per defecte és la versió 1.8, àlies versió 8.

Si Ancestris no s'inicia, Ancestris no la troba, troba una versió incompatible o troba una versió danyada. Si us plau, seguiu les instruccions per identificar la versió de Java que troba Ancestris.

•  Si veieu una versió Java diferent d’1.8 o 11, vol dir que teniu una altra versió Java de manera predeterminada.

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)

Segons la pantalla de dalt, podem veure que la versió de Java instal·lada establerta per defecte és la versió 10. Ancestris no s'executarà. Si us plau, seguiu la secció d'instal·lació de sota per instal·lar Java 8.

Un cop fet això, tindràs diverses versions Java instal·lades en el sistema.

Si us convé definir Java 8 com a versió predeterminada, seguiu les instruccions per configurar la versió predeterminada de Java en el vostre sistema i, a continuació, inicieu Ancestris.

Si preferiu mantenir el conjunt de la versió de Java tal com és, haureu de dir-li a Ancestris que no usi la versió de Java per defecte. Si us plau seguiu les instruccions per obligar Ancestris a utilizar una versió Java específica i llavors iniciar Ancestris.

Identifiqueu quina versió de Java troba Ancestris

Per saber quina és la versió de Java que troba Ancestris, caldrà que comproveu el fitxer de configuració d'Ancestris.

1. Comproveu la definició de la línia default_options

Aquesta línia hauria de ser així:

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

Si una de les opcions d'aquesta línia inclou --jdkhome="/path/to/java, assegureu-vos que la ruta especificada en aquesta opció sigui la ruta a la versió 1.8 de Java.. En cas contrari, editeu el fitxer de configuració i canvieu-lo. A continuació, inicieu Ancestris.      .

Si aquesta línia no inclou cap ruta Java, seguiu les instruccions que es mostren a continuació.

2. Comproveu la definició de la línia jdkhome

Si la línia sembla jdkhome="/path/to/java", assegureu-vos que la ruta especificada en aquesta opció és la ruta a la versió Java 8. En cas contrari, editeu el fitxer de configuració i canvieu-lo. A continuació, iniciar Ancestris.   .

Si la línia comença amb "# ", o si la línia no existeix, llavors significa que la línia no és utilitzada per Ancestris i que Ancestris utilitza la versió per defecte del Java establerta al vostre sistema.

Si la versió per defecte marcada anteriorment era Java 8, vol dir que la vostra versió instal·lada de Java 8 podria estar malmesa. Intenti reinstal·lar-lo utilitzant les instruccions d'instal·lació i reprengui Ancestris.

 

---

Instal·lar Java

Per instal·lar la versió Java 8 en el vostre sistema, podeu obtenir-la des de la pàgina principal d'Oracle, o de manera més precisa, directament des de la pàgina de descàrrega.

• Si necessiteu saber si el vostre dispositiu pot executar Java, aneu a aquesta pàgina de configuració per conèixer la configuració mínima necessària.

 

• Si voleu triar entre totes les versions disponibles d'Oracle Java, consulteu aquesta pàgina de versions disponibles.
  • Es recomana Java versió 8  ja que suporta totes les característiques Ancestris.
    
    • Per a més detalls sobre com instal·lar la versió 8
      
      • Per MacOS, veure JRE 8 Instal·lació per MacOS.
      • Per Windows, veure JRE Instal·lació per Windows.
      • Per Linux, veure JRE Instal·lació per Linux.

• • Java versió 11 suporta la majoria de característiques Ancestris.
    
    • Descarregar i instal·lar Java Development Kit (JDK) Versió 11
      • Per MacOS, escollir el fitxer .dmg.
    • Per a més detalls sobre com instal·lar la versió 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"