Apigee Edge 4.19.06 또는 4.50.00을 4.51.00으로 업데이트합니다.

이 섹션에서는 Apigee Edge 4.19.06 또는 4.50.00에서 4.51.00으로 업그레이드하는 방법을 설명합니다.

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

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

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

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

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

속성 설정 자동 전파

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

Postgres 10.17로 업그레이드 필요

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

대부분의 Edge 프로덕션 시스템에서는 마스터-대기 복제용으로 구성된 2개의 Postgres 노드를 사용합니다. 업데이트 프로세스 중에는 Postgres 노드가 업데이트를 위해 다운되는 동안 분석 데이터는 계속 Qpid 노드에 기록됩니다. Postgres 노드가 업데이트되고 다시 온라인 상태가 되면 애널리틱스 데이터가 Postgres 노드로 푸시됩니다.

Postgres 업데이트를 수행하는 방법은 Postgres 노드의 데이터 스토리지를 구성한 방법에 따라 다릅니다.

• Postgres 노드에 로컬 데이터 스토리지를 사용하는 경우 업그레이드 기간 동안 새 Postgres 대기 노드를 설치해야 합니다. 업그레이드가 완료되면 새 Postgres 대기 노드를 사용 중지할 수 있습니다.

  어떠한 이유로든 업데이트를 롤백해야 하는 경우에는 추가 Postgres 대기 노드가 필요합니다. 업데이트를 롤백해야 하는 경우에는 롤백 후 새 Postgres 대기 노드가 마스터 Postgres 노드가 됩니다. 따라서 새 Postgres 대기 노드를 설치할 때는 Edge 설치 요구사항에 정의된 대로 Postgres 서버의 모든 하드웨어 요구사항을 충족하는 노드에 있어야 합니다.

  Edge의 1노드 및 2노드 구성에서는 프로토타입 제작 및 테스트에 사용되는 토폴로지가 1개의 Postgres 노드만 있습니다. 새 Postgres 노드를 만들 필요 없이 이러한 Postgres 노드를 직접 업데이트할 수 있습니다.

• Apigee에서 권장하는 대로 Postgres 노드에 네트워크 스토리지를 사용하는 경우 새 Postgres 노드를 설치할 필요가 없습니다. 아래 절차에서는 새 Postgres 대기 노드를 설치하고 나중에 해제하도록 지정하는 단계를 건너뛸 수 있습니다.

  업데이트 프로세스를 시작하기 전에 Postgres에서 사용하는 데이터 저장소의 네트워크 스냅샷을 만듭니다. 그런 다음 업데이트 중에 오류가 발생하여 강제로 롤백을 수행해야 하는 경우 해당 스냅샷에서 Postgres 노드를 복원할 수 있습니다.

새 Postgres 대기 노드 설치

이 절차는 새 노드에 Postgres 대기 서버를 만듭니다. 버전 4.51.00이 아닌 기존 Edge 버전 (4.19.06 또는 4.50.00)에 새 Postgres 대기 서버를 설치해야 합니다.

설치를 수행하려면 현재 버전의 Edge를 설치하는 데 사용한 구성 파일과 동일한 구성 파일을 사용합니다.

새 Postgres 대기 노드를 만들려면 다음 안내를 따르세요.

1. 현재 Postgres 마스터에서 /opt/apigee/customer/application/postgresql.properties 파일을 수정하여 다음 토큰을 설정합니다. 이 파일이 없으면 다음과 같이 만듭니다.

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   여기서 existing_standby_ip는 현재 Postgres 대기 서버의 IP 주소이고 new_standby_ip는 새 대기 노드의 IP 주소입니다.

2. Postgres 마스터에서 apigee-postgresql를 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. 마스터의 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 파일을 보고 새 대기 노드가 추가되었는지 확인합니다. 해당 파일에 다음 줄이 표시됩니다.

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. 새 Postgres 대기 서버를 설치합니다.
   1. 현재 버전의 Edge를 설치하는 데 사용한 구성 파일을 수정하여 다음을 지정합니다.

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. Edge Apigee-setup 유틸리티 설치에 설명된 대로 SELinux를 사용 중지합니다.
   3. 업그레이드할 Edge 버전에 따라 다음 중 하나를 수행합니다.
      • Edge 4.19.06에서 업그레이드하는 경우 Edge bootstrap_4.19.06.sh 파일을 /tmp/bootstrap_4.19.06.sh 에 다운로드합니다.

        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        그런 다음 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Edge 4.50.00에서 업그레이드하는 경우 Edge bootstrap_4.50.00.sh 파일을 /tmp/bootstrap_4.50.00.sh 로 다운로드합니다.

        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        그런 다음 Edge apigee-service 유틸리티 및 종속 항목을 설치합니다.

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   4. apigee-service를 사용하여 apigee-setup 유틸리티를 설치합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. Postgres를 설치합니다.

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

   6. 새 대기 노드에서 다음 명령어를 실행합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      대기 상태임을 확인합니다.

Postgres 인플레이스(In-Place) 업그레이드 수행

Postgres 10.17로 인플레이스(In-Place) 업그레이드를 수행하려면 다음 단계를 따르세요.

1. 마스터 호스트

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

   에서 postgres 업그레이드
2. 마스터 호스트에서 설정 명령어를 실행합니다.

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. 마스터 호스트에서 구성 명령어

   apigee-service apigee-postgresql configure

   를 실행합니다.
4. 마스터 호스트를 다시 시작합니다.

   apigee-service apigee-postgresql restart

5. 이를 마스터로 구성합니다.

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. 마스터 호스트가 시작되었는지 확인합니다.

   apigee-service apigee-postgresql wait_for_ready

7. 대기를 중지합니다.

   apigee-service apigee-postgresql stop

8. 대기를 업그레이드합니다.

   참고: 이 단계에서 오류가 발생하거나 실패하면 무시할 수 있습니다. update.sh에서 잘못된 구성으로 대기 서버를 시작하려고 시도합니다. Postgres 설치가 10.17로 업그레이드되었다면 이 오류는 무시해도 됩니다.

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

9. 대기가 중지되었는지 확인합니다.

   apigee-service apigee-postgresql stop

10. 이전 대기 구성을 삭제합니다.

    rm -rf /opt/apigee/data/apigee-postgresql/

11. 대기 서버에서 복제를 설정합니다.

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

이 절차를 완료하면 대기가 성공적으로 시작됩니다.

Postgres 노드 해제

업데이트가 완료되면 새 대기 노드를 사용 중지합니다.

1. Postgres가 실행 중인지 확인합니다.

   /opt/apigee/apigee-service/bin/apigee-all status

   Postgres가 실행되고 있지 않으면 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-all start

2. 새 대기 노드에서 다음 curl 명령어를 실행하여 새 대기 노드의 UUID를 가져옵니다.

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   출력 끝에 노드의 UUID가

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

   형식으로 표시됩니다.

3. 새 대기 노드에서 다음 명령어를 실행하여 새 대기 노드를 중지합니다.

   /opt/apigee/apigee-service/bin/apigee-all stop

4. Postgres 마스터 노드에서 /opt/apigee/customer/application/postgresql.properties을 수정하여 conf_pg_hba_replication.connection에서 새 대기 노드를 삭제합니다.

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. Postgres 마스터에서 apigee-postgresql을 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. 마스터의 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 파일을 보고 새 대기 노드가 삭제되었는지 확인합니다. 이 파일에는 다음 줄만 표시됩니다.

   host replication apigee existing_standby_ip/32 trust

7. 관리 서버 노드에서 다음 에지 관리 API를 호출하여 주Keeper에서 대기 노드의 UUID를 삭제합니다.

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

기본 요건 업데이트

Apigee Edge를 업그레이드하기 전에 다음 기본 요건을 충족해야 합니다.

• 모든 노드 백업
  업데이트하기 전에 안전을 위해 모든 노드의 전체 백업을 수행하는 것이 좋습니다. 현재 버전의 Edge에 대한 절차에 따라 백업을 수행합니다.

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

• Edge가 실행 중인지 확인
  다음 명령어를 사용하여 업데이트 프로세스 중에 Edge가 실행 중인지 확인합니다.

  /opt/apigee/apigee-service/bin/apigee-all status

새로운 Edge UI

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

Edge UI 설치

초기 설치를 완료한 후 Apigee에서는 Edge UI를 설치하는 것이 좋습니다. 이 UI는 Private Cloud용 Apigee Edge의 개발자와 관리자를 위한 고급 사용자 인터페이스입니다.

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

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

Edge UI 업데이트

Edge UI 구성요소를 업데이트하려면 업그레이드할 프라이빗 클라우드의 Edge 버전을 고려하세요.

• 4.19.06 또는 4.50.00에서 4.51.00으로 (새 Edge UI가 이미 설치된 상태): edge-management-ui 구성요소에 대한 이 섹션의 업그레이드 안내를 참고하세요.

Apigee mTLS로 업데이트

Apigee mTLS를 업데이트하려면 다음 단계를 수행합니다.

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

업데이트 롤백

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

실패로 인해 업데이트를 이전 버전으로 롤백해야 하는 경우 4.51.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.19.06 또는 4.50.00을 설치하는 데 사용한 것과 동일해야 합니다.

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

노드에서 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 bootstrap_4.51.00.sh 파일을 /tmp/bootstrap_4.51.00.sh에 다운로드합니다.

   curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

8. 다음 명령어를 실행하여 Edge 4.51.00 apigee-service 유틸리티 및 종속 항목을 설치합니다.

   sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

   여기서 uName:pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

   기본적으로 설치 프로그램은 Java 1.8이 설치되어 있는지 확인합니다. 그렇지 않으면 설치 프로그램이 자동으로 설치합니다.

   JAVA_FIX 옵션을 사용하여 자바 설치 처리 방법을 지정합니다. JAVA_FIX는 다음 값을 사용합니다.

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

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

10. 다음 예시와 같이 관리 서버에서 apigee-validate 유틸리티를 업데이트합니다.

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

11. 다음 예시와 같이 관리 서버에서 apigee-provision 유틸리티를 업데이트합니다.

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

12. 다음 명령어를 실행하여 노드에서 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.19.06 또는 4.50.00 설치 중에 Edge 구성요소를 정의하는 데 사용한 구성 파일과 동일한 구성 파일입니다.

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

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

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

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

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

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

로컬 저장소에서 4.51.00으로 업데이트합니다.

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

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

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

로컬 4.51.00 저장소에서 업데이트하는 방법:

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

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

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

      tar -xzf apigee-4.51.00.tar.gz

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

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

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

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

3. NGINX 웹 서버를 사용하여 apigee-service를 설치하려면 다음 안내를 따르세요.
   1. Edge apigee-setup 유틸리티 설치의 'NGINX 웹 서버를 사용하여 저장소에서 설치'에 설명된 대로 NGINX 웹 서버를 구성합니다.
   2. 원격 노드에서 Edge bootstrap_4.51.00.sh 파일을 /tmp/bootstrap_4.51.00.sh에 다운로드합니다.

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

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

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

      sudo bash /tmp/bootstrap_4.51.00.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 New Edge UI
     • ui: 기본 Edge UI
     • zk: 사육사
   • configFile은 4.19.06 또는 4.50.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.51.00 롤백에 설명된 절차를 사용합니다.

머신 업데이트 순서

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

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

1노드 독립형 업그레이드

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,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. 머신 1에서 UI를 업데이트합니다.

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

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

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

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

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

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

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

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

5노드 업그레이드

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

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

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

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, 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. 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

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

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

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

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

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

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

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

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

5. 머신 1에서 LDAP 업데이트:

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c edge -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 및 JoKeeper를 업데이트합니다.

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

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

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

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

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

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

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

5. 머신 4와 5에서 LDAP를 업데이트합니다.

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c edge -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. 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

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

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

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

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. qpidd, ps
4. LDAP
5. Edge. Qpid 서버, Edge Postgres 서버, 관리 서버, 메시지 프로세서, 라우터가 있는 노드 순서로 모든 노드의 '-c Edge' 프로필을 의미합니다.
6. Edge UI (기본 또는 신규)
7. apigee-adminapi
8. Apigee SSO

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