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 que faz parte de um ensemble falhar, você poderá criar um novo nó com o mesmo nome de host/endereço IP. Você só precisa reinstalar o Cassandra e seguir mais algumas etapas. Não é necessário restaurar os dados dos backups. Réplicas disponíveis em outros nós podem ser usadas para restaurar dados em nós com falha. Geralmente, estas etapas são aplicáveis se um nó no cluster do Cassandra falhar devido a um problema no hardware etc.

.

Se o nó com falha não estiver mais acessível, destrua-o e isole a rede para garantir que ele não volte acidentalmente ao cluster do Cassandra. Em seguida, crie um novo nó com o mesmo endereço IP do nó original e execute as etapas normais de inicialização da Apigee nele.

Se o nó ainda estiver acessível e você quiser reutilizá-lo, siga estas etapas:

1. Interrompa o processo do Cassandra no nó:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Desinstale o software Cassandra do nó:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Exclua permanentemente o diretório de dados do nó:
   rm -rf /opt/apigee/data/apigee-cassandra

Depois de concluir as etapas acima, você terá um nó com o mesmo endereço IP que o que falhou e está pronto para a instalação do software da Apigee. Siga estas etapas:

1. Identifique os nós de origem do data center.
   1. Em qualquer nó operacional do Cassandra no mesmo data center que o nó que está sendo restaurado, execute o seguinte comando:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. A saída será semelhante a esta:

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. Consulte a última linha na saída. Os endereços IP separados por vírgulas listados são os nós de origem usados pelos nós neste data center.
2. No novo nó que está sendo restaurado, crie ou edite o seguinte arquivo:
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. Se esse nó for um dos nós de sugestão (o endereço IP do nó aparece na lista de nós de origem da etapa 1), adicione outra linha ao arquivo:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. Por exemplo, na instância acima, a lista de origem tem dois IPs: 10.1.0.1 e 10.1.0.2. Se o nó que está sendo restaurado for 10.1.0.1, adicione uma linha como esta:
      

      conf_cassandra_seeds="10.1.0.2"

5. Salve o arquivo, verifique se ele pertence a legíveis para o usuário da Apigee:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Instale o software Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. Execute a configuração do Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. A configuração tentará inicializar o serviço do Cassandra internamente. Isso pode levar muito tempo, dependendo da quantidade de dados para transmitir de outros nós, da capacidade de processamento da sua rede etc.
9. [Opção avançada] É possível acelerar o streaming de dados executando os seguintes comandos do nodetool no nó:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Depois que o nó do Cassandra for reativado, use os comandos padrão como abaixo para verificar se o nó foi associado ao ring:
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. Depois de confirmar que o nó está funcionando corretamente, edite o arquivo /opt/apigee/customer/application/cassandra.properties novamente e remova as linhas adicionadas anteriormente nas etapas 3 e 4.
12. Reinicie o serviço do Cassandra no nó:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

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