Reinstalar e restaurar componentes

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:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  2. Remova os diretórios antigos do ZooKeeper:
    /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. Restaure o ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper 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". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Você pode omitir o arquivo de backup no comando restore. Nesse caso, o Edge 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ó de cluster

Se um único nó do ZooKeeper que faz parte de um conjunto falhar, crie um novo nó com o mesmo nome do host/endereço IP e reinstale 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:
    /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. 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, não especifique o caminho do diretório para o arquivo de backup, nem o prefixo "backup-" ou o sufixo ".tar.gz". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Você pode omitir o arquivo de backup no comando restore. Nesse caso, o Edge 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ó de cluster

Se um único nó do Cassandra que faz parte de um conjunto falhar, será possível criar um novo nó com o mesmo nome de host/endereço IP. Basta reinstalar o Cassandra e seguir algumas etapas extras. Não é necessário restaurar os dados dos backups. As réplicas disponíveis em outros nós podem ser usadas para restaurar dados no nó com falha. Essas etapas geralmente são aplicáveis se um nó no cluster do Cassandra falhar devido a um mau funcionamento de 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 entre novamente no cluster do Cassandra por acidente. Em seguida, abra um novo nó com o mesmo endereço IP do nó original e execute as etapas de inicialização habituais da Apigee nele.

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

  1. Pare 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 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 do nó que falhou e estará pronto para a instalação do software da Apigee. Siga estas etapas:

  1. Identifique os nós de semente do data center.
    1. Em qualquer nó operacional do Cassandra no mesmo data center do 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 semente 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 semente (o endereço IP do nó aparece na lista de nós de semente 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 e verifique se ele pertence ao usuário da Apigee e pode ser lido por ele:
    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 vai tentar inicializar internamente o serviço do Cassandra. Isso pode levar muito tempo, dependendo da quantidade de dados a serem transmitidos de outros nós, da capacidade de processamento da rede etc.
  9. [Opção avançada] É possível acelerar o streaming de dados executando os seguintes comandos nodetool no nó:
    nodetool setstreamthroughput <value>
    nodetool setcompactionthroughput <value>
  10. Depois que o nó do Cassandra voltar a funcionar, use comandos padrão como os abaixo para verificar se ele entrou no anel:
    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status
  11. Depois de validar que o nó está funcionando corretamente, edite o arquivo /opt/apigee/customer/application/cassandra.properties novamente e remova as linhas adicionadas anteriormente neste procedimento 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 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 Management Server, o Qpid Server e o Postgres Server 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 do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

    Ao restaurar o componente do PostgreSQL, não especifique o caminho do diretório para o arquivo de backup nem o sufixo ".dump". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Se quiser, omita 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 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

PostgreSQL em execução como Standby

  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 mestre e em espera:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  2. Remova os diretórios antigos do servidor Postgres:
    /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 do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server 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.

    Se quiser, omita 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

Servidor Qpid e Qpidd

  1. Interrompa o Qpidd, o servidor Qpid e o servidor Postgres 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 antigos do servidor Qpid e do Qpidd:
    /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, não especifique o caminho do diretório para o arquivo de backup nem o prefixo "backup-" ou o sufixo ".tar.gz". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Você pode omitir o arquivo de backup no comando restore. Nesse caso, o Edge usará 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 servidor Qpid:
    /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, não especifique o caminho do diretório para o arquivo de backup nem o prefixo "backup-" ou o sufixo ".tar.gz". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Se quiser, omita 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, 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

SymasLDAP

  1. Interrompa o SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
  2. Reinstale o SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install
  3. Remova os diretórios antigos do SymasLDAP:
    /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d
  4. Restaurar o SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap 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.

    Se quiser, omita 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 SymasLDAP:
    /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. Parar o servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  2. Remova 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 Management Server do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server 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.

    Você pode omitir o arquivo de backup no comando restore. Nesse caso, o Edge 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. Remova os diretórios antigos do processador de mensagens:
    /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 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, 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.

    Se quiser, omita 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 o roteador:
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  2. Remova os diretórios antigos do roteador:
    /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 do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-router 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". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Se quiser, omita 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 roteador:
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

Nova interface do Edge

  1. Interrompa 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. Reinstale a nova interface do Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install
  4. 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". Especifique apenas a parte de data/hora do nome do arquivo de backup.

    Se quiser, omita 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 a nova interface do Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

Recuperação completa do site

  1. Interrompa todos os nós de componentes. A ordem de interrupção dos subsistemas é importante: primeiro, pare todos os nós de borda e depois pare 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 SymasLDAP está em execução.
    4. Iniciar qpid
    5. Verifique 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 Postgres
    10. Iniciar a nova interface do Edge