Restaurar um componente para um ambiente existente

Este documento aborda a restauração de qualquer componente do Edge em um ambiente atual sem precisar reinstalar o componente. Isso significa que o nó em que você está restaurando o componente tem o mesmo endereço IP ou nome DNS de quando você fez o backup.

Se você precisar reinstalar o componente, consulte Como reinstalar e restaurar componentes.

Apache ZooKeeper

Restaurar um nó independente

1. Remova os diretórios antigos do ZooKeeper:

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

2. Restaure os dados do ZooKeeper do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore backup-2016.03.17,14.40.41.tar.gz

3. Reinicie todos os componentes para estabelecer a sincronização com o novo ZooKeeper restaurado.

Restaurar um nó de cluster

1. Se um único nó do ZooKeeper falhar, que faz parte de um conjunto, você poderá criar um novo nó com o mesmo nome do host/endereço IP (siga as etapas de reinstalação mencionadas em Como reinstalar e restaurar componentes) e quando ele entrar no conjunto do ZooKeeper, receberá os snapshots mais recentes do líder e começará a atender os clientes. Não é necessário restaurar dados nessa instância.

Restaurar um cluster completo

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

Apache Cassandra

Restaurar um nó independente

1. Remova o diretório antigo do Cassandra:

   /opt/apigee/data/apigee-cassandra

2. Restaure o nó do Cassandra do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup-2016.03.17,14.40.41.tar.gz

3. Reinicie todos os componentes.

Restaurar um nó de cluster

1. Se um único nó do Cassandra falhar, que faz parte de um conjunto, você poderá criar um novo nó com o mesmo nome do host/endereço IP (siga as etapas de reinstalação mencionadas em Como reinstalar e restaurar componentes). Só é necessário reinstalar o Cassandra, não é necessário restaurar os dados.

   Ao realizar uma restauração em um nó não inicial, verifique se pelo menos um nó inicial do Cassandra está ativo.

   Depois de instalar o Cassandra e o nó estiver ativo (considerando que RF>=2 para todos os keyspaces) execute o seguinte nodetool comando para inicializar o nó:

   /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr

   Só é necessário transmitir seu nome de usuário e senha se você tiver ativado a autenticação JMX para o Cassandra.

Restaurar um cluster completo

1. Pare 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. Pare o servidor de gerenciamento, o servidor Qpid e o servidor Postgres em todos os nós:

   /opt/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. Verifique se o banco de dados PostgreSQL está em execução:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql status

3. Restaure o banco de dados PostgreSQL do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2016.03.17,14.40.41.dump

4. Inicie o servidor de gerenciamento, o servidor Qpid e o servidor 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 como espera

1. Reconfigure o banco de dados PostgreSQL usando o mesmo arquivo de configuração que você usou para instalá-lo:

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

2. Inicie o PostgreSQL:

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

Servidor Postgres

1. Remova os diretórios antigos do servidor Postgres:

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

2. Restaure o servidor Postgres do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restore backup-2016.03.17,14.40.41.tar.gz

3. Inicie o servidor Postgres:

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

Banco de dados Qpidd

1. Remova os diretórios antigos do Qpidd:

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

2. Restaure o Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore backup-2016.03.17,14.40.41.tar.gz 

3. Inicie o Qpidd:

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

Servidor Qpid

1. Remova os diretórios antigos do servidor Qpid:

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

2. Restaure o servidor Qpid do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore backup-2016.03.17,14.40.41.tar.gz

3. Inicie o servidor Qpid:

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

SymasLDAP

1. Remova os diretórios antigos do SymasLDAP:

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

2. Restaure o SymasLDAP do arquivo de backup:

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

3. Reinicie o SymasLDAP:

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

Servidor de gerenciamento

1. Remova os diretórios antigos do servidor de gerenciamento:

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

2. Restaure o servidor de gerenciamento do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore backup-2016.03.17,14.40.41.tar.gz

3. Reinicie o servidor de gerenciamento:

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

processador de mensagens

1. Remova os diretórios antigos do processador de mensagens:

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

2. Restaure o processador de mensagens do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore backup-2016.03.17,14.40.41.tar.gz

3. Reinicie o processador de mensagens:

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

Roteador

1. Remova os diretórios antigos do roteador:

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

2. Restaure o roteador do arquivo de backup:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore backup-2016.03.17,14.40.41.tar.gz

3. Reinicie o roteador:

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

Nova interface do Edge

1. Pare a nova interface do Edge:

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

2. Remova os diretórios antigos da nova interface do Edge:

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

3. Restaure a nova interface do Edge do arquivo de backup:

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

   Ao restaurar um componente, não especifique o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Você só especifica a parte de data/hora do nome do arquivo de backup.

   Opcionalmente, você pode 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.

4. Reinicie a nova interface do Edge:

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