Após uma instalação bem-sucedida do Edge, há algumas tarefas comuns que convém realizar para validar a instalação, ajustar e personalizar a configuração. Essas tarefas incluem:
Tarefa | Descrição |
---|---|
Invocar comandos em componentes do Edge | Use o utilitário apigee-service para iniciar, interromper, reiniciar e conferir o status de cada componente do Edge. |
Configurar componentes do Edge | Use os arquivos de propriedades para alterar as configurações padrão do componente Edge. |
Executar o apigee-validate | Invoque os scripts de teste para garantir que a instalação de cada componente tenha sido bem-sucedida. |
Ajustar configurações de heap da JVM | Otimizar as configurações de memória Java para cada nó. |
Gerenciar a política de senha LDAP | Alterar a senha LDAP padrão e definir várias configurações de autenticação. |
Instalar o apigee-monit no nó | Instale e use uma ferramenta que monitore os componentes no nó e tente reiniciá-los em caso de falha. |
Alterar a senha padrão do PostgreSQL | A Apigee recomenda que você altere a senha padrão do PostgreSQL depois de instalar o Edge para nuvem privada para manter a segurança dos seus dados. |
Configurar jobs de limpeza do PostgreSQL | Elimine os dados em excesso coletados pelo serviço de análise. |
Configurar o reparo do nodetool do Cassandra | Manutenção periódica no anel do Cassandra para garantir consistência em todos os nós. |
Ativar o início automático | Instrua o Edge para nuvem privada a reiniciar automaticamente durante uma reinicialização. |
Instalar a nova interface do Edge | A Apigee recomenda que você instale a nova interface do Edge, que é uma interface de usuário aprimorada para desenvolvedores e administradores do Apigee Edge para nuvem privada. |
Essas são apenas algumas das tarefas mais comuns que você normalmente realiza após a instalação do Edge. Para mais tarefas de operações e administração, consulte Como configurar o Edge e Operações.
Invocar comandos em componentes do Edge
O Edge instala utilitários de gerenciamento em /opt/apigee/apigee-service/bin
que podem
ser usados para gerenciar uma instalação do Edge. Por exemplo, é possível usar o utilitário apigee-all
para iniciar, parar, reiniciar ou determinar o status de todos os componentes do Edge no nó:
/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version
Use o utilitário apigee-service
para controlar e configurar componentes individuais. O utilitário apigee-service
tem o seguinte formato:
/opt/apigee/apigee-service/bin/apigee-service component_name action
Em que component_name identifica o componente. O componente precisa estar no nó em
que você executa apigee-service
. Dependendo da configuração, os valores de component_name podem incluir:
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(banco de dados PostgreSQL)apigee-qpidd
(Qpidd)apigee-sso
(SSO de borda)apigee-zookeeper
(ZooKeeper)edge-management-server
(Servidor de gerenciamento)edge-management-ui
(nova IU do Edge)edge-message-processor
(processador de mensagens)edge-postgres-server
(Servidor Postgres)edge-qpid-server
(servidor Qpid)edge-router
(roteador Edge)edge-ui
(IU clássica)
Além desses componentes, também é possível invocar apigee-service
nos componentes
apigee-provision
e apigee-validate
, dependendo da
configuração.
Por exemplo, para reiniciar o roteador de borda, execute o seguinte comando:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Você pode determinar a lista de componentes instalados no nó examinando o diretório /opt/apigee
. Esse diretório contém um subdiretório para cada componente do Edge instalado no nó. Cada subdiretório é prefixado por:
apigee
: um componente de terceiros usado pelo Edge. Por exemplo,apigee-cassandra
.edge
: um componente Edge da Apigee. Por exemplo,edge-management-server
.edge-mint
: um componente de monetização. Por exemplo,edge-mint-management-server
.
A lista completa de ações para um componente depende dele, mas todos são compatíveis com as seguintes ações:
start, stop, restart
status, version
backup, restore
install, uninstall
Configurar os componentes do Edge
Para configurar o Edge após a instalação, use uma combinação de arquivos .properties
e utilitários do Edge. Por exemplo, para configurar o TLS/SSL na IU do Edge, edite
os arquivos .properties
para definir as propriedades necessárias. Para fazer mudanças nos arquivos .properties
,
é necessário reiniciar o componente do Edge afetado.
Os arquivos .properties
estão localizados no
diretório /opt/apigee/customer/application
.
Cada componente tem o próprio arquivo .properties
nesse diretório.
Por exemplo, router.properties
e management-server.properties
.
Para definir uma propriedade para um componente, edite o arquivo .properties
correspondente e
reinicie o componente:
/opt/apigee/apigee-service/bin/apigee-service component restart
Exemplo:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Quando você atualiza o Edge, os arquivos .properties
no diretório /opt/apigee/customer/application
são lidos. Isso significa que a atualização retém
todas as propriedades que você definiu no componente.
Consulte Como configurar o Edge para mais informações sobre a configuração do Edge.
Instalar o apigee-monit no nó
Depois de concluir a instalação dos componentes em um nó, você pode adicionar o utilitário apigee-monit
. apigee-monit
vai monitorar os componentes no nó e tentar reiniciá-los se falharem.
Para mais informações, consulte Autocorreção com apigee-monit.
Configurar um servidor OpenLDAP para ser somente leitura
Se a instalação do Edge contiver um servidor OpenLDAP que não precisa ter tráfego para ele, recomendamos que você configure o servidor para ser somente leitura. Basta seguir estas etapas:
- Crie um arquivo
mark_readonly.ldif
no servidor com as seguintes linhas:dn: olcDatabase={2}bdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: TRUE
- Execute o seguinte comando no servidor para marcá-lo como somente leitura:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif
Se o servidor principal falhar, você pode voltar a usar o servidor em espera como principal da seguinte maneira:
- Crie um arquivo
mark_writable.ldif
no servidor em espera com a seguinte linha:dn: olcDatabase={2}bdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: FALSE
- Execute o seguinte comando no servidor em espera:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif