중개 모듈 설치는 설치 가능한 중개 모듈 EAR 파일을
중개 모듈을 호스트할 서버나 클러스터로 옮기는 작업으로 이루어집니다. 올바르게 시작 및 실행되는 설치 중개 모듈은
전개된 파일로 간주됩니다.
중개 모듈을 JAR 파일로 내보낸 다음 serviceDeploy 명령을 사용하여
중개 모듈 JAR 파일에서 설치 가능한 EAR 파일을 작성할 수 있습니다. 설치 가능한 중개 모듈 EAR 파일을 작성하는
방법에 대한 자세한 정보는
프로덕션 서버에 모듈 설치를 참조하십시오.
중개 모듈에서 제공하는 기능을 사용하여 응용프로그램과 서버를 통합하기 위해
WebSphere ESB를 활성화하려면
중개 모듈 EAR 파일을 서버나 클러스터에 설치한 다음 전개된 모듈을 시작해야 합니다.
이 주제에서는 관리 콘솔을 사용하여 중개 모듈 EAR 파일을 설치하는
방법을 설명합니다. 또는 엔터프라이즈 응용프로그램을 WebSphere Application Server에
설치할 때와 같은 방법으로 install 또는 installinteractive 명령과 같은 다른 메소드를 wsadmin 도구와 함께 사용할 수도 있습니다.
중요사항: 아래 단계를 수행하기 시작한 후, 응용프로그램을 설치하지 않기로
결정한 경우, 취소를 클릭하여 종료하십시오. 먼저 응용프로그램 설치 페이지에서 취소를
클릭하지 않고 다른 관리 콘솔로 이동하지 마십시오.
관리 콘솔을 사용하여 중개 모듈 EAR 파일을 설치하려면
다음 단계를 완료하십시오.
- 콘솔 탐색 트리에서 를 클릭하십시오. 두 개의 응용프로그램 설치를 위한 준비 페이지 중
첫 번째 페이지가 표시됩니다.
- 첫 번째 응용프로그램 설치 준비 페이지에서 다음 하위 단계를 완료하십시오.
- 중개 모듈 EAR 파일(.ear 파일)의 전체 경로 이름을 지정하십시오. 설치하려는 EAR 파일은
클라이언트 시스템(관리 콘솔 웹 브라우저를 실행하는 시스템) 또는 서버
시스템(클라이언트가 연결된 시스템)에 있을 수 있습니다. 클라이언트 시스템에서 EAR 파일을 지정하는 경우,
관리 콘솔은 콘솔이 실행 중인 시스템에 EAR 파일을 업로드한 다음 응용프로그램
설치를 계속합니다.
- 다음을 클릭하십시오
- 두 번째 응용프로그램 설치 준비 페이지에서 다음 하위 단계를 완료하십시오.
- 기본 바인딩을 생성할지 여부를 선택하십시오.
기본 바인딩을 사용하면 응용프로그램의 바인딩이 기본값으로 다 채워지지 않습니다.
기존 바인딩은 변경되지 않습니다.
기본
바인딩을 생성하는 데 사용되는 기본값을 사용자 정의할 수
있습니다.
- 다음을 클릭하십시오. 보안 경고가 표시되면
계속을 클릭하십시오. 새 응용프로그램 설치 페이지가 표시됩니다. 기본
바인딩 생성을 선택하면 요약 단계(아래 마지막 단계)로
진행할 수 있습니다.
- 단계: 설치 옵션 선택 패널에서
다음과 같은 설정값을 제공하십시오. 이 페이지의 설정에 대한 자세한 정보는
설치 옵션 선택 설정을 참조하십시오. 값을 지정하지 않으면
기본값이 사용됩니다.
- 응용프로그램을 설치할 디렉토리,
응용프로그램 EAR 파일을 설치할 디렉토리를 지정합니다. 기본값은 APP_INSTALL_ROOT/cell_name의 값입니다.
여기서 APP_INSTALL_ROOT 변수는 install_root/installedApps입니다.
예를 들어 WebSphere ESB를
Windows의 C:\Program Files\WESB\에 설치할 경우
기본 위치는 C:\Program Files\WESB\profile_name \installedApps\cell_name입니다.
주: 독립형 프로파일에
응용프로그램을 설치한 경우 설치 디렉토리를 지정하지 않으면, 응용프로그램은
APP_INSTALL_ROOT/base_cell_name에 설치됩니다. Deployment Manager 셀에
독립형 서버를 추가하는 경우, 새 서버 구성의 셀 이름은 Deployment Manager 노드의 셀 이름이 됩니다.
-includeapps
옵션을 addNode 유틸리티에 사용하면, addNode 조작 전에 설치한 응용프로그램은
계속 APP_INSTALL_ROOT/base_cell_name 설치 디렉토리를 사용합니다.
그러나 서버가 네트워크 구성에 추가된 후 설치된 응용프로그램은 기본 설치 디렉토리
APP_INSTALL_ROOT/network_cell_name을 사용합니다. addNode 조작을 실행 중인 APP_INSTALL_ROOT/network_cell_name
위치로 응용프로그램을 이동하려면
설치 중에 설치 디렉토리를 명시적으로 ${APP_INSTALL_ROOT}/${CELL}로 지정해야 합니다.
이 경우 이러한 응용프로그램 파일은 항상
APP_INSTALL_ROOT/current_cell_name에서 찾을 수 있습니다.
- 응용프로그램 분배에서는 WebSphere ESB가 설치 목적지에서 응용프로그램 2진을 펼치거나
삭제하는지 여부를 지정합니다. 기본값은 응용프로그램 분배를 사용 가능하게 하는 것입니다. 결과적으로 콘솔에서
변경사항을 저장하면 새로 설치된 응용프로그램의 응용프로그램 2진이 지정된 디렉토리로 확장됩니다. 2진은 또한 구성 변경사항 설치 제거 및 저장 시
삭제됩니다. 이 옵션을 사용 불가능하게 하는 경우, 응용프로그램이
실행되는 모든 노드의 대상 디렉토리에 응용프로그램 2진이 올바르게
펼쳐졌는지 확인해야 합니다.
중요사항: 이 옵션을 사용 불가능하게 하고 응용프로그램 2진을 노드로 복사하고
펼치지 않은 경우, 구성 또는 수동 동기화의 나중 저장은
응용프로그램 2진을 노드로 이동시키지 않습니다.
- 2진 구성 사용에서는 서버 또는 클러스터가 응용프로그램 전개 문서, deployment.xml 파일(기본값)
또는 EAR 파일에 있는 바인딩, 확장자 및 전개 설명자를 사용할지
여부를 지정합니다.
- 응용프로그램 이름에서는 응용프로그램 이름을 입력하십시오. 응용프로그램
이름은 셀 내에서 고유해야 하며 오브젝트 이름에서 허용되지 않는 문자를 포함할
수 없습니다. 오브젝트 이름에 사용할 수 없는 문자 목록은
오브젝트 이름을 참조하십시오.
- 자원에 대한 MBeans 작성에서는 응용프로그램이 시작할 때 다양한 자원(Servlet 또는 JSP 파일)에 대한 MBean을
응용프로그램 내에서 작성할지 여부를 지정합니다. 기본값은 MBean 인스턴스를 작성하는 것입니다.
- 클래스 재로드 사용 가능에서는 응용프로그램 파일이 갱신될 때 클래스 재로드 사용 가능 여부를 지정합니다. 기본값은 클래스 재로딩
사용 불가능입니다. 클래스 재로드 사용 가능은
중개 모듈의 deployment.xml 파일에서 reloadEnabled를 true로 설정합니다.
중개 모듈의 클래스 정의가 변경되면 Application Server 런타임이
응용프로그램을 중지한 후 재시작하여 응용프로그램 클래스를 재로드합니다.
- 재로드 간격(초)에서는 갱신된 파일에 대해 응용프로그램 파일 시스템을 스캔할
시간(초)을 지정하십시오. 기본값은 EAR 파일의
IBM 확장자(META-INF/ibm-application-ext.xmi) 파일 내 재로드 간격 속성 값입니다. 재로드할 수 있게 하려면 0보다 큰 값을
지정하십시오(예: 1 - 2147483647). 재로드할 수 없게 하려면 0을 지정하십시오.
여기에 지정된 재로드 간격은
클래스 재로드를 사용할 수 있는 경우에만 유효합니다.
- 웹 서비스 전개에서는 응용프로그램 설치 중에 웹 서비스 전개 도구인 wsdeploy를 실행할지 여부를
지정합니다. 이 도구은 웹 서비스를 사용하여 응용프로그램을 실행하는 데 필요한
코드를 생성합니다. 기본값은 wsdeploy 도구를 실행하지 않는 것입니다.
EAR 파일에 웹 서비스를 사용하는 모듈이 들어 있으며
이전에 wsdeploy 도구가 실행되지 않은 경우,
명령행이나 어셈블리 도구의 전개 메뉴 선택사항에서
이 설정을 사용 가능하게 해야 합니다.
- 입력 유효성 검증 값(off/warn/fail)에서는 WebSphere ESB가 응용프로그램 설치 또는 갱신 중에
지정된 응용프로그램 참조를 조사하는지 여부를 지정하며,
유효성 검증이 사용 가능한 경우 사용자에게 잘못된 참조를 경고하거나
또는 조작이 실패합니다. 응용프로그램은 일반적으로 컨테이너 관리 지속(CMP) Bean용
데이터소스를 사용하거나 전개 설명자에 정의된 자원 참조 또는
자원 환경 참조를 사용하여 자원을 참조합니다. 유효성 검증은 응용프로그램에서 참조하는 자원이
해당 응용프로그램의 전개 대상 범위에 정의되어 있는지 여부를 확인합니다. 자원 유효성 검증을 하지 않을 경우
off, 잘못된 자원 참조에 관하여 메시지에 경고할 경우
warn 또는 잘못된 자원 참조 결과로 실패한 조작을 중지하려면
fail을 선택하십시오.
- 프로세스 임베디드 구성에서는 임베디드 구성을 처리할지 여부를 지정합니다. 임베디드 구성은
resource.xml 및 variables.xml 등의 파일로 이루어집니다.
선택되거나 true인 경우, 임베디드 구성은 .ear 파일의
응용프로그램 범위에 로드됩니다. .ear 파일에
임베디드 구성이 포함되지 않으면 기본값은 false입니다. .ear 파일에
임베디드 구성이 포함되어 있으면 기본값은 true입니다.
- 단계: 서버에 모듈 맵핑 패널에서 모든 모듈에 대해
클러스터 및 서버 목록에서 대상 서버 또는 클러스터를
선택하십시오. 모듈 옆의 선택란을 선택하여
중개 모듈을 선택하십시오.
응용프로그램이 WebSphere Adapter를 사용하는 경우 각 RAR 파일에 대해
대상 서버 또는 클러스터를 지정하십시오. 또한, RAR 모듈에 정의된 자원 어댑터를 사용하는
다른 모든 모듈을 동일한 대상에 맵핑하십시오.
주: 서버에 RAR 파일을 설치할 때 WebSphere ESB는
커넥터 모듈에 대한 Manifest(MANIFEST.MF)를 검색합니다. 먼저
RAR 파일에서 connectorModule.jar 파일을 찾고 _connectorModule.jar 파일에서
Manifest를 로드합니다. 클래스 경로 항목이 connectorModule.jar 파일의 Manifest에 있는 경우,
RAR은 이 클래스 경로를 사용합니다. 설치된 커넥터 모듈이
필요한 클래스와 자원을 찾는지 확인하려면 콘솔을 사용하여 RAR에 대한 클래스 경로
설정을 확인하십시오. 클래스 경로 설정에 대한 자세한 정보는
관리 콘솔의 자원 어댑터 설정 및 WebSphere 관계형 자원 어댑터 설정을 참조하십시오.
요청을 응용프로그램에 라우트하는 웹 서버를 대상으로
지정할 수 있습니다. 각 웹 서버에 대한 플러그인 구성 파일 plugin-cfg.xml은 웹 서버를 통해
라우트되는 응용프로그램에 기초하여 생성됩니다.
웹 서버로 응용프로그램을 지원하게 하려면 Ctrl 키를 사용하여
Application Server 또는 클러스터와 웹 서버를 함께 선택하여 해당 웹 서버에 대한 플러그인 구성 파일
plugin-cfg.xml이 웹 서버를 통해 라우트된 응용프로그램에 기초하여 생성되도록 하십시오.
- 응용프로그램에서 자원 참조를 정의하는 경우, 단계: 자원으로 자원 참조
맵핑에서, 자원 참조에 지정된 로직 이름을 나타내는 자원의 JNDI 이름을 지정하십시오. 응용프로그램에 정의된
각 자원 참조는 요약 패널에서 완료를 클릭하기 전에 WebSphere ESB 구성에
정의된 자원에 바인드되어야 합니다.
- 옵션: 자원에 대한 로그인 구성 이름 및 인증 등록 정보를 지정하십시오.
- 확인을 클릭하여 값을 저장하고 맵핑 단계로 돌아가십시오.
- 응용프로그램에서 웹 모듈을 사용하는 경우 단계: 웹 모듈에 대한
가상 호스트 맵핑에 대해, 응용프로그램에 정의된 웹 모듈에 맵핑되는 가상 호스트를 목록에서 선택하십시오.
가상 호스트 정의에 지정된 포트 번호는
웹 모듈의 artifact(예: Servlet, JSP 파일)에 액세스하는 데
사용되는 URL에 사용됩니다. 각 웹 모듈에는 모듈이 맵핑되는
가상 호스트가 있어야 합니다. 필요한 가상 호스트를 모두 지정하지 않으면,
요약 패널에서 완료를 클릭한 후 유효성 검증 오류가 발생하게 됩니다.
- 응용프로그램의 보안 역할이 해당 전개 설명자에 정의된 경우,
단계: 사용자/그룹에 보안 역할 맵핑에서, 각 보안 역할에 맵핑되는
사용자 및 그룹을 지정하십시오.
역할을 선택하여 모든 역할을
선택하거나 개별 역할을 선택하십시오.
각 역할에 대해 다음 선택사항 중 하나를 선택하여 적용할 보안 방법을
지정하십시오.
옵션 |
설명 |
모든 사용자 |
보안이 적용되지 않는 것과 동일합니다. |
모든 인증된 사용자 |
올바른 사용자 이름과 암호를
사용하여 인증된 사용자는 모두 역할의 구성원입니다. |
맵핑된 사용자 |
개별 사용자가 역할의 구성원으로 나열됩니다. |
맵핑된 그룹 |
그룹을 사용하면 사용자를 가장 쉽게 추가할 수 있습니다.
식별된 그룹의 모든 구성원은 역할의 구성원이 됩니다. |
맵핑된 사용자 또는 맵핑된 그룹에서는
사용자 레지스트리에서 특정 사용자 또는 그룹을 선택하려면 다음을 수행하십시오.
- 역할을 선택한 다음 사용자 찾아보기 또는 그룹 찾아보기를 클릭하십시오.
- 표시된 사용자/그룹 찾아보기 패널에서,
사용자 레지스트리로부터 사용자 또는 그룹 목록을 추출할 검색 기준을 입력하십시오.
- 표시된 결과에서 개별 사용자 또는 그룹을 선택하십시오.
- 확인을 클릭하여 단계: 사용자/그룹에 보안 역할 맵핑 패널에서
선택한 역할에 선택한 사용자 또는 그룹을 맵핑하십시오.
- 응용프로그램의 Run As 역할이 전개 설명자에 정의된 경우,
단계: 사용자로 RunAs 역할 맵핑에서,
모든 Run As 역할에 대한 Run As 사용자 이름 및 암호를
지정하십시오. Run As 역할은 다른 Enterprise Bean과 상호작용하는 동안 특정
역할로서 실행해야 하는 Enterprise Bean에서 사용합니다. 역할을 선택하여 모든 역할을
선택하거나 개별 역할을 선택하십시오.
역할을 선택한 다음 사용자 이름, 암호 값을 입력하고 적용을
클릭하십시오.
- 응용프로그램에 자원 환경 참조가 있는 경우, 단계: 자원에 자원 환경 참조
맵핑에서, 자원 환경 참조에 정의된 로직 이름에 맵핑되는 자원의
JNDI 이름을 지정하십시오. 각 자원 환경 참조에 이와 연관된 자원이 없으면,
완료를 클릭한 후 유효성 검증 오류가 표시됩니다.
- 응용프로그램에서 Run-As ID를 시스템 ID로 정의하는 경우,
단계: RunAs 시스템을 RunAs 역할로 바꾸기에서, 선택적으로 RunAs 시스템을
Run-As 역할로 변경하고 지정된 Run As 역할에 사용자 이름 및 암호를
지정할 수 있습니다. 시스템 ID를 선택하면 WebSphere Application Server 보안 서버 ID를
사용하여 호출이 수행되고, 이 ID에는 더 많은 권한이 있기 때문에 주의해서 사용해야 합니다.
- 응용프로그램이 백엔드 처리를 수행하는 Oracle 데이터베이스가 있는 자원에
맵핑하는 자원 참조를 갖는 경우, 단계: Oracle 유형 프로바이더에 대해 분리 레벨 지정에서,
응용프로그램을 통해 사용될 때 이러한 자원에 사용할 분리 레벨을 지정하거나 정정하십시오. Oracle 데이터베이스는
ReadCommitted 및 Serializable 분리 레벨만 지원합니다.
- 요약 패널에서 응용프로그램 모듈이 설치될 셀, 노드 및 서버를 확인하십시오.
- Cell/Node/Server 옆에 여기를 클릭을 클릭하십시오.
- 설정을 확인하십시오.
- 완료를 클릭하십시오.
응용프로그램 파일이 제대로 설치되는지 여부를 표시하는 여러
메시지가 표시됩니다.
OutOfMemory 예외를 수신하고
소스 응용프로그램 파일이 설치되지 않는 경우, 시스템의 메모리가 부족하거나
서버에 설치하기에 너무 많은 모듈이 응용프로그램에 있을 수 있습니다.
시스템 메모리 부족이 예외의 원인이 아닌 경우, .ear 파일이
더 적은 모듈을 가지도록 응용프로그램을 다시
패키지하십시오. 시스템 메모리 부족 및 모듈 수가 예외의 원인이
아닌 경우 관리 콘솔을 실행하는 Application Server의
Java Virtual Machine 페이지에
지정된 옵션을 확인하십시오. 그런 다음, 응용프로그램 파일을
다시 설치하십시오.
설치 중 특정 응용프로그램 파일이
구성 세션이 표시하는 디렉토리로 추출되고, 구성 저장 시 이들 파일은
WebSphere Application Server 구성 저장소에 저장됩니다.
Windows 시스템에서는 파일 경로가 256 문자로 제한됩니다.
따라서 구성 세션 및 구성 저장소의 응용프로그램
파일 경로가 256자 제한을 초과하는 경우 응용프로그램 설치에 실패할 수 있습니다.
경로 이름이 너무 김 메시지와 함께 FileNotFound 예외가 발생할 수 있습니다.
이러한 문제점을 극복하려면 응용프로그램 이름과 모듈 URI 이름을 더 짧게 하여
파일 경로의 길이를 줄이십시오.
그런 다음, 응용프로그램 파일을
다시 설치하십시오.
응용프로그램 파일이 설치되면 다음 조치를 완료하십시오.
- 응용프로그램이 필요로 하는 공유 라이브러리를
응용프로그램과 연관시키십시오.
- 구성에 대한 변경사항을 저장하십시오. 응용프로그램이 관리 구성에
등록되고 응용프로그램 파일이 대상 디렉토리에 복사됩니다. 대상 디렉토리는
기본적으로 install_root/installedApps/cell_name이거나,
사용자가 지정하는 디렉토리입니다. Network Deployment 프로파일로 설치된 경우,
Deployment Manager의 구성이 개별 노드의 구성과 동기화될 때 파일이 원격 노드로 복사됩니다.
- 모듈이 서버 클러스터에 전개된 경우 엔터프라이즈 응용프로그램 페이지에서 갱신 롤아웃을
클릭하여 모든 클러스터 구성원에 변경된 구성을 전파하십시오.
갱신 롤아웃은 클러스터 구성원이 들어 있는 노드에 대해
순차적으로 구성을 갱신합니다.
중개 모듈에서 제공하는 기능을 사용하여 응용프로그램과 서버를 통합하기 위해
WebSphere ESB를 활성화하려면
전개된 모듈을 시작해야 합니다. 모듈을 수동으로 시작하거나 자동으로 시작되도록
구성할 수 있습니다. 또한 모듈 구성을 변경하거나, 모듈을 중지 또는 갱신시키거나, 모듈의
활동을 관리하는 등의 여러 가지 방법으로 모듈을 관리할 수 있습니다.