이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Apigee Edge 4.52.02 롤백

Edge 4.52.02로 업데이트하는 중에 오류가 발생하면 오류를 일으킨 구성요소를 롤백한 후 업데이트를 다시 시도할 수 있습니다.

Edge 4.52.02를 다음 주요 출시 버전 중 하나로 롤백할 수 있습니다.

버전 4.52.01
버전 4.52.00
버전 4.51.00

버전을 롤백하려면 업그레이드했을 수 있는 모든 구성요소를 롤백해야 합니다. 또한 시작한 버전에 따라 특정 소프트웨어 구성요소를 롤백하기 전에 특별한 단계를 고려해야 할 수도 있습니다. 다음 표에는 롤백 중에 특수한 단계가 필요할 수 있는 다양한 소프트웨어 구성요소가 나와 있습니다.

버전으로 롤백	소프트웨어에 대한 특별 고려사항
4.52.01	Cassandra
4.52.00	Zookeeper, Cassandra, Qpid
4.51.00	Zookeeper, Postgres, Cassandra, Qpid

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

이전 메이저 또는 마이너 버전으로 롤백합니다. 예를 들어 4.52.02에서 4.52.00으로 업그레이드할 수 있습니다.
동일한 출시의 이전 패치 버전으로 롤백합니다. 예를 들어 4.52.00.02에서 4.52.00.01로 변경할 수 있습니다.

자세한 내용은 Apigee Edge 출시 프로세스를 참고하세요.

롤백 순서

구성요소 롤백은 업그레이드의 역순으로 진행해야 합니다. 단, 관리 서버는 Cassandra 후에 롤백해야 합니다. Cassandra, 런타임 구성요소, 관리 서버는 모두 데이터 센터별 (DC-by-DC) 접근 방식을 사용하여 롤백해야 하며, 이때 일시적으로 트래픽을 작동하는 데이터 센터로 리디렉션해야 합니다.

프라이빗 클라우드 4.52.02의 일반적인 일반 롤백 순서는 다음과 같습니다.

단일 데이터 센터

단일 데이터 센터 설정의 경우 롤백 프로세스가 런타임 트래픽 및 특정 관리 API에 상당한 영향을 미칩니다.

Qpid 및 기타 분석 관련 구성요소 롤백
롤백 라우터 및 메시지 프로세서
Cassandra 롤백
롤백 관리 서버
Postgres 및 Zookeeper 롤백

여러 데이터 센터

다중 데이터 센터 설정의 경우 롤백은 작동하는 데이터 센터로 일시적으로 트래픽을 리디렉션하는 데이터 센터별 (DC-by-DC) 접근 방식을 따라야 합니다. 이렇게 하면 트래픽 연속성이 보장되고 다운타임이 방지되며 Cassandra, 관리 서버, 런타임 노드의 제어된 롤백 프로세스가 가능합니다.

모든 DC에서 Qpid 및 기타 분석 관련 구성요소를 롤백합니다.
첫 번째 데이터 센터에서 트래픽을 차단하고 트래픽을 다른 데이터 센터로 다시 라우트합니다.
첫 번째 데이터 센터에서 라우터와 메시지 프로세서를 롤백합니다.
첫 번째 데이터 센터에서 Cassandra를 롤백합니다.
첫 번째 데이터 센터의 롤백 관리 서버
첫 번째 데이터 센터에서 트래픽을 차단 해제하고 마지막 데이터 센터에서 런타임 노드, Cassandra, 관리 서버가 롤백될 때까지 2단계부터 6단계를 따릅니다.
모든 DC에서 Postgres, Zookeeper, LDAP를 롤백합니다.

예를 들어 전체 Cassandra 클러스터, 모든 관리 서버, 일부 런타임 메시지 프로세서 (RMP)를 버전 4.52.01에서 4.52.02로 업그레이드한 후 롤백해야 한다고 가정해 보겠습니다. 이 경우 다음과 같이 롤백을 실행해야 합니다.

첫 번째 데이터 센터 (데이터 센터)로의 트래픽을 차단하고 다른 활성 DC로 트래픽을 다시 라우팅하여 서비스 연속성을 보장합니다.
첫 번째 데이터 센터에서 라우터 및 메시지 프로세서를 롤백합니다.
백업 또는 VM 스냅샷에서 복원하여 첫 번째 데이터 센터에서 Cassandra를 롤백합니다.
첫 번째 데이터 센터에서 관리 서버를 롤백합니다.
첫 번째 데이터 센터로 가는 트래픽을 차단 해제합니다.
모든 런타임 노드, Cassandra, 관리 서버가 롤백될 때까지 남은 각 데이터 센터에 대해 1~5단계를 반복합니다.

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

롤백을 실행하는 사용자는 원래 Edge를 업데이트한 사용자 또는 root로 실행 중인 사용자와 동일해야 합니다.

기본적으로 Edge 구성요소는 'apigee' 사용자로 실행됩니다. 경우에 따라 Edge 구성요소를 다른 사용자로 실행할 수 있습니다. 예를 들어 라우터가 권한이 있는 포트(예: 1,000 미만의 포트)에 액세스해야 하는 경우 라우터를 루트로 실행하거나 이러한 포트에 액세스할 수 있는 사용자로 실행해야 합니다. 또는 한 구성요소는 한 사용자로 실행하고 다른 구성요소는 다른 사용자로 실행할 수도 있습니다.

공통 코드가 있는 구성요소

다음 Edge 구성요소는 공통 코드를 공유합니다. 따라서 노드에서 이러한 구성요소 중 하나를 롤백하려면 해당 노드에 있는 이러한 구성요소를 모두 롤백해야 합니다.

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

예를 들어 노드에 관리 서버, 라우터, 메시지 프로세서가 설치된 경우, 그중 하나를 롤백하려면 세 가지 모두를 롤백해야 합니다.

Cassandra 롤백

특정 Cassandra 노드에서 Cassandra의 주요 업그레이드가 실행되면 Cassandra는 노드에 저장된 데이터의 스키마를 수정하여 직접 롤백할 수 없게 됩니다. 롤백에는 두 가지 방법이 있습니다. 롤백하려는 업그레이드의 상태에 따라 이러한 방법 중 하나를 사용합니다.

롤백 방법론

롤백 시나리오

Edge for Private Cloud 4.52.02에는 Cassandra 및 메시지 프로세서와 관리 서버가 Cassandra에 연결하는 데 사용하는 드라이버의 업그레이드가 포함되어 있습니다. 따라서 이러한 세 가지 구성요소의 업그레이드와 롤백은 서로 밀접하게 연결되어 있습니다. 아래 표에는 이러한 세 가지 구성요소의 롤백 시나리오에 관한 일반적인 예시가 나와 있습니다. 다른 구성요소를 롤백할 때는 롤백 순서 섹션에 따라야 합니다.

이 섹션에서는 위에 설명된 접근 방식에 따라 따라야 하는 권장 방법과 함께 다양한 롤백 시나리오를 간략히 설명합니다.

시나리오	롤백 전략
단일 데이터 센터, 일부 Cassandra 노드 업그레이드됨	백업 복원
단일 데이터 센터, 모든 Cassandra 노드 업그레이드됨	백업 복원
단일 데이터 센터, 모든 노드 (Cassandra, 관리 서버, 런타임 노드) 업그레이드됨	런타임 노드 롤백 Cassandra 백업 복원 관리 롤백
여러 데이터 센터, 첫 번째 데이터 센터의 일부/모든 Cassandra 노드가 업그레이드됨	기존 데이터 센터에서 다시 빌드하기
여러 데이터 센터, 모든 Cassandra 노드, 첫 번째 데이터 센터의 관리 서버 및 런타임 노드가 업그레이드됨	런타임 노드 롤백 Cassandra 재빌드 복원 관리 롤백 한 번에 하나의 데이터 센터에서만 실행해야 합니다.
여러 데이터 센터, 마지막 데이터 센터의 일부/모든 Cassandra 노드가 업그레이드됨	백업을 사용하여 마지막 데이터 센터 롤백 백업 또는 재빌드를 사용하여 한 번에 하나씩 나머지 데이터 센터를 롤백합니다.
여러 데이터 센터, 모든 Cassandra 노드, 모든 DC에서 업그레이드된 관리 서버 및 런타임 노드	런타임 노드 롤백 Cassandra 백업 복원 관리 롤백 한 번에 하나의 데이터 센터에서만 실행해야 합니다.

일반적으로 Cassandra를 롤백할 때는 다음 사항을 고려해야 합니다.

런타임 또는 관리 구성요소 롤백
데이터 센터 (DC)에서 Edge 관리 서버 또는 Edge 메시지 프로세서와 같은 구성요소를 이전 Edge Private Cloud 버전으로 롤백해야 하는 경우 해당 데이터 센터에서 Cassandra도 동시에 롤백해야 합니다. 이는 관리 및 런타임 트래픽 실패를 방지하기 위해 필요합니다.
백업을 사용하여 롤백
Cassandra 3.11.x에서 가져온 백업은 Cassandra 2.1.x의 백업과 호환되지 않습니다. 백업 복원을 사용하여 롤백을 사용 설정하려면 업그레이드를 실행하기 전에 Cassandra 2.1.x의 백업을 수행해야 합니다.
롤백을 위해 데이터 센터 격리
다운타임을 방지하려면 트래픽이 완전히 작동하는 데이터 센터로 리디렉션되고 롤백이 진행 중인 데이터 센터에서는 차단되도록 합니다.

빌드 재생성을 사용하여 Cassandra 롤백

기본 요건

여러 데이터 센터에서 Edge for Private Cloud 4.51.00 / 4.52.00 / 4.52.01 클러스터를 운영하고 있습니다.
Cassandra를 2.1.X에서 3.11.X로 업그레이드하는 중이며 업그레이드 중에 문제가 발생함
클러스터에 이전 버전의 Cassandra (Cassandra 2.1.X)를 사용하는 완전히 작동하는 데이터 센터가 1개 이상 있습니다.

대략적인 단계

롤백할 데이터 센터 (부분적으로 또는 완전히 업그레이드됨)를 하나 선택합니다. 이 데이터 센터의 모든 애플리케이션 트래픽을 완전히 작동하는 다른 데이터 센터로 리디렉션합니다.
라우터 및 메시지 프로세서가 업그레이드된 경우 데이터 센터의 모든 라우터 및 메시지 프로세서 노드를 한 번에 하나씩 롤백합니다.
한 노드에서 Cassandra를 중지하고 제거한 후 모든 관련 데이터를 정리합니다.
이전 버전 부트스트랩을 설치하고 정리된 노드에서 Cassandra 버전 2.1.x를 설정합니다.
아직 Cassandra 2.1.x를 실행 중인 기존의 작동하는 데이터 센터에서 노드를 다시 빌드합니다.
데이터 센터의 나머지 각 Cassandra 노드에서 3~5단계를 한 번에 하나씩 실행합니다.
데이터 센터에서 관리 서버 설정을 다시 실행합니다.
롤백을 확인하기 위한 테스트를 실행합니다. 확인되면 애플리케이션 트래픽을 복원된 데이터 센터로 다시 리디렉션합니다.
롤백이 필요한 다른 데이터 센터에 대해 위 단계를 한 번에 하나씩 반복합니다.

클러스터에서 기존 노드를 삭제하고 이를 사용하여 노드를 다시 빌드하는 세부 단계는 다음과 같습니다.

롤백하려는 노드로 시작합니다.

다음 단계를 진행하기 전에 트래픽이 완전히 작동하는 데이터 센터로 리디렉션되는지 확인합니다.
라우터 및 메시지 프로세서가 업그레이드된 경우 데이터 센터의 모든 라우터 및 메시지 프로세서 노드를 이전 버전으로 롤백합니다(한 번에 하나씩).

노드에서 Cassandra를 중지합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

노드에서 Cassandra 소프트웨어를 제거합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

노드에서 데이터 디렉터리를 삭제합니다.
```
rm -rf /opt/apigee/data/apigee-cassandra
```
롤백하려는 이전 버전의 Edge Private Cloud 부트스트랩을 다운로드하여 실행합니다.

예: 4.52.01로 롤백

4.52.01의 부트스트랩을 다운로드합니다.

curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

4.52.01의 부트스트랩을 실행합니다.

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

노드에 Cassandra 소프트웨어를 설치합니다.
```
apigee-service apigee-cassandra install
```

/opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh 파일에 아래 속성을 추가합니다.

JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

예:

JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

노드에서 Cassandra를 설정합니다.
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
```
참고: Cassandra 설정에 실패하면 /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh 파일을 수정하고 JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"가 포함된 줄을 삭제합니다. 이렇게 변경한 후 위의 setup.sh 스크립트를 다시 실행하여 설정을 다시 시도합니다.
Cassandra가 UP AND RUNNING 상태가 되면 아래 파일(/opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh 파일)에서 위의 CWC를 삭제합니다.
Cassandra 노드 다시 시작
```
apigee-service apigee-cassandra restart
```

작동하는 데이터 센터의 이름을 제공하여 노드에서 리빌드를 실행합니다.

/opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

예:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

데이터 센터에서 롤백하려는 각 노드에 대해 위 단계를 한 번에 하나씩 반복합니다.

데이터 센터의 모든 Cassandra 노드가 롤백되고 다시 빌드되면

롤백되는 데이터 센터에서 관리 서버 노드 설정을 실행합니다. 관리 서버가 롤백된 버전인지 확인합니다. 그렇지 않은 경우 관리 서버도 롤백합니다.

관리 서버를 이전 버전으로 롤백

관리 서버를 중지합니다.

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

수익 창출을 사용하는 경우 수익 창출도 제거합니다.

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

edge-gateway 및 apigee-cassandra-client를 제거합니다.

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall

이전 버전의 부트스트랩을 다운로드하여 실행합니다. 예를 들어 다음 단계를 실행하여 버전 4.52.01의 부트스트랩을 다운로드하고 실행합니다.
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
```
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```

관리 서버 설정

관리 서버 노드 1개의 설정을 실행합니다.

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

위 단계를 완료한 후 트래픽을 롤백된 데이터 센터로 다시 리디렉션합니다.

빌드 후 최적화

위 단계에서 리빌드 중에 노드의 모든 데이터가 원격 데이터 센터에서 스트리밍됩니다. 모든 복제본이 로컬 데이터 센터로 스트리밍된 후 복구를 사용하여 이 프로세스를 최적화할 수 있습니다. 이렇게 하면 교차 데이터 센터 스트리밍이 방지되며 원격 데이터 센터에서 모든 노드를 다시 빌드하는 것보다 빠릅니다.

예: 로컬 데이터 센터에 Cassandra 노드가 6개 있다고 가정해 보겠습니다. 기본적으로 Apigee의 복제 인수는 3이므로 모든 노드가 데이터의 50% 를 보유합니다. 이 경우 위의 절차에 따라 노드 1과 4를 다시 빌드할 수 있습니다. 노드 2, 3, 5, 6의 경우 아래 단계에 따라 백업을 복원하고 수리를 실행합니다.

문서에 설명된 대로 위 단계까지 절차를 따라 로컬 데이터 센터에서 복제본을 다시 빌드합니다.
나머지 노드의 경우 각 노드에 대해 아래 단계를 하나씩 따르세요.

이 노드에서 캡처한 백업을 복원합니다 (참고: 이 백업은 Cassandra 업그레이드를 시작하기 전에 캡처되었으므로 오래된 데이터가 있을 수 있음).
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
```
노드의 VM 스냅샷이 있는 경우 Cassandra 백업을 복원하는 대신 스냅샷을 복원할 수 있습니다.
백업이 복원된 후 노드에서 Cassandra 서비스를 시작합니다.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
```

기존 데이터 센터에서 최신 데이터를 스트리밍할 수 있도록 노드에서 수리를 실행합니다.

/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

예:

/opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

수리하려는 각 노드에서 2단계에 언급된 위의 모든 단계를 반복합니다.

백업 / VM 스냅샷을 사용하여 Cassandra 롤백

이 절차는 전체 Cassandra 클러스터를 업그레이드한 후 롤백하려는 경우에만 사용할 수 있습니다. 또한 Apigee 백업은 노드별로 이루어집니다. 한 노드에서 만든 백업을 다른 노드로 복원할 수는 없습니다. Cassandra 백업에는 노드 메타데이터 정보 (예: IP 주소, 링 위치 등)가 포함됩니다.

기본 요건

마지막 데이터 센터에서 Cassandra를 2.1.X에서 3.11.X로 업그레이드하는 중이며 업그레이드 중에 문제가 발생했습니다.
롤백하려는 업그레이드 전 노드의 백업이 있습니다. 2.1.X에서 3.11.X로 업그레이드하기 전에 백업이 진행되었습니다.

대략적인 단계

롤백할 데이터 센터 (부분 업그레이드 또는 전체 업그레이드)를 선택합니다. 이 데이터 센터의 모든 런타임 트래픽을 완전히 작동하는 다른 데이터 센터로 리디렉션합니다.
라우터 및 메시지 프로세서가 업그레이드된 경우 데이터 센터의 모든 라우터 및 메시지 프로세서 노드를 한 번에 하나씩 롤백합니다.
한 노드에서 Cassandra를 중지하고 제거한 후 모든 관련 데이터를 정리합니다.
이전 버전 부트스트랩을 설치하고 정리된 노드에서 Cassandra 버전 2.1.x를 설정합니다.
Cassandra 노드를 중지하고 모든 관련 데이터를 정리합니다.
업그레이드 전에 찍은 백업에서 Cassandra 노드를 복원합니다.
데이터 센터의 나머지 Cassandra 노드에 대해 3~6단계를 한 번에 하나씩 반복합니다.
데이터 센터에서 관리 서버 설정을 다시 실행합니다.
테스트를 실행하여 롤백을 검증합니다. 확인되면 런타임 트래픽을 복원된 데이터 센터로 다시 리디렉션합니다.
롤백이 필요한 다른 데이터 센터에 대해 위 단계를 한 번에 하나씩 반복합니다.
(선택사항) 데이터 센터 간에 데이터 불일치가 있는 경우 모든 데이터 센터의 모든 Cassandra 노드에서 수리 명령어를 실행합니다.

백업/VM 스냅샷을 사용하여 Cassandra를 롤백하는 자세한 단계

클러스터에서 Cassandra 노드 1개로 시작

다음 단계를 진행하기 전에 트래픽이 완전히 작동하는 데이터 센터로 리디렉션되는지 확인합니다.
라우터 및 메시지 프로세서가 업그레이드된 경우 데이터 센터의 모든 라우터 및 메시지 프로세서 노드를 이전 버전으로 한 번에 하나씩 롤백합니다.

노드에서 Cassandra를 중지합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

노드에서 Cassandra 소프트웨어를 제거합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

노드에서 데이터 디렉터리를 삭제합니다.
```
rm -rf /opt/apigee/data/apigee-cassandra
```
롤백하려는 이전 버전의 Edge Private Cloud 부트스트랩을 다운로드하여 실행합니다.

예: 4.52.01로 롤백하기

4.52.01의 부트스트랩을 다운로드합니다.

curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

4.52.01의 부트스트랩을 실행합니다.

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

노드에서 Cassandra를 설정합니다.

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

노드에서 Cassandra를 중지합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

노드에서 데이터 디렉터리를 삭제합니다.
```
rm -rf /opt/apigee/data/apigee-cassandra/data
```

백업 복원:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

노드에서 Cassandra 서비스 시작

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

각 Cassandra 노드에서 단계를 한 번에 하나씩 반복합니다.
롤백되는 데이터 센터에서 관리 서버 노드 설정을 실행합니다. 관리 서버가 롤백된 버전인지 확인합니다. 그렇지 않은 경우 관리 서버도 롤백합니다.
위 단계를 완료한 후 트래픽을 롤백된 데이터 센터로 다시 리디렉션합니다.
(선택사항) 데이터 센터 간에 데이터 불일치가 있는 경우 모든 데이터 센터의 모든 Cassandra 노드에서 수리 명령어를 실행합니다.
```
/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
```

Zookeeper 3.8.3 업데이트 롤백

버전 4.52.00 또는 4.51.00으로 롤백하는 경우 Zookeeper를 롤백하기 전에 몇 가지 특별한 단계를 참고해야 합니다. 이 단계는 롤백에 나와 있습니다.

버전 4.52.01로 롤백하는 경우 아래 이전 주요 버전 또는 부 버전으로 롤백 섹션에 나와 있는 대로 소프트웨어를 롤백하는 것처럼 Zookeeper를 롤백합니다.

Qpid 롤백

버전 4.52.00 또는 4.51.00으로 롤백하는 경우 Qpid를 롤백하기 전에 몇 가지 특별한 단계를 참고해야 합니다. 이 단계는 롤백에 나와 있습니다.

버전 4.52.01로 롤백하는 경우 이전 주요 버전 또는 부 버전으로 롤백에 나열된 소프트웨어를 롤백하는 것처럼 Qpid를 롤백합니다.

Postgres 10.17 업데이트 롤백

버전 4.51.00으로 롤백하는 경우 Postgres를 롤백하기 전에 몇 가지 특별한 단계를 참고해야 합니다. 이 단계는 롤백에 나와 있습니다.

버전 4.52.01 또는 4.52.00으로 롤백하는 경우 아래의 이전 주요 또는 부 버전으로 롤백 섹션에 나와 있는 대로 소프트웨어를 롤백하는 것처럼 Postgres를 롤백합니다.

이전 메이저 또는 마이너 버전으로 롤백

이전 주요 또는 마이너 버전으로 롤백하려면 구성요소를 호스팅하는 각 노드에서 다음을 실행합니다.

롤백하려는 버전의 bootstrap.sh 파일을 다운로드합니다.
- 4.51.00으로 롤백하려면 bootstrap_4.51.00.sh을 다운로드하세요.

구성요소를 중지하여 롤백합니다.

노드에서 공통 코드가 있는 구성요소를 롤백하려면 다음 예와 같이 모두 중지해야 합니다.

/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

노드의 기타 구성요소를 롤백하려면 해당 구성요소만 중지합니다.
```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

수익 창출을 롤백하는 경우 모든 관리 서버 및 메시지 프로세서 노드에서 수익 창출을 제거합니다.
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
노드에서 롤백할 구성요소를 제거합니다.
1. 노드에서 공통 코드가 있는 구성요소를 롤백하려면 다음 예와 같이 edge-gateway 및 apigee-cassandra-client 구성요소 그룹을 제거하여 모두 제거해야 합니다.
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
```
2. 노드의 다른 구성요소를 롤백하려면 다음 예와 같이 해당 구성요소만 제거합니다.
```
/opt/apigee/apigee-service/bin/apigee-service component uninstall
```
  여기서 component은 구성요소 이름입니다.
3. Edge 라우터를 롤백하려면 edge-gateway 구성요소 그룹을 제거하는 것 외에도 /opt/nginx/conf.d 파일의 콘텐츠를 삭제해야 합니다.
```
cd /opt/nginx/conf.d
rm -rf *
```

apigee-setup의 4.52.02 버전을 제거합니다.

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

apigee-service 유틸리티의 4.51.00 버전과 종속 항목을 설치합니다. 다음 예에서는 apigee-service의 4.51.00 버전을 설치합니다.
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
여기서 uName 및 pWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

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

apigee-setup을 설치합니다.

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

이전 버전의 구성요소를 설치합니다.
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
여기서 component는 설치할 구성요소이고 configFile는 이전 버전의 구성 파일입니다.
Qpid를 롤백하는 경우 iptables를 플러시합니다.
```
sudo iptables -F
```
롤백하려는 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.

이전 패치 버전으로 롤백

구성요소를 특정 패치 출시로 롤백하려면 구성요소를 호스팅하는 각 노드에서 다음을 실행합니다.

특정 구성요소 버전을 다운로드합니다.
```
/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 component
```
예를 들면 다음과 같습니다.
```
yum --showduplicates list edge-ui
```
apigee-setup을 사용하여 구성요소를 설치합니다.
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
예를 들면 다음과 같습니다.
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
구성요소를 설치할 때는 버전이 아닌 구성요소 이름만 지정합니다.
롤백하려는 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.

mTLS 롤백

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

Apigee 중지:
```
apigee-all stop
```
mTLS를 중지합니다.
```
apigee-service apigee-mtls uninstall
```

mTLS를 재설치합니다.

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