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

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 Private Cloud에는 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에 데이터를 전송할 수도 있습니다.

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

     sudo yum install nc

2. 노드에서 다음 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는 독립형으로 설정됩니다.

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

관찰자 및 후속 노드에서 Zookeeper 업그레이드

다음과 같이 각 관찰자 및 후속 노드에서 Zookeeper를 업그레이드합니다.

1. 외부 인터넷에 연결된 노드에서 4.52.01로 업데이트에 설명된 대로 비공개 클라우드용 Edge 4.52의 부트스트랩을 다운로드하여 실행합니다. 이 프로세스는 노드에 외부 인터넷 연결이 있는지 또는 오프라인 설치를 실행하는지에 따라 다를 수 있습니다.
2. Zookeeper 구성요소를 업그레이드합니다.

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

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

리더 종료

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

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

이 이벤트가 발생하는 동안 새 리더가 선출되기 전에 Zookeeper에 일시적인 지연 또는 쓰기 실패가 발생할 수 있습니다. 이는 프록시 배포 작업 또는 Apigee 인프라 변경사항(예: 메시지 프로세서 추가 또는 삭제)과 같이 Zookeeper에 쓰는 작업에 영향을 줄 수 있습니다.

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

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

리더 업그레이드

위의 옵저버 및 후속 노드에서 Zookeeper 업그레이드와 동일한 단계를 따릅니다.

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

롤백

롤백이 필요한 경우:

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

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

4. 기존 ZooKeeper를 제거합니다.

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

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

     /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 백업은 Private Cloud용 Edge 4.52의 Zookeeper 버전과 호환되어야 합니다.

Postgres 14로 업그레이드 필요

이번 Edge Private Cloud 출시에는 Postgres 14로의 업그레이드가 포함되어 있습니다. 이번 업그레이드의 일환으로 모든 Postgres 데이터가 Postgres 14로 이전됩니다.

• Edge for Private Cloud 4.51.00에서 4.52.01로 업그레이드하는 경우 추가 Postgres 업그레이드 단계를 따라야 합니다. 버전 4.51.00에서 4.52.01로 업그레이드하는 경우 Postgres 14로의 필수 업그레이드 섹션을 참고하세요.
• Edge Private Cloud 4.52.00에서 4.52.01로 업그레이드하는 경우에는 추가 Postgres 업그레이드 단계가 필요하지 않습니다.

Qpid 업그레이드

이 Private Cloud용 Edge 출시에는 Qpid J-Broker 업그레이드가 포함되어 있습니다.

Qpid 업그레이드를 실행하려면 다음 방법 중 하나를 선택하는 것이 좋습니다.

• 다운타임 없는 인플레이스 업그레이드
• 새 Qpid 노드 커미셔닝

제로 다운타임 인플레이스 업그레이드

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

Qpid로의 인플레이스 업그레이드(다운타임 없음)를 수행하려면 다음 단계를 따르세요.

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

   apigee-service apigee-qpidd stop

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

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

   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-broker로 Qpid 노드를 설정합니다. 자세한 단계는 Qpid 서버 추가를 참고하세요.
2. 기존 Qpid 노드 (업그레이드하려는 버전의 노드)를 선택합니다.
3. 노드에서 Qpid 브로커를 중지합니다.

   apigee-service apigee-qpidd stop

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

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

   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 노드로 전송되는 요청을 DROP하려면 다음과 같은 명령어를 사용할 수 있습니다.

   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 Edge for Private Cloud의 개발자 및 관리자를 위한 향상된 사용자 인터페이스인 Edge UI를 설치하는 것이 좋습니다.

Edge UI를 사용하려면 기본 인증을 사용 중지하고 SAML 또는 LDAP와 같은 IDP를 사용해야 합니다.

자세한 내용은 새 Edge UI 설치를 참고하세요.

Edge UI 업데이트

Edge UI 구성요소를 업데이트하려면 업그레이드하려는 Edge for Private Cloud 버전을 고려하세요.

• 4.51.00에서 4.52.00으로 (새 Edge UI가 이미 설치됨): edge-management-ui 구성요소에 이 섹션의 업그레이드 안내를 사용합니다.

Apigee mTLS로 업데이트

Apigee mTLS를 업데이트하려면 다음 단계를 따르세요.

• 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개 노드 이상의 구성에서만 가능합니다.

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

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

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

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

무음 구성 파일 사용

업데이트 명령어에 무음 구성 파일을 전달해야 합니다. 무음 구성 파일은 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 설치를 처리하는 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.

      • I: OpenJDK 1.8을 설치합니다 (기본값).
      • C: Java를 설치하지 않고 계속 진행합니다.
      • Q: 종료 이 옵션을 사용하려면 Java를 직접 설치해야 합니다.
   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를 제외한 모든 Edge 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (SSO를 설치한 경우)
        • ue: 새로운 Edge UI
        • ui: 기존 Edge UI
        • zk: Zookeeper
      • configFile는 4.50.00 또는 4.51.00 설치 중에 Edge 구성요소를 정의하는 데 사용한 것과 동일한 구성 파일입니다.

      Edge 올인원 (AIO) 설치 프로필이 있는 경우에만 component을 'all'로 설정하여 모든 구성요소에 대해 update.sh를 실행할 수 있습니다. 예를 들면 다음과 같습니다.

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

   7. 아직 Edge UI 구성요소를 실행하는 모든 노드에서 Edge UI 구성요소를 다시 시작합니다.

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|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. .tar 파일을 Edge를 업데이트할 노드에 복사합니다. 예를 들어 새 노드의 /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

      이 명령어에는 저장소 디렉터리의 경로가 포함됩니다.

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를 제외한 모든 Edge 구성요소: 관리 서버, 메시지 프로세서, 라우터, QPID 서버, Postgres 서버
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: Apigee SSO (SSO를 설치한 경우)
     • ue 새 Edge UI
     • ui: 기존 Edge UI
     • zk: Zookeeper
   • configFile는 4.50.00 또는 4.51.00 설치 중에 Edge 구성요소를 정의하는 데 사용한 것과 동일한 구성 파일입니다.

   Edge 올인원 (AIO) 설치 프로필이 있는 경우에만 component을 'all'로 설정하여 모든 구성요소에 대해 update.sh를 실행할 수 있습니다. 예를 들면 다음과 같습니다.

   /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 및 ZooKeeper 노드를 모두 업데이트해야 합니다.
• 여러 Edge 구성요소(관리 서버, 메시지 프로세서, 라우터, 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노드 독립형 설치의 경우 다음 구성요소를 업데이트합니다.

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

1. 머신 1에서 Cassandra 및 ZooKeeper를 업데이트합니다.

   /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노드 설치의 경우 다음 구성요소를 업데이트합니다.

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

1. 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.

   /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노드 클러스터 설치의 경우 다음 구성요소를 업데이트합니다.

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

1. 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.

   /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노드 클러스터 설치의 경우 다음 구성요소를 업데이트합니다.

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

1. 머신 1, 2, 3에서 Cassandra 및 ZooKeeper를 업데이트합니다.

   /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노드 클러스터 설치의 경우 다음 구성요소를 업데이트합니다.

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

1. Cassandra 및 ZooKeeper를 업데이트합니다.
   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 서버, 관리 서버, 메시지 프로세서, 라우터 순으로 모든 노드의 '-c edge' 프로필을 의미합니다.
6. qpidd
7. Edge UI (기존 또는 신규)
8. apigee-adminapi
9. Apigee SSO

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