이 주제에서는 웹 서버 플러그인을 구성하는 방법에 대해 설명합니다.
제품은 웹 애플리케이션에서 동적 내용(예: 서블릿)에 대한
요청을 라우트하기 위해 웹 서버와 함께 작업합니다. 애플리케이션 서버에서
실행되는 트래픽을 브라우저에서 애플리케이션으로 라우팅하려면
웹 서버가 필요합니다. 웹 서버 플러그인은 XML 구성 파일을 사용하여
요청이 애플리케이션 서버에 대한 것인지 여부를 판별합니다.
시작하기 전에
- WebSphere® Application Server 토폴로지의 프론트 엔드 선택에 대한 정보를 참조하십시오. 이 주제는
WebSphere Application Server 토폴로지에 대한 세션 선호도, 장애 조치(failover) 지원 및 워크로드 밸런싱을 제공하기 위해
웹 서버 플러그인, 프록시 서버 또는 보안 프록시 서버를 설정할지 여부를 판별하는 데 도움을 줍니다. 웹 서버가 아직
설치되지 않았으면 설치하십시오.
유의: IBM® i와 함께
제공되는 웹 서버는 제품 5761-DG1(
IBM i V6R1의 경우) 또는
5770-DG1(
IBM i V7R1의 경우) 아래에 이미 설치되어 있습니다.
IBM i 웹 서버를
IBM i용 IBM HTTP Server라고도
합니다. 이 웹 서버는
IBM i에서 실행되지 않는
WebSphere Application Server에서 제공되는 IBM HTTP Server와는
전혀 다릅니다.
제품에서 제공된 IBM
HTTP Server를 사용하려는 경우 IBM HTTP
Server 설치에 대한 정보를 참조하십시오. 그렇지 않으면 웹 서버에 제공된 설치 정보를 참조하십시오.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
적합한 플러그인 파일이 사용자 웹 서버에
설치되었으며 configureweb_server_name
스크립트가 이 웹 서버의 웹 서버 정의를 작성하고 구성하도록 실행되었는지
확인하십시오.
분산 플랫폼 웹 서버를 사용 중인 경우,
Web Server Plug-ins Configuration Tool을 사용하여 웹 서버에 적합한 플러그인 파일을
설치하십시오. 그런 다음, 도구가 작성하는 configureweb_server_name 스크립트를 실행하여
WebSphere 구성 저장소에 웹 서버 정의를
작성 및 구성하십시오.
제품과 함께 제공되는 z/OS®용 IBM HTTP Server(Apache 기반)를
사용 중인 경우, z/OS의 WebSphere Application Server용 IBM HTTP Server에 대한
플러그인 설치 및 구성에 대한 정보를 참조하십시오.
z/OS 기본 운영 체제와 함께 제공되는
IBM HTTP Server 버전 5.3을 사용 중인 경우, z/OS용 IBM HTTP Server V5.3에 대한
웹 서버 플러그인 설치 및 구성에 대한 정보를 참조하십시오.
z/OS 운영 체제에서 실행 중인
제품 버전에서 분산 플랫폼 웹 서버를 사용 중인 경우, FTP 연결을 사용하여 플러그인을 웹 서버로 전송하고
플러그인 설치 마법사를 사용하여 웹 서버에 적합한 플러그인 파일을 설치하십시오.
다수의 애플리케이션을 설치하는 것과 같은 일련의 동시 변경을 수행하는 경우,
마지막 변경 이후까지 구성 서비스를 작동 불가능하게 할 수 있습니다. 웹 서버 플러그인 구성 서비스는 기본적으로 사용
가능합니다. 이 서비스를 사용하지 않으려면 관리 콘솔에서 를 클릭한 후
옵션을
선택 취소하십시오.
유의: 설치 시 방화벽이 사용되는 경우,
열려 있는 포트를 사용하도록 웹 서버 플러그인을 구성하십시오. 열려 있는 포트를 확보하는 방법에 대한 정보는 보안 관리자에게 문의하십시오.
이 태스크 정보
적합한 플러그인 파일이 설치됩니다.
그 밖에 http 프로파일이 작성됩니다(/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http).
http 프로파일은 웹 서버 정의를 작성할 때
사용할 수 있습니다. 애플리케이션 서버와 통신하도록 IBM i용 IBM HTTP Server를
구성하는 방법에 대한 지시사항은 "웹 서버 토폴로지 다이어그램 및 길잡이 선택" 주제를 참조하십시오.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
다음 단계는 플러그인 설치 프로세스
중에 수행됩니다. 추가 정보는 플러그인 설치 로드맵을 참조하십시오.
노드가 작성됩니다.웹 서버가 애플리케이션 서버와 다른 컴퓨터에 있으면
비관리 노드가 작성됩니다. 비관리 노드는 실행 중인 노드 에이전트가 없는
노드입니다. 비관리 노드를 사용하면 제품은 해당 구성 토폴로지에
애플리케이션 서버가 없는 서버를 표시할 수 있습니다. 이 표시를 통해 서버와 애플리케이션 서버 사이의 연결 정보를 유지보수할 수 있습니다.
자세한 정보는 "노드 추가, 관리 및 제거" 주제를 참조하십시오.
- 웹 서버 정의가 작성됩니다.
또한 관리 콘솔을 사용하거나 ConfigurewebServerDefinition.jacl 스크립트를 사용하여
웹 서버 정의를 작성할 수도 있습니다.
- 애플리케이션 또는 모듈이 웹 서버로 맵핑됩니다. 이 웹 서버에서
사용하려는 애플리케이션이 이미 설치되어 있는 경우, 애플리케이션이
자동으로 웹 서버에 맵핑됩니다. 애플리케이션이 설치되지 않은 경우, 애플리케이션 설치 프로세스의
"서버에 모듈 맵핑" 단계 중에 이 웹 서버를 선택하십시오.
- 마스터 저장소는 업데이트 및 저장됩니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
플러그인을 구성하면
해당 플러그인의 구성 파일이 자동으로 작성됩니다. 이 구성 파일에서 특성의 기본 설정을 변경하거나
튜닝할 수 있습니다. 설정을 변경한 경우, 변경사항을 적용하기 전에 파일을
재생성해야 합니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
구성 파일 생성 또는 재생성을 완료하는 데에는
시간이 걸릴 수 있습니다. 완료되면, 관리 셀에 있는 모든 오브젝트는
웹 서버가 액세스할 수 있는 최신의 설정값을 사용합니다. 애플리케이션 서버가 웹 서버와 동일한 실제 워크스테이션에 있으면,
재생성을 완료하는 데에는 약 30 - 60초가 걸립니다. 애플리케이션 서버와 웹 서버가 다른 워크스테이션에 있는 경우 재생성 시간이 오래 걸립니다.
다음 프로시저에서는 SSL 및 웹 서버 튜닝에 대한 구성을 포함하여
플러그인 구성 파일을 업데이트하기 위한 단계에 대해 설명합니다.
프로시저
- 플러그인 구성 파일에서 설정을 변경하려면 관리 콘솔을 사용하십시오.
웹 서버 플러그인을 설정할 때 구성 변경에 대한 응답으로 구성이 자동으로 생성되게 할지의 여부를 결정해야 합니다. 웹
서버 플러그인 구성 서비스를 사용 가능으로 설정하고 다음 상태 중
하나가 발생하면, 플러그인 구성 파일이 자동으로 생성됩니다.
- 웹 서버가 작성되거나 저장된 경우
- 애플리케이션이 설치된 경우
- 애플리케이션이 설치 제거된 경우
- 가상 호스트 정의가 업데이트된 경우
유의: 플러그인 구성 파일이 처음 생성될 때에는 가상 호스트 목록에
admin_host가 들어 있지 않습니다. 웹 서버의 관리 콘솔 액세스
허용에 대한 정보에서 목록에 추가하는 방법을 설명합니다.
관리 콘솔을 사용하거나
GenPluginCfg 명령을 발행하여 plugin-cfg.xml 파일을 재생성할 수 있습니다.
다음 단계에 따라 관리 콘솔을 사용하여 plugin-cfg.xml 파일을 재생성하십시오.
- 을 선택하십시오.
- 플러그인 구성 파일 자동 생성을 선택하거나 다음 주제 중 하나 이상을 클릭하여
plugin-cfg.xml 파일을 수동으로 구성하십시오.
유의: plugin-cfg.xml 파일을 수동으로 업데이트하지 마십시오.
웹 서버에 작성하는 수동 업데이트는 해당 웹 서버의 plugin-cfg.xml 파일이
재생성될 때마다 대체됩니다.
- 확인을 클릭하십시오.
플러그인 구성을 전파하십시오. 관리 콘솔에서 플러그인 구성을 전파하려면 web_server_name를 클릭하십시오.
플러그인 구성을 전파하기 위한 다른 방법으로
GenPluginCfg 명령을 실행할 수 있습니다. 자세한 정보는 GenPluginCfg 명령 문서를 참조하십시오.
웹 서버가 연관된 독립형 버전의 제품과 동일한 시스템에 위치하는 경우
플러그인 구성을 전파할 필요가 없습니다. 알 수 없는 원인으로 인해 플러그인 구성을 전파하는 데 실패하는 경우,
직접 plugin-cfg.xml 파일을 원격 웹 서버 설치 위치로 복사해야 합니다.
유의: FTP
기능을 사용하여 복사를 수행하고 구성 다시 로드에 실패할 경우
plugin-cfg.xml 파일에 대한 파일 사용 권한을 확인하여
QTMHHTTP, QNOTES 및 QEJBSVR 사용자가 RWX 권한을 갖는지 확인하십시오.
권한이 올바르지 않은 경우, 웹 서버는 구성 다시 로드 실패의 원인이 되는 새 버전의 파일에
액세스할 수 없습니다. 권한을 확인하려면 다음 IBM i 명령을 실행하십시오.
wrklnk 'plug_in_folder_location/plugin-cfg.xml'
그런 다음, 옵션 9를 선택하여 사용자에게 지정된
권한을 보십시오(QTMHHTTP, QNOTES 및 QEJBSVR).
권한이 올바르지 않은 경우 다음 IBM i
명령을 발행하여 파일 권한을 적합한 설정으로 변경하십시오.
CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('plug_in_folder_location/plugin-cfg.xml') DTAAUT(*RWX)
plug_in_folder_location은 plugin-cfg.xml 파일을 전송할 때 지정한 위치입니다.
- 애플리케이션 서버를 중지시킨 후 웹 서버가 plugin-cfg.xml 파일을 찾을 수 있도록
애플리케이션 서버를 시작해야 할 수도 있습니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
웹 서버를 튜닝하십시오. 자세한 정보는 웹 서버 튜닝에 대한 페이지를 참조하십시오.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
플러그인 구성을 전파하십시오. 웹 서버 플러그인 구성 서비스가 사용 가능하고 다음 조건 중 하나가 참인 경우,
플러그인 구성 파일(plugin-cfg.xml)이 자동으로 웹 서버에 전파됩니다.
- 웹 서버는 로컬 웹 서버입니다. 이는 웹 서버가 애플리케이션 서버와
동일한 워크스테이션에 있다는 의미입니다.
- 웹 서버는 IBM HTTP Server
관리 서버가 실행되고 있는 원격 IBM HTTP
Server 버전 7입니다.
이러한 조건 중 하나가 참인 경우, 직접 plugin-cfg.xml 파일을
원격 웹 서버 설치 위치로 복사해야 합니다. <app_server_root>/profiles/<profilename>/config/cells/../../nodes/../servers/<webservername>의
plugin-cfg.xml 파일을 웹 서버 호스트 위치(<PluginInstallRoot>/config/<webservername>/)로
복사하십시오.
중요사항: FTP 기능을 사용하여 파일을 복사하고 구성 다시 로드가 실패하는 경우,
plugin-cfg.xml 파일에 대한 파일 권한을 확인하여
rw-r--r--로 설정되어 있는지
확인하십시오. 파일 사용 권한이 올바르지 않은 경우 웹 서버는 새 버전의
파일에 액세스할 수 없고, 이는 구성 다시 로드의 실패를 초래합니다.
파일 사용 권한이 올바르지 않은 경우
다음 명령을 실행하여 파일 사용 권한을 적합한 설정으로 변경하십시오.
chmod 644 plugin-cfg.xml
AIX® FTP 기능은
파일 속성을 보존하지 않습니다. 따라서 AIX 운영 체제에서
plugin-cfg.xml을 직접 복사해야 하는 경우, FTP 기능 대신 AIX RCP 기능을 사용하여
파일을 복사하려 할 수도 있습니다.
원격 웹 서버 설치 위치는 이 웹 서버에 대한
노드 작성 시 지정한 위치입니다.
- 키 저장소 파일을 웹 서버의 키 저장소 디렉토리에
복사하십시오.
참고: 이 단계는 웹 서버가 올바로 작동하는 데 필요합니다.
키 저장소
파일 복사에 대한 자세한 지시사항은 SSL(Secure Sockets Layer)의
웹 서버 플러그인 구성에 대한 주제를 참조하십시오.
결과
구성이 완료되었습니다. 구성을 활성화하려면 웹 서버를 중지한 후
다시 시작하십시오. 웹 서버를 다시 시작하는 데 문제가 있는 경우,
http_plugin.log 파일에서 오류가 있는
plugin-cfg.xml 파일 부분에 대한 정보를 확인하십시오. 로그 파일에는
웹 서버가 시작되지 않은 이유를 진단하는 데 도움이 될 수 있는 기타 세부사항과 함께 오류가 발생한
행 번호가 표시되어 있습니다. 그런 다음, 관리 콘솔을 사용하여
plugin-cfg.xml 파일을
업데이트할 수 있습니다.
애플리케이션을 자주 설치 또는 설치 제거하지 않는 경우(프로덕션 환경) 또는
앞서 나열한 임의의 조치가 발생할 때마다 플러그인 구성 파일의 생성 및 분배 성능에 미치는 영향을 견딜 수 있다면,
구성 서비스를 사용 가능하게 하는 것에 대해 고려하십시오.