Apigee Edge 4.53.00 롤백

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

Edge 4.53.00을 다음과 같은 마이너 버전으로 롤백할 수 있습니다.

  • 버전 4.52.02

버전을 롤백하려면 업그레이드했을 수 있는 모든 구성요소를 롤백해야 합니다. 또한 Cassandra를 버전 4.52.02로 롤백할 때는 특별한 고려사항을 고려해야 합니다.

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

  1. 이전 메인 또는 마이너 버전으로 롤백합니다. 예를 들어 4.53.00에서 4.52.02로 업그레이드할 수 있습니다.
  2. 동일한 출시의 이전 패치 출시로 롤백합니다. 예를 들어 4.53.00.01에서 4.53.00.00으로 업그레이드할 수 있습니다.

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

롤백 순서

구성요소는 업그레이드된 순서의 역순으로 롤백해야 합니다. 단, 관리 서버는 Cassandra 다음에 롤백해야 합니다.

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

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

예를 들어 전체 Cassandra 클러스터, 모든 관리 서버, 일부 RMP를 버전 4.52.02에서 버전 4.53.00으로 업그레이드한 후 롤백하려고 한다고 가정해 보겠습니다. 이 경우 다음을 수행합니다.

  1. 모든 RMP를 하나씩 롤백
  2. 백업을 사용하여 전체 Cassandra 클러스터 롤백
  3. Edge 관리 서버 노드를 하나씩 롤백

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

롤백을 실행하는 사용자는 원래 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 Private Cloud 4.53.00에서 사용할 수 있는 Cassandra 4.0.X는 Private Cloud 4.52.02의 다른 구성요소와 호환됩니다.

사용할 수 있는 다양한 롤백 전략의 요약은 아래 표를 참고하세요.

시나리오 롤백 전략
단일 데이터 센터, 일부 Cassandra 노드 업그레이드됨 백업 사용하기
단일 데이터 센터, 모든 Cassandra 노드 업그레이드됨 Cassandra를 롤백하지 마세요. 다른 구성요소는 롤백할 수 있습니다.
단일 DC, 모든 노드 (Cassandra 및 기타) 업그레이드됨 Cassandra를 롤백하지 마세요. 다른 구성요소는 롤백할 수 있습니다.
여러 DC, 한 DC의 일부 노드 업그레이드됨 기존 DC에서 다시 빌드
여러 데이터 센터, 일부 데이터 센터의 모든 Cassandra 노드가 업그레이드됨 기존 DC에서 다시 빌드
여러 데이터 센터, 업그레이드 중인 마지막 데이터 센터의 Cassandra 노드 업그레이드를 완료해 보세요. 불가능하다면 백업을 사용하여 1대의 DC를 롤백합니다. 롤백된 DC에서 나머지 DC를 다시 빌드합니다.
여러 데이터 센터, 모든 Cassandra 노드 업그레이드됨 Cassandra를 롤백하지 마세요. 다른 구성요소는 롤백할 수 있습니다.
여러 데이터 센터, 모든 노드 (Cassandra 및 기타) 업그레이드됨 Cassandra를 롤백하지 마세요. 다른 구성요소는 롤백할 수 있습니다.

일반적인 고려사항

롤백을 고려할 때는 다음 사항에 유의하세요.

  • 런타임 또는 관리 구성요소 롤백: edge-management-server, edge-message-processor와 같은 구성요소 또는 Cassandra가 아닌 구성요소를 프라이빗 클라우드 버전 4.52.02로 롤백하려면 Cassandra를 롤백하지 않는 것이 좋습니다. Private Cloud 4.53.00과 함께 제공되는 Cassandra는 Private Cloud 4.52.02의 Cassandra가 아닌 모든 구성요소와 호환됩니다. Cassandra가 버전 4.0.13으로 유지되는 동안 여기에 나열된 방법을 사용하여 Cassandra가 아닌 구성요소를 롤백할 수 있습니다.
  • 전체 Cassandra 클러스터가 4.0.X로 업그레이드된 후 롤백: 프라이빗 클라우드 버전 4.53.00으로 업그레이드하는 과정에서 전체 Cassandra 클러스터가 버전 4.0.X로 업그레이드된 경우 이 클러스터 설정을 계속하고 Cassandra를 롤백하지 않는 것이 좋습니다. 프라이빗 클라우드 버전 4.52.02의 edge-management-server, edge-message-processor, edge-router와 같은 구성요소는 Cassandra 버전 4.0.X와 호환됩니다.
  • Cassandra 업그레이드 중 Cassandra 롤백: Cassandra 업그레이드 중에 문제가 발생하면 롤백을 고려해 볼 수 있습니다. 이 도움말에 나열된 롤백 전략은 업그레이드 프로세스 중 현재 상태에 따라 따를 수 있습니다.
  • 백업을 사용한 롤백: Cassandra 4.0.X에서 가져온 백업은 Cassandra 3.11.X의 백업과 호환되지 않습니다. 백업 복원을 사용하여 Cassandra를 롤백하려면 업그레이드를 시도하기 전에 Cassandra 3.11.X의 백업을 수행해야 합니다.

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

기본 요건

  • 여러 데이터 센터에서 Edge for Private Cloud 4.52.02 클러스터를 운영하고 있습니다.
  • Cassandra를 3.11.X에서 4.0.X로 업그레이드하는 중이며 업그레이드 중에 문제가 발생했습니다.
  • 클러스터에 이전 버전의 Cassandra (Cassandra 3.11.X)를 계속 실행하는 완전히 작동하는 데이터 센터가 하나 이상 있습니다.

이 절차는 기존 데이터 센터의 스트리밍 데이터를 사용합니다. Cassandra에 저장된 데이터의 양에 따라 상당한 시간이 걸릴 수 있습니다. 롤백이 진행되는 동안 런타임 트래픽을 이 데이터 센터에서 다른 곳으로 전환할 준비를 해야 합니다.

대략적인 단계

  1. 롤백할 데이터 센터 (부분적으로 또는 완전히 업그레이드됨)를 하나 선택합니다. 런타임 트래픽을 작동하는 다른 데이터 센터로 전환합니다.
  2. 데이터 센터에서 시드 노드를 식별하고 시드 노드 중 하나로 시작합니다.
  3. Cassandra 노드를 중지, 제거, 정리합니다.
  4. 노드에 이전 버전의 Cassandra를 설치하고 필요에 따라 구성합니다.
  5. 이전에 추가된 추가 구성을 삭제합니다.
  6. 데이터 센터의 모든 시드 노드에 대해 위 단계를 하나씩 반복합니다.
  7. 데이터 센터의 나머지 모든 Cassandra 노드에 대해 위 단계를 하나씩 반복합니다.
  8. 기존의 작동하는 데이터 센터에서 노드를 하나씩 다시 빌드합니다.
  9. Cassandra에 연결된 데이터 센터의 모든 edge-* 구성요소를 다시 시작합니다.
  10. 트래픽을 테스트하고 이 데이터 센터로 다시 전환합니다.
  11. 각 데이터 센터에 대해 이 단계를 하나씩 반복합니다.

세부 단계

  1. 일부 또는 모든 Cassandra 노드가 업그레이드된 데이터 센터를 하나 선택합니다. 이 데이터 센터의 Cassandra 노드가 롤백되는 동안 이 데이터 센터에서 모든 런타임 프록시 트래픽과 관리 트래픽을 전환합니다. 노드에서 nodetool ring 명령어를 실행할 때 모든 Cassandra 노드가 UN (작동/정상) 상태인지 확인합니다. 특정 노드가 다운된 경우 문제를 해결하고 해당 노드를 다시 가동한 후 계속 진행합니다.

    아래 예시를 참고하세요.

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    노드에서 nodetool describecluster를 실행하여 전체 클러스터의 현재 상태를 파악할 수 있습니다. 예를 들어 다음은 모든 DC-1 노드가 Cassandra 버전 4를 사용하는 반면 모든 DC-2 노드가 Cassandra 버전 3을 사용하는 2개 데이터 센터 클러스터의 인스턴스를 보여줍니다.

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. 데이터 센터의 시드 노드 식별: 부록의 시드 노드 식별 방법 섹션을 참고하세요. 시드 노드 중 하나에서 다음 단계를 실행합니다.
  3. Cassandra 노드에서 데이터를 중지, 제거, 정리합니다. 이 데이터 센터의 Cassandra 버전 4에서 첫 번째 시드 노드를 선택합니다. 그만해. 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. 노드에 이전 Cassandra 소프트웨어를 설치하고 일부 구성을 설정합니다. Edge Private Cloud 4.52.02의 부트스트랩 파일을 실행합니다. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

Cassandra 구성 설정

  1. /opt/apigee/customer/application/cassandra.properties 파일을 만들거나 수정합니다.
  2. 파일에 다음 내용을 추가합니다. ipOfNode는 Cassandra가 다른 Cassandra 노드와 통신하는 데 사용하는 노드의 IP 주소입니다. 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  3. apigee 사용자가 파일을 소유하고 읽을 수 있는지 확인합니다. 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. Cassandra를 설치하고 설정합니다.
    • Cassandra 버전 3.11.X를 설치합니다. 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • 표준 구성 파일( 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
      )을 전달하여 Cassandra를 설정합니다.
    • Cassandra 3.11.X가 설치되어 있고 서비스가 실행 중인지 확인합니다. 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. 노드가 시작되었는지 확인합니다. 이 노드와 클러스터의 다른 노드에서 다음 명령어를 확인합니다. 노드가 'UN' (작동/정상) 상태라고 보고해야 합니다. 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. 앞서 /opt/apigee/customer/application/cassandra.properties 파일에 추가된 추가 구성을 삭제합니다.
  7. 데이터 센터의 모든 Cassandra 시드 노드에서 3~6단계를 하나씩 반복합니다.
  8. 데이터 센터의 나머지 모든 Cassandra 노드에 대해 3~6단계를 하나씩 반복합니다.
  9. 이전 Cassandra 버전을 실행하는 데이터 센터에서 데이터 센터의 모든 노드를 다시 빌드합니다. 이 단계를 한 번에 하나씩 노드를 수행합니다. 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    이 절차는 다소 시간이 걸릴 수 있습니다. 필요한 경우 streamingthroughput를 조정할 수 있습니다. 다음을 사용하여 상태를 확인합니다. 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. 데이터 센터의 모든 edge-* 구성요소를 하나씩 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  11. 트래픽을 검증하고 이 데이터 센터로 다시 전환합니다. 이 데이터 센터에서 런타임 트래픽 및 관리 API에 대한 유효성 검사를 실행하고 프록시 및 관리 API 트래픽을 다시 이 데이터 센터로 라우트하기 시작합니다.
  12. 롤백하려는 각 데이터 센터에 대해 위 단계를 반복합니다.

백업을 사용하여 Cassandra 롤백

기본 요건

  1. Cassandra를 3.11.X에서 4.0.X로 업그레이드하는 중이며 업그레이드 중에 문제가 발생했습니다.
  2. 롤백할 노드의 백업이 있습니다. 3.11.X에서 4.0.X로 업그레이드하기 전에 백업이 진행되었습니다.

단계

  1. 롤백할 노드를 하나 선택합니다. 백업을 사용하여 데이터 센터의 모든 노드를 롤백하는 경우 먼저 시드 노드로 시작합니다. 부록의 '시드 노드를 식별하는 방법' 섹션을 참고하세요.

  2. Cassandra 노드를 중지, 제거, 정리합니다.

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. 노드에 이전 Cassandra 소프트웨어를 설치하고 구성합니다.

    • Edge Private Cloud 4.52.02의 부트스트랩 파일을 실행합니다.
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • /opt/apigee/customer/application/cassandra.properties 파일을 만들거나 수정합니다.
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • 파일이 apigee 사용자의 소유이며 읽을 수 있는지 확인합니다.
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • Cassandra를 설치하고 설정합니다.
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    노드가 시작되었는지 확인합니다. 이 노드와 클러스터의 다른 노드에서 다음 명령어를 확인합니다. 노드는 이 노드가 'UN' 상태라고 보고해야 합니다.

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. Cassandra 서비스를 중지하고 백업을 복원합니다. 자세한 내용은 백업 및 복원 문서를 참고하세요.

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. 백업이 복원되면 추가 구성을 삭제합니다.

    /opt/apigee/customer/application/cassandra.properties 파일에서 앞서 추가한 구성을 삭제합니다.

  6. 노드에서 Cassandra 서비스를 시작합니다.

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

  7. 백업을 사용하여 롤백하려는 각 Cassandra 노드에서 단계를 한 번에 하나씩 반복합니다.

  8. 모든 Cassandra 노드가 복원되면 모든 edge-* 구성요소를 하나씩 다시 시작합니다.

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

백업 최적화 (고급 옵션)

최신 데이터가 포함된 복제본을 사용할 수 있는 경우 백업을 복원하는 동안 데이터 손실을 최소화하거나 제거할 수 있습니다. 복제본을 사용할 수 있는 경우 백업을 복원한 후 복원된 노드에서 수리를 실행합니다.

부록

시드 노드를 식별하는 방법

데이터 센터의 Cassandra 노드에서 다음 명령어를 실행합니다.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

이 명령어는 여러 줄을 출력합니다. 출력의 마지막 줄을 찾습니다. 마지막 줄에 나열된 IP 주소가 시드 노드입니다. 아래 예에서 DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2는 시드 노드 IP입니다.

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

이전 주요 버전 또는 부 버전으로 롤백

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

  1. 롤백하려는 버전의 bootstrap.sh 파일을 다운로드합니다.

    • 4.52.02로 롤백하려면 bootstrap_4.52.02.sh를 다운로드하세요. 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. 구성요소를 중지하여 롤백합니다.
    1. 노드에서 공통 코드가 있는 구성요소를 롤백하려면 다음 예와 같이 모두 중지해야 합니다. 
      /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
    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 라우터를 롤백하려면 edge-gateway 구성요소 그룹을 제거하는 것 외에도 /opt/nginx/conf.d 파일의 콘텐츠를 삭제해야 합니다. 
      cd /opt/nginx/conf.d
rm -rf *
  5. apigee-setup 4.53.00 버전을 제거합니다. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service 유틸리티의 4.52.02 버전과 종속 항목을 설치합니다. 다음 예에서는 apigee-service의 4.52.02 버전을 설치합니다. 
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

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

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

  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를 롤백하는 경우 iptables를 플러시합니다. 
    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.53.00-0.0.20254 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. 롤백하는 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.

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