Após a instalação

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

Estas são apenas algumas das tarefas mais comuns que você normalmente realiza depois de instalar o Edge. Para outras operações e tarefas de administração, consulte Como configurar o Edge e Operações.

Invocar comandos em componentes de borda

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, use 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 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-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, você também pode invocar apigee-service nos componentes apigee-provision e apigee-validate, dependendo da sua configuração.

Por exemplo, para reiniciar o roteador de borda, execute o seguinte comando:

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

Para determinar a lista de componentes instalados no nó, examine 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 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 dele, mas todos os componentes aceitam as 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 arquivos .properties e utilitários do Edge. Por exemplo, para configurar o TLS/SSL na interface do Edge, edite os arquivos .properties 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 o próprio arquivo .properties nesse diretório. Por exemplo, router.properties e management-server.properties.

Para definir uma propriedade de 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 definidas no componente.

Consulte Como configurar o Edge para mais informações sobre a configuração do Edge.

Instale o apigee-monit no nó

Depois de concluir a instalação dos componentes em um nó, você pode adicionar o utilitário apigee-monit. O apigee-monit monitora os componentes no nó e tenta reiniciá-los se eles falharem. Para mais informações, consulte Autocura com apigee-monit.

Configurar um servidor SymasLDAP como somente leitura

Se a instalação do Edge tiver um servidor SymasLDAP que não precisa ter o tráfego transferido para ele, recomendamos que você configure o servidor como somente leitura. Para fazer isso, siga 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 em espera como principal da seguinte maneira:

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

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

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