WebSphere® Application Server provides a web
server plug-in that you can configure to communicate with a particular brand of web server. Learn
how to install the web server and its web server plug-in for WebSphere Application Server on one machine and configuring the application server in the
default profile on another machine to communicate with the web server.
Before you begin
다중 프로파일이 존재하면 웹 서버 플러그인 구성 도구가
구성하는 플러그인을 선택할 수 있습니다.
구성할 프로파일을 선택하는 방법을 판별하는 논리 플로우에 대한 설명은
Plug-ins configuration의
내용을 참조하십시오.
다중 프로파일이 존재하면 웹 서버 플러그인 구성 도구가
구성하는 플러그인을 선택할 수 있습니다.
구성할 프로파일을 선택하는 방법을 판별하는 논리 플로우에 대한 설명은
Plug-ins configuration의
내용을 참조하십시오.
WebSphere Application Server
제품군이 IBM® HTTP Server 또는 Microsoft
IIS(Internet Information Service)와 같은 특정 브랜드의 웹 서버를 지원하면 WebSphere
Application Server 제품은 설치해야 하는 웹 서버의 2진 플러그인을
제공합니다.
WebSphere Application Server
제품군이 특정 브랜드의 웹 서버에 대한 2진 플러그인을 제공하지 않으면
웹 서버는 지원되지 않습니다. 2진 플러그인의 목적은 웹 서버와
애플리케이션 서버 사이에 통신 프로토콜을 제공하는
것입니다.
새 프로파일을 작성하고
웹 서버를 사용하려는 경우를 가정하십시오. 새 프로파일의
새 웹 서버를 설치하고 웹 서버 플러그인을 설치한 후 웹 서버
플러그인 구성 도구를 사용하여 웹 서버와 애플리케이션 서버를
모두 구성해야 합니다.
웹 서버가 아직 설치되지 않은 경우 나중에 사용하도록
웹 서버 플러그인을 계속 설치할 수 있습니다.
About this task
웹 서버 플러그인을 설치하면 플러그인 모듈이 설치됩니다.
웹 서버 플러그인 구성 도구는
애플리케이션 서버와 통신하도록 웹 서버를 구성하고, 가능한 경우
애플리케이션 서버에서 웹 서버 구성 정의를 작성합니다.
지원된 구성: 이 도구는 AIX®,
Linux 및 Windows에서만
지원됩니다. As an
alternative to using the Web Server Plug-ins Configuration Tool, you can use the pct command-line
tool with a response file to configure a web server. Read
pct 도구를 사용하여 웹 서버 플러그인 구성 for more information.
sptcfg
This procedure configures the application server profile that is the default profile on the
machine. A one-to-one relationship exists between a web server and the application server.
이 기사에서는 다음 토폴로지를 작성하는 방법을 설명합니다.
Attention: 애플리케이션 서버 노드를
배치 관리자 셀에 추가할 계획이지만 아직 수행하지 않은 경우 배치 관리자를
시작하고, 플러그인을 구성하기 전에 노드를 연합하십시오.
웹 서버 정의가 있는 애플리케이션 서버를 배치 관리자 셀에
추가할 수는 없습니다.
다음 토폴로지는
웹 서버가 별도의 시스템에 있으므로 원격 토폴로지로
간주됩니다. 다이어그램은 분산 환경의 일반적인 원격 토폴로지를
보여줍니다.
이 기사에서는 한 시스템에 웹 서버를 설치하고
별도의 시스템에 애플리케이션 서버를 설치하는 방법에 대해 설명합니다.
이 경우
한 시스템의 웹 서버 플러그인 구성 도구는 다른 시스템의 애플리케이션 서버
구성에서 웹 서버 정의를 작성할 수 없습니다.
이 경우 웹 서버 플러그인 구성 도구는
애플리케이션 서버 시스템으로 복사할 수 있는 웹 서버 시스템에서
스크립트를 작성합니다. 애플리케이션 서버 시스템에서
스크립트를 실행하여 애플리케이션 서버 구성에서 웹 서버 구성 정의를
작성하십시오.
다음 프로시저를 수행하여 플러그인을 설치하고
웹 서버 및 애플리케이션 서버 모두를 구성하십시오.
Procedure
- Install Installation Manager on Machine A and Machine B.
- Installation Manager를 사용하여 시스템 A에 WebSphere
Application Server Network Deployment를 설치하십시오.
- Create a standalone application server on Machine A.
- Optional: 기본 가상 호스트의 새 호스트 별명을 작성하십시오.
포트 80이 아닌 포트를 사용하려고 웹 서버를 구성한 경우
해당 포트에 기본 호스트용 새 호스트 별명을 추가해야
합니다. 예를 들어, 루트 이외로 실행하는 경우 IBM
HTTP Server는 기본 포트 값 8080으로 구성됩니다.
- Use Installation Manager to install the following on Machine B.
- Web Server Plug-ins for WebSphere Application
Server
- Websphere Customization Toolbox
- Installation Manager를 사용하여 시스템 B에 IBM
HTTP Server를 설치하거나 시스템 B에 다른 지원 웹 서버를 설치하십시오.
WebSphere Customization Toolbox를 열고
웹 서버가 있는 시스템에서 웹 서버 플러그인 구성 도구를
실행하십시오.
- Select a web server plug-in runtime location.
If the location of a previously installed web server that you want to use is not in the list,
perform the following actions to add the location to your working set:
- Click Add.
- Enter a name for the web server plug-in location.
- Perform one of the following actions:
- Enter the location.
- Click Browse, find the location, and click OK.
- Click Create.
- Select the type of web server that you are configuring, and click Next.
- Select the architecture of your installed target web server (64 bit or 32 bit) and click
Next if you are asked.
- Click Browse to select the configuration file or files for your web
server, verify that the web server port is correct, and then click Next when
you are finished.
Select the file and not just the directory of the file. Some web servers have two configuration
files and require you to browse for each file.
The following list shows configuration files for supported web servers:
- Apache HTTP Server
- apache_root/config/httpd.conf
- Domino® Web Server
- names.nsf and Notes.jar
The wizard prompts for the
notes.jar file. The actual name is Notes.jar.
The Web Server Plug-ins Configuration Tool verifies that the files exist but the tool
does not validate either file.
- IBM HTTP Server
IHS_root/conf/httpd.conf
IHS_profile_root/conf/httpd.conf
- Microsoft Internet Information Services (IIS)
- The Web Server Plug-ins Configuration Tool can determine the correct files to edit.
- Sun Java™ System Web Server (formerly Sun ONE Web Server
and iPlanet Web Server) Version 6.0 and later
- obj.conf and magnus.conf
- If you are configuring an IBM HTTP web server plug-in,
perform the following actions.
- Optionally, set up the administration server configuration to administer the web server.
Attention: When using the Web Server Plug-ins Configuration Tool to configure the IBM HTTP Server Administration Server, the Websphere Customization
Toolbox must be run as a "local" account with administrator/root privileges.
- Select Setup IBM HTTP Server Administration
Server.
- Specify a port number on which the IBM HTTP administration
server will communicate.
- Optionally, select Create a user ID for IBM Server
Administration Server authentication and enter a user ID and password to authenticate to the IBM HTTP Server administrative server from the administrative
console.
- Click Next.
![[AIX]](../images/aixlogo.gif)
Specify the system user ID and group to have write permission to IBM HTTP Server, the IBM
HTTP Server administrative server, and the web server plug-in configuration files.Select
Create a new unique system user ID and group using the credentials if necessary.
Restriction: The configuration might fail if you specify a new user ID or group
name that exceeds the platform limit, which is commonly 8 characters and is sometimes
configurable.
Optionally, set up the IBM HTTP Server
Administration Server to run as a Window service.- Select Run IBM HTTP Server Administration Server as a
Windows Service.
- Perform one of the following actions:
- Select Log on as a local system account.
- Select Log on as a specified user account, and enter the user ID and password for that
account.
The user ID requires the following advanced user rights:
- Act as part of the operating system
- Log on as a service
- Choose whether your startup type will be automatic or manual.
- Click Next.
- Specify a unique name for the web server definition, and click Next.
- Select the configuration scenario.
- Choose the remote scenario.
- Identify the host name or IP address of Machine A, which is the application server machine.
- Click Next.
- Select the profile to configure with the current web server plug-in, and click
Next.
This panel does not display if you selected the remote scenario in the previous step.
- 요약 패널을 점검하고 구성을 클릭하여
구성을 시작하십시오.
설치 및 구성을 완료하기 위해
수행할 수동 단계가 있음을 패널이 알려줍니다.
웹 서버 플러그인 구성 도구는 시스템 B(웹 서버가 있는 시스템)의
plugins_root/bin/ 디렉토리에서
configureweb_server_name
스크립트를 작성합니다.
또한 웹 서버 플러그인 구성 도구는 plugin-cfg.xml 파일을
plugins_root/config/web_server_name 디렉토리에서 작성합니다.
웹 서버는 plugin-cfg.xml 파일을
읽고 시스템 A의 애플리케이션 서버가 시스템 B의 웹 서버에 제공할 수 있는
애플리케이션을 판별합니다. 구성이 변경될 때마다 애플리케이션 서버는
파일을 재생성합니다. 재생성될 때 실제 plugin-cfg.xml
파일을 애플리케이션 서버 시스템에서 웹 서버 시스템으로 전파 또는
복사하십시오. 자동으로 파일을 IBM HTTP Server
제품으로 전파할 수 있습니다.
- Verify the success of the installation on the summary panel, and click
Finish.
If a problem occurs and the installation is unsuccessful, examine the logs in the
plugins_root/logs directory. Correct any problems and
re-configure.
- configureweb_server_name 스크립트를
시스템 B(웹 서버가 있는 시스템)에서 시스템 A(애플리케이션 서버 시스템)의
app_server_root /bin 디렉토리로 복사하십시오.
web_server_name은 사용자가 지정한 웹 서버의
별명입니다. web_server_name은 IIS 또는
Apache와 같은 벤더 이름이 아닙니다.
AIX 또는 Linux
같은 운영 체제의 경우 파일은 configureweb_server_name.sh입니다.
Windows 시스템의 경우
파일은 configureweb_server_name.bat입니다.
예를 들어, 기본 위치에 web_server_1이라는
IBM HTTP Server가 설치된 Linux
시스템에서 plugins_root/bin/configureweb_server_1.sh를
시스템 B(웹 서버가 있는 시스템)에서 시스템 A(애플리케이션 서버 시스템)의
app_server_root/bin 디렉토리로 복사하십시오.
예를 들어, 기본 위치에 web_server_1이라는
IBM HTTP Server가 설치된 IBM i
시스템에서 plugins_root/bin/configureweb_server_1을
시스템 B(웹 서버가 있는 시스템)에서 시스템 A(애플리케이션 서버 시스템)의
app_server_root/bin 디렉토리로 복사하십시오.
- 파일 인코딩 차이를 보완하여 스크립트 실패를
방지하십시오.
configureweb_server_name.bat
스크립트 또는 configureweb_server_name.sh
스크립트의 컨텐츠는
두 시스템의 기본 파일 인코딩이 다른 경우 손상될 수 있습니다.
이 시나리오는 한 시스템이 2바이트 문자 세트(DBCS) 로케일로
설정되었고 다른 시스템은 아닌 경우 해당됩니다.
configureweb_server_name 스크립트의 컨텐츠는
두 시스템의 기본 파일 인코딩이 다른 경우 손상될 수 있습니다.
이 시나리오는 한 시스템이 2바이트 문자 세트(DBCS) 로케일로
설정되었고 다른 시스템은 아닌 경우 해당됩니다.
파일 인코딩을
판별하고 다음 프로시저 중 하나를 사용하여 장애를 방지하십시오.
기본 파일
인코딩을 판별하려면 적절한 명령을 실행하십시오.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
- AIX 또는 Linux와
같은 시스템에서 locale charmap 명령을 실행하십시오.
- Windows 시스템에서 CHCP 명령을 실행하십시오.
다음 프로시저 중 하나에서 web_server_machine_encoding
변수 및 application_server_machine_encoding 변수의 값으로
각 시스템의 명령 결과를 사용하십시오. 인코딩 차이를
보완하는 프로시저
한 행에 명령을 입력하는 경우
연결 문자(\)를 생략하십시오.
변환 맵핑이 사용자 시스템의
iconv 명령에 의해
지원되지 않는 경우 웹 서버 구성 스크립트의 컨텐츠를 클립보드로 복사하고
애플리케이션 서버가 실행 중인 시스템에 붙여넣으십시오.
Note: Windows 운영 체제에서 원격 구성 후
.sh 파일을 UNIX 기반 운영 체제에 복사하는 경우 chmod 755를 수행해야 합니다.
- 시스템 A에서 애플리케이션 서버를 시작하십시오.
- 명령 창을 열고 웹 서버를 지정해야 하는 프로파일 디렉토리로
변경하십시오. 시스템 A(애플리케이션 서버 시스템)로 복사한 스크립트를
실행하십시오. 다음 매개변수가 필요합니다.
- 프로파일 이름
- (선택사항) 관리자 ID
- (선택사항) 관리자 비밀번호
예를 들어, 다음을 입력할 수 있습니다. configurewebserver1.sh AppSrv01 my_user_ID my_Password
웹 서버는
wsadmin을 통해 구성됩니다.
configurewebserver1.sh 스크립트의 컨텐츠는 다음과 유사합니다.
wsadmin.bat -profileName AppSrv01 -user my_user_ID -password my_Password
-f "%WAS_HOME%\bin\configureWebserverDefinition.jacl" webserver1 IHS..
- From the administrative console of the deployment manager, click System
administration > Save Changes to Master Repository > Synchronize changes with Nodes >
Save.
Domino 웹 서버 전용: WAS_PLUGIN_CONFIG_FILE
환경 변수를 설정하십시오. AIX 또는 Linux 같은 플랫폼에서,
스크립트를 상위 쉘로 소스 지정하면 하위 프로세스가 내보낸 변수를 상속할 수 있습니다.
Windows 시스템에서
다른 명령을 실행하는 것처럼 스크립트를 실행하십시오. 소스 지정은
Windows 시스템에서 자동입니다.
- 명령 창을 여십시오.
- 플러그인 설치 루트 디렉토리로 디렉토리를 변경하십시오.
- plugins_root/bin/setupPluginCfg.sh
스크립트에 대해 적합한 명령을 실행하십시오.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
. plugins_root/bin/setupPluginCfg.sh (마침표와
설치 루트 디렉토리 사이에 공간이 있음에 유의하십시오.)
source plugins_root/bin/setupPluginCfg.sh
스크립트는 AIX 또는 Linux 같은 운영 체제의
lotus_root/notesdata 디렉토리에도 있습니다.
Domino 웹 서버를 시작하기 전에
스크립트에 맞는 적절한 명령을 실행하십시오.
- 관리 콘솔을 사용하여 시스템 A(애플리케이션 서버
시스템)에서 plugin-cfg.xml 파일을 재생성하십시오.
서버 > 서버 유형 > 웹 서버를 클릭하십시오.
웹 서버를 선택한 다음 플러그인 생성을 클릭하십시오.
플러그인 설치 중 기본 plugin-cfg.xml 파일은
시스템 B(웹 서버가 있는 시스템)의
plugins_root/config/web_server_name 디렉토리에 설치됩니다.
웹 서버 플러그인 구성 서비스는 plugin-cfg.xml 파일을
자동으로 재생성합니다. 애플리케이션 서버에서 현재
plugin-cfg.xml 파일을 사용하려면
다음 단계에 설명된 대로 plugin-cfg.xml
파일을 전파하십시오.
이 단계에는
plugin-cfg.xml 파일을 재생성하는 방법이
나와 있습니다. WebSphere Application Server 제품은
중대한 이벤트가 발생할 때마다 파일을 자동으로 재생성하도록
구성됩니다. 예를 들어, 이러한 이벤트에는 애플리케이션 서버와
웹 서버에 애플리케이션을 설치하는 작업이 포함됩니다. 새 가상
호스트 작성은 또 다른 이벤트입니다.
- 관리 콘솔을 사용하여 plugin-cfg.xml 파일을
애플리케이션 서버에서 웹 서버로 전파하십시오. 서버 >
웹 서버를 클릭하십시오.
웹 서버를 선택한 다음 플러그인 전파를 클릭하십시오.
IBM
HTTP Server 이외의 웹 서버는 수동으로 전파해야 합니다.
웹 서버 플러그인 구성 서비스는 IBM HTTP Server의 경우에만
plugin-cfg.xml 파일을 자동으로 전파합니다. 기타 모든 웹 서버의 경우, 시스템 A(애플리케이션 서버 시스템)의
profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name
디렉토리에서 시스템 B(웹 서버가 있는 시스템)의 plugins_root/config/web_server_name 디렉토리로
plugin-cfg.xml 파일을 수동으로 복사하여 플러그인 구성 파일을 전파하십시오.
- Snoop 서블릿을 시작하여 웹 서버가 애플리케이션 서버에서
애플리케이션을 검색할 수 있는지 확인하십시오.
애플리케이션
서버, 웹 서버를 시작하고 Snoop 서블릿을
IP 주소와 함께 사용하여 환경을 테스트하십시오.
- 애플리케이션 서버를 시작하십시오. Network Deployment 환경에서
애플리케이션 서버를 셀에 추가할 때, DefaultApplication을 포함시킨 경우에만
Snoop 서블릿을 셀에서 사용할 수 있습니다. addNode 명령에 대한
-includeapps 옵션은 DefaultApplication을 셀로 마이그레이션합니다.
애플리케이션이 없는 경우에는 이 단계를 건너뛰십시오.
- 사용 중인 IBM HTTP
Server 또는 웹 서버를 시작하십시오.
2001 페이지를 사용하거나 STRTCPSVR
SERVER(*HTTP) HTTPSVR(instance_name ) 명령을 사용하여
IBM HTTP Server를 시작하십시오.
명령 창을 사용하여 디렉토리를 IBM
HTTP Server 설치 이미지 또는 웹 서버 설치 이미지로 변경하십시오.
해당 명령을 실행하여 웹 서버를
시작하십시오. 예를 들어, IBM HTTP Server의 경우 명령은 다음과 같습니다.
명령행에서 IBM
HTTP Server를 시작하려면 다음을 수행하십시오.
IBMHttpServer/bin
디렉토리에서
apache 및
apachectl
명령에 액세스하십시오.
- 브라우저를
http://localhost:9080/snoop로 지정하여 애플리케이션 서버에서 제공한 내부 HTTP 전송을 테스트하십시오.
브라우저를 http://Host_name_of_Web_server_machine/snoop로 지정하여
웹 브라우저 플러그인을 테스트하십시오.
HTTP 전송 포트는
기본적으로 9080이며 모든 프로파일에 대해
고유해야 합니다. 포트는 설치된
DefaultApplication을 호스팅하도록 구성된 default_host라는 가상 호스트와
연관됩니다. Snoop 서블릿은 DefaultApplication의 일부입니다. 포트를 변경하여 실제 HTTP 전송 포트와 일치시키십시오.
- Snoop가 실행 중인지 확인하십시오.
두 가지 웹
주소중 하나는 Snoop 서블릿 - 요청/클라이언트 정보
페이지를 표시해야 합니다.
- 원격 IBM HTTP
Server에만 해당:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
다음 단계에 따라
원격 IBM HTTP Server에서 자동 전파 기능이 작동 가능한지 확인하십시오.
로컬 웹 서버에서는 이 프로시저가 필요하지 않습니다.
- IHS_root /conf/admin.passwd 파일에서 user=adminUser, password=adminPassword를 작성하십시오.
예를 들어 다음과 같습니다. c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd
adminUser adminPassword
- 배치 관리자 또는 애플리케이션 서버의
관리 콘솔을 사용하여
IBM HTTP Server의 관리자에 대해 작성한
사용자 ID 및 비밀번호 정보를 입력하십시오. 서버 > 웹 서버 >
web_server_definition > 원격 웹 서버 관리로 이동하십시오. 다음
값을 설정하십시오. admin Port=8008, User
Id=adminUser, Password=adminPassword.
- httpd.conf 파일 및 plugin-cfg.xml 파일에 대해 올바른
읽기/쓰기 권한을 설정하십시오. 자세한 정보는 IHS_root /logs/admin_ERROR.LOG 파일을 참조하십시오.
플러그인 구성 파일의 자동 전파를 위해서는 IBM HTTP
관리 서버를 시작하고 실행해야 합니다. WebSphere Application Server 관리 콘솔을 사용하여
IBM HTTP Server를 관리하는 경우 다음 오류가 표시될 수 있습니다.
"IHS 관리 서버에 연결할 수 없음 오류"
다음
프로시저를 수행하여 오류를 정정하십시오.
- IBM HTTP Server
관리 서버가 실행 중인지 확인하십시오.
- WebSphere Application Server
관리 콘솔에 정의된 웹 서버 호스트 이름 및 포트가 IBM
HTTP Server 관리 호스트 이름 및 포트와 일치하는지 확인하십시오.
- 방화벽이 WebSphere Application Server
관리 콘솔에서 IBM HTTP Server 관리 서버에
액세스하는 것을 방해하지 않는지 확인하십시오.
- WebSphere Application Server 관리 콘솔에서
원격 관리 아래에 지정된 사용자 ID 및 비밀번호가 htpasswd 명령을 사용하여
admin.passwd 파일에서 작성되었는지 확인하십시오.
- 안전하게 연결하려는 경우, IBM HTTP Server
관리 서버 keydb 개인 인증서를 서명자 인증서로 WebSphere
Application Server 키 데이터베이스로 내보냈는지 확인하십시오.
이 키 데이터베이스는
com.ibm.ssl.trustStore 지시문에 의해 관리 콘솔이 실행 중인 프로파일의 sas.client.props
파일에서 지정됩니다. 이러한
고려사항은 주로 자체 서명된 인증서에 적용됩니다.
- 문제점이 계속되는 경우에는 IBM HTTP Server
admin_ERROR.LOG 파일 및
WebSphere Application Server
로그(trace.log 파일)를 확인하여 문제점의 원인을 판별하십시오.
Results
This procedure results in the installation of the Web Server Plug-ins for WebSphere Application Server on a web server machine. The Web Server
Plug-ins Configuration Tool also configures the web server to support an application server on a
separate machine.
웹 서버 플러그인을 설치하면
Plugins 디렉토리와 여러 서브디렉토리가
작성됩니다. 다음은 Linux
시스템에서 작성된 디렉토리로, 예를 들면 다음과 같습니다.
- plugins_root/bin/32bits 또는 plugins_root/bin/64bits에는
지원되는 모든 웹 서버에 대한 2진 플러그인이 포함되어 있습니다.
- plugins_root/logs에는
로그 파일이 들어 있음
- plugins_root/properties에는
버전 정보가 들어 있음
What to do next
See Selecting a web server topology diagram and
roadmap for an overview of the installation procedure.
See Web server configuration for more information about the files
involved in configuring a web server.
See Plug-ins configuration for information about the location of the
plug-in configuration file.
See Editing web server configuration files for information about how the Web Server
Plug-ins Configuration Tool configures supported web servers.