구성요소 재설치 및 복원하기

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

Apache ZooKeeper

독립형 노드 1개 복원

1. 주키퍼 중지:

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

2. 이전 동물원Keeper 디렉터리를 삭제합니다.

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

3. 주키퍼를 다시 설치하려면 다음 단계를 따르세요.

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

4. 주키퍼를 복원합니다.

   /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개 복원

앙상블의 일부인 단일 주키퍼 노드에 장애가 발생하는 경우 주키퍼를 다시 설치할 수 있습니다. 새 주키퍼 노드가 주키퍼 앙상블은 리더의 최신 스냅샷을 받아 고객에게 서비스를 제공하기 시작합니다. 이 경우에는 데이터를 복원할 필요가 없습니다.

1. 주키퍼를 다시 설치하려면 다음 단계를 따르세요.

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

2. 다음을 설치할 때 사용된 것과 동일한 구성 파일을 사용하여 주키퍼 노드에서 설정을 실행합니다. 원본 노드:

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

3. 주키퍼를 시작하려면 다음 단계를 따르세요.

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

전체 클러스터 복원

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

Apache Cassandra

독립형 노드 1개 복원

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

클러스터 노드 1개 복원

앙상블에 포함된 단일 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

위 단계를 완료하면 실패하여 Apigee 소프트웨어를 설치할 준비가 된 노드와 동일한 IP 주소를 가진 노드가 있어야 합니다. 다음 단계를 따르세요.

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. 이 노드가 시드 노드 중 하나인 경우 (노드의 IP 주소가 1단계의 시드 노드 목록에 표시됨) 파일에 다른 줄을 추가합니다.
   

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

   <ph type="x-smartling-placeholder">
   </ph>
   1. 예를 들어 위의 예에서 시드 목록에는 IP 2개(10.1.0.1)가 있고 10.1.0.2. 복원 중인 노드가 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 데이터베이스

PosgreSQL이 독립형 또는 마스터로

1. 모든 노드에서 Management Server, Qpid Server, 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. 모든 노드에서 Management Server, Qpid Server, 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

PosgreSQL이 대기 모드로 실행 중

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 Server, 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 Server 및 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 Server, 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

OpenLDAP

1. OpenLDAP 중지:

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

2. OpenLDAP 다시 설치:

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

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

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

4. OpenLDAP 복원:

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

   구성요소를 복원할 때 백업에 대한 디렉터리 경로를 지정하지 않는다는 점에 유의하세요. 파일을 내보내거나 'backup-'이라는 접두사 또는 '.tar.gz' 서픽스입니다. 사용자는 백업 파일 이름의 날짜/시간 부분입니다.

   필요한 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 이렇게 하면 Edge가 구성요소의 백업 디렉터리에 있는 최신 백업 파일 사용

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

   /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. 중지 UI:

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

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

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

3. UI 재설치:
   

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

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

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

   구성요소를 복원할 때 백업에 대한 디렉터리 경로를 지정하지 않는다는 점에 유의하세요. 파일을 내보내거나 'backup-'이라는 접두사 또는 '.tar.gz' 서픽스입니다. 사용자는 백업 파일 이름의 날짜/시간 부분입니다.

   필요한 경우 restore 명령어에서 백업 파일을 생략할 수 있으며 이렇게 하면 Edge가 구성요소의 백업 디렉터리에 있는 최신 백업 파일 사용

5. UI 다시 시작:
   

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

사이트 복구 완료

1. 모든 구성요소 노드를 중지합니다. 하위 시스템을 중지하는 순서가 중요합니다. 먼저 모든 Edge 노드를 중지한 다음 모든 Datastore 노드를 중지합니다.
2. 위에서 설명한 대로 모든 구성요소를 복원합니다.
3. 이제 다음 순서로 모든 구성요소를 시작합니다. 참고로 하위 시스템의 역할이 중요합니다. <ph type="x-smartling-placeholder">
   </ph>
   1. ZooKeeper 클러스터 시작
   2. Cassandra 클러스터 시작
   3. OpenLDAP이 작동되어 실행 중인지 확인하세요.
   4. qpid 시작
   5. PostgreSQL 데이터베이스가 실행 중인지 확인
   6. 관리 서버 시작
   7. 라우터 및 메시지 프로세서 시작
   8. Qpid 서버 시작
   9. Postgres 서버 시작
   10. Apigee UI 시작