Installation FAQ/ja

Contents:

Installation on your computer

LimeSurvey can be installed on your computer with MAMP/XAMP or any other system. But your computer is not a web server : it's not accessible via web by other user.

Then if you want to spread your survey on the web : you have to

• own a server
• or a web space at a hoster
• find a LimeSurvey instance specialized hoster

  Installation on your computer is not done to share your survey on internet.

Starting installation

How can I create a database and a user in mysql with command line access?

You have to enter the below commands in your mysql.

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';

You have to replace <your_database_name>, <your_database_username> and <your_database_password> in above commands with according values.

What if I can't create a database through a script?

Normally, the script creates a new database, and then the table structure. However if your server/ISP doesn't give you admin rights to create a new database in MySQL, you will need to contact your server administrator to create the necessary database (or create it yourself). They should create a blank database for you that gives you the appropriate access rights (ie: read/write/create). Start the LimeSurvey installation as usually and it will then create the tables in the existing database.

Blank page when accessing the Install page

The problem is not with the LimeSurvey installation but with the PHP installation.

• Verify you have the MySQL PHP module (php-mysql) installed.
• Verify your PHP install is loading the PHP.ini file your are modifying and not parsing other PHP.INI files on your system.
• Verify the location and permissions of the following setting in your PHP.ini

upload_tmp_dir="/temp"

session.save_path="/temp"

• Verify your server runs a suitable PHP version (e.g. this "blank page" problem appeared with PHP v4.4 and LimeSurvey v2.00+).

Error messages because of non-existing resources

Sometimes files are not uploaded correctly or were broken during upload. This leads to several different error messages. Most of them refer to a file or function within a file which can't be found.

Solution: Re-upload all files using the binary mode of your FTP program.

Requirements page

mbstringライブラリ（マルチバイト文字列機能）とは何ですか？

mbstringライブラリとは、文字セットを他言語のものに変換するためのPHPのライブラリで、LimeSurveyを実行するのに必要となります。mbstringがすでにインストールされているかどうかを確認するには、webスペースにtest.phpというファイルを作成して、そこに次のように記入します。

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

Webブラウザからtest.phpのファイルを開くと、インストールされているphpについての各種情報が表示されます。その中にmbstringという文字列が見つかれば、正しくインストールされています。見つからない場合には、正しくインストールされていません。対処方法は利用しているサーバに応じて、次のようになります。

If you find the mbstring section then all should be well and you can continue on with your LimeSurvey installation!

If you don't find the mbstring section you might have a problem on your hands.

• プロバイダのサーバを利用している場合。プロバイダにこのPHPの拡張機能を利用可能にするように依頼してください。ちゃんとしたプロバイダならば、何の問題もなく応じてくれるはずです。
• 自前のLinuxサーバを利用している場合。mbstringを含めてPHPを再コンパイルする必要があります。Linuxの熟練者に方法を尋ねてください。
  • 'yum'をサポートしているLinux（CentOS, RedHat, Fedora）を利用している場合は、ターミナルから（スーパーユーザとして）次のように入力します。
    • yum install php-mbstring
  • インストール後は、apacheを再起動する必要があります。
    • /etc/init.d/httpd restart
• 自前のWindowsサーバを利用している場合。これは簡単です。システム上のphp.iniを探してエディタで開き、mbstringという文字列を検索します。たいていの場合、mbstringという文字列の含まれている行が ; （セミコロン）でコメントアウトされています。セミコロンを削除してphp.iniを保存し、サーバを再起動すればOKです。

Stuck at checking file system permissions

If SELinux is activated (primarily on CentOS) then you might get an error that the file system permissions are not correct but the list of directories is empty. SELinux prevents writing even though the permissions are on e.g. 777 or 755. You need to configure SELinux for your server correctly - check out the SELinux documentation.

After database creation

Blank page after database creation

Symptoms

• LimeSurvey installed OK, and database was created, but instead of the admin page, you get an empty page
• Web surver log shows "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69"

Fix

This is probably an incorrect setting for $rooturl or $rootdir in config.php. In particular, config.php attempts to set $rootdir correctly by calling dirname('''FILE''') and while this usually works, it can be upset when LimeSurvey is installed in a user's home or public_html directory and the home directory is mounted over NFS. Try setting $rootdir manually, and in particular, while your shell or pwd command may show a path like "/disks/hostname/home/username/public_html/limesurvey", try using "/home/username/public_html/limesurvey".

When accessing admin page, the browser keeps running and will eventually fail to show it

Symptoms

• LimeSurvey installed OK and database was created. But when you access the admin page, the browser keeps running and will eventually fail to show the page.
• When you check the web server access log, its size has become so big (in some cases, more than 2 GB).
• Inside the access log, you get this message filling the log.

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

Note: line number may be different depending on your LimeSurvey version.

Fix

This may be caused by the mbstring.func_overload setting. Check the setting in your php.ini and set as the following.

mbstring.func_overload = 0

Note: This means no function overloading. See PHP manual for this setting: Function Overloading Feature

When accessing admin page, the browser reports Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76

Symptoms

• LimeSurvey installed OK and database was created. But when rdirected to the admin page, the browser displayed the the listed error.
• $rootdir and $rooturl are correctly set in config.php.
• The disk path name for limesurvey installation directory includes one of the following characters: ()+

Note: Other characters may also induce the same behaviour

Fix

Move / rename the limesurvey installation directory so that pathname does not include either the ( or ) characters

After installation

For all issues happening after a successful installation please refer to the Troubleshooting page.