Apigee Edge 4.51.00 또는 4.52.00을 4.52.01로 업데이트

Apigee에서는 Private Cloud용 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 for Private Cloudes 출시 버전에는 Jokeeper 3.8.3으로의 업그레이드가 포함되어 있습니다. 이 업그레이드의 일환으로 모든 Jokeeper 데이터가 Jokeeper 3.8.3으로 마이그레이션됩니다.

Zookeeper를 업그레이드하기 전에 Zookeeper 유지관리 가이드를 읽어보세요. 대부분의 Edge 프로덕션 시스템은 여러 데이터 센터에 분산된 Jokeeper 노드 클러스터를 사용합니다. 이러한 노드 중 일부는 Jokeeper 리더 선택에 참여하는 투표자로 구성되고 나머지 노드는 관찰자로 구성됩니다. 자세한 내용은 리더, 팔로어, 투표자, 관찰자에 대한 정보를 참고하세요. 유권자 노드가 리더를 선택하고 나면 투표자 노드 자체가 팔로어가 됩니다.

업데이트 프로세스 중에 리더 노드가 종료될 때 잠시 지연되거나 Jokeeper에 쓰기 오류가 발생할 수 있습니다. 이는 프록시 배포 작업과 같이 Jokeeper에 작성하는 관리 작업과 메시지 프로세서 추가 또는 삭제 등의 Apigee 인프라 변경사항에 영향을 줄 수 있습니다. 아래 절차를 따르는 동안 이러한 런타임 API가 관리 API를 호출하지 않는 한 Apigee의 런타임 API에 영향을 미치지 않습니다.

개략적으로 업그레이드 프로세스에는 각 노드의 백업을 수행하는 것이 포함됩니다. 그런 다음 모든 관찰자와 팔로어를 업그레이드하고 마지막으로 리더 노드를 업그레이드합니다.

백업

롤백이 필요한 경우에 사용할 수 있도록 동물원의 모든 노드를 백업합니다. 롤백하면 백업이 수행된 시점의 상태로Zookeeper가 복원됩니다. 참고: 백업이 실행된 후 (Zookeeper에 정보가 저장됨) Apigee의 배포 또는 인프라 변경사항은 복원 중에 손실됩니다.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

가상 머신을 사용 중이고 해당 기능이 있는 경우 복원 또는 롤백을 위해 VM 스냅샷 또는 백업을 수행할 수도 있습니다 (필요한 경우).

리더, 팔로어, 관찰자 식별

참고: 아래의 샘플 명령어에서는 nc 유틸리티를 사용하여 Zookeeper로 데이터를 전송합니다. 대체 유틸리티를 사용하여 Zookeeper로 데이터를 전송할 수도 있습니다.

1. JoKeeper 노드에 설치되어 있지 않으면 nc를 설치합니다.

     sudo yum install nc

2. 노드에서 다음 nc 명령어를 실행합니다. 여기서 2181은 주Keeper 포트입니다.

     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 줄에는 노드 구성에 따라 관찰자, 리더, 팔로어 (리더가 아닌 투표자)가 표시됩니다. 참고: 하나의 JoKeeper 노드가 포함된 Edge의 독립형 설치에서 Mode는 독립형으로 설정됩니다.

3. 각 JoKeeper 노드에서 1단계와 2단계를 반복합니다.

관찰자 및 팔로어 노드에서 Jokeeper 업그레이드

각 관찰자 및 팔로워 노드에서 Jokeeper를 다음과 같이 업그레이드합니다.

1. 외부 인터넷 연결이 있는 노드에서 4.52.01로 업데이트에 설명된 대로 Edge for Private Cloud 4.52의 부트스트랩을 다운로드하고 실행합니다. 이 프로세스는 노드가 외부 인터넷에 연결되어 있는지 또는 오프라인 설치를 수행하고 있는지에 따라 달라질 수 있습니다.
2. Jokeeper 구성요소 업그레이드:

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   참고: 이러한 노드에 다른 구성요소 (예: Cassandra)가 설치되어 있으면 지금 업그레이드하거나 (예: cs,zk 프로필) 나중에 다른 구성요소를 업그레이드할 수 있습니다. Apigee에서는 다른 구성요소를 업그레이드하기 전에 먼저 Jokeeper를 업그레이드하고 클러스터가 제대로 작동하는지 확인하는 것이 좋습니다.
3. Zookeeper 관찰자 및 팔로어 노드에서 위의 단계를 반복합니다.

리더 종료

모든 관찰자 및 팔로어 노드가 업그레이드되면 리더를 종료합니다. 리더로 식별된 노드에서 아래 명령어를 실행합니다.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

이 이벤트 중에 새 리더가 선택되기 전에 Zakeeper에서 일시적인 지연 또는 쓰기 오류가 발생할 수 있습니다. 이는 프록시 배포 작업 또는 메시지 프로세서 추가 또는 삭제와 같은 Apigee 인프라 변경과 같이 Jokeeper에 작성하는 작업에 영향을 줄 수 있습니다.

새 리더가 선출되었는지 확인

기존 리더가 중지된 후 위의 리더, 팔로어, 관찰자 식별 섹션의 단계를 사용하여 팔로어에서 새 리더가 선택되었는지 확인합니다. 리더는 현재 리더와 다른 데이터 센터에서 선택되었을 수 있습니다.

리더 업그레이드

위의 관찰자 및 팔로어 노드에서 Jokeeper 업그레이드와 동일한 단계를 따릅니다.

이전 리더 노드도 업그레이드되면 클러스터 상태를 확인하고 리더 노드가 있는지 확인합니다.

롤백

롤백이 필요한 경우 다음을 실행합니다.

1. 먼저 관찰자와 팔로어에서 롤백 단계를 실행합니다.
2. 롤백하려는 버전(4.50 또는 4.51)의 부트스트랩을 다운로드하여 실행합니다. 이 프로세스는 노드가 외부 인터넷에 연결되어 있는지 또는 오프라인 설치를 따르는지에 따라 다를 수 있습니다.
3. Jokeeper가 노드에서 실행 중인 경우 다음을 중지합니다.

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

4. 기존 zookeeper 제거:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

5. 평소와 같이 Jokeeper를 설치합니다.

     /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

6. 모든 팔로어와 관찰자가 롤백되면 리더 노드에서 2~5단계에 따라 리더 노드를 롤백합니다.
7. 모든 노드가 롤백되면 클러스터 상태를 확인하고 클러스터에 리더 노드가 있는지 확인합니다.

백업 복원

백업에서 복원하기를 참고하세요. 4.50 및 4.51과 같은 이전 버전의 Private Cloud용 Edge에서 가져온 Zookeeper 백업은 프라이빗 클라우드용 Edge용 Edge 4.52의 Zookeeper 버전과 호환되어야 합니다.

Qpid 업그레이드

이 프라이빗 클라우드용 에지 출시 버전에는 Qpid J-Broker로의 업그레이드가 포함되어 있습니다. 다음 방법 중 하나를 선택하여 Qpid 업그레이드를 수행하는 것이 좋습니다.

• 다운타임 없이 인플레이스(In-Place) 업그레이드
• 새 Qpid 노드 커밋

다운타임 없이 인플레이스(In-Place) 업그레이드

이 방법을 사용하면 Edge 런타임 환경에 다운타임이 발생하지 않으며 분석을 위해 획득한 런타임 데이터의 손실이 최소화됩니다.

다운타임 없이 인플레이스(In-Place)로 Qpid로 업그레이드하려면 다음 안내를 따르세요.

1. 시작할 Qpid 노드 1개를 선택합니다.
2. 노드에서 Qpid 브로커를 중지합니다.

   apigee-service apigee-qpidd stop

3. 방화벽을 적용하여 모든 메시지 프로세서로부터 브로커 포트 5672에 들어오는 트래픽을 차단합니다. Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성요소 수준에서 이 방화벽을 적용할 수 있습니다.

   모든 메시지 프로세서 IP 주소에 대해 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 IPTables를 사용하여 메시지 프로세서 IP 주소에서 들어오는 포트 5672의 Qpid 노드로 요청을 DROPS하려면 다음과 같은 명령어를 사용할 수 있습니다.

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

4. Qpid 브로커를 다시 시작하여 기존 메시지를 드레이닝합니다(있는 경우).

   apigee-service apigee-qpidd start

5. 기존 큐가 비어 있는지 확인합니다.

   qpid-stat -q

   메시지가 데드 레터 큐 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl)에서 멈춘 경우 데드 레터 큐에서 멈춘 분석 데이터 해결 단계를 사용하여 큐를 드레이닝합니다.

6. 이전 노드에서 큐가 드레이닝되었는지 확인한 후 apigee-qpidd를 중지합니다.

   apigee-service apigee-qpidd stop

7. 노드에서 Qpid를 업그레이드합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

8. edge-qpid-server를 다시 시작합니다.

   apigee-service edge-qpid-server restart

9. 3단계에서 적용한 방화벽 규칙을 삭제합니다.

   방화벽이 적용된 모든 메시지 프로세서 IP 주소에 대해 동일한 삭제 단계를 수행합니다. 방화벽이 삭제되면 메시지 프로세서 IP 주소에서 포트 5672의 Qpid 노드로 전송되는 요청이 수락됩니다. iptables를 사용하여 방화벽을 추가하고, 방화벽을 삭제하고, 기존 설정을 나열하려면 다음과 같은 명령어를 사용할 수 있습니다.

   iptables -F
     iptables -L

10. 웹 모니터링을 사용하여 Qpid 큐가 메시지를 수신하는지 확인합니다.

    http://QPID_NODE_IP:8090

11. 각 Qpid 노드에 1~9단계를 반복합니다.

새 Qpid 노드 커미셔닝

이 메서드는 새 노드에 apigee-qpidd와 edge-qpid-server를 설정하고 설치합니다.

1. 새 Qpid 노드를 추가합니다. 이 단계에서는 J-브로커로 Qpid 노드를 설정합니다. 자세한 단계는 Qpid 서버 추가를 참조하세요.
2. 기존 Qpid 노드 (업그레이드할 버전의 노드)를 선택합니다.
3. 노드에서 Qpid 브로커를 중지합니다.

   apigee-service apigee-qpidd stop

4. 방화벽을 적용하여 모든 메시지 프로세서로부터 브로커 포트 5672에 들어오는 트래픽을 차단합니다. Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성요소 수준에서 이 방화벽을 적용할 수 있습니다.

   모든 메시지 프로세서 IP 주소에 대해 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 IPTables를 사용하여 메시지 프로세서 IP 주소에서 들어오는 포트 5672의 Qpid 노드로 요청을 DROPS하려면 다음과 같은 명령어를 사용할 수 있습니다.

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

5. Qpid 브로커를 다시 시작하여 기존 메시지를 드레이닝합니다(있는 경우).

   apigee-service apigee-qpidd start

6. 기존 큐가 비어 있는지 확인합니다.

   qpid-stat -q

   메시지가 데드 레터 큐 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl)에서 멈춘 경우 문제 해결 주제 애널리틱스 데이터가 Qpidd 데드 레터 큐에서 멈춤의 단계에 따라 큐를 드레이닝합니다.

7. 큐가 이전 노드에서 드레이닝되었는지 확인한 후 apigee-qpidd

   apigee-service apigee-qpidd stop

   를 중지합니다.
8. Qpid 서버 삭제의 단계에 따라 이전 Qpid 노드를 등록 취소합니다.
9. 모든 Qpid 노드가 업그레이드될 때까지 계속 새 노드를 추가하고 이전 노드를 한 번에 하나씩 삭제합니다.

롤백

이전 기능 출시로 롤백하려면 롤백하려는 버전의 bootstrap.sh 파일을 다운로드해야 합니다. v4.52.00으로 롤백하려면 bootstrap_4.52.00.sh을 다운로드하세요.

Qpid를 롤백하려면 모든 Qpid 호스트에서 다음 단계를 따르세요.

1. 기존 Qpid 브로커

   apigee-service apigee-qpidd stop

   중지
2. 방화벽을 적용하여 모든 메시지 프로세서로부터 브로커 포트 5672에 들어오는 트래픽을 차단합니다. Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성요소 수준에서 이 방화벽을 적용할 수 있습니다.

   모든 메시지 프로세서 IP 주소에 대해 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 IPTables를 사용하여 메시지 프로세서 IP 주소에서 들어오는 포트 5672의 Qpid 노드로 요청을 DROPS하려면 다음과 같은 명령어를 사용할 수 있습니다.

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

3. qpid 브로커를 다시 시작하여 기존 메시지를 드레이닝합니다(있는 경우).

   apigee-service apigee-qpidd start

4. 기존 큐가 비어 있는지 확인합니다. 확인하려면 Qpid 관리 포털에 로그인하세요.

   http://QPID_NODE_IP:8090

   참고: QPID 노드의 이 포트 8090에 액세스할 수 없는 경우 SSH 포트 전달과 같은 대체 메커니즘을 사용하여 이 URL에 액세스할 수 있습니다.
5. 큐가 드레이닝되었는지 확인한 후 Qpid를 중지하고 제거합니다.

   apigee-service apigee-apidd uninstall

6. Qpid 데이터 디렉터리를 삭제합니다.

   rm -r APIGEE_ROOT/data/apigee-qpidd

7. Qpid 브로커를 재설치합니다.

   /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

8. Qpid 브로커가 재설치되면 방화벽 설정을 삭제하고 다음 명령어를 사용하여 기존 설정을 나열합니다.

   iptables -F

   iptables -L

새 Edge UI

이 섹션에는 Edge UI와 관련된 고려사항이 나와 있습니다. 자세한 내용은 프라이빗 클라우드용 새로운 Edge UI를 참조하세요.

Edge UI 설치

초기 설치를 완료한 후에는 Apigee에서 Private Cloud용 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를 업데이트하려면 다음 단계를 수행합니다.

• Apigee mTLS를 제거합니다.
• Apigee mTLS를 재설치합니다.

업데이트 롤백

업데이트에 실패하면 문제 해결을 시도한 다음 update.sh를 다시 실행할 수 있습니다. 업데이트를 여러 번 실행할 수 있으며 마지막으로 중단된 부분부터 업데이트를 계속합니다.

실패 시 업데이트를 이전 버전으로 롤백해야 하는 경우 4.52.00 롤백에서 자세한 안내를 확인하세요.

Logging 업데이트 정보

기본적으로 update.sh 유틸리티는 다음에 로그 정보를 작성합니다.

/opt/apigee/var/log/apigee-setup/update.log

update.sh 유틸리티를 실행하는 사용자에게 해당 디렉터리에 대한 액세스 권한이 없으면 로그를 /tmp 디렉터리에 update_username.log라는 파일로 작성합니다.

그 사람에게 /tmp 액세스 권한이 없으면 update.sh 유틸리티가 실패합니다.

다운타임 없는 업데이트

다운타임이 없는 업데이트 또는 순차적 업데이트를 사용하면 Edge를 중단하지 않고도 Edge 설치를 업데이트할 수 있습니다.

다운타임 없는 업데이트는 노드가 5개 이상인 구성에서만 가능합니다.

다운타임 없는 업그레이드의 핵심은 부하 분산기에서 한 번에 하나씩 라우터를 삭제하는 것입니다. 그런 다음 라우터와 동일한 머신의 라우터 및 기타 구성요소를 업데이트하고 라우터를 다시 부하 분산기에 추가합니다.

1. 머신 업데이트 순서에 설명된 대로 올바른 설치 순서로 머신을 업데이트합니다.
2. 라우터를 업데이트할 때가 되면 서버(메시지 프로세서/라우터) 연결 가능성 사용 설정/사용 중지에 설명된 대로 라우터를 하나만 선택하고 연결할 수 없도록 설정합니다.
3. 라우터와 동일한 머신에서 선택한 라우터 및 다른 모든 Edge 구성요소를 업데이트합니다. 모든 Edge 구성은 동일한 노드에 라우터와 메시지 프로세서를 표시합니다.
4. 라우터를 다시 연결할 수 있도록 설정합니다.
5. 나머지 라우터에 대해 2~4단계를 반복합니다.
6. 설치에 남아 있는 머신의 업데이트를 계속 진행합니다.

업데이트 전후에 다음 사항에 유의하세요.

• 결합된 라우터 및 메시지 프로세서 노드에서:
  • 업데이트 전: 다음을 실행합니다.
    1. 라우터에 연결할 수 없도록 설정합니다.
    2. 메시지 프로세서에 연결할 수 없도록 설정합니다.
  • 업데이트 후 다음을 실행합니다.
    1. 메시지 프로세서에 연결할 수 있도록 합니다.
    2. 라우터에 연결 가능하도록 설정합니다.
• 단일 라우터 노드의 경우:
  • 업데이트하기 전에 라우터를 연결할 수 없도록 설정합니다.
  • 업데이트 후에는 라우터에 연결 가능하도록 설정합니다.
• 단일 메시지 프로세서 노드:
  • 업데이트하기 전에 메시지 프로세서에 연결할 수 없도록 설정합니다.
  • 업데이트 후 메시지 프로세서를 연결 가능하도록 설정합니다.

자동 구성 파일 사용

자동 구성 파일을 update 명령어에 전달해야 합니다. 자동 구성 파일은 Edge 4.50.00 또는 4.51.00을 설치하는 데 사용한 파일과 동일해야 합니다.

외부 인터넷 연결이 있는 노드에서 4.52.01로 업데이트

다음 절차에 따라 노드의 Edge 구성요소를 업데이트합니다.

1. 이 항목이 있으면 업데이트가 완료될 때까지 Cassandra에서 복구 작업을 수행하도록 구성된 모든 cron 작업을 사용 중지합니다.
2. 노드에 루트로 로그인하여 Edge RPM을 설치합니다.
3. yum-utils 및 yum-plugin-priorities를 설치합니다.

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. Edge Apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
5. Oracle 7.x에 설치하는 경우 다음 명령어를 실행합니다.

   sudo yum-config-manager --enable ol7_optional_latest

6. 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

7. 현재 Edge 4.51.00을 사용 중인 경우:

   1. 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

   2. 다음 명령어를 실행하여 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_FIX는 다음 값을 사용합니다.

      • I: OpenJDK 1.8 (기본값)을 설치합니다.
      • C: 자바를 설치하지 않고 계속 진행합니다.
      • Q: 종료합니다. 이 옵션을 사용하려면 자바를 직접 설치해야 합니다.
   3. 다음 예에 표시된 대로 apigee-service를 사용하여 apigee-setup 유틸리티를 업데이트합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. 다음 예시에 표시된 것처럼 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. 다음 예시에 표시된 것처럼 관리 서버에서 apigee-provision 유틸리티를 업데이트합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. 다음 명령어를 실행하여 노드에서 update 유틸리티를 실행합니다.

      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      머신 업데이트 순서에 설명된 순서대로 수행합니다.

      각 항목의 의미는 다음과 같습니다.

      • component는 업데이트할 Edge 구성요소입니다. 가능한 값은 다음과 같습니다.
        • cs: Cassandra
        • edge: Edge UI를 제외한 모든 에지 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (SSO를 설치한 경우)
        • ue: 새로운 Edge UI
        • ui: 기본 Edge UI
        • zk: 동물원키퍼
      • 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

   7. 아직 실행하지 않았다면 실행 중인 모든 노드에서 Edge UI 구성요소를 다시 시작합니다.

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   8. 설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.

나중에 업데이트를 롤백하려면 4.52.01 롤백에 설명된 절차를 사용합니다.

로컬 저장소에서 4.52.01로 업데이트

Edge 노드가 방화벽으로 보호되어 있거나 어떤 방식으로든 인터넷을 통해 Apigee 저장소에 액세스하는 것이 금지된 경우 Apigee 저장소의 로컬 저장소 또는 미러에서 업데이트를 수행할 수 있습니다.

로컬 Edge 저장소를 만든 후 로컬 저장소에서 Edge를 업데이트하는 방법에는 두 가지가 있습니다.

• 저장소의 .tar 파일을 만들고 .tar 파일을 노드에 복사한 다음 .tar 파일에서 Edge를 업데이트합니다.
• 다른 노드에서 액세스할 수 있도록 로컬 저장소가 있는 노드에 웹 서버를 설치합니다. Apigee에서 사용할 수 있는 Nginx 웹 서버를 제공하거나 자체 웹 서버를 사용할 수 있습니다.

로컬 4.52.01 저장소에서 업데이트하는 방법은 다음과 같습니다.

1. Edge apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.52.01 저장소를 만듭니다.
2. .tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요.
   1. 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz이라는 단일 .tar 파일로 패키징합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. Edge를 업데이트할 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
   3. 새 노드에서 /tmp 디렉터리의 파일을 압축 해제합니다.

      tar -xzf apigee-4.52.01.tar.gz

      이 명령어는 .tar 파일이 포함된 디렉터리에 repos라는 새 디렉터리를 만듭니다. 예: /tmp/repos

   4. /tmp/repos에서 Edge apigee-service 유틸리티와 종속 항목을 설치합니다.

      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      이 명령어에 repos 디렉터리의 경로를 포함합니다.

3. Nginx 웹 서버를 사용하여 Apigee-service를 설치하려면 다음 안내를 따르세요.
   1. Edge apigee-setup 유틸리티 설치의 'Nginx 웹 서버를 사용하여 저장소에서 설치'에 설명된 대로 Nginx 웹 서버를 구성합니다.
   2. 원격 노드에서 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 이름입니다.

   3. 원격 노드에서 Edge apigee-setup 유틸리티 및 종속 항목을 설치합니다.

      sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      여기서 uName:pWord는 저장소 사용자 이름과 비밀번호입니다.

4. 다음 예에 표시된 대로 apigee-service를 사용하여 apigee-setup 유틸리티를 업데이트합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. 다음 예시에 표시된 것처럼 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. 다음 예시에 표시된 것처럼 관리 서버에서 apigee-provision 유틸리티를 업데이트합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. 머신 업데이트 순서에 설명된 순서대로 노드에서 update 유틸리티를 실행합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   각 항목의 의미는 다음과 같습니다.

   • component는 업데이트할 Edge 구성요소입니다. 일반적으로 다음 구성요소를 업데이트합니다.
     • cs: Cassandra
     • edge: Edge UI를 제외한 모든 에지 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: Apigee SSO (SSO를 설치한 경우)
     • ue New Edge UI
     • ui: 기본 Edge UI
     • zk: 동물원키퍼
   • 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

8. UI 구성요소를 실행 중인 모든 노드에서 UI 구성요소를 다시 시작합니다(아직 실행하지 않은 경우).

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. 설치 테스트에 설명된 대로 관리 서버에서 apigee-validate 유틸리티를 실행하여 업데이트를 테스트합니다.

나중에 업데이트를 롤백하려면 4.52.01 롤백에 설명된 절차를 사용합니다.

머신 업데이트 순서

Edge 설치에서 머신을 업데이트하는 순서가 중요합니다.

• 다른 노드를 업데이트하기 전에 모든 Cassandra 및 JoKeeper 노드를 업데이트해야 합니다.
• 여러 에지 구성요소(관리 서버, 메시지 프로세서, 라우터, QPID 서버(Postgres 서버 제외))가 있는 시스템의 경우 -c edge 옵션을 사용하여 모든 구성요소를 동시에 업데이트합니다.
• 단계가 여러 머신에서 수행되어야 한다고 지정하는 경우 지정된 머신 순서로 수행합니다.
• 수익 창출을 업데이트하기 위한 별도의 단계는 없습니다. -c edge 옵션을 지정하면 업데이트됩니다.

1노드 독립형 업그레이드

1노드 독립형 구성을 4.52.01로 업그레이드하려면 다음 안내를 따르세요.

1. 모든 구성요소 업데이트:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. (apigee-adminapi를 설치한 경우) apigee-adminapi 유틸리티를 업데이트했습니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2노드 독립형 업그레이드

2노드 독립형 설치를 위해 다음 구성요소를 업데이트합니다.

Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

1. 머신 1에서 Cassandra 및 동물원Keeper를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 머신 2에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

3. 시스템 1에서 LDAP 업데이트:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. 머신 2 및 1에서 Edge 구성요소를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. 머신 2에서 Qpid를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. 머신 1에서 UI를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

7. (apigee-adminapi를 설치한 경우) 머신 1의 apigee-adminapi 유틸리티를 다음과 같이 업데이트했습니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (Apigee SSO를 설치한 경우) 머신 1에서 Apigee SSO를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   여기서 sso_config_file은 SSO를 설치할 때 생성한 구성 파일입니다.

9. 머신 1에서 Edge UI 구성요소를 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5노드 업그레이드

5노드 설치를 위해 다음 구성요소를 업데이트합니다.

Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

1. 머신 1, 2, 3에서 Cassandra 및 동물원Keeper를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 머신 4에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

3. 머신 5에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. 시스템 1에서 LDAP 업데이트:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. 머신 4, 5, 1, 2, 3의 Edge 구성요소를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 머신 4에서 Qpid를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

7. 머신 5에서 Qpid를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

8. Edge UI를 업데이트합니다.
   • 기본 UI: 기본 UI를 사용하는 경우 다음 예에 표시된 것처럼 머신 1의 ui 구성요소를 업데이트합니다.

     /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   • 새 Edge UI: 새 Edge UI를 설치했으면 적절한 머신 (머신 1이 아닐 수 있음)에서 ue 구성요소를 업데이트합니다.

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

9. (apigee-adminapi를 설치한 경우) 머신 1의 apigee-adminapi 유틸리티를 다음과 같이 업데이트했습니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. (Apigee SSO를 설치한 경우) 머신 1에서 Apigee SSO를 업데이트합니다.

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    여기서 sso_config_file은 SSO를 설치할 때 생성한 구성 파일입니다.

11. 다음과 같이 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

9노드 클러스터형 업그레이드

9노드 클러스터링 설치를 위해 다음 구성요소를 업데이트합니다.

Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

1. 머신 1, 2, 3에서 Cassandra 및 동물원Keeper를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 머신 8에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

3. 머신 9에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. 시스템 1에서 LDAP 업데이트:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. 머신 6, 7, 8, 9, 1, 4, 5의 Edge 구성요소를 순서대로 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 머신 6 및 7에서 Qpid를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

7. 머신 1에서 새 UI (ue) 또는 기본 UI (ui)를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (apigee-adminapi를 설치한 경우) 머신 1에서 apigee-adminapi 유틸리티를 업데이트합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (Apigee SSO를 설치한 경우) 머신 1에서 Apigee SSO를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   여기서 sso_config_file은 SSO를 설치할 때 생성한 구성 파일입니다.

10. 다음과 같이 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

노드 13개로 클러스터링된 업그레이드

13노드 클러스터형 설치를 위해 다음 구성요소를 업데이트합니다.

Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

1. 머신 1, 2, 3에서 Cassandra 및 동물원Keeper를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 머신 8에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

3. 머신 9에서 Postgres를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. 시스템 4 및 5에서 LDAP를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. 머신 12, 13, 8, 9, 6, 7, 10, 11의 Edge 구성요소를 순서대로 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 머신 12 및 13에서 Qpid를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

7. 머신 6과 7에서 새 UI (ue) 또는 기본 UI (ui)를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (apigee-adminapi를 설치한 경우) 머신 6 및 7의 apigee-adminapi 유틸리티를 다음과 같이 업데이트했습니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (Apigee SSO를 설치한 경우) 머신 6 및 7에서 Apigee SSO를 업데이트합니다.

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   여기서 sso_config_file은 SSO를 설치할 때 생성한 구성 파일입니다.

10. 다음과 같이 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

노드 12개로 클러스터링된 업그레이드

12노드 클러스터형 설치를 위해 다음 구성요소를 업데이트합니다.

Edge 토폴로지 및 노드 번호 목록은 설치 토폴로지를 참고하세요.

1. Cassandra 및 동물원Keeper를 업데이트합니다.
   1. 데이터 센터 1에 있는 머신 1, 2, 3의 경우:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. 데이터 센터 2에 있는 머신 7, 8, 9에서

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Postgres를 업데이트합니다.
   1. 데이터 센터 1의 머신 6

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. 데이터 센터 2의 머신 12

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

3. LDAP를 업데이트합니다.
   1. 데이터 센터 1의 머신 1

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   2. 데이터 센터 2의 머신 7

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. Edge 구성요소를 업데이트합니다.
   1. 데이터 센터 1의 머신 4, 5, 6, 1, 2, 3

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. 데이터 센터 2의 머신 10, 11, 12, 7, 8, 9

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. qpidd를 업데이트합니다.
   1. 데이터 센터 1의 머신 4, 5
      1. 머신 4에서 qpidd를 업데이트합니다.

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. 머신 5에서 qpidd를 업데이트합니다.

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. 데이터 센터 2의 머신 10, 11
      1. 머신 10에서 qpidd 를 업데이트합니다.

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. 머신 11에서 qpidd 를 업데이트합니다.

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. 새 UI (ue) 또는 기본 UI (ui)를 업데이트합니다.
   1. 데이터 센터 1의 머신 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. 데이터 센터 2의 머신 7:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. (apigee-adminapi를 설치한 경우) apigee-adminapi 유틸리티를 업데이트했습니다.
   1. 데이터 센터 1의 머신 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. 데이터 센터 2의 머신 7:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (Apigee SSO를 설치한 경우) Apigee SSO를 업데이트합니다.
   1. 데이터 센터 1의 머신 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. 데이터 센터 2의 머신 7:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   여기서 sso_config_file은 SSO를 설치할 때 생성한 구성 파일입니다.

9. 머신 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 구성요소를 다음 순서로 업데이트합니다.

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge로, Qpid 서버가 있는 노드, Edge Postgres 서버, Management Server, 메시지 프로세서, 라우터 순서로 모든 노드의 '-c Edge' 프로필을 의미합니다.
6. Qpidd
7. Edge UI (기본 또는 신규)
8. apigee-adminapi
9. Apigee SSO

업데이트가 완료되면 이를 실행하는 모든 머신에서 Edge UI 구성요소를 다시 시작해야 합니다.