Asennus - LimeSurvey CE

Huomautus: Nämä asennusohjeet koskevat LimeSurveyn nykyistä versiota. Vanhemmat ohjeet versiolle 1.92 löytyvät täältä ja päivitysohjeet täältä. Jos haluat asentaa LimeSurveyn komentoriviltä, katso Asennus komentorivikäyttöliittymällä (CLI).

Varmista, että voit käyttää LimeSurveyta verkkosivustollasi

Varmista, että palvelimesi täyttää seuraavat vaatimukset.

Vähimmäisvaatimukset tarkistetaan myös asennuksen aikana!

LimeSurveyn vähimmäisvaatimukset:

• Vähintään 500 Mt levytilaa (pelkkä purettu LimeSurvey 7.x -paketti vie noin 380 Mt) sekä tilaa lataamillesi tiedostoille ja kyselyiden tiedoille.
• MariaDB 10.3.38 tai uudempi TAI MySQL 8 tai uudempi TAI Microsoft SQL Server 2019 tai uudempi TAI Postgres 14 tai uudempi.
• PHP-version vaatimukset:
  • LS 7.x vaatii PHP 8.1.29:n tai uudemman (testattu PHP 8.5.x:ään asti)
  • LS 6.x vaatii PHP 8.1.x–8.3.x
  • LS 5.x vaatii PHP 7.2.5–8.0.x
  • LS 3.x vaatii PHP 5.5.9–7.4.x
• PHP:n memory_limit-asetuksen arvon tulee olla vähintään 128 Mt.
• Seuraavien PHP-moduulien/kirjastojen tulee olla käytössä:
  • mbstring (Multibyte String Functions) -laajennuskirjasto.
  • PDO-tietokantaohjain MySQL/MariaDB:lle (pdo_mysql), Postgresille (pdo_pgsql) tai MSSQL:lle (pdo_sqlsrv Windowsille ja pdo_dblib Linuxille).
  • GD - katso PHP GD-Library Extension -dokumentaatio
  • Zip - katso PHP Zip Extension -dokumentaatio
  • Zlib - katso PHP Zlib Extension -dokumentaatio
  • Curl-kirjasto
  • fileinfo
  • JSON
  • Lisäksi oletamme yleisesti, että kaikki PHP:n oletuskirjastot ovat käytössä, esimerkiksi:
    • ctype
    • filter
    • hash
    • openssl
    • session
    • SimpleXML
    • jne. …
• LimeSurvey 7.x:ää varten: URL-muodoksi tulee asettaa path (URL-osoitteet, kuten index.php/admin). Vanhaa get-URL-muotoa (URL-osoitteet, kuten index.php?r=admin) ei enää tueta. Asennusohjelma asettaa path-muodon automaattisesti, joten sinun tarvitsee tarkistaa tämä vain, jos käytät uudelleen vanhempaa config.php-tiedostoa, jossa on 'urlFormat' => 'get'.

Huomautus: Jos yhdistät Linuxista Windows-palvelimella olevaan MSSQL-tietokantaan dblib PDO -ohjaimella, taustalla olevan FreeTDS:n on oltava määritetty oikein. Lisätietoja löytyy sivulta Vianmääritys.

Valinnaiset PHP-laajennukset:

• GD-kirjasto FreeType- ja JPEG-tuella tarvitaan captchoihin, tilastojen havainnollisiin kaavioihin sekä kuvien lataamiseen HTML editorin kautta - katso PHP GD-Library Extension -dokumentaatio
• IMAP tarvitaan sähköpostin palautusten seurantajärjestelmää varten - katso PHP IMAP Extension -dokumentaatio. PHP 8.4:stä alkaen IMAP-laajennus ei enää kuulu PHP:n mukana, vaan se täytyy asentaa erikseen PECL:stä.
• LDAP tarvitaan osallistujien tuomiseen LDAP:n avulla - katso PHP LDAP -dokumentaatio
• Intl käytetään tekstien lajitteluun oikein kunkin kielen sääntöjen mukaisesti - katso PHP Intl -dokumentaatio
• Sodium on suositeltava tietojen salaukseen - katso PHP Sodium -dokumentaatio. Jos se puuttuu, LimeSurvey käyttää paljon hitaampaa PHP-toteutusta.

Suositellut PHP-asetukset (asennusohjelma näyttää varoituksen, jos arvosi ovat tätä pienempiä):

• max_input_vars: 5000 tai enemmän
• post_max_size: 32M tai enemmän
• upload_max_filesize: 32M tai enemmän

Useimmiten verkkopalvelimesi tarjoaja tai järjestelmänvalvoja voi auttaa näiden valinnaisten osien kanssa.

Selainten yhteensopivuus

Kyselyyn vastaajan puolella tuemme tällä hetkellä Edgeä ja kaikkia uudempia vastaavia selaimia, kuten FF, Chrome, Opera jne., kun JavaScript on käytössä.

Hallintaosassa tuemme tällä hetkellä Edgeä ja kaikkia uudempia vastaavia selaimia, kuten FF, Chrome, Opera jne., kun JavaScript on käytössä.

Näyttökoot

Tuemme kyselyyn vastaamisessa kaikkia kohtuullisia näyttökokoja (360 px x 640 px ja suuremmat). LimeSurveyn hallintasivun pienin tuettu näytön resoluutio on 1280 px x 1024 px.

LimeSurveyn palveluntarjoajat

LimeSurveyn pitäisi toimia useimmilla palveluntarjoajilla, jotka tarjoavat PHP:tä ja MySQL:ää/MariaDB:tä. Jos haluat valmiiksi asennetun LimeSurveyn, jota me ylläpidämme puolestasi, kokeile LimeSurvey Cloudia. Erot on kuvattu sivulla LimeSurvey Cloud vs. LimeSurvey CE.

Lataa LimeSurvey-paketti

Lataa uusin vakaa LimeSurvey zip-paketti (saatavilla on myös gzip-, bz2- ja 7zip-paketit) ja tallenna se paikalliselle levyllesi.

Pura LimeSurvey-paketti

Pura zip-tiedosto omaan hakemistoon/kansioon haluamallasi pakkausohjelmalla. Varmista purkaessasi, että hakemistorakenne puretaan tiedostojen kanssa (tämä on useimpien pakkausohjelmien oletustoiminto). Asennushakemiston polun nimessä ei saa olla erikoismerkkejä '(' tai ')', mutta siinä voi olla välilyönti.

Kerää tiedot palvelimestasi

Sinun täytyy tietää seuraavat asiat, jotta voit asentaa LimeSurveyn verkkopalvelimellesi oikein:

• Verkkosivustosi URL-osoite, jossa skriptit sijaitsevat (esim. https://my.domain.com/limesurvey).
• Mitä verkkopalvelinohjelmistoa käytät?
  • Apachelle: LimeSurveyn Apache-esimerkkimääritys
  • nginxille: tutustu LimeSurveyn nginx-esimerkkimääritykseen (vanhentunut, ei editorin tukea)
• Palvelimesi fyysinen levysijainti, jossa skriptit sijaitsevat (esim. /home/usr/htdocs/limesurvey).
• Tietokantapalvelimesi IP-/verkkosijainti (esim. localhost).
• Jos tietokantapalvelimesi käyttää epästandardia porttia, selvitä, mikä portti se on.
• Tietokantapalvelimesi käyttäjänimi ja salasana.
• Useimmilla palveluntarjoajilla et voi antaa skriptin luoda tietokantaa, vaan sinun täytyy tehdä se itse. Jos käytät tällaista palveluntarjoajaa, luo tietokanta (esimerkiksi limesurvey) itse. MySQL/MariaDB:lle käytä merkistöä utf8mb4 ja vertailujärjestystä utf8mb4_unicode_ci.

Lataa tiedostot verkkopalvelimellesi

Yhdistä verkkopalvelimeesi FTP/SFTP-ohjelmalla (esim. FileZilla) ja luo hakemisto skriptien säilyttämistä varten. Lataa sitten tiedostot palvelimelle säilyttäen hakemistorakenne. Varmista, että lataat tiedostot binääritilassa (tarkista FTP-ohjelmasi asetukset). Huomaa, että lataaminen ASCII-tilassa voi aiheuttaa epätavallisia virheitä (esim. 'class not found' -virhe asennuksen aikana), eikä kuvia välttämättä ladata oikein. Varmista myös, että piilotetut .htaccess-tiedostot ladataan - ne suojaavat joitakin hakemistoja ja mahdollistavat Apachella URL-osoitteet ilman index.php-osaa.

Aseta hakemistojen oikeudet

Jotta skripti toimisi oikein, sillä tulee olla tietty pääsy joihinkin hakemistoihin - tämä koskee erityisesti Linux/*nix-järjestelmiä.

• Hakemistoa "/limesurvey/tmp" (ja kaikkia sen alihakemistoja ja tiedostoja) käytetään tuonteihin ja latauksiin, ja sen oikeudeksi tulee asettaa verkkopalvelimellesi luku ja kirjoitus.
• Hakemistolla "/limesurvey/upload/" (ja kaikilla sen alihakemistoilla ja tiedostoilla) tulee myös olla verkkopalvelimellesi luku- ja kirjoitusoikeus, jotta kuvien ja mediatiedostojen lataus onnistuu.
• Hakemisto "/limesurvey/application/config/" tarvitsee myös luku- ja kirjoitusoikeudet verkkopalvelimellesi.
• Muut hakemistot voidaan asettaa vain luettaviksi.

  Jos käytät Linuxia, oikeuksien asettaminen riippuu verkkopalvelimesi määrityksistä. Jos verkkopalvelimesi toimii esimerkiksi käyttäjänä www-data (Debian/Ubuntu) tai apache (RHEL/Rocky Linux/AlmaLinux), kirjoita yllä lueteltuihin kolmeen hakemistoon chown -R www-data <directory> ; chmod -R 755 <directory>. Tämä antaa kaikille lukuoikeuden, ja verkkopalvelimellasi on kirjoitusoikeus.

Luo tietokannan käyttäjä

LimeSurvey luo tietokannan ja sen sisälle taulut. Tätä varten se tarvitsee tietokannan käyttäjän käyttäjänimen ja salasanan. Suosittelemme yleensä luomaan tietokannan käyttäjän, jolla on seuraavat oikeudet:

- MySQL/MariaDB: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX

- PostgreSQL: Helpointa on tehdä tietokannan käyttäjästä LimeSurvey-tietokannan omistaja. Muussa tapauksessa käyttäjä tarvitsee skeemaan CREATE-oikeuden sekä tauluihin SELECT-, INSERT-, UPDATE-, DELETE-, TRUNCATE- ja TRIGGER-oikeudet ja sekvensseihin USAGE-oikeuden.

- Microsoft SQL Server: Tietokannan käyttäjän tulisi olla LimeSurvey-tietokannan db_owner-roolin jäsen. Jos haluat asennusohjelman luovan tietokannan, käyttäjä tarvitsee lisäksi dbcreator-palvelinroolin.

Suorita asennuskomentosarja

Avaa LimeSurvey-asennuksesi URL-osoite selaimessa (esim. https://example.org/limesurvey). Jos olet määrittänyt kaiken oikein, LimeSurveyn asennusohjelma käynnistyy automaattisesti – noudata vain ohjeita:

1. Valitse asennusohjelman kieli ja hyväksy lisenssi.
2. Tarkista Asennuksen ennakkotarkastus. Kaikkien pakollisten kohtien tulee olla merkitty OK-tilaan ennen kuin voit jatkaa.
3. Anna Tietokannan asetukset. LimeSurvey kysyy, haluatko luoda tietokannan ja/tai luoda taulut tietokantaan, ja luo sen jälkeen tarvittavat taulut.
4. Määritä ylläpitäjän tili: anna ylläpitäjän käyttäjänimi, salasana ja sähköpostiosoite sekä kyselysivustosi nimi ja Oletuskieli.

Yhdistä hallintakomentosarjaan ensimmäistä kertaa

Asennus on valmis, kun asennusohjelma päättyy! Avaa selain ja kirjoita LimeSurveyn hallinnan URL-osoite. Jos käytit tiedostojen tallennuskansion nimenä 'limesurvey', osoite on suunnilleen https://www.example.com/limesurvey/admin.

Sinun pitäisi nähdä kirjautumisnäkymä. Kirjaudu sisään asennuksen aikana antamallasi ylläpitäjän käyttäjänimellä ja salasanalla. Jos et muuttanut niitä asennusohjelmassa, oletuskirjautumistiedot ovat:

User: admin
Password: password

Jos käytät yhä oletussalasanaa, vaihda se heti tilisi asetuksista. Hyvää kyselyiden tekoa!

Lisäasetukset

Lisäasetuksia, kuten sähköpostin (SMTP) määritystä tai tietoturva-asetuksia, varten katso Valinnaiset asetukset ja Yleiset asetukset.

Välimuisti

LimeSurvey käyttää oletuksena Yii-tiedostovälimuistia, mutta se voidaan määrittää käyttämään myös muita välimuistimoottoreita. Muita mahdollisia välimuisteja ovat:

• Memcached (CMemCache)
• Redis (CRedisCache)
• APCu (CApcCache)
• Tietokanta (CDbCache)

Katso täydellinen kuvaus Yii-dokumentaatiosta.

LimeSurveyn versiosta 4.0.0 alkaen voit myös tallentaa laskutoimitukset välimuistiin ExpressionScriptissä. Tämä voi nopeuttaa toimintaa merkittävästi kyselyn monimutkaisuudesta riippuen. Voit ottaa emcachen käyttöön lisäämällä seuraavan config.php-tiedostoosi (components-taulukkoon):

'emcache' => array('class' => 'CFileCache'),

Kuten Yiin päävälimuistin kohdalla, myös muita välimuistijärjestelmiä voidaan käyttää.

Emcache ei ole yhteensopiva satunnaistettujen kyselyiden kanssa, ja se poistetaan käytöstä automaattisesti tällaisissa tapauksissa.

Entä jos kohtaan ongelmia...

Kuten kaikkien tietokoneohjelmien kohdalla, useimmiten asiat toimivat ohjeiden mukaan, mutta joskus eivät. Syitä siihen, ettei kaikki mene suunnitelmien mukaan, on liian paljon lueteltavaksi tässä. Jos kohtaat ongelmia, tutustu ensin sivuun Asennuksen usein kysytyt kysymykset. Jos et löydä vastausta sieltä, kirjoita ongelmasi ja mahdolliset virheilmoitukset LimeSurvey-keskustelupalstoille, avaa tukipyyntö (vain LimeSurvey Cloudia käyttäville asiakkaille) tai liity Discord-kanavallemme.