Linux installatie

Deze handleiding beschrijft de installatie van OpenAC onder Linux (waarbij we "Linux" opvatten als dingen-die-niet-Windows zijn, dus FreeBSD en MacOSX vallen hier ook onder). Omdat er meer variatie zit in de beschikbare Linux varianten dan in de Windows varianten, is er meer handwerk te verrichten.

Als je dapper genoeg bent om de Linux versie te installeren, dan is de ontwikkelaarsinformatie wellicht ook nuttig.

Er is geen starter kit voor OpenAC onder Linux. We gebruiken een aantal standaard-pakketten en de standaard Python runtime die onder Linux beschikbaar is. De functionaliteit van OpenAC is onder Linux wel minder dan onder Windows, omdat niet alle koppelingen (bijvoorbeeld naar meetpakketten) gerealiseerd kunnen worden.

Python

In de meeste Linux distributies is Python 2.7 voorgeinstalleerd. OpenAC vereist minstens Python 2.5. Python 2.7 wordt het meeste gebruikt en getest. Python 3 wordt niet getest.

Log in als een gewone gebruiker. Controleer of Python geinstalleerd is met python --version. Als dat iets afdrukt als Python 2.7.6 dan is Python al geinstalleerd en kan je verder met de volgende stap. Anders moet je eerst Python installeren:

• OpenSuse: Python is altijd geinstalleerd, omdat het gebruikt wordt door sommige delen van de systeem-tools. Zoniet, dan toch sudo zypper in python.
• Debian en Ubuntu: Python is bijna altijd geinstalleerd, omdat het gebruikt wordt door sommige delen van de systeem-tools. Zoniet, dan sudo apt-get install python.
• Fedora: Is niet getest.
• FreeBSD en PC-BSD: Python wordt niet standaard meegeleverd. Gebruik (als root) portinstall -PP python.
• MacOSX: Is niet getest.

Versiebeheer

Installeer een van de versiebeheer tools om de source van OpenAC mee op te halen. Aanbevolen is Subversion omdat het de meest-centrale bron van de OpenAC source is, maar je kan ook Mercurial of Git gebruiken, zie daarvoor de pagina over source control.

Log eerst in als een gewone gebruiker. Controleer of subversion geinstalleerd is met svn --version. Als dat een omschrijving afdrukt (meestal beginnend met svn, version 1.8.10) dan is subversion al geinstalleerd en kan je verder naar de volgende stap.

• OpenSuse: Gebruik sudo zypper in subversion.
• Debian en Ubuntu: Gebruik sudo apt-get install subversion.
• Fedora: Gebruik sudo yum install subversion.
• FreeBSD en PC-BSD: Gebruik (als root) portinstall -PP subversion.
• MacOSX: Is niet getest.

Sources

Maak een checkout van de OpenAC source tree. Log eerst in als gewone gebruiker. OpenAC wordt geinstalleerd in een directory OpenAC in de home-directory. Vervang in het onderstaande commando v2.008 door de versie van OpenAC die je wilt hebben.

cd ~
svn co https://svn.openac.fenac.nl/release/v2.008 OpenAC
mkdir OpenAC/.openac

Subversion vraagt eerst om een wachtwoord behorende bij je login-naam. Druk maar op enter, omdat die toch niet overeenkomt met de login-namen voor de OpenAC site. Voer daarna je OpenAC-site username en wachtwoord in.

Dependencies

OpenAC hangt af van een aantal andere pakketten, zoals wxPython, reportlab, en anderen. Omdat het te langdurig is om uit te leggen welke packages dat allemaal zijn in de verschillende distributies is er een shell-script setup-linux.sh in de bin/ directory van de OpenAC source checkout. De dependencies worden automatisch geinstalleerd.

Log eerst in als (dezelfde) gewone gebruiker met OpenAC sources in de OpenAC directory in de eigen home. Voer vervolgens de volgende stappen uit:

cd ~/OpenAC
sh bin/setup-linux.sh

Gebruik

Als er eenmaal een checkout is gemaakt, kan je OpenAC opstarten door in de source directory python openac.pyw te draaien. Dat kan in een terminal als volgt:

cd ~/OpenAC
python openac.pyw