Como reinstalar e restaurar componentes

Edge para nuvem privada v. 4.16.05

Este documento aborda a reinstalação e a restauração de um componente do Edge. Use este procedimento se precisar reinstalar o componente do Edge antes de restaurar o backup.

Apache ZooKeeper

Restaurar um nó independente

1. Interrompa o ZooKeeper:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
2. Remova os diretórios antigos do ZooKeeper:
   /<inst_root>/apigee/data/apigee-zookeeper
   /<inst_root>/apigee/etc/apigee-zookeeper.d
3. Reinstale o ZooKeeper:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
4. Restaure o ZooKeeper.
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie todos os componentes:
   > /<inst_root>/apigee/apigee-service/bin/apigee-all restart

Restaurar um nó de cluster

Se um único nó do ZooKeeper que faz parte de um conjunto falhar, será possível criar um novo nó com o mesmo nome de host/endereço IP e reinstalar o ZooKeeper. Quando o novo nó do ZooKeeper se junta ao conjunto do ZooKeeper, ele recebe os snapshots mais recentes do líder e começa a atender aos clientes. Não é necessário restaurar dados nessa instância.

1. Reinstale o ZooKeeper:
   > /<inst_root>/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:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile
3. Inicie o ZooKeeper:
   > /<inst_root>/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. Interrompa o Cassandra:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Remova os diretórios antigos do Cassandra:
   /<inst_root>/apigee/data/apigee-cassandra
   /<inst_root>/apigee/etc/apigee-cassandra.d
3. Reinstale o Cassandra:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra install
4. Restaure o Cassandra:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie todos os componentes:
   > /<inst_root>/apigee/apigee-service/bin/apigee-all restart

Restaurar um nó de cluster

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

Observação: ao realizar uma reinstalação em um nó que não é de semente, verifique se pelo menos um nó de semente do Cassandra está ativo.

1. Reinstale o Cassandra:
   > /<inst_root>/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:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
3. Inicie o Cassandra:
   > /<inst_root>/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ó:
   <inst_root>/apigee/apigee-cassandra/bin/nodetool -h localhost repair

Restaurar um cluster completo

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

Banco de dados PostgreSQL

PostgreSQL em execução de forma independente ou como mestre

1. Interrompa o servidor de gerenciamento, o servidor Qpid e o servidor Postgres em todos os nós:
   Observação: seu sistema ainda pode processar solicitações para proxies de API enquanto esses componentes estão interrompidos.
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server stop
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Reinstale o banco de dados PostgreSQL:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql install
3. Inicie o PostgreSQL:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql start
4. Restaure o banco de dados PostgreSQL do arquivo de backup:
   /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2016.03.17,14.40.41.dump
5. Inicie o servidor de gerenciamento, o servidor Qpid e o servidor Postgres em todos os nós:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server start
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PostgreSQL em execução como Standby

1. Reinstale o banco de dados PostgreSQL:
   > /<inst_root>/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:
   /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile
3. Inicie o PostgreSQL:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql start

Servidor Postgres

1. Interrompa o servidor Postgres em todos os nós mestre e em espera:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Remova os diretórios antigos do servidor Postgres:
   /<inst_root>/apigee/data/edge-postgres-server
   /<inst_root>/apigee/etc/edge-postgres-server.d
3. Reinstale o servidor Postgres:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server install
4. Restaure o servidor Postgres do arquivo de backup:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server restore backup-2016.03.17,14.40.41.tar.gz
5. Inicie o servidor Postgres em todos os nós mestre e em espera:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Servidor Qpid e Qpidd

1. Interrompa o Qpidd, o servidor Qpid e o servidor Postgres em todos os nós:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
2. Remova os diretórios antigos do servidor Qpid e do Qpidd:
   /<inst_root>/apigee/data/edge-qpid-server
   /<inst_root>/apigee/etc/edge-qpid-server.d
   /<inst_root>/apigee/data/apigee-qpidd
   /<inst_root>/apigee/etc/apigee-qpidd.d
3. Reinstale o Qpidd:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-qpidd install
4. Restaure o Qpidd:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-qpidd restore backup-2016.03.17,14.40.41.tar.gz
5. Inicie o Qpidd:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-qpidd start
6. Reinstale o servidor Qpid:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server install
7. Restaure o servidor Qpid:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server restore backup-2016.03.17,14.40.41.tar.gz
8. Reinicie os servidores Qpid, Qpidd e Postgres em todos os nós:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

OpenLDAP

1. Interrompa o OpenLDAP:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap stop
2. Reinstale o OpenLDAP:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap install
3. Remova os diretórios antigos do OpenLDAP:
   /<inst_root>/apigee/data/apigee-openldap
   /<inst_root>/apigee/etc/apigee-openldap.d
4. Restaure o OpenLDAP:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie o OpenLDAP:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap start
6. Reinicie todos os servidores de gerenciamento:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart

Servidor de gerenciamento

1. Interrompa o servidor de gerenciamento:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server stop
2. Remova os diretórios antigos do Management Server:
   /<inst_root>/apigee/data/edge-management-server
   /<inst_root>/apigee/etc/edge-management-server.d
3. Reinstale o servidor de gerenciamento:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server install
4. Restaure o Management Server do arquivo de backup:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie o servidor de gerenciamento:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server start

processador de mensagens

1. Interrompa o processador de mensagens:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-message-processor stop
2. Remova os diretórios antigos do processador de mensagens:
   /<inst_root>/apigee/data/edge-message-processor
   /<inst_root>/apigee/etc/edge-message-processor.d
3. Reinstale o processador de mensagens:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-message-processor install
4. Restaure o processador de mensagens do arquivo de backup:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-message-processor restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie o processador de mensagens:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-message-processor start

Roteador

1. Interrompa o roteador:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router stop
2. Remova os diretórios antigos do roteador:
   /<inst_root>/apigee/data/edge-router
   /<inst_root>/apigee/etc/edge-router.d
3. Reinstale o roteador:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router install
4. Restaure o roteador do arquivo de backup:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie o roteador:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router start

IU do Edge

1. Interrompa a IU:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui stop
2. Remova os diretórios antigos da interface:
   /<inst_root>/apigee/data/edge-ui
   /<inst_root>/apigee/etc/edge-ui.d
3. Reinstale a IU:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui install
4. Restaure a interface do arquivo de backup:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui restore backup-2016.03.17,14.40.41.tar.gz
5. Reinicie a IU:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui start

Recuperação completa do site

1. Interrompa todos os nós de componentes. A ordem de interrupção dos subsistemas é importante: primeiro todos os nós do Edge e, em seguida, todos os nós de repositórios de dados.
2. Restaure todos os componentes conforme descrito acima.
3. Agora, inicie todos os componentes na ordem a seguir. A ordem de inicialização dos subsistemas é importante:
   1. Iniciar o cluster do ZooKeeper
   2. Iniciar o cluster do Cassandra
   3. Verifique se o OpenLDAP está em execução
   4. Iniciar qpid
   5. Verifique se o banco de dados 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 IU da Apigee