Skip to main content

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 "screen 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  "required configuration").

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 gaatkomt nu naarop de download sectie.

macOS-14.png

 

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

macOS-15.png

 

15. AllowAls downloadsdit fromde theeerste keer is dat je Ancestris webinstalleert, sitedan ifgeeft thisje isnu thede firstdownload timevan youAncestris dotoestemming it.om vanaf de website Anchestris te dowloaden.

macOS-16.png

 

16. DownloadingDe starts.downloading Itstart. willHet takeneemt aeen coupleslechts ofeen minutes.paar minuten in beslag.

macOS-17.png

 

17. WaitWacht anog biteven morelanger ....  we saidzeiden aeen couplepaar of minutesminuutjes !

macOS-18.png

 

18. OnceAls complete,de movedownload theklaar fileis tozet yourhet genealogybestand folder.in je genealogie map.

macOS-19.png

 

19. ItHet is betterbeter toom place your het Ancestris applicationprogramma in aeen separateandere foldermap fromdan yourje genealogygenealogie data.data te zetten.

macOS-20.png

 

20. ToOm makezeker surete itweten isdat theje versionde yougoede expect,versie clickhebt, onklik op "Quick Look "Ancestris" fromvan thehet context menu.

macOS-21.png

 
21. TheHet applicationprogramma panelscherm shouldlaat tellje younu abouthet theversienummer fileen versionde anddatum date.zien.

macOS-22.png

 

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

macOS-23.png

 

 

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.

macOS-24.png

 

24. For that, go to the System Preferences

macOS-25.png

 

25. Click on "Security & Privacy"

macOS-26.png

 

26. Click on "Open anyway"

macOS-27.png

 

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

macOS-28.png

 

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

macOS-29.png

 

29. Finally, Ancestris starts.

macOS-30.png

 

30. You can see the Welcome window.

macOS-31.png

 

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

macOS-32.png

 

Keep in dock

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

macOS-33.png

 

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

macOS-34.png

 

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

macOS-35.png

 

 

 

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

en-force-java-path-01.png

2. Open the editor on the Ancestris configuration file
  • Type the following command which starts with "nano ${HOME}..."

en-force-java-path-02.png

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

en-force-java-path-03.png

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.

en-force-java-path-04.png

5. Exit and save your change

en-force-java-path-05.png

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.

en-force-java-path-06.png

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

 

 

 

 

 

 

 

 

Back to top