Reinstalar e restaurar componentes

Neste documento, explicamos a reinstalação e a restauração de um componente do Edge. Use este procedimento se você precisar reinstalar o componente do Edge antes de restaurar o backup.

Apache ZooKeeper

Restaurar um nó independente

  1. Parar o ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  2. Os diretórios antigos do ZooKeeper foram removidos:
    /opt/apigee/data/apigee-zookeeper
    /opt/apigee/etc/apigee-zookeeper.d
  3. Reinstale o ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
  4. Restaurar ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reinicie todos os componentes:
    /opt/apigee/apigee-service/bin/apigee-all restart

Restaurar um nó do cluster

Se um único nó do ZooKeeper falhar e fizer parte de um conjunto, você poderá criar um novo nó com o mesmo nome de host/endereço IP e reinstalar o ZooKeeper. Quando o novo nó do ZooKeeper entrar no conjunto do ZooKeeper, ele receberá os snapshots mais recentes do líder e começará a exibir clientes. Não é necessário restaurar dados nesta instância.

  1. Reinstale o ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
  2. Execute a configuração no nó do ZooKeeper usando o mesmo arquivo de configuração usado ao instalar o nó original:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile
  3. Iniciar o ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Restaurar um cluster completo

  1. Interrompa o cluster completo.
  2. Restaure todos os nós do ZooKeeper a partir do arquivo de backup, conforme descrito acima para um único nó.
  3. Inicie o cluster ZooKeeper.
  4. Reinicie todos os componentes.

Apache Cassandra

Restaurar um nó independente

  1. Interromper o Cassandra:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  2. Remova o diretório antigo do Cassandra:
    /opt/apigee/data/apigee-cassandra
  3. Reinstale o Cassandra:
    /apigee/apigee-service/bin/apigee-service apigee-cassandra install
  4. Restaurar o Cassandra:
    /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reinicie todos os componentes:
    /apigee/apigee-service/bin/apigee-all restart

Restaurar um nó do cluster

Se um único nó do Cassandra falhar, que fizer parte de um conjunto, será possível criar um novo nó com o mesmo nome de host/endereço IP. Você só precisa reinstalar o Cassandra. Não é necessário restaurar os dados.

  1. Reinstale o Cassandra:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
  2. Execute a configuração no nó do Cassandra usando o mesmo arquivo de configuração usado ao instalar o nó original:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
  3. Inicie o Cassandra:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  4. Depois de instalar o Cassandra e o nó estiver ativo, (considerando que RF>=2 para todos os keyspaces) executem o seguinte comando nodetool para inicializar o nó:
    /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr

    Você só precisará passar seu nome de usuário e senha se ativar a autenticação JMX para o Cassandra.

Restaurar um cluster completo

  1. Interrompa o cluster completo.
  2. Restaure todos os nós do Cassandra do arquivo de backup.
  3. Inicie o cluster do Cassandra.
  4. Reinicie todos os componentes.

Banco de dados PostgreSQL

PosgreSQL em execução independente ou como mestre

  1. Interrompa os servidores de gerenciamento, Qpid Server e Postgres em todos os nós:
    /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. Reinstale o banco de dados PostgreSQL:
    /apigee/apigee-service/bin/apigee-service apigee-postgresql install 
  3. Inicie o PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  4. Restaure o banco de dados PostgreSQL usando o arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

    Observe que, ao restaurar o componente PostgreSQL, você não especifica o caminho do diretório para o arquivo de backup nem o sufixo ".dump". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Inicie os servidores de gerenciamento, Qpid Server e Postgres em todos os nós:
    /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 em execução em espera

  1. Reinstale o banco de dados PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install
  2. Reconfigure o banco de dados PostgreSQL usando o mesmo arquivo de configuração usado na instalação:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile
  3. Inicie o PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Servidor Postgres

  1. Interrompa o servidor Postgres em todos os nós mestre e de espera:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  2. Os diretórios antigos do servidor Postgres foram removidos:
    /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d
  3. Reinstale o servidor Postgres:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install
  4. Restaure o servidor Postgres a partir do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Inicie o servidor Postgres em todos os nós mestre e de espera:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Qpid Server e Qpidd

  1. Interrompa o Qpidd, o Qpid Server e o Postgres Server em todos os nós:
    /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. Remova os diretórios Qpid Server e Qpidd antigos:
    /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. Reinstale o Qpidd:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 
  4. Restaurar Qpidd:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Iniciar Qpidd:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 
  6. Reinstale o servidor Qpid:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install
  7. Restaurar o servidor Qpid:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  8. Reinicie os servidores Qpid Server, Qpidd e Postgres em todos os nós:
    /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. Parar o OpenLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
  2. Reinstale o OpenLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install
  3. Remova os diretórios OpenLDAP antigos:
    /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d
  4. Restaurar o OpenLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reinicie o OpenLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start
  6. Reinicie todos os servidores de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Servidor de gerenciamento

  1. Interromper o servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  2. Remover os diretórios antigos do servidor de gerenciamento:
    /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d
  3. Reinstale o servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server install
  4. Restaure o servidor de gerenciamento a partir do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reinicie o servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

processador de mensagens

  1. Parar o processador de mensagens:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
  2. Os diretórios antigos do processador de mensagens foram removidos:
    /opt/apigee/data/edge-message-processor
    /opt/apigee/etc/edge-message-processor.d
  3. Reinstale o processador de mensagens:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install
  4. Restaure o processador de mensagens a partir do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reinicie o processador de mensagens:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

Roteador

  1. Parar roteador:
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  2. Remova os diretórios de roteador antigos:
    /opt/apigee/data/edge-router
    /opt/apigee/etc/edge-router.d
  3. Reinstale o roteador:
    /opt/apigee/apigee-service/bin/apigee-service edge-router install
  4. Restaure o roteador a partir do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reinicie o roteador:
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

interface do Edge

  1. Parar interface:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Remova os diretórios de interface antigos:
    /opt/apigee/data/edge-ui
    /opt/apigee/etc/edge-ui.d
  3. Reinstale a interface:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui install
  4. Restaure a IU a partir do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

    Observe que, ao restaurar um componente, você não especifica o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você especifica apenas a parte da data/hora do nome do arquivo de backup.

    Também é possível omitir o arquivo de backup no comando restore, e o Edge vai usar o arquivo de backup mais recente no diretório de backup do componente.

  5. Reiniciar a interface:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui start

Concluir a recuperação do site

  1. Interrompa todos os nós dos componentes. Observe que a ordem de interrupção dos subsistemas é importante: primeiro, pare todos os nós de borda e depois pare todos os nós de armazenamento de dados.
  2. Restaure todos os componentes conforme descrito acima.
  3. Agora inicie todos os componentes na ordem a seguir. Observe que a ordem de inicialização dos subsistemas é importante:
    1. Iniciar o cluster ZooKeeper
    2. Iniciar o cluster do Cassandra
    3. Verificar se o OpenLDAP está instalado e em execução
    4. Iniciar qpid
    5. Verifique se o banco de dados do PostgreSQL está em execução
    6. Iniciar o servidor de gerenciamento
    7. Iniciar roteadores e processadores de mensagens
    8. Iniciar o servidor Qpid
    9. Iniciar o servidor Postgres
    10. Iniciar a interface da Apigee