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 호환성 전략이 다음과 같이 설정되어 있는지 확인하세요. LeveledCompactionStrategy(다음에 설명됨) Cassandra 압축 전략.

속성 설정 자동 전파

다음에서 .properties 파일을 수정하여 속성을 설정한 경우 /opt/apigee/customer/application이면 이 값이 업데이트에 의해 유지됩니다.

주키퍼 3.8.3으로 업그레이드 필요

이번 Private Cloud용 Edge 출시 버전에는 주키퍼 3.8.3으로의 업그레이드가 포함되어 있습니다. 참여 대상 업그레이드하지 않을 경우 모든 동물원 데이터는 주키퍼 3.8.3으로 이전됩니다.

주키퍼를 업그레이드하기 전에 Zookeeper 유지보수 가이드를 참조하세요. 대부분의 Edge 프로덕션 시스템은 Zookeeper 노드 클러스터가 분산된 경우 여러 개의 데이터 센터에 저장되어 있습니다 이러한 노드 중 일부는 참여하는 투표자로 구성됩니다. 나머지는 관찰자로 구성됩니다. 를 참조하세요. 리더, 팔로어, 투표자, 관찰자 정보를 참고하세요. 유권자 노드는 리더가 되고 그 이후에는 유권자 노드 자체가 팔로어가 됩니다.

업데이트 프로세스 중에 일시적으로 지연되거나 동물원 사냥에 쓰기 실패가 발생할 수 있습니다. 리더 노드가 종료될 때 이는 프록시 배포 작업, Apigee 인프라 변경사항 등 주키퍼 메시지 프로세서 추가 또는 제거 등이 포함되며, 런타임에도 영향이 없어야 합니다. API의 주키퍼를 업그레이드하는 동안 Apigee (이러한 런타임 API 호출 관리 API 제외) 다음 절차를 따르세요.

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

백업

롤백이 필요한 경우에 사용할 수 있도록 동물원의 모든 노드를 백업합니다. 참고: 롤백하면 주키퍼가 백업이 수행된 상태로 복원됩니다. 참고: 모든 배포 또는 백업이 이루어진 후 Apigee의 인프라 변경사항 (정보가 Google Cloud Storage에 동물원 사육사) 데이터가 손실될 수 있습니다.

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

가상 머신을 사용하고 있고 기능이 있는 경우, VM 스냅샷 또는 백업은 복구 또는 롤백을 수행합니다 (필요한 경우).

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

참고: 아래 샘플 명령어는 nc 유틸리티 주키퍼에 데이터를 보냅니다. 다음을 사용할 수 있습니다. 주키퍼에 데이터를 보내는 대체 유틸리티도 있습니다.

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

     sudo yum install nc

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

     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 줄에 관찰자, 리더 또는 팔로어 (리더가 아닌 유권자)에게 할당될 수 있습니다. 참고: 하나의 주Keeper 노드가 있는 Edge의 독립형 설치에서는 Mode 독립형으로 설정됩니다

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

관찰자 및 팔로어 노드에서 주키퍼 업그레이드

각 관찰자 및 팔로어 노드에서 다음과 같이 동물원을 업그레이드합니다.

1. 다음에 설명된 대로 Private Cloud 4.52용 Edge 부트스트랩을 다운로드하고 실행합니다. <ph type="x-smartling-placeholder"></ph> 외부 인터넷이 연결된 노드에서 4.52.01로 업데이트 이 프로세스는 노드에 외부 인터넷 연결이 있는지 또는 오프라인 설치를 수행하는 경우
2. 주키퍼 구성요소를 업그레이드합니다.

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

   드림 참고: 이러한 노드에 다른 구성요소 (예: Cassandra)가 설치되어 있는 경우 지금도 업그레이드하거나 (예: cs,zk 프로필 사용) 나중에 다른 구성요소를 업그레이드할 수 있습니다. Apigee 먼저 주키퍼를 업그레이드하고 클러스터가 제대로 작동하는지 확인할 것을 권장합니다. 다른 구성요소를 업그레이드하기 전에 확인할 수 있습니다
3. 각 주키퍼 관찰자 및 팔로어 노드에서 위 단계를 반복합니다.

리더 종료

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

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

이 이벤트 중에는 새 리더가 선출되기 전에 일시적으로 지연되거나 주키퍼의 쓰기 실패입니다. 이 작업으로 주키퍼에 쓰는 작업이 영향을 받을 수 있습니다. 추가, 메시지 프로세서 제거 등

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

주요 변수 식별, 섹션에서 새로운 리더가 선출되었는지 확인하고 기존 리더가 중지되면 팔로어가 되지 않습니다. 참고로 리더는 현재 리더와 다른 데이터 센터를 운영해야 합니다

리더 업그레이드

에서와 동일한 단계를 따릅니다. 위의 관찰자 및 팔로어 노드에서 주키퍼 업그레이드를 참조하세요.

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

롤백

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

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

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

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

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

5. 평소와 같이 동물원을 설치합니다.

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

6. 모든 팔로어와 관찰자가 롤백되면 리더 노드 2~5단계를 따릅니다.
7. 모든 노드가 롤백된 후 클러스터 상태를 확인하고 리더 노드를 선택할 수 있습니다

백업 복원

백업에서 복원하기를 참고하세요. 이전 버전 Edge for Private Cloud(예: 4.50 및 4.51)에서 가져온 Zakeeper 백업은 Private Cloud용 Edge의 주키퍼(Zookeeper) 4.52 버전과 호환됩니다.

Postgres 14로 업그레이드 필요

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

• Private Cloud용 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 업그레이드

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

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

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

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

이 방법을 사용하면 Edge 런타임 환경에 다운타임이 없고 분석을 위해 획득한 런타임 데이터의 손실(있는 경우)

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

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

   apigee-service apigee-qpidd stop

3. 브로커 포트 5672에서 모든 메시지 프로세서의 수신 트래픽을 방화벽입니다 이 방화벽은 Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성 요소입니다.

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

   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 주소에 동일한 단계를 수행하는 것이 좋습니다. 예를 들어 메시지 프로세서 IP 주소에서 들어오는 요청을 포트의 Qpid 노드로 삭제합니다. 5672를 사용하려면 다음과 같은 명령을 사용할 수 있습니다.

   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 파일을 다운로드해야 합니다. 롤백하려는 버전을 선택합니다 v 4.52.00으로 롤백하려면 bootstrap_4.52.00.sh를 다운로드하세요.

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

1. 기존 Qpid 브로커 중지

   apigee-service apigee-qpidd stop

2. 브로커 포트 5672에서 모든 메시지 프로세서의 수신 트래픽을 방화벽입니다 이 방화벽은 Qpid 노드 인스턴스 또는 다른 외부 방화벽/네트워크 구성 요소입니다.

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

   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와 관련된 고려사항이 나와 있습니다. 자세한 내용은 Private Cloud용 새로운 Edge UI.

Edge UI 설치

초기 설치를 완료한 후 Apigee는 Edge UI를 설치할 것을 권장합니다. 프라이빗 클라우드용 Apigee Edge의 개발자와 관리자를 위한 향상된 사용자 인터페이스입니다.

Edge UI를 사용하려면 기본 인증을 사용 중지하고 IDP(예: SAML 또는 LDAP)

자세한 내용은 새 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을 롤백하세요.

업데이트 정보 로깅

기본적으로 update.sh 유틸리티는 로그 정보를 다음 위치에 씁니다.

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

update.sh 유틸리티를 실행하는 사용자가 이 디렉터리에서는 로그를 /tmp 디렉터리에 update_username.log입니다.

사용자가 /tmp에 액세스할 수 없는 경우 update.sh 유틸리티 있습니다

다운타임 없는 업데이트

제로 다운타임 업데이트 또는 순차적 업데이트를 사용하면 표시됩니다.

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

다운타임 없이 업그레이드하려면 한 번에 하나씩 각 라우터를 로드에서 제거해야 합니다. 배급합니다 그런 다음 라우터와 동일한 컴퓨터에서 라우터 및 기타 구성 요소를 업데이트하고, 라우터를 부하 분산기에 다시 추가합니다.

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

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

• 라우터 및 메시지 프로세서 결합 노드: <ph type="x-smartling-placeholder">
  </ph>
  • 업데이트 전 – 다음을 수행합니다. <ph type="x-smartling-placeholder">
    </ph>
    1. 라우터에 연결할 수 없도록 합니다.
    2. 메시지 프로세서에 연결할 수 없도록 합니다.
  • 업데이트 후 – 다음을 수행합니다. <ph type="x-smartling-placeholder">
    </ph>
    1. 메시지 프로세서에 연결할 수 있도록 합니다.
    2. 라우터에 연결할 수 있도록 합니다.
• 단일 라우터 노드: <ph type="x-smartling-placeholder">
  </ph>
  • 업데이트하기 전에 라우터에 연결할 수 없도록 합니다.
  • 업데이트 후 라우터에 연결할 수 있도록 설정합니다.
• 단일 메시지 프로세서 노드: <ph type="x-smartling-placeholder">
  </ph>
  • 업데이트하기 전에 메시지 프로세서에 연결할 수 없도록 합니다.
  • 업데이트 후 메시지 프로세서에 연결할 수 있도록 합니다.

자동 구성 파일 사용

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

업데이트 대상 외부 인터넷이 연결된 노드에서 4.52.01

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

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

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

4. 설치에 설명된 대로 SELinux를 사용 중지합니다. Edge Apigee 설정 유틸리티를 참조하세요.
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는 업데이트할 에지 구성요소입니다. 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
        </ph>
        • 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: 동물원 사육사
      • configFile는 이전에 사용한 것과 동일한 구성 파일입니다. 에지 정의 구성요소가 포함될 수 있습니다.

      component를 설정하여 모든 구성요소에 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 저장소를 만든 후 로컬 저장소:

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

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

1. '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.52.01 저장소를 만듭니다. 위치: Edge Apigee-setup 유틸리티를 설치합니다.
2. .tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요. <ph type="x-smartling-placeholder">
   </ph>
   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

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

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

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

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

3. Nginx 웹 서버를 사용하여 apigee-service를 설치하려면 다음 안내를 따르세요. <ph type="x-smartling-placeholder">
   </ph>
   1. 'Nginx를 사용하여 저장소에서 설치'에 설명된 대로 Nginx 웹 서버를 구성합니다. webserver&quot; Install the Edge Apigee 설정 유틸리티를 참조하세요.
   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는 업데이트할 에지 구성요소입니다. 일반적으로 다음 구성요소가 포함됩니다. <ph type="x-smartling-placeholder">
     </ph>
     • 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: 동물원 사육사
   • configFile는 이전에 사용한 것과 동일한 구성 파일입니다. 에지 구성요소를 정의 4.50.00 또는 4.51.00 설치 중

   component를 설정하여 모든 구성요소에 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 및 주키퍼 노드를 업데이트해야 합니다. 실행할 수 있습니다
• 여러 에지 구성요소 (관리 서버, 메시지 프로세서, 라우터, 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 및 ZaKeeper를 업데이트합니다.

   /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 및 ZaKeeper를 업데이트합니다.

   /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를 업데이트합니다. <ph type="x-smartling-placeholder">
   </ph>
   • 기본 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

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 구성요소를 다시 시작합니다. <ph type="x-smartling-placeholder">
    </ph>
    • 기본 UI: 기본 UI를 사용하는 경우 다음 예에 표시된 것처럼 머신 1의 edge-ui 구성요소

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

    • 새 Edge UI: 새 Edge UI를 설치한 경우 적절한 시스템의 edge-management-ui 구성요소 (머신이 아닐 수도 있음) 1):

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

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

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

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

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

   /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 구성요소를 다시 시작합니다. <ph type="x-smartling-placeholder">
    </ph>
    • 기본 UI: 기본 UI를 사용하는 경우 다음 예에 표시된 것처럼 머신 1의 edge-ui 구성요소

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

    • 새 Edge UI: 새 Edge UI를 설치한 경우 적절한 시스템의 edge-management-ui 구성요소 (머신이 아닐 수도 있음) 1):

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

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

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

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

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

   /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에서 새 UI (ue) 또는 기본 UI (ui)를 업데이트합니다. 7:

   /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 구성요소를 다시 시작합니다. <ph type="x-smartling-placeholder">
    </ph>
    • 기본 UI: 기본 UI를 사용하는 경우 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 및 ZaKeeper를 업데이트합니다. <ph type="x-smartling-placeholder">
   </ph>
   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를 업데이트합니다. <ph type="x-smartling-placeholder">
   </ph>
   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 업데이트: <ph type="x-smartling-placeholder">
   </ph>
   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 구성요소를 업데이트합니다. <ph type="x-smartling-placeholder">
   </ph>
   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 업데이트: <ph type="x-smartling-placeholder">
   </ph>
   1. 데이터 센터 1의 머신 4, 5 <ph type="x-smartling-placeholder">
      </ph>
      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 <ph type="x-smartling-placeholder">
      </ph>
      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)를 업데이트합니다. <ph type="x-smartling-placeholder">
   </ph>
   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 유틸리티를 업데이트했습니다. <ph type="x-smartling-placeholder">
   </ph>
   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를 업데이트합니다. <ph type="x-smartling-placeholder">
   </ph>
   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. 새 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: '-c 에지' Qpid 서버가 있는 노드, Edge Postgres 서버, 관리 서버, 메시지 프로세서, 라우터입니다.
6. qpidd
7. Edge UI (기본 또는 새 버전)
8. apigee-adminapi
9. Apigee SSO

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