Web Server에 수동으로 FastCGI 플러그인 구성 (Sun Java System Web Server 7.0 Update 3 관리자 설명서)

Sun Java System Web Server 7.0 Update 3 관리자 설명서

Web Server에 수동으로 FastCGI 플러그인 구성

플러그인은 다음 위치에 설치되어 있습니다.

32비트 FastCGI 플러그인 바이너리는 <install_dir>/plugins/fastcgi 디렉토리에 설치됩니다.

64 비트 Solaris SPARC FastCGI 플러그인 바이너리는 <install_dir>/lib/plugins/fastcgi/64 디렉토리에 설치됩니다.

다음 FastCGI 바이너리가 설치됩니다.

libfastcgi.so(Solaris/Linux용)

fastcgi.dll(Windows용)

Fastcgistub.exe(Windows용)

libfastcgi.sl(HP-UX용)

Fastcgistub(실행 파일)

FastCGI 플러그인은 <instance-dir>/config 디렉토리 아래에 있는 Web Server 구성을 통해 구성됩니다. FastCGI 플러그인을 구성하려면 다음 단계를 수행합니다.

magnus.conf 수정

"load-modules" Init 기능을 사용하여 FastCGI 플러그인 공유 라이브러리를 로드합니다.

Init fn=flex-init access="access" format.access="%Ses->client.ip%
- %Req->vars.auth-user% [%SYSDATE%] \"%Req->reqpb.clf-request%\"
%Req->srvhdrs.clf-status% %Req->srvhdrs.content-length%"

Init fn="load-modules" shlib="libJava EEplugin.so" shlib_flags="(global|now)"

Init fn="load-modules" shlib="libfastcgi.so" shlib_flags="(global|now)"

MIME 유형 수정(선택 사항)

mime.types 파일을 편집하여 MIME 매핑을 지정합니다. MIME 유형 매핑 수정은 선택적인 단계입니다.

예:

#--Sun Microsystems Inc. MIME Information

# Do not delete the above line. It is used to identify the file type.

#

# Copyright 2006 Sun Microsystems, Inc. All rights reserved.

# Use is subject to license terms.

#


type=application/octet-stream exts=bin

type=application/astound exts=asd,asn

...

...

type=magnus-internal/fastcgi exts=php

...

...

obj.conf 수정

obj.conf 파일을 편집하여 이전 절에 설명된 플러그인 SAF를 통해 FastCGI 특정 요청을 구성합니다.

다음은 수정된 obj.conf 파일의 예입니다.

#

# Copyright 2006 Sun Microsystems, Inc. All rights reserved.

# Use is subject to license terms.

#


# You can edit this file, but comments and formatting changes

# might be lost when you use the administration GUI or CLI.



<object name = "default">

		AuthTrans fn="match-browser" browser="*MSIE*" 
						ssl-unclean-shutdown="true"
		NameTrans fn="ntrans-Java EE" name="Java EE"
		NameTrans fn="pfx2dir" from="/mc-icons" 
						dir="/ws7/lib/icons" name="es-internal"
		NameTrans fn="assign-name" from="/fcgi/*" name="fcgi.config"

</object>

<Object name="fcgi.config">

		AuthTrans fn="auth-fastcgi" app-path="/fastcgi/apps/c/simpleAuth" 
				bind-path="localhost:2111"
		Service fn="responder-fastcgi" 
						app-path="/fastcgi_enabled_php_installation_dir/bin/php" 
				app-env="name1=abc"

</object>
...

서로 다른 URL 패턴에 다른 객체를 정의하거나 SAF를 서로 다른 MIME 유형에 매핑하면 다양한 방법으로 FastCGI SAF를 호출할 수 있습니다.

obj.conf 구성 및 구문에 대한 자세한 내용은 Sun Java System Web Server 7.0 Update 3 Administrator’s Configuration File Reference의 6 장, Syntax and Use of obj.conf를 참조하십시오.

여러 FastCGI 응용 프로그램 구성

관리 콘솔이나 CLI를 통해서는 여러 FastCGI 응용 프로그램을 구성할 수 없습니다. 해결 방법으로 obj.conf 파일을 수정하면 여러 응용 프로그램을 구성할 수 있습니다. 예:

<If> $uri =~ '^/fcgi/(.*)'>

Service fn="responder-fastcgi" app-path="/export/home/bits/fastcgi/fcgi-2.4.0/examples/$1" app-env="LD_LIBRARY_LIBRARY_PATH=/export/home/bits/fastcgi/fcgi-2.4.0/libfcgi/.libs"</If>

표현식은 <app-path> 프로세스를 생성하므로 별도로 구성하지 않아도 됩니다.

주 –

여러 응용 프로그램에 대해 동일한 bind-path를 구성할 수 없습니다. 이 경우 공통된 bind-path로 인해 시작할 수 없게 됩니다.

가상 호스팅 환경 구성

가상 호스팅 환경은 가상 서버가 여러 대인 경우 PHP 엔진 공유와 관련된 잠재적인 보안 및 성능 문제를 방지하기 위한 것입니다.

Web Server 7.0 환경 변수를 사용하면 별도의 엔진 범위가 있는 동일한 PHP 바이너리를 각 가상 서버에 할당할 수 있습니다. 각 가상 서버에는 서버마다 고유한 php.ini 파일이 있어야 합니다.

Service fn=responder-fastcgi
        app-path="/path/to/php/php_fcgi"
        bind-path="$(lc($urlhost))"
        req-retry=5
        type="*magnus-internal/fastcgi*"
        app-env="PHPRC=/path/to/users/$(lc($urlhost))/config"
        app-env="PHP_FCGI_CHILDREN=5"
        app-env="PHP_FCGI_MAX_REQUEST=200"
        min-procs=1
        restart-interval=10
        bucket="php-bucket"
        rlimit_cpu=60

Web Server tmp 디렉토리에는 이제 PHP 요청을 처리하는 개별 가상 서버를 따라 명명된 Unix 도메인 소켓이 표시됩니다. 이것은 모든 사용자에 대해 단일 PHP FastCGI 바이너리를 사용하기 때문에 가능합니다. 그러므로 단일 바이너리에 바이너리로 컴파일된 필요한 모든 플러그인이 들어 있어야 합니다. 위 문제에 대한 해결책으로 각 사용자는 본인의 필요에 따라 PHP 바이너리 복사본을 가지고 있어야 합니다.

Service fn=responder-fastcgi
        app-path="/path/to/users/$(lc($urlhost))/php_fcgi"
        bind-path="$(lc($urlhost))"
        req-retry=5
        type="*magnus-internal/fastcgi*"
        app-env="PHPRC=/path/to/users/$(lc($urlhost))/config"
        app-env="PHP_FCGI_CHILDREN=5"
        app-env="PHP_FCGI_MAX_REQUEST=200"
        min-procs=1
        restart-interval=10
        bucket="php-bucket"
        rlimit_cpu=60

URI 공간 구조를 제어하여 각 응용 프로그램에 대해 다른 PHP 바이너리를 허용할 수도 있습니다.

예:

URI 공간이 다음과 같이 구성되어 있는 경우:

/app/foo.php

여기에서 /app는 전체 응용 프로그램의 이름으로 PHP 파일로 끝나는 URI 구조에서 항상 첫 번째 디렉토리가 됩니다.

<If uri~=^/(\w+)/\w+\.php$>
						Service fn=responder-fastcgi
						app-path="/path/to/users/$(lc($urlhost))/$1/php_fcgi"
						bind-path="$(lc($urlhost))_$1"
						req-retry=5
						type=+magnus-internal/fastcgi*"
						app-env="PHPRC=/path/to/users/$(lc($urlhost))/config"
						app-env="PHP_FCGI_CHILDREN=5"
						app-env="PHP_FCGI_MAX_REQUEST=200"
						min-procs=1
						restart-interval=10
						bucket="php-bucket"
						rlimit_cpu=60
</If>

이렇게 하면 고유하게 명명된 Unix 도메인 소켓으로 바인드하는 특별히 구성된 PHP FastCGI 바이너리가 호출됩니다. 그러므로 다른 PHP 응용 프로그램이나 가상 서버에 영향을 미치지 않습니다. 하지만 이 프로세스는 다수의 PHP 프로세스로 인해 메모리 사용량이 많습니다.

샘플 구성 파일

다음은 FastCGI에서 PHP를 구성하는 샘플 구성 파일입니다.

<If -f $path>
Service type="magnus-internal/php"
    fn="responder-fastcgi"
    app-path="/opt/coolstack/php5/bin/php-cgi"
    bind-path="localhost:3101"
    app-env="PHPRC=/opt/coolstack/php5"
    app-env="PHP_FCGI_CHILDREN=5"
    app-env="PHP_FCGI_MAX_REQUEST=200"
    app-env="FCGI_WEB_SERVER_ADDRS=127.0.0.1"
    req-retry=5
    restart-interval=10
    bucket="php-bucket"

</If>
<Else>
Service type="magnus-internal/php" fn="set-variable" error="404"
</Else>

FastCGI 플러그인 문제 해결

Fastcgistub은 FastCGI 응용 프로그램 프로세스의 라이프사이클을 관리하는 프로세스 관리자입니다. Fastcgistub은 메시지를 Web Server의 임시 디렉토리 아래의 Fastcgistub.log 파일에 기록합니다. 오류가 발생한 경우에는 이 파일을 확인하면 문제를 디버깅하는 데 도움이 됩니다.

문제: FastCGI 요청이 처리되지 않습니다.

가능한 원인과 해결 방법은 다음과 같습니다.

FastCGI 플러그인이 로드되었는지 확인합니다. Web Server를 시작할 때 다음 메시지가 나타나면 플러그인이 로드된 것입니다. 그렇지 않은 경우 magnus.conf에서 플러그인 라이브러리 경로를 확인합니다.FCGI1000: Sun Java System Web Server 7.0 Update 3 FastCGI NSAPI Plugin < build info>
obj.conf에서 요청 매핑이 정확하게 지정되었는지 확인합니다. obj.conf 파일에 대한 자세한 내용은 Sun Java System Web Server Administrator's Configuration Reference File을 참조하십시오.
오류 로그에 오류 메시지가 있는지 확인합니다.
스텁 바이너리와 FastCGI 응용 프로그램의 권한을 확인합니다. 충분한 권한이 지정되지 않은 경우에는 플러그인에서 스텁 또는 응용 프로그램 시작에 실패합니다.
Fastcgistub.log 파일에서 스텁 부분의 오류가 있는지 확인합니다. <instances>/logs에서 로그 정보를 볼 수 있습니다.
가능한 경우 FastCGI 응용 프로그램을 독립 실행형 모드로 실행하고 문제 없이 실행되는지 확인합니다.

라이브러리 종속성 오류가 발생한 경우에는 obj.conf에서 LD_LIBRARY_PATH를 LD_LIBRARY_PATH=<dependency library paths>인 app-env 매개 변수로 지정합니다.

문제: FastCGI 응용 프로그램이 시작되지 않습니다.

가능한 원인과 해결 방법은 다음과 같습니다.

Fastcgistub.log 파일에 다음 로그 메시지가 있는지 확인합니다.

..
<pid> process startup failure, trying to restart
...
Even after trying <n> time(s), <application path> process failed to start...no more retries

시작 장애의 원인 중에는 종속성 라이브러리 로드 실패가 있을 수 있습니다. 이 문제는 obj.conf 파일에 구성된 FastCGI 응용 프로그램에 app-env 매개 변수 값으로 적절한 라이브러리 경로를 지정하면 해결할 수 있습니다. 예:

Service fn="responder_fastcgi" app-path="/fastcgi/c/tux-app" bind-path="localhost:2112" 
app-env="LD_LIBRARY_PATH=/tuxedo/lib"

FastCGI 응용 프로그램 개발

FastCGI 응용 프로그램은 Perl, PHP, C 및 Java를 사용하여 개발할 수 있습니다. 다음 절에서는 흔히 사용되는 일부 프로그래밍 언어를 통해 응용 프로그램을 개발하는 절차를 간략하게 설명합니다.

FastCGI 응용 프로그램 실행

Web Server를 중지합니다.

Web Server를 다시 시작합니다.

응용 프로그램 루트가 "fcgi"인 응용 프로그램에 액세스합니다.

예: http://localhost/fcgi/ListDir.php

FastCGI 응용 프로그램의 구조

전형적인 FastCGI 응용 프로그램의 코드 구조는 다음과 같습니다.

Initialization code

Start of response loop
		body of response loop
End of response loop

초기화 코드는 응용 프로그램을 초기화할 때 한 번만 실행됩니다. 초기화 코드는 보통 데이터베이스 열기 또는 테이블이나 비트맵의 값 계산과 같이 시간이 오래 걸리는 작업을 수행합니다. CGI 프로그램을 FastCGI 프로그램으로 변환할 때의 주된 작업은 초기화 코드를 각 요청에 대해 실행해야 할 코드와 분리하는 것입니다.

응답 루프는 계속 실행되며 클라이언트 요청이 도착하기를 기다립니다. 루프는 FastCGI 라이브러리에 있는 루틴인 FCGI_Accept에 대한 호출로 시작됩니다. FCGI_Accept 루틴은 클라이언트에서 FastCGI 응용 프로그램을 요청할 때까지 프로그램 실행을 차단합니다. 클라이언트 요청이 들어오면 FCGI_Accept 차단이 해제되고 응답 루프 본문이 한 번 실행된 후 다시 차단되어 다른 클라이언트 요청을 기다립니다. 루프는 시스템 관리자 또는 Web Server가 FastCGI 응용 프로그램을 종료한 경우에만 종료됩니다.

Perl 사용

CPAN에서 최신 FCGI를 다운로드하여 설치합니다. ActivePerl의 경우 http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/Zips에서 모듈을 다운로드할 수 있습니다.

Perl을 사용한 FastCGI 응용 프로그램 작성에 대한 자세한 내용은 http://www.fastcgi.com/#TheDevKit를 참조하십시오.

PHP 사용

PHP 4.3.0 이후로 FastCGI가 PHP 엔진용으로 지원되는 구성이 되었습니다. FastCGI을 지원하는 PHP 4.3.x 이상의 엔진을 컴파일하려면 다음과 같이 작성 과정 중에 구성 스위치 --enable-fastcgi를 포함합니다.

./configure <other-options> --enable-fastcgi
gmake

컴파일이 끝나면 php 바이너리에 FastCGI를 사용할 수 있게 됩니다.

PHP 버전 5.1.2 이하(PHP 4.x 포함)를 사용하는 경우에는 FastCGI 플러그인을 바인드 경로와 함께 host: port 형식으로 구성해야 합니다. 예를 들면 bind-path = "localhost: 3333"과 같습니다.

PHP 버전 5.1.3 이상에서는 bind-path가 선택 사항입니다. 이 값을 지정하는 경우 "host: port" 형식을 사용하면 안 됩니다. 문자열을 지정할 수 있습니다. 예를 들면 bind-path = "myphpbindpath"와 같습니다.

C/Java 사용

FastCGI 개발 키트는 FastCGI C/Java 응용 프로그램을 작성하는 API를 제공합니다. http://www.fastcgi.com/devkit/doc/fcgi-devel-kit.htm에서 키트를 다운로드할 수 있습니다.

다운로드된 FastCGI 개발 키트를 구축하려면 다음 단계를 수행합니다.

tar 파일의 압축을 해제합니다. 이 작업으로 fcgi-devel-kit라는 새 디렉토리가 만들어집니다.
fcgi-devel-kit 디렉토리에서 다음 순서로 명령을 실행합니다.
1. ./configure
2. make

C를 사용한 FastCGI 응용 프로그램 작성에 대한 자세한 내용은 http://www.fastcgi.com/devkit/doc/fcgi-devel-kit.htm#S3을 참조하십시오.

Java를 사용한 FastCGI 응용 프로그램 작성에 대한 자세한 내용은 http://www.fastcgi.com/devkit/doc/fcgi-java.htm을 참조하십시오.