Apache HTTP Server Version 2.4

Apache > HTTP Server > Documentation > Version 2.4 > 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`에 설치한다고 가정한다):

- 바이너리로 다운받은 압축파일을 `SYS:` 볼륨 최상위 디렉토리에 푼다 (다른 볼륨에 설치해도 된다)
- `httpd.conf` 파일을 수정하여 `ServerRoot`와 `ServerName`과 파일경로 값을 서버에 알맞게 지정한다
- 예를 들어

  `SEARCH ADD SYS:\APACHE2`

  와 같이 검색경로에 `SYS:/APACHE2`를 추가한다

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

- NetWare 볼륨에 `Apache2`라는 디렉토리를 만든다
- `APACHE2.NLM`과 `APRLIB.NLM`을 `SYS:/APACHE2`에 복사한다
- `SYS:/APACHE2` 아래에 `BIN`이라는 디렉토리를 만든다
- `HTDIGEST.NLM`, `HTPASSWD.NLM`, `HTDBM.NLM`, `LOGRES.NLM`, `ROTLOGS.NLM`을 `SYS:/APACHE2/BIN`에 복사한다
- `SYS:/APACHE2` 아래에 `CONF`라는 디렉토리를 만든다
- `HTTPD-STD.CONF` 파일을 `SYS:/APACHE2/CONF`에 복사하고 파일명을 `HTTPD.CONF`로 변경한다
- `MIME.TYPES`, `CHARSET.CONV`, `MAGIC` 파일을 `SYS:/APACHE2/CONF` 디렉토리에 복사한다
- `\HTTPD-2.0\DOCS\ICONS`에 있는 모든 파일과 하위디렉토리를 `SYS:/APACHE2/ICONS`로 복사한다
- `\HTTPD-2.0\DOCS\MANUAL`에 있는 모든 파일과 하위디렉토리를 `SYS:/APACHE2/MANUAL`로 복사한다
- `\HTTPD-2.0\DOCS\ERROR`에 있는 모든 파일과 하위디렉토리를 `SYS:/APACHE2/ERROR`로 복사한다
- `\HTTPD-2.0\DOCS\DICROOT`에 있는 모든 파일과 하위디렉토리를 `SYS:/APACHE2/HTDOCS`로 복사한다
- 서버에 `SYS:/APACHE2/LOGS` 디렉토리를 만든다
- 서버에 `SYS:/APACHE2/APACHE2/CGI-BIN`이란 디렉토리를 만든다
- `SYS:/APACHE2/MODULES` 디렉토리를 만들고 모든 nlm 모듈을 `modules` 디렉토리로 복사한다
- `HTTPD.CONF` 파일의 모든 `@@Value@@` 표시를 적절한 설정으로 대체한다

- `SEARCH ADD SYS:\APACHE2`

  같이 검색경로에 `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`

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

- `-f`는 특정 설정파일 경로를 지정한다

`apache2 -f "vol:/my server/conf/my.conf"`

`apache -f test/test.conf`

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

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

- `-C` 옵션의 `ServerRoot` 지시어.
- 명령행의 `-d` 옵션.
- 현재 디렉토리
- 서버에 컴파일된 server root.

서버에 컴파일된 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용 아파치는 다중쓰레드 방식을 사용하기때문에, 유닉스와 같이 요청마다 다른 프로세스를 사용하지 않는다. 대신 여러 쓰레드를 실행한다: 부모 쓰레드와 요청을 처리하는 여러 자식 혹은 worker 쓰레드들.

  그러므로 "프로세스"-관리 지시어가 다르다:

  `MaxRequestsPerChild` - 유닉스와 같이 worker 쓰레드가 요청을 얼마만큼 처리하고 죽을지를 조정한다. 권장하는 기본값 `MaxRequestsPerChild 0`을 사용하면 쓰레드는 죽지않고 영원히 요청을 서비스한다. 특별한 이유가 없다면 NetWare에서는 이 지시어를 `0`으로 설정하길 권한다.

  `StartThreads` - 이 지시어는 서버가 처음에 시작할 쓰레드 개수를 결정한다. 권장하는 기본값은 `StartThreads 50`이다.

  `MinSpareThreads` - 서버는 쉬는(idle) 쓰레드 개수가 이 값보다 적으면 worker 쓰레드를 더 만든다. 권장하는 기본값은 `MinSpareThreads 10`이다.

  `MaxSpareThreads` - 서버는 쉬는 쓰레드 개수가 이 값보다 많으면 worker 쓰레드를 죽이기 시작한다. 권장하는 기본값은 `MaxSpareThreads 100`이다.

  `MaxThreads` - 이 지시어는 worker 쓰레드의 최대 개수를 제한한다. 권장하는 기본값은 `ThreadsPerChild 250`이다.

  `ThreadStackSize` - 한 worker 쓰레드가 사용할 스택 크기를 지시한다. 권장하는 기본값은 `ThreadStackSize 65536`이다.

- 아규먼트로 파일명을 받는 지시어에는 유닉스 파일명이 아닌 NetWare 파일명을 사용해야 한다. 그러나 아파치가 내부적으로 유닉스식 파일명을 사용하기때문에 백슬래쉬 대신 슬래쉬를 사용해야 한다. 모든 절대경로에 볼륨명을 포함하길 바란다. 볼륨명을 생략하면 아파치는 `SYS:` 볼륨이라고 잘못 가정할 수 있다.

- NetWare용 아파치는 서버를 다시 컴파일하지 않고 실행할때 모듈을 읽어들일 수 있다. 보통 아파치를 컴파일하면 `\Apache2\modules` 디렉토리에 여러 추가 모듈을 설치한다. 이들 혹은 다른 모듈을 사용하려면 `LoadModule` 지시어를 사용한다. 예를 들어 status 모듈을 사용한다면:

  `LoadModule status_module modules/status.nlm`

  읽어들일 수 있는 모듈 만들기에 대한 정보도 있다.

### 이외의 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을 컴파일하려면 다음 개발도구가 필요하다:

- Metrowerks CodeWarrior 6.0 이상과 NetWare PDK 3.0 이상.
- NetWare Libraries for C (LibC)
- LDAP Libraries for C
- ZLIB 압축 라이브러리 소스코드
- AWK 도구 (awk, gawk 등). AWK는 http://developer.novell.com/ndk/apache.htm에서 다운받을 수 있다. 도구를 `awk.exe`란 이름으로 윈도우즈 경로에 두어야 한다.
- makefile을 사용하여 컴파일하려면 http://developer.novell.com/ndk/apache.htm에 있는 GNU make 버전 3.78.1 (GMake)이 필요하다.

### 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과 비슷하지만 디렉토리도 지운다.