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

Apigee는 Private Cloud용 Edge를 버전 4.51.00, 4.52.00 또는 4.52.01에서 버전 4.52.02로 직접 업그레이드할 수 있도록 지원합니다. 이 페이지에서는 이러한 업그레이드를 수행하는 방법을 설명합니다.

업데이트를 수행할 수 있는 사용자

업데이트를 실행하는 사용자는 Edge를 처음 설치한 사용자 또는 루트로 실행하는 사람과 동일해야 합니다.

Edge RPM을 설치하면 누구나 구성할 수 있습니다.

업데이트해야 하는 구성요소

모든 Edge 구성요소를 업데이트해야 합니다. Edge는 여러 버전의 구성요소가 포함된 설정을 지원하지 않습니다.

기본 요건 업데이트

Apigee Edge를 업그레이드하기 전에 다음 기본 요건을 확인하세요.

  • 모든 노드 백업
    업데이트하기 전에 안전을 위해 모든 노드를 완전히 백업하는 것이 좋습니다. 현재 사용 중인 Edge 버전의 절차에 따라 백업을 수행하세요.

    이렇게 하면 새 버전으로의 업데이트가 제대로 작동하지 않을 경우를 대비해 백업 계획을 세울 수 있습니다. 백업에 관한 자세한 내용은 백업 및 복원을 참고하세요.

  • Edge가 실행 중인지 확인
    다음 명령어를 사용하여 업데이트 프로세스 중에 Edge가 실행 중인지 확인합니다. 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Cassandra 압축 전략이 LeveledCompactionStrategy인지 확인
    Cassandra 압축 전략 변경에 설명된 대로 Cassandra 압축 전략이 LeveledCompactionStrategy로 설정되어 있는지 확인합니다.

업그레이드를 위해 고려해야 할 특별 단계

Private Cloud용 Edge 4.52.02로 업그레이드하려면 특정 소프트웨어를 업그레이드하는 특정 단계를 실행하는 것이 좋습니다. 필요한 단계는 현재 버전에 따라 다릅니다. 추가 단계가 필요한 다양한 소프트웨어는 아래 표를 참고하세요. 이 페이지의 이후 섹션에서는 각 소프트웨어에 대한 자세한 설명과 정확한 단계를 제공합니다.

현재 버전 4.52.02로 업그레이드하려면 특별한 단계가 필요한 소프트웨어
4.52.01 Cassandra
4.52.00 Cassandra, 주키퍼, Qpid
4.51.00 Cassandra, 동물원, Qpid, Postgres

속성 설정 자동 전파

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

Cassandra 3.11.16으로 업그레이드 필요

Private Cloud용 Apigee Edge 4.52.02에는 Cassandra의 버전 3.11.16 업그레이드가 포함되어 있습니다. Cassandra는 Apigee의 중요한 구성요소입니다. 이 업그레이드에는 Cassandra를 쿼리하고 작성하는 데 사용되는 다양한 런타임 및 관리 구성요소의 드라이버 소프트웨어 업데이트도 포함되어 있습니다.

이 업그레이드는 주요 업그레이드이므로 최신 버전에서 최적의 성능을 보장하기 위해 Cassandra에서 Apigee의 데이터 모델을 일부 변경해야 했습니다. 이러한 변경사항은 아주 적지만 업그레이드 프로세스로 인해 특정 관리 API가 중단되어 Apigee UI와 개발자 포털 모두에 영향을 미칩니다. 아래 문서에서는 작동하지 않는 정확한 API를 명시하고 중단이 시작되고 종료되는 경우 업그레이드 도중의 단계를 간략히 설명합니다. 무엇보다도 업그레이드 중에 런타임 트래픽이 중단되지 않아야 합니다.

대략적인 롤백

한 번에 한 노드씩 Cassandra 업그레이드를 적용합니다. 노드가 업데이트되는 즉시 직접 롤백할 수 없는 특정 스키마 변경사항이 적용됩니다. 클러스터 업그레이드 양에 따라 다양한 기술을 사용할 수 있으므로 롤백에 대한 섹션을 꼼꼼히 읽어보세요.

Cassandra 클러스터 전체가 업그레이드된 후 업그레이드를 롤백해야 하는 경우 유일한 옵션은 백업을 복원하는 것입니다. 이에 대비하고 Cassandra 백업 복원에 익숙해지세요. Apigee 백업보다 빠르게 VM 수준 스냅샷을 복원할 수 있는 경우 VM 스냅샷을 사용하여 Cassandra VM을 이전 상태로 복원하세요.

자세한 내용은 Cassandra 3.11.16 업데이트 롤백 섹션을 참조하세요.

개발자 포털의 API 문서화

Apigee Drupal 개발자 포털은 API 문서화를 위한 다양한 기능을 제공합니다. Drupal 7 기반 개발자 포털 사용을 중단하는 것이 좋지만, 아직 이 포털을 사용하고 있고 SmartDocs 기능을 사용하고 있다면 SmartDocs API 사용 문서가 적용됩니다. 최신 버전의 개발자 포털을 사용하는 경우에는 이번 업그레이드 중에 API 문서에 영향을 미치지 않습니다.

Apigee를 버전 4.52.02로 업그레이드해도 Drupal 7 개발자 포털의 SmartDocs 기능을 사용하여 만든 API 모델은 최신 버전으로 자동 마이그레이션되지 않습니다. 개발자 포털을 사용하여 각 모델을 수동으로 내보내고 업그레이드를 완료한 후 다시 가져와야 합니다.

다음 섹션에서 사용되는 용어

런타임: 런타임에는 런타임 프록시 트래픽 처리가 포함됩니다. 여기에는 기존 프록시에 대한 런타임 API 요청을 효과적으로 처리하기 위해 라우터와 메시지 프로세서에서 수행하는 모든 작업이 포함됩니다. 하지만 새 프록시 배포나 새 프록시 버전은 포함되지 않습니다.

관리: 관리에는 Apigee Edge 시스템 관리가 포함됩니다. 여기에는 앱, 제품, 대상 서버, 키 저장소의 배포, 수정 등이 포함되며 이에 국한되지 않습니다. 모든 관리 API (및 Apigee UI 및 개발자 포털과 같은 클라이언트)가 이 범위에 포함됩니다.

아래의 각 단계에서는 업그레이드 절차의 여러 단계를 진행하는 동안 런타임 및 관리 상태에 대해 설명합니다. 업그레이드 중에는 런타임 트래픽에는 영향을 미치지 않습니다. 그러나 관리 API 및 개발자 포털 기능의 일부 하위 집합에 장애가 발생합니다.

0단계: 시작 상태

  1. 버전 2.1.22로 실행되는 Apigee의 Cassandra
  2. Private Cloud용 Edge 4.52.02 구성요소:
    • 이전의 Thrift 프로토콜을 통해 Cassandra와 통신하는 관리 서버입니다.
    • 이전의 드리프트 프로토콜을 통해 Cassandra와 통신하는 런타임 서버 (메시지 프로세서 및 라우터)
이 단계의 런타임 상태 이 단계의 관리 상태
정상적으로 작동하는 런타임 완전한 기능을 갖춘 관리

1단계: 업그레이드 준비하기

아래 단계는 구성요소 업그레이드를 사용 설정하기 위한 Apigee의 표준 구성 파일과 같이 일반적으로 생성하는 표준 파일에 추가로 추가됩니다.

  1. LeveledCompactionStrategy를 사용하도록 Cassandra를 변경합니다.
  2. Apigee를 사용하여 Cassandra를 백업합니다.
  3. Cassandra 노드의 VM 스냅샷을 촬영합니다 (가능한 경우).
  4. /opt/apigee/apigee-cassandra/cass_upgrade.conf의 각 Cassandra 노드에서 다음 콘텐츠로 Cassandra 업그레이드 구성 파일을 만듭니다. 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    /opt/apigee/apigee-cassandra/cass_upgrade.conf에서 파일을 만들 수 없는 경우 각 Cassandra 노드에서 동일한 콘텐츠로 /opt/silent.conf 파일을 만듭니다.
  • Apigee Drupal 7 개발자 포털의 SmartDocs 기능을 사용하는 경우 개발자 포털 UI에서 JSON 형식으로 모델을 다운로드하여 각 모델을 내보내기하세요. 관리 서버를 업데이트한 후에 이러한 모델을 Apigee로 다시 가져와야 합니다.
  • 아직 없는 경우 모든 Private Cloud용 Edge 4.52.02 구성요소에서 Cassandra 노드까지 포트 9160 및 9042에 액세스할 수 있는지 확인하세요. 자세한 내용은 포트 요구사항을 참고하세요.

2단계: 모든 Cassandra 노드 업그레이드

  1. 모든 리전의 모든 Cassandra 노드를 하나씩 업그레이드합니다. 각 노드에서 다음 명령어를 실행합니다. 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. 노드가 업데이트되면 계속 진행하기 전에 노드에서 다음 명령어를 실행하여 일부 검증을 실행합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. 위의 출력은 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
    줄을 따라 출력됩니다.
이 단계의 런타임 상태 이 단계의 관리 상태
정상적으로 작동하는 런타임 Cassandra가 업그레이드되면 다음 관리 기능이 저하됩니다.

3단계: 모든 관리 노드 업그레이드

모든 리전의 모든 관리 노드를 하나씩 업그레이드합니다.

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
런타임 상태 관리 상태
정상적으로 작동하는 런타임 Management API의 성능이 저하됨:

3a단계: [선택사항] 이전에 내보낸 SmartDocs 가져오기

모든 관리 서버가 업그레이드되면 1단계에서 내보낸 SmartDocs 모델을 가져올 수 있습니다. 나중에 이 작업을 수행할 수도 있습니다.

런타임 상태 관리 상태
정상적으로 작동하는 런타임 완전한 기능을 갖춘 관리

4단계: 모든 런타임 노드 업그레이드

모든 리전의 모든 라우터 및 메시지 프로세서 노드를 하나씩 업그레이드합니다.

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
런타임 상태 관리 상태
정상적으로 작동하는 런타임 완전한 기능을 갖춘 관리

5단계: Private Cloud의 나머지 모든 Edge 4.52.02 구성요소 업그레이드

모든 리전의 남은 모든 edge-qpid-server 및 edge-postgres-server 노드를 하나씩 업그레이드합니다.

이 단계에서 Private Cloud용 Edge 4.52.01 이전 버전에서 업그레이드하고 Qpid 또는 Postgres 업그레이드를 위한 추가 단계를 따르는 경우 각 단계에 따라 동일하게 업그레이드하세요.

런타임 상태 관리 상태
정상적으로 작동하는 런타임 완전한 기능을 갖춘 관리

6단계: 업그레이드 후 단계

업그레이드가 완료된 후 각 Cassandra 노드에서 다음 명령어를 하나씩 실행합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

다음 명령어를 실행하여 Cassandra 클러스터에서 사용되지 않는 이전 테이블을 삭제합니다. 이 작업이 실행되기 전에는 Cassandra의 특정 기능 (예: 새로운 인증 설정 - 이전의 인증 메커니즘은 계속 작동함)을 사용할 수 없습니다. 이 명령어는 클러스터의 노드 1개에서만 실행할 수 있습니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

아직 완료하지 않았다면 3a단계를 완료합니다.

런타임 상태 관리 상태
정상적으로 작동하는 런타임 완전한 기능을 갖춘 관리

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

Private Cloud용 Edge 4.52.02에는 주키퍼로의 업그레이드가 포함되어 있지 않지만, 4.52.01 이전 버전에서 업그레이드하는 경우 다음 단계에 따라 주키퍼를 업그레이드해야 합니다.

  • Private Cloud용 Edge 버전 4.51.00 또는 4.52.00에서 업그레이드하는 경우 Zookeeper 3.8.3으로 업그레이드 필요의 단계에 따라 주키퍼를 업그레이드하세요.
  • Private Cloud용 Edge 버전 4.52.01에서 업그레이드하는 경우 이미 주키퍼 버전 3.8.3을 사용 중이어야 하며, 주키퍼를 업그레이드하기 위한 특별한 단계를 따를 필요는 없습니다.

Postgres 14로 업그레이드 필요

  • Private Cloud용 Edge 4.51.00에서 4.52.02로 업그레이드하는 경우 Private Cloud용 Edge 4.52.02에 Postgres 업그레이드가 포함되지 않더라도 단계에 따라 Postgres를 업그레이드해야 합니다. Private Cloud용 Edge 4.51.00에서 4.52.02로 업그레이드하려면 추가 Postgres 업그레이드 단계가 필요합니다. Postgres 14로의 필수 업그레이드 섹션을 참고하세요.
  • Private Cloud용 Edge 4.52.00 또는 4.52.01에서 4.52.02로 업그레이드하는 경우 추가 Postgres 업그레이드 단계가 필요하지 않습니다.

Qpid J-Broker로 업그레이드 필요

Private Cloud용 Edge 4.52.02에 QPID로의 업그레이드가 포함되어 있지 않더라도 4.52.01 이전 버전에서 업그레이드하는 경우 단계에 따라 QPID를 업그레이드해야 합니다.

  • Private Cloud용 Edge 4.51.00 또는 4.52.00에서 4.52.02로 업그레이드하는 경우 추가 QPID 업그레이드 단계를 따라야 합니다. 버전 4.51.00 또는 4.52.00에서 4.52.02로 업그레이드하는 경우 Qpid 업그레이드 섹션을 참조하세요.
  • Private Cloud용 Edge 4.52.01에서 4.52.02로 업그레이드하는 경우 이미 최신 버전의 Qpid 브로커를 사용하고 있을 것이므로 추가 QPID 업그레이드 단계가 필요하지 않습니다.

새로운 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 버전을 고려하세요.

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. 설치 중인 나머지 머신의 업데이트를 계속합니다.

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

자동 구성 파일 사용

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

외부 인터넷이 연결된 노드에서 4.52.02로 업데이트

다음 절차에 따라 노드에서 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.02.sh 파일을 /tmp/bootstrap_4.52.02.sh에 다운로드합니다. 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. 다음 명령어를 실행하여 Edge 4.52.02 apigee-service 유틸리티 및 종속 항목을 설치합니다. 
      sudo bash /tmp/bootstrap_4.52.02.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는 업데이트할 에지 구성요소입니다. 가능한 값은 다음과 같습니다.
        • 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.02 롤백에 설명된 절차를 따르세요.

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

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

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

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

로컬 4.52.02 저장소에서 업데이트하려면 다음 안내를 따르세요.

  1. Edge Apigee-setup 유틸리티 설치의 '로컬 Apigee 저장소 만들기'에 설명된 대로 로컬 4.52.02 저장소를 만듭니다.
  2. .tar 파일에서 apigee-service를 설치하려면 다음 안내를 따르세요.
    1. 로컬 저장소가 있는 노드에서 다음 명령어를 사용하여 로컬 저장소를 /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz이라는 단일 .tar 파일로 패키징합니다. 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Edge를 업데이트할 노드에 .tar 파일을 복사합니다. 예를 들어 새 노드의 /tmp 디렉터리에 복사합니다.
    3. 새 노드에서 /tmp 디렉터리로 파일의 압축을 풉니다. 
      tar -xzf apigee-4.52.02.tar.gz

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

    4. /tmp/repos에서 Edge apigee-service 유틸리티와 종속 항목을 설치합니다. 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Nginx 웹 서버를 사용하여 apigee-service를 설치하려면 다음 안내를 따르세요.
    1. Edge apigee-setup 유틸리티 설치의 'Nginx 웹 서버를 사용하여 저장소에서 설치하기'에 설명된 대로 Nginx 웹 서버를 구성합니다.
    2. 원격 노드에서 Edge bootstrap_4.52.02.sh 파일을 /tmp/bootstrap_4.52.02.sh에 다운로드합니다. 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      여기서 uName:pWord는 이전에 저장소에 설정한 사용자 이름과 비밀번호이고 remoteRepo는 저장소 노드의 IP 주소 또는 DNS 이름입니다.

    3. 원격 노드에서 Edge apigee-setup 유틸리티 및 종속 항목을 설치합니다. 
      sudo bash /tmp/bootstrap_4.52.02.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는 업데이트할 에지 구성요소입니다. 일반적으로 다음 구성요소를 업데이트합니다.
      • cs: Cassandra
      • 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 /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.02 롤백에 설명된 절차를 따르세요.

머신 업데이트 순서

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

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

1노드 독립형 업그레이드

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

  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를 업데이트합니다.
    • 기본 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 및 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 구성요소를 다시 시작합니다.
    • 기본 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 및 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 및 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 및 ZaKeeper를 업데이트합니다.
    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

      3. 여기서 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 구성요소를 다시 시작해야 합니다.