Java installatie

Ancestris heeft Java nodig en is compatible met Java 8 (ook genoemd 1.8) en Java 11. We bevelen aan dat je Java 8 gebruikt.

Als Ancestris niet wil starten, of je ziet het Ancestris fout scherm en het stopt, meestal is dit een probleem met de Java installatie. Of Java is niet geïnstalleerd, of Ancestris kan kan Java niet vinden, of het vindt een niet compatible versie, of het vindt een beschadigde Java versie.

Het volgende gedeelte biedt een stap-voor-stap controle om zeker te zijn dat Ancestris een geldige versie 8 van Java gebruikt.

Algemene principes

• Je hebt een Java Runtime Enviiremont (JRE) nodig. De JDK (Java Development Kit) is niet vereist, maar omdat de JDK tegenwoordig ook een JRE bevat is alleen een JDK voldoende.
• Ancestris werkt met Java versies 8 en hoger. Het is ontwikkeld in versie 8 of hoger voor een betere samenwerking met de meeste gebruikers. Het is ook getest en het werkt ook met met Java 11 en Java 14, dat zijn LTS (Long Term Support) versies. We controleren niet de Short Term versies, die eindig zijn en niet meer gedownload kunnen worden na 18 maanden.
• Je kan een JRE ook van een andere leverancier gebruiken: Oracle, OpenJdk of AdoptOpenJdk of één die je zelf hebt samengesteld.
• De Oracle JRE installatie wordt door alle systemen en programma's herkend.
  • Alleen de Oracle versie wordt direct herkend door de programma's en heeft geen extra installatie of configuratie nodig. 
  • Als je de Oracle versie installeert, heeft alleen JRE 8 geen Oracle  registratie nodig.
  • Op Windows, dan is er niet alleen een JAVA_HOME variabele of de PATH variabele, maar er is ook een registratie sleutel nodig.
• Als je opteert voor een gratis installatie, zal je Ancestris moeten vertellen waar deze installatie staat. In dat geval, zoals hieronder beschreven, wis de jdkhome regel in het ancestis.conf configuratie bestand dat staat in de "etc" map van je Ancestris installatie en zet je hier het juiste pad neer.

Uitzoeken welke Java versie standaard wordt gebruikt

Als je niet weet of Java of welke versie is geinstalleerd, ga dan naar de  official detailed explanation page of open een commando terminal en type op de commando regel:

java -version

Er zijn verschillende methoden voor MacOS en Windows.
   - voor MacOS systemen, controleer de stap-voor-stap instructies.
   - voor Windows systemen, controleer de stap-voor-stap instructies.

• Als je een foutboodschap krijgt te zien in het commando scherm dan is Java niet op je systeem geïnstalleerd. Ancestris start dan niet. Volg de onderstaande installeer handleiding  om Java 1.8 alsnog te installeren en Ancestris te starten.
• Als je iets ziet wat op onderstaand lijkt waar Java 1.8 is geïnstalleerd. betekent dat er een juiste versie is geïnstalleerd en als standaard wordt gebruikt.

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)

Zoals je in het bovenstaande scherm kan zien is dat standaard Java 1.8, aka versie 8 is geïnstalleerd. 

Als Ancestris niet wil starten dan, of Ancestris kan Java niet vinden, of vindt een niet bruikbare versie, of vindt een beschadigde versie. Volg dan de instructies om te bepalen welke versie van Java Ancestris heeft gevonden.

• Als je een andere versie van Java vindt dan 1,8 of 11 betekent dat dat je standaard een andere versie gebruikt.

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)

Volgens bovenstaand scherm zie je dat de geïnstalleerde Java standaard versie 10 is. Ancestris zal niet starten. Ga naar de onderstaande installatie handleiding om Java 8 te installeren.

Wanneer je dit gedaan hebt zal je verschillende versies van Java op je systeem geïnstalleerd hebben.

Als je tevreden bent om Java versie 8 als standaard versie te gebruiken, volg de volgende instructies om java 8 als standaard op jouw systeem te installeren en en Ancestris te starten.

Als je echter de Java versie die je hebt te gebruiken, dan moet je Ancestris vertellen om niet de standaard versie Java te gebruiken. Volg dan de instructies om Ancestris een andere specifieke Java versie te gebruiken en dan Ancestris te starten.

Uitzoeken welke Java versie Ancestris vindt.

Als je wil weten welke versie Ancestris vindt moet je het configuratie bestand raadplegen.(configuration file).

1. Controleer de regel default_options

De regel ziet er als volgt uit::

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

Als een van de opties in de regel  --jdkhome="/path/to/java, bevat, wees er dan zeker van dat het pad in deze optie het pad is naar Java versie 1.8 is. Zo niet dan moet je het configuratie bestand aanpassen. Daarna start je Ancestris.

Als deze regel geen pad naar java heeft volg dan onderstaande instructies.

2. Controleer de regel die  jdkhome definieert.

Als de de regel er uit ziet zoals jdkhome="/path/to/java", wees er dan zeker van dat het pad in deze optie het pad is naar Java versie 8. Zo niet wijzig het configuratie bestand. Start Ancestris.

Als de regel start met "#", of de regel bestaat niet, betekent dat dat de regel niet gebruikt wordt door Ancestris en dat Ancestris de standaard Java versie op jouw systeem gebruikt.

Als de standaard versie hierboven Java 8 is, betekent dat misschien dat de de geïnstalleerde versie Java 8 beschadigd is. Probeer dan dan Java opnieuw te installeren m.b.v. de installatie instructies en herstart dan Ancestris.

Installeer Java

Om Java versie 8 op je systeem te installeren kan je dit direct van de Oracle hoofdpagina downloaden of anders gezegd, direct van de download pagina.

• Als je wil weten of jouw systeem Java kan starten ga dan naar de configuratie pagina waarin staat wat de minimale configuratie is die nodig is om Java te kunnen gebruiken.
• IfAls youje wantvan toalle choosebeschikbare fromversies all the available Oraclevan Java versionswil wil kiezen ga dan naar de de beschikbare versies, check this available versions page.pagina.
  • Java Version 8 iswordt recommendedaanbevolen, asomdat ithet supportsalle allfuncties van Ancestris features.ondersteund. 
    • ForVoor fullalle details onhoe how to install versionversie 8 te installeren
      • ForVoor MacOS, see zie JRE 8 InstallationInstallatie forvoor MacOS.
      • ForVoor Windows, see zie JRE InstallationInstallatie forvoor Windows.
      • ForVoor Linux, see zie JRE InstallationInstallatie forvoor Linux.

• • Java Version 11 supportondersteund mostde meeste Ancestris features.functies. 
    • Download anden installinstalleer Java Development Kit (JDK) Version 11
      • For MacOS, choosekies thehet .dmg file.bestand.
    • ForVoor fullalle details onhoe how to install versionversie 11 te installeren
      • ForVoor MacOS, seezie JRE Installation8 ofInstallatie the JDK forvoor MacOS.
      • ForVoor windows,Windows, seezie JRE InstallationInstallatie of the JDK forvoor Windows.
      • ForVoor Linux, seezie JRE InstallationInstallatie of the JDK onvoor Linux.

java -version
echo $jdkhome

/usr/libexec/java_home -V

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

exit

java -version
echo $jdkhome

@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

@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

sudo update-alternatives --config java

sudo update-alternatives -l

jdkhome="/path/to/java"