Esta página foi traduzida pela API Cloud Translation.

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 do Edge antes de restaurar o backup.

Apache ZooKeeper

Restaurar um nó independente

Interrompa o ZooKeeper:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Remova os diretórios antigos do ZooKeeper:

/opt/apigee/data/apigee-zookeeper
/opt/apigee/etc/apigee-zookeeper.d

Reinstale o ZooKeeper:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

Restaurar 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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

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 de host/endereço IP e reinstale o ZooKeeper. Quando o novo nó do ZooKeeper entrar no conjunto do ZooKeeper, ele vai receber os snapshots mais recentes do líder e começar a atender os clientes. Não é necessário restaurar os dados nessa instância.

Reinstale o ZooKeeper:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

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

Inicie o ZooKeeper:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Restaurar um cluster completo

Interrompa o cluster completo.
Restaure todos os nós do ZooKeeper do arquivo de backup, conforme descrito acima para um único nó.
Inicie o cluster do ZooKeeper.
Reinicie todos os componentes.

Apache Cassandra

Restaurar um nó independente

Pare o Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

Remova o diretório antigo do Cassandra:
```
/opt/apigee/data/apigee-cassandra
```

Reinstale o Cassandra:

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

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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

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, crie 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 de 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 do 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, crie um novo nó com o mesmo endereço IP do nó original e execute as etapas normais de bootstrap do Apigee nele.

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

Pare o processo do Cassandra no nó:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
Desinstale o software do Cassandra do nó:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
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ó com falha e pronto para a instalação do software Apigee. Siga estas etapas:

Identifique os nós de seed do data center.

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

A saída será algo assim:

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

Consulte a última linha na saída. Os endereços IP separados por vírgulas listados são os nós de seed usados pelos nós neste data center.

No nó novo que está sendo restaurado, crie ou edite o seguinte arquivo:
```
vi /opt/apigee/customer/application/cassandra.properties
```

Add the following line:

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

Se esse nó for um dos nós de seed (o endereço IP do nó aparece na lista de nós de seed 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 sementes 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"
```
Salve o arquivo e verifique se ele pertence e pode ser lido pelo usuário da Apigee:
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```

Instale o software do Cassandra:

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

Execute a configuração do Cassandra:

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

A configuração vai tentar fazer o bootstrap do serviço do Cassandra internamente. Isso pode levar muito tempo, dependendo da quantidade de dados a serem transmitidos de outros nós, da capacidade de processamento da rede etc.
[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>
```
Depois que o nó do Cassandra voltar a funcionar, use comandos padrão como abaixo para verificar se ele entrou no anel:
```
/opt/apigee/apigee-cassandra/bin/nodetool ring
/opt/apigee/apigee-cassandra/bin/nodetool status
```
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.

Reinicie o serviço do Cassandra no nó:

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

Restaurar um cluster completo

Interrompa o cluster completo.
Restaure todos os nós do Cassandra do arquivo de backup.
Inicie o cluster do Cassandra.
Reinicie todos os componentes.

Banco de dados PostgreSQL

PosgreSQL executado de forma independente ou como mestre

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.
```
/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
```

Reinstale o banco de dados PostgreSQL:

/apigee/apigee-service/bin/apigee-service apigee-postgresql install

Inicie o PostgreSQL:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

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

Reinstale o banco de dados PostgreSQL:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

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

Inicie o PostgreSQL:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

Servidor Postgres

Interrompa o servidor Postgres em todos os nós principais e em espera:

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

Remova os diretórios antigos do servidor Postgres:

/opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

Reinstale o servidor Postgres:

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

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.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Inicie o servidor Postgres em todos os nós principais e de espera:

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

Servidor Qpid e Qpidd

Pare 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

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

Reinstale o Qpidd:

/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install

Restaure 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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Inicie o Qpidd:

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

Reinstale o servidor Qpid:

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

Restaurar 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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

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

Parar o SymasLDAP:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

Reinstale o SymasLDAP:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

Remova os diretórios antigos do SymasLDAP:

/opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

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.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Reinicie o SymasLDAP:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

Reinicie todos os servidores de gerenciamento:

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

Servidor de gerenciamento

Parar o servidor de gerenciamento:

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

Remova os diretórios antigos do servidor de gerenciamento:

/opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

Reinstale o servidor de gerenciamento:

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

Restaure o servidor de gerenciamento 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, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Reinicie o servidor de gerenciamento:

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

processador de mensagens

Parar o processador de mensagens:

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

Remova os diretórios antigos do processador de mensagens:

/opt/apigee/data/edge-message-processor
/opt/apigee/etc/edge-message-processor.d

Reinstale o processador de mensagens:

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

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.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Reinicie o processador de mensagens:

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

Roteador

Parar roteador:

/opt/apigee/apigee-service/bin/apigee-service edge-router stop

Remova os diretórios antigos do roteador:

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

Reinstalar o roteador:

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

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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Reiniciar o roteador:

/opt/apigee/apigee-service/bin/apigee-service edge-router start

Interface do Edge

Parar interface:

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

Remova os diretórios da interface antiga:

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

Reinstalar interface:

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

Restaure a interface do usuário pelo 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". Você só especifica a parte de data/hora do nome do arquivo de backup.

Você pode omitir o arquivo de backup no comando restore, e o Edge usará o arquivo de backup mais recente no diretório de backup do componente.

Reiniciar interface:

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

Recuperação completa de sites

Interrompa todos os nós de componentes. A ordem de parada dos subsistemas é importante: primeiro, pare todos os nós de borda e depois pare todos os nós de repositórios de dados.
Restaure todos os componentes conforme descrito acima.
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á funcionando.
6. Iniciar servidor de gerenciamento
7. Iniciar roteadores e processadores de mensagens
8. Iniciar servidor Qpid
9. Iniciar o servidor Postgres
10. Iniciar a interface da Apigee