Stap-voor-stap installatie op MacOS

Deze pagina is een gedetailleerde stap-voor-stap beschrijving voor installatie van Ancestris op een MacOS systeem.

We laten hier een schermvoorbeeld zien van 21 januari 2021 van de installatie van Ancestris versie 11 op Mac OS Catalina.

Het betreft hier de volgende stappen:

• Het nog niet geïnstalleerde Java alsnog te installeren op Mac OS Catalina.
• Het downloaden van Ancestris versie 11 vanaf de veilige Ancestris web site.
• De toestemming geven aan  de MacOS veiligheidscontrole om Ancestris te starten, ondanks dat Ancestris afkomstig is van een onbekende ontwikkelaar.
• Het starten van Ancestris.
• Aanmaken van een Ancherstris item in the Dock.

Merk op, dat deze schermafbeeldingen er verschillend uit kunnen zien ten opzichte van de huidige Ancestris en/of de  -software schermafdrukken.

Een speciale opmerking voor de  gebruikers van MacOS Big Sur: "Volg nauwkeurig het onderstaand stappen en lees goed de speciale sectie onderaan de tekst".

Installatie van Java

1. Vanaf het Mac OS bureaublad...

 

2. Open een terminal scherm en type "java -version".

Als Java niet geïnstalleerd is, zal een nieuw scherm verschijnen, waarin gevraagd wordt Java alsnog te installeren. Klik "More info...".

Als Java geīnstalleerd is, kan je direct doorgaan naar "screen 11".

 

3. Je bent nu op de Java web site. Klik op "JDK Download"

We kunnen op de website zien dat versie 15 voorgesteld wordt om te installeren. Laten we toch deze versie installeren, alhoewel we versie 8 of 11 aanbevelen om te gebruiken, omdat dit al langere tijd stabiele versies zijn. (zie  "required configuration").

 

4. Ga naar het "MacOS installatie programma" en dubbelklik op het ".dmg' bestand.

 

5. Klik op de groene "download" knop.

 

6. Het downloaden start... Wacht.

 

7. De download is gereed. Open de Download map om het bestand te controleren.

 

8. Dubbel klik op het JDK pakketje.

 

9. De JDK installatie start. Volg de stappen.

 

10. De installatie moet nu geslaagd zijn. Sluit het scherm.

 

11. Type opnieuw "java -version" in het terminal scherm.

De volgende mededeling zal verschijnen, dat aangeeft dat Java versie 15 in ons voorbeeld is geïnstalleerd.   

Je bent nu klaar met de Java installatie. We gaan nu Ancestris installeren.

 

Installatie van Ancestris

12. Ga naar de https://www.ancestris.org web site

 

13. In het menu, klik op DOWNLOAD. Je komt nu op de download sectie.

 

14. Klik op de Ancestris 11 knop van het MacOS paneel.

 

15. Als dit de eerste keer is dat je Ancestris installeert, dan geeft je nu de download van Ancestris toestemming om vanaf de website Anchestris te dowloaden.

 

16. De downloading start. Het neemt een slechts een paar minuten in beslag.

 

17. Wacht nog even langer ....  we zeiden een paar minuutjes !

 

18. Als de download klaar is zet het bestand in je genealogie map.

 

19. Het is beter om  het Ancestris programma in een andere map dan je genealogie data te zetten.

 

20. Om zeker te weten dat je de goede versie hebt, klik op "Quick Look Ancestris" van het context menu.

 

21. Het programma scherm laat je nu het versienummer en de datum zien.

 

22. Click 'Open ancestris' or go back top your Genealogy folder and click on the icon to launch Ancestris.

 

 

Confirmation of the security check

23. Ancestris starts but MacOS tells you it comes from an unverified developer. Not a problem. Ancestris is open source and does not have any malware. Let's authorize it.

 

24. For that, go to the System Preferences

 

25. Click on "Security & Privacy"

 

26. Click on "Open anyway"

 

27. If it is the first time you do this, confirm with your password.

 

28. Yes, you are sure. Click "Open".

 

29. Finally, Ancestris starts.

 

30. You can see the Welcome window.

 

31. Please note that from the application Menu, you can access the Preferences and the "About Ancestris" panel.

 

Keep in dock

32. Let's keep the application in the Dock by clicking on the Ancestris icon in the dock panel.

 

33. Choose "Option" and "Keep in Dock".

 

34. This is it. Ancestris is installed and in the Dock. Yessss !

 

 

---

 

Special note for users of MacOS Big Sur

There are additional steps for MacOS Bug Sur users, in case Ancestris does not start after the installation above:

• For security reasons, it might be necessary to store Gedcom files in another folder than the 'Documents' folder
• It might be necessary to specify the path to the java version in the ancestris configuration file

Please follow these additional steps to specify the path to the java version in the ancestris configuration file:

Basic principles:

• The configuration file is here : ${HOME}/Library/Application Support/ancestris/trunk/etc/ancestris.conf
• Java's location is given by the following line command : /usr/libexec/java_home -V

These are the steps.

1. Open a terminal, and check and copy the location of the installed java version

• Type /usr/libexec/java_home -V on ther command line and press Enter
• You shoud see the path of the installed java version.
• Select the line indicating the path, and click on the mouse to copy it in the clipboard. This line could be different in your case.
  • Here it is /Library/Java/JavaVirtualMachines/jdk-15.0.1.jdk/Contents/Home

2. Open the editor on the Ancestris configuration file

• Type the following command which starts with "nano ${HOME}..."

3. The nano editor opens and shows the content of the Ancestris configuration file

4. Add - or modify - the line that says jdkhome="" and paste the java path between the double quotes

• Add the line if it does not exist
• Or update it otherwise. Make sure in this case that there is no pond sign "#" at the beggining of the line, your change would not be taken into account.

5. Exit and save your change

6. Check that the Ancestris configuration file has your change, and start Ancestris.

• Type the command starting with "cat ${home}/..." below.
• The terminal displays the configuration file with the added line.

The configuration file is updated. You can start Ancestris and Ancestris should find java.