[[TOC(heading=Linux installatie)]]
[[TOC(heading=Installatiehandleiding, sectionindex, compact, depth=4, allactive, Documentatie/Beheerder/Installeren/Installatiehandleiding/)]]
[[TOC(heading=Installeren en beheren, sectionindex, compact, depth=3, allactive, indirect=Documentatie/Beheerder/Installeren/TOC)]]
[[TOC(heading=Beheerder, sectionindex, compact, depth=2, allactive, indirect=Documentatie/Beheerder/TOC)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

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

[[NoteBox(tip, Als je dapper genoeg bent om de Linux versie te installeren, dan is de [wiki:Documentatie/Ontwikkelaar 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 [wiki:Documentatie/Ontwikkelhandleiding/Source 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
}}}