Dispatcher 설치

Dispatcher 릴리스 정보 페이지를 사용하여 운영 체제 및 웹 서버에 대한 최신 Dispatcher 설치 파일을 가져옵니다. Dispatcher 릴리스 번호는 Adobe Experience Manager 릴리스 번호와 독립적이며 Adobe Experience Manager 6.x, 5.x 및 Adobe CQ 5.x 릴리스와 호환됩니다.

노트

Adobe Experience Manager 6.5에는 Dispatcher 버전 4.3.2 이상이 필요합니다. 즉, Dispatcher 버전은 AEM과 독립적입니다. 예를 들어 Dispatcher 버전 4.3.2는 Adobe Experience Manager 6.4와도 호환됩니다.

다음 파일 이름 지정 규칙이 사용됩니다.

dispatcher-<web-server>-<operating-system>-<dispatcher-version-number>.<file-format>

예를 들어 dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz 파일에는 Linux i686에서 실행되는 Apache 2.4 웹 서버용 Dispatcher 버전 4.3.1이 포함되어 있으며 파일은 tar 형식을 사용하여 패키지됩니다.

다음 표에는 각 웹 서버의 파일 이름에 사용되는 웹 서버 식별자가 나열되어 있습니다.

웹 서버 설치 키트
Apache 2.4 dispatcher-apache 2.4-<기타 매개 변수>
Microsoft Internet Information Server 7.5, 8, 8.5 dispatcher-iis-<기타 매개 변수>
Sun Java 웹 서버 iPlanet dispatcher-ns-<기타 매개 변수>
주의

플랫폼에 사용할 수 있는 최신 버전의 Dispatcher를 설치해야 합니다. 제품 개선 사항을 활용하려면 매년 최신 버전을 사용하도록 Dispatcher 인스턴스를 업그레이드해야 합니다.

각 아카이브에는 다음 파일이 포함되어 있습니다.

  • Dispatcher 모듈
  • 예제 구성 파일
  • 설치 지침과 최신 정보가 포함된 추가 정보 파일
  • 현재 및 과거 릴리스에서 수정된 문제를 나열하는 변경 사항 파일
노트

설치를 시작하기 전에 추가 정보 파일에서 마지막 변경 사항/플랫폼별 참고 사항을 확인하십시오.

Microsoft Internet Information Server

이 웹 서버를 설치하는 방법에 대한 정보는 다음 리소스를 참조하십시오.

필수 IIS 구성 요소

IIS 버전 8.5 및 10에는 다음 IIS 구성 요소가 설치되어 있어야 합니다.

  • ISAPI 확장

또한 웹 서버(IIS) 역할을 추가해야 합니다. 서버 관리자를 사용하여 역할 및 구성 요소를 추가합니다.

Microsoft IIS - Dispatcher 모듈 설치

Microsoft Internet Information System에 필요한 아카이브는 다음과 같습니다.

  • dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip

ZIP 파일에는 다음 파일이 포함되어 있습니다.

파일 설명
disp_iis.dll Dispatcher 동적 링크 라이브러리 파일입니다.
disp_iis.ini IIS에 대한 구성 파일입니다. 이 예제는 요구 사항에 따라 업데이트할 수 있습니다. 참고: ini 파일은 dll과 동일한 루트 이름을 가져야 합니다.
dispatcher.any Dispatcher에 대한 예제 구성 파일입니다.
author_dispatcher.any 작성자 인스턴스로 작업하는 Dispatcher의 예제 구성 파일입니다.
추가 정보 설치 지침과 최신 정보가 포함된 추가 정보 파일입니다. 참고: 설치를 시작하기 전에 이 파일을 확인하십시오.
변경 사항 현재 및 과거 릴리스에서 수정된 문제를 나열하는 변경 사항 파일.

다음 절차에 따라 Dispatcher 파일을 올바른 위치에 복사합니다.

  1. Windows 탐색기를 사용하여 <IIS_INSTALLDIR>/Scripts 디렉터리(예: C:\inetpub\Scripts)를 생성합니다.

  2. Dispatcher 패키지에서 이 Scripts 디렉터리로 다음 파일의 압축을 풉니다.

    • disp_iis.dll
    • disp_iis.ini
    • Dispatcher가 AEM 작성자 인스턴스 또는 게시 인스턴스와 함께 작동하는지 여부에 따라 다음 파일 중 하나입니다.
      • 작성자 인스턴스: author_dispatcher.any
      • 게시 인스턴스: dispatcher.any

Microsoft IIS - Dispatcher INI 파일 구성

disp_iis.ini 파일을 편집하여 Dispatcher 설치를 구성합니다 .ini 파일의 기본 형식은 다음과 같습니다.

[main]
configpath=<path to dispatcher.any>
loglevel=1|2|3
servervariables=0|1
replaceauthorization=0|1

다음 표에서는 각 속성에 대해 설명합니다.

매개 변수 설명
configpath 로컬 파일 시스템 내 dispatcher.any의 위치(절대 경로)입니다.
logfile dispatcher.log 파일의 위치입니다. 설정되지 않은 경우, 로그 메시지는 Windows 이벤트 로그로 이동합니다.
loglevel 이벤트 로그에 메시지를 출력하는 데 사용되는 로그 수준을 정의합니다. 다음과 같은 로그 파일의 로그 수준 값을 지정할 수 있습니다.
0 - 오류 메시지만.
1 - 오류 및 경고.
2 - 오류, 경고 및 정보 메시지
3 - 오류, 경고, 정보 및 디버그 메시지.
참고: 설치 및 테스트 중에는 로그 수준을 3으로 설정하고 프로덕션 환경에서 실행할 때는 0으로 설정하는 것이 좋습니다.
replaceauthorization HTTP 요청의 권한 부여 헤더가 처리되는 방식을 지정합니다. 다음 값이 유효합니다.
0 - 인증 헤더가 수정되지 않습니다.
1 - “Basic” 이외의 “Authorization”이라는 헤더를 Basic <IIS:LOGON\_USER>에 해당하는 헤더로 바꿉니다.
servervariables 서버 변수가 처리되는 방법을 정의합니다.
0 - IIS 서버 변수가 Dispatcher나 AEM으로 전송되지 않습니다.
1 - 모든 IIS 서버 변수(예: LOGON\_USER, QUERY\_STRING, ...)가 요청 헤더와 함께 Dispatcher로 전송됩니다(캐시되지 않은 경우 AEM 인스턴스로도 전송됨).
서버 변수에는 AUTH\_USER, LOGON\_USER, HTTPS\_KEYSIZE 등이 포함됩니다. 자세한 내용과 함께 전체 변수 목록은 IIS 설명서를 참조하십시오.
enable_chunked_transfer 클라이언트 응답에 대한 청크 전송을 활성화(1) 또는 비활성화(0)할지 여부를 정의합니다. 기본값은 0입니다.

예제 구성:

[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0

Microsoft IIS 구성

Dispatcher ISAPI 모듈을 통합하도록 IIS를 구성합니다. IIS에서는 와일드카드 애플리케이션 매핑을 사용합니다.

익명 액세스 구성 - IIS 8.5 및 10

작성자 인스턴스의 기본 플러시 복제 에이전트가 플러시 요청과 함께 보안 자격 증명을 전송하지 않도록 구성되었습니다. 따라서 Dispatcher 캐시를 사용하는 웹 사이트에서는 익명 액세스를 허용해야 합니다.

웹 사이트에서 인증 방법을 사용하는 경우 플러시 복제 에이전트를 그에 따라 구성해야 합니다.

  1. IIS 관리자를 열고 Disptcher 캐시로 사용 중인 웹 사이트를 선택합니다.
  2. 기능 보기 모드를 사용하여 IIS 섹션에서 인증을 더블 클릭합니다.
  3. 익명 인증이 활성화되지 않은 경우 익명 인증을 선택하고 작업 영역에서 [사용]을 클릭합니다.

Dispatcher ISAPI 모듈 통합 - IIS 8.5 및 10

다음 절차에 따라 Dispatcher ISAPI 모듈을 IIS에 추가합니다.

  1. IIS 관리자를 엽니다.

  2. Dispatcher 캐시로 사용 중인 웹 사이트를 선택합니다.

  3. 기능 보기 모드를 사용하여 IIS 섹션에서 [핸들러 매핑]을 더블 클릭합니다.

  4. 핸들러 매핑 페이지의 작업 패널에서 [와일드카드 스크립트 맵 추가]를 클릭하고 다음 속성 값을 추가한 다음 [확인]을 클릭합니다.

    • 요청 경로: *
    • 실행 파일: disp_iis.dll 파일의 절대 경로(예: C:\inetpub\Scripts\disp_iis.dll).
    • 이름: 핸들러 매핑에 대한 설명적인 이름(예: Dispatcher).
  5. 표시되는 대화 상자에서 ISAPI 및 CGI 제한 목록에 disp_iis.dll 라이브러리를 추가하려면 [예]를 클릭합니다.

    IIS 7.0 및 7.5의 경우 구성이 완료되었습니다. IIS 8.0을 구성하는 경우 나머지 단계를 계속 진행합니다.

  6. (IIS 8.0) 핸들러 매핑 목록에서 방금 만든 매핑을 선택하고 작업 영역에서 [편집]을 클릭합니다.

  7. (IIS 8.0) 스크립트 맵 편집 대화 상자에서 요청 제한 버튼을 클릭합니다.

  8. (IIS 8.0) 아직 캐시되지 않은 파일 및 폴더에 핸들러가 사용되도록 하려면 [요청이 매핑된 경우에만 핸들러 호출]을 선택 취소한 다음 [확인]을 클릭합니다.

  9. (IIS 8.0) 스크립트 맵 편집 대화 상자에서 [확인]을 클릭합니다.

캐시에 대한 액세스 구성 - IIS 8.5 및 10

기본 앱 풀 사용자에게 Dispatcher 캐시로 사용 중인 폴더에 대한 쓰기 액세스 권한을 제공합니다.

  1. Dispatcher 캐시로 사용 중인 웹 사이트의 루트 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(예: C:\inetpub\wwwroot)을 클릭합니다.

  2. 보안 탭에서 [편집]을 클릭한 다음 사용 권한 대화 상자에서 [추가]를 클릭합니다. 사용자 계정을 선택하는 대화 상자가 열립니다. 위치 버튼을 클릭하고 컴퓨터 이름을 선택한 다음 [확인]을 클릭합니다.

    다음 단계를 완료하는 동안 이 대화 상자를 열어 두십시오.

  3. IIS 관리자에서 Dispatcher 캐시에 사용할 IIS 사이트를 선택하고 창 오른쪽에서 [고급 설정]을 클릭합니다.

  4. 애플리케이션 풀 속성의 값을 선택하고 클립보드에 복사합니다.

  5. 열린 대화 상자로 돌아갑니다. 선택할 개체 이름 입력 상자에 IIS AppPool\을 입력한 다음 클립보드의 내용을 붙여넣습니다. 값은 다음 예제와 같아야 합니다.

    IIS AppPool\DefaultAppPool

  6. 이름 확인 버튼을 클릭합니다. Windows에서 사용자 계정을 확인하면 [확인]을 클릭합니다.

  7. Dispatcher 폴더의 권한 대화 상자에서 방금 추가한 계정을 선택하고 전체 제어를 제외한 계정에 대한 모든 권한을 활성화한 다음 [확인]을 클릭합니다. [확인]을 클릭하여 폴더 속성 대화 상자를 닫습니다.

JSON Mime 유형 등록 - IIS 8.5 및 10

Dispatcher가 JSON 호출을 허용하도록 하려면 다음 절차를 사용하여 JSON MIME 유형을 등록하십시오.

  1. IIS 관리자에서 웹 사이트를 선택하고 기능 보기를 사용하여 Mime 유형을 더블 클릭합니다.

  2. JSON 확장이 목록에 없는 경우 작업 패널에서 [추가]를 클릭하고 다음 속성 값을 입력한 후 [확인]을 클릭합니다.

    • 파일 이름 확장명: .json
    • MIME 유형: application/json

bin 숨겨진 세그먼트 제거 - IIS 8.5 및 10

다음 절차를 사용하여 bin 숨겨진 세그먼트를 제거합니다. 새 세그먼트가 아닌 웹 사이트에는 이 숨겨진 세그먼트가 포함될 수 있습니다.

  1. IIS 관리자에서 웹 사이트를 선택하고 기능 보기를 사용하여 요청 필터링을 더블 클릭합니다.
  2. bin 세그먼트를 선택하고 [제거]를 클릭한 다음 확인 대화 상자에서 [예]를 클릭합니다.

파일에 IIS 메시지 로깅 - IIS 8.5 및 10

다음 절차를 사용하여 Dispatcher 로그 메시지를 Windows 이벤트 로그 대신 로그 파일에 기록합니다. 로그 파일을 사용하도록 Dispatcher를 구성하고 IIS에 파일에 대한 쓰기 권한을 제공해야 합니다.

  1. Windows 탐색기를 사용하여 IIS 설치의 로그 폴더 아래에 dispatcher 라는 폴더를 만듭니다. 일반 설치의 경우 이 폴더의 경로는 C:\inetpub\logs\dispatcher입니다.

  2. Dispatcher 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성을 클릭합니다.

  3. 보안 탭에서 [편집]을 클릭한 다음 사용 권한 대화 상자에서 [추가]를 클릭합니다. 사용자 계정을 선택하는 대화 상자가 열립니다. 위치 버튼을 클릭하고 컴퓨터 이름을 선택한 다음 [확인]을 클릭합니다.

    다음 단계를 완료하는 동안 이 대화 상자를 열어 두십시오.

  4. IIS 관리자에서 Dispatcher 캐시에 사용할 IIS 사이트를 선택하고 창 오른쪽에서 [고급 설정]을 클릭합니다.

  5. 애플리케이션 풀 속성의 값을 선택하고 클립보드에 복사합니다.

  6. 열린 대화 상자로 돌아갑니다. 선택할 개체 이름 입력 상자에 IIS AppPool\을 입력한 다음 클립보드의 내용을 붙여넣습니다. 값은 다음 예제와 같아야 합니다.

    IIS AppPool\DefaultAppPool

  7. 이름 확인 버튼을 클릭합니다. Windows에서 사용자 계정을 확인하면 [확인]을 클릭합니다.

  8. Dispatcher 폴더의 권한 대화 상자에서 방금 추가한 계정을 선택하고 전체 제어를 제외한 계정에 대한 모든 권한을 활성화한 다음 [확인]을 클릭합니다. [확인]을 클릭하여 폴더 속성 대화 상자를 닫습니다.

  9. 텍스트 편집기를 사용하여 disp_iis.ini 파일을 엽니다.

  10. 다음 예제와 유사한 텍스트 행을 추가하여 로그 파일의 위치를 구성한 다음 파일을 저장합니다.

    logfile=C:\inetpub\logs\dispatcher\dispatcher.log
    

다음 단계

Dispatcher 사용을 시작하려면 먼저 다음과 같은 사항을 알아야 합니다.

Apache 웹 서버

주의

WindowsUnix 모두 에서의 설치 지침은 여기에서 다룹니다. 주의하여 단계를 수행하십시오.

Apache 웹 서버 설치

Apache 웹 서버를 설치하는 방법에 대한 자세한 내용은 설치 설명서(온라인 또는 배포 시)을 참조하십시오.

주의

소스 파일을 컴파일하여 Apache 바이너리를 생성하는 경우 동적 모듈 지원​을 사용하도록 설정해야 합니다. 이 작업을 –enable-shared 옵션을 사용하여 수행할 수 있습니다. 최소한 mod_so 모듈을 포함하십시오.

자세한 내용은 Apache 웹 서버 설치 설명서에서 확인할 수 있습니다.

Apache HTTP Server 보안 팁보안 보고서도 참조하십시오.

Apache 웹 서버 - Dispatcher 모듈 추가

Dispatcher는 다음 중 하나로 제공됩니다.

  • Windows: 동적 링크 라이브러리(DLL)
  • Unix: 동적 공유 개체(DSO)

설치 아카이브 파일에는 Windows 또는 Unix를 선택했는지 여부에 따라 다음 파일이 포함되어 있습니다.

파일 설명
disp_apache<x.y>.dll Windows: Dispatcher 동적 링크 라이브러리 파일입니다.
dispatcher-apache<x.y>-<rel-nr>.so Unix: Dispatcher 공유 개체 라이브러리 파일입니다.
mod_dispatcher.so Unix: 예제 링크입니다.
http.conf.disp<x> Apache 서버에 대한 예제 구성 파일입니다.
dispatcher.any Dispatcher에 대한 예제 구성 파일입니다.
추가 정보 설치 지침과 최신 정보가 포함된 추가 정보 파일입니다. 참고: 설치를 시작하기 전에 이 파일을 확인하십시오.
변경 사항 현재 및 과거 릴리스에서 수정된 문제를 나열하는 변경 사항 파일입니다.

다음 단계를 사용하여 Apache 웹 서버에 Dispatcher를 추가합니다.

  1. Dispatcher 파일을 적절한 Apache 모듈 디렉터리에 배치합니다.

    • Windows: disp_apache<x.y>.dll <APACHE_ROOT>/modules를 배치합니다.
    • Unix: 설치에 따라 <APACHE_ROOT>/libexec 또는 <APACHE_ROOT>/modules디렉터리를 찾습니다.
      dispatcher-apache<options>.so를 이 디렉터리에 복사합니다.
      장기 유지 관리를 단순화하기 위해 Dispatcher에 mod_dispatcher.so 라는 심볼 링크를 만들 수도 있습니다.
      ln -s dispatcher-apache<x>-<os>-<rel-nr>.so mod_dispatcher.so
  2. dispatcher.any 파일을 <APACHE_ROOT>/conf 디렉터리에 복사합니다.

    참고: Dispatcher 모듈의 DispatcherLog 속성이 적절하게 구성되어 있는 한 이 파일을 다른 위치에 배치할 수 있습니다. (아래의 Dispatcher별 구성 항목을 참조하십시오.)

Apache 웹 서버 - SELinux 속성 구성

SELinux가 활성화된 RedHat Linux Kernel 2.6에서 Dispatcher를 실행하는 경우 Dispatcher 로그 파일에서 다음과 같은 오류 메시지가 나타날 수 있습니다.

Mon Jun 30 00:03:59 2013] [E] [16561(139642697451488)] Unable to connect to backend rend01 (10.122.213.248:4502): Permission denied

이는 SELinux 보안 기능이 활성화되어 있기 때문일 수 있습니다. 그런 다음, 다음의 작업을 수행해야 합니다.

  • Dispatcher 모듈 파일의 SELinux 컨텍스트를 구성합니다.
  • HTTPD 스크립트 및 모듈을 활성화하여 네트워크 연결을 만듭니다.
  • 캐시된 파일이 저장되는 docroot의 SELinux 컨텍스트를 구성합니다.

터미널 창에 다음 명령을 입력합니다. [path to the dispatcher.so file]을 Apache 웹 서버에 설치한 Dispatcher 모듈의 경로로 바꾸고, path to the docroot​를 docroot가 있는 경로로 바꿉니다(예: /opt/cq/cache):

semanage fcontext -a -t httpd_modules_t [path to the dispatcher.so file]
setsebool -P httpd_can_network_connect on
chcon -R --type httpd_sys_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_content_t "[path to the docroot](/.*)?"

Apache 웹 서버 - Dispatcher용 Apache 웹 서버 구성

httpd.conf을 사용하여 Apache 웹 서버를 구성해야 합니다. Dispatcher 설치 키트에서 httpd.conf.disp<x>라는 예제 구성 파일을 찾을 수 있습니다.

다음 단계는 필수입니다.

  1. <APACHE_ROOT>/conf로 이동합니다.

  2. 편집을 위해 httpd.conf를 엽니다.

  3. 나열된 순서대로 다음 구성 항목을 추가해야 합니다.

    • 시작 시 모듈을 로드하는 LoadModule.
    • DispatcherConfig, DispatcherLogDispatcherLogLevel​을 포함한 Dispatcher 관련 구성 항목.
    • Dispatcher를 활성화하는 SetHandler. LoadModule.
    • mod_mime​의 동작을 구성하는 ModMimeUsePathInfo.
  4. (선택 사항) htdocs 디렉터리의 소유자를 변경하는 것이 좋습니다.

    • Apache 서버는 루트로 시작하지만 하위 프로세스는 (보안을 위해) 디먼으로 시작합니다. The DocumentRoot(<APACHE_ROOT>/htdocs) 는 사용자 디먼에 속해야 합니다.

      cd <APACHE_ROOT>  
      chown -R daemon:daemon htdocs
      

LoadModule

다음 표에는 사용할 수 있는 예제가 나열되어 있습니다. 정확한 항목은 특정 Apache 웹 서버에 따라 다릅니다.

Windows ... LoadModule dispatcher_module modules\disp_apache.dll ...
Unix(심볼 링크로 가정함) ... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
노트

각 명령문의 첫 번째 매개 변수는 위의 예제와 정확히 동일하게 작성해야 합니다.

이 명령에 대한 자세한 내용은 제공된 예제 구성 파일 및 Apache 웹 서버 설명서를 참조하십시오.

Dispatcher별 구성 항목

Dispatcher별 구성 항목은 LoadModule 항목 뒤에 배치됩니다. 다음 표에는 Unix와 Windows 모두에 적용할 수 있는 예제 구성이 나열되어 있습니다.

Windows 및 Unix

...
<fModule disp_apache2.c>
DispatcherConfig conf/dispatcher.any
DispatcherLog logs/dispatcher.log DispatcherLogLevel 3
DispatcherNoServerHeader 0 DispatcherDeclineRoot 0
DispatcherUseProcessedURL 0
DispatcherPassError 0
DispatcherKeepAliveTimeout 60
</IfModule>
...

개별 구성 매개 변수:

매개 변수 설명
DispatcherConfig Dispatcher 구성 파일의 위치 및 이름입니다.
이 속성이 주 서버 구성에 있는 경우 모든 가상 호스트는 속성 값을 상속합니다. 단, 가상 호스트는 DispatcherConfig 속성을 포함하여 기본 서버 구성을 재정의할 수 있습니다.
DispatcherLog 로그 파일의 위치 및 이름입니다.
DispatcherLogLevel 로그 파일의 로그 수준:
0 - 오류
1 - 경고
2 - 정보
3 - 디버그
참고: 설치 및 테스트 중에는 로그 수준을 3으로 설정한 다음 프로덕션 환경에서 실행할 때는 0으로 설정하는 것이 좋습니다.
DispatcherNoServerHeader 이 매개 변수는 더 이상 사용되지 않으며 더 이상 영향을 주지 않습니다.

사용할 서버 헤더를 정의합니다.
  • 정의되지 않음 또는 0 - HTTP 서버 헤더에 AEM 버전이 포함됩니다.
  • 1 - Apache 서버 헤더가 사용됩니다.
DispatcherDeclineRoot 루트 “/”에 대한 요청을 거절할지 여부를 정의합니다.
0 - / 요청을 수락합니다
1 - / 요청을 Dispatcher에서 처리하지 않습니다. 올바른 매핑을 위해 mod_alias를 사용하십시오.
DispatcherUseProcessedURL Dispatcher의 모든 추가 처리에 사전 처리된 URL을 사용할지 여부를 정의합니다.
0 - 웹 서버에 전달된 원래 URL을 사용합니다.
1 - Dispatcher가 웹 서버에 전달된 원래 URL 대신 Dispatcher 앞에 오는 핸들러에 의해 이미 처리된 URL(즉, mod_rewrite)을 사용합니다. 예를 들어 원본 또는 처리된 URL이 Dispatcher 필터와 일치합니다. URL은 캐시 파일 구조의 기초로도 사용됩니다. mod_rewrite에 대한 정보는 Apache 웹 사이트 설명서를 참조하십시오. 예를 들어 Apache 2.4. mod_rewrite를 사용할 때는 “passthrough” 플래그를 사용하는 것이 좋습니다.
DispatcherPassError ErrorDocument 처리를 위해 오류 코드를 지원하는 방법을 정의합니다.
0 - Dispatcher가 클라이언트에 대한 모든 오류 응답을 스풀 처리합니다.
1 - Dispatcher가 클라이언트에 오류 응답을 스풀 처리하지 않지만(상태 코드가 400보다 크거나 같은 경우) 상태 코드를 Apache에 전달합니다. 예를 들어 ErrorDocument 지시문이 이러한 상태 코드를 처리할 수 있도록 허용합니다.
코드 범위 -응답이 Apache에 전달되는 오류 코드의 범위를 지정합니다. 다른 오류 코드는 클라이언트에 전달됩니다. 예를 들어 다음 구성은 오류 412에 대한 응답을 클라이언트에 전달하고 다른 모든 오류는 Apache에 전달합니다. DispatcherPassError 400-411,413-417
DispatcherKeepAliveTimeout keep-alive 시간 제한을 초 단위로 지정합니다. Dispatcher 버전 4.2.0부터 기본 keep-alive 값은 60입니다. 값이 0이면 keep-alive가 비활성화됩니다.
DispatcherNoCanonURL 이 매개 변수를 On으로 설정하면 정규화된 URL 대신 원시 URL이 백엔드에 전달되고 DispatcherUseProcessedURL 설정이 무시됩니다. 기본값은 Off입니다.
참고: Dispatcher 구성의 필터 규칙은 항상 원시 URL이 아닌 정리된 URL에 대해 평가됩니다.
노트

경로 항목은 Apache 웹 서버의 루트 디렉터리에 상대적입니다.

노트

서버 헤더의 기본 설정은 다음과 같습니다.

ServerTokens Full

DispatcherNoServerHeader 0

(통계적 목적을 위해) AEM 버전을 보여 주는 것입니다. 헤더에서 이러한 정보를 사용할 수 없도록 비활성화하려면 다음을 설정할 수 있습니다.

ServerTokens Prod

자세한 내용은 ServerTokens 지시문에 대한 Apache 설명서(예를 들면, Apache 2.4용)를 참조하십시오.

SetHandler

이러한 항목 뒤에는 Dispatcher가 수신 요청을 처리할 수 있도록 구성 컨텍스트(<Directory>, <Location>)에 SetHandler 문을 추가해야 합니다. 다음 예제에서는 전체 웹 사이트에 대한 요청을 처리하도록 Dispatcher를 구성합니다.

Windows 및 Unix

...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

다음 예제에서는 가상 도메인에 대한 요청을 처리하도록 Dispatcher를 구성합니다.

Windows

...  
<VirtualHost 123.45.67.89>  
ServerName www.mycompany.com  
DocumentRoot _\[cache-path\]_\\docs  
<Directory _\[cache-path\]_\\docs>  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
AllowOverride None  
</Directory>  
</VirtualHost>  
...

Unix

...  
<VirtualHost 123.45.67.89>  
ServerName www.mycompany.com  
DocumentRoot /usr/apachecache/docs  
<Directory /usr/apachecache/docs>  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
</IfModule>  
AllowOverride None  
</Directory>  
</VirtualHost>  
...
노트

SetHandler 문의 매개 변수는 모듈에 정의된 핸들러 이름이므로 위의 예제와 정확히 동일하게 작성되어야 합니다.

이 명령에 대한 자세한 내용은 제공된 예제 구성 파일 및 Apache 웹 서버 설명서를 참조하십시오.

ModMimeUsePathInfo

SetHandler 문 뒤에 ModMimeUsePathInfo 정의도 추가해야 합니다.

노트

ModMimeUsePathInfo 매개 변수는 Dispatcher 버전 4.0.9 이상을 사용하는 경우에만 사용하고 구성해야 합니다.

(Dispatcher 버전 4.0.9는 2011년에 릴리스되었습니다. 이전 버전을 사용하는 경우 최신 Dispatcher 버전으로 업그레이드하는 것이 적절합니다).

ModMimeUsePathInfo 매개 변수는 모든 Apache 구성에 대해 On으로 설정해야 합니다.

ModMimeUsePathInfo On

mod_mime 모듈(예: Apache Module mod_mime참조)은 HTTP 응답을 위해 선택한 콘텐츠에 콘텐츠 메타데이터를 할당하는 데 사용됩니다. 기본 설정은 mod_mime이 콘텐츠 유형을 결정할 때 파일이나 디렉터리에 매핑되는 URL 부분만 고려된다는 것을 의미합니다.

On인 경우 ModMimeUsePathInfo 매개 변수는 mod_mimecomplete URL을 기반으로 콘텐츠 유형을 결정하도록 지정합니다. 즉, 해당 확장을 기반으로 가상 리소스에 메타 정보가 적용됩니다.

다음 예제에서는 ModMimeUsePathInfo​를 활성화합니다.

Windows 및 Unix

...  
<Directory />  
<IfModule disp\_apache2.c>  
SetHandler dispatcher-handler  
ModMimeUsePathInfo On  
</IfModule>  
  
Options FollowSymLinks  
AllowOverride None  
</Directory>  
...

HTTPS 지원 활성화(Unix 및 Linux)

Dispatcher는 OpenSSL을 사용하여 HTTP를 통한 보안 통신을 구현합니다. Dispatcher 버전 4.2.0​부터 OpenSSL 1.0.0 및 OpenSSL 1.0.1이 지원됩니다. Dispatcher는 기본적으로 OpenSSL 1.0.0을 사용합니다. OpenSSL 1.0.1을 사용하려면 Dispatcher가 설치된 OpenSSL 라이브러리를 사용하도록 다음 절차에 따라 심볼 링크를 만듭니다.

  1. 터미널을 열고 현재 디렉터리를 OpenSSL 라이브러리가 설치된 디렉터리로 변경합니다. 예를 들면 다음과 같습니다.

    cd /usr/lib64
    
  2. 심볼 링크를 만들려면 다음 명령을 입력합니다.

    ln -s libssl.so libssl.so.1.0.1
    ln -s libcrypto.so libcrypto.so.1.0.1
    
노트

사용자 지정된 Apache 버전을 사용하는 경우 Apache와 Dispatcher가 동일한 버전의 OpenSSL을 사용하여 컴파일되었는지 확인하십시오.

다음 단계

Dispatcher 사용을 시작하려면 먼저 다음과 같은 사항을 알아야 합니다.

Sun Java System 웹 서버/iPlanet

노트

여기에서는 Windows 및 Unix 환경에 대한 지침을 다룹니다.

실행할 항목을 선택할 때 주의하십시오.

Sun Java System 웹 서버/iPlanet - 웹 서버 설치

이러한 웹 서버를 설치하는 방법에 대한 전체 정보는 해당 문서를 참조하십시오.

  • Sun Java System 웹 서버
  • iPlanet 웹 서버

Sun Java System 웹 서버/iPlanet - Add the Dispatcher 모듈 추가

Dispatcher는 다음 중 하나로 제공됩니다.

  • Windows: 동적 링크 라이브러리(DLL)
  • Unix: 동적 공유 개체(DSO)

설치 아카이브 파일에는 Windows 또는 Unix를 선택했는지 여부에 따라 다음 파일이 포함되어 있습니다.

파일 설명
disp_ns.dll Windows: Dispatcher 동적 링크 라이브러리 파일입니다.
dispatcher.so Unix: Dispatcher 공유 개체 라이브러리 파일입니다.
dispatcher.so Unix: 예제 링크입니다.
obj.conf.disp iPlanet/Sun Java System 웹 서버에 대한 예제 구성 파일입니다.
dispatcher.any Dispatcher에 대한 예제 구성 파일입니다.
추가 정보 설치 지침과 최신 정보가 포함된 추가 정보 파일입니다. 참고: 설치를 시작하기 전에 이 파일을 확인하십시오.
변경 사항 현재 및 과거 릴리스에서 수정된 문제를 나열하는 변경 사항 파일입니다.

다음 단계를 사용하여 웹 서버에 Dispatcher를 추가합니다.

  1. 웹 서버의 plugin 디렉터리에 Dispatcher 파일을 배치합니다.

Sun Java System 웹 서버/iPlanet - Dispatcher를 위한 구성

obj.conf를 사용하여 웹 서버를 구성해야 합니다. Dispatcher 설치 키트에서 obj.conf.disp라는 예제 구성 파일을 찾을 수 있습니다.

  1. 다음으로 이동 <WEBSERVER_ROOT>/config.

  2. 편집을 위해 obj.conf를 엽니다.

  3. 다음
    Service fn="dispService"
    로 시작하는 행을 obj.conf.disp에서 obj.conf의 초기화 섹션으로 복사합니다.

  4. 변경 사항을 저장합니다.

  5. 편집을 위해 magnus.conf를 엽니다.

  6. 다음
    Init funcs="dispService, dispInit"

    Init fn="dispInit"
    로 시작하는 두 행을 obj.conf.disp에서 magnus.conf의 초기화 섹션으로 복사합니다.

  7. 변경 사항을 저장합니다.

노트

다음 구성은 모두 한 줄에 있어야 하며 $(SERVER_ROOT)$(PRODUCT_SUBDIR) 은 해당 값으로 대체되어야 합니다.

Init

다음 표에는 사용할 수 있는 예제가 나열되어 있습니다. 정확한 항목은 특정 웹 서버에 따라 다릅니다.

Windows 및 Unix

...  
Init funcs="dispService,dispInit" fn="load-modules" shlib="$(SERVER\_ROOT)/plugins/dispatcher.so"  
Init fn="dispInit" config="$(PRODUCT\_SUBDIR)/dispatcher.any" loglevel="1" logfile="$(PRODUCT\_SUBDIR)/logs/dispatcher.log"  
keepalivetimeout="60"  
...

다음의 경우:

매개 변수 설명
config 구성 파일 dispatcher.any.의 위치 및 이름입니다.
logfile 로그 파일의 위치 및 이름입니다.
loglevel 로그 파일에 메시지를 작성할 때의 로그 수준:
0 오류
1 경고
2 정보
3 디버그
참고: 설치 및 테스트 중에는 로그 수준을 3으로 설정하고 프로덕션 환경에서 실행할 때는 0으로 설정하는 것이 좋습니다.
keepalivetimeout keep-alive 시간 제한을 초 단위로 지정합니다. Dispatcher 버전 4.2.0부터 기본 keep-alive 값은 60입니다. 값이 0이면 keep-alive가 비활성화됩니다.

요구 사항에 따라 Dispatcher를 개체에 대한 서비스로 정의할 수 있습니다. 전체 웹 사이트에 대해 Dispatcher를 구성하려면 기본 개체를 수정합니다.

Windows

...  
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)\\dispcache"  
...  
Service fn="dispService" method="(GET|HEAD|POST)" type="\*\\\*"  
...

Unix

...  
NameTrans fn="document-root" root="$(PRODUCT\_SUBDIR)/dispcache"  
...  
Service fn="dispService" method="(GET|HEAD|POST)" type="\*/\*"  
...

다음 단계

Dispatcher 사용을 시작하려면 먼저 다음과 같은 사항을 알아야 합니다.

이 페이지에서는