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.

    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 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, 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:
    /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. Interrompa 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.

    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 todos os componentes:
    /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.

  1. Reinstale o Cassandra:
    /opt/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:
    /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ó precisa transmitir seu nome de usuário e senha se tiver ativado a autenticação JMX para o Cassandra.

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:
    /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". 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 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 o 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.

    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 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

OpenLDAP

  1. Interrompa 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 antigos do OpenLDAP:
    /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d
  4. Restaure o OpenLDAP:
    /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". 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 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. Interrompa 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". 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 o servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

processador de mensagens

  1. Interrompa 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". 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 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

IU do Edge

  1. Interromper a 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 do arquivo de backup:
    /opt/apigee/apigee-service/bin/apigee-service edge-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. Reiniciar a interface:
    /opt/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, interrompa 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