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. TheDe JDK installerinstallatie starts.start. JustVolg followde the steps.stappen.

macOS-10.png

 

10. TheDe installationinstallatie shouldmoet benu successful.geslaagd Closezijn. theSluit window.het scherm.

macOS-11.png

 

11. ThenType type againopnieuw "java -version" in thehet terminal.terminal scherm.

TheDe followingvolgende resultmededeling shouldzal appear,verschijnen, indicatingdat Javaaangeeft dat Java versie 15 in ons voorbeeld is installedgeïnstalleerd. in our example.  

macOS-12.png

YourJe arebent nownu doneklaar withmet thede Java installation.installatie. Let'sWe installgaan nu Ancestris now.installeren.

 

InstallationInstallatie ofvan Ancestris

12. GoGa tonaar the de https://www.ancestris.org web site

macOS-13.png

 

13. In thehet menu, clickklik onop DOWNLOAD. ThisJe willgaat scrollnu downnaar to thede download section.sectie.

macOS-14.png

 

14. ClickKlik onop the de Ancestris 11 buttonknop ofvan the het MacOS panel.paneel.

macOS-15.png

 

15. Allow downloads from the Ancestris web site if this is the first time you do it.

macOS-16.png

 

16. Downloading starts. It will take a couple of minutes.

macOS-17.png

 

17. Wait a bit more ... we said a couple of minutes !

macOS-18.png

 

18. Once complete, move the file to your genealogy folder.

macOS-19.png

 

19. It is better to place your Ancestris application in a separate folder from your genealogy data.

macOS-20.png

 

20. To make sure it is the version you expect, click on "Quick Look "Ancestris" from the context menu.

macOS-21.png

 
21. The application panel should tell you about the file version and date.

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