설치 FAQ

목차:

컴퓨터에 설치하기

LimeSurvey는 MAMP/XAMPP 또는 다른 시스템을 사용하여 사용자의 컴퓨터에 설치할 수 있습니다. 사용자의 컴퓨터는 웹 서버가 아니므로 다른 사용자가 웹을 통해 접속할 수 없다는 점에 유의하십시오.

다른 사용자가 웹을 통해 설문조사에 접속할 수 있도록 하려면 다음 중 하나가 필요합니다.

• 호스팅 업체의 서버 또는 웹 공간을 보유
• 또는 LimeSurvey 전문 호스팅 업체를 찾기

설치 시작

명령줄 접근으로 MySQL에서 데이터베이스와 사용자를 생성하려면 어떻게 해야 하나요?

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

터미널에서 <your_database_name>, <your_database_username>, <your_database_password>은(는) 해당하는 값 또는 원하는 값으로 바꿔야 합니다.

스크립트로 데이터베이스를 생성할 수 없으면 어떻게 하나요?

일반적으로 스크립트는 새 데이터베이스를 생성한 다음 테이블 구조를 생성합니다. 그러나 서버/ISP에서 MySQL에 새 데이터베이스를 생성할 수 있는 관리자 권한을 제공하지 않는 경우, 서버 관리자에게 문의하여 필요한 데이터베이스를 생성해야 합니다(필요한 권한을 받았다면 직접 생성할 수도 있습니다). 새로 생성한 빈 데이터베이스에는 적절한 접근 권한(예: 읽기/쓰기/생성)이 포함되어야 합니다. 그런 다음 LimeSurvey 설치를 시작하면 새로 생성한 데이터베이스 안에 테이블이 생성됩니다.

설치 페이지에 접속하면 빈 페이지가 표시됨

이 문제는 LimeSurvey 설치가 아니라 PHP 설치에서 발생합니다.

• MySQL PHP 모듈(php-mysql)이 설치되어 있는지 확인하십시오.
• PHP가 사용자가 수정 중인 PHP.ini 파일을 불러오고 있는지, 시스템의 다른 PHP.INI 파일을 읽고 있지는 않은지 확인하십시오.
• PHP.ini에서 다음 설정의 위치와 권한을 확인하십시오.

upload_tmp_dir="/temp"

session.save_path="/temp"

• 서버에서 적합한 PHP 버전이 실행되고 있는지 확인하십시오.

존재하지 않는 리소스로 인한 오류 메시지

파일이 올바르게 업로드되지 않거나 업로드 과정에서 손상되는 경우가 있습니다. 이로 인해 여러 가지 오류 메시지가 표시됩니다. 대부분은 찾을 수 없는 파일 또는 파일 내의 함수를 가리킵니다.

해결 방법: FTP 프로그램의 바이너리 모드를 사용하여 모든 파일을 다시 업로드하십시오.

요구 사항 페이지

mbstring(Multibyte String Functions) 라이브러리란 무엇인가요?

mbstring 라이브러리는 문자 집합을 한 언어에서 다른 언어로 변환할 수 있는 PHP 라이브러리입니다. LimeSurvey를 실행하려면 이 라이브러리가 필요합니다. 이미 설치되어 있는지 확인하려면 웹 브라우저에서 다음 URL을 여십시오.

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

많은 정보가 표시됩니다. 설정 섹션에서 'mbstring' 문자열을 검색하세요. mbstring 섹션이 있다면 모든 것이 정상이며 LimeSurvey 설치를 계속 진행할 수 있습니다!

mbstring 섹션이 없는 경우 문제가 있을 수 있습니다. 가능한 경우는 세 가지입니다.

• 호스팅 업체의 서버인 경우, PHP에서 해당 확장 기능을 활성화해 달라고 요청하거나 활성화 방법에 대한 자세한 정보를 문의하세요. 서버에 좋은 관리 패널이 있다면 직접 활성화할 수도 있습니다.
• 직접 운영하는 Linux 서버인 경우, PHP를 다시 컴파일하여 mbstring 라이브러리를 포함해야 할 수 있습니다. 방법은 Linux 전문가에게 문의하세요. 다만 요즘은 대부분의 Linux 배포판에서 제공하는 패키지 관리자를 사용하여 설치할 수도 있습니다.
  • 'yum'을 지원하는 Linux 버전(CentOS, RedHat, Fedora)을 사용하는 경우...
    • ...터미널을 (슈퍼 사용자 권한으로) 열고 다음을 입력하세요: yum install php-mbstring
    • .../etc/php.ini를 업데이트하여 mbstring 관련 매개변수의 주석을 해제하세요.
    • ...설치한 후에는 반드시 apache를 다시 시작하세요: /etc/init.d/httpd restart
• 직접 운영하는 Windows 서버인 경우, 시스템에서 php.ini를 검색하여 편집기로 열고 mbstring을 검색하세요. 해당 문자열이 포함된 줄이 세미콜론으로 주석 처리되어 있을 가능성이 높습니다. 세미콜론을 제거하고 저장한 후 웹 서버를 다시 시작하세요.

파일 시스템 권한 확인 단계에서 멈춤

SELinux가 활성화되어 있는 경우(주로 CentOS), 디렉터리 목록이 비어 있어도 파일 시스템 권한이 올바르지 않다는 오류가 표시될 수 있습니다. SELinux는 권한이 예를 들어 777 또는 755로 설정되어 있어도 쓰기를 차단합니다. 서버에서 SELinux를 올바르게 구성하려면 SELinux 문서를 확인하세요.

데이터베이스 생성 이후

데이터베이스 생성 후 빈 페이지가 표시됨

증상

• LimeSurvey가 올바르게 설치되고 데이터베이스도 생성되었지만, 관리자 페이지 대신 빈 페이지가 표시됩니다.
• 웹 서버 로그에 "Fatal error: Call to a member function on a non-object in /path/to/limesurvey/admin/login_check.php on line 69""가 표시됩니다.

해결 방법

이 문제는 config.php의 $rooturl 또는 $rootdir 설정이 잘못되어 발생했을 가능성이 높습니다. config.php 파일은 dirname('''FILE''')를 호출하여 $rootdir을 올바르게 설정하려고 시도합니다. 보통은 정상적으로 작동하지만, LimeSurvey가 사용자의 홈 디렉터리나 public_html 디렉터리에 설치되어 있고 홈 디렉터리가 NFS로 마운트된 경우에는 문제가 생길 수 있습니다. $rootdir을 수동으로 설정하려면(셸이나 pwd 명령이 /disks/hostname/home/username/public_html/limesurvey와 같은 경로를 보여줄 수 있습니다) /home/username/public_html/limesurvey를 사용해 보세요.

관리자 페이지에 접속하면 브라우저가 계속 실행되다가 결국 페이지를 표시하지 못함

증상

• LimeSurvey가 올바르게 설치되고 데이터베이스도 생성되었습니다. 그러나 관리자 페이지에 접속하면 브라우저가 계속 실행되다가 결국 페이지를 표시하지 못합니다.
• 웹 서버 액세스 로그를 확인하면 크기가 매우 커져 있습니다(경우에 따라 2GB 이상).
• 액세스 로그에 다음 메시지가 계속 기록됩니다.

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

줄 번호는 LimeSurvey 버전에 따라 다를 수 있습니다.

해결 방법

mbstring.func_overload 설정이 원인일 수 있습니다. php.ini 파일에서 다음 설정을 변경하세요.

mbstring.func_overload = 0

이는 함수 오버로딩을 사용하지 않는다는 의미입니다. 이 설정에 대해서는 PHP 매뉴얼을 참조하세요: Function Overloading Feature.

관리자 페이지에 접속하면 브라우저에 Fatal error: Call to a member function gT() on a non-object in login_check.php on line 76 오류가 표시됨

증상

• LimeSurvey가 올바르게 설치되고 데이터베이스도 생성되었습니다. 그러나 관리자 페이지로 리디렉션될 때 브라우저에 위의 오류가 표시됩니다.
• config.php에서 $rootdir와 $rooturl이 올바르게 설정되어 있습니다.
• limesurvey 설치 디렉터리의 디스크 경로 이름에 '(', ')' 또는 '+' 문자 중 하나가 포함되어 있습니다.

  다른 문자도 동일한 현상을 일으킬 수 있습니다.

해결 방법

경로 이름에 '(', ')' 또는 '+' 문자가 포함되지 않도록 LimeSurvey 설치 디렉터리를 이동하거나 이름을 변경하세요.

설치 이후

설치에 성공한 후 발생할 수 있는 다른 모든 문제는 문제 해결 페이지를 참조하세요.