Show Menu
TOPICS×

Dispatcher 설치

Dispatcher 버전은 AEM과 독립적입니다. 이전 버전의 AEM에 대한 설명서에 포함된 Dispatcher 설명서에 대한 링크를 따라간 경우 이 페이지로 리디렉션되었을 수 있습니다.
Dispatcher 릴리스 정보 페이지에서는 운영 체제 및 웹 서버에 대한 최신 Dispatcher 설치 파일을 얻을 수 있습니다. Dispatcher 릴리스 번호는 Adobe Experience Manager 릴리스 번호와 독립적이며 Adobe Experience Manager 6.x, 5.x 및 Adobe CQ 5.x 릴리스와 호환됩니다.
다음 파일 이름 지정 규칙이 사용됩니다.
dispatcher-<web-server>-<operating-system>-<dispatcher-version-number>.<file-format>
예를 들어, 이
dispatcher-apache2.4-linux-x86_64-ssl-4.3.1.tar.gz
파일에는 Linux i686에서 실행되고
tar
형식을 사용하여 패키지화된 Apache 2.4 웹 서버용 Dispatcher 버전 4.3.1이 포함되어 있습니다.
다음 표에는 각 웹 서버의 파일 이름에 사용되는 웹 서버 식별자가 나열되어 있습니다.
웹 서버
설치 키트
Apache 2.4
dispatcher-apache
2.4
-<기타 매개 변수>
Microsoft Internet Information Server 7.5, 8, 8.5
dispatcher-
iis
-<other parameters>
Sun Java Web Server iPlanet
dispatcher-
ns
-<other parameters>
사용 중인 플랫폼에 사용할 수 있는 최신 버전의 Dispatcher를 설치해야 합니다. 매년 Dispatcher 인스턴스를 업그레이드하여 최신 버전을 사용하여 향상된 제품을 이용해야 합니다.
각 아카이브에는 다음 파일이 포함되어 있습니다.
  • 디스패처 모듈
  • 예제 구성 파일
  • 설치 지침 및 최종 정보가 포함된 README 파일
  • 현재 및 이전 릴리스에서 해결된 문제를 나열하는 CHANGES 파일
설치를 시작하기 전에 README 파일에서 마지막 변경 사항/플랫폼 관련 정보를 확인하십시오.

Microsoft Internet Information Server

이 웹 서버를 설치하는 방법에 대한 자세한 내용은 다음 리소스를 참조하십시오.

필수 IIS 구성 요소

IIS 버전 8.5 및 10을 사용하려면 다음 IIS 구성 요소가 설치되어 있어야 합니다.
  • ISAPI 확장
또한 IIS(웹 서버) 역할을 추가해야 합니다. 서버 관리자를 사용하여 역할 및 구성 요소를 추가합니다.

Microsoft IIS - 디스패처 모듈 설치

Microsoft 인터넷 정보 시스템에 필요한 보관 파일은 다음과 같습니다.
  • dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip
ZIP 파일에는 다음 파일이 포함되어 있습니다.
파일
설명
disp_iis.dll
Dispatcher Dynamic Link 라이브러리 파일입니다.
disp_iis.ini
IIS의 구성 파일입니다. 이 예는 요구 사항에 맞게 업데이트할 수 있습니다.
참고
:ini 파일의 이름 루트는 dll과 같아야 합니다.
dispatcher.any
Dispatcher의 예제 구성 파일입니다.
author_dispatcher.any
작성자 인스턴스로 작업하는 Dispatcher의 예제 구성 파일입니다.
README
설치 지침 및 최종 정보가 포함된 Readme 파일.
참고
:설치를 시작하기 전에 이 파일을 확인하십시오.
변경 사항
현재 및 이전 릴리스에서 해결된 문제를 나열하는 파일을 변경합니다.
다음 절차를 사용하여 Dispatcher 파일을 올바른 위치에 복사합니다.
  1. Windows 탐색기를 사용하여
    <IIS_INSTALLDIR>/Scripts
    디렉토리를 만듭니다(예:
    C:\inetpub\Scripts
    ).
  2. Dispatcher 패키지에서 다음 파일을 이 스크립트 디렉토리로 추출합니다.
    • disp_iis.dll
    • disp_iis.ini
    • Dispatcher가 AEM 작성자 인스턴스 또는 게시 인스턴스로 작업하는지 여부에 따라 다음 파일 중 하나:
      • 작성자 인스턴스:
        author_dispatcher.any
      • 게시 인스턴스:
        dispatcher.any

Microsoft IIS - Dispatcher INI 파일 구성

파일을 편집하여 Dispatcher
disp_iis.ini
설치를 구성합니다. 파일의 기본 형식은 다음과 같습니다.
.ini
[main] configpath=<path to dispatcher.any> loglevel=1|2|3 servervariables=0|1 replaceauthorization=0|1
다음 표에서는 각 속성에 대해 설명합니다.
매개 변수
설명
구성 경로
로컬 파일 시스템 내의 위치
dispatcher.any
(절대 경로).
로그 파일
파일의 위치입니다
dispatcher.log
. 이 설정이 설정되지 않으면 로그 메시지가 Windows 이벤트 로그로 이동합니다.
로그 수준
이벤트 로그에 메시지를 출력하는 데 사용되는 로그 수준을 정의합니다. 다음 값을 지정할 수 있습니다.로그 파일의 로그 수준:
0 - 오류 메시지만 해당합니다.
1 - 오류 및 경고
2 - 오류, 경고 및 정보 메시지
3 - 오류, 경고, 정보 및 디버그 메시지
참고
:설치 및 테스트 중에 로그 수준을 3으로 설정한 다음 프로덕션 환경에서 실행할 때 0으로 설정하는 것이 좋습니다.
재허가
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 캐시를 사용하는 웹 사이트에서 익명 액세스를 허용해야 합니다.
웹 사이트에서 인증 방법을 사용하는 경우 Flush 복제 에이전트를 적절하게 구성해야 합니다.
  1. IIS 관리자를 열고 Dispatcher 캐시로 사용 중인 웹 사이트를 선택합니다.
  2. 기능 보기 모드를 사용하는 경우 IIS 섹션에서 인증을 두 번 클릭합니다.
  3. 익명 인증이 활성화되지 않은 경우 익명 인증을 선택하고 작업 영역에서 활성화를 클릭합니다.

Dispatcher ISAPI 모듈 통합 - IIS 8.5 및 10

다음 절차를 사용하여 Dispatcher ISAPI 모듈을 IIS에 추가합니다.
  1. IIS 관리자를 엽니다.
  2. 발송자 캐시로 사용 중인 웹 사이트를 선택합니다.
  3. 기능 보기 모드를 사용하는 경우 IIS 섹션에서 처리기 매핑을 두 번 클릭합니다.
  4. # 페이지의 # 패널에서 # 를 클릭하고 다음 속성 값을 추가한 다음 # 을 클릭합니다.
    • 요청 경로:*
    • 실행 파일:예를 들어 disp_iis.dll 파일의 절대 경로입니다
      C:\inetpub\Scripts\disp_iis.dll
      .
    • 이름:예를 들어 처리기 매핑에 대한 설명형 이름입니다
      Dispatcher
      .
  5. 표시되는 대화 상자에서 disp_iis.dll 라이브러리를 ISAPI 및 CGI 제한 목록에 추가하려면 예를 클릭합니다.
    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

기본 앱 풀 사용자에게 발송자 캐시로 사용되는 폴더에 대한 쓰기 액세스 권한을 제공합니다.
  1. Dispatcher 캐시로 사용 중인 웹 사이트의 루트 폴더를 마우스 오른쪽 단추로 클릭하고 속성(예:
    C:\inetpub\wwwroot
    )을 클릭합니다.
  2. 보안 탭에서 편집을 클릭한 다음 권한 대화 상자에서 추가를 클릭합니다. 사용자 계정을 선택할 수 있는 대화 상자가 열립니다. 위치 단추를 클릭하고 컴퓨터 이름을 선택한 다음 확인을 클릭합니다.
    다음 단계를 완료하는 동안 이 대화 상자를 엽니다.
  3. iis 관리자에서 Dispatcher 캐시에 사용할 IIS 사이트를 선택하고 창의 오른쪽에서 고급 설정을 클릭합니다.
  4. 응용 프로그램 풀 속성 값을 선택하고 클립보드에 복사합니다.
  5. 열린 대화 상자로 돌아갑니다. 선택할 개체 이름 입력 상자에 클립보드의 내용을
    IIS AppPool\
    입력한 다음 붙여 넣습니다. 값은 다음 예와 같아야 합니다.
    IIS AppPool\DefaultAppPool
  6. 이름 확인 단추를 클릭합니다. Windows에서 사용자 계정을 확인하면 확인을 클릭합니다.
  7. 디스패처 폴더의 권한 대화 상자에서 방금 추가한 계정을 선택하고 전체 제어를
    제외한 계정에 대한 모든 권한을 활성화하고
    확인을 클릭합니다. 확인을 클릭하여 폴더 속성 대화 상자를 닫습니다.

JSON MIME 유형 등록 - IIS 8.5 및 10

Dispatcher가 JSON 호출을 허용하려면 다음 절차를 사용하여 JSON MIME 유형을 등록합니다.
  1. IIS Manager에서 웹 사이트를 선택하고 기능 보기를 사용하여 Mime 형식을 두 번 클릭합니다.
  2. JSON 확장이 목록에 없는 경우 # 패널에서 # 를 클릭하고 다음 속성 값을 입력한 다음 # 을 클릭합니다.
    • 파일 이름 확장자:
      .json
    • MIME 유형:
      application/json

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

다음 절차를 사용하여
bin
숨겨진 세그먼트를 제거합니다. 새 사이트가 아닌 웹 사이트에는 이 숨겨진 세그먼트가 포함될 수 있습니다.
  1. IIS Manager에서 웹 사이트를 선택하고 기능 보기를 사용하여 요청 필터링을 두 번 클릭합니다.
  2. 세그먼트를 선택하고
    bin
    제거를 클릭한 다음 확인 대화 상자에서 예를 클릭합니다.

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

다음 절차에 따라 Dispatcher 로그 메시지를 Windows 이벤트 로그 대신 로그 파일에 기록합니다. 로그 파일을 사용하도록 Dispatcher를 구성하고 IIS에서 파일에 대한 쓰기 액세스 권한을 제공해야 합니다.
  1. Windows 탐색기를 사용하여 IIS 설치의 로그 폴더
    dispatcher
    아래에 명명된 폴더를 만듭니다. 일반적인 설치에 대한 이 폴더의 경로는
    C:\inetpub\logs\dispatcher
    입니다.
  2. 발송자 폴더를 마우스 오른쪽 단추로 클릭하고 # 을 클릭합니다.
  3. 보안 탭에서 편집을 클릭한 다음 권한 대화 상자에서 추가를 클릭합니다. 사용자 계정을 선택할 수 있는 대화 상자가 열립니다. 위치 단추를 클릭하고 컴퓨터 이름을 선택한 다음 확인을 클릭합니다.
    다음 단계를 완료하는 동안 이 대화 상자를 엽니다.
  4. iis 관리자에서 Dispatcher 캐시에 사용할 IIS 사이트를 선택하고 창의 오른쪽에서 고급 설정을 클릭합니다.
  5. 응용 프로그램 풀 속성 값을 선택하고 클립보드에 복사합니다.
  6. 열린 대화 상자로 돌아갑니다. 선택할 개체 이름 입력 상자에 클립보드의 내용을
    IIS AppPool\
    입력한 다음 붙여 넣습니다. 값은 다음 예와 같아야 합니다.
    IIS AppPool\DefaultAppPool
  7. 이름 확인 단추를 클릭합니다. Windows에서 사용자 계정을 확인하면 확인을 클릭합니다.
  8. 디스패처 폴더의 권한 대화 상자에서 방금 추가한 계정을 선택하고 전체 제어를
    제외한 계정에 대한 모든 권한을 활성화한 다음
    확인을 클릭합니다. 확인을 클릭하여 폴더 속성 대화 상자를 닫습니다.
  9. 텍스트 편집기를 사용하여
    disp_iis.ini
    파일을 엽니다.
  10. 다음 예와 유사한 텍스트 줄을 추가하여 로그 파일의 위치를 구성한 다음 파일을 저장합니다.
    logfile=C:\inetpub\logs\dispatcher\dispatcher.log

다음 단계

Dispatcher를 사용하기 전에 알아야 할 사항은 다음과 같습니다.

Apache Web Server

Windows 및 Unix
에서
설치
지침은
여기에 설명되어 있습니다. 단계를 수행할 때는 주의하십시오.

Apache 웹 서버 설치

Apache 웹 서버 설치 방법에 대한 자세한 내용은 온라인 또는 배포 중 설치 설명서를 참조하십시오.
소스 파일을 컴파일하여 Apache 바이너리를 만드는 경우
동적 모듈 지원을
​설정해야 합니다. 이 작업은 활성화 공유 옵션을 사용하여 수행할 수 있습니다. 적어도
mod_so
모듈이 포함됩니다.
자세한 내용은 Apache Web Server 설치 설명서를 참조하십시오.
Apache HTTP Server 보안 및 보안 보고서를 참조하십시오 .

Apache Web Server - Dispatcher 모듈 추가

Dispatcher는 다음 중 하나를 따릅니다.
  • Windows
    :다이내믹 링크 라이브러리(DLL)
  • Unix
    :동적 공유 개체(DSO)
설치 아카이브 파일에는 Windows 또는 Unix를 선택했는지 여부에 따라 다음 파일이 포함됩니다.
파일
설명
disp_apache<x.y>.dll
Windows:Dispatcher Dynamic Link 라이브러리 파일입니다.
dispatch-apache<x.y>-<rel-nr>.so
Unix:Dispatcher 공유 개체 라이브러리 파일입니다.
mod_dispatcher.so
Unix:예제 링크입니다.
http.conf.disp<x>
Apache 서버의 구성 파일 예
dispatcher.any
Dispatcher의 예제 구성 파일입니다.
README
설치 지침 및 최종 정보가 포함된 Readme 파일.
참고
:설치를 시작하기 전에 이 파일을 확인하십시오.
변경 사항
현재 및 이전 릴리스에서 해결된 문제를 나열하는 파일을 변경합니다.
다음 단계에 따라 Dispatcher를 Apache 웹 서버에 추가합니다.
  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 속성이 그에 따라 구성된 한 이 파일을 다른 위치에 배치할 수 있습니다. (아래 발송자별 구성 항목을 참조하십시오.)

Apache 웹 서버 - SELinux 속성 구성

SELinux가 활성화된 RedHat Linux Kernel 2.6에서 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 보안 기능이 활성화되어 있기 때문일 수 있습니다. 그런 다음 다음 작업을 수행해야 합니다.
  • 디스패처 모듈 파일의 SELinux 컨텍스트를 구성합니다.
  • HTTPD 스크립트 및 모듈을 사용하여 네트워크 연결을 만들 수 있습니다.
  • 캐시된 파일이 저장되는 docroot의 SELinux 컨텍스트를 구성합니다.
터미널 창에 다음 명령을 입력하여 Apache Web Server에 설치한 Dispatcher 모듈의
[path to the dispatcher.so file]
path to the 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 Web Server - Dispatcher용 Apache Web Server 구성

를 사용하여 Apache Web Server를 구성해야
httpd.conf
합니다. Dispatcher 설치 키트에서 이름이
httpd.conf.disp<x>
있는 예제 구성 파일을 찾을 수 있습니다.
이러한 단계는 필수입니다.
  1. 다음으로 이동
    <APACHE_ROOT>/conf
    .
  2. 편집을
    httpd.conf
    위해 엽니다.
  3. 나열된 순서대로 다음 구성 항목을 추가해야 합니다.
    • LoadModule
      을 사용하여 시작할 때 모듈을 로드합니다.
    • DispatcherConfig, DispatcherLog 및
      DispatcherLogLevel을
      비롯한
      발송자별 구성 항목입니다
      .
    • SetHandler를
      사용하여 Dispatcher를 활성화합니다.
      LoadModule
      .
    • ModMimeUsePathInfo
      를 사용하여
      mod_mime
      ​동작을 구성합니다.
  4. (선택 사항) htdocs 디렉토리의 소유자를 변경하는 것이 좋습니다.
    • Apache 서버는 루트로 시작하지만 하위 프로세스는 데몬으로 시작됩니다(보안 목적용). 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 Web Server 설명서를 참조하십시오.
발송자별 구성 항목
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
이 매개 변수는 더 이상 사용되지 않으며 아무 효과도 없습니다.
사용할 서버 헤더를 정의합니다.
  • undefined 또는 0 - HTTP 서버 헤더에 AEM 버전이 포함되어 있습니다.
  • 1 - Apache 서버 헤더가 사용됩니다.
DispatcherDeclineRoot
루트 "/"에 대한 요청을 거절할지 여부를 정의합니다.0
- 요청에 대한 /
1
- 디스패처에 의한 요청 / 처리 안 함올바른 매핑에 mod_alias를 사용합니다.
DispatcherUseProcessedURL
Dispatcher의 모든 추가 처리에 사전 처리된 URL을 사용할지 여부를 정의합니다.
0
- 웹 서버에 전달된 원본 URL을 사용합니다.
1
- 디스패처는 디스패처 앞에 있는 핸들러에서 이미 처리한 URL을 사용합니다(예:)를
mod_rewrite
클릭합니다. 예를 들어 원본 URL 또는 처리된 URL이 발송자 필터와 일치합니다. URL은 캐시 파일 구조의 기초로 사용됩니다. mod_rewrite에 대한 자세한 내용은 Apache 웹 사이트 설명서를 참조하십시오.예: Apache 2.4.mod_rewrite를 사용하는 경우 'passthrough' 플래그를 사용하는 것이 좋습니다.
DispatcherPassError
ErrorDocument 처리에 대한 오류 코드를 지원하는 방법을 정의합니다.
0
- 디스패처는 클라이언트에 대한 모든 오류 응답을 스풀합니다.
1
- Dispatcher는 클라이언트에 대한 오류 응답을 스풀링하지 않으며(상태 코드가 400보다 크거나 같음) 상태 코드를 Apache로 전달합니다. Apache에서는 이 상태 코드를 ErrorDocument 지시문이 이러한 상태 코드를 처리할 수 있습니다.
코드 범위
- Apache에 응답이 전달되는 오류 코드의 범위를 지정합니다. 다른 오류 코드는 클라이언트에 전달됩니다. 예를 들어 다음 구성은 오류 412에 대한 응답을 클라이언트에 전달하며 다른 모든 오류가 Apache로 전달됩니다.DispatcherPassError 400-411,413-417
DispatcherKeepAliveTimeout
유지 제한 시간(초)을 지정합니다. Dispatcher 버전 4.2.0부터 기본 keep-alive 값은 60입니다. 값이 0이면 keep-alive가 비활성화됩니다.
DispatcherNoCanonURL
이 매개 변수를 On으로 설정하면 기본 URL이 아닌 원시 URL을 백엔드로 전달되고 DispatcherUseProcessedURL의 설정이 무시됩니다. 기본값은 해제입니다.
참고
:발송자 구성의 필터 규칙은 항상 원시 URL이 아닌 정리된 URL에 대해 평가됩니다.
경로 항목은 Apache 웹 서버의 루트 디렉토리에 상대적입니다.
서버 헤더의 기본 설정은 다음과 같습니다.
ServerTokens Full
DispatcherNoServerHeader 0
AEM 버전(통계 목적)을 보여줍니다. 헤더에서 이러한 정보를 사용할 수 없도록 설정하려면 다음을 설정할 수 있습니다.
ServerTokens Prod
자세한 내용은 ServerTokens Directive(예: Apache 2.4의 경우) 에 대한 Apache 설명서를 참조하십시오.
SetHandler
이러한 항목 후에는 Dispatcher가
들어오는 요청을
처리하려면 SetHandler 문을 구성 컨텍스트(
<Directory>
,
<Location>
)에 추가해야 합니다. 다음 예제에서는 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 Web Server 설명서를 참조하십시오.
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_mime
전체 ** 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 Web Server / iPlanet

Windows 및 Unix 환경을 위한 지침은 여기에서 다룹니다. 실행할 항목을 선택할 때는 주의하십시오.

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

이러한 웹 서버를 설치하는 방법에 대한 자세한 내용은 해당 설명서를 참조하십시오.
  • Sun Java System Web Server
  • iPlanet Web Server

Sun Java System Web Server / iPlanet - 디스패처 모듈 추가

Dispatcher는 다음 중 하나를 따릅니다.
  • Windows
    :다이내믹 링크 라이브러리(DLL)
  • Unix
    :동적 공유 개체(DSO)
설치 아카이브 파일에는 Windows 또는 Unix를 선택했는지 여부에 따라 다음 파일이 포함됩니다.
파일
설명
disp_ns.dll
Windows:Dispatcher Dynamic Link 라이브러리 파일입니다.
dispatcher.so
Unix:Dispatcher 공유 개체 라이브러리 파일입니다.
dispatcher.so
Unix:예제 링크입니다.
obj.conf.disp
iPlanet/Sun Java System 웹 서버에 대한 예제 구성 파일입니다.
dispatcher.any
Dispatcher의 예제 구성 파일입니다.
README
설치 지침 및 최종 정보가 포함된 Readme 파일. 참고:설치를 시작하기 전에 이 파일을 확인하십시오.
변경 사항
현재 및 이전 릴리스에서 해결된 문제를 나열하는 파일을 변경합니다.
다음 단계에 따라 웹 서버에 Dispatcher를 추가합니다.
  1. 웹 서버의
    plugin
    디렉토리에 Dispatcher 파일을 배치합니다.

Sun Java System Web Server / iPlanet - 발송자에 대한 구성

을 사용하여 웹 서버를 구성해야 합니다
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)
합니다.
초기화
다음 표에는 사용할 수 있는 예제가 나와 있습니다.정확한 항목은 특정 웹 서버에 따라 다릅니다.
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" ...
where:
매개 변수
설명
config
구성 파일의 위치 및 이름
dispatcher.any.
로그 파일
로그 파일의 위치 및 이름입니다.
로그 수준
로그 파일에 메시지를 작성할 때의 로그 수준:오류 0
1
경고 2
Infos 3 Debug
Debug Note:설치 및 테스트 중에는 로그 수준을 3으로, 프로덕션 환경에서 실행할 때는 0으로 설정하는 것이 좋습니다.
keepalivetimeout
유지 제한 시간(초)을 지정합니다. 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 사용을 시작하려면 먼저 다음을 수행해야 합니다.