Platform Specific Notes Novell NetWare에서 아파치 사용하기

이 문서는 Novell NetWare 6.0 이상에서 아파치 2.0을 설치, 설정, 실행하는 방법을 설명한다. 버그를 찾았거나 다른 방법으로 돕고싶다면, 버그 보고 페이지를 이용하길 바란다.

버그 보고 페이지나 dev-httpd 메일링리스트는 아파치 설정과 실행에 대한 질문을 답하지 않는다. 버그를 보고하기 전에 먼저 이 문서와 자주 물어보는 질문 (FAQ) 페이지, 다른 관련문서를 살펴봐라. 그래도 궁금한 점이나 문제가 있다면, NetWare에서 아파치 사용에 대한 어렵고 새로운 질문을 답해줄 많은 아파치 사용자가 있는 novell.devsup.webserver 뉴스그룹에 글을 올리길 바란다.

이 문서는 바이너리 배포본으로 아파치를 설치했다고 가정한다. (아마도 개발에 도움을 주거나 버그를 찾기위해) 직접 아파치를 컴파일하려면 아래 NetWare에서 아파치 컴파일하기 절을 참고하라.
요구조건

아파치 2.0은 NetWare 6.0 service pack 3 이상에서 동작하도록 설계되었다. SP3보다 낮은 service pack을 사용한다면 최신 NetWare Libraries for C (LibC)를 설치해야 한다.

NetWare service pack은 여기에 있다.

최신 service pack이나 최신 버전 NetWare Libraries for C (LibC)를 설치했다면 NetWare 5.1 환경에서도 NetWare용 아파치 2.0을 실행할 수 있다. 경고: NetWare용 아파치 2.0은 이 환경을 고려하지 않았고 테스트하지 않았다.

NetWare용 아파치 다운받기

아파치 최신 버전에 대한 정보는 http://www.apache.org/에서 (아파치 웹서버) 찾을 수 있다. 여기에는 현재 버전과 최근 알파/베타테스트 버전, 미러 웹사이트와 ftp 사이트 정보가 있다. NetWare용 아파치 2.0의 최신 바이너리 배포본은 여기에서 다운받을 수 있다.

NetWare용 아파치 설치하기

현재 NetWare용 아파치 설치프로그램은 없다. NetWare용 아파치 2.0 소스를 직접 컴파일한다면 파일을 서버로 직접 복사해줘야 한다.

바이너리로 다운받은 NetWare용 아파치를 설치하는 과정은 다음과 같다 (sys:/apache2에 설치한다고 가정한다):

직접 소스를 컴파일한 경우 NetWare에 아파치를 설치하는 방법은 다음과 같다 (sys:/apache2에 설치한다고 가정한다):

기본 SYS 볼륨이 아닌 다른 볼륨에도 아파치를 설치할 수 있다.

makefile 명령어에 "install" 키워드를 사용하면 컴파일시 자동으로 DIST 하위디렉토리에 완전한 배포본을 만든다. makefile로 만든 배포본을 NetWare 볼륨 최상위 디렉토리로 복사하면 아파치가 설치된다 (아래 NetWare용 아파치 컴파일하기 참고).

NetWare용 아파치 실행하기

아파치를 시작하려면 콘솔에서 apache를 입력하면 된다. 그러면 운영체제 주소영역에 아파치를 읽어들인다. 보호주소영역에 아파치를 읽어들이려면 다음과 같이 load 명령어로 주소영역을 지정한다:

load address space = apache2 apache2

그러면 아파치를 apache2라는 주소영역에 읽어들인다. NetWare는 여러 아파치를 각각 다른 보호주소영역에 읽어들여서 여러 아파치를 동시에 실행할 수 있다.

아파치가 시작하면 (설정파일에서 Listen 지시어를 수정하지 않는한) 포트 80번을 기다린다. 브라우저를 시작하여 서버명 혹은 서버 주소를 입력하면 서버에 접속하여 기본페이지에 접근한다. 아파치 설명서 링크가 있는 환영페이지가 나와야 한다. 아무 일도 없거나 오류가 발생하면 logs 디렉토리에 있는 error_log 파일을 살펴봐라.

기본 설치가 동작하면 conf 디렉토리에 있는 파일을 적절히 설정한다.

운영체제 주소영역에서 실행중인 아파치를 내릴려면 콘솔에 다음과 같이 입력한다:

unload apache2

혹은

apache2 shutdown

보호주소영역에서 아파치를 실행했다면 unload 명령어에 주소영역을 지정한다:

unload address space = apache2 apache2

아파치가 설정파일 위치를 찾는 방법을 알아두어야 한다. 명령행에서 설정파일을 지정하는 방법은 두가지다:

apache2 -f "vol:/my server/conf/my.conf" apache -f test/test.conf

이 경우 설정파일은 올바른 ServerRoot를 설정해야 한다.

-f로 설정파일명을 지정하지 않으면, 아파치는 서버에 컴파일된 파일명을 (보통 conf/httpd.conf) 사용한다. -V 옵션으로 아파치를 시작하면 SERVER_CONFIG_FILE이라는 항목을 보여준다. 아파치는 다음 순서대로 ServerRoot를 찾는다:

서버에 컴파일된 server root는 보통 sys:/apache2이다. -V 옵션으로 아파치를 시작하면 HTTPD_ROOT라는 항목을 보여준다.

NetWare용 아파치 2.0에는 실행중인 웹서버를 죽이거나 정보를 알려주는 명령행 지시어가 있다. 이들 지시어는 아파치 동작중에만 사용할 수 있다. 지시어 앞에는 APACHE2 키워드를 붙여야 한다.

RESTART
모든 쓰레드가 쉬는 상태일때 아파치를 죽이고, 설정파일을 다시 읽은후 새로운 설정에 따라 worker 쓰레드들을 재시작한다.
VERSION
현재 실행중인 아파치 버전 정보를 출력한다.
MODULES
기본 모듈과 외부 모듈 목록을 출력한다.
DIRECTIVES
모든 지시어 목록을 출력한다.
SETTINGS
콘솔에 쓰레드 상태 표시를 보이거나 없앤다. 상태를 보이면, 아파치 콘솔창에 동작하는 쓰레드들의 상태가 나온다.
SHUTDOWN
실행중인 아파치 웹서버를 죽인다.
HELP
실행 옵션들을 설명한다.

기본적으로 이 지시어들은 운영체제 주소영역에서 실행중인 아파치를 대상으로 한다. 아파치가 보호주소영역에서 실행중이라면, -p와 주소영역 이름을 추가한다. 더 많은 정보를 보려면 명령행에 "apache2 Help"를 입력한다.

NetWare용 아파치 설정하기

아파치는 보통 conf 디렉토리에 있는 설정파일로 설정한다. 이 파일은 유닉스용과 같지만, NetWare용 아파치에는 조금 다른 지시어들이 있다. 사용가능한 모든 지시어에 대해서는 아파치 문서를 참고하라.

NetWare용 아파치의 주된 차이점은:

이외의 NetWare 전용 지시어들:
  • CGIMapExtension - CGI 파일 확장자를 스크립트 인터프리터와 연결한다.
  • SecureListen - 특정 포트를 SSL 암호화한다.
  • NWSSLTrustedCerts - 프록시하는 서버에 보안연결할때 사용할 신뢰하는 인증서(certificate)를 추가한다.
  • NWSSLUpgradeable - 특정 주소/포트로 맺어진 연결을 SSL 연결로 변경할 수 있다.
Netware용 아파치 컴파일하기

아파치를 컴파일하려면 MetroWerks CodeWarrior 6.x 이상이 필요하다. 아파치를 컴파일하면 어떤 Netware 볼륨에라도 설치할 수 있다. 기본값은 sys:/Apache2 디렉토리다.

서버를 실행하기 전에 conf 디렉토리를 작성해야 한다. 배포본의 conf 디렉토리에 있는 HTTPD-STD.CONF 파일명을 HTTPD.CONF로 변경한다. HTTPD.CONF 파일에서 @@Value@@ 표시를 찾아서 적절한 설정으로 대체한다. conf/magic과 conf/mime.types 파일도 복사한다. 아니면 makefile을 실행할때 install 키워드를 사용하면 완전한 배포본을 만든다.

요구사항:

NetWare용 아파치 2.0을 컴파일하려면 다음 개발도구가 필요하다:

NetWare makefile을 사용하여 아파치 컴파일하기:
  • NOVELLLIBC 환경변수를 Set NOVELLLIBC=c:\novell\ndk\libc와 같이 NetWare Libraries for C SDK 위치로 설정한다.
  • METROWERKS 환경변수를 Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior와 같이 Metrowerks CodeWarrior 컴파일러를 설치한 위치로 설정한다. 기본 위치인 C:\Program Files\Metrowerks\CodeWarrior에 설치하였다면, 환경변수를 설정할 필요는 없다.
  • LDAPSDK 환경변수를 Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc와 같이 LDAP Libraries for C를 설치한 위치로 설정한다.
  • ZLIBSDK 환경변수를 Set ZLIBSDK=D:\NOVELL\zlib과 같이 ZLib 라이브러리 소스코드 위치로 설정한다.
  • AP_WORK 환경변수를 \httpd-2.0 디렉토리의 전체 경로로 설정한다.
  • APR_WORK 환경변수를 \httpd-2.0\srclib\apr 디렉토리의 전체 경로로 설정한다.
  • AWK 도구와 GNU make (gmake.exe) 도구가 시스템의 PATH 환경변수에 포함되있는지 확인한다.
  • 소스코드를 다운받아 적당한 디렉토리에 압축을 푼다.
  • \httpd-2.0\srclib\apr-util\uri 디렉토리에서 "gmake -f nwgnumakefile"을 실행하여 GENURI.nlm을 컴파일한다.
  • GENURI.nlm 파일을 NetWare 서버의 SYS: 볼륨으로 복사하고 SYS:\genuri > sys:\uri_delims.h 명령을 실행한다.
  • uri_delims.h 파일을 컴파일하는 컴퓨터의 \httpd-2.0\srclib\apr-util\uri 디렉토리로 복사한다.
  • \httpd-2.0\srclib\apr 디렉토리에서 "gmake -f nwgnumakefile"을 실행하여 APR을 컴파일한다.
  • \httpd-2.0\srclib\pcre 디렉토리에서 "gmake -f nwgnumakefile"을 실행하여 DFTABLES.nlm을 컴파일한다.
  • \httpd-2.0\server 디렉토리에서 "gmake -f nwgnumakefile"을 실행하여 GENCHARS.nlm을 컴파일한다.
  • 각 디렉토리의 GENCHARS.nlm과 DFTABLES.nlm 파일을 NetWare 서버의 SYS: 볼륨으로 복사하고 다음과 같이 실행한다: SYS:\genchars > sys:\test_char.h
    SYS:\dftables > sys:\chartables.c
  • test_char.h와 chartables.c 파일을 컴파일하는 컴퓨터의 \httpd-2.0\os\netware 디렉토리로 복사한다.
  • \httpd-2.0 디렉토리에서 "gmake -f nwgnumakefile"을 실행하여 아파치를 컴파일한다. gmake -f nwgnumakefile install과 같이 install 파라미터를 추가하면 배포용 디렉토리를 만들 수 있다.
추가 make 옵션
  • gmake -f nwgnumakefile

    일반 실행파일을 컴파일하여 \release 디렉토리로 복사한다.

  • gmake -f nwgnumakefile DEBUG=1

    디버그용 실행파일을 컴파일하여 \debug 디렉토리로 복사한다.

  • gmake -f nwgnumakefile install

    \dist\Apache2 디렉토리에 실행파일, 문서, 추가 지원파일을 포함한 완전한 아파치 배포본을 만든다.

  • gmake -f nwgnumakefile installdev

    install과 비슷하지만, \lib과 \include 디렉토리를 만들고 헤더파일과 import 파일을 복사한다.

  • gmake -f nwgnumakefile clean

    DEBUG 정의 유무에 따라 \release나 \debug에 있는 오브젝트파일과 실행파일을 모두 지운다.

  • gmake -f nwgnumakefile clobber_all

    clean과 비슷하지만 디렉토리도 지운다.