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 je op "Quick Look Ancestris" van het context menu.

 

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

 

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

 

 

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.

 

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

 

25. Klik op "Security & Privacy".

 

26. Klik op "Open anyway".

 

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

 

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

 

29. Tenslotte, Ancestris is gestart.

.

 

30. Je ziet nu het welkomst scherm.

 

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

 

 

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.

 

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

 

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

 

 

---

 

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

2. Open het Ancestris configuratie bestand met de editor.

• Typ het volgende commando dat start met "nano ${HOME}..."

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

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,

5. Stop en sla je wijzigingen op.

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

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