[BPM]IBM BPM Cumulative Fixpack 업데이트 하기

안녕하세요 이정운 입니다.

IBM BPM 은 WW 의 다양한 사례를 통해서 문제를 해결하고 고객의 요구에 따라서 기능을 강화하여 보통 분기 단위로 Cumulative Fixpack 을 출시합니다. 다시 말씀드려, 해당 fixpack 에는 문제 수정사항만을 포함하고 있는 것이 아니라 고객의 요구사항을 최대한 반영하여 새로운 기능 추가도 포함되어 있기 때문에 이를 업데이트 하시면 기존 IBM BPM 환경에서 문제 발생 가능성을 줄이는 것 뿐만 아니라 새로운 기능도 사용 가능합니다.

다만, 그에 대해서 Step-by-step 형태의 가이드가 없는 것 같아 간단하게 테스트 후 그 내용 공유드리오니 참고하시기 바라겠습니다.

1) Cumulative Fixpack 다운로드 및 업데이트 하기

Upgrading profiles from IBM Business Process Manager Version 8.5.7.0 to IBM Business Process Manager V8.5.7 Cumulative Fix 2016.06
http://www-01.ibm.com/support/docview.wss?uid=swg27047845

IBM BPM 의 최신 fixpack 은 현재 기준(2016년 10월)으로 IBM BPM v8.5.7 Cumulative Fix 2016.09 입니다. 해당 버전의 fixpack 을 인터넷을 통해서 다운로드 받으면 되며 IBM BPM 의 내장 엔진인 WAS 와  Java 도 최신 버전의 fixpack 을 다운로드 받습니다.(WAS : IBM WAS fixpack 8.5.5.10, IBM Java 7.0.9.40)

Downloading IBM Business Process Manager V8.5.7 Cumulative Fix 2016.09
http://www-01.ibm.com/support/docview.wss?uid=swg24042580

8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
http://www-01.ibm.com/support/docview.wss?uid=swg24042150

IBM WebSphere Java SDKs for WebSphere Application Server V8.5.5.10
http://www-01.ibm.com/support/docview.wss?uid=swg24042600

정상적으로 fixpack 을 다운로드 하고 압축을 푼후에 각 컴포넌트를 하나의 폴더로 합쳐놓으면 하단과 같습니다. (모든 fixpack 이 1번, 2번으로 쪼개져 있는데 압축을 풀고 폴더를 하나로 합쳐놓으면 됩니다.)

이제 fixpack 을 실제로 설치하기 위하여 IBM Installation Manager 를 구동한 후에 파일 > 환경 설정을 클릭하여 저장소를 하단과 같이 추가합니다.(각 폴더에 들어있는 repository.config 를 설정)

저장소 추가가 완료되면 다시 Installation Manager 의 첫화면으로 돌아와 업데이트를 선택하여 다음과 같이 3개의 컴포넌트에 대해서 업데이트가 가능한 것을 확인합니다.

이후 부터는 마법사 형태라 다음, 다음만 클릭하면 정상적으로 설치가 됩니다. 정상적으로 설치가 완료 되었다면 설치된 BPM 위치의 bin 디렉토리에서 versionInfo.sh/bat 을 수행하면 하단과 같이 설치된 버전 리스트가 나오는데 하단과 같이 나오면 1차 업데이트는 성공적으로 완료하신 것 입니다.

업데이트가 완료되면 이제 각 profile 에 따른 업데이트 작업을 수행해야 하는데 메인 버전이 동일하다면(예를 들어 8.5.7) 하단과 같이 startManager.sh/bat 이나 startNode.sh/bat 을 수행하면 자동으로 해당 profile 에 대한 업데이트를 수행하게 되어 있습니다.

자동 업데이트 중에 상단과 같이 failed 된다면 하단의 링크를 참고하여 로그 파일을 확인해보면 됩니다.

Identifying and recovering from profile upgrade or toolkit upgrade errors
http://www-01.ibm.com/support/docview.wss?uid=swg27047845#errors

C:\IBM\BPM857\AppServer\profiles\ADmgrProfile\logs\BPMConfig_20161017-130548.log

C:\IBM\BPM857\AppServer\profiles\ADmgrProfile\logs\bootstrapProcesServerData.log

상단의 로그를 보시면 아시겠지만 BPMConfig 는 정상적으로 수행되었는데 bootstrapProcessServerData 부분에서 스키마가 달라서 DB 업데이트를 실패한 것을 확인 가능합니다. BPM 8.5.7 CF 2016.09 fixpack은 DB 스키마 업데이트가 필요한데 해당 부분이 수행이 안되어서 오류가 난 것입니다. 하단과 같은 명령어를 통해서 DB 업그레이드를 수행합니다.

BPM설치/bin/DBUpgrade.bat -profileName ADmgrProfile -de De2 –noPrompt

DB 업그레이드 작업이 정상적으로 완료되었으면 startManager.sh/bat 명령을 통해서 Dmgr 을 다시 시작시켜 봅니다.

위에 보시는 것처럼 이제는 정상적으로 Dmgr 이 시작된 것을 확인할 수 있습니다. 마찬가지로 각 노드에서 startNode.sh/bat 명령어를 이용해서 node agent 를 시작합니다.

정상적으로 Dmgr 과 node agent 가 시작되었으므로 브라우저를 통해서 관리콘솔에 접속 가능합니다. 접속을 해보시면 아시겠지만 BPM(WAS) 버전이 올라가 있는 것을 하단과 같이 확인 가능합니다.

마지막으로 필요한 server 를 시작시켜서 SystemOut.log 를 확인해봤을때 Exception 없이 하단과 같이 “e-business를 위해 XXXXX 서버가 열려 있습니다.” 라고 나온다면 정상적으로 BPM 서버도 기동 된 것입니다.

참고 : Cumulative Fixpack 을 적용하고 나면 하향 호환성을 준수하며 이후에 보강된 기능이나 이슈가 있어서 변경된 기능을 실 운영환경에 적용여부를 선택적으로 수행할 수 있습니다. 그 부분이 하단의 링크에 보이는 Post-upgrade tasks 입니다.

Post-upgrade tasks for IBM Business Process Manager V8.5.7 Cumulative Fix 2016.09
http://www-01.ibm.com/support/docview.wss?uid=swg27048418

예를 들어 REST API 에 대한 멤버 lookup 에 대한 성능 이슈가 있어서 이를 높이기 위하여 하단과 같은 APAR 가 나왔었고 이를 실제 운영환경에 적용하고 싶다면 가이드에 따라서 해당 설정을 변경해주고 BPM 서버를 재시작하면 됩니다.(운영환경에서 그러한 이슈가 없다면 당연히 적용하지 않아도 됩니다.)

이를 좀 더 이해하기 쉽게 순차적으로 설명 드리면 가이드에 명시된 것처럼 100Custom.xml 파일을 확인해서 옵션을 추가하고 저장합니다. (이때 해당 BPM 서버는 가급적 내려 두는 것이 좋습니다.)
dmgr_profile_root\config\cells\cell_name\clusters\cluster_name\server_type\config\100Custom.xml

이후 관리콘솔에서 System administrators > Nodes 메뉴에서 Full Resynchronize 를 선택하여 설정을 전체 노드로 동기화 합니다.(만약 해당 파일을 변경하고 Dmgr 부터 전체 재시작을 하였다면 이 작업은 생략해도 상관없습니다.)

그러면 정상적으로 새로 시작되는 BPM 서버는 변경된 설정이 반영됩니다.

참고 : Cumulative Fixpack 에는 수정사항과 보강된 기능이외에 사용자의 요구사항에 맞추어서 새로운 기능이 추가될 수도 있습니다. 해당 부분은 하단과 같이 What’s New 에서 확인 가능합니다.

What's New in IBM Business Process Manager V8.5.7 Cumulative Fix 2016.09
http://www-01.ibm.com/support/docview.wss?uid=swg27048504

참고 : 프로세스 디자이너는 하단과 같이 브라우저를 통해서 Process Center 에 접속후에 다운로드 한 후에 installProcessDesigner_admin.bat 를 이용해서 설치해서 사용하면 됩니다.

혹여 프로세스 디자이너 설치중에 하단과 같은 Exception 이 나온다면 다운받은 파일 중에 eclipse.ini 파일과 etc 폴더를 카피한 후 화면에 나오는 C:\IBM\ProcessDesigner\v8.5 폴더에 카피한 후 다시 진행하면 정상적으로 수행됩니다.

 
9) 참고 자료
1.    IBM BPM 8.5.7 온라인 메뉴얼(Knowledge Center) – 한글 제공
http://www.ibm.com/support/knowledgecenter/SSFPJS_8.5.7/com.ibm.wbpm.main.doc/kc-homepage-bpm.html

2.    Upgrading profiles from IBM Business Process Manager Version 8.5.7.0 to IBM Business Process Manager V8.5.7 Cumulative Fix 2016.06
http://www-01.ibm.com/support/docview.wss?uid=swg27047845