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

Para instalar o Edge em um nó, primeiro você precisa instalar o utilitário Edge de configuração da Apigee. Se você estiver em um ambiente em que os nós não tenham uma conexão de Internet externa, também será necessário instalar uma cópia local do repo 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, reative o SELinux depois da instalação do Edge.

  • Para definir temporariamente o SELinux no modo permissivo, execute o seguinte comando:
    • Em um sistema operacional Linux 8.x:
      sudo setenforce 0

      Para reativar o SELinux após a instalação do Edge:

      sudo setenforce 1
    • Em um sistema operacional Linux 7.x:
      sudo setenforce 0

      Para reativar o SELinux após a instalação do Edge:

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

      Para reativar o SELinux após a instalação do Edge:

      sudo echo 1 > /selinux/enforce
  • Para desativar permanentemente o SELinux ou configurá-lo para o modo permissivo:
    1. Abra /etc/sysconfig/selinux em um editor.
    2. Definir 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 este procedimento para definir SELINUX=enabled.

Pré-requisito: Ativar repositório EPEL

Ative os pacotes extras para o 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 o Red Hat Enterprise Linux (RHEL) 8.0, consulte os Pré-requisitos do RHEL 8.

  • Para Red Hat/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 Red Hat/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
  • Para AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

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

No RedHat 7.4 e no CentOS 7.4, verifique a versão das RPMs libdb4 antes da instalação. O Edge requer a versão 4.8, e algumas versões do RedHat 7.4 e CentOS 7.4 são fornecidas com uma versão posterior. Se você tiver uma versão posterior, desinstale-a e o instalador do Edge instalará a versão 4.8.

Você pode usar o seguinte comando para verificar sua versão:

rpm -qa | grep libdb4

Se a versão da RPM libdb4 for posterior à 4.8, desinstale-a.

Pré-requisitos do RHEL 8

Se você estiver instalando o Edge em um servidor que executa o Red Hat Enterprise Linux (RHEL) 8, siga estas etapas antes de realizar a instalação:

  1. Ative Pacotes extras para Enterprise Linux (EPEL):
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Desative o Postgres e o NGINX:
    sudo dnf module disable postgresql
    sudo dnf module disable nginx
  3. Instale o Python 2 e crie um link simbólico:
    sudo dnf install -y python2
    sudo ln -s /usr/bin/python2 /usr/bin/python

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

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

  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 username:password 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.
  5. Ative o repositório EPEL.
  6. Verifique a versão do libdb4.
  7. Se você estiver instalando no RHEL 8, siga as etapas em Pré-requisitos do RHEL 8.
  8. Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
    sudo yum-config-manager --enable ol7_optional_latest
  9. Se você estiver instalando na AWS, execute os seguintes comandos yum-configure-manager:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Faça o download do arquivo bootstrap_4.51.00.sh do Edge para /tmp/bootstrap_4.51.00.sh:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  11. Instale o utilitário de serviço de borda da Apigee e as dependências:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado a inseri-lo.

    Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, ele será instalado para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX assume os seguintes valores:

    • I: Instalar o OpenJDK 1.8 (padrão)
    • C: Continuar sem instalar o Java
    • P: 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 ver 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*'
  12. Use o serviço apigee para instalar o utilitário de configuração da apigee:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Use a configuração da Apigee para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes do Edge em um nó para saber mais.

Solução de problemas

Ao tentar instalar em um nó com uma conexão de Internet externa, você pode encontrar um ou mais dos seguintes erros:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

A tabela a seguir lista algumas possíveis soluções para esses erros:

Tipo de erro Possível solução
A senha contém caracteres inválidos Não use caracteres especiais na senha da Apigee.
Problemas de conectividade

Execute o seguinte comando ncat para testar a conectividade de rede:

nc -v software.apigee.com 443

Você verá uma mensagem semelhante à seguinte:

Connection to software.apigee.com 443 port [tcp/https] succeeded!

Se você não tiver nc instalado, execute o seguinte comando telnet:

telnet software.apigee.com 443

Se os comandos forem concluídos, use CTRL+C para cancelar a conexão aberta.

Se um dos comandos falhar, você tem conectividade de rede limitada ou cancelada. Verifique com o administrador de rede.

Credenciais incorretas

Verifique se o nome de usuário e a senha estão corretos.

Por exemplo, verifique se você recebe um erro ao tentar usar o seguinte comando com o nome de usuário e a senha da Apigee:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
Problemas de proxy Sua configuração local usa um proxy HTTP de saída e você não ampliou a mesma configuração para o gerenciador de pacotes yum. Verifique as variáveis de ambiente:
echo $http_proxy
echo $https_proxy

Para um proxy HTTP de saída, use uma das seguintes opções:

  • Adicionar uma configuração de proxy HTTP em /etc/yum.conf
  • Adicionar a configuração de proxy HTTP global em /etc/environment

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

Se os nós de borda estiverem protegidos por firewall ou, de alguma outra forma, forem proibidos de acessar a Internet, será necessário criar vários repositórios ou espelhos que contenham os arquivos necessários durante a instalação. Esses espelhos precisam estar acessíveis a todos os nós. Depois de criados, os nós podem acessar esses espelhos locais para instalar o Edge.

O processo de instalação do Apigee Edge para nós sem conexões com a Internet requer acesso aos seguintes repositórios locais:

Criar um repositório local da Apigee

Para criar o repositório interno da Apigee, você precisa de 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 da Apigee, talvez seja necessário atualizá-lo com os arquivos de versão mais recentes do Edge. As seções a seguir descrevem como criar um repositório local da Apigee e como atualizá-lo.

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 do FTP da Apigee, use essas credenciais.
  2. Faça login no nó como raiz para instalar as RPMs do Edge.
  3. Desative o SELinux conforme descrito acima.
  4. Faça o download do arquivo bootstrap_4.51.00.sh do Edge para /tmp/bootstrap_4.51.00.sh:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  5. Instale o utilitário de serviço de borda da Apigee e as dependências:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado a inseri-lo.

  6. Instale o utilitário apigee-mirror no nó:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. 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 repo, inclua o --only-new-rpms para fazer o download apenas das RPMs mais recentes. Você precisa de 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 as RPMs mais antigas, omita --only-new-rpms. Você precisa de 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. Na próxima seção, descrevemos como instalar o utilitário Edge apigee-setup do repo local.

  8. (Opcional) Se você quiser instalar o Edge a partir do repo local no mesmo nó que hospeda o repo local, primeiro precisará executar os seguintes comandos:
    1. Execute bootstrap_4.51.00.sh no repositório local para instalar o utilitário apigee-service:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.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 do Edge no nó. Consulte Instalar componentes de Edge em um nó para mais informações.

Instalar a configuração da Apigee em um nó remoto a partir do repo local

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

  • Crie um arquivo .tar do repo, copie o arquivo .tar em um nó e instale o Edge a partir do arquivo .tar.
  • 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 ou é possível usar seu próprio servidor da Web.

Instalar a partir do arquivo .tar

Para instalar a partir do arquivo .tar:

  1. No nó com o repo local, use o seguinte comando para empacotar o repo local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Copie o arquivo .tar no nó em que você quer instalar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
  3. No novo nó, desative o SELinux conforme descrito acima.
  4. No novo nó, verifique se você pode acessar o repositório do utilitário local do Yum e o repositório do EPEL.
  5. Verifique se todos os repositórios de Internet externos estão desativados. Esse é o caso porque você está instalando em uma máquina sem acesso à Internet:
    sudo yum repolist

    Todos os repositórios externos precisam ser desativados, mas o repo local da Apigee e seus repositórios internos precisam estar ativados.

  6. No novo nó, instale yum-utils e yum-plugin-priorities a partir do seu repositório local:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    Sua equipe de operações ou outro grupo na sua organização precisa configurar um repositório local para que você possa instalar as ferramentas do Yum.

  7. No novo nó, verifique a versão do libdb4 conforme descrito acima.
  8. Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
    sudo yum-config-manager --enable ol7_optional_latest
  9. 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
  10. No novo nó, descompacte o arquivo no diretório /tmp:
    tar -xzf apigee-4.51.00.tar.gz

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

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

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

  12. Use apigee-service para instalar o utilitário apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Use apigee-setup para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes de Edge em um nó para mais informações.

Instalar a partir do repositório usando o servidor da Web NGINX

Para instalar 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 o localhost como o nome do servidor e a porta 3939. Para mudar esses valores:
    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 repo exige um nome de usuário:senha de admin:admin. Para alterar essas credenciais, defina as seguintes variáveis de ambiente:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. No novo nó, 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. No novo nó, verifique se o repositório EPEL local está ativado.
  7. No novo nó, verifique a versão do libdb4 conforme descrito acima.
  8. No nó remoto, faça o download do arquivo Edge bootstrap_4.51.00.sh para /tmp/bootstrap_4.51.00.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

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

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

    Em que uName:pWord são o nome de usuário e a senha do repo.

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

Atualizar um repositório local da Apigee

Para atualizar o repo, você precisa fazer o download do arquivo bootstrap_4.51.00.sh mais recente e realizar uma nova sincronização.

Para atualizar o repositório:

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

    Em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado a inseri-lo.

  3. Atualizar apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Execute a sincronização:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Se quiser um 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 repo 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.51.00

Se você precisar manter instalações para o Edge 4.16.0x ou 4.17.0x em um repositório 4.51.00, será possível manter um repositório que contenha todas as versões. A partir desse repositório, é possível instalar qualquer versão do Edge.

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

  1. Verifique se você instalou a versão 4.51.00 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.51.00-0.0.xyz
  2. Use o utilitário apigee-mirror para fazer o download do Edge 4.16.0x/4.17.0x para seu repo. Observe como prefixar 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 este mesmo comando para atualizar posteriormente os repositórios 4.16.0x/4.17.0x 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
    bootstrap_4.18.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

    Observe como você tem 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 repo.

Para instalar o Edge a partir do arquivo .tar ou repo local, basta executar o arquivo de inicialização correto usando um dos seguintes comandos. Este exemplo instala o Edge 4.17.01:

  • Se estiver instalando a partir de um arquivo .tar, execute o arquivo de inicialização correto a partir do 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 de "Instalar do arquivo .tar" acima.

  • Se estiver instalando usando 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 de "Instalar a partir do repositório usando o servidor da Web NGINX" acima.