Kurogo Tutorial 03

Setup and Installation

Kurogo는 PHP 웹 어플리케이션 입니다. 당연히 웹 서버에 인스톨 되어야 겠죠. 현재까지는 2 종류의 웹 서버를 지원하고 있습니다.

System Requirements

• Web Servers supported
  • Apache (tested on 2.x)
    • Requires mod_rewrite module
    • Requires .htaccess support (AllowOverride)
    • Subfolder support using symlinks, see Using Kurogo in a subfolder of a domain
  • IIS (tested on 7.5)
    • Requires URL Rewrite Module 2.0 - http://www.iis.net/download/URLRewrite
    • Tested using x86 Non Thread Safe version using FastCGI on IIS.
    • Support for virtual folders requires a manual configuration change
    • Experimental subfolder support using Junctions, see Using Kurogo in a subfolder of a domain
• PHP 5.2 or higher with the following extensions:
  • zlib
  • xml
  • dom
  • json
  • PDO (Used for Database Access)
  • mbstring
  • Zip (needed if parsing KMZ files)
• Some PHP modules are optional depending on whether you need their backend functionality
  • LDAP

Installation

이 튜토리얼은 여러분이 기본적인 시스템을 가지고 있고 웹 서버 관리에 대한 기본적인 지식을 가지고 있는 것을 상정하고 작성했습니다. 좀 더 자세한 사항은 여러분의 시스템과 웹 서버 설명서를 참조하세요.

1. Kurogo 파일을 웹 서버가 접근 가능한 위치에 넣으세요.
   
2. 웹서버의 루트 폴더를 Kurogo의 www 폴더로 잡아 주세요.(Using Kurogo in a subfolder of a domain 을 보세요.)
3. (Apache Only) .htaccess files 이 사용 가능해야 합니다.  적어도 FileInfo 에는  AllowOverride 가 세팅되 있어야 합니다. (MAMP on OS X 에는 이 기능이 디폴트로 설정 돼 있습니다. )
4. (IIS Only) 전체 프로젝트 폴더에 Application Pool 이 read access 가 가능해야 합니다.  In IIS 7.5 this is the IIS AppPoolDefaultAppPool user

5. site directory에, make a copy of the Universitas folder 를 그 안의 파일들까지 모두 복사해서 하나 더 만드세요. 여러분의 site name으로 사용할 이름을 그 폴더이름으로 사용하세요. 이 폴더를 SITE_FOLDER 로 사용할 겁니다.
   

   • Critical: 웹서버 유저는 SITE_FOLDER 내의 모든 파일에 쓰기 가능으로 설정 돼 있어야 합니다. (Apache typically: apache or www, IUSR on IIS) 
6. kurogo-default.ini file 을 kurogo.ini 라는 이름으로 하나 더 복사해 넣으세요.
   
7. 그 kurogo.ini file 의 ACTIVE_SITE option 을 SITE_FOLDER 하고 같게 설정하세요.
   
8. 웹서버를 restart 하고  http://yourhost/admin 를 브라우저에서 불러보세요.

Using Kurogo in a subfolder of a domain

특정 환경에서는 Kurogo 가 도메인의 root 가 아니라 URL로 install 되어야 필요가 있습니다. 이렇게 하기 위한 몇가지 방법이 있습니다.

• Unix environment 에서는 symbolic links 사용하기
  
• IIS 에서는 Virtual Folders 사용하기 (requires manual configuration change)
• 윈도우에서는 Junctions 사용하기
  

Note. Apache aliases는 aliases 와 mod_rewrite 를 실행하는데에는 지원하지 않습니다.

Using Symbolic Links in a Unix environment

유닉스 환경에서는 symbolic link를 사용해서 subpath안에 Kurogo를 넣을 수 있습니다.

현재까지는 아래와 같은 환경에서 이 기능이 지원 됩니다.

• 유닉스 기반 환경(Linux, Mac OS X, etc)에서 아파치 웹 서버 사용하기
  
• 아파치는 symbolic links 를 사용할 수 있음 (Options FollowSymlinks)

이 조건이 성립되면 여러본은 www 폴더를 가리키는 symbolic link를 생성할 수 있고 루트폴더나 그 subfolder에 Kurogo를 넣을 수 있습니다.

command line에서는 이 명령어가 아래처럼 될 겁니다.

ln -s /path/to/kurogo/www /path/to/documentroot/mobile

subfolder 이름은 폴더 naming rule에 맞는 한 어떤 이름을 넣어도 상관 없습니다.

Using Virtual Folders in IIS

윈도우즈 환경에서 IIS 웹서버를 사용하신다면 virtual folder에 Kurogo를 인스톨 해야 합니다. 이렇게 하면 document root가 아닌 경로에서도 Kurogo를 사용할 수 있습니다. 이렇게 사용하기 위해서는 아래와 같이 하시면 됩니다.

• kurogo www folder를 가리키는 vitual folder를 생성하세요.
• Kurogo project folder에서 config/kurogo.ini 를 오픈하세요. 이 파일이 없으면 kurogo-default.ini를 복사해서 사용하시면 됩니다.  
• [kurogo] section 에서, URL_BASE option의 주석을 풀고 해당 경로를 세팅해 주세요. 예를 들어 여러분의 사이트가  /kurogo 에 인스톨 돼 있으면 다음과 같이 세팅하시면 됩니다.  URL_BASE=”/kurogo”

Using Junctions in Windows

The following procedure should work in either IIS or Apache, however it is recommended to use Virtual Folders in IIS

아래 절차들은 IIS나 아파치 모두에서 작동합니다. 어쨌든 IIS에서는 Virtual Folder를 사용할 것을 권장합니다.

•  서버에 junction program이 인스톨 되어 있어야 합니다. 이것은 마이크로 소프트 (Microsoft) 에서 배포합니다. 그리고 이 글을 쓰는 시점에는 다음 링크에서 받으실 수 있습니다. http://technet.microsoft.com/en-us/sysinternals/bb896768
• junction program이 PATH내에 위치해 있어야 합니다. 대부분의 경우 junction.exe 파일을 시스템 루트 폴더 (C:Windows)에 카피해서 넣으면 됩니다.
  
• same NTFS filesystem. 의 2개 path들 사이에 junction들을 생성하실 수 있습니다. FAT32로 포맷된 volumes 나 on volumes 사이에 junctions를 생성하실 수 없습니다.

아래와 같이 명령창에서 실행해 보세요. (조건에 따라 약간씩 다를 수 있습니다.)

junction C:\path\to\documentroot\mobile C:\path\to\kurogo\www

여기서는 subfolder 이름이 mobile이라는 것으로 가정했습니다. 폴더 이름은 임으로 정하시면 됩니다.

Common Installation Problems

설치하는 과정에서 문제가 발생할 수 있습니다. 대부분의 문제는 셋업이 제대로 안 됐거나 다른 요건들이 충족되지 않아서 입니다.

Apache: Viewing any of the modules results in a 404 Not Found error

설치 후 브라우저에서 열어봤는데 404 에러가 나올 수 있습니다. 이것은 Kurogo가 작동하고 있지만 .htaccess 파일을 Kurogo가 제대로 읽을 수 없기 때문입니다.

• mod_rewrite 가 enabled 되 있어야 합니다. 이것은 httpd.conf 파일에서 enableing mod_rewrite 의 주석을 제거해 주시면 됩니다. 이 httpd.conf 가 어디에 있는지 아시려면 설치한 서버에서 제공하는 instructin을 참조하세요.
  
• AllowOverride를 FileInfo나 All로 세팅해야 합니다. AllowOverride는 아파치가 .htaccess 파일을 읽을 수 있도록 해 주는 옵션입니다. 어떤 경우에슨 디폴트로 이것이 disabled 된 경우가 있습니다. (NONE으로 세팅되 있음) httpd.conf나 virtual host configuration에서 이 부분을 확실하게 enabled 시켜야 합니다.
  

Kurogo Error messages are shown as an Apache error message

에러메세지가 아파치 Apache 메세지 처럼 보인다면 아마도 서버가 /error urls 로 trapping 되고 있기 때문일 겁니다.

• httpd.conf 나 virtual host configuration 파일에서 Alias /error 라인을 제거해 주세요.