구성요소 재설치 및 복원

이 문서에서는 Edge 구성요소의 재설치 및 복원에 대해 설명합니다. 백업을 복원하기 전에 Edge 구성요소를 다시 설치해야 하는 경우 이 절차를 사용하세요.

Apache ZooKeeper

하나의 독립형 노드 복원

1. ZooKeeper를 중지합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. 이전 ZooKeeper 디렉터리를 삭제합니다.

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. ZooKeeper를 다시 설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. ZooKeeper 복원:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 접두사나 '.tar.gz' 접미사도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에서 가장 최근 백업 파일을 사용합니다.

5. 모든 구성요소를 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-all restart

클러스터 노드 1개 복원

앙상블의 일부인 단일 ZooKeeper 노드가 실패하면 동일한 호스트 이름/IP 주소로 새 노드를 만들고 ZooKeeper를 다시 설치할 수 있습니다. 새 ZooKeeper 노드가 ZooKeeper 앙상블에 조인되면 리더로부터 최신 스냅샷을 가져와 클라이언트에 제공하기 시작합니다. 이 인스턴스에서는 데이터를 복원할 필요가 없습니다.

1. ZooKeeper를 재설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. 원래 노드를 설치할 때 사용한 것과 동일한 구성 파일을 사용하여 ZooKeeper 노드에서 설정을 실행합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. ZooKeeper를 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

전체 클러스터 복원

1. 전체 클러스터를 중지합니다.
2. 단일 노드에 대해 위에서 설명한 대로 백업 파일에서 모든 ZooKeeper 노드를 복원합니다.
3. ZooKeeper 클러스터를 시작합니다.
4. 모든 구성요소를 다시 시작합니다.

Apache Cassandra

하나의 독립형 노드 복원

1. Cassandra를 중지합니다.

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

2. 이전 Cassandra 디렉터리를 삭제합니다.

   /opt/apigee/data/apigee-cassandra

3. Cassandra를 다시 설치합니다.

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. Cassandra를 복원합니다.

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 프리픽스 또는 '.tar.gz' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에서 가장 최근 백업 파일을 사용합니다.

5. 모든 구성요소를 다시 시작합니다.
   

   /apigee/apigee-service/bin/apigee-all restart

클러스터 노드 하나 복원

앙상블에 속한 단일 Cassandra 노드가 실패하면 동일한 호스트 이름/IP 주소로 새 노드를 만들 수 있습니다. Cassandra를 다시 설치하고 몇 가지 추가 단계를 따르기만 하면 됩니다. 백업에서 데이터를 복원할 필요가 없습니다. 다른 노드에서 사용할 수 있는 복제본을 사용하여 장애가 발생한 노드의 데이터를 복원할 수 있습니다. 이 단계는 일반적으로 하드웨어 오작동 등으로 인해 Cassandra 클러스터의 노드가 다운되는 경우에 적용됩니다.

장애가 발생한 노드에 더 이상 액세스할 수 없는 경우 노드를 폐기하고 네트워크를 격리하여 실수로 Cassandra 클러스터에 다시 참여하지 않도록 합니다. 그런 다음 원본 노드와 동일한 IP 주소로 새 노드를 가져와서 일반적인 Apigee 부트스트랩 단계를 실행합니다.

노드에 계속 액세스할 수 있고 이를 재사용하려면 다음 단계를 수행합니다.

1. 노드에서 Cassandra 프로세스를 중지합니다.
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. 노드에서 Cassandra 소프트웨어를 제거합니다.
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. 노드에서 데이터 디렉터리를 완전 삭제합니다.
   rm -rf /opt/apigee/data/apigee-cassandra

위 단계를 완료하면 실패한 노드와 동일한 IP 주소를 가진 노드가 생성되고 Apigee 소프트웨어 설치를 위한 준비가 완료됩니다. 다음 단계를 따르세요.

1. 데이터 센터의 시드 노드를 식별합니다.
   1. 복원 중인 노드와 동일한 데이터 센터의 운영 Cassandra 노드에서 다음 명령어를 실행합니다.

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. 다음과 같은 결과가 출력됩니다.

      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, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. 출력의 마지막 줄을 참고하세요. 쉼표로 구분된 IP 주소는 이 데이터 센터의 노드에서 사용되는 시드 노드입니다.
2. 복원되는 새 노드에서 다음 파일을 만들거나 수정합니다.
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. 이 노드가 시드 노드 중 하나인 경우 (1단계의 시드 노드 목록에 노드의 IP 주소가 표시됨) 파일에 다음 줄을 추가합니다.
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. 예를 들어 위의 인스턴스에서 시드 목록에는 10.1.0.1과 10.1.0.2라는 두 개의 IP가 있습니다. 복원되는 노드가 10.1.0.1인 경우 다음과 같은 줄을 추가합니다.
      

      conf_cassandra_seeds="10.1.0.2"

5. 파일을 저장하고 Apigee 사용자가 소유하고 읽을 수 있는지 확인합니다.
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Cassandra 소프트웨어를 설치합니다.
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. Cassandra 설정을 실행합니다.
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. 설정은 내부적으로 Cassandra 서비스를 부트스트랩하려고 시도합니다. 다른 노드에서 스트리밍할 데이터의 양, 네트워크 처리량 등에 따라 시간이 오래 걸릴 수 있습니다.
9. [고급 옵션] 노드에서 다음 nodetool 명령어를 실행하여 데이터 스트리밍을 신속하게 처리할 수 있습니다.
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Cassandra 노드가 다시 가동되면 아래와 같은 표준 명령어를 사용하여 노드가 링에 성공적으로 조인했는지 확인합니다.
    

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

11. 노드가 성공적으로 실행 중인지 확인한 후 /opt/apigee/customer/application/cassandra.properties 파일을 다시 수정하고 이 절차의 3단계와 4단계에서 이전에 추가한 줄을 삭제합니다.
12. 노드에서 Cassandra 서비스를 다시 시작합니다.
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

전체 클러스터 복원

1. 전체 클러스터를 중지합니다.
2. 백업 파일에서 모든 Cassandra 노드를 복원합니다.
3. Cassandra 클러스터를 시작합니다.
4. 모든 구성요소를 다시 시작합니다.

PostgreSQL 데이터베이스

독립형 또는 마스터로 실행되는 PostgreSQL

1. 모든 노드에서 관리 서버, Qpid 서버, Postgres 서버를 중지합니다.

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

2. PostgreSQL 데이터베이스를 다시 설치합니다.

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. PostgreSQL을 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. 백업 파일에서 PostgreSQL 데이터베이스를 복원합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   PostgreSQL 구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 '.dump' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에서 가장 최근 백업 파일을 사용합니다.

5. 모든 노드에서 관리 서버, Qpid 서버, Postgres 서버를 시작합니다.

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

대기 모드로 실행되는 PostgreSQL

1. PostgreSQL 데이터베이스를 다시 설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. 설치에 사용한 것과 동일한 구성 파일을 사용하여 PostgreSQL 데이터베이스를 재구성합니다.
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. PostgreSQL을 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Postgres 서버

1. 모든 마스터 및 대기 노드에서 Postgres 서버를 중지합니다.

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

2. 오래된 Postgres 서버 디렉터리를 삭제합니다.

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. Postgres 서버를 다시 설치합니다.

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

4. 백업 파일에서 Postgres 서버를 복원합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 프리픽스 또는 '.tar.gz' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에서 가장 최근 백업 파일을 사용합니다.

5. 모든 마스터 및 대기 노드에서 Postgres 서버를 시작합니다.

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

Qpid 서버 및 Qpidd

1. 모든 노드에서 Qpidd, Qpid 서버, Postgres 서버를 중지합니다.
   

   /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 apigee-qpidd stop

2. 이전 Qpid 서버 및 Qpidd 디렉터리를 삭제합니다.

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. Qpidd를 다시 설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. Qpidd 복원:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 프리픽스 또는 '.tar.gz' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에 있는 최신 백업 파일을 사용합니다.

5. Qpidd를 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Qpid 서버를 다시 설치합니다.

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

7. Qpid 서버 복원:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 프리픽스 또는 '.tar.gz' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에 있는 최신 백업 파일을 사용합니다.

8. 모든 노드에서 Qpid 서버, Qpidd, Postgres 서버를 다시 시작합니다.

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

SymasLDAP

1. SymasLDAP 중지:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. SymasLDAP를 다시 설치합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. 이전 SymasLDAP 디렉터리를 삭제합니다.

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. SymasLDAP 복원:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 접두사나 '.tar.gz' 접미사도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에서 가장 최근 백업 파일을 사용합니다.

5. SymasLDAP를 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. 모든 관리 서버를 다시 시작합니다.

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

관리 서버

1. 관리 서버 중지:

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

2. 이전 관리 서버 디렉터리를 삭제합니다.

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. 관리 서버를 다시 설치합니다.

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

4. 백업 파일에서 관리 서버를 복원합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 프리픽스 또는 '.tar.gz' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에 있는 최신 백업 파일을 사용합니다.

5. 관리 서버를 다시 시작합니다.

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

메시지 프로세서

1. 메시지 프로세서 중지:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. 이전 메시지 프로세서 디렉터리를 삭제합니다.

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. 메시지 프로세서 재설치:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. 백업 파일에서 메시지 프로세서를 복원합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 접두사나 '.tar.gz' 접미사도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에 있는 최신 백업 파일을 사용합니다.

5. 메시지 프로세서를 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

라우터

1. 라우터를 중지합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. 이전 라우터 디렉터리를 삭제합니다.

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. 라우터 재설치:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. 백업 파일에서 라우터를 복원합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 프리픽스 또는 '.tar.gz' 서픽스도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에 있는 최신 백업 파일을 사용합니다.

5. 라우터 다시 시작:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

새 Edge UI

1. 새 Edge UI 중지:

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

2. 이전 New Edge UI 디렉터리를 삭제합니다.

   /opt/apigee/data/edge-management-ui
   /opt/apigee/etc/edge-management-ui.d

3. 새 Edge UI 재설치:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install

4. 백업 파일에서 새 Edge UI 복원:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restore 2019.03.17,14.40.41

   구성요소를 복원할 때는 백업 파일의 디렉터리 경로를 지정하지 않으며 'backup-' 접두사나 '.tar.gz' 접미사도 지정하지 않습니다. 백업 파일 이름의 날짜/시간 부분만 지정합니다.

   원하는 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 Edge는 구성요소의 백업 디렉터리에 있는 최신 백업 파일을 사용합니다.

5. 새 Edge UI를 다시 시작합니다.

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

사이트 복구 완료

1. 모든 구성요소 노드를 중지합니다. 하위 시스템을 중지하는 순서가 중요합니다. 먼저 모든 Edge 노드를 중지한 후 모든 데이터 스토어 노드를 중지합니다.
2. 위에 설명된 대로 모든 구성요소를 복원합니다.
3. 이제 다음 순서로 모든 구성요소를 시작합니다. 하위 시스템 시작 순서가 중요합니다.
   1. ZooKeeper 클러스터 시작
   2. Cassandra 클러스터 시작
   3. SymasLDAP가 실행 중인지 확인
   4. qpid 시작
   5. PostgreSQL 데이터베이스가 실행 중인지 확인
   6. 관리 서버 시작
   7. 라우터 및 메시지 프로세서 시작
   8. Qpid 서버 시작
   9. Postgres 서버 시작
   10. 새 Edge UI 시작