프라이빗 클라우드용 Edge v. 4.17.01
4.17.01로 업데이트할 수 있는 Edge 버전
이 절차를 사용하여 Apigee Edge 버전 4.16.09.0x를 4.17.01로 업데이트할 수 있습니다.
버전 4.16.01 이전의 Edge 버전이 있는 경우 먼저 버전 4.16.01.x로 마이그레이션한 후 버전 4.17.01로 업데이트해야 합니다.
업데이트를 수행할 수 있는 사용자
업데이트를 실행하는 사용자는 원래 Edge를 설치한 사용자와 동일하거나 루트로 실행하는 사용자여야 합니다.
Edge RPM을 설치한 후에는 모든 사용자가 이를 구성할 수 있습니다.
업데이트해야 하는 구성요소
모든 Edge 구성요소를 업데이트해야 합니다. Edge는 여러 버전의 구성요소가 포함된 설정을 지원하지 않습니다.
Qpid 1.35로 업그레이드 필요
이 출시 버전에는 Qpid 1.35에 대한 필수 업데이트가 포함되어 있습니다. Qpid 노드를 업데이트하는 과정에서 다음을 수행해야 합니다.
- Qpid 노드에서 포트 5672를 차단하여 라우터 및 메시지 프로세서가 Qpid 노드에 쓰지 못하도록 일시적으로 방지합니다. 다음 명령어를 사용하여 Qpid 노드에서 이 포트를 차단할 수 있습니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Qpid 노드가 업데이트 전에 모든 메시지를 처리했는지 확인하기 위해 Qpid 큐가 메시지를 비울 때까지 기다립니다. 다음 명령어를 사용하여 Qpid 메시지 큐가 비어 있는지 확인합니다.
> qpid-stat -q - Qpid 노드를 업데이트합니다.
- 라우터 및 메시지 프로세서에서 액세스할 수 있도록 Qpid 노드에서 포트 5672를 차단 해제합니다.
다음 명령어를 사용하여 이 포트를 차단 해제할 수 있습니다.
> sudo iptables -F
다른 규칙에 iptables를 사용하는 경우 -D 옵션을 사용하여 특정 변경사항을 되돌릴 수 있습니다.
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
이 프로세스는 각 Edge 토폴로지에 대해 아래에 자세히 설명되어 있습니다.
EPEL 저장소를 사용 설정하는 데 필요함
Edge를 설치하거나 업데이트하려면 Enterprise Linux용 추가 패키지 (또는 EPEL)를 사용 설정해야 합니다. 사용하는 명령어는 RedHat/CentOS 버전에 따라 다릅니다.
- RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm - RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
외부 인증을 사용할 때 업데이트하는 경우 필요합니다.
외부 디렉터리 서비스를 기존 Apigee Edge 프라이빗 클라우드 설치에 통합할 수 있습니다. 이 기능은 Active Directory, OpenLDAP 등 LDAP를 지원하는 모든 디렉터리 서비스에서 작동하도록 설계되었습니다. 외부 LDAP 솔루션을 사용하면 시스템 관리자가 사용자 인증 정보를 사용하는 Apigee Edge와 같은 시스템 외부에 있는 중앙 집중식 디렉터리 관리 서비스에서 사용자 인증 정보를 관리할 수 있습니다.
자세한 내용은 외부 인증 구성을 참조하세요.
외부 인증이 사용 설정되면 대부분의 고객은 Edge OpenLDAP 서버에서 사용하는 이메일 주소 대신 Active Directory SAM 계정 이름 필드를 인증을 위한 사용자 이름으로 사용합니다.
외부 디렉터리 서비스와 통합한 경우 Edge를 4.17.01로 업데이트할 때 구성 파일에 다음 줄을 추가합니다.
IS_EXTERNAL_AUTH="true"
이 줄은 이메일 주소가 아닌 계정 이름을 사용자 이름으로 지원하도록 Edge를 구성합니다.
속성 설정 자동 전파
/opt/apigee/customer/application에서 .properties 파일을 수정하여 속성을 설정한 경우 업데이트에서 이러한 값이 유지됩니다.
업데이트 사전 준비 사항
Apigee Edge를 업그레이드하기 전에 다음 기본 요건을 충족해야 합니다.
- 모든 노드 백업
업데이트하기 전에 안전을 위해 모든 노드를 완전히 백업하는 것이 좋습니다. 현재 버전의 Edge에 대한 절차를 사용하여 백업을 수행합니다.
이렇게 하면 새 버전으로의 업데이트가 제대로 작동하지 않는 경우에 대비한 백업 계획을 세울 수 있습니다. 백업에 대한 자세한 내용은 백업 및 복원을 참조하세요. - Edge가 실행 중인지 확인
다음 명령어를 사용하여 업데이트 프로세스 중에 Edge가 실행 중인지 확인합니다.
> /opt/apigee/apigee-service/bin/apigee-all status
실패한 업데이트 처리
업데이트에 실패하면 문제를 해결한 후 update.sh를 다시 실행할 수 있습니다. 업데이트를 여러 번 실행할 수 있으며 마지막으로 중단된 지점부터 업데이트가 계속됩니다.
실패로 인해 업데이트를 이전 버전으로 롤백해야 하는 경우 4.17.01 롤백 프로세스를 참조하세요.
업데이트 정보 로깅
기본적으로 update.sh 유틸리티는 로그 정보를 다음에 기록합니다.
/opt/apigee/var/log/apigee-setup/update.log
update.sh 유틸리티를 실행하는 사용자에게 해당 디렉터리에 대한 액세스 권한이 없으면 로그를 /tmp 디렉터리에 update_username.log라는 파일로 작성합니다.
사용자에게 /tmp에 대한 액세스 권한이 없으면 update.sh 유틸리티가 실패합니다.
제로 다운타임 업데이트
다운타임 없는 업데이트 또는 순차적 업데이트를 사용하면 Edge를 중단하지 않고 Edge 설치를 업데이트할 수 있습니다.
다운타임 없는 업데이트는 노드 5개 이상의 구성에서만 가능합니다.
다운타임 없는 업그레이드의 핵심은 부하 분산기에서 라우터를 한 번에 하나씩 삭제하는 것입니다. 그런 다음 라우터 및 라우터와 동일한 머신의 다른 구성요소를 업데이트한 후 라우터를 부하 분산기에 다시 추가합니다.
- 아래의 '머신 업데이트 순서'에 설명된 대로 설치에 맞는 올바른 순서로 머신을 업데이트합니다.
- 라우터를 업데이트할 때가 되면 서버 (메시지 프로세서/라우터) 연결 가능 여부 사용 설정/사용 중지에 설명된 대로 라우터를 하나 선택하여 연결할 수 없도록 합니다.
- 선택한 라우터와 라우터와 동일한 머신의 다른 모든 Edge 구성요소를 업데이트합니다. 모든 Edge 구성은 동일한 노드에 라우터와 메시지 프로세서를 표시합니다.
- 라우터를 다시 연결할 수 있도록 합니다.
- 나머지 라우터에 대해 2~4단계를 반복합니다.
- 설치에 남아 있는 머신에 대한 업데이트를 계속합니다.
업데이트 전후에 다음 사항을 확인하세요.
- 결합된 라우터 및 메시지 프로세서 노드에서 다음을 실행합니다.
- 업데이트 전 – 다음을 수행합니다.
- 라우터에 연결할 수 없도록 합니다.
- 메시지 프로세서에 연결할 수 없도록 합니다.
- 업데이트 후 다음을 수행합니다.
- 메시지 프로세서에 연결할 수 있도록 합니다.
- 라우터에 연결할 수 있도록 합니다.
- 업데이트 전 – 다음을 수행합니다.
- 단일 라우터 노드:
- 업데이트 전에 라우터에 연결할 수 없도록 합니다.
- 업데이트 후 라우터에 연결할 수 있도록 합니다.
- 단일 메시지 프로세서 노드:
- 업데이트하기 전에 메시지 프로세서에 연결할 수 없도록 합니다.
- 업데이트 후 메시지 프로세서에 연결할 수 있도록 합니다.
자동 구성 파일 사용
업데이트 명령어에 무인 구성 파일을 전달해야 합니다. 자동 구성 파일은 Edge 4.16.01 또는 4.16.05를 설치하는 데 사용한 파일과 동일해야 합니다.
외부 인터넷 연결이 있는 노드에서 4.17.01로 업데이트하는 절차
다음 절차를 사용하여 노드의 Edge 구성요소를 업데이트합니다.
- 있는 경우 업데이트가 완료될 때까지 Cassandra에서 복구 작업을 수행하도록 구성된 크론 작업을 사용 중지합니다.
- Edge RPM을 설치하려면 노드에 루트로 로그인합니다.
참고: RPM 설치에는 루트 액세스 권한이 필요하지만 루트 액세스 권한 없이 Edge 구성을 수행할 수 있습니다. - Edge apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
- Edge 4.17.01 bootstrap_4.17.01.sh 파일을 /tmp/bootstrap_4.17.01.sh에 다운로드합니다.
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - Edge 4.17.01 apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.
기본적으로 설치 프로그램은 Java 1.8이 설치되어 있는지 확인합니다. 설치되어 있지 않으면 자동으로 설치됩니다. JAVA_FIX 옵션을 사용하여 Java 설치를 처리하는 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.
I = OpenJDK 1.8 설치 (기본값)
C = Java를 설치하지 않고 계속
Q = 종료 이 옵션을 사용하려면 Java를 직접 설치해야 합니다. - (CentOS-6.x 및 RedHat-6.x만 해당) 모든 Qpid 노드에서 다음 명령어를 실행하여 올바른 Qpid 버전을 다운로드합니다.
> yum install apigee-qpidd --disablerepo=epel - apigee-service를 사용하여 apigee-setup 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - apigee-provision 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - 아래의 '머신 업데이트 순서'에 설명된 순서대로 노드에서 업데이트 유틸리티를 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
구성 파일의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다.
'-c' 옵션을 사용하여 업데이트할 구성요소를 지정합니다. 가능한 구성요소 목록은 다음과 같습니다.
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Edge UI를 제외한 모든 Edge 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
ui = Edge UI
all = 머신의 모든 구성요소 업데이트 (Edge aio 설치 프로필 또는 API BaaS asa 설치 프로필에만 사용)
e = ElasticSearch
b = API BaaS 스택
p = API BaaS 포털
ebp = 동일한 노드의 ElasticSearch, API BaaS 스택, API BaaS 포털 - 설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.
나중에 업데이트를 롤백하려면 4.16.09 롤백 프로세스에 설명된 절차를 사용하세요.
로컬 저장소에서 4.17.01로 업데이트하는 절차
Edge 노드가 방화벽 뒤에 있거나 다른 방식으로 인터넷을 통해 Apigee 저장소에 액세스할 수 없는 경우 Apigee 저장소의 로컬 저장소 또는 미러에서 업데이트를 수행할 수 있습니다.
로컬 Edge 저장소를 만든 후에는 로컬 저장소에서 Edge를 업데이트하는 두 가지 옵션이 있습니다.
- 저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 후 .tar 파일에서 Edge를 업데이트합니다.
- 다른 노드가 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹 서버를 설치합니다. Apigee는 사용할 수 있는 Nginx 웹 서버를 제공하거나 자체 웹 서버를 사용할 수 있습니다.
로컬 4.17.01 저장소에서 업데이트하려면 다음 안내를 따르세요.
- Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.17.01 저장소를 만듭니다.
참고: 기존 4.16.09 저장소가 이미 있는 경우 Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 업데이트'에 설명된 대로 4.17.01 저장소를 추가할 수 있습니다. -
.tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요.
- 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz라는 단일 .tar 파일로 패키징합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - Edge를 업데이트하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
- 새 노드에서 파일을 /tmp 디렉터리에 untar합니다.
> tar -xzf apigee-4.17.01.tar.gz
이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예를 들면 /tmp/repos입니다. - /tmp/repos에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
이 명령어에 repos 디렉터리의 경로를 포함해야 합니다.
- 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz라는 단일 .tar 파일로 패키징합니다.
-
Nginx 웹 서버를 사용하여 apigee-service를 설치하려면 다음 안내를 따르세요.
- Edge apigee-setup 유틸리티 설치의 'Nginx 웹 서버를 사용하여 저장소에서 설치'에 설명된 대로 Nginx 웹 서버를 구성합니다.
- 원격 노드에서 Edge bootstrap_4.17.01.sh 파일을 /tmp/bootstrap_4.17.01.sh에 다운로드합니다.
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
여기서 uName:pWord는 위에서 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다. - 원격 노드에서 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.
- thought
apigee-service를 사용하여 apigee-setup 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - apigee-provision 유틸리티를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - 아래의 '머신 업데이트 순서'에 설명된 순서대로 노드에서 업데이트 유틸리티를 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
구성 파일의 유일한 요구사항은 'apigee' 사용자가 구성 파일에 액세스하거나 읽을 수 있어야 한다는 것입니다.
'-c' 옵션을 사용하여 업데이트할 구성요소를 지정합니다. 가능한 구성요소 목록은 다음과 같습니다.
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =Edge UI를 제외한 모든 Edge 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
ui = Edge UI
all = 머신의 모든 구성요소 업데이트 (Edge aio 설치 프로필 또는 API BaaS asa 설치 프로필에만 사용)
e = ElasticSearch
b = API BaaS 스택
p = API BaaS 포털
ebp = 동일한 노드의 ElasticSearch, API BaaS 스택, API BaaS 포털 - 설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.
나중에 업데이트를 롤백하려면 4.16.09 롤백 프로세스에 설명된 절차를 사용합니다.
머신 업데이트 순서
Edge 설치에서 머신을 업데이트하는 순서가 중요합니다. 업데이트에서 가장 중요한 고려사항은 다음과 같습니다.
- 다른 노드를 업데이트하기 전에 모든 Cassandra 및 ZooKeeper 노드를 업데이트해야 합니다.
- 여러 Edge 구성요소 (관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버 제외)가 있는 머신의 경우 '-c edge' 옵션을 사용하여 모두 동시에 업데이트합니다.
- 여러 머신에서 수행해야 하는 단계가 있는 경우 지정된 머신 순서대로 수행합니다.
- 수익 창출을 업데이트하는 별도의 단계는 없습니다. '-c edge' 옵션을 지정하면 업데이트됩니다.
- (CentOS-6.x 및 RedHat-6.x만 해당) 외부 인터넷 연결이 있는 모든 Qpid 노드에서 다음 명령어를 실행하여 위에 표시된 대로 올바른 Qpid 버전을 다운로드했는지 확인합니다.
> yum install apigee-qpidd --disablerepo=epel
1호스트 독립형 설치
- Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - iptables를 플러시합니다.
> sudo iptables -F - postgresql을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - postgresql을 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 나머지 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Edge UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
2호스트 독립형 설치
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 머신 2에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - 머신 2에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - 머신 2에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 머신 2에서 iptables를 플러시합니다.
> sudo iptables -F - 머신 2에서 postgresql을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 머신 2에서 postgresql을 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 머신 1에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 머신 2 및 1에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 머신 1에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
5개 호스트 클러스터 설치
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 머신 4에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - 머신 4에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 개수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - 머신 4에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 머신 4에서 iptables를 플러시합니다.
> sudo iptables -F - 머신 5에서 2~5단계를 반복합니다.
- 머신 4에서 postgresql을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 머신 4에서 postgresql을 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 머신 5에서 7단계와 8단계를 반복합니다.
- 머신 1에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 머신 4, 5, 1, 2, 3에서 Edge 구성요소를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 머신 1에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
9개 호스트 클러스터 설치
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 머신 6에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - 머신 6에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - 머신 6에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 머신 6에서 iptables를 플러시합니다.
> sudo iptables -F - 머신 7에서 2~5단계를 반복합니다.
- 머신 6에서 postgresql을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 머신 6에서 postgresql을 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 머신 7에서 7단계와 8단계를 반복합니다.
- 머신 1에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 머신 6, 7, 8, 9, 1, 4, 5에서 Edge 구성요소를 순서대로 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 머신 1에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13개 호스트 클러스터 설치
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 머신 12에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - 머신 12에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 개수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - 머신 12에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 머신 12에서 iptables를 플러시합니다.
> sudo iptables -F - 머신 13에서 2~5단계를 반복합니다.
- 머신 12에서 postgresql을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 머신 12에서 postgresql을 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 머신 13에서 7단계와 8단계를 반복합니다.
- 머신 4 및 5에서 LDAP를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 머신 12, 13, 8, 9, 6, 7, 10, 11에서 Edge 구성요소를 순서대로 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 머신 6 및 7에서 UI를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
12개 호스트 클러스터 설치
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- Cassandra 및 ZooKeeper를 업데이트합니다.
- 데이터 센터 1의 머신 1, 2, 3에서 다음을 실행합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 데이터 센터 2의 머신 7, 8, 9에서
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 데이터 센터 1의 머신 1, 2, 3에서 다음을 실행합니다.
- qpidd를 업데이트합니다.
- 데이터 센터 1의 머신 4, 5
- 머신 4에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - 머신 4에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - 머신 4에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 머신 4에서 iptables를 플러시합니다.
> sudo iptables -F - 머신 5에서 1~4단계를 반복합니다.
- 머신 4에서 다음 iptables 규칙을 설정합니다.
- 데이터 센터 2의 머신 10, 11
- 머신 10에서 다음 iptables 규칙을 설정합니다.
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - 머신 10에서 Qpid 메시지 큐를 확인합니다.
> qpid-stat -q
'msg' 열의 수가 0이 될 때까지 큐를 계속 확인합니다. 모든 메시지를 처리할 때까지 Qpid를 업그레이드할 수 없습니다. - 머신 10에서 qpidd를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - 머신 10에서 iptables를 플러시합니다.
> sudo iptables -F - 머신 11에서 1~4단계를 반복합니다.
- 머신 10에서 다음 iptables 규칙을 설정합니다.
- 데이터 센터 1의 머신 4, 5
-
postgresql을 업데이트합니다.
-
데이터 센터 1의 머신 6
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start -
데이터 센터 2의 머신 12
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
-
- LDAP를 업데이트합니다.
- 데이터 센터 1의 머신 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - 데이터 센터 2의 머신 7
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 데이터 센터 1의 머신 1
- Edge 구성요소를 업데이트합니다.
- 데이터 센터 1의 머신 4, 5, 6, 1, 2, 3
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - 데이터 센터 2의 머신 10, 11, 12, 7, 8, 9
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 데이터 센터 1의 머신 4, 5, 6, 1, 2, 3
- UI 업데이트:
- 데이터 센터 1의 머신 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - 데이터 센터 2의 머신 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 데이터 센터 1의 머신 1:
7개 호스트 API BaaS 설치
업그레이드 절차를 실행하기 전에 구성 파일에 새 속성 두 개를 추가해야 합니다.
# For a single data center, specify the same value as BAAS_CASS_LOCALDC. BAAS_CASS_DC_LIST="dc-1" # Defines the initial contact points for members of the BaaS cluster. # Specify the IP address of no more than two Stack nodes. BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"
전체 구성 파일 예시는 API BaaS 설치를 참조하세요.
또한 다른 모든 Stack 노드에서 액세스할 수 있도록 모든 Stack 노드에서 포트 2551이 열려 있어야 합니다.
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 5, 6, 7에서 Cassandra를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile -
머신 1, 2, 3에서 ElasticSearch 및 API BaaS 스택을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - 머신 4에서 API BaaS 포털을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
호스트 10개 API BaaS 설치
업그레이드 절차를 실행하기 전에 구성 파일에 두 개의 새 속성을 추가해야 합니다.
# For a single data center, specify the same value as BAAS_CASS_LOCALDC. BAAS_CASS_DC_LIST="dc-1" # Defines the initial contact points for members of the BaaS cluster. # Specify the IP address of no more than two Stack nodes. BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"
전체 구성 파일 예시는 API BaaS 설치를 참조하세요.
또한 다른 모든 Stack 노드에서 액세스할 수 있도록 모든 Stack 노드에서 포트 2551이 열려 있어야 합니다.
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 8, 9, 10에서 Cassandra를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - 머신 1, 2, 3에서 ElasticSearch를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - 머신 4, 5, 6에서 API BaaS 스택을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - 머신 7에서 API BaaS 포털을 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
비표준 설치의 경우
비표준 설치가 있는 경우 다음 순서로 Edge 구성요소를 업데이트합니다.
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge: 모든 노드의 '-c edge' 프로필을 Qpid 서버, Postgres 서버, 관리 서버, 메시지 프로세서, 라우터가 있는 노드 순서로 지정합니다.
참고: 노드에 Qpid 서버와 Postgres 서버가 모두 설치되어 있으면 '-c edge' 프로필 단계를 실행합니다. - Edge UI