Após a instalação

Após uma instalação bem-sucedida do Edge, há algumas tarefas comuns que você pode querer realizar para validar a instalação, ajustar as configurações e personalizar a configuração. Essas tarefas incluem:

Essas são apenas algumas das tarefas mais comuns que você normalmente realiza após a instalação do Edge. Para outras operações e tarefas de 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, você pode usar o utilitário apigee-all para iniciar, interromper, 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 sua 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-zookeeper (ZooKeeper)
• edge-management-server (servidor de gerenciamento)
• edge-management-ui (nova interface do Edge)
• edge-message-processor (processador de mensagens)
• edge-postgres-server (servidor Postgres)
• edge-qpid-server (servidor Qpid)
• edge-router (roteador de borda)

Além desses componentes, também é possível invocar apigee-service nos apigee-provision e apigee-validate componentes, dependendo da sua configuração.

Por exemplo, para reiniciar o roteador do Edge, execute o seguinte comando:

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

É possível determinar a lista de componentes instalados no nó examinando o /opt/apigee diretório. 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 do 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 do próprio componente, mas todos os componentes oferecem suporte às seguintes ações:

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

Configurar componentes do Edge

Para configurar o Edge após a instalação, use uma combinação de .properties arquivos e utilitários do Edge. Por exemplo, para configurar o TLS/SSL na nova interface do Edge, edite .properties arquivos para definir as propriedades necessárias. As mudanças nos arquivos .properties exigem que você reinicie o componente do Edge afetado.

Os arquivos .properties estão localizados no diretório /opt/apigee/customer/application. Cada componente tem seu 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 .properties arquivos no /opt/apigee/customer/application diretório são lidos. Isso significa que a atualização retém todas as propriedades definidas 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 de componentes em um nó, você pode adicionar o apigee-monit utilitário. O apigee-monit vai monitorar os componentes no nó e tentar reiniciá-los em caso de falha. Para mais informações, consulte Recuperação automática com apigee-monit.

Configurar um servidor SymasLDAP como somente leitura

Se a instalação do Edge contiver um servidor SymasLDAP que não precisa ter o tráfego alternado para ele, recomendamos que você configure o servidor como somente leitura. Basta seguir estas etapas:

1. Crie um arquivo mark_readonly.ldif no servidor com as seguintes linhas:

   dn: olcDatabase={2}mdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: TRUE

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

Caso o servidor principal falhe, você poderá voltar a usar o servidor de espera como principal da seguinte maneira:

1. Crie um arquivo mark_writable.ldif no servidor de espera com a seguinte linha:

     dn: olcDatabase={2}mdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: FALSE

2. Execute o seguinte comando no servidor de espera:

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif