여러 개의 WebSphere 프로파일이나 클러스터 환경에서 생성된
plugin-cfg.xml파일을 하나로 통합해야 할 때 사용하는pluginCfgMerge도구의 사용법과 작업 절차를 정리합니다. 또한 수동 병합 시 관리 콘솔에서 변경해야 할 설정을 다룹니다.
1. 플러그인 병합 도구 (Plugin Merge Tool)
WAS 설치 루트의 bin 디렉토리에 위치한 스크립트를 사용하여 두 개의 플러그인 파일을 하나로 병합합니다. WAS 버전에 따라 스크립트 이름이 pluginMerge 또는 pluginCfgMerge일 수 있습니다.
구문 (Syntax)
# 기본 구문
[실행스크립트] [소스파일1] [소스파일2] [결과파일]운영체제별 실행 경로
Unix / Linux
# WAS 버전에 따라 파일명이 다를 수 있음
[AppServer_Root]/bin/pluginMerge.sh plugin_cfg1.xml plugin_cfg2.xml result_cfg.xml
# 또는
[AppServer_Root]/bin/pluginCfgMerge.sh plugin_cfg1.xml plugin_cfg2.xml result_cfg.xmlWindows
[AppServer_Root]\bin\pluginMerge.bat plugin_cfg1.xml plugin_cfg2.xml result_cfg.xml
# 또는
[AppServer_Root]\bin\pluginCfgMerge.bat plugin_cfg1.xml plugin_cfg2.xml result_cfg.xml2. 병합 작업 절차 (Workflow)
Step 1: 사전 준비 및 백업
작업 시작 전, 기존에 웹 서버에서 사용 중인 plugin-cfg.xml 파일을 반드시 백업합니다.
# Linux 예시
cp /apps/wes/IBM/plugin-cfg.xml /apps/wes/IBM/plugin-cfg.xml.bak_YYYYMMDDStep 2: 소스 파일 준비
- 각 프로파일(또는 노드)에서 최신
plugin-cfg.xml파일을 새로 생성(Generate)합니다. - 병합할 플러그인 파일들을 작업할 한 디렉토리에 모아둡니다.
- 파일명이 겹치지 않도록 구분하여 변경합니다. (예:
plugin-cfg01.xml,plugin-cfg02.xml)
Step 3: 병합 명령어 실행
준비된 두 개의 파일을 병합하여 최종 파일을 생성합니다.
# 예시: plugin-cfg01.xml과 plugin-cfg02.xml을 병합하여 plugin-cfg.xml 생성
./pluginCfgMerge.sh /apps/wes/IBM/plugin-cfg01.xml /apps/wes/IBM/plugin-cfg02.xml /apps/wes/IBM/plugin-cfg.xmlStep 4: 웹 서버 적용
생성된 최종 plugin-cfg.xml 파일을 웹 서버의 플러그인 경로로 복사하고, 필요시 웹 서버를 재기동합니다.
3. WebSphere 관리 콘솔 설정 (필수)
플러그인 파일을 수동으로 병합하여 사용하는 경우, WAS 관리 콘솔에서 자동 생성 및 전파 옵션을 비활성화해야 합니다. 이 옵션이 켜져 있으면 WAS가 자동으로 파일을 재생성하여 수동 병합된 내용을 덮어쓸 위험이 있습니다.
설정 경로
웹 서버(Web Servers) > [웹서버명] > 플러그인 특성(Plug-in properties)
변경 사항
- 플러그인 구성 파일 자동 생성 (Automatically generate the plug-in configuration file): 체크 해제 (False)
- 플러그인 구성 파일 자동 전파 (Automatically propagate the plug-in configuration file): 체크 해제 (False)
Note: 위 설정을 적용하면 이후 플러그인 변경 사항이 발생할 때마다 수동으로 병합 및 복사 작업을 수행해야 합니다.
Next Step:
병합된 플러그인 파일이 정상적으로 작동하는지 확인하기 위해, 웹 서버의 http_plugin.log를 모니터링하여 파싱 오류나 로딩 실패 메시지가 없는지 점검하십시오.