Apigee Edge 4.52.01 롤백

Edge 4.52.01로 업데이트하는 동안 오류가 발생하면 구성요소를 제거한 다음 업데이트를 다시 시도하세요.

Edge 4.52.01을 다음 주 출시 버전으로 롤백할 수 있습니다.

• 버전 4.52.00
• 버전 4.51.00

롤백을 실행해야 하는 두 가지 시나리오가 있습니다.

1. 이전 메인 또는 마이너 버전으로 롤백합니다. 예를 들어 4.52.01에서 4.52.00으로 업그레이드할 수 있습니다.
2. 동일한 출시의 이전 패치 출시로 롤백합니다. 예: 4.52.00.02에서 4.52.00.01까지

자세한 내용은 Apigee Edge 출시 버전을 참조하세요. 절차에 따라 다릅니다.

롤백을 수행할 수 있는 사용자

롤백을 수행하는 사용자는 Edge를 처음 업데이트한 사용자와 동일해야 합니다. 루트로 실행 중인 사용자

기본적으로 Edge 구성요소는 사용자 'Apigee'로 실행됩니다. 경우에 따라 Edge 구성요소를 다른 사용자로 실행할 수 있습니다. 예를 들어, 라우터가 루트 또는 액세스 권한이 있는 사용자로서 라우터를 실행해야 합니다. 있습니다 또는 하나의 구성 요소를 한 사용자로, 다른 구성 요소를 다른 사용자로 실행할 수 있습니다.

공통 코드가 있는 구성요소

다음 Edge 구성요소는 공통 코드를 공유합니다. 따라서 해당 노드에 있는 모든 구성요소를 롤백해야 합니다.

• edge-management-server (관리 서버)
• edge-message-processor(메시지 프로세서)
• edge-router (라우터)
• edge-postgres-server(Postgres 서버)
• edge-qpid-server (Qpid 서버)

예를 들어, 컴퓨터에 관리 서버, 라우터 및 메시지 프로세서가 설치되어 있고 이러한 노드 중 하나를 롤백하려면 세 가지 노드 모두를 롤백해야 합니다.

이전 주 또는 부 출시 버전으로 롤백

이전의 주 또는 부 출시 버전으로 롤백하려면 구성요소:

1. 롤링할 버전의 bootstrap.sh 파일을 다운로드합니다. 뒤로:

   • 4.51.00으로 롤백하려면 bootstrap_4.51.00.sh를 다운로드합니다.

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

2. 롤백할 구성요소를 중지합니다.
   1. 공통 코드가 있는 구성요소를 다음 예와 같이 노드를 모두 중지해야 합니다. <ph type="x-smartling-placeholder">

      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

      </ph>
   2. 노드의 기타 구성요소를 롤백하려면 해당 구성요소만 중지합니다.

      • /opt/apigee/apigee-service/bin/apigee-service component stop

3. 수익 창출을 롤백하는 경우 모든 관리 서버 및 메시지에서 제거하세요. 프로세서 노드:

   /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall

4. 노드에서 롤백할 구성요소를 제거합니다.
   1. 공통 코드가 있는 구성요소를 edge-gateway 구성요소를 제거하여 모두 제거해야 합니다. 다음 예와 같이 표시됩니다.

      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall

   2. 노드의 다른 구성요소를 롤백하려면 해당 구성요소만 제거합니다. 다음 예는 다음과 같습니다.

      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      여기서 component은 구성요소 이름입니다.

   3. Edge Router를 롤백하려면 /opt/nginx/conf.d 파일을 삭제하기만 하면 됩니다. edge-gateway 구성요소 그룹: <ph type="x-smartling-placeholder">

      cd /opt/nginx/conf.d
      rm -rf *

      </ph>
5. apigee-setup의 4.52.01 버전을 제거합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

6. apigee-service의 4.51.00 버전을 설치합니다. 유틸리티와 그 종속 항목이 포함되어 있습니다 다음 예는 apigee-service:

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

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

   오류가 발생하면 단계에서 bootstrap.sh 파일을 다운로드했는지 확인하세요. 1.

7. apigee-setup를 설치합니다.

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

8. 이전 버전의 구성요소를 설치합니다.

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

   여기서 component는 설치할 구성요소이고 configFile는 구성 파일을 엽니다.

9. Qpid를 롤백하는 경우 iptable을 삭제합니다.

   sudo iptables -F

10. 롤백하는 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.

이전 패치 출시로 롤백

구성요소를 특정 패치 출시로 롤백하려면 각 노드에서 다음을 수행합니다. 다음과 같습니다.

1. 특정 구성요소 버전을 다운로드합니다.

   /opt/apigee/apigee-service/bin/apigee-service component_version install

   여기서 component_version는 설치할 구성요소 및 패치 출시입니다. 예:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

   Apigee 온라인 저장소를 사용하는 경우 사용 가능한 구성요소를 확인할 수 있습니다. 사용하여 버전을 관리할 수 있습니다

   yum --showduplicates list comp

   예를 들면 다음과 같습니다.

   yum --showduplicates list edge-ui

2. apigee-setup를 사용하여 구성요소를 설치합니다.

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

   예를 들면 다음과 같습니다.

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

   구성요소를 설치할 때는 버전이 아닌 구성요소 이름만 지정합니다.

3. 롤백할 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.

Postgres 10.17 업데이트 롤백

버전 4.50.00 또는 4.51.00에서 4.52.01로 업그레이드한 경우 Edge 구성요소 외에도 Postgres가 업데이트됩니다.

마스터-대기 구성에서 Postgres를 업데이트할 때 Postgres 업데이트를 롤백하려면 다음 안내를 따르세요.

• 새 대기 노드를 Postgres 마스터가 되도록 승격합니다. 새 Postgres 마스터는 동일한 버전으로 업데이트할 수 있습니다
• 이전 대기 노드를 새 마스터의 대기 노드로 구성합니다. 이전 대기 노드 이전 Edge 설치와 동일한 버전입니다.
• 애널리틱스 및 소비자 그룹에 새 마스터 및 대기 노드를 등록합니다.

롤백이 완료되면 이전 마스터 노드가 더 이상 필요하지 않습니다. 다음을 수행할 수 있습니다. 이전 마스터 노드를 사용 중지합니다.

1. 새 대기 Postgres 노드가 실행 중인지 확인합니다.

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

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

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

2. 이전 마스터 노드와 이전 대기 노드에서 Postgres가 중지되었는지 확인합니다.

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

   Postgres가 실행 중이면 중지합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

3. 설치된 경우 이전 대기 노드에서 Qpid를 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

4. 새 대기 노드를 Postgres 마스터로 승격합니다.
   1. 새 대기 노드를 새 마스터로 승격합니다. <ph type="x-smartling-placeholder">

      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      </ph>

      메시지가 표시되면 'Apigee'의 Postgres 비밀번호를 입력합니다. 기본 사용자이며 "postgres"라는 두 가지 메서드를 가지고 있습니다.

   2. 현재 버전의 Edge를 설치하는 데 사용한 구성 파일을 수정하여 지정합니다. 다음과 같습니다.

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   3. 새 마스터를 구성합니다.
      

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile

5. 이전 대기 노드를 이미 새 버전으로 업그레이드한 경우 먼저 이전 대기 노드에서 Apigee 소프트웨어를 다운그레이드합니다 이전 기기에 여전히 이전 버전이 있는 경우 대기 노드의 경우 이 단계를 건너뛰고 6단계로 계속 진행할 수 있습니다.
   1. 이전 대기 노드에서 Postgres를 중지합니다.

      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop

   2. 이전 대기 노드에서 Postgres를 제거합니다.

      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall

   3. 이전 대기 노드에서 Postgres 데이터 디렉터리를 삭제합니다.

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   4. 이전 버전 부트스트랩 다운로드 및 실행 (롤링 중인 Apigee 버전용) 다시 돌아가야 합니다 정확한 단계는 인터넷 기반 설치를 사용하는지 또는 오프라인 설치를 사용하는지에 따라 다를 수 있습니다. 이전 버전의 Apigee 부트스트랩을 실행하면 이전 버전의 Apigee 데이터로 yum 저장소를 설정했습니다.
   5. 이전 대기 노드에 Postgres 구성요소를 설정합니다.

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

   6. 이전 대기 노드에서 Postgres 구성요소 확인 및 확인 이전 버전으로 롤백되었습니다.

      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version

6. 이전 대기 노드를 다시 빌드합니다.
   1. 현재 버전의 Edge를 설치하는 데 사용한 구성 파일을 수정하여 지정합니다. 다음과 같습니다.

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   2. 이전 대기 노드에서 데이터 디렉터리를 삭제합니다.

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   3. 이전 대기 노드를 새 마스터의 대기 노드로 재구성합니다.

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. Postgres가 이전 대기 노드에서 실행 중인지 확인합니다.

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

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

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

7. 새 마스터의 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 파일
8. 다음 명령어를 실행하여 현재 분석 및 소비자 그룹 정보를 봅니다. 를 클릭합니다.

   curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

   이 명령어는 name 필드에 애널리틱스 그룹 이름을 반환합니다. consumer-groups 아래 name 필드에 소비자 그룹 이름을 입력합니다. 또한 는 이전 Postgres 마스터 노드와 대기 노드의 UUID를 postgres-server 필드 및 datastores 필드에 각각 입력됩니다. 다음과 같이 표시됩니다. 다음과 같은 형식으로 출력됩니다.

   {
     "name" : "axgroup-001",
     "properties" : {
     },
     "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
     "uuids" : {
       "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "postgres-server" : [
         "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
       ]
     },
     "consumer-groups" : [ {
       "name" : "consumer-group-001",
       "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "datastores" :
         [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
         "properties" : {     }
       }
     ],
     "data-processors" : {
     }
   }

9. 다음 curl 명령어를 실행하여 이전 마스터의 UUID 주소를 가져옵니다. 이전 마스터 노드의 경우:

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

   출력 끝에 노드의 UUID가 다음과 같은 형식으로 표시됩니다.

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

10. 이전 단계를 반복하여 이전 대기 노드와 새 대기 노드의 IP 주소를 가져옵니다. 있습니다.
11. 소비자 그룹에서 이전 마스터 및 대기 노드를 삭제합니다.

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    여기서 axgroup-001 및 consumer-group-001는 분석 및 소비자 그룹의 기본 이름입니다. masterUUID,standbyUUID는 위에서 현재 분석 및 소비자 그룹 정보를 볼 때 표시된 순서와 동일합니다. 나 standbyUUID,masterUUID로 지정해야 할 수 있습니다.

    이제 consumer-groups의 datastores 속성이 비어 있어야 합니다.

12. 분석 그룹에서 이전 마스터 및 대기 노드를 삭제합니다.

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    이제 uuids 아래의 postgres-server 속성이 비어 있습니다.

13. 새 PG 마스터 및 대기 노드를 애널리틱스 및 소비자 그룹에 등록합니다.
    

    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

14. 분석 그룹을 확인합니다.

    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    분석 그룹에 새 마스터 노드 및 대기 노드의 UUID가 표시됩니다. 소비자 그룹이 있습니다

15. 에지 관리 서버를 다시 시작합니다.

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

16. 모든 Qpid 서버를 다시 시작합니다.

    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

17. 모든 Postgres 서버를 다시 시작합니다.

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

18. 두 서버에서 다음 스크립트를 실행하여 복제 상태를 확인합니다. 시스템 복제가 성공적으로 이루어지도록 두 서버에 동일한 결과가 표시되어야 합니다.

    새 마스터에서 다음을 실행합니다.

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

    마스터인지 확인합니다. 이전 대기 노드에서 다음을 수행합니다.

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

    대기 상태인지 확인합니다.

19. 여러 API 요청을 한 후 이전 단계를 반복하여 노드가 싱크입니다.
20. 다음 절차에 따라 이전 Postgres 마스터를 사용 중단합니다. 서비스를 사용 중단하여 Postgres 노드입니다.

    또는 이전 마스터에서 Qpid를 제거하고 새 마스터 노드에 Qpid 설치하기 Qpid를 제거한 후 이전 마스터 노드와 연결되어 있어야 합니다

mTLS 롤백

mTLS 업데이트를 롤백하려면 모든 호스트에서 다음 단계를 수행합니다.

1. Apigee 중지:

   apigee-all stop

2. mTLS 중지:

   apigee-service apigee-mtls uninstall

3. mTLS를 재설치합니다.

   apigee-service apigee-mtls install
   apigee-service apigee-mtls setup -f /opt/silent.conf