Asennuksen UKK

Sisältö:

Asennus omalle tietokoneelle

LimeSurvey voidaan asentaa omalle tietokoneelle MAMP:n, XAMPP:n tai jonkin muun järjestelmän avulla. Muista, että tietokoneesi ei ole verkkopalvelin – se ei ole muiden käyttäjien käytettävissä verkon kautta.

Jotta kyselysi olisi muiden käyttäjien tavoitettavissa verkon kautta, sinun täytyy joko:

• omistaa palvelin tai ostaa verkkotilaa palveluntarjoajalta
• tai löytää LimeSurveyhin erikoistunut palveluntarjoaja

Asennuksen aloittaminen

Miten voin luoda tietokannan ja käyttäjän MySQL:ssä komentorivin kautta?

Anna alla olevat komennot MySQL:ssäsi:

• create database <your_database_name>;

• create user <your_database_username>;

• create user <your_database_username>@localhost;

• set password for <your_database_username> = PASSWORD('<your_database_password>');

• set password for <your_database_username>@localhost = PASSWORD('<your_database_password>');

• grant all on <your_database_name>.* to '<your_database_username>';

• grant all on <your_database_name>.* to '<your_database_username>'@'localhost';

Päätteessä <your_database_name>, <your_database_username> ja <your_database_password> tulee korvata vastaavilla haluamillasi arvoilla.

Mitä jos en voi luoda tietokantaa komentosarjalla?

Yleensä komentosarja luo ensin uuden tietokannan ja sitten taulurakenteen. Jos palvelimesi tai palveluntarjoajasi ei kuitenkaan anna sinulle ylläpitäjän oikeuksia uuden tietokannan luomiseen MySQL:ssä, sinun täytyy ottaa yhteyttä palvelimen ylläpitäjään, jotta tarvittava tietokanta luodaan (tai luoda se itse, jos saat tarvittavat oikeudet). Vasta luodulla tyhjällä tietokannalla tulee olla asianmukaiset käyttöoikeudet (eli luku-, kirjoitus- ja luontioikeudet). Tämän jälkeen voit aloittaa LimeSurveyn asennuksen, joka luo taulut uuteen tietokantaan.

Tyhjä sivu asennussivulle siirryttäessä

Tämä ongelma ei johdu LimeSurveyn asennuksesta vaan PHP:n asennuksesta.

• Varmista, että MySQL PHP -moduuli (php-mysql) on asennettu.
• Varmista, että PHP-asennuksesi lataa sen PHP.ini-tiedoston, jota muokkaat, eikä käytä järjestelmässäsi jotakin toista PHP.INI-tiedostoa.
• Tarkista seuraavan PHP.ini-asetuksen sijainti ja käyttöoikeudet:

upload_tmp_dir="/temp"

session.save_path="/temp"

• Varmista, että palvelimesi käyttää sopivaa PHP-versiota.

Virheilmoitukset puuttuvien resurssien vuoksi

Joskus tiedostot eivät siirry palvelimelle oikein tai ne vioittuvat siirron aikana. Tämä aiheuttaa useita erilaisia virheilmoituksia. Useimmat niistä viittaavat tiedostoon tai tiedoston sisällä olevaan funktioon, jota ei löydy.

Ratkaisu: Lähetä kaikki tiedostot uudelleen käyttämällä FTP-ohjelmasi binääritilaa.

Vaatimukset-sivu

Mikä on mbstring-kirjasto (Multibyte String Functions)?

mbstring on PHP-kirjasto, joka voi muuntaa merkistöjä kielestä toiseen. Tarvitset sitä, jotta voit ajaa LimeSurveyta. Voit tarkistaa, onko se jo asennettu, avaamalla seuraavan URL-osoitteen selaimessa:

http://<your_server>/<your_limesurvey_directory>/admin/install/phpinfo.php

Näkyviin tulee paljon tietoa. Etsi merkkijonoa 'mbstring' kohdasta Asetukset. Jos löydät mbstring-osion, kaiken pitäisi olla kunnossa ja voit jatkaa LimeSurveyn asennusta!

Jos et löydä mbstring-osiota, saattaa olla ongelma. Vaihtoehtoja on kolme:

• Jos kyseessä on palveluntarjoajasi palvelin, pyydä laajennuksen aktivointia PHP:ssä tai lisätietoja sen aktivoinnista – jos palvelimesi hallintapaneeli on hyvä, voit ehkä aktivoida sen itse
• Jos kyseessä on oma Linux-palvelimesi, saatat joutua kääntämään PHP:n uudelleen mbstring-kirjaston kanssa. Kysy neuvoa Linux-asiantuntijoilta. Voit kuitenkin asentaa sen Linuxin paketinhallinnan avulla, joka on nykyään saatavilla lähes kaikissa Linux-jakeluissa
  • Jos käytät Linuxin versiota, joka tukee 'yum'-komentoa (CentOS, RedHat, Fedora)...
    • ...käytä päätettä (pääkäyttäjänä) ja kirjoita: yum install php-mbstring
    • ...muista päivittää /etc/php.ini ja poistaa kommenttimerkit mbstring-parametreista
    • ...muista käynnistää apache uudelleen asennuksen jälkeen: /etc/init.d/httpd restart
• Jos kyseessä on oma Windows-palvelimesi, etsi järjestelmästäsi php.ini, avaa se editorilla ja etsi mbstring. Todennäköisesti merkkijonon sisältävä rivi on kommentoitu puolipisteellä. Poista puolipiste, tallenna ja käynnistä verkkopalvelin uudelleen

Jumissa tiedostojärjestelmän oikeuksien tarkistuksessa

Jos SELinux on aktivoitu (pääasiassa CentOS:ssa), saatat saada virheilmoituksen, että tiedostojärjestelmän oikeudet eivät ole oikein, vaikka hakemistolista olisi tyhjä. SELinux estää kirjoittamisen, vaikka oikeudet olisivat esimerkiksi 777 tai 755. Voit määrittää SELinuxin oikein palvelimellesi tutustumalla SELinux-dokumentaatioon.

Tietokannan luomisen jälkeen

Tyhjä sivu tietokannan luomisen jälkeen

Oireet

• LimeSurvey on asennettu oikein ja tietokanta on luotu, mutta ylläpitosivun sijaan näkyviin tulee tyhjä sivu
• Verkkopalvelimen loki näyttää "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"

Korjaus

Tämä liittyy todennäköisesti virheelliseen $rooturl- tai $rootdir-asetukseen config.php-tiedostossa. Tiedosto config.php yrittää asettaa $rootdir-arvon oikein kutsumalla dirname('''FILE'''). Tämä toimii yleensä, mutta se voi epäonnistua, kun LimeSurvey on asennettu käyttäjän kotihakemistoon tai public_html-hakemistoon ja kotihakemisto on liitetty NFS:n kautta. Jos haluat asettaa $rootdir-arvon manuaalisesti (komentotulkkisi tai pwd-komento voi näyttää polun, kuten /disks/hostname/home/username/public_html/limesurvey), kokeile käyttää polkua /home/username/public_html/limesurvey.

Kun avaan hallintasivun, selain jää pyörimään eikä lopulta näytä sivua

Oireet

• LimeSurvey on asennettu oikein ja tietokanta on luotu. Kun kuitenkin avaat hallintasivun, selain jää pyörimään eikä lopulta pysty näyttämään sivua
• Kun tarkistat verkkopalvelimen käyttölokin, huomaat sen kasvaneen erittäin suureksi (joissakin tapauksissa yli 2 Gt)
• Käyttölokin täyttää seuraava viesti:

  fread() [function.fread]: Length parameter must be greater than 0 in /limesurvey/classes/php-gettext/streams.php on line 120.

Rivinumero voi olla eri, riippuen LimeSurveyn versiosta.

Korjaus

Tämä voi johtua mbstring.func_overload-asetuksesta. Muuta seuraava asetus php.ini-tiedostossa:

mbstring.func_overload = 0

Tämä tarkoittaa, ettei funktioiden ylikuormitusta käytetä. Katso tämän asetuksen kuvaus PHP-käsikirjasta: Function Overloading Feature.

Kun avaan hallintasivun, selain ilmoittaa virheen Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76

Oireet

• LimeSurvey on asennettu oikein ja tietokanta on luotu. Kun sinut kuitenkin ohjataan hallintasivulle, selain näytti listatun virheen.
• $rootdir ja $rooturl on asetettu oikein config.php-tiedostossa.
• LimeSurveyn asennushakemiston levypolun nimi sisältää jonkin seuraavista merkeistä: '(',')' tai '+'.

  Myös muut merkit voivat aiheuttaa saman toiminnan.

Korjaus

Siirrä tai nimeä uudelleen LimeSurveyn asennushakemisto siten, ettei polun nimessä ole merkkejä '(',')' tai '+'.

Asennuksen jälkeen

Muiden onnistuneen asennuksen jälkeen mahdollisesti ilmenevien ongelmien osalta katso vianmäärityssivu.