[APIC]본격적으로 살펴보는 IBM API Connect 06 - Fixpack 업데이트

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

IBM API Connect 의 경우에는 크게 세가지 모듈(API Manager, API Gateway(DataPower), API Portal) 로 구성되어 있으며 당연히 이들 각각도 소프트웨어 이기 때문에 버그가 있을 수 있고 IBM 은 WW 벤더로서 다양한 사례를 통해서 문제를 해결하고 해당 경험을 통해서 주기적으로 Fixpack 을 출시합니다.

IBM API Connect 의 경우에는 여기서 한 단계 더 진화하여 지속적 전달(continuous delivery) 모델을 가지고 있기 때문에 거의 매달 새로운 Fixpack 이 출시되며 해당 fixpack 에는 문제 수정사항만을 포함하고 있는 것이 아니라 고객의 요구사항을 바로 반영하여 새로운 기능 추가도 포함되어 있기 때문에 이전 IBM 솔루션과는 다르게 계속 혁신하는 형태를 가지고 있습니다.

What’s New - IBM API Connect 5.0 온라인 메뉴얼
https://www.ibm.com/support/knowledgecenter/en/SSMNED_5.0.0/com.ibm.apic.overview.doc/overview_whatsnew.html

이번 강좌에서는 IBM API Connect 를 각 모듈별로 어떻게 fixpack 을 업데이트 하는지 하나 하나 살펴보도록 하겠습니다.

그럼 백문이 불여일타! Fixpack 업데이트에 대한 강좌를 진행하도록 하겠습니다.
 
1) Fixpack 다운로드 하기

IBM API Connect 를 위한 Fixpack 을 업그레이드 하기 위해서는 당연히 fixpack 을 다운로드 받아야 합니다. IBM 은 이를 손쉽게 수행하기 위해서 모든 IBM 솔루션은 공통적으로 하단의 첨부한 링크인 Fix Central 을 통해서 ifix 나 Fixpack 을 다운로드 받을 수 있도록 합니다.  

IBM Fix Central
https://www-945.ibm.com/support/fixcentral/

여 기서 중요한 점은 IBM API Connect 영역에서 API Manager 와 API Portal 에 대한 Fixpack 을 다운로드 받을 수 있으며 기 언급한 것처럼 API Gateway 는 실제로 DataPower 이기 때문에 DataPower 항목에서 다운로드 가능합니다.

2016년 9월 기준으로 결국 업데이트를 위한 3개의 최신 fixpack 파일이 정상적으로 다운로드 되었는지 확인해보면 하단과 같아야 합니다. - API Gateway(DataPower) fixpack - v7.5.1.2, API Connect Manager fixpack - v5.0.4, API Connect Portal fixpack - v5.0.4

2) API Gateway Fixpack 업데이트 하기

그럼 먼저 API Gateway 부터 Fixpack 을 업데이트 하도록 하겠습니다.

Installation operations
https://www.ibm.com/support/knowledgecenter/SS9H2Y_7.5.0/com.ibm.dp.doc/installationoperations.html

Fixpack 을 설치하기 전에 하단과 같이 ssl 로 접속하여 filesystem 을 확인합니다. (Internal 이나 Temporary 가 부족하면 업데이트 중에 이슈가 발생될 수 있기 때문에 reboot 작업이 필요합니다.)

Filesystem 에 이슈가 없으면 웹 콘솔에 접속하여 File Management 를 통해서 image: 폴더에 firmware 파일을 업로드 합니다.

업로드가 정상적으로 끝나면 ssl 로 다시 접속하여 하단의 명령을 이용해서 정상적으로 firmware 파일이 업로드 되었는지 확인합니다.

이제 준비가 다 되었다면 firmware update 명령을 수행하여 fixpack 을 업데이트 합니다.

boot image accept-license idg7512.scrypt4

업데이트가 진행되다가 완료되면 자동으로 rebooting 되므로 그냥 기다리시면 됩니다.

정상적으로 업데이트가 완료되고 reboot 되면 하단과 같이 CLI 에서 업데이트 된 버전을 확인 가능합니다.

3) API Manager Fixpack 업데이트 하기

API Gateway Fixpack 업데이트 수행이 완료되었으면 이제 API Manager Fixpack 업데이트를 해보도록  하겠습니다.

Upgrading your IBM API Connect solution
https://www.ibm.com/support/knowledgecenter/en/SSMNED_5.0.0/com.ibm.apic.install.doc/apply_main_mgmt.html

SSL 을 이용해서 기존 API Manager 로 접속을 수행합니다.

다양한 방법이 존재하지만 여기서는 외부에 다운로드 받은 fixpack 파일을 이용해서 바로 API Manager fixpack 업데이트를 수행합니다. (sftp 를 활용하는 방안) - 업데이트 하는데 1시간 이상 소요
system update firmware from sftp 192.168.225.10 port 22 user student file /mnt/hgfs/VMShared/APIConnect_Management_5.0.4.0_20160920-0552.vcrypt2

업데이트가 정상적으로 완료되면 하단과 같이 변경된 버전을 확인할 수 있습니다.

API Manager 에 대한 업데이트가 완료되면 해당 업데이트를 API Gateway 에도 적용해주어야 합니다. 해당 작업을 리프레쉬 작업이라고 하며 CMC 콘솔에서 기존 등록된 API Gateway 를 삭제한후 다시 추가해주면 됩니다.

참고 #1 : API Gateway refresh 작업중에는 DataPower 의 Memory 가 8GB 이상 할당되어 있어야 합니다. (refresh 이후에 Memory 조정 가능)

참 고 #2 : 혹여나, API Gateway refresh 작업중에 하단과 같은 Error 가 나온다면 API Gateway(DataPower) 에 직접 접속해서 해당 APIMgmt 도메인을 삭제한 후에 해당 작업을 진행하시면 됩니다.

4) API Portal Fixpack 업데이트 하기

마지막으로 API Portal Fixpack 업데이트를 해보도록 하겠습니다.

Applying an IBM fix pack and upgrading all sites to use the new distribution
https://www.ibm.com/support/knowledgecenter/en/SSMNED_5.0.0/com.ibm.apic.install.doc/tapim_portal_production_upgrade.html

SSL 을 이용해서 기존 API Connect Portal 로 접속한 후에 다른 서버에서 scp 를 사용하여 업데이트할 fixpack 파일을 API Connect Portal 로 올려놉니다.
scp ./5.0.0.1-APIConnect-Portal-20160505-1214.bin admin@192.168.225.20:

API Portal 에서 fixpack 파일이 제대로 업데이트 되었는지 확인합니다.

해당 파일을 이용해서 API Portal 에 대한 업그레이드 작업을 수행합니다.

bash 5.0.4.0-APIConnect-Portal-20160920-0134.bin -a -i

업그레이드가 정상적으로 완료되면 하단과 같이 status 명령을 이용해 새로운 버전이 적용된 것을 확인 가능합니다.

여기까지 잘 따라왔다면 IBM API Connect 에 대한 Fixpack 업데이트를 잘 완료하신 것 입니다.

참고 #1 : 위의 가이드는 API Portal 을 단일 노드로 썻을 경우에 가이드 이며 Cluster 를 구성하였다면 N 대의 서버에 1) 을 수행한 후에 마지막 노드에서 2) 를 수행하면 됩니다.
1) bash version-APIConnect-Portal-yyyymmdd_hhmm.bin –a
2) bash version-APIConnect-Portal-yyyymmdd_hhmm.bin -a -i

참고 #2 : 업그레이드 시에 하단과 같은 메세지가 나오면 fixpack 업그레이드를 위한 여유 공간이 부족한 거니 불필요한 파일을 지우거나 하단의 링크 참고해서 디스크 할당을 더 해주고 다시 시도하면 됩니다.

Increasing your virtual disk size
https://www.ibm.com/support/knowledgecenter/en/SSMNED_5.0.0/com.ibm.apic.install.doc/tapim_portal_install_hardware.html

참고 #3 : 선택적으로 API Create 를 위해서 Developer Toolkit 을 설치하셨다면 하단과 같이 업데이트를 수행하시면 됩니다.

Installing the toolkit
https://www.ibm.com/support/knowledgecenter/en/SSMNED_5.0.0/com.ibm.apic.toolkit.doc/tapim_cli_install.html

apic stop --all

sudo npm rm apiconnect –g –cache-clear

sudo npm install -g --unsafe-perm install apiconnect

apic --version

9) 참고 자료

1.    IBM API Connect 5.0 온라인 메뉴얼(Knowledge Center) – 한글 제공
https://www.ibm.com/support/knowledgecenter/ko/SSMNED_5.0.0/mapfiles/ic_home.html

2.    Upgrading your IBM API Connect solution - IBM API Connect 5.0 온라인 메뉴얼
https://www.ibm.com/support/knowledgecenter/en/SSMNED_5.0.0/com.ibm.apic.install.doc/apply_main_mgmt.html

APIC5_guide_06_fixpack_juwlee201609_v1.pdf