EekBoek - Gebruikersbijdragen [nl]

Platform:Debian

2015-04-23T18:58:43Z

Pvdv: /* EekBoek starten */

== Inleiding ==

Deze handleiding gaat over het installeren van EekBoek op Debian Squeeze (6.0) en zal ook bruikbaar zijn op Wheezy (7.0) en Sid.

Website: http://www.debian.org/

== Het installeren van de packages ==

Doe onderstaande als root.
Voor de console versie van EekBoek is het pakket "eekboek" nodig:
apt-get install eekboek
Indien je de grafische versie wilt installeren dan installeer je het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
apt-get install eekboek-gui
Mocht je PostgreSQL willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek. PostgreSQL is wat krachtiger en geeft o.a. mogelijkheden voor een multi-user netwerk installatie.
apt-get install eekboek-db-postgresql

== Het eventueel upgraden van de packages naar EekBoek versie 2.02.04 ==

In Debian 6 zit EekBoek 2.00.02 en in Debian 7 zit EekBoek 2.00.04. Sinds kort is er echter ook een EekBoek 2.02.04. Deze versie heeft een aantal verbeteringen met betrekking tot meerdere BTW-percentages in één jaar, en met betrekking tot het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren. Voor het installeren zijn uiteraard root-rechten nodig:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.04+dfsg-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.04+dfsg-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.04+dfsg-1_all.deb
dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

== EekBoek starten ==

Daarna kun je de grafische EekBoek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

Indien je gebruik wilt maken van de console-versie, tik dan "ebshell" in een shell (uiteraard als gewone gebruiker), er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Platform:Debian

2015-04-23T18:58:24Z

Pvdv: /* Inleiding */

Platform:Debian

2015-04-23T18:58:05Z

Pvdv: /* Het eventueel upgraden van de packages naar EekBoek versie 2.00.02 */

== Inleiding ==

Deze handleiding gaat over het installeren van EekBoek op Debian Squeeze (6.0) en zal ook bruikbaar zijn op Wheezy (7.0) en Sid.

Website: http://www.debian.org/

Packager: paul@vandervlis.nl

== Het installeren van de packages ==

Doe onderstaande als root.
Voor de console versie van EekBoek is het pakket "eekboek" nodig:
apt-get install eekboek
Indien je de grafische versie wilt installeren dan installeer je het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
apt-get install eekboek-gui
Mocht je PostgreSQL willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek. PostgreSQL is wat krachtiger en geeft o.a. mogelijkheden voor een multi-user netwerk installatie.
apt-get install eekboek-db-postgresql

== Het eventueel upgraden van de packages naar EekBoek versie 2.02.04 ==

In Debian 6 zit EekBoek 2.00.02 en in Debian 7 zit EekBoek 2.00.04. Sinds kort is er echter ook een EekBoek 2.02.04. Deze versie heeft een aantal verbeteringen met betrekking tot meerdere BTW-percentages in één jaar, en met betrekking tot het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren. Voor het installeren zijn uiteraard root-rechten nodig:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.04+dfsg-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.04+dfsg-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.04+dfsg-1_all.deb
dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

== EekBoek starten ==

Daarna kun je de grafische EekBoek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

Indien je gebruik wilt maken van de console-versie, tik dan "ebshell" in een shell (uiteraard als gewone gebruiker), er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Debian

2015-04-23T18:56:56Z

Pvdv: /* Het eventueel upgraden van de packages naar EekBoek versie 2.00.02 */

== Inleiding ==

Deze handleiding gaat over het installeren van EekBoek op Debian Squeeze (6.0) en zal ook bruikbaar zijn op Wheezy (7.0) en Sid.

Website: http://www.debian.org/

Packager: paul@vandervlis.nl

== Het installeren van de packages ==

Doe onderstaande als root.
Voor de console versie van EekBoek is het pakket "eekboek" nodig:
apt-get install eekboek
Indien je de grafische versie wilt installeren dan installeer je het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
apt-get install eekboek-gui
Mocht je PostgreSQL willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek. PostgreSQL is wat krachtiger en geeft o.a. mogelijkheden voor een multi-user netwerk installatie.
apt-get install eekboek-db-postgresql

== Het eventueel upgraden van de packages naar EekBoek versie 2.00.02 ==

In Debian 6 zit EekBoek 2.00.02 en in Debian 7 zit EekBoek 2.00.04. Sinds kort is er echter ook een EekBoek 2.02.00. Deze versie heeft een aantal verbeteringen met betrekking tot meerdere BTW-percentages in één jaar, en met betrekking tot het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren. Voor het installeren zijn uiteraard root-rechten nodig:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.04+dfsg-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.04+dfsg-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.04+dfsg-1_all.deb
dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

== EekBoek starten ==

Daarna kun je de grafische EekBoek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

Indien je gebruik wilt maken van de console-versie, tik dan "ebshell" in een shell (uiteraard als gewone gebruiker), er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Netwerk

2012-10-09T10:09:41Z

Pvdv: /* De volgende clients */

Deze handleiding gaat over de netwerkinstallatie van EekBoek, ofwel het ter beschikking stellen van EekBoek via een bedrijfsnetwerk, zodat meerdere personen tegelijkertijd in dezelfde administraties boekingen kunnen invoeren of bewerken. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

===Architectuur===
Het doel is om tot de volgende architectuur te komen:

[[Bestand:Eekboek-network.png]]

=== Server ===
Bij installatie in een netwerk is er een server en zijn er één of meerdere clients. Concreet betekent dit dat EekBoek als applicatie op iedere client is geinstalleerd en het database management systeem op de server. Het database management systeem uit deze handleiding is PostgreSQL, omdat dat systeem multi-user mogelijkheden biedt. PostgreSQL 8.3 en later is bruikbaar, waarschijnlijk wat oudere versies ook maar precies weet ik dit niet. PostgreSQL is een database met veel mogelijkheden waarover complete boeken vol zijn geschreven, mijn verhaal blijft daarom enigszins beperkt. PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

Ik ga het nu allereerst over een paar configuratiebestanden hebben. Deze staan op ieder platform weer ergens anders. Vaak is het het handigste er even naar te zoeken. Na het wijzigen van deze bestanden moet postgresql herstart worden.

==== pg_hba.conf ====
Een belangrijk bestand in PostgreSQL is pg_hba.conf, hier dient het netwerk toegang te krijgen tot de database. Ik stel voor deze regel toe te voegen:
host all all 0.0.0.0/0 md5
Hiermee vertel je dat iedereen via het netwerk mag inloggen op alle databases mits er een juiste username en paswoord bekend is. Uiteraard kan er ook iets als 192.168.1.0/24 gebruikt worden in plaats van 0.0.0.0/0 als extra veiligheid. Meer informatie is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

==== postgresql.conf ====
Een ander belangerijk bestand is postgresql.conf. Ik raad je aan in dit bestand te zoeken naar "listen_addresses". Vaak is dit namelijk "localhost", of is het default "localhost" en dat gaat niet werken via het netwerk. Ik raad je hier aan er "listen_addresses = '*' " van te maken, wat betekent dat je van overal kunt aanmelden. Een eventueel hekje (#) aan het begin van de regel moet worden verwijderd. Uiteraard kan het ook hier op vele manieren, meer informatie is [http://www.postgresql.org/docs/8.4/interactive/config-setting.html hier te vinden].

==== Database role aanmaken ====
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Je kunt voor iedere gebruiker een eigen role aanmaken, maar een role kan ook prima gedeeld worden door meerdere gebruikers, vandaar ook de term "role" (in het Nederlands "rol").

In Linux/Unix kun je user "postgres" worden met een commando als "sudo su postgres" of als root met "su progres". Het aanmaken van de role gaat hier met het commando "createuser -P ebuser". Hiermee maak je een role "ebuser" aan met paswoord. Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je normaal "ja" [1]. Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Ook voor Linux is dit programma beschikbaar. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user normaal databases moet kunnen aanmaken [1], dat kun je in een tabblad instellen.

==== Firewall ====
Op de meeste servers zit tegenwoordig een firewall. PostgreSQL draait normaal op 5432 TCP en deze poort moet worden opengezet, zodat de clients bij deze poort kunnen. De configuratie van de firewall voor PostgreSQL is vergelijkbaar met die van een webserver, alleen is het poortnummer dus anders.

=== Client ===
Het is een goed idee om vanaf een client PC eerst te testen of de server te bereiken is op poort 5432. Ik doe dat normaal door op de commandline het commando "telnet 1.2.3.4 5432" te geven. Uiteraard moet je in plaats van "1.2.3.4" het correcte IP adres of de correcte naam van de server opgeven. Mocht de poort niet te bereiken zijn, ga dan nog eens naar de configuratie van de server kijken. Sommige Windows versies hebben overigens de telnet client default uit staan, [http://windows.microsoft.com/nl-NL/windows-vista/Telnet-frequently-asked-questions hier staat hoe je dat kunt veranderen].

Onderstaande gaat over Eekboek versie 2.02.00 en hoger. Mocht je een oudere versie van EekBoek gebruiken dan staan [[platform:Netwerkclient-oud|hier de juiste aanwijzingen]].

==== De eerste client, het aanmaken van de database ====
Na installatie van de eerste client kan de database worden aangemaakt. Het installeren van deze client kan eventueel ook op de server gebeuren, we gaan hier ervan uit dat het op de client gebeurt.

In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je moet invullen met welke server je wilt connecten, via welke TCP/IP poort en met welke usernaam (role) en password. In een normale netwerkinstallatie vul je het ip nummer of de naam van de databaseserver in, de poort laat je ongewijzigd ("--standaard--"), de role waarmee je toegang hebt tot de database, en het bijbehorende paswoord. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Waarschuwing: als je een administratie aanmaakt onder een naam die al bestaat in PostgreSQL, en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven. Zie ook voetnoot [1].

==== De volgende clients ====
In de wizard kies je voor "verbinden met een bestaande boekhouding". Er wordt je om je username, paswoord, hostname en dergelijke gevraagd, die vul je in precies zoals hierboven beschreven. Er wordt nu een configuratiebestand aangemaakt maar geen boekhouding (die is er immers al) en je kunt inloggen op de bestaande boekhouding.

=== Resultaat ===
Het resultaat is een boekhouding waar verschillende mensen tegelijk op kunnen werken. De gegevens staan in een database op een server, die wellicht wat degelijker is en gebackupped wordt, en wie weet zelfs een UPS heeft tegen stroomuitval.

[1] Eekboek kan boekhoudingen zelf aanmaken in PostgreSQL, daartoe moet de role wel het recht hebben om databases aan te maken. Er zijn echter situaties denkbaar waarin de beheerder van de database dit niet wil, hij/zij kan dan zelf databases aanmaken, en de role dit recht niet geven. Een andere optie is om 2 roles te maken, bijvoorbeeld een role "ebuser" die geen databases mag aanmaken en een role "ebadmin" die dit wel mag. Het lastige daarvan is wel, dat de role "ebuser" het recht zal moeten krijgen om de database van "ebadmin" te bewerken.

Eekboek met PostgreSQL op localhost

2012-10-07T13:29:26Z

Pvdv: /* Bij problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma [http://www.pgadmin.org/ PGadmin3], wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken.

Het gemakkelijkste is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie (2.02.00 en hoger) van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bij problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

En bij een Windows systeem dit:
host all all 127.0.0.1/32 md5

Dit zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Bij ieder operating systeem en versie van PostgreSQL staat het weer ergens anders, dus ik raad je aan er even naar te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden].

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2012-10-07T13:28:23Z

Pvdv: /* Nieuwe versie van Eekboek configureren */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma [http://www.pgadmin.org/ PGadmin3], wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken.

Het gemakkelijkste is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie (2.02.00 en hoger) van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bij problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

En bij een Windows systeem dit:
host all all 127.0.0.1/32 md5

Dit zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Bij ieder operating systeem en versie van PostgreSQL staat het weer ergens anders, dus ik raad je aan er even naar te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden].

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Platform:Netwerk

2012-10-07T13:22:24Z

Pvdv: /* Database role aanmaken */

Deze handleiding gaat over de netwerkinstallatie van EekBoek, ofwel het ter beschikking stellen van EekBoek via een bedrijfsnetwerk, zodat meerdere personen tegelijkertijd in dezelfde administraties boekingen kunnen invoeren of bewerken. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

===Architectuur===
Het doel is om tot de volgende architectuur te komen:

[[Bestand:Eekboek-network.png]]

=== Server ===
Bij installatie in een netwerk is er een server en zijn er één of meerdere clients. Concreet betekent dit dat EekBoek als applicatie op iedere client is geinstalleerd en het database management systeem op de server. Het database management systeem uit deze handleiding is PostgreSQL, omdat dat systeem multi-user mogelijkheden biedt. PostgreSQL 8.3 en later is bruikbaar, waarschijnlijk wat oudere versies ook maar precies weet ik dit niet. PostgreSQL is een database met veel mogelijkheden waarover complete boeken vol zijn geschreven, mijn verhaal blijft daarom enigszins beperkt. PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

Ik ga het nu allereerst over een paar configuratiebestanden hebben. Deze staan op ieder platform weer ergens anders. Vaak is het het handigste er even naar te zoeken. Na het wijzigen van deze bestanden moet postgresql herstart worden.

==== pg_hba.conf ====
Een belangrijk bestand in PostgreSQL is pg_hba.conf, hier dient het netwerk toegang te krijgen tot de database. Ik stel voor deze regel toe te voegen:
host all all 0.0.0.0/0 md5
Hiermee vertel je dat iedereen via het netwerk mag inloggen op alle databases mits er een juiste username en paswoord bekend is. Uiteraard kan er ook iets als 192.168.1.0/24 gebruikt worden in plaats van 0.0.0.0/0 als extra veiligheid. Meer informatie is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

==== postgresql.conf ====
Een ander belangerijk bestand is postgresql.conf. Ik raad je aan in dit bestand te zoeken naar "listen_addresses". Vaak is dit namelijk "localhost", of is het default "localhost" en dat gaat niet werken via het netwerk. Ik raad je hier aan er "listen_addresses = '*' " van te maken, wat betekent dat je van overal kunt aanmelden. Een eventueel hekje (#) aan het begin van de regel moet worden verwijderd. Uiteraard kan het ook hier op vele manieren, meer informatie is [http://www.postgresql.org/docs/8.4/interactive/config-setting.html hier te vinden].

==== Database role aanmaken ====
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Je kunt voor iedere gebruiker een eigen role aanmaken, maar een role kan ook prima gedeeld worden door meerdere gebruikers, vandaar ook de term "role" (in het Nederlands "rol").

In Linux/Unix kun je user "postgres" worden met een commando als "sudo su postgres" of als root met "su progres". Het aanmaken van de role gaat hier met het commando "createuser -P ebuser". Hiermee maak je een role "ebuser" aan met paswoord. Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je normaal "ja" [1]. Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Ook voor Linux is dit programma beschikbaar. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user normaal databases moet kunnen aanmaken [1], dat kun je in een tabblad instellen.

==== Firewall ====
Op de meeste servers zit tegenwoordig een firewall. PostgreSQL draait normaal op 5432 TCP en deze poort moet worden opengezet, zodat de clients bij deze poort kunnen. De configuratie van de firewall voor PostgreSQL is vergelijkbaar met die van een webserver, alleen is het poortnummer dus anders.

=== Client ===
Het is een goed idee om vanaf een client PC eerst te testen of de server te bereiken is op poort 5432. Ik doe dat normaal door op de commandline het commando "telnet 1.2.3.4 5432" te geven. Uiteraard moet je in plaats van "1.2.3.4" het correcte IP adres of de correcte naam van de server opgeven. Mocht de poort niet te bereiken zijn, ga dan nog eens naar de configuratie van de server kijken. Sommige Windows versies hebben overigens de telnet client default uit staan, [http://windows.microsoft.com/nl-NL/windows-vista/Telnet-frequently-asked-questions hier staat hoe je dat kunt veranderen].

Onderstaande gaat over Eekboek versie 2.02.00 en hoger. Mocht je een oudere versie van EekBoek gebruiken dan staan [[platform:Netwerkclient-oud|hier de juiste aanwijzingen]].

==== De eerste client, het aanmaken van de database ====
Na installatie van de eerste client kan de database worden aangemaakt. Het installeren van deze client kan eventueel ook op de server gebeuren, we gaan hier ervan uit dat het op de client gebeurt.

In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je moet invullen met welke server je wilt connecten, via welke TCP/IP poort en met welke usernaam (role) en password. In een normale netwerkinstallatie vul je het ip nummer of de naam van de databaseserver in, de poort laat je ongewijzigd ("--standaard--"), de role waarmee je toegang hebt tot de database, en het bijbehorende paswoord. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Waarschuwing: als je een administratie aanmaakt onder een naam die al bestaat in PostgreSQL, en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven. Zie ook voetnoot [1].

==== De volgende clients ====
In de wizard kies je voor een nieuwe boekhouding. Wat voor boekhouding je kiest is niet erg van belang want we kiezen er later voor om hem niet aan te maken. Je kiest de postgresql database. Er wordt je om je username, paswoord, hostname en dergelijke gevraagd, die vul je in precies zoals hierboven beschreven. Dan komt er als laatste een pagina met een overzicht wat er gaat gebeuren. '''Daar vink je alles uit''' behalve "configuratiebestand". Er wordt nu een configuratiebestand aangemaakt maar geen database (die is er immers al) en je kunt inloggen op de bestaande database.

Waarschuwing: als je het boven genoemde uitvinken vergeet en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven.

In het CLI interface is er geen laatste pagina met een overzicht maar komen er verschillende vragen na elkaar. De vraag over het configuratiebestand beantwoord je met "ja". De vraag over de administratiebestanden en over de database beantwoord je met "nee". De laatste vraag over doorgaan beantwoord je uiteraard weer met "ja".

=== Resultaat ===
Het resultaat is een boekhouding waar verschillende mensen tegelijk op kunnen werken. De gegevens staan in een database op een server, die wellicht wat degelijker is en gebackupped wordt, en wie weet zelfs een UPS heeft tegen stroomuitval.

[1] Eekboek kan boekhoudingen zelf aanmaken in PostgreSQL, daartoe moet de role wel het recht hebben om databases aan te maken. Er zijn echter situaties denkbaar waarin de beheerder van de database dit niet wil, hij/zij kan dan zelf databases aanmaken, en de role dit recht niet geven. Een andere optie is om 2 roles te maken, bijvoorbeeld een role "ebuser" die geen databases mag aanmaken en een role "ebadmin" die dit wel mag. Het lastige daarvan is wel, dat de role "ebuser" het recht zal moeten krijgen om de database van "ebadmin" te bewerken.

Platform:Netwerk

2012-10-07T13:21:02Z

Pvdv: /* Resultaat */

Deze handleiding gaat over de netwerkinstallatie van EekBoek, ofwel het ter beschikking stellen van EekBoek via een bedrijfsnetwerk, zodat meerdere personen tegelijkertijd in dezelfde administraties boekingen kunnen invoeren of bewerken. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

===Architectuur===
Het doel is om tot de volgende architectuur te komen:

[[Bestand:Eekboek-network.png]]

=== Server ===
Bij installatie in een netwerk is er een server en zijn er één of meerdere clients. Concreet betekent dit dat EekBoek als applicatie op iedere client is geinstalleerd en het database management systeem op de server. Het database management systeem uit deze handleiding is PostgreSQL, omdat dat systeem multi-user mogelijkheden biedt. PostgreSQL 8.3 en later is bruikbaar, waarschijnlijk wat oudere versies ook maar precies weet ik dit niet. PostgreSQL is een database met veel mogelijkheden waarover complete boeken vol zijn geschreven, mijn verhaal blijft daarom enigszins beperkt. PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

Ik ga het nu allereerst over een paar configuratiebestanden hebben. Deze staan op ieder platform weer ergens anders. Vaak is het het handigste er even naar te zoeken. Na het wijzigen van deze bestanden moet postgresql herstart worden.

==== pg_hba.conf ====
Een belangrijk bestand in PostgreSQL is pg_hba.conf, hier dient het netwerk toegang te krijgen tot de database. Ik stel voor deze regel toe te voegen:
host all all 0.0.0.0/0 md5
Hiermee vertel je dat iedereen via het netwerk mag inloggen op alle databases mits er een juiste username en paswoord bekend is. Uiteraard kan er ook iets als 192.168.1.0/24 gebruikt worden in plaats van 0.0.0.0/0 als extra veiligheid. Meer informatie is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

==== postgresql.conf ====
Een ander belangerijk bestand is postgresql.conf. Ik raad je aan in dit bestand te zoeken naar "listen_addresses". Vaak is dit namelijk "localhost", of is het default "localhost" en dat gaat niet werken via het netwerk. Ik raad je hier aan er "listen_addresses = '*' " van te maken, wat betekent dat je van overal kunt aanmelden. Een eventueel hekje (#) aan het begin van de regel moet worden verwijderd. Uiteraard kan het ook hier op vele manieren, meer informatie is [http://www.postgresql.org/docs/8.4/interactive/config-setting.html hier te vinden].

==== Database role aanmaken ====
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Je kunt voor iedere gebruiker een eigen role aanmaken, maar een role kan ook prima gedeeld worden door meerdere gebruikers, vandaar ook de term "role" (in het Nederlands "rol").

In Linux/Unix kun je user "postgres" worden met een commando als "sudo su postgres" of als root met "su progres". Het aanmaken van de role gaat hier met het commando "createuser -P ebuser". Hiermee maak je een role "ebuser" aan met paswoord. Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je normaal "ja" [1]. Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Ook voor Linux is dit programma geschikbaar. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user normaal databases moet kunnen aanmaken [1], dat kun je in een tabblad instellen.

==== Firewall ====
Op de meeste servers zit tegenwoordig een firewall. PostgreSQL draait normaal op 5432 TCP en deze poort moet worden opengezet, zodat de clients bij deze poort kunnen. De configuratie van de firewall voor PostgreSQL is vergelijkbaar met die van een webserver, alleen is het poortnummer dus anders.

=== Client ===
Het is een goed idee om vanaf een client PC eerst te testen of de server te bereiken is op poort 5432. Ik doe dat normaal door op de commandline het commando "telnet 1.2.3.4 5432" te geven. Uiteraard moet je in plaats van "1.2.3.4" het correcte IP adres of de correcte naam van de server opgeven. Mocht de poort niet te bereiken zijn, ga dan nog eens naar de configuratie van de server kijken. Sommige Windows versies hebben overigens de telnet client default uit staan, [http://windows.microsoft.com/nl-NL/windows-vista/Telnet-frequently-asked-questions hier staat hoe je dat kunt veranderen].

Onderstaande gaat over Eekboek versie 2.02.00 en hoger. Mocht je een oudere versie van EekBoek gebruiken dan staan [[platform:Netwerkclient-oud|hier de juiste aanwijzingen]].

==== De eerste client, het aanmaken van de database ====
Na installatie van de eerste client kan de database worden aangemaakt. Het installeren van deze client kan eventueel ook op de server gebeuren, we gaan hier ervan uit dat het op de client gebeurt.

In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je moet invullen met welke server je wilt connecten, via welke TCP/IP poort en met welke usernaam (role) en password. In een normale netwerkinstallatie vul je het ip nummer of de naam van de databaseserver in, de poort laat je ongewijzigd ("--standaard--"), de role waarmee je toegang hebt tot de database, en het bijbehorende paswoord. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Waarschuwing: als je een administratie aanmaakt onder een naam die al bestaat in PostgreSQL, en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven. Zie ook voetnoot [1].

==== De volgende clients ====
In de wizard kies je voor een nieuwe boekhouding. Wat voor boekhouding je kiest is niet erg van belang want we kiezen er later voor om hem niet aan te maken. Je kiest de postgresql database. Er wordt je om je username, paswoord, hostname en dergelijke gevraagd, die vul je in precies zoals hierboven beschreven. Dan komt er als laatste een pagina met een overzicht wat er gaat gebeuren. '''Daar vink je alles uit''' behalve "configuratiebestand". Er wordt nu een configuratiebestand aangemaakt maar geen database (die is er immers al) en je kunt inloggen op de bestaande database.

Waarschuwing: als je het boven genoemde uitvinken vergeet en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven.

In het CLI interface is er geen laatste pagina met een overzicht maar komen er verschillende vragen na elkaar. De vraag over het configuratiebestand beantwoord je met "ja". De vraag over de administratiebestanden en over de database beantwoord je met "nee". De laatste vraag over doorgaan beantwoord je uiteraard weer met "ja".

=== Resultaat ===
Het resultaat is een boekhouding waar verschillende mensen tegelijk op kunnen werken. De gegevens staan in een database op een server, die wellicht wat degelijker is en gebackupped wordt, en wie weet zelfs een UPS heeft tegen stroomuitval.

[1] Eekboek kan boekhoudingen zelf aanmaken in PostgreSQL, daartoe moet de role wel het recht hebben om databases aan te maken. Er zijn echter situaties denkbaar waarin de beheerder van de database dit niet wil, hij/zij kan dan zelf databases aanmaken, en de role dit recht niet geven. Een andere optie is om 2 roles te maken, bijvoorbeeld een role "ebuser" die geen databases mag aanmaken en een role "ebadmin" die dit wel mag. Het lastige daarvan is wel, dat de role "ebuser" het recht zal moeten krijgen om de database van "ebadmin" te bewerken.

Platform:Netwerk

2012-10-07T13:15:39Z

Pvdv: /* Resultaat */

Deze handleiding gaat over de netwerkinstallatie van EekBoek, ofwel het ter beschikking stellen van EekBoek via een bedrijfsnetwerk, zodat meerdere personen tegelijkertijd in dezelfde administraties boekingen kunnen invoeren of bewerken. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

===Architectuur===
Het doel is om tot de volgende architectuur te komen:

[[Bestand:Eekboek-network.png]]

=== Server ===
Bij installatie in een netwerk is er een server en zijn er één of meerdere clients. Concreet betekent dit dat EekBoek als applicatie op iedere client is geinstalleerd en het database management systeem op de server. Het database management systeem uit deze handleiding is PostgreSQL, omdat dat systeem multi-user mogelijkheden biedt. PostgreSQL 8.3 en later is bruikbaar, waarschijnlijk wat oudere versies ook maar precies weet ik dit niet. PostgreSQL is een database met veel mogelijkheden waarover complete boeken vol zijn geschreven, mijn verhaal blijft daarom enigszins beperkt. PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

Ik ga het nu allereerst over een paar configuratiebestanden hebben. Deze staan op ieder platform weer ergens anders. Vaak is het het handigste er even naar te zoeken. Na het wijzigen van deze bestanden moet postgresql herstart worden.

==== pg_hba.conf ====
Een belangrijk bestand in PostgreSQL is pg_hba.conf, hier dient het netwerk toegang te krijgen tot de database. Ik stel voor deze regel toe te voegen:
host all all 0.0.0.0/0 md5
Hiermee vertel je dat iedereen via het netwerk mag inloggen op alle databases mits er een juiste username en paswoord bekend is. Uiteraard kan er ook iets als 192.168.1.0/24 gebruikt worden in plaats van 0.0.0.0/0 als extra veiligheid. Meer informatie is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

==== postgresql.conf ====
Een ander belangerijk bestand is postgresql.conf. Ik raad je aan in dit bestand te zoeken naar "listen_addresses". Vaak is dit namelijk "localhost", of is het default "localhost" en dat gaat niet werken via het netwerk. Ik raad je hier aan er "listen_addresses = '*' " van te maken, wat betekent dat je van overal kunt aanmelden. Een eventueel hekje (#) aan het begin van de regel moet worden verwijderd. Uiteraard kan het ook hier op vele manieren, meer informatie is [http://www.postgresql.org/docs/8.4/interactive/config-setting.html hier te vinden].

==== Database role aanmaken ====
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Je kunt voor iedere gebruiker een eigen role aanmaken, maar een role kan ook prima gedeeld worden door meerdere gebruikers, vandaar ook de term "role" (in het Nederlands "rol").

In Linux/Unix kun je user "postgres" worden met een commando als "sudo su postgres" of als root met "su progres". Het aanmaken van de role gaat hier met het commando "createuser -P ebuser". Hiermee maak je een role "ebuser" aan met paswoord. Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je normaal "ja" [1]. Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Ook voor Linux is dit programma geschikbaar. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user normaal databases moet kunnen aanmaken [1], dat kun je in een tabblad instellen.

==== Firewall ====
Op de meeste servers zit tegenwoordig een firewall. PostgreSQL draait normaal op 5432 TCP en deze poort moet worden opengezet, zodat de clients bij deze poort kunnen. De configuratie van de firewall voor PostgreSQL is vergelijkbaar met die van een webserver, alleen is het poortnummer dus anders.

=== Client ===
Het is een goed idee om vanaf een client PC eerst te testen of de server te bereiken is op poort 5432. Ik doe dat normaal door op de commandline het commando "telnet 1.2.3.4 5432" te geven. Uiteraard moet je in plaats van "1.2.3.4" het correcte IP adres of de correcte naam van de server opgeven. Mocht de poort niet te bereiken zijn, ga dan nog eens naar de configuratie van de server kijken. Sommige Windows versies hebben overigens de telnet client default uit staan, [http://windows.microsoft.com/nl-NL/windows-vista/Telnet-frequently-asked-questions hier staat hoe je dat kunt veranderen].

Onderstaande gaat over Eekboek versie 2.02.00 en hoger. Mocht je een oudere versie van EekBoek gebruiken dan staan [[platform:Netwerkclient-oud|hier de juiste aanwijzingen]].

==== De eerste client, het aanmaken van de database ====
Na installatie van de eerste client kan de database worden aangemaakt. Het installeren van deze client kan eventueel ook op de server gebeuren, we gaan hier ervan uit dat het op de client gebeurt.

In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je moet invullen met welke server je wilt connecten, via welke TCP/IP poort en met welke usernaam (role) en password. In een normale netwerkinstallatie vul je het ip nummer of de naam van de databaseserver in, de poort laat je ongewijzigd ("--standaard--"), de role waarmee je toegang hebt tot de database, en het bijbehorende paswoord. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Waarschuwing: als je een administratie aanmaakt onder een naam die al bestaat in PostgreSQL, en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven. Zie ook voetnoot [1].

==== De volgende clients ====
In de wizard kies je voor een nieuwe boekhouding. Wat voor boekhouding je kiest is niet erg van belang want we kiezen er later voor om hem niet aan te maken. Je kiest de postgresql database. Er wordt je om je username, paswoord, hostname en dergelijke gevraagd, die vul je in precies zoals hierboven beschreven. Dan komt er als laatste een pagina met een overzicht wat er gaat gebeuren. '''Daar vink je alles uit''' behalve "configuratiebestand". Er wordt nu een configuratiebestand aangemaakt maar geen database (die is er immers al) en je kunt inloggen op de bestaande database.

Waarschuwing: als je het boven genoemde uitvinken vergeet en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven.

In het CLI interface is er geen laatste pagina met een overzicht maar komen er verschillende vragen na elkaar. De vraag over het configuratiebestand beantwoord je met "ja". De vraag over de administratiebestanden en over de database beantwoord je met "nee". De laatste vraag over doorgaan beantwoord je uiteraard weer met "ja".

=== Resultaat ===
Het resultaat is een boekhouding waar verschillende mensen tegelijk op kunnen werken. De gegevens staan in een database op een server, die wellicht wat degelijker is en gebackupped wordt, en wie weet zelfs een UPS heeft tegen stroomuitval.

[1] Eekboek kan de database zelf aanmaken, daartoe moet de role het recht hebben om databases aan te maken. Er zijn echter situaties denkbaar waarin de beheerder van de database dit niet wil, hij/zij kan dan zelf databases aanmaken of zelfs de tabellen, en de role dit recht niet geven. Een andere optie is om 2 roles te maken, bijvoorbeeld een role "ebuser" die geen databases mag aanmaken en een role "ebadmin" die dit wel mag.

Platform:Netwerk

2012-10-07T13:13:24Z

Pvdv: /* De eerste client, het aanmaken van de database */

Deze handleiding gaat over de netwerkinstallatie van EekBoek, ofwel het ter beschikking stellen van EekBoek via een bedrijfsnetwerk, zodat meerdere personen tegelijkertijd in dezelfde administraties boekingen kunnen invoeren of bewerken. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

===Architectuur===
Het doel is om tot de volgende architectuur te komen:

[[Bestand:Eekboek-network.png]]

=== Server ===
Bij installatie in een netwerk is er een server en zijn er één of meerdere clients. Concreet betekent dit dat EekBoek als applicatie op iedere client is geinstalleerd en het database management systeem op de server. Het database management systeem uit deze handleiding is PostgreSQL, omdat dat systeem multi-user mogelijkheden biedt. PostgreSQL 8.3 en later is bruikbaar, waarschijnlijk wat oudere versies ook maar precies weet ik dit niet. PostgreSQL is een database met veel mogelijkheden waarover complete boeken vol zijn geschreven, mijn verhaal blijft daarom enigszins beperkt. PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

Ik ga het nu allereerst over een paar configuratiebestanden hebben. Deze staan op ieder platform weer ergens anders. Vaak is het het handigste er even naar te zoeken. Na het wijzigen van deze bestanden moet postgresql herstart worden.

==== pg_hba.conf ====
Een belangrijk bestand in PostgreSQL is pg_hba.conf, hier dient het netwerk toegang te krijgen tot de database. Ik stel voor deze regel toe te voegen:
host all all 0.0.0.0/0 md5
Hiermee vertel je dat iedereen via het netwerk mag inloggen op alle databases mits er een juiste username en paswoord bekend is. Uiteraard kan er ook iets als 192.168.1.0/24 gebruikt worden in plaats van 0.0.0.0/0 als extra veiligheid. Meer informatie is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

==== postgresql.conf ====
Een ander belangerijk bestand is postgresql.conf. Ik raad je aan in dit bestand te zoeken naar "listen_addresses". Vaak is dit namelijk "localhost", of is het default "localhost" en dat gaat niet werken via het netwerk. Ik raad je hier aan er "listen_addresses = '*' " van te maken, wat betekent dat je van overal kunt aanmelden. Een eventueel hekje (#) aan het begin van de regel moet worden verwijderd. Uiteraard kan het ook hier op vele manieren, meer informatie is [http://www.postgresql.org/docs/8.4/interactive/config-setting.html hier te vinden].

==== Database role aanmaken ====
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Je kunt voor iedere gebruiker een eigen role aanmaken, maar een role kan ook prima gedeeld worden door meerdere gebruikers, vandaar ook de term "role" (in het Nederlands "rol").

In Linux/Unix kun je user "postgres" worden met een commando als "sudo su postgres" of als root met "su progres". Het aanmaken van de role gaat hier met het commando "createuser -P ebuser". Hiermee maak je een role "ebuser" aan met paswoord. Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je normaal "ja" [1]. Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Ook voor Linux is dit programma geschikbaar. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user normaal databases moet kunnen aanmaken [1], dat kun je in een tabblad instellen.

==== Firewall ====
Op de meeste servers zit tegenwoordig een firewall. PostgreSQL draait normaal op 5432 TCP en deze poort moet worden opengezet, zodat de clients bij deze poort kunnen. De configuratie van de firewall voor PostgreSQL is vergelijkbaar met die van een webserver, alleen is het poortnummer dus anders.

=== Client ===
Het is een goed idee om vanaf een client PC eerst te testen of de server te bereiken is op poort 5432. Ik doe dat normaal door op de commandline het commando "telnet 1.2.3.4 5432" te geven. Uiteraard moet je in plaats van "1.2.3.4" het correcte IP adres of de correcte naam van de server opgeven. Mocht de poort niet te bereiken zijn, ga dan nog eens naar de configuratie van de server kijken. Sommige Windows versies hebben overigens de telnet client default uit staan, [http://windows.microsoft.com/nl-NL/windows-vista/Telnet-frequently-asked-questions hier staat hoe je dat kunt veranderen].

Onderstaande gaat over Eekboek versie 2.02.00 en hoger. Mocht je een oudere versie van EekBoek gebruiken dan staan [[platform:Netwerkclient-oud|hier de juiste aanwijzingen]].

==== De eerste client, het aanmaken van de database ====
Na installatie van de eerste client kan de database worden aangemaakt. Het installeren van deze client kan eventueel ook op de server gebeuren, we gaan hier ervan uit dat het op de client gebeurt.

In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je moet invullen met welke server je wilt connecten, via welke TCP/IP poort en met welke usernaam (role) en password. In een normale netwerkinstallatie vul je het ip nummer of de naam van de databaseserver in, de poort laat je ongewijzigd ("--standaard--"), de role waarmee je toegang hebt tot de database, en het bijbehorende paswoord. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Waarschuwing: als je een administratie aanmaakt onder een naam die al bestaat in PostgreSQL, en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven. Zie ook voetnoot [1].

==== De volgende clients ====
In de wizard kies je voor een nieuwe boekhouding. Wat voor boekhouding je kiest is niet erg van belang want we kiezen er later voor om hem niet aan te maken. Je kiest de postgresql database. Er wordt je om je username, paswoord, hostname en dergelijke gevraagd, die vul je in precies zoals hierboven beschreven. Dan komt er als laatste een pagina met een overzicht wat er gaat gebeuren. '''Daar vink je alles uit''' behalve "configuratiebestand". Er wordt nu een configuratiebestand aangemaakt maar geen database (die is er immers al) en je kunt inloggen op de bestaande database.

Waarschuwing: als je het boven genoemde uitvinken vergeet en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven.

In het CLI interface is er geen laatste pagina met een overzicht maar komen er verschillende vragen na elkaar. De vraag over het configuratiebestand beantwoord je met "ja". De vraag over de administratiebestanden en over de database beantwoord je met "nee". De laatste vraag over doorgaan beantwoord je uiteraard weer met "ja".

=== Resultaat ===
Het resultaat is een boekhouding waar verschillende mensen tegelijk op kunnen werken. De gegevens staan in een database op een server, die wellicht wat degelijker is en gebackupped wordt, en wie weet zelfs een UPS heeft tegen stroomuitval.

[1] Normaal maakt Eekboek de database zelf aan, daartoe moet de role het recht hebben om databases aan te maken. Er zijn echter situaties denkbaar waarin de beheerder van de database dit niet wil, hij/zij kan dan zelf databases aanmaken of zelfs de tabellen, en de role dit recht niet geven.

Platform:Ubuntu

2012-10-07T13:01:51Z

Pvdv:

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu. Hij is getest met Maverick (10.10) en Natty (11.04). Waarschijnlijk gaat het ook zo met 11.10 en 12.04 (reacties zijn welkom). Mocht je Lucid (10.04, LTS) gebruiken, dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 10.04.

__FORCETOC__

===Installatie===
Een installatie via het Ubuntu Software Center is de eenvoudigste methode om EekBoek (inclusief GUI) te installeren. Het Ubuntu Software Center is te vinden in het hoofdmenu. Zoek op "eekboek" en de twee EekBoek worden zichtbaar en kunnen door het aanklikken van de knop Install geinstalleerd worden als package:

[[Bestand:installatie-ubuntu.png]]

In deze handleiding wordt echter verder de installatie via de commandline besproken.

Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig.
sudo apt-get install eekboek-db-postgresql
Voor het gebruik van SQLite (de default database) worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

=== Het eventueel upgraden van de packages naar Eekboek versie 2.00.02 ===

Sinds kort is er een Eekboek versie 2.02.00. Deze versie heeft een aantal verbeteringen m.b.t. meerdere BTW-percentages in één jaar, en m.b.t. het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren. Onderstaande heb ik alleen op Debian getest en niet op Ubuntu, maar ik neem aan dat het zal functioneren:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.00-1_all.deb
sudo dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

===Opmerkingen===
In Ubuntu Natty (11.4) zat een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl). Dit probleem zou nu opgelost moeten zijn door een nieuwe versie van libwx-perl in natty-updates.

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Ubuntu

2012-10-07T13:01:00Z

Pvdv:

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu. Hij is getest met Maverick (10.10) en Natty (11.04). Waarschijnlijk gaat het ook zo met 11.10 en 12.04 (reacties zijn welkom). Mocht je Lucid (10.04, LTS) gebruiken, dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 10.04.

__FORCETOC__

===Installatie===
Een installatie via het Ubuntu Software Center is de eenvoudigste methode om EekBoek (inclusief GUI) te installeren. Het Ubuntu Software Center is te vinden in het hoofdmenu. Zoek op "eekboek" en de twee EekBoek worden zichtbaar en kunnen door het aanklikken van de knop Install geinstalleerd worden als package:

[[Bestand:installatie-ubuntu.png]]

In deze handleiding wordt echter verder de installatie via de commandline besproken.

Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig.
sudo apt-get install eekboek-db-postgresql
Voor het gebruik van SQLite (de default database) worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

==== Het eventueel upgraden van de packages naar Eekboek versie 2.00.02 ====

Sinds kort is er een Eekboek versie 2.02.00. Deze versie heeft een aantal verbeteringen m.b.t. meerdere BTW-percentages in één jaar, en m.b.t. het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren. Onderstaande heb ik alleen op Debian getest en niet op Ubuntu, maar ik neem aan dat het zal functioneren:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.00-1_all.deb
sudo dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

===Opmerkingen===
In Ubuntu Natty (11.4) zat een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl). Dit probleem zou nu opgelost moeten zijn door een nieuwe versie van libwx-perl in natty-updates.

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Ubuntu

2012-10-07T13:00:24Z

Pvdv: Stuk over upgraden naar 2.02.00 toegevoegd

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu. Hij is getest met Maverick (10.10) en Natty (11.04). Waarschijnlijk gaat het ook zo met 11.10 en 12.04 (reacties zijn welkom). Mocht je Lucid (10.04, LTS) gebruiken, dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 10.04.

__FORCETOC__

===Installatie===
Een installatie via het Ubuntu Software Center is de eenvoudigste methode om EekBoek (inclusief GUI) te installeren. Het Ubuntu Software Center is te vinden in het hoofdmenu. Zoek op "eekboek" en de twee EekBoek worden zichtbaar en kunnen door het aanklikken van de knop Install geinstalleerd worden als package:

[[Bestand:installatie-ubuntu.png]]

In deze handleiding wordt echter verder de installatie via de commandline besproken.
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig.
sudo apt-get install eekboek-db-postgresql
Voor het gebruik van SQLite (de default database) worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

==== Het eventueel upgraden van de packages naar Eekboek versie 2.00.02 ====

Sinds kort is er een Eekboek versie 2.02.00. Deze versie heeft een aantal verbeteringen m.b.t. meerdere BTW-percentages in één jaar, en m.b.t. het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren. Onderstaande heb ik alleen op Debian getest en niet op Ubuntu, maar ik neem aan dat het zal functioneren:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.00-1_all.deb
sudo dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

===Opmerkingen===
In Ubuntu Natty (11.4) zat een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl). Dit probleem zou nu opgelost moeten zijn door een nieuwe versie van libwx-perl in natty-updates.

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Debian

2012-10-07T12:48:14Z

Pvdv: Upgraden naar 2.00.02 toegevoegd

==== Inleiding ====

Deze handleiding gaat over het installeren van Eekboek op Debian Squeeze (6.0) en zal ook bruikbaar zijn op Wheezy (7.0) en Sid.

==== Het installeren van de packages ====

Doe onderstaande als root.
Voor de console versie van eekboek is het pakket "eekboek" nodig:
apt-get install eekboek
Indien je de grafische versie wilt installeren dan installeer je het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
apt-get install eekboek-gui
Mocht je postgresql willen gebruiken als database dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQlite worden de benodigde pakketen al automatisch geinstalleerd met Eekboek. PostgreSQL is wat krachtiger en geeft o.a. mogelijkheden voor een multi-user netwerk installatie.
apt-get install eekboek-db-postgresql

==== Het eventueel upgraden van de packages naar Eekboek versie 2.00.02 ====

In Debian 6 zit Eekboek 2.00.02 en in Debian 7 zit Eekboek 2.00.04. Sinds kort is er echter ook een Eekboek 2.02.00. Deze versie heeft een aantal verbeteringen m.b.t. meerdere BTW-percentages in één jaar, en m.b.t. het opzetten van een multi-user installatie met PostgreSQL. Het is daarom te overwegen om deze nieuwe versie te installeren, dit gaat als volgt. Voor het installeren zijn uiteraard root-rechten nodig:

# downloaden, uiteraard alleen die pakketten downloaden die nodig zijn:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.02.00-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.02.00-1_all.deb
dpkg -i eekboek*.deb # gedownloade pakketten installeren
rm eekboek*.deb # gedownloade pakketen opruimen

==== Eekboek starten ====

Daarna kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

Indien je gebruik wilt maken van de console-versie, tik dan "ebshell" in een shell (uiteraard als gewone gebruiker), er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Debian

2012-10-07T12:29:39Z

Pvdv: /* Inleiding */

==== Inleiding ====

Deze handleiding gaat over het installeren van Eekboek op Debian Squeeze (6.0) of Wheezy (7.0) met Debian packages en zal ook bruikbaar zijn op Sid.

==== Het installeren van de packages ====

Voor de console versie van eekboek is het pakket "eekboek" nodig:
apt-get install eekboek
Indien je de grafische versie wilt installeren dan installeer je het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
apt-get install eekboek-gui
Mocht je postgresql willen gebruiken als database dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQlite worden de benodigde pakketen al automatisch geinstalleerd met Eekboek. PostgreSQL is wat krachtiger en geeft o.a. mogelijkheden voor een multi-user netwerk installatie.
apt-get install eekboek-db-postgresql

==== Eekboek starten ====

Daarna kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

Indien je gebruik wilt maken van de console-versie, tik dan "ebshell" in een shell (uiteraard als gewone gebruiker), er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Netwerk

2012-09-25T16:40:47Z

Pvdv:

Deze handleiding gaat over de netwerkinstallatie van EekBoek, ofwel het ter beschikking stellen van EekBoek via een bedrijfsnetwerk, zodat meerdere personen tegelijkertijd in dezelfde administraties boekingen kunnen invoeren of bewerken. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

===Architectuur===
Het doel is om tot de volgende architectuur te komen:

[[Bestand:Eekboek-network.png]]

=== Server ===
Bij installatie in een netwerk is er een server en zijn er één of meerdere clients. Concreet betekent dit dat EekBoek als applicatie op iedere client is geinstalleerd en het database management systeem op de server. Het database management systeem uit deze handleiding is PostgreSQL, omdat dat systeem multi-user mogelijkheden biedt. PostgreSQL 8.3 en later is bruikbaar, waarschijnlijk wat oudere versies ook maar precies weet ik dit niet. PostgreSQL is een database met veel mogelijkheden waarover complete boeken vol zijn geschreven, mijn verhaal blijft daarom enigszins beperkt. PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

Ik ga het nu allereerst over een paar configuratiebestanden hebben. Deze staan op ieder platform weer ergens anders. Vaak is het het handigste er even naar te zoeken. Na het wijzigen van deze bestanden moet postgresql herstart worden.

==== pg_hba.conf ====
Een belangrijk bestand in PostgreSQL is pg_hba.conf, hier dient het netwerk toegang te krijgen tot de database. Ik stel voor deze regel toe te voegen:
host all all 0.0.0.0/0 md5
Hiermee vertel je dat iedereen via het netwerk mag inloggen op alle databases mits er een juiste username en paswoord bekend is. Uiteraard kan er ook iets als 192.168.1.0/24 gebruikt worden in plaats van 0.0.0.0/0 als extra veiligheid. Meer informatie is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

==== postgresql.conf ====
Een ander belangerijk bestand is postgresql.conf. Ik raad je aan in dit bestand te zoeken naar "listen_addresses". Vaak is dit namelijk "localhost", of is het default "localhost" en dat gaat niet werken via het netwerk. Ik raad je hier aan er "listen_addresses = '*' " van te maken, wat betekent dat je van overal kunt aanmelden. Een eventueel hekje (#) aan het begin van de regel moet worden verwijderd. Uiteraard kan het ook hier op vele manieren, meer informatie is [http://www.postgresql.org/docs/8.4/interactive/config-setting.html hier te vinden].

==== Database role aanmaken ====
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Je kunt voor iedere gebruiker een eigen role aanmaken, maar een role kan ook prima gedeeld worden door meerdere gebruikers, vandaar ook de term "role" (in het Nederlands "rol").

In Linux/Unix kun je user "postgres" worden met een commando als "sudo su postgres" of als root met "su progres". Het aanmaken van de role gaat hier met het commando "createuser -P ebuser". Hiermee maak je een role "ebuser" aan met paswoord. Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je normaal "ja" [1]. Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Ook voor Linux is dit programma geschikbaar. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user normaal databases moet kunnen aanmaken [1], dat kun je in een tabblad instellen.

==== Firewall ====
Op de meeste servers zit tegenwoordig een firewall. PostgreSQL draait normaal op 5432 TCP en deze poort moet worden opengezet, zodat de clients bij deze poort kunnen. De configuratie van de firewall voor PostgreSQL is vergelijkbaar met die van een webserver, alleen is het poortnummer dus anders.

=== Client ===
Het is een goed idee om vanaf een client PC eerst te testen of de server te bereiken is op poort 5432. Ik doe dat normaal door op de commandline het commando "telnet 1.2.3.4 5432" te geven. Uiteraard moet je in plaats van "1.2.3.4" het correcte IP adres of de correcte naam van de server opgeven. Mocht de poort niet te bereiken zijn, ga dan nog eens naar de configuratie van de server kijken. Sommige Windows versies hebben overigens de telnet client default uit staan, [http://windows.microsoft.com/nl-NL/windows-vista/Telnet-frequently-asked-questions hier staat hoe je dat kunt veranderen].

Onderstaande gaat over Eekboek versie 2.02.00 en hoger. Mocht je een oudere versie van EekBoek gebruiken dan staan [[platform:Netwerkclient-oud|hier de juiste aanwijzingen]].

==== De eerste client, het aanmaken van de database ====
Na installatie van de eerste client kan de database worden aangemaakt. Het installeren van deze client kan eventueel ook op de server gebeuren, we gaan hier ervan uit dat het op de client gebeurt.

In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je moet invullen met welke server je wilt connecten, via welke TCP/IP poort en met welke usernaam (role) en password. In een normale netwerkinstallatie vul je het ip nummer of de naam van de databaseserver in, de poort laat je ongewijzigd ("--standaard--"), de role waarmee je toegang hebt tot de database, en het bijbehorende paswoord. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Waarschuwing: als je een administratie aanmaakt onder een naam die al bestaat in PostgreSQL, en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven.

==== De volgende clients ====
In de wizard kies je voor een nieuwe boekhouding. Wat voor boekhouding je kiest is niet erg van belang want we kiezen er later voor om hem niet aan te maken. Je kiest de postgresql database. Er wordt je om je username, paswoord, hostname en dergelijke gevraagd, die vul je in precies zoals hierboven beschreven. Dan komt er als laatste een pagina met een overzicht wat er gaat gebeuren. '''Daar vink je alles uit''' behalve "configuratiebestand". Er wordt nu een configuratiebestand aangemaakt maar geen database (die is er immers al) en je kunt inloggen op de bestaande database.

Waarschuwing: als je het boven genoemde uitvinken vergeet en je hebt de database aangemaakt zoals beschreven op deze pagina, dan zal de bestaande boekhouding worden overschreven.

In het CLI interface is er geen laatste pagina met een overzicht maar komen er verschillende vragen na elkaar. De vraag over het configuratiebestand beantwoord je met "ja". De vraag over de administratiebestanden en over de database beantwoord je met "nee". De laatste vraag over doorgaan beantwoord je uiteraard weer met "ja".

=== Resultaat ===
Het resultaat is een boekhouding waar verschillende mensen tegelijk op kunnen werken. De gegevens staan in een database op een server, die wellicht wat degelijker is en gebackupped wordt, en wie weet zelfs een UPS heeft tegen stroomuitval.

[1] Normaal maakt Eekboek de database zelf aan, daartoe moet de role het recht hebben om databases aan te maken. Er zijn echter situaties denkbaar waarin de beheerder van de database dit niet wil, hij/zij kan dan zelf databases aanmaken of zelfs de tabellen, en de role dit recht niet geven.

Platform:Ubuntu

2011-11-26T22:08:31Z

Pvdv:

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu Maverick (10.10) en Natty (11.04). Waarschijnlijk gaat het ook zo met 11.10 (reacties zijn welkom). Mocht je een wat oudere versie gebruiken, zoals Lucid (10.04, LTS) dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 10.04.

__FORCETOC__

===Installatie===
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.
sudo apt-get install eekboek-db-postgresql

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

===Opmerkingen===
In Ubuntu Natty (11.4) zat een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl). Dit probleem zou nu opgelost moeten zijn door een nieuwe versie van libwx-perl in natty-updates.

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Ubuntu

2011-06-14T21:28:10Z

Pvdv: Stuk verwijderd over crashende eekboek, opmerking verplaatst.

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu Maverick (10.10) en Natty (11.04). Mocht je een wat oudere versie gebruiken, zoals Karmic (9.10) of Lucid (10.04, LTS) dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 9.10.

__FORCETOC__

===Installatie===
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.
sudo apt-get install eekboek-db-postgresql

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

===Opmerkingen===
In Ubuntu Natty (11.4) zat een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl). Dit probleem zou nu opgelost moeten zijn door een nieuwe versie van libwx-perl in natty-updates.

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Ubuntu

2011-06-14T21:18:23Z

Pvdv: Natty-probleem opgelost

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu Maverick (10.10) en Natty (11.04). Mocht je een wat oudere versie gebruiken, zoals Karmic (9.10) of Lucid (10.04, LTS) dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 9.10.

In Ubuntu versie 11.4 zat een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl). Dit probleem zou nu opgelost moeten zijn. Zo niet, laat dit horen op de mailinglijst.

__FORCETOC__

===Installatie===
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.
sudo apt-get install eekboek-db-postgresql

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Crasht Eekboek?===
Mocht de Eekboek wizard correct starten maar na het aanmaken van een boekhouding crashen dan heb je wellicht nog een oude versie van libwx-perl die Ubuntu met deze versie van Ubuntu geleverd heeft. De correcte versie is "0.9702-1build0.1", de verkeerde versie is "0.9702-1". Je kunt controleren welke versie van libwx-perl je hebt met:
aptitude show libwx-perl
Je kunt de nieuwe versie installeren met:
apt-get install libwx-perl

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:Ubuntu

2011-06-08T10:22:34Z

Pvdv: Verhaaltje over problemen met Ubuntu 11.4

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu Maverick (10.10). Mocht je een wat oudere versie gebruiken, zoals Karmic (9.10) of Lucid (10.04, LTS) dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 9.10.

In Ubuntu versie 11.4 zit een fout in een benodigd pakket voor de grafische versie van Eekboek (libwx-perl, zie deze bug: https://bugs.launchpad.net/ubuntu/+source/libwx-perl/+bug/754513 ) Waarschijnlijk wordt dit probleem binnenkort opgelost door Ubuntu met een update. In de bugmelding staat ook een noodoplossing d.m.v. CPAN. Johan heeft in de mailinglijst voorgesteld eventueel de binairy installer te gebruiken, maar die is nog wel beta, in die binary installer zit een correcte libwxperl. Vraag eventueel in de mailinglijst. De console versie van Eekboek doet het zonder problemen in Ubuntu 11.4.

__FORCETOC__

===Installatie===
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.
sudo apt-get install eekboek-db-postgresql

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Crasht Eekboek?===
Mocht de Eekboek wizard correct starten maar na het aanmaken van een boekhouding crashen dan heb je wellicht nog een oude versie van libwx-perl die Ubuntu met deze versie van Ubuntu geleverd heeft. De correcte versie is "0.9702-1build0.1", de verkeerde versie is "0.9702-1". Je kunt controleren welke versie van libwx-perl je hebt met:
aptitude show libwx-perl
Je kunt de nieuwe versie installeren met:
apt-get install libwx-perl

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Platform:UbuntuLTS

2011-03-27T16:45:25Z

Pvdv: /* Het installeren van de pakketten */

==== Inleiding ====

Deze handleiding is geschikt voor Ubuntu Karmic (9.10) en Lucid (10.04, LTS).

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian). Mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden.

==== Het installeren van de pakketten ====

In deze versies van Ubuntu zit een verouderde versie van Eekboek zonder grafische user interface. We raden je aan om de nieuwere versie te installeren van Debian.

Verder moet het Ubuntu "universe" repository moet gebruikt kunnen worden, zie hier voor meer informatie: https://help.ubuntu.com/community/Repositories/Ubuntu

# eerst enkele pakketten installeren
sudo apt-get install libwx-perl libwx-perl-processstream-perl libcarp-assert-perl
sudo apt-get install libarchive-zip-perl libdbd-sqlite3-perl libdbi-perl libnet-daemon-perl libplrpc-perl
sudo apt-get install libterm-readline-gnu-perl

# tijdelijke directory aanmaken:
mkdir /tmp/kanweg; cd /tmp/kanweg

# ophalen van Debian pakketten, dit is de basis:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.00.03-1_all.deb

# dit heb je nodig om de grafische versie te kunnen draaien:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.00.03-1_all.deb

# alleen als je PostgreSQL als database wilt gebruiken heb je deze twee regels nodig:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.00.03-1_all.deb
sudo apt-get install libdbd-pg-perl

# alles installeren:
sudo dpkg -i *

# opruimen:
cd .. ; rm -r kanweg

==== Eekboek starten ====

Daarna kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

Indien je gebruik wilt maken van de console-versie, tik dan "ebshell" in in de shell, er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

Eekboek met GUI installeren onder Debian

2011-03-27T16:41:38Z

Pvdv:

Het volgende is getest op Debian Lenny. Het is alleen bruikbaar voor de platformen i386 en amd64.

Onderstaande moet als root.
# het installeren van de afhankelijkheden voor het pakket eekboek:
apt-get install libarchive-zip-perl libcarp-assert-perl libdbd-sqlite3-perl libdbi-perl libterm-readline-gnu-perl perl

# het installeren van de afhankelijkheden voor het pakket libwx-perl:
apt-get install libc6 libgcc1 libstdc++6 libwxbase2.8-0 libwxgtk2.8-0 perl perl-base

# het installeren van de afhankelijkheden voor het pakket libalien-wxwidgets-perl:
apt-get install libmodule-pluggable-perl libwxgtk2.8-dev perl

# Tijdelijke directory aanmaken:
cd /tmp; mkdir kanweg; cd kanweg

# alleen voor i386:
wget http://www.vandervlis.nl/libwx-perl/libalien-wxwidgets-perl_0.44+dfsg-1_i386.deb
wget http://www.vandervlis.nl/libwx-perl/libwx-perl_0.84-1~bpo50+1_i386.deb

# alleen voor amd64:
wget http://www.vandervlis.nl/libwx-perl/libalien-wxwidgets-perl_0.44+dfsg-1_amd64.deb
wget http://www.vandervlis.nl/libwx-perl/libwx-perl_0.84-1~bpo50+1_amd64.deb

# weer voor zowel 32-bits als 64-bits:
wget http://www.vandervlis.nl/libwx-perl/libwx-perl-processstream-perl_0.24-1_all.deb

# ophalen van Debian-pakketten uit unstable:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek_2.00.03-1_all.deb
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-gui_2.00.03-1_all.deb

# alleen als je PostgreSQL als database wilt gebruiken heb je deze twee nodig:
wget http://ftp.nl.debian.org/debian/pool/main/e/eekboek/eekboek-db-postgresql_2.00.03-1_all.deb
apt-get install libdbd-pg-perl

# alles installeren:
dpkg -i *

# pakketten wissen, ze zijn immers geinstalleerd:
cd .. ; rm -r kanweg

Daarna kun je als gewone gebruiker de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" of "Applications | Office | EekBoek.

Kritiek en bedankjes zijn welkom op paul@vandervlis.nl.

Community support

2011-02-06T20:49:23Z

Pvdv: /* Inleiding */

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

==== Inleiding ====
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten (van voor 3 februari 2011) zijn op dit moment alleen te doorzoeken via [http://sourceforge.net/search/?group_id=154512&type_of_search=mlists de mailinglist archieven van SourceForge].

==== Support via een mailinglist ====
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een forum ====
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een nieuwsgroep ====
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-06T20:47:36Z

Pvdv: /* Inleiding */

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

==== Inleiding ====
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten (van voor 3 februari 2011) zijn op dit moment alleen te doorzoeken via [http://sourceforge.net/search/?group_id=154512&type_of_search=mlists de mailinglist archieven van SourceForge]. Misschien veranderd dit nog.

==== Support via een mailinglist ====
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een forum ====
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een nieuwsgroep ====
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-06T20:45:29Z

Pvdv: /* Inleiding */

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

==== Inleiding ====
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten (van voor 3 februari 2011) zijn op dit moment alleen te bekijken via [https://sourceforge.net/mail/?group_id=154512 de mailinglist archieven van SourceForge]. Misschien veranderd dit nog.

==== Support via een mailinglist ====
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een forum ====
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een nieuwsgroep ====
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-06T20:42:19Z

Pvdv: /* Inleiding */

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

==== Inleiding ====
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten (van voor 3 februari 2011) zijn op dit moment alleen te bekijken via [https://sourceforge.net/projects/eekboek/support de mailinglist archieven van SourceForge]. Misschien veranderd dit nog.

==== Support via een mailinglist ====
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een forum ====
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een nieuwsgroep ====
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-06T20:41:28Z

Pvdv:

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

==== Inleiding ====
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten (van voor februari 2011) zijn op dit moment alleen te bekijken via [https://sourceforge.net/projects/eekboek/support de mailinglist archieven van SourceForge]. Misschien veranderd dit nog.

==== Support via een mailinglist ====
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een forum ====
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een nieuwsgroep ====
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Overleg:Community support

2011-02-06T20:32:57Z

Pvdv:

Misschien is het goed om duidelijk te maken dat de mailing lists, forums en newsgroepen dezelfde informatiestromen zijn .

Paul: ik denk dat ik dat nu gedaan heb.

Community support

2011-02-06T20:31:55Z

Pvdv:

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

==== Inleiding ====
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten zijn op dit moment nog niet te vinden op het forum en in de nieuwsgroep, wellicht komt dit nog.

==== Support via een mailinglist ====
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een forum ====
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

==== Support via een nieuwsgroep ====
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-06T20:30:05Z

Pvdv: /* Inleiding */

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

=== Inleiding ===
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep. Oude berichten zijn op dit moment nog niet te vinden op het forum en in de nieuwsgroep, wellicht komt dit nog.

=== Support via een mailinglist ===
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

=== Support via een forum ===
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

=== Support via een nieuwsgroep ===
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-06T20:28:31Z

Pvdv:

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

=== Inleiding ===
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep. De berichten in de deze drie media zijn dezelfde. Als je dus b.v. iets post op het forum verschijnt dat bericht ook in de mailinglijst en in de nieuwsgroep.

=== Support via een mailinglist ===
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

=== Support via een forum ===
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurt naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

=== Support via een nieuwsgroep ===
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Community support

2011-02-05T17:23:05Z

Pvdv: Forums en nieuwsgroepen toegevoegd.

Heeft u de [http://www.eekboek.nl/docs/ officiële documentatie] en [[Meer_documentatie_en_gebruikstips|deze wiki documentatie]] al bekeken?

=== Inleiding ===
Support is verkrijgbaar via een mailinglist, forum of nieuwsgroep.

=== Support via een mailinglist ===
* [https://lists.sourceforge.net/lists/listinfo/eekboek-users EekBoek gebruikers mailing list] Hier wisselen gebruikers ervaring uit.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-announce EekBoek aankondigingen mailing list] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [https://lists.sourceforge.net/lists/listinfo/eekboek-devel EekBoek development mailing list] Voor mensen die mee willen werken aan de ontwikkeling.

=== Support via een forum ===
Berichten versturen kan via "--Action--" knop rechts, kies daar voor "post". De eerste keer dat je een bericht verstuurd naar een forum moet je een e-mail beantwoorden, dit is om spam te voorkomen.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.user EekBoek gebruikers forum] Hier wisselen gebruikers ervaring uit.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.announce EekBoek aankondigingen forum] Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* [http://dir.gmane.org/gmane.comp.finance.eekboek.devel EekBoek development forum] Voor mensen die mee willen werken aan de ontwikkeling.

=== Support via een nieuwsgroep ===
De nieuwsgroepen zijn in elk geval bereikbaar via news.gmane.org.
* gmane.comp.finance.eekboek.user EekBoek gebruikers nieuwsgroep. Hier wisselen gebruikers ervaring uit.
* gmane.comp.finance.eekboek.announce EekBoek aankondigingen nieuwsgroep. Geeft meldingen bij nieuwe versies en dergelijke, low volume.
* gmane.comp.finance.eekboek.devel EekBoek development mailing list. Voor mensen die mee willen werken aan de ontwikkeling.

Eekboek met PostgreSQL op localhost

2011-01-26T08:19:47Z

Pvdv: /* Database role aanmaken */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma [http://www.pgadmin.org/ PGadmin3], wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken.

Het gemakkelijkste is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bij problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

En bij een Windows systeem dit:
host all all 127.0.0.1/32 md5

Dit zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Bij ieder operating systeem en versie van PostgreSQL staat het weer ergens anders, dus ik raad je aan er even naar te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden].

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-26T08:05:43Z

Pvdv:

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma [http://www.pgadmin.org/ PGadmin3], wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het gemakkelijkste is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bij problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

En bij een Windows systeem dit:
host all all 127.0.0.1/32 md5

Dit zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Bij ieder operating systeem en versie van PostgreSQL staat het weer ergens anders, dus ik raad je aan er even naar te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden].

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-25T10:45:56Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

En bij een Windows systeem dit:
host all all 127.0.0.1/32 md5

Dit zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Bij ieder operating systeem en versie van PostgreSQL staat het weer ergens anders, dus ik raad je aan er even naar te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden].

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-25T10:40:01Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Deze regel zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in /etc/postgresql/versie/main/, bij Windows in C:\Program Files\PostgreSQL\versie\data\. Maar zoeken is wellicht ook een oplossing. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T23:14:34Z

Pvdv: /* PostgreSQL */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies. De installatie spreekt vrij voor zich, ik hield de defaults aan.

Onder Windows kwam ik aan het eind nog een vraag tegen over het starten van "Stack Builder" waarmee je verdere zaken kunt downloaden. Omdat dat niet nodig was heb ik het weg geklikt.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Deze regel zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:58:10Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat er bij een Linux/Unix systeem in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Deze regel zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:56:32Z

Pvdv: /* Nieuwe versie van Eekboek configureren */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt eigenlijk alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. Indien de naam van de role anders is als je gebruikersnaam, dan moet je deze wel opgeven. Bij het afronden van de wizard wordt de database op de server aangemaakt.

Stanaard maakt Eekboek een locale connectie via Unix sockets. Bij Windows wordt TCP op poort 5432 gebruikt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Deze regel zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel net iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:51:50Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Deze regel zorgt ervoor dat je vanaf localhost kunt inloggen met een geldige username en paswoord.

Bij Debian Lenny is deze regel net iets anders, waardoor je alleen kunt inloggen indien de role die gebruikt wordt dezelfde naam heeft als de username van de gebruiker. In dat geval is er geen paswoord nodig. Bovenstaande werkt wel bij Debian Squeeze en bij actuele versies van Ubuntu.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:47:07Z

Pvdv: /* Met PGadmin3 */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGadmin3 meegeleverd waarmee je een user kunt aanmaken. Eerst moet je als user "postgres" verbinden met postgresql op localhost, ik deed dit door op "servers" te klikken, toen kwam "postgresql 9.0 op localhost" te voorschijn en daarop heb ik geklikt. Om te connecten heb je een paswoord nodig voor de user postgres die je tijdens de installatie hebt opgegeven.

In de versie die ik bekeken heb kon ik hier een user aanmaken:
edit | new object | new login role

Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Dit is ook zo bij Debian Squeeze en actuele versies van Ubuntu, maar bij Debian Lenny is de regel net iets anders, waardoor het alleen werkt indien de role die gebruikt wordt ook echt hetzelfde is als de username. In dat geval is er geen paswoord nodig.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:37:49Z

Pvdv: /* Op de commandline */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als
createuser -P piet
* Dit vraagt eerst om het wachtwoord, kies een wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Dit is ook zo bij Debian Squeeze en actuele versies van Ubuntu, maar bij Debian Lenny is de regel net iets anders, waardoor het alleen werkt indien de role die gebruikt wordt ook echt hetzelfde is als de username. In dat geval is er geen paswoord nodig.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:36:49Z

Pvdv: /* Op de commandline */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat met een commando als "createuser -P piet". Hij vraagt eerst om het wachtwoord.
* Dan of de nieuwe role een superuser moet zijn, daarop antwoord je "nee".
* Dan of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja".
* Dan of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee".

Meer informatie over het "createuser" commando is [http://www.postgresql.org/docs/8.4/static/app-createuser.html hier te vinden].

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Dit is ook zo bij Debian Squeeze en actuele versies van Ubuntu, maar bij Debian Lenny is de regel net iets anders, waardoor het alleen werkt indien de role die gebruikt wordt ook echt hetzelfde is als de username. In dat geval is er geen paswoord nodig.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:28:32Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat hier met een commando als "createuser piet". Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja". Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Hier is meer informatie te vinden over het "createuser" commando: http://www.postgresql.org/docs/8.4/static/app-createuser.html

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Dit is ook zo bij Debian Squeeze en actuele versies van Ubuntu, maar bij Debian Lenny is de regel net iets anders, waardoor het alleen werkt indien de role die gebruikt wordt ook echt hetzelfde is als de username. In dat geval is er geen paswoord nodig.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken. Meer informatie over pg_hba.conf is [http://www.postgresql.org/docs/8.4/interactive/auth-pg-hba-conf.html hier te vinden]

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:26:49Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat hier met een commando als "createuser piet". Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja". Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Hier is meer informatie te vinden over het "createuser" commando: http://www.postgresql.org/docs/8.4/static/app-createuser.html

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand:
local all all ident

Dit is ook zo bij Debian Squeeze en actuele versies van Ubuntu, maar bij Debian Lenny is de regel net iets anders, waardoor het alleen werkt indien de role die gebruikt wordt ook echt hetzelfde is als de username. In dat geval is er geen paswoord nodig.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken.

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Eekboek met PostgreSQL op localhost

2011-01-24T22:25:29Z

Pvdv: /* Bekende problemen */

Deze handleiding gaat over de stand-alone installatie van Eekboek met PostgreSQL op een PC. De handleiding is niet specifiek voor een bepaald platform en is daarom enigszins algemeen. Deze handleiding is nog in ontwikkeling en zeker niet volledig. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

=== PostgreSQL ===
PostgreSQL wordt niet standaard bij EekBoek geleverd, maar het zit wel in de meeste Linux distributies en voor de meeste andere platformen is het gratis te downloaden via http://www.postgresql.org/ . Er zijn Windows, Mac, Linux, FreeBSD en Solaris versies.

=== PGadmin3 ===
Daarnaast is er een grafisch programma "PGadmin3", wat op sommige platformen (b.v. Windows, Mac) automatisch wordt meegeinstalleerd met PostgreSQL, op andere platformen is het een keuze (b.v. Linux). Voor Linux is het niet nodig dit programma te installeren, maar uiteraard kan het wel. Het is daar echter niet altijd zomaar "klaar voor gebruik".

=== Database role aanmaken ===
In PostgreSQL moet een "role" aangemaakt worden, dat is een user in PostgreSQL termen. Dit moet gedaan worden door de administratieve user van PostgreSQL, normaal heet deze "postgres". Onder Linux kun je dit het beste op de commandline doen omdat de gebruiker postgres daar meestal geen paswoord heeft, onder Windows kun je het beste PGadmin3 gebruiken. Wat je op de Mac het beste kunt doen weet ik niet, maar ik hoor graag ervaringen.

Het meest gemakkelijke is om een role aan te maken met dezelfde naam als je login-naam. Je kunt ook kiezen voor een meer generieke naam, b.v. "ebuser", een naam die we ook gebruiken in de netwerkinstallatie. Default wordt uitgegaan van je login-naam, een andere naam moet specifiek worden opgegeven in Eekboek.

==== Op de commandline ====
In Linux/Unix kun je op de commandline user "postgres" worden met een commando als "sudo su postgres" of "su progres". Het aanmaken van de role gaat hier met een commando als "createuser piet". Hij vraagt of de nieuwe role een superuser moet zijn, daarop antwoord je "nee". Hij vraagt of de nieuwe role nieuwe databases mag aanmaken, daarop antwoord je "ja". Als laatste vraagt hij of de nieuwe role nieuwe roles mag aanmaken, daarop antwoord je "nee". Uiteraard vraagt hij nog om een paswoord voor de nieuwe user en dan is de role klaar. Hier is meer informatie te vinden over het "createuser" commando: http://www.postgresql.org/docs/8.4/static/app-createuser.html

==== Met PGadmin3 ====
Bij Windows/Mac wordt er een programma PGAdmin meegeleverd waarmee je gemakkelijk een user kunt aanmaken nadat je verbonden bent als user "postgres" met postgresql op localhost. Je moet "edit | new object | new login role" doen. Let er op dat de nieuwe user databases moet kunnen aanmaken, dat kun je in een tabblad instellen.

=== Eekboek configureren ===
Allereerst moet Eekboek worden geinstalleerd, zie daarvoor de platform specifieke pagina's op deze wiki. De nieuwe versie van Eekboek die op dit moment in GIT zit kan op een comfortabeler manier worden ingsteld dan de oudere versie. Daarom twee mogelijkheden. Waarschuwing: als je een administratie aanmaakt waarvan de naam al bestaat in PostgreSQL, en je hebt de database ingericht zoals op deze pagina beschreven, dan wordt de oude administratie overschreven.

==== Nieuwe versie van Eekboek configureren ====
In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Je kunt alle instellingen op "--standaard--" laten staan, afgezien van het paswoord. De standaard host is localhost, de standaard username is je loginnaam, standaard worden er Unix sockets gebruikt als het OS dat ondersteund (dus geen poort), en anders (bij Windows) TCP op poort 5432. Bij het afronden van de wizard wordt de database op de server aangemaakt.

==== Oudere versie van Eekboek configureren ====
Na installatie van Eekboek (zie platform specifieke pagina's) kan Eekboek worden gestart. In de wizard geef je aan een nieuwe database te willen maken van het type "postgresql". Het aanmaken van de administratie zal normaal mislukken vanwege het ontbreken van het paswoord. Hier moeten de gegevens met de hand in het configfile worden gezet.

Normaal worden de configfiles opgeslagen in een directory /home/user/.eekboek/admdir/naam/eekboek.conf of C:\documents and settings\user\eekboek\admdir\naam\eekboek.conf (zoek eventueel op "admdir"). Hierin moet dan iets dergelijks komen te staan:

[database]
name = boekhouding_2010
driver = postgres
user = piet
password = eekboek

De regel met "user" kan ook worden weggelaten.

Hierna kan de database vanuit deze directory op de commandline worden aangemaakt en ingericht met:
ebshell --init

=== Bekende problemen ===

Bovenstaande setup gaat er van uit dat in het bestand pg_hba.conf van PostgreSQL een regel staat als onderstaand, normalerwijze is dat ook het geval:
local all all ident

Dit is ook zo bij Debian Squeeze en actuele versies van Ubuntu, maar bij Debian Lenny is de regel net iets anders, waardoor het alleen werkt indien de role die gebruikt wordt ook echt hetzelfde is als de username. In dat geval is er geen paswoord nodig.

Uiteraard is het mogelijk pg_hba.conf aan te passen. Het is op Linux/Unix systemen te vinden in een subdirectory van /etc/postgresql/. Op andere systemen is het wellicht verstandig even naar het bestand te zoeken.

=== Resultaat ===
Het resultaat is een Eekboek die zijn gegevens opslaat in PostgreSQL.

Platform:Ubuntu

2011-01-23T12:53:09Z

Pvdv:

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu Maverick (10.10). Mocht je een wat oudere versie gebruiken, zoals Karmic (9.10) of Lucid (10.04, LTS) dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 9.10.
__FORCETOC__

===Installatie===
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.
sudo apt-get install eekboek-db-postgresql

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Crasht Eekboek?===
Mocht de Eekboek wizard correct starten maar na het aanmaken van een boekhouding crashen dan heb je wellicht nog een oude versie van libwx-perl die Ubuntu met deze versie van Ubuntu geleverd heeft. De correcte versie is "0.9702-1build0.1", de verkeerde versie is "0.9702-1". Je kunt controleren welke versie van libwx-perl je hebt met:
aptitude show libwx-perl
Je kunt de nieuwe versie installeren met:
apt-get install libwx-perl

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.

GitRepository

2011-01-22T20:48:32Z

Pvdv:

=== EekBoek opzetten van uit de Git repository===

De ontwikkelomgeving van EekBoek is gehuisvest in een git repository op [http://eekboek.git.sourceforge.net/git/gitweb-index.cgi SourceForge]. Deze repository bevat naast de sources ook hulpmiddelen waarmee de sources worden onderhouden. '''Veel van deze hulpmiddelen zijn ter informatie en verder niet gedocumenteerd en kunnen zonder vooraankondiging wijzigen.''' De commando's op deze pagina dienen als gewone user te worden uitgevoerd.

U kunt een lokale kopie maken van de repository met het volgende commando:
git clone git://eekboek.git.sourceforge.net/gitroot/eekboek/eekboek

Om EekBoek te kunnen bouwen vanuit de ontwikkelomgeving moet eerst de volgende stap worden uitgevoerd:
cd eekboek
make bootstrap

'''Dit vereist dat u de GNU versie van het programma 'make' gebruikt.''' Heeft u dit programma niet, dan kunt u proberen of dit werkt:
make -f GNUmakefile bootstrap

Nadat de bootstrap is uitgevoerd, kunt u EekBoek gewoon bouwen zoals beschreven in [[EekBoek_installeren_vanaf_source]], dus:
perl Build.PL
./Build
./Build test

U kunt nu de nieuwe versie testen met:
blib/script/ebshell

Of de GUI versie met:
blib/script/ebwxshell

Om in een later stadium een nieuwe versie op te halen, dient u naar de "eekboek" directory te gaan die git de eerste keer heeft aangemaakt, en dan de volgende commando's uit te voeren. "./Build test" is wellicht niet altijd nodig.
git pull
make bootstrap
perl Build.PL
./Build
./Build test

'''Het is nog niet mogelijk om een EekBoek source distributie aan te maken omdat de daarvoor benodigde documentatiebestanden elders staan.'''

Platform:Ubuntu

2011-01-22T13:16:51Z

Pvdv:

Deze handleiding gaat over het installeren van Eekboek onder Ubuntu Maverick (10.10). Mocht je een wat oudere versie gebruiken, zoals Karmic (9.10) of Lucid (10.04, LTS) dan raad ik je aan om deze handleiding te gebruiken: [[Platform:UbuntuLTS]]. EekBoek wordt ondersteund vanaf Ubuntu versie 9.10.
__FORCETOC__

===Installatie===
Voor de console versie van eekboek is het pakket "eekboek" nodig:
sudo apt-get install eekboek
Indien je de grafische versie wilt gebruiken, installeer dan het pakket "eekboek-gui". Dit pakket is afhankelijk van bovengenoemde pakket "eekboek" en zal dat dus ook installeren:
sudo apt-get install eekboek-gui
Mocht je [http://www.postgresql.org PostgreSQL] willen gebruiken als database, dan heb je ook het pakket "eekboek-db-postgresql" nodig. Voor het gebruik van SQLite worden de benodigde pakketten al automatisch geinstalleerd met EekBoek.
sudo apt-get install eekboek-db-postgresql

Op de pagina [[Platform:Netwerk]] staat een handleiding voor installatie van PostgreSQL voor multi-user gebruik.

===Probleem bij deze versie van Ubuntu===
Bij deze versie van Ubuntu werd een defect libwx-perl pakket geleverd, dit probleem is echter nu opgelost doordat Ubuntu een nieuwe versie van libwx-perl levert.

===EekBoek starten===
Indien alleen het pakket "eekboek" is geinstalleerd, tik dan "ebshell" in in de shell. Er start dan een wizard voor het aanmaken van een boekhouding. Indien je in een directory staat met daarin een boekhouding, dan zal die boekhouding worden gestart.

Indien ook het pakket "eekboek-gui" is geinstalleerd, kun je de grafische eekboek starten via "Toepassingen | Kantoor | EekBoek" (of "Applications | Office | EekBoek").

===Verwijderen van EekBoek===
Bij een herinstallatie van EekBoek of om EekBoek te verwijderen, gebruik dan de volgende commando's:
sudo apt-get remove eekboek
sudo apt-get remove eekboek-gui

Zelf ben ik geen Ubuntu gebruiker (ik gebruik Debian), mocht je het onderhouden van deze manual willen overnemen dan zou ik dat prettig vinden. Kritiek en succesverhalen zijn welkom op paul@vandervlis.nl.