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

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

Apache ZooKeeper

독립형 노드 1개 복원

  1. JoKeeper를 중지합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  2. 이전 주Keeper 디렉터리를 삭제합니다.
    /opt/apigee/data/apigee-zookeeper
    /opt/apigee/etc/apigee-zookeeper.d
  3. 주Keeper를 재설치합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
  4. 주Keeper를 복원합니다.
    /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개 복원

앙상블의 일부인 하나의 동물원키퍼 노드에 장애가 발생하면 동일한 호스트 이름/IP 주소로 새 노드를 만들고 주Keeper를 다시 설치하면 됩니다. 새 주Keeper 노드가 JoKeeper 앙상블에 참여하면 리더의 최신 스냅샷을 가져와 클라이언트에 서비스를 제공하기 시작합니다. 이 인스턴스의 데이터는 복원할 필요가 없습니다.

  1. 주Keeper를 재설치합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
  2. 원래 노드를 설치할 때 사용한 구성 파일(
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile
    )과 동일한 구성 파일을 사용하여 JoKeeper 노드에서 설정을 실행합니다.
  3. 다음과 같이 동물원Keeper를 시작합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

전체 클러스터 복원

  1. 전체 클러스터를 중지합니다.
  2. 단일 노드에 대해 위에서 설명한 대로 백업 파일에서 모든 주Keeper 노드를 복원합니다.
  3. JoKeeper 클러스터를 시작합니다.
  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를 다시 설치하기만 하면 되며 데이터를 복원할 필요가 없습니다.

  1. Cassandra를 재설치합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
  2. 원본 노드를 설치할 때 사용된 것과 동일한 구성 파일을 사용하여 Cassandra 노드에서 설정을 실행합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
  3. Cassandra를 시작합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  4. Cassandra를 설치하고 노드가 작동하면 (모든 키스페이스에 대해 RF>=2인 경우) 다음 nodetool 명령어를 실행하여 노드를 초기화합니다.
    /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr

    Cassandra에 JMX 인증을 사용 설정한 경우에만 사용자 이름과 비밀번호를 전달하면 됩니다.

전체 클러스터 복원

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

PostgreSQL 데이터베이스

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

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

대기 모드로 실행 중인 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. 이제 다음 순서로 모든 구성요소를 시작합니다. 하위 시스템을 시작하는 순서가 중요합니다.
    1. JoKeeper 클러스터를 시작합니다.
    2. Cassandra 클러스터 시작
    3. OpenLDAP가 작동되어 실행 중인지 확인합니다.
    4. qpid 시작
    5. PostgreSQL 데이터베이스가 실행 중인지 확인합니다.
    6. 관리 서버 시작
    7. 라우터 및 메시지 프로세서 시작
    8. Qpid 서버 시작
    9. Postgres 서버 시작
    10. Apigee UI 시작