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.

macOS-01.png

Het betreft hier de volgende stappen:

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...

macOS-02.png

 
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 "stap 11".

macOS-03.png

 
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  "Vereiste configuratie").

macOS-04.png

 
4. Ga naar het "MacOS installatie programma" en dubbelklik op het ".dmg' bestand.
macOS-05.png

 

5. Klik op de groene "download" knop.
macOS-06.png

 

6. Het downloaden start... Wacht.
macOS-07.png

 

7. De download is gereed. Open de Download map om het bestand te controleren.
macOS-08.png

 

8. Dubbel klik op het JDK pakketje.

macOS-09.png

 

9. De JDK installatie start. Volg de stappen.

macOS-10.png

 

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

macOS-11.png

 

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.   

macOS-12.png

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

macOS-13.png

 

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

macOS-14.png

 

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

macOS-15.png

 

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.

macOS-16.png

 

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

macOS-17.png

 

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

macOS-18.png

 

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

macOS-19.png

 

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

macOS-20.png

 

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

macOS-21.png

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

macOS-22.png

 

22. Klik op "Open Ancestris" of ga terug naar je Genealogie map en dubbelklik op het icoon om Ancestris te starten.

macOS-23.png

 

 

Goedkeuring van de veiligheid controle check

23. Ancestris start, maar MacOS vertelt je dat Ancestris van een ongeautoriseerde ontwikkelaar komt. Dit is geen probleem. Ancestris is een "Open Source' programma en heeft geen malware. Laten we het gebruik dus maar autoriseren.

macOS-24.png

 

24. Om dit te doen, ga je naar "System Preferences" van je Mac.

macOS-25.png

 

25. Klik op "Security & Privacy".

macOS-26.png

 

26. Klik op "Open anyway".

macOS-27.png

 

27. Als je dit voor de eerste keer doet, bevestig je het met het invoeren van je wachtwoord.

macOS-28.png

 

28. Ja, je weet het zeker. Klik op "Open".

macOS-29.png

 

29. Tenslotte, Ancestris is gestart.

macOS-30.png

30. Je ziet nu het welkomst scherm.

macOS-31.png

 

31. Merk op, dat je vanuit het programma, je toegang kan krijgen tot het "Voorkeuren"- en het "Over Ancestris" paneel.

 

macOS-32.png

 

Laat Ancestris in het "Dock" staan

32. Laat de applicatie in het Dock staan door op de Ancestris icoon in het "Dock" te aan te wijzen. Er verschijnt nu een submenu.

macOS-33.png

 

33. Kies "Option" en "Keep in Dock".

macOS-34.png

 

34. Dat is alles. Ancestris staat in het "Dock" en werkt. Yessss !

macOS-30.png

 

 


 

Extra informatie voor gebruikers van  MacOS Big Sur

Er zijn extra stappen nodig voor MacOS Big Sur gebruikers, als Ancestris na bovenstaande installatie niet start.:

  • Voor beveiligings redenen, is het misschien nodig om de Gedcom bestanden in een andere map dan de "Documents" map op te slaan.
  • Het is misschien noodzakelijk om het pad naar het Java programma in het configuratie bestand van Ancestris op te slaan.

Volg deze extra stappen om het pad naar de Java versie aan te geven in het Ancestris configuratie bestand.

Basis principes.
  • Het configuratie bestand bevindt zich hier : ${HOME}/Library/Application Support/ancestris/trunk/etc/ancestris.conf
  • De Java lokatie wordt met het volgende Terminal commando opgevraagd: /usr/libexec/java_home -V

Dit zijn de te volgren stappen:.

1. Open een terminal scherm, en controle en kopieer de lokatie van de geïnstalleerde Java versie,  
  • Typ /usr/libexec/java_home -V op de commando regel van de Terminal en druk op Enter (return).
  • Je ziet nu het pad van de geïnstalleerde Java versie.
  • Selecteer de regel waar het pad op staat, en klik op de muis om het te kopiëren. Deze regel kan in jouw geval anders zijn.
    • Hier staat Java:  /Library/Java/JavaVirtualMachines/jdk-15.0.1.jdk/Contents/Home

en-force-java-path-01.png

2. Open het Ancestris configuratie bestand met de editor.
  • Typ het volgende commando dat start met "nano ${HOME}..."

en-force-java-path-02.png

3. De nano editor opent en geeft de inhoud van het Ancestris configuratie bestand weer.

en-force-java-path-03.png

4. Voeg toe - of wijzig - the regel met jdkhome="" en plak het Java pad tussen de dubbele aanhalingstekens.
  • Voeg de regel toe als deze nog niet bestaat.
  • Of update deze. Wees er zeker van dat er geen "pond" teken  "#" aan het begin van de regel staat. Je wijzigingen worden dan niet doorgevoerd. (# staat voor "commentaar" en is voor de computer dus geen opdracht c.q. commando,

en-force-java-path-04.png

5. Stop en sla je wijzigingen op.

en-force-java-path-05.png

6. Controleer of het Ancestris configuratie bestand je wijzigingen heeft opgeslagen, en start Ancestris.
  • Typ het commando's wat start met "cat ${home}/..." en daarna alle volgende onderstaande commando's.
  • Het terminal scherm laat nu de inhoud van het configuratie bestand zien inclusief de regel die je hebt toegevoegd (gewijzigd).

en-force-java-path-06.png

Het configuratie bestand is nu bijgewerkt. Je kan nu Ancestris starten en Ancestris moet Java nu vinden.

Ancestris, genealogie die met je meeleeft!

Vertaling, Ed van Driel, voorjaar 2021.