This procedure describes installing a web server and its
plug-in on a machine where the default profile is a custom profile.
Before you begin
다중 프로파일이 존재하면 웹 서버 플러그인 구성 도구가
구성하는 플러그인을 선택할 수 있습니다.
구성할 프로파일을 선택하는 방법을 판별하는 논리 플로우에 대한 설명은
Plug-ins configuration의
내용을 참조하십시오.
다중 프로파일이 존재하면 웹 서버 플러그인 구성 도구가
구성하는 플러그인을 선택할 수 있습니다.
구성할 프로파일을 선택하는 방법을 판별하는 논리 플로우에 대한 설명은
Plug-ins configuration의
내용을 참조하십시오.
This procedure configures the custom
profile on Machine B. This procedure assumes that you already have
installed a deployment manager on Machine A.
The WebSphere® Application Server node on Machine
B is the custom node that you create in this procedure. This procedure
starts the deployment manager and federates the custom node before
installing the Web Server Plug-ins.
Start the deployment manager.
The deployment manager must be running to successfully federate and
configure the custom node.
About this task
Note: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을
참조합니다. 권장되는 대안은 분배 및 IBM® i 시스템에서 SystemOut.log, SystemErr.log, trace.log 및 activity.log 파일을 사용하는 대신
HPEL(High Performance Extensible Logging) 로그를 사용하고
인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우
서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여
모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는
HPEL을 사용한 애플리케이션 문제점 해결 정보를
참조하십시오.
Use
this procedure to install the web server plug-in, configure the web
server, and create a web server definition in the custom profile (custom
node).
지원된 구성: 이 도구는 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
Procedure
- 운영 체제에 로그온하십시오.
루트가 아닌
사용자 또는 관리자가 아닌 사용자로 설치하는 경우 몇 가지
제한사항이 있습니다.
![[Windows]](../images/windows.gif)
Windows
운영 체제에 관리 사용자로 설치할 때 Windows
서비스를 자동으로 작성하여 애플리케이션 서버를
자동으로 시작합니다. 설치 프로그램
사용자 계정에는 다음과 같은 고급 사용자 권한이 있어야 합니다.
예를 들어, 일부 Windows 운영 체제에서는
제어판 > 관리 도구 > 로컬 보안 정책 > 로컬 정책 > 사용자 권한 지정을 클릭하여
고급 옵션을 설정하십시오. 자세한 정보는 Windows
운영 체제 문서를 참조하십시오.
Windows 서비스로 애플리케이션 서버를 실행하려는 경우
공백이 포함된 사용자 ID로는
설치하지 마십시오. 공백이 있는 사용자 ID는 유효성 검증할 수 없습니다.
이러한
사용자 ID로는 설치를 계속할 수 없습니다. 이 제한사항을 해결하려면 공백이 없는 사용자 ID로 설치하십시오.
- Use Installation Manager to install the following on Machine
B.
- WebSphere Application
Server Network Deployment
- Web Server Plug-ins for WebSphere Application
Server
- Websphere Customization Toolbox
- Use Installation Manager to install IBM HTTP Server on Machine B, or install another
supported web server on Machine B.
- Create a custom profile as the first profile on Machine
B, and federate the node as you create the profile.
- Optional: Use the administrative console of
the deployment manager to create an application server on the custom
node.
Click Servers > Applications servers >
New and follow the instructions to create a server. A
server is not required for installing the plug-ins but it lets you
verify the functionality of the web server.
- Optional: Install the DefaultApplication on
the new server while you are in the administrative console of the
deployment manager.
The DefaultApplication includes
the Snoop servlet. The verification step uses the Snoop servlet.
- Open the WebSphere Customization
Toolbox and launch the Web Server Plug-ins Configuration Tool on Machine
B.
- Select a web server plug-in runtime location.
If
the location of a previously installed web server plug-in 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 local scenario.
- Perform one of the following actions:
- Enter the installation location of WebSphere Application Server (app_server_root).
- Click Browse, find the installation location of WebSphere Application Server
(app_server_root), and click OK.
- Click Next.
- Select the profile to configure with the current web server
plug-in, and click Next.
- Review the summary information, and click Configure to
begin configuring the web server, web server plug-in, and profile.
- 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.
- Create the web server definition on Machine A.
You
can use the administrative console of the deployment manager to create
the web server definition on a federated node; or you can run the
configuration script that the Web Server Plug-ins Configuration Tool
created.
The script already contains all of the information
that you must gather when using the administrative console option.
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 웹 서버를 시작하기 전에
스크립트에 맞는 적절한 명령을 실행하십시오.
- 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 파일)를 확인하여 문제점의 원인을 판별하십시오.
- If the deployment manager does not have
the DefaultApplication installed, you can test the functionality of
the web server and the custom node using an application of your own.
- 배치 관리자의 관리 콘솔에서 시스템 관리 >
마스터 저장소에 변경사항 저장 > 노드에서 변경사항 동기화 > 저장을
클릭하십시오.
- To create multiple web server definitions for the managed
node, use the Web Server Plug-ins Configuration Tool to configure
each web server.
Identify the same managed node each
time. Give each web server a different nick name.
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 creates a web server definition within the managed node.
The
Web Server Plug-ins Configuration Tool configures the web server to
use the plugin-cfg.xml file that is within the
managed custom node.
The deployment manager regenerates the
web server plug-in configuration file, plugin-cfg.xml whenever
an event occurs that affects the file. Such events include the addition
or removal of an application, server, or virtual host.
The
creation or removal of clusters and cluster members also causes file
regeneration. Automatic propagation through node synchronization copies
the file after each regeneration to the following location on the
custom node machine:
profile_root
/config/cells/cell_name/nodes/
node_name_of_custom_profile/servers/
web_server_name/plugin-cfg.xml
웹 서버 플러그인을 설치하면
Plugins 디렉토리와 여러 서브디렉토리가
작성됩니다. 다음은 Linux
시스템에서 작성된 디렉토리로, 예를 들면 다음과 같습니다.
- plugins_root/bin/32bits 또는 plugins_root/bin/64bits에는
지원되는 모든 웹 서버에 대한 2진 플러그인이 포함되어 있습니다.
- plugins_root/logs에는
로그 파일이 들어 있음
- plugins_root/properties에는
버전 정보가 들어 있음
What to do next
See Plug-ins configuration for
information about the location of the plug-in configuration file.
See Web server configuration for
more information about the files involved in configuring a web server.
See Editing web server configuration files for information
about how the Web Server Plug-ins Configuration Tool configures supported
web servers.
See 웹 서버 플러그인 구성 for
information about other installation scenarios for installing Web
server plug-ins.