Dispatcher 설치 installing-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에서 실행되는 Apache 2.4 웹 서버용 Dispatcher 버전 4.3.1이 포함되어 있으며 파일은 tar 형식을 사용하여 패키징됩니다.
다음 표에는 각 웹 서버의 파일 이름에 사용되는 웹 서버 식별자가 나열되어 있습니다.
각 아카이브에는 다음 파일이 포함되어 있습니다.
- Dispatcher 모듈
- 예제 구성 파일
- 설치 지침과 최신 정보가 포함된 추가 정보 파일
- 현재 및 과거 릴리스에서 수정된 문제를 나열하는 변경 사항 파일
Microsoft® Internet Information Server microsoft-internet-information-server
이 웹 서버를 설치하는 방법에 대한 정보는 다음 리소스를 참조하십시오.
- Internet Information Server에 대한 Microsoft® 자체 설명서
- “공식 Microsoft® IIS 사이트”
필수 IIS 구성 요소 required-iis-components
IIS 버전 8.5 및 10에는 다음 IIS 구성 요소가 설치되어 있어야 합니다.
- ISAPI 확장
또한 웹 서버(IIS) 역할을 추가해야 합니다. 서버 관리자를 사용하여 역할 및 구성 요소를 추가합니다.
Microsoft® IIS - Dispatcher 모듈 설치 microsoft-iis-installing-the-dispatcher-module
Microsoft® Internet Information System에 필요한 아카이브는 다음과 같습니다.
dispatcher-iis-<operating-system>-<dispatcher-release-number>.zip
ZIP 파일에는 다음 파일이 포함되어 있습니다.
disp_iis.dll
disp_iis.ini
dispatcher.any
author_dispatcher.any
다음 절차에 따라 Dispatcher 파일을 올바른 위치에 복사합니다.
-
Windows 탐색기를 사용하여
<IIS_INSTALLDIR>/Scripts
디렉터리(예:C:\inetpub\Scripts
)를 생성합니다. -
Dispatcher 패키지에서 이 Scripts 디렉터리로 다음 파일의 압축을 풉니다.
-
disp_iis.dll
-
disp_iis.ini
-
Dispatcher가 AEM 작성자 인스턴스 또는 게시 인스턴스와 함께 작동하는지 여부에 따라 다음 파일 중 하나입니다.
- 작성자 인스턴스:
author_dispatcher.any
- 게시 인스턴스:
dispatcher.any
- 작성자 인스턴스:
-
Microsoft® IIS - Dispatcher INI 파일 구성 microsoft-iis-configure-the-dispatcher-ini-file
Dispatcher 설치를 구성하려면 disp_iis.ini
파일을 편집합니다. .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
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
예제 구성:
[main]
configpath=C:\Inetpub\Scripts\dispatcher.any
loglevel=1
servervariables=1
replaceauthorization=0
Microsoft® IIS 구성 configuring-microsoft-iis
Dispatcher ISAPI 모듈을 통합하도록 IIS를 구성합니다. IIS에서는 와일드카드 애플리케이션 매핑을 사용합니다.
익명 액세스 구성 - IIS 8.5 및 10 configuring-anonymous-access-iis-and
작성자 인스턴스의 기본 플러시 복제 에이전트가 플러시 요청과 함께 보안 자격 증명을 전송하지 않도록 구성되었습니다. 따라서 Dispatcher 캐시를 사용하는 웹 사이트에서는 익명 액세스를 허용해야 합니다.
웹 사이트에서 인증 방법을 사용하는 경우 플러시 복제 에이전트를 그에 따라 구성해야 합니다.
- IIS 관리자를 열고 Dispatcher 캐시로 사용 중인 웹 사이트를 선택합니다.
- 기능 보기 모드를 사용하여 IIS 섹션에서 인증을 더블 클릭합니다.
- 익명 인증이 활성화되지 않은 경우 익명 인증을 선택하고 작업 영역에서 [사용]을 클릭합니다.
Dispatcher ISAPI 모듈 통합 - IIS 8.5 및 10 integrating-the-dispatcher-isapi-module-iis-and
다음 절차에 따라 Dispatcher ISAPI 모듈을 IIS에 추가합니다.
-
IIS 관리자를 엽니다.
-
Dispatcher 캐시로 사용 중인 웹 사이트를 선택합니다.
-
기능 보기 모드를 사용하여 IIS 섹션에서 [핸들러 매핑]을 더블 클릭합니다.
-
핸들러 매핑 페이지의 작업 패널에서 [와일드카드 스크립트 맵 추가]를 클릭하고 다음 속성 값을 추가한 다음 [확인]을 클릭합니다.
- 요청 경로: *
- 실행 파일: disp_iis.dll 파일의 절대 경로(예:
C:\inetpub\Scripts\disp_iis.dll
). - 이름: 핸들러 매핑에 대한 설명적인 이름(예:
Dispatcher
).
-
표시되는 대화 상자에서 ISAPI 및 CGI 제한 목록에 disp_iis.dll 라이브러리를 추가하려면 예 를 클릭합니다.
IIS 7.0 및 7.5의 경우 구성이 완료되었습니다. IIS 8.0을 구성하는 경우 나머지 단계를 계속 진행합니다.
-
(IIS 8.0) 핸들러 매핑 목록에서 방금 만든 매핑을 선택하고 작업 영역에서 [편집]을 클릭합니다.
-
(IIS 8.0) 스크립트 맵 편집 대화 상자에서 요청 제한 버튼을 클릭합니다.
-
(IIS 8.0) 아직 캐시되지 않은 파일 및 폴더에 핸들러가 사용되도록 하려면 요청이 매핑된 경우에만 핸들러 호출 을 선택 취소합니다. 확인 을 클릭합니다.
-
(IIS 8.0) 스크립트 맵 편집 대화 상자에서 [확인]을 클릭합니다.
캐시에 대한 액세스 구성 - IIS 8.5 및 10 configuring-access-to-the-cache-iis-and
기본 앱 풀 사용자에게 Dispatcher 캐시로 사용 중인 폴더에 대한 쓰기 액세스 권한을 제공합니다.
-
Dispatcher 캐시로 사용 중인 웹 사이트의 루트 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성(예:
C:\inetpub\wwwroot
)을 클릭합니다. -
보안 탭에서 [편집]을 클릭한 다음 사용 권한 대화 상자에서 [추가]를 클릭합니다. 사용자 계정을 선택하는 대화 상자가 열립니다. 위치 버튼을 클릭하고 컴퓨터 이름을 선택한 다음 [확인]을 클릭합니다.
다음 단계를 완료하는 동안 이 대화 상자를 열어 두십시오.
-
IIS 관리자에서 Dispatcher 캐시에 사용할 IIS 사이트를 선택하고 창 오른쪽에서 [고급 설정]을 클릭합니다.
-
애플리케이션 풀 속성의 값을 선택하고 클립보드에 복사합니다.
-
열린 대화 상자로 돌아갑니다. 선택할 오브젝트 이름 입력 상자에
IIS AppPool\
을 입력한 다음 클립보드의 내용을 붙여넣습니다. 값은 다음 예제와 같아야 합니다.IIS AppPool\DefaultAppPool
-
이름 확인 버튼을 클릭합니다. Windows에서 사용자 계정을 확인하면 [확인]을 클릭합니다.
-
Dispatcher 폴더의 권한 대화 상자에서 방금 추가한 계정을 선택하고 전체 제어를 제외한 계정에 대한 모든 권한을 활성화한 다음 [확인]을 클릭합니다. [확인]을 클릭하여 폴더 속성 대화 상자를 닫을 수 있습니다.
JSON Mime 유형 등록 - IIS 8.5 및 10 registering-the-json-mime-type-iis-and
Dispatcher가 JSON 호출을 허용하도록 하려면 다음 절차를 사용하여 JSON MIME 유형을 등록하십시오.
-
IIS 관리자에서 웹 사이트를 선택하고 기능 보기를 사용하여 Mime 유형을 더블 클릭합니다.
-
JSON 확장 기능이 목록에 없는 경우 작업 패널에서 [추가]를 클릭하고 다음 속성 값을 입력한 후 [확인]을 클릭합니다.
- 파일 이름 확장자:
.json
- MIME 유형:
application/json
- 파일 이름 확장자:
bin 숨겨진 세그먼트 제거 - IIS 8.5 및 10 removing-the-bin-hidden-segment-iis-and
다음 절차를 사용하여 bin
숨겨진 세그먼트를 제거합니다. 새 세그먼트가 아닌 웹 사이트에는 이 숨겨진 세그먼트가 포함될 수 있습니다.
- IIS 관리자에서 웹 사이트를 선택하고 기능 보기를 사용하여 요청 필터링을 더블 클릭합니다.
bin
세그먼트를 선택하고 [제거]를 클릭한 다음 확인 대화 상자에서 [예]를 클릭합니다.
파일에 IIS 메시지 로깅 - IIS 8.5 및 10 logging-iis-messages-to-a-file-iis-and
다음 절차를 사용하여 Dispatcher 로그 메시지를 Windows 이벤트 로그 대신 로그 파일에 기록합니다. 로그 파일을 사용하도록 Dispatcher를 구성하고 IIS에 파일에 대한 쓰기 권한을 제공합니다.
-
Windows 탐색기를 사용하여 IIS 설치의 로그 폴더 아래에
dispatcher
라는 폴더를 만듭니다. 일반 설치의 경우 이 폴더의 경로는C:\inetpub\logs\dispatcher
입니다. -
Dispatcher 폴더를 마우스 오른쪽 버튼으로 클릭하고 속성 을 클릭합니다.
-
보안 탭에서 편집 을 클릭합니다.
-
권한 대화 상자에서 추가 를 클릭합니다. 사용자 계정을 선택하는 대화 상자가 열립니다. 위치 버튼을 클릭하고 컴퓨터 이름을 선택한 다음 [확인]을 클릭합니다.
다음 단계를 완료하는 동안 이 대화 상자를 열어 두십시오.
-
IIS 관리자에서 Dispatcher 캐시에 사용할 IIS 사이트를 선택하고 창 오른쪽에서 [고급 설정]을 클릭합니다.
-
애플리케이션 풀 속성의 값을 선택하고 클립보드에 복사합니다.
-
열린 대화 상자로 돌아갑니다. 선택할 오브젝트 이름 입력 상자에
IIS AppPool\
을 입력한 다음 클립보드의 내용을 붙여넣습니다. 값은 다음 예제와 같아야 합니다.IIS AppPool\DefaultAppPool
-
이름 확인 버튼을 클릭합니다. Windows에서 사용자 계정을 확인하면 [확인]을 클릭합니다.
-
Dispatcher 폴더의 권한 대화 상자에서 방금 추가한 계정을 선택하고 전체 제어를 제외한 계정에 대한 모든 권한을 활성화한 다음 [확인]을 클릭합니다. [확인]을 클릭하여 폴더 속성 대화 상자를 닫을 수 있습니다.
-
텍스트 편집기를 사용하여
disp_iis.ini
파일을 엽니다. -
로그 파일의 위치를 구성하려면 다음 예제와 유사한 텍스트 행을 추가한 다음 파일을 저장합니다.
code language-xml logfile=C:\inetpub\logs\dispatcher\dispatcher.log
다음 단계 next-steps
Dispatcher 사용을 시작하려면 먼저 다음과 같은 사항을 알아야 합니다.
Apache 웹 서버 apache-web-server
Apache 웹 서버 설치 installing-apache-web-server
Apache 웹 서버를 설치하는 방법에 대한 자세한 내용은 설치 설명서(온라인 또는 배포 시)을 참조하십시오.
dynamic modules support
을 사용하도록 설정해야 합니다. 이 옵션은 –enable-shared 옵션을 사용하여 활성화할 수 있습니다. 최소한 mod_so
모듈을 포함하십시오.Apache HTTP Server 보안 팁 및 보안 보고서도 참조하십시오.
Apache 웹 서버 - Dispatcher 모듈 추가 apache-web-server-add-the-dispatcher-module
Dispatcher는 다음 중 하나로 제공됩니다.
- Windows: 동적 링크 라이브러리(DLL)
- UNIX®: 동적 공유 오브젝트(DSO)
설치 아카이브 파일에는 Windows 또는 UNIX®를 선택했는지 여부에 따라 다음 파일이 포함되어 있습니다.
다음 단계를 사용하여 Apache 웹 서버에 Dispatcher를 추가합니다.
-
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
- Windows:
-
dispatcher.any 파일을
<APACHE_ROOT>/conf
디렉터리에 복사합니다.참고: Dispatcher 모듈의 DispatcherLog 속성이 적절하게 구성되어 있는 한 이 파일을 다른 위치에 배치할 수 있습니다. (아래의 Dispatcher별 구성 항목을 참조하십시오.)
Apache 웹 서버 - SELinux 속성 구성 apache-web-server-configure-selinux-properties
SELinux가 활성화된 Red Hat® 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_rw_content_t [path to the docroot]
semanage fcontext -a -t httpd_sys_rw_content_t "[path to the docroot](/.*)?"
Apache 웹 서버 - Dispatcher용 Apache 웹 서버 구성 apache-web-server-configure-apache-web-server-for-dispatcher
httpd.conf
을 사용하여 Apache 웹 서버를 구성해야 합니다. Dispatcher 설치 키트에서 httpd.conf.disp<x>
라는 예제 구성 파일을 찾습니다.
다음 단계는 필수입니다.
-
<APACHE_ROOT>/conf
로 이동합니다. -
편집을 위해
httpd.conf
를 엽니다. -
나열된 순서대로 다음 구성 항목을 추가해야 합니다.
- 시작 시 모듈을 로드하는 LoadModule.
- DispatcherConfig, DispatcherLog 및 DispatcherLogLevel 을 포함한 Dispatcher 관련 구성 항목.
- Dispatcher를 활성화하는 SetHandler. LoadModule.
- mod_mime 의 동작을 구성하는 ModMimeUsePathInfo.
-
(선택 사항) htdocs 디렉터리의 소유자를 변경하는 것이 좋습니다.
-
Apache 서버는 루트로 시작하지만 하위 프로세스는 (보안을 위해) 데몬으로 시작합니다. The DocumentRoot(
<APACHE_ROOT>/htdocs
)는 사용자 데몬에 속해야 합니다.code language-xml cd <APACHE_ROOT> chown -R daemon:daemon htdocs
-
LoadModule
다음 표에는 사용할 수 있는 예제가 나열되어 있습니다. 정확한 항목은 특정 Apache 웹 서버에 따라 다릅니다.
... LoadModule dispatcher_module modules\disp_apache.dll ...
... LoadModule dispatcher_module libexec/mod_dispatcher.so ...
Dispatcher별 구성 항목
Dispatcher별 구성 항목은 LoadModule 항목 뒤에 배치됩니다. 다음 표에는 UNIX®와 Windows 모두에 적용할 수 있는 예제 구성이 나열되어 있습니다.
Windows 및 UNIX®
...
<IfModule 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 속성을 포함하여 기본 서버 구성을 재정의할 수 있습니다.
0 - 오류
1 - 경고
2 - 정보
3 - 디버그
참고: 설치 및 테스트 중에는 로그 수준을 3으로 설정한 다음 프로덕션 환경에서 실행할 때는 0으로 설정합니다.
이 매개변수는 권장되지 않으며 효과가 없습니다.
사용할 서버 헤더를 정의합니다.
- 정의되지 않음 또는 0 - HTTP 서버 헤더에 AEM 버전이 포함됩니다.
- 1 - Apache 서버 헤더가 사용됩니다.
0 - /
1 에 대한 요청 수락 - Dispatcher가 /에 대한 요청을 처리하지 않습니다. 대신 올바른 매핑을 위해 mod_alias를 사용합니다.
0 - 웹 서버에 전달된 원래 URL을 사용합니다.
1 - Dispatcher가 웹 서버에 전달된 원래 URL 대신 Dispatcher 앞에 오는 핸들러에 의해 이미 처리된 URL(즉,
mod_rewrite
)을 사용합니다. 예를 들어 원본 또는 처리된 URL이 Dispatcher 필터와 일치합니다. URL은 캐시 파일 구조의 기초로도 사용됩니다. Apache 2.4와 같은 mod_rewrite에 대한 자세한 내용은 Apache 웹 사이트 설명서를 참조하십시오. mod_rewrite를 사용할 때 “passthrough”(다음 핸들러로 전달) 플래그를 사용하여 재작성 엔진이 내부 request_rec 구조의 URI 필드를 파일 이름 필드의 값으로 설정하도록 강제합니다.0 - Dispatcher가 클라이언트에 대한 모든 오류 응답을 스풀 처리합니다.
1 - Dispatcher는 클라이언트에 대한 오류 응답을 스풀링하지 않습니다(상태 코드가 400보다 크거나 같은 경우). 대신 상태 코드를 Apache에 전달하여 ErrorDocument 지시문이 이러한 상태 코드를 처리할 수 있도록 합니다.
코드 범위 -응답이 Apache에 전달되는 오류 코드의 범위를 지정합니다. 다른 오류 코드는 클라이언트에 전달됩니다. 예를 들어 다음 구성은 오류 412에 대한 응답을 클라이언트에 전달하고 다른 모든 오류는 Apache에 전달합니다. DispatcherPassError 400-411,413-417
참고: Dispatcher 구성의 필터 규칙은 항상 원시 URL이 아닌 정리된 URL에 대해 평가됩니다.
ServerTokens Full
DispatcherNoServerHeader 0
ServerTokens Prod
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>
...
ModMimeUsePathInfo
SetHandler 문 뒤에 ModMimeUsePathInfo 정의도 추가해야 합니다.
ModMimeUsePathInfo
매개변수는 Dispatcher 버전 4.0.9 이상을 사용하는 경우에만 사용하고 구성합니다.ModMimeUsePathInfo 매개변수는 모든 Apache 구성에 대해 On
으로 설정해야 합니다.
ModMimeUsePathInfo On
mod_mime 모듈(예: Apache Module mod_mime)은 HTTP 응답을 위해 선택한 콘텐츠에 콘텐츠 메타데이터를 할당하는 데 사용됩니다. 기본 설정은 mod_mime
이 콘텐츠 유형을 결정한다는 의미입니다. 따라서 파일이나 디렉터리에 매핑되는 URL 부분만 고려됩니다.
On
인 경우 ModMimeUsePathInfo
매개변수는 mod_mime
이 complete URL을 기반으로 콘텐츠 유형을 결정하도록 지정합니다. 즉, 해당 확장을 기반으로 가상 리소스에 메타 정보가 적용됩니다.
다음 예제에서는 ModMimeUsePathInfo 를 활성화합니다.
Windows 및 UNIX®
...
<Directory />
<IfModule disp_apache2.c>
SetHandler dispatcher-handler
ModMimeUsePathInfo On
</IfModule>
Options FollowSymLinks
AllowOverride None
</Directory>
...
HTTPS 지원 활성화(UNIX® 및 Linux®) enable-support-for-https-unix-and-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 라이브러리를 사용하도록 다음 절차에 따라 심볼 링크를 만듭니다.
-
터미널을 열고 현재 디렉터리를 OpenSSL 라이브러리가 설치된 디렉터리로 변경합니다. 예를 들면 다음과 같습니다.
code language-shell cd /usr/lib64
-
심볼 링크를 만들려면 다음 명령을 입력합니다.
code language-shell ln -s libssl.so libssl.so.1.0.1 ln -s libcrypto.so libcrypto.so.1.0.1
다음 단계 next-steps-1
Dispatcher 사용을 시작하려면 먼저 다음과 같은 사항을 알아야 합니다.
Sun Java™ System 웹 서버/iPlanet sun-java-system-web-server-iplanet
Sun Java™ System 웹 서버/iPlanet - 웹 서버 설치 sun-java-system-web-server-iplanet-installing-your-web-server
이러한 웹 서버를 설치하는 방법에 대한 전체 정보는 해당 문서를 참조하십시오.
- Sun Java™ System 웹 서버
- iPlanet 웹 서버
Sun Java™ System 웹 서버/iPlanet - Dispatcher 모듈 추가 sun-java-system-web-server-iplanet-add-the-dispatcher-module
Dispatcher는 다음 중 하나로 제공됩니다.
- Windows: 동적 링크 라이브러리(DLL)
- UNIX®: 동적 공유 오브젝트(DSO)
설치 아카이브 파일에는 Windows 또는 UNIX®를 선택했는지 여부에 따라 다음 파일이 포함되어 있습니다.
disp_ns.dll
dispatcher.so
dispatcher.so
obj.conf.disp
dispatcher.any
다음 단계를 사용하여 웹 서버에 Dispatcher를 추가합니다.
- 웹 서버의
plugin
디렉터리에 Dispatcher 파일을 배치합니다.
Sun Java™ System 웹 서버/iPlanet - Dispatcher를 위한 구성 sun-java-system-web-server-iplanet-configure-for-the-dispatcher
obj.conf
을 사용하여 웹 서버를 구성해야 합니다. Dispatcher 설치 키트에서 obj.conf.disp
라는 예제 구성 파일을 찾습니다.
-
다음으로 이동
<WEBSERVER_ROOT>/config
. -
편집을 위해
obj.conf
를 엽니다. -
다음
Service fn="dispService"
로 시작하는 행을obj.conf.disp
에서obj.conf
의 초기화 섹션으로 복사합니다. -
변경 사항을 저장합니다.
-
편집을 위해
magnus.conf
를 엽니다. -
다음
Init funcs="dispService, dispInit"
및Init fn="dispInit"
로 시작하는 두 행을obj.conf.disp
에서magnus.conf
의 초기화 섹션으로 복사합니다. -
변경 사항을 저장합니다.
$(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
요구 사항에 따라 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="\*/\*"
...
다음 단계 next-steps-2
Dispatcher 사용을 시작하려면 먼저 다음과 같은 사항을 알아야 합니다.