Reinstalar e restaurar componentes

Este documento aborda a reinstalação e a restauração de um componente do Edge. Use este procedimento se você precisar reinstalar o componente 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. Remova os diretórios do ZooKeeper antigos:

   /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 o ZooKeeper:

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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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 ensemble, você poderá criar um novo nó com mesmo nome de host/endereço IP e reinstale o ZooKeeper. Quando o novo nó ZooKeeper entra no O conjunto do ZooKeeper coleta as imagens mais recentes do líder e começa a atender clientes. Não é necessário restaurar os 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 com 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. Inicie 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 do arquivo de backup, conforme descrito acima, para um único nó.
3. Inicie o cluster do ZooKeeper.
4. Reinicie todos os componentes.

Apache Cassandra

Restaurar um nó independente

1. Parar 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. Restaure o Cassandra:

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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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, ele faz parte de um ensemble, é possível criar um novo nó com mesmo nome de host/endereço IP. Você só precisa reinstalar o Cassandra, não é preciso restaurá-lo 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 com o mesmo arquivo de configuração usado na instalação do 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) execute 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 sua senha se ativou a autenticação JMX para o Cassandra.

Restaurar um cluster completo

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

Banco de dados PostgreSQL

PostgreSQL em execução autônoma ou como mestre

1. Interrompa o servidor de gerenciamento, o Qpid Server e o servidor 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 pelo arquivo de backup:

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

   Ao restaurar o componente PostgreSQL, você não especifica o caminho do diretório para o arquivo de backup, nem ".dump" sufixo. Você só especifica parte de data/hora do nome do arquivo de backup.

   É possível omitir o arquivo de backup no comando restore e o Edge use o arquivo de backup mais recente no diretório de backup do componente.

5. Inicie o servidor de gerenciamento, o Qpid Server 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 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 para instalá-lo:
   

   /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 mestres e de espera:

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

2. Remova os diretórios antigos do Postgres Server:

   /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 pelo arquivo de backup:

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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use o arquivo de backup mais recente no diretório de backup do componente.

5. Inicie o servidor Postgres em todos os nós mestres e de espera:

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

Qpid Server e Qpidd

1. Interromper 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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use o arquivo de backup mais recente no diretório de backup do componente.

5. Inicie o Qpidd:

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

6. Reinstale o Qpid Server:

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

7. Restaure o servidor Qpid:

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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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. Pare 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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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. Pare o servidor de gerenciamento:

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

2. Remova os diretórios antigos do Management Server:

   /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 usando o arquivo de backup:

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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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 processador de mensagens:

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

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

   /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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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 do roteador antigo:

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

3. Reinstalar 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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use 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. Reinstalar a interface:
   

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

4. Restaure a interface usando o arquivo de backup:

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

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

   É possível omitir o arquivo de backup no comando restore e o Edge use o arquivo de backup mais recente no diretório de backup do componente.

5. Reiniciar 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. A ordem de parada dos subsistemas é importante: primeiro interromper todos os nós do Edge e depois todos os nós do repositório de dados.
2. Restaure todos os componentes conforme descrito acima.
3. Agora, inicie todos os componentes na seguinte ordem. Observe que a ordem de iniciar é importante:
   1. Inicie o cluster do ZooKeeper
   2. Iniciar o cluster do Cassandra
   3. Verifique se o OpenLDAP está instalado e em execução
   4. Iniciar qpid
   5. Verificar se o banco de dados PostgreSQL está em execução
   6. Iniciar servidor de gerenciamento
   7. Iniciar roteadores e processadores de mensagens
   8. Iniciar o servidor Qpid
   9. Iniciar o servidor do Postgres
   10. Iniciar a interface da Apigee