Apigee는 프라이빗 클라우드용 Edge를 버전 4.51.00 또는 버전 4.52.00에서 버전 4.52.01로 직접 업그레이드하는 것을 지원합니다. 이 페이지에서는 업그레이드를 수행하는 방법을 설명합니다.
업데이트를 수행할 수 있는 사용자
업데이트를 실행하는 사용자는 원래 Edge를 설치한 사용자와 동일하거나 루트로 실행하는 사용자여야 합니다.
Edge RPM을 설치한 후에는 누구나 구성할 수 있습니다.
업데이트해야 하는 구성요소
모든 Edge 구성요소를 업데이트해야 합니다. Edge는 여러 버전의 구성요소가 포함된 설정을 지원하지 않습니다.
업데이트 기본 요건
Apigee Edge를 업그레이드하기 전에 다음 기본 요건을 확인하세요.
- 모든 노드 백업
업데이트하기 전에 안전을 위해 모든 노드를 완전히 백업하는 것이 좋습니다. 현재 버전의 Edge에 대한 절차를 사용하여 백업을 수행합니다.이렇게 하면 새 버전으로의 업데이트가 제대로 작동하지 않는 경우에 대비한 백업 계획을 세울 수 있습니다. 백업에 관한 자세한 내용은 백업 및 복원을 참고하세요.
- Edge가 실행 중인지 확인
다음 명령어를 사용하여 업데이트 프로세스 중에 Edge가 실행 중인지 확인합니다./opt/apigee/apigee-service/bin/apigee-all status
- Cassandra 압축 전략이
LeveledCompactionStrategy인지 확인
Cassandra 압축 전략 변경에 설명된 대로 Cassandra 압축 전략이LeveledCompactionStrategy로 설정되어 있는지 확인합니다.
속성 설정 자동 전파
/opt/apigee/customer/application에서 .properties 파일을 수정하여 속성을 설정한 경우 업데이트에서 이러한 값이 유지됩니다.
Zookeeper 3.8.3으로 업그레이드 필요
이 프라이빗 클라우드용 Edge 출시 버전에는 Zookeeper 3.8.3으로의 업그레이드가 포함되어 있습니다. 이 업그레이드의 일환으로 모든 Zookeeper 데이터가 Zookeeper 3.8.3으로 마이그레이션됩니다.
Zookeeper를 업그레이드하기 전에 Zookeeper 유지보수 가이드를 읽어보세요. 대부분의 Edge 프로덕션 시스템은 여러 데이터 센터에 분산된 Zookeeper 노드 클러스터를 사용합니다. 이러한 노드 중 일부는 Zookeeper 리더 선택에 참여하는 투표자로 구성되고 나머지는 관찰자로 구성됩니다. 자세한 내용은 리더, 팔로어, 투표자, 관찰자 정보를 참조하세요. 투표자 노드는 리더를 선출한 후 투표자 노드 자체가 팔로어가 됩니다.
업데이트 프로세스 중에 리더 노드가 종료되면 Zookeeper에 일시적인 지연 또는 쓰기 실패가 발생할 수 있습니다. 이는 프록시 배포 작업과 같은 Zookeeper에 쓰는 관리 작업과 메시지 프로세서 추가 또는 삭제와 같은 Apigee 인프라 변경사항에 영향을 줄 수 있습니다. 아래 절차를 따르는 동안 Zookeeper를 업그레이드하는 동안 Apigee의 런타임 API(이러한 런타임 API가 관리 API를 호출하지 않는 한)에 영향을 주지 않습니다.
업그레이드 프로세스에는 각 노드의 백업을 수행하는 과정이 포함됩니다. 그런 다음 모든 옵저버와 팔로어를 업그레이드하고 마지막으로 리더 노드를 업그레이드합니다.
백업 수행
롤백이 필요한 경우에 사용할 수 있도록 ZooKeeper의 모든 노드를 백업합니다. 롤백하면 ZooKeeper가 백업이 수행된 시점의 상태로 복원됩니다. 참고: 백업이 수행된 이후 Apigee의 배포 또는 인프라 변경사항(정보가 Zookeeper에 저장됨)은 복원 중에 손실됩니다.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup
가상 머신을 사용하고 있고 기능이 있는 경우 복원 또는 롤백을 위해 VM 스냅샷 또는 백업을 수행할 수도 있습니다(필요한 경우).
리더, 팔로어, 옵저버 식별
참고: 아래 샘플 명령어는 nc 유틸리티를 사용하여 Zookeeper에 데이터를 전송합니다. 대체 유틸리티를 사용하여 Zookeeper에 데이터를 전송할 수도 있습니다.
- ZooKeeper 노드에 설치되지 않은 경우 nc를 설치합니다.
sudo yum install nc
- 노드에서 다음 nc 명령어를 실행합니다. 여기서 2181은 ZooKeeper 포트입니다.
echo stat | nc localhost 2181
다음과 같은 출력이 표시되어야 합니다.
Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC Clients: /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0.2518/41 Received: 647228 Sent: 647339 Connections: 4 Outstanding: 0 Zxid: 0x400018b15 Mode: follower Node count: 100597
노드 출력의
Mode줄에 노드 구성에 따라 옵저버, 리더 또는 팔로어(리더가 아닌 투표자)가 표시됩니다. 참고: 단일 ZooKeeper 노드가 있는 Edge의 독립형 설치에서Mode는 독립형으로 설정됩니다. - 각 ZooKeeper 노드에서 1단계와 2단계를 반복합니다.
관찰자 및 팔로어 노드에서 Zookeeper 업그레이드
다음과 같이 각 옵저버 및 팔로워 노드에서 ZooKeeper를 업그레이드합니다.
- 외부 인터넷 연결이 있는 노드에서 4.52.01로 업데이트에 설명된 대로 프라이빗 클라우드용 Edge 4.52의 부트스트랩을 다운로드하고 실행합니다. 이 프로세스는 노드에 외부 인터넷 연결이 있는지 또는 오프라인 설치를 수행하는지에 따라 달라질 수 있습니다.
- Zookeeper 구성요소를 업그레이드합니다.
참고: 이러한 노드에 다른 구성요소(예: Cassandra)가 설치된 경우 지금 업그레이드하거나(cs,zk 프로필과 같이) 나중에 다른 구성요소를 업그레이드할 수 있습니다. Apigee에서는 다른 구성요소를 업그레이드하기 전에 먼저 Zookeeper만 업그레이드하고 클러스터가 제대로 작동하는지 확인하는 것이 좋습니다./opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
- 각 Zookeeper 옵저버 및 팔로어 노드에서 위 단계를 반복합니다.
리더 종료
모든 옵저버 및 팔로어 노드가 업그레이드되면 리더를 종료합니다. 리더로 식별된 노드에서 아래 명령어를 실행합니다.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
이 이벤트 중에 새 리더가 선출되기 전에 ZooKeeper에서 일시적인 지연 또는 쓰기 실패가 발생할 수 있습니다. 이는 프록시 배포 작업 또는 Apigee 인프라 변경사항(예: 메시지 프로세서 추가 또는 삭제 등)과 같이 Zookeeper에 쓰는 작업에 영향을 줄 수 있습니다.
새 리더가 선출되었는지 확인
위의 리더, 팔로어, 옵저버 식별 섹션의 단계를 사용하여 기존 리더가 중지되면 팔로어 중에서 새 리더가 선출되었는지 확인합니다. 리더는 현재 리더와 다른 데이터 센터에서 선출되었을 수 있습니다.
리더 업그레이드
위의 옵저버 및 팔로어 노드에서 Zookeeper 업그레이드와 동일한 단계를 따릅니다.
이전 리더 노드도 업그레이드되면 클러스터 상태를 확인하고 리더 노드가 있는지 확인합니다.
롤백
롤백이 필요한 경우:
- 먼저 관찰자 및 팔로어에서 롤백 단계를 수행합니다.
- 롤백할 버전(4.50 또는 4.51)의 부트스트랩을 다운로드하고 실행합니다. 이 프로세스는 노드에 외부 인터넷 연결이 있는지 또는 오프라인 설치를 따르는지에 따라 달라질 수 있습니다.
- 노드에서 실행 중인 경우 ZooKeeper를 중지합니다.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- 기존 zookeeper를 제거합니다.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
- 평소와 같이 Zookeeper를 설치합니다.
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
- 모든 팔로어와 옵저버가 롤백되면 리더 노드에서 2~5단계를 수행하여 리더 노드를 롤백합니다.
- 모든 노드가 롤백된 후 클러스터 상태를 확인하고 클러스터에 리더 노드가 있는지 확인합니다.
백업 복원
백업에서 복원을 참고하세요. 4.50 및 4.51과 같은 이전 버전의 프라이빗 클라우드용 Edge에서 가져온 Zookeeper 백업은 프라이빗 클라우드용 Edge 4.52의 Zookeeper 버전과 호환되어야 합니다.
Postgres 14로 업그레이드 필요
이 프라이빗 클라우드용 Edge 출시 버전에는 Postgres 14로의 업그레이드가 포함되어 있습니다. 이 업그레이드의 일환으로 모든 Postgres 데이터가 Postgres 14로 마이그레이션됩니다.
- 프라이빗 클라우드용 Edge 4.51.00에서 4.52.01로 업그레이드하는 경우 추가 Postgres 업그레이드 단계를 따라야 합니다. 버전 4.51.00에서 4.52.01로 업그레이드하는 경우 Postgres 14로 필수 업그레이드 섹션을 참고하세요.
- Private Cloud용 Edge 4.52.00에서 4.52.01로 업그레이드하는 경우 추가 Postgres 업그레이드 단계가 필요하지 않습니다.
Qpid 업그레이드
이 프라이빗 클라우드용 Edge 출시 버전에는 Qpid J-Broker 업그레이드가 포함되어 있습니다.
다음 방법 중 하나를 선택하여 Qpid 업그레이드를 수행하는 것이 좋습니다.
다운타임 없는 인플레이스 업그레이드
이 방법을 사용하면 Edge 런타임 환경에 다운타임이 발생하지 않으며 분석을 위해 획득한 런타임 데이터의 손실을 최소화할 수 있습니다.
Qpid로 인플레이스, 다운타임 없는 업그레이드를 수행하려면 다음 안내를 따르세요.
- 시작할 Qpid 노드 하나를 선택합니다.
- 노드에서 Qpid 브로커를 중지합니다.
apigee-service apigee-qpidd stop
- 방화벽을 적용하여 모든 메시지 프로세서에서 브로커 포트 5672로 들어오는 트래픽을 차단합니다. 이 방화벽은 Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성요소 수준에서 적용할 수 있습니다.
모든 메시지 프로세서 IP 주소에 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 IPTables를 사용하여 포트 5672의 Qpid 노드로 메시지 프로세서 IP 주소에서 들어오는 요청을 삭제하려면 다음과 같은 명령어를 사용하면 됩니다.
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Qpid 브로커를 다시 시작하여 기존 메시지(있는 경우)를 드레이닝합니다.
apigee-service apigee-qpidd start
- 기존 큐가 비어 있는지 확인합니다.
qpid-stat -q
메시지가 데드 레터 큐(DLQ)(ax-q-axgroup-001-consumer-group-001-dl)에 걸려 있는 경우 데드 레터 큐에 걸려 있는 분석 데이터를 해결하는 단계를 사용하여 큐를 드레이닝합니다.
- 이전 노드에서 큐가 비워졌는지 확인한 후
apigee-qpidd를 중지합니다.apigee-service apigee-qpidd stop
- 노드에서 Qpid를 업그레이드합니다.
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
edge-qpid-server를 다시 시작합니다.apigee-service edge-qpid-server restart
3단계에서 적용한 방화벽 규칙을 삭제합니다.
방화벽이 적용된 모든 메시지 프로세서 IP 주소에 대해 동일한 삭제 단계를 수행합니다. 방화벽이 삭제되면 메시지 프로세서 IP 주소에서 포트 5672의 Qpid 노드로 들어오는 요청이 수락됩니다.
iptables를 사용하여 방화벽을 추가한 경우 방화벽을 삭제하고 기존 설정을 나열하려면 다음과 같은 명령어를 사용하면 됩니다.iptables -F iptables -L
- 웹 모니터링을 사용하여 Qpid 큐가 메시지를 수신하는지 확인합니다.
http://QPID_NODE_IP:8090
- 각 Qpid 노드에 대해 1~9단계를 반복합니다.
새 Qpid 노드 커미셔닝
이 메서드는 새 노드에서 apigee-qpidd 및 edge-qpid-server를 설정하고 설치합니다.
- 새 Qpid 노드를 추가합니다. 이 단계에서는 J-broker를 사용하여 Qpid 노드를 설정합니다. 자세한 단계는 Qpid 서버 추가를 참조하세요.
- 기존 Qpid 노드(업그레이드하려는 버전의 노드)를 선택합니다.
- 노드에서 Qpid 브로커를 중지합니다.
apigee-service apigee-qpidd stop
- 방화벽을 적용하여 모든 메시지 프로세서에서 브로커 포트 5672로 들어오는 트래픽을 차단합니다. Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성요소 수준에서 이 방화벽을 적용할 수 있습니다.
모든 메시지 프로세서 IP 주소에 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 IPTables를 사용하여 포트 5672의 Qpid 노드로 메시지 프로세서 IP 주소에서 들어오는 요청을 삭제하려면 다음과 같은 명령어를 사용하면 됩니다.
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- Qpid 브로커를 다시 시작하여 기존 메시지(있는 경우)를 드레이닝합니다.
apigee-service apigee-qpidd start
- 기존 큐가 비어 있는지 확인합니다.
qpid-stat -q
메시지가 데드 레터 큐(DLQ)(ax-q-axgroup-001-consumer-group-001-dl)에 걸려 있는 경우 문제 해결 주제 Qpidd 데드 레터 큐에 걸린 분석 데이터의 단계에 따라 큐를 드레이닝합니다.
- 이전 노드에서 큐가 비워졌는지 확인한 후
apigee-qpidd를 중지합니다.apigee-service apigee-qpidd stop
- Qpid 서버 삭제의 단계에 따라 이전 Qpid 노드를 등록 취소합니다.
- 모든 Qpid 노드가 업그레이드될 때까지 새 노드를 추가하고 이전 노드를 한 번에 하나씩 삭제합니다.
롤백
이전 기능 출시로 롤백하려면 롤백하려는 버전의 bootstrap.sh 파일을 다운로드해야 합니다. v4.52.00으로 롤백하려면 bootstrap_4.52.00.sh를 다운로드하세요.
Qpid를 롤백하려면 모든 Qpid 호스트에서 다음 단계를 따르세요.
- 기존 Qpid 브로커 중지
apigee-service apigee-qpidd stop
- 방화벽을 적용하여 모든 메시지 프로세서에서 브로커 포트 5672로 들어오는 트래픽을 차단합니다. 이 방화벽은 Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성요소 수준에서 적용할 수 있습니다.
모든 메시지 프로세서 IP 주소에 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 IPTables를 사용하여 포트 5672의 Qpid 노드로 메시지 프로세서 IP 주소에서 들어오는 요청을 삭제하려면 다음과 같은 명령어를 사용하면 됩니다.
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
- qpid 브로커를 다시 시작하여 기존 메시지(있는 경우)를 드레이닝합니다.
apigee-service apigee-qpidd start
- 기존 큐가 비어 있는지 확인합니다. 확인하려면 Qpid 관리 포털에 로그인합니다.
참고: QPID 노드의 이 포트 8090에 액세스할 수 없는 경우 SSH 포트 전달과 같은 대체 메커니즘을 사용하여 이 URL에 액세스할 수 있습니다.http://QPID_NODE_IP:8090
- 큐가 비워졌는지 확인한 후 Qpid를 중지하고 제거합니다.
apigee-service apigee-apidd uninstall
- Qpid 데이터 디렉터리를 삭제합니다.
rm -r APIGEE_ROOT/data/apigee-qpidd
- Qpid 브로커를 다시 설치합니다.
/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
- Qpid 브로커가 다시 설치되면 다음 명령어를 사용하여 방화벽 설정을 삭제하고 기존 설정을 나열합니다.
iptables -F
iptables -L
새로운 Edge UI
이 섹션에는 Edge UI와 관련된 고려사항이 나와 있습니다. 자세한 내용은 Private Cloud용 새 Edge UI를 참조하세요.
Edge UI 설치
초기 설치를 완료한 후에는 프라이빗 클라우드용 Apigee Edge의 개발자 및 관리자를 위한 향상된 사용자 인터페이스인 Edge UI를 설치하는 것이 좋습니다.
Edge UI를 사용하려면 기본 인증을 사용 중지하고 SAML 또는 LDAP와 같은 IDP를 사용해야 합니다.
자세한 내용은 새 Edge UI 설치를 참조하세요.
Edge UI 업데이트
Edge UI 구성요소를 업데이트하려면 업그레이드하려는 프라이빗 클라우드용 Edge 버전을 고려하세요.
- 4.51.00에서 4.52.00으로(새 Edge UI가 이미 설치된 경우):
edge-management-ui구성요소에 이 섹션의 업그레이드 안내를 사용합니다.
Apigee mTLS로 업데이트
Apigee mTLS를 업데이트하려면 다음 단계를 수행합니다.
업데이트 롤백
업데이트에 실패하면 문제를 해결한 후 update.sh를 다시 실행할 수 있습니다. 업데이트를 여러 번 실행할 수 있으며 마지막으로 중단된 지점부터 업데이트가 계속됩니다.
업데이트를 이전 버전으로 롤백해야 하는 오류가 발생하면 4.52.00 롤백에서 자세한 안내를 참조하세요.
업데이트 정보 로깅
기본적으로 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단계를 반복합니다.
- 설치에 남아 있는 머신에 대한 업데이트를 계속합니다.
업데이트 전후에 다음 사항을 확인하세요.
- 결합된 라우터 및 메시지 프로세서 노드:
- 업데이트 전 – 다음을 수행합니다.
- 라우터에 연결할 수 없도록 합니다.
- 메시지 프로세서에 연결할 수 없도록 합니다.
- 업데이트 후 다음을 수행합니다.
- 메시지 프로세서에 연결할 수 있도록 합니다.
- 라우터에 연결할 수 있도록 합니다.
- 업데이트 전 – 다음을 수행합니다.
- 단일 라우터 노드:
- 업데이트하기 전에 라우터에 연결할 수 없도록 설정합니다.
- 업데이트 후 라우터에 연결할 수 있도록 합니다.
- 단일 메시지 프로세서 노드:
- 업데이트하기 전에 메시지 프로세서에 연결할 수 없도록 합니다.
- 업데이트 후 메시지 프로세서에 연결할 수 있도록 합니다.
무인 설치 구성 파일 사용
무인 설치 구성 파일을 update 명령어에 전달해야 합니다. 무인 설치 구성 파일은 Edge 4.50.00 또는 4.51.00을 설치하는 데 사용한 파일과 동일해야 합니다.
외부 인터넷 연결이 있는 노드에서 4.52.01로 업데이트
다음 절차를 사용하여 노드의 Edge 구성요소를 업데이트합니다.
- 있는 경우 업데이트가 완료될 때까지 Cassandra에서 복구 작업을 수행하도록 구성된
cron작업을 사용 중지합니다. - Edge RPM을 설치하려면 노드에 루트로 로그인합니다.
yum-utils및yum-plugin-priorities를 설치합니다.sudo yum install yum-utils
sudo yum install yum-plugin-priorities- Edge apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
- Oracle 7.x에 설치하는 경우 다음 명령어를 실행합니다.
sudo yum-config-manager --enable ol7_optional_latest
- AWS에 설치하는 경우 다음
yum-configure-manager명령어를 실행합니다.yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional 현재 Edge 4.51.00을 사용 중인 경우:
- Edge
bootstrap_4.52.01.sh파일을/tmp/bootstrap_4.52.01.sh에 다운로드합니다.curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
- 다음 명령어를 실행하여 Edge 4.52.01
apigee-service유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/bootstrap_4.52.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를 직접 설치해야 합니다.
- 다음 예시와 같이
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
- 다음 명령어를 실행하여 노드에서
update유틸리티를 실행합니다./opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
머신 업데이트 순서에 설명된 순서대로 이 작업을 수행합니다.
각 항목의 의미는 다음과 같습니다.
- component은 업데이트할 Edge 구성요소입니다. 가능한 값은 다음과 같습니다.
cs: Cassandraedge: Edge UI를 제외한 모든 Edge 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버ldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO(SSO를 설치한 경우)ue: 새 Edge UIui: 기본 Edge UIzk: Zookeeper
- configFile는 4.50.00 또는 4.51.00 설치 중에 Edge 구성요소를 정의하는 데 사용한 것과 동일한 구성 파일입니다.
component를 'all'로 설정하여 모든 구성요소에 대해
update.sh를 실행할 수 있지만 Edge 올인원(AIO) 설치 프로필이 있는 경우에만 가능합니다. 예를 들면 다음과 같습니다./opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component은 업데이트할 Edge 구성요소입니다. 가능한 값은 다음과 같습니다.
- 아직 실행하지 않은 경우 실행 중인 모든 노드에서 Edge UI 구성요소를 다시 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- 설치 테스트에 설명된 대로 관리 서버에서
apigee-validate유틸리티를 실행하여 업데이트를 테스트합니다.
- Edge
나중에 업데이트를 롤백하려면 4.52.01 롤백에 설명된 절차를 사용합니다.
로컬 저장소에서 4.52.01로 업데이트
Edge 노드가 방화벽 뒤에 있거나 다른 방식으로 인터넷을 통해 Apigee 저장소에 액세스할 수 없는 경우 Apigee 저장소의 로컬 저장소 또는 미러에서 업데이트를 수행할 수 있습니다.
로컬 Edge 저장소를 만든 후에는 로컬 저장소에서 Edge를 업데이트하는 두 가지 옵션이 있습니다.
- 저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 후 .tar 파일에서 Edge를 업데이트합니다.
- 다른 노드가 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹 서버를 설치합니다. Apigee는 사용할 수 있는 Nginx 웹 서버를 제공하거나 자체 웹 서버를 사용할 수 있습니다.
로컬 4.52.01 저장소에서 업데이트하려면 다음 안내를 따르세요.
- Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.52.01 저장소를 만듭니다.
- .tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요.
- 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를
/opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz라는 단일 .tar 파일로 패키징합니다./opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge를 업데이트하려는 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의
/tmp디렉터리에 복사합니다. - 새 노드에서 파일의 tar 압축을 풀어
/tmp디렉터리에 저장합니다.tar -xzf apigee-4.52.01.tar.gz
이 명령어는 .tar 파일이 포함된 디렉터리에
repos라는 새 디렉터리를 만듭니다. 예:/tmp/repos /tmp/repos에서 Edgeapigee-service유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
이 명령어에 repos 디렉터리의 경로를 포함합니다.
- 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를
- Nginx 웹 서버를 사용하여 apigee-service를 설치하려면 다음 안내를 따르세요.
- Edge apigee-setup 유틸리티 설치의 'Nginx 웹 서버를 사용하여 저장소에서 설치'에 설명된 대로 Nginx 웹 서버를 구성합니다.
- 원격 노드에서 Edge
bootstrap_4.52.01.sh파일을/tmp/bootstrap_4.52.01.sh에 다운로드합니다./usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
여기서 uName:pWord는 이전에 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.
- 원격 노드에서 Edge
apigee-setup유틸리티 및 종속 항목을 설치합니다.sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.
- 다음 예시와 같이
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
- 머신 업데이트 순서에 설명된 순서대로 노드에서
update유틸리티를 실행합니다./opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
각 항목의 의미는 다음과 같습니다.
- component은 업데이트할 Edge 구성요소입니다. 일반적으로 다음 구성요소를 업데이트합니다.
cs: Cassandraedge: Edge UI를 제외한 모든 Edge 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버ldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO(SSO를 설치한 경우)ue새 Edge UIui: 기본 Edge UIzk: Zookeeper
- configFile는 4.50.00 또는 4.51.00 설치 중에 Edge 구성요소를 정의하는 데 사용한 것과 동일한 구성 파일입니다.
component를 'all'로 설정하여 모든 구성요소에 대해
update.sh를 실행할 수 있지만 Edge 올인원(AIO) 설치 프로필이 있는 경우에만 가능합니다. 예를 들면 다음과 같습니다./opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component은 업데이트할 Edge 구성요소입니다. 일반적으로 다음 구성요소를 업데이트합니다.
- 아직 실행하지 않은 경우 UI 구성요소를 실행하는 모든 노드에서 UI 구성요소를 다시 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- 설치 테스트에 설명된 대로 관리 서버에서
apigee-validate유틸리티를 실행하여 업데이트를 테스트합니다.
나중에 업데이트를 롤백하려면 4.52.01 롤백에 설명된 절차를 사용합니다.
머신 업데이트 순서
Edge 설치에서 머신을 업데이트하는 순서가 중요합니다.
- 다른 노드를 업데이트하기 전에 모든 Cassandra 및 ZooKeeper 노드를 업데이트해야 합니다.
- 여러 Edge 구성요소(관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버 제외)가 있는 머신의 경우
-c edge옵션을 사용하여 모두 동시에 업데이트합니다. - 여러 머신에서 수행해야 하는 단계가 있는 경우 지정된 머신 순서대로 수행합니다.
- 수익 창출을 업데이트하는 별도의 단계는 없습니다.
-c edge옵션을 지정하면 업데이트됩니다.
1노드 독립형 업그레이드
1노드 독립형 구성을 4.52.01로 업그레이드하려면 다음 안내를 따르세요.
- 모든 구성요소 업데이트:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (
apigee-adminapi를 설치한 경우)apigee-adminapi유틸리티를 업데이트했습니다./opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
노드 2개 독립형 업그레이드
2노드 독립형 설치를 위해 다음 구성요소를 업데이트합니다.
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1에서 Cassandra 및 ZooKeeper를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 머신 2에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 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
- 머신 2에서 Qpid를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 1에서 UI를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (
apigee-adminapi를 설치한 경우) 머신 1에서apigee-adminapi유틸리티를 업데이트했습니다./opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Apigee SSO를 설치한 경우) 머신 1에서 Apigee SSO를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
여기서 sso_config_file는 SSO를 설치할 때 만든 구성 파일입니다.
- 머신 1에서 Edge UI 구성요소를 다시 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
노드 5개 업그레이드
5노드 설치를 위해 다음 구성요소를 업데이트합니다.
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 머신 4에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 5에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 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
- 머신 4에서 Qpid를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 5에서 Qpid를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Edge UI를 업데이트합니다.
- 기존 UI: 기존 UI를 사용하는 경우 다음 예시와 같이 머신 1에서
ui구성요소를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 새 Edge UI: 새 Edge UI를 설치한 경우 적절한 머신에서
ue구성요소를 업데이트합니다(머신 1이 아닐 수 있음)./opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- 기존 UI: 기존 UI를 사용하는 경우 다음 예시와 같이 머신 1에서
- (
apigee-adminapi를 설치한 경우) 머신 1에서apigee-adminapi유틸리티를 업데이트했습니다./opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Apigee SSO를 설치한 경우) 머신 1에서 Apigee SSO를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
여기서 sso_config_file는 SSO를 설치할 때 만든 구성 파일입니다.
- UI 구성요소를 다시 시작합니다.
- 클래식 UI: 클래식 UI를 사용하는 경우 다음 예시와 같이 머신 1에서
edge-ui구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 새 Edge UI: 새 Edge UI를 설치한 경우 적절한 머신(머신 1이 아닐 수 있음)에서
edge-management-ui구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 클래식 UI: 클래식 UI를 사용하는 경우 다음 예시와 같이 머신 1에서
9노드 클러스터 업그레이드
9노드 클러스터 설치를 위해 다음 구성요소를 업데이트합니다.
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 머신 8에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 9에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 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
- 머신 6 및 7에서 Qpid를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 1에서 새 UI(
ue) 또는 기본 UI(ui)를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (
apigee-adminapi를 설치한 경우) 머신 1에서apigee-adminapi유틸리티를 업데이트합니다./opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Apigee SSO를 설치한 경우) 머신 1에서 Apigee SSO를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
여기서 sso_config_file는 SSO를 설치할 때 만든 구성 파일입니다.
- UI 구성요소를 다시 시작합니다.
- 클래식 UI: 클래식 UI를 사용하는 경우 다음 예시와 같이 머신 1에서
edge-ui구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 새 Edge UI: 새 Edge UI를 설치한 경우 적절한 머신(머신 1이 아닐 수 있음)에서
edge-management-ui구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 클래식 UI: 클래식 UI를 사용하는 경우 다음 예시와 같이 머신 1에서
노드 13개 클러스터 업그레이드
13노드 클러스터 설치를 위해 다음 구성요소를 업데이트합니다.
Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참조하세요.
- 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 머신 8에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 9에서 Postgres를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 머신 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
- 머신 12 및 13에서 Qpid를 업데이트합니다.
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 6 및 7에서 새 UI(
ue) 또는 기본 UI(ui)를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (
apigee-adminapi를 설치한 경우) 머신 6 및 7에서apigee-adminapi유틸리티를 업데이트했습니다./opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Apigee SSO를 설치한 경우) 6번 및 7번 머신에서 Apigee SSO를 업데이트하세요.
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
여기서 sso_config_file는 SSO를 설치할 때 만든 구성 파일입니다.
- UI 구성요소를 다시 시작합니다.
- 기존 UI: 기존 UI를 사용하는 경우 다음 예시와 같이 머신 6 및 7에서
edge-ui구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 새 Edge UI: 새 Edge UI를 설치한 경우 머신 6과 7에서
edge-management-ui구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 기존 UI: 기존 UI를 사용하는 경우 다음 예시와 같이 머신 6 및 7에서
노드 12개 클러스터 업그레이드
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에서 다음을 실행합니다.
- Postgres 업데이트:
- 데이터 센터 1의 머신 6
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 데이터 센터 2의 머신 12
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 데이터 센터 1의 머신 6
- 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
- qpidd를 업데이트합니다.
- 데이터 센터 1의 머신 4, 5
- 머신 4에서
qpidd를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 5에서
qpidd를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 4에서
- 데이터 센터 2의 머신 10, 11
- 머신 10에서
qpidd를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 11에서
qpidd를 업데이트합니다./opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 머신 10에서
- 데이터 센터 1의 머신 4, 5
- 새 UI(
ue) 또는 기본 UI(ui)를 업데이트합니다.- 데이터 센터 1의 머신 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 데이터 센터 2의 머신 7:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 데이터 센터 1의 머신 1:
- (
apigee-adminapi를 설치한 경우)apigee-adminapi유틸리티를 업데이트했습니다.- 데이터 센터 1의 머신 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- 데이터 센터 2의 머신 7:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- 데이터 센터 1의 머신 1:
- (Apigee SSO를 설치한 경우) Apigee SSO를 업데이트합니다.
- 데이터 센터 1의 머신 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- 데이터 센터 2의 머신 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
여기서 sso_config_file는 SSO를 설치할 때 만든 구성 파일입니다.
- 데이터 센터 1의 머신 1:
- 머신 1 및 7에서 새 Edge UI(
edge-management-ui) 또는 기본 Edge UI(edge-ui) 구성요소를 다시 시작합니다./opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
비표준 구성의 경우
비표준 구성이 있는 경우 다음 순서로 Edge 구성요소를 업데이트합니다.
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge: 모든 노드의 '-c edge' 프로필을 Qpid 서버, Edge Postgres 서버, 관리 서버, 메시지 프로세서, 라우터가 있는 노드 순서로 지정합니다.
- qpidd
- Edge UI(기존 또는 신규)
apigee-adminapi- Apigee SSO
업데이트가 완료되면 Edge UI 구성요소를 실행하는 모든 머신에서 다시 시작해야 합니다.