Instalar o utilitário Edge de configuração da Apigee

Edge para nuvem privada v. 4.17.09

Para instalar o Edge em um nó, primeiro instale o utilitário de configuração da Apigee do Edge. Se você estiver em um ambiente em que os nós não têm uma conexão de Internet externa, instale uma cópia local do repositório da Apigee.

Diretório de instalação padrão: /opt/apigee

O Edge instala todos os arquivos no diretório /opt/apigee. Não é possível alterar esse diretório. No entanto, se quiser, você pode criar um link simbólico para mapear /opt/apigee para outro local. Consulte Requisitos de instalação para mais informações.

Pré-requisito: desativar o SELinux

Desative o SELinux ou configure-o para o modo permissivo antes de instalar o utilitário apigee-setup do Edge ou qualquer componente do Edge. Se necessário, depois de instalar o Edge, será possível reativar o SELinux.

  • Para definir temporariamente o SELinux para o modo permissivo, execute o seguinte comando:
    1. Em um sistema operacional Linux 6.x: 
      > sudo echo 0 > /selinux/enforce

      Para reativar o SELinux depois de instalar o Edge:

      > sudo echo 1 > /selinux/enforce
    2. Em um sistema operacional Linux 7.x: 
      > sudo setenforce 0

      Para reativar o SELinux depois de instalar o Edge:

      > sudo setenforce 1
  • Para desativar permanentemente o SELinux ou defini-lo para o modo permissivo:
    1. Abra /etc/sysconfig/selinux em um editor.
    2. Defina SELINUX=disabled ou SELINUX=permissive
    3. Salve suas edições.
    4. Reinicie o nó.
    5. Se necessário, reative o SELinux após a instalação do Edge repetindo esse procedimento para definir SELINUX=enabled.

Pré-requisito: ativar o repositório EPEL

Ative os Pacotes extras do Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge ou criar um repositório local. O comando usado depende da sua versão do RedHat/CentOS:

  • Para RedHat/CentOS/Oracle 7.x: 
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • Para RedHat/CentOS/Oracle 6.x: 
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Pré-requisito: verifique a versão da biblioteca libdb4 no RedHat 7.4 e CentOS 7.4

No RedHat 7.4 e CentOS 7.4, verifique a versão dos RPMs libdb4 antes de fazer a instalação. O Edge requer a versão 4.8, e algumas versões do RedHat 7.4 e CentOS 7.4 vêm com uma versão mais recente.

Use o seguinte comando para verificar sua versão:

> rpm -qa | grep libdb

Se você perceber que a versão da RPM libdb4 é posterior à versão 4.8, use o seguinte comando para substituir as RPMs:

> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm

Se você tiver que fazer o download dessas RPMs, poderá consegui-las em:

Instalar o utilitário de configuração da Apigee do Edge em um nó com uma conexão de Internet externa

Para instalar o Edge em um nó com uma conexão externa à Internet:

  1. Consiga o nome de usuário e a senha da Apigee que você usa para acessar o repositório da Apigee. Se você já tiver um nome de usuário:senha para o site de FTP da Apigee, poderá usar essas credenciais.
  2. Faça login no nó como raiz para instalar as RPMs do Edge
  3. Instale yum-utils e yum-plugin-priorities: 
    > sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
  4. Desative o SELinux conforme descrito acima.
  5. Ative o repositório EPEL conforme descrito acima.
  6. Se você estiver instalando na AWS, execute o seguinte comando yum-configure-manager: 
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Faça o download do arquivo bootstrap_4.17.09.sh do Edge em /tmp/bootstrap_4.17.09.sh: 
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Instale o utilitário e as dependências do serviço da Apigee do Edge: 
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir o campo pWord, será necessário inseri-lo.

    Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, ele vai instalar o pacote para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa estes valores:

    • I = Instalar o OpenJDK 1.8 (padrão)
    • C = Continuar sem instalar o Java
    • Q = sair. Para essa opção, você precisa instalar o Java por conta própria.

    A instalação do utilitário apigee-service cria o arquivo /etc/yum.repos.d/apigee.repo que define o repositório da Apigee. Para acessar o arquivo de definição, use o comando:

    > cat /etc/yum.repos.d/apigee.repo

    Para ver o conteúdo do repositório, use o comando:

    > sudo yum -v repolist 'apigee*'
  9. Use apigee-service para instalar o utilitário apigee-setup: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Use apigee-setup para instalar e configurar componentes de borda no nó. Consulte Instalar componentes do Edge em um nó para saber mais.

Instalar o utilitário de configuração da Apigee do Edge em um nó sem conexão de Internet externa

Se os nós do Edge estiverem protegidos por firewall ou, de alguma outra forma, forem proibidos de acessar o repositório da Apigee pela Internet, será necessário criar um repositório local, ou espelho, do repositório da Apigee. Dessa forma, esse espelho precisa estar acessível para todos os nós. Depois de criados, os nós podem acessar esse espelho local para instalar o Edge.

Para criar o repositório interno da Apigee, é necessário ter um nó com acesso externo à Internet para fazer o download das RPMs e dependências do Edge. Depois de criar o repositório interno, é possível movê-lo para outro nó ou tornar esse nó acessível aos nós do Edge para instalação.

Depois de criar um repositório local do Edge, talvez seja necessário atualizá-lo com os arquivos de lançamento mais recentes do Edge. As seções a seguir descrevem como criar um repositório local e como atualizá-lo.

Criar um repositório local da Apigee

Para criar um repositório local da Apigee:

  1. Consiga o nome de usuário e a senha da Apigee que você usa para acessar o repositório da Apigee. Se você já tiver um nome de usuário:senha para o site de FTP da Apigee, poderá usar essas credenciais.
  2. Faça login no nó como raiz para instalar as RPMs do Edge.
  3. Instale yum-utils e yum-plugin-priorities: 
    > sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
  4. Desative o SELinux conforme descrito acima.
  5. Ative o repositório EPEL conforme descrito acima.
  6. Se você estiver instalando na AWS, execute o seguinte comando yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Faça o download do arquivo bootstrap_4.17.09.sh do Edge em /tmp/bootstrap_4.17.09.sh: 
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Instale o utilitário e as dependências do Edge apigee-service: 
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir o campo pWord, será necessário inseri-lo.

  9. Instale o utilitário apigee-mirror no nó: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  10. Use o utilitário apigee-mirror para sincronizar o repositório da Apigee com o diretório /opt/apigee/data/apigee-mirror/repos/.

    Para minimizar o tamanho do repositório, inclua o --only-new-rpms para fazer o download apenas das RPMs mais recentes. São necessários aproximadamente 1,6 GB de espaço em disco para o download: 

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Se você quiser fazer o download do repositório inteiro, incluindo RPMs mais antigas, omita --only-new-rpms. São necessários aproximadamente 6 GB de espaço em disco para o download completo: 

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Agora você tem uma cópia local do repositório da Apigee. A próxima seção descreve como instalar o utilitário apigee-setup do Edge a partir do repositório local.

  11. (Opcional) Se você quiser instalar o Edge a partir do repositório local no mesmo nó que hospeda o repositório local, primeiro execute os comandos a seguir:
    1. Execute bootstrap_4.17.09.sh a partir do repositório local para instalar o utilitário apigee-service: 
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.sh apigeeprotocol="file://"
  apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Use apigee-service para instalar o utilitário apigee-setup: 
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Use apigee-setup para instalar e configurar componentes de borda no nó. Consulte Instalar componentes do Edge em um nó para saber mais.

Instalar o apigee-setup em um nó remoto do repositório local

Você tem duas opções para instalar o Edge pelo repositório local. você tem as seguintes opções:

  • Crie um arquivo .tar do repositório, copie-o em um nó e instale o Edge a partir desse arquivo.
  • Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. A Apigee fornece o servidor da Web Nginx para você usar, mas também é possível usar seu próprio servidor da Web.

Instale a partir do arquivo .tar:

  1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Copie o arquivo .tar para o nó em que você quer instalar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
  3. Instale yum-utils e yum-plugin-priorities: 
    > sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
  4. No novo nó, desative o SELinux conforme descrito acima.
  5. Ative o repositório EPEL conforme descrito acima.
  6. No novo nó, descompacte o arquivo no diretório /tmp:
    > tar -xzf apigee-4.17.09.tar.gz

    Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo /tmp/repos.

  7. Instale o utilitário de serviço da Apigee e as dependências de /tmp/repos: 
    > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Observe que você incluiu o caminho para o diretório de repositórios nesse comando.

  8. Use apigee-service para instalar o utilitário apigee-setup: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    .
  9. Use apigee-setup para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes do Edge em um nó para saber mais.

Instale a partir do repositório usando o servidor da Web Nginx:

  1. Instale o servidor da Web Nginx no nó de repositório: 
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Por padrão, o Nginx está configurado para usar localhost como o nome do servidor e a porta 3939. Para mudar esses valores, faça o seguinte:
    1. Abra /opt/apigee/customer/application/mirror.properties em um editor. Crie o arquivo se ele não existir.
    2. Defina os seguintes valores, conforme necessário: 
      conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost
    3. Reinicie o Nginx:
      > /opt/nginx/scripts/apigee-nginx restart
  3. Por padrão, o repositório requer um username:password de admin:admin. Para alterar essas credenciais, defina as seguintes variáveis de ambiente: 
    MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
  4. Instale yum-utils e yum-plugin-priorities: 
    > sudo yum install yum-utils > sudo yum install yum-plugin-priorities
  5. No novo nó, desative o SELinux conforme descrito acima.
  6. Ative o repositório EPEL conforme descrito acima.
  7. No nó remoto, faça o download do arquivo Edge bootstrap_4.17.09.sh para /tmp/bootstrap_4.17.09.sh: 
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

    em que uName:pWord é o nome de usuário e a senha que você definiu acima para o repositório, e remoteRepo é o endereço IP ou nome DNS do nó do repositório.

  8. No nó remoto, instale o utilitário apigee-service e as dependências do Edge: 
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName
  apigeepassword=pWord apigeeprotocol=http://

    em que uName:pWord é o nome de usuário e a senha do repositório.

  9. No nó remoto, use apigee-service para instalar o utilitário apigee-setup: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Use apigee-setup para instalar e configurar componentes de borda no nó remoto. Consulte Instalar componentes do Edge em um nó para saber mais.

Atualizar um repositório local da Apigee

Para atualizar o repositório, faça o download do arquivo bootstrap_4.17.09.sh mais recente e execute uma nova sincronização:

  1. Faça o download do arquivo Edge bootstrap_4.17.09.sh para /tmp/bootstrap_4.17.09.sh: 
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  2. Execute o arquivo bootstrap_4.17.09.sh do Edge: 
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir o campo pWord, será necessário inseri-lo.

  3. Atualizar apigee-mirror: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Faça a sincronização: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Se você quiser fazer o download do repositório inteiro: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Limpar um repositório local da Apigee

A limpeza do repositório local exclui /opt/apigee/data/apigee-mirror e /var/tmp/yum-apigee-*.

Para limpar o repositório local, use:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Adicionar ou atualizar o Edge 4.16.0x/4.17.0x em um repositório 4.17.09

Se você precisar manter instalações do Edge 4.16.0x ou 4.17.01/4.17.05 em um repositório 4.17.09, mantenha um repositório que contenha todas as versões. Nesse repositório, é possível instalar qualquer versão do Edge.

Para adicionar 4.16.0x/4.17.0x a um repositório 4.17.09:

  1. Verifique se você instalou a versão 4.17.09 do utilitário apigee-mirror: 
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Você verá um resultado no formulário abaixo, em que xyz é o número da versão:

    apigee-mirror-4.17.09-0.0.xyz
  2. Use o utilitário apigee-mirror para fazer o download do Edge 4.16.0x/4.17.01/4.17/05 para seu repositório. Observe como você prefixa o comando com a versão desejada: 
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Use esse mesmo comando para atualizar posteriormente os repositórios 4.16.0x/4.17.05 especificando os números de versão necessários.

  3. Examine o diretório /opt/apigee/data/apigee-mirror/repos para ver a estrutura do arquivo: 
    > ls /opt/apigee/data/apigee-mirror/repos

    Você verá os seguintes arquivos e diretórios: 

    apigee apigee-repo-1.0-6.x86_64.rpm
bootstrap_4.16.01.sh
bootstrap_4.16.05.sh
bootstrap_4.17.01.sh
bootstrap_4.17.05.sh 
bootstrap_4.17.09.sh
thirdparty

    Observe que há um arquivo de inicialização para todas as versões do Edge. O diretório apigee também contém diretórios separados para cada versão do Edge.

  4. Para empacotar o repositório em um arquivo .tar, use o seguinte comando: 
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Esse comando empacota todos os repositórios 4.17.0x e 4.16.0x no mesmo arquivo .tar. Não é possível empacotar apenas parte do repositório.

Para instalar o Edge a partir do repositório local ou do arquivo .tar, execute o arquivo de inicialização correto usando um dos comandos a seguir. Este exemplo instala o Edge 4.17.01:

  • Se a instalação for feita com um arquivo .tar, execute o arquivo de inicialização correto no repositório: 
    > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Para concluir a instalação, siga as etapas restantes em "Instalar usando o arquivo .tar" acima.

  • Se você estiver instalando o servidor da Web Nginx, faça o download e execute o arquivo de inicialização correto do repositório: 
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Para concluir a instalação, siga as etapas restantes em "Instalar do repositório usando o servidor da Web Nginx" acima.