Installatie - LimeSurvey CE
From LimeSurvey Manual
Algemeen
Het LimeSurvey-project biedt twee opties om LimeSurvey te installeren:
- Op een webserver: volg de instructies op deze pagina
- Op je eigen PC.
Hiermee kun je lokaal enquêtes maken (vanwege de reactiesnelheid, of om ze vooraf te ontwikkelen/testen) om ze later naar een webserver te uploaden. Hiervoor is er een download gemaakt, waarin een webserver, de database en de applicatie zitten. Bekijk hier de instructies.
Controleren of je LimeSurvey op je website kunt gebruiken
Controleer of de instellingen op de server voldoen aan de volgende eisen.
Bij de installatie worden de systeemvereisten gecontroleerd!De minimale set vereisten voor LimeSurvey 6.x:
- Minimaal 250 MB schijfruimte.
- MariaDB 10.3.38 of hoger OR' MySQL 8 of hoger 'OR Microsoft SQL Server 2008 of hoger OR Postgres 12 of hoger.
- Vereisten voor PHP-versie:
- LS 6.x van PHP 7.4.x tot 8.x
- LS 5.x van PHP 7.2.5 naar 8.0.x
- LS 3.x van PHP 5.5.9 naar 7.4.x
- php.ini `short_open_tag` instelling moet zijn ingesteld op `ON`
- De volgende PHP-modules/bibliotheken moeten zijn ingeschakeld:
- mbstring (Multibyte String Functions) extensie bibliotheek.
- PDO-databasestuurprogramma voor MySQL (pdo_mysql of pdo_mysqli) of Postgres (pdo_pgsql) of MSSQL (pdo_sqlsrv voor Windows en pdo_dblib voor Linux).
- We gaan er in het algemeen ook van uit dat alle PHP-standaardbibliotheken zijn ingeschakeld
- hash
- sessie
- openssl of mcrypt
- bestandsinfo
- SimpleXML
- etc …
Optionele PHP Extensies:
- GD-Library met FreeType support voor captcha's of grafieken in de statistieken of om afbeeldingen te uploaden in de HTML-editor . (zie ook: PHP GD-Library extensie)
- IMAP (redelijk standaard) voor de Niet verzonden e-mail. (zie ook: PHP IMAP extensie)
- LDAP voor het importeren van deelnemers aan enquêtes via LDAP. zie ook: PHP LDAP
- Zip (redelijk standaard) voor het uploaden, importeren van een zip-archief, en exporteren naar excel. (zie ook: PHP Zip extensie)
- Zlib (redelijk standaard) voor de ComfortUpdate (zie ook: PHP Zlib extensie)
In de meeste gevallen kan je webhoster je helpen om deze componenten te activeren.
Als je LimeSurvey op een Microsoft IIS server wilt draaien, kijk dan bij Installatie op XP met IIS.
Webbrowser compatibiliteit
Bij het invullen van de enquête ondersteunen we IE11 (geen intranet-mode) en alle nieuwere vergelijkbare webbrowsers zoals Firefox, Chrome, Opera, ... met JavaScript ingeschakeld.
Voor het beheergedeelte ondersteunen we Edge en alle vergelijkbare webbrowsers zoals Firefox, Chrome, Opera, ... met JavaScript ingeschakeld. We ondersteunen in dit deel geen enkele versie van Internet Explorer!
Schermgrootte
We ondersteunen alle gebruikelijke schermgroottes voor het afnemen van enquêtes vanaf (360px x 640px en hoger). Voor LimeSurvey-beheer is de minimale schermresolutie 1280px x 1024px.
Hosting van LimeSurvey
LimeSurvey werkt met de meeste webhosters die PHP en MySQL leveren. Mocht je een turn-key oplossing willen hebben, bekijk dan LimeSurvey Cloud, of onze Lijst van LimeSurvey-compatible hosters.
Download LimeSurvey
Download de laatste stabiele versie van de LimeSurvey. Er zijn zip, gzip, bz2 en 7zip-bestanden beschikbaar. Sla de download op.
Uitpakken van LimeSurvey-download
Pak het bestand uit in een map. Gebruik hiervoor je favoriete software. Check bij het uitpakken dat je de mapstructuur mee uitpakt (gebeurt meestal vanzelf). Het pad mag geen haakjes, maar wel spaties bevatten.
Informatie over de server verzamelen
Noteer de volgende zaken voordat je LimeSurvey gaat installeren op de webserver:
- Het webadres waar de scripts bereikbaar zijn(voorbeeld: http://mijn.domein.nl/limesurvey).
- De fysieke locatie waar de scripts staan (voorbeeld: /home/usr/htdocs/limesurvey).
- De IP/netlocatie van de databaseserver (voorbeeld: localhost)
- De poort waarop de databaseserver zit, als dat een niet-standaardpoort is.
- Naam en wachtwoord van de databaseserver.
- De meeste webhosters laten een script niet een database aanmaken op de server. Maak in dat geval zelf een database aan (bijvoorbeeld limesurvey)
De bestanden uploaden op de webserver
Met behulp van je favoriete FTP programma (bijv. FileZilla) maak je verbinding met de webserver. Maak hierin een directory of map aan. Check of je de bestanden "in binaire modus" gaat uploaden (instellingen in het FTP programma). Als je in ASCII-mode gaat uploaden zullen plaatjes niet werken, en mogelijk ook de code niet. Upload de bestanden zoals ze in de mapstructuur staan.
Maprechten
Om de scripts goed te laten werken moeten de rechten op de directories goed staan: dat geldt vooral bij Linux/*nix-systemen.
- De "/limesurvey/tmp" directory en alle onderliggende directories en bestanden worden gebruikt voor het importeren en uploads, en moeten dus een "Lees & Schrijf"-permissie hebben.
- De "/limesurvey/upload/" directory en alle onderliggende directories en bestanden worden ook gebruikt voor uploads, en moeten dus een "Lees & Schrijf"-permissie hebben.
- De "/limesurvey/application/config/" directory moet ook een "Lees & Schrijf" permissie hebben.
- Alle overige directories kunnen af met een "Alleen lezen"-permissie. Dit geldt vooral voor de bestanden in de "/limesurvey/admin" directory.
Op Linux-systemen kun je afhankelijk van de webserver de rechten instellen. Voor Apache HTTPD op CentOS gebruik je chmod -R 755 <directory> ; chown -R apache <directory>. Iedereen heeft dan leesrechten, en de webserver schrijfrechten. Lees voor meer informatie over rechten op Linux https://www.linux.com/learn/tutorials/309527-understanding-linux-file-permissions.
Een databasegebruiker aanmaken
LimeSurvey zal een database inclusief de structuur aanmaken. Daarvoor heeft het een gebruikersnaam en wachtwoord nodig van een database gebruiker. We raden aan een gebruiker aan te maken met de volgende rechten:
- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER
- Microsoft SQL Server: "Onbekend, indien u dit weet, vult dit dan a.u.b. hier toe".
Het installatiescript starten
Open je favoriete browser en ga naar "voorbeeld.org/limesurvey/admin". Als alles goed staat, start de installer nu. Volg de instructies: er wordt je gevraagd of je de database wilt laten aanmaken. Daarna zal LimeSurvey de databasestructuur gaan aanmaken.
Het beheerscript voor het eerst opstarten
Nadat de installer gedraaid heeft ben je klaar! Ga in je browser naar het administratie-gedeelte van LimeSurvey. Als je "limesurvey" als mapnaam hebt gebruikt, wordt dat iets als "http://mijn.domein.nl/limesurvey/admin".
Nu zou je een loginscherm moeten zien. De standaardinloggevens (als je die niet zelf aangepast hebt tijdens de installatie):
Gebruikersnaam: admin
Wachtwoord: password
Daarna word je gevraagd om het wachtwoord te wijzigen. Veel plezier!
Verdere configuratie
Caching
LimeSurvey maakt standaard gebruik van de Yii-bestandscache, maar dit kan worden gewijzigd. Mogelijke andere caches zijn:
- Memcached
- Redis
- WinCache
- XCache
Raadpleeg de documentatie bij Yii.
Vanaf LimeSurvey 4.0.0 heb je ook de mogelijkheid om berekeningen te cachen in ExpressionScript. Dit kan de snelheid verbeteren bij een meer complexe enquête. Als je de emcache wilt inschakelen, voeg dan onderstaande regel toe aan het config.php-bestand (componentsarray):
'emcache' => array('class' => 'CFileCache'),
Net als bij Yii-cache kun je een andere cache gebruiken.
De emcache is niet compatibel met gerandomiseerde enquêtes en wordt in dergelijke gevallen automatisch uitgeschakeld.
Problemen
Zoals alle applicaties werkt het altijd als je de instructies maar volgt. Maar soms ook niet, de redenen zijn te divers om er hier op in te gaan. Bekijk daarom bij problemen eerst even de Installatie FAQ. Mocht daar het antwoord niet staan, plaats dan je probleem en de foutmelding(en) in het LimeSurvey forum, open (alleen voor klanten die LimeSurvey Cloud gebruiken) een support ticket, of ga naar het Discord channel.