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

Para instalar o Edge em um nó, primeiro instale o utilitário apigee-setup do Edge. Se você estiver em um ambiente em que os nós não têm uma conexão externa com a Internet, também será necessário instalar uma cópia local do repositório do 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 mudar esse diretório. No entanto, se quiser, você pode criar um symlink para mapear /opt/apigee para outro local. Consulte Requisitos de instalação para mais informações.

Pré-requisito: desativar o SELinux

É preciso desativar o SELinux ou defini-lo como permissivo antes de instalar o utilitário Edge apigee-setup ou qualquer componente do Edge. Se necessário, depois de instalar o Edge, você pode reativar o SELinux.

  • Para definir o SELinux como permissivo temporariamente, execute o seguinte comando:
    • 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
    • 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 definir o modo permissivo:
    1. Abra /etc/sysconfig/selinux em um editor.
    2. Defina SELINUX=disabled ou SELINUX=permissive
    3. Salve as 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 o repositório EPEL

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

  • Para o Red Hat Enterprise Linux (RHEL) 8.0, consulte Pré-requisitos para o 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 o AWS-2: 
    sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

Pré-requisito: verifique 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 dos RPMs libdb4 antes de instalar. O Edge requer a versão 4.8, e algumas versões do RedHat 7.4 e do CentOS 7.4 são fornecidas com uma versão mais recente. Se você tiver uma versão mais recente, desinstale-a. O instalador do Edge vai instalar a versão 4.8.

Use o seguinte comando para verificar sua versão:

rpm -qa | grep libdb4

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

Pré-requisitos para o RHEL 8

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

  1. Ative os 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: 
    sudo dnf install -y python2

Pré-requisitos para o Amazon Linux 2023(AL2023)

Se você estiver instalando o Edge em um servidor que executa o Amazon-Linux-2023(AL2023), siga estas etapas antes de realizar a instalação: 

USE_CQLUTIL=y

Instalar o utilitário apigee-setup do Edge 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ê tiver um username:password para o site FTP da Apigee, use essas credenciais.
  2. Faça login no nó como root para instalar os 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 sua versão do libdb4.
  7. Se você estiver instalando no RHEL 8, siga as etapas em Pré-requisitos para o 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 do 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.52.02.sh do Edge em /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  11. Instale o utilitário apigee-service do Edge e as dependências: 
    sudo bash /tmp/bootstrap_4.52.02.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á necessário inserir essa informação.

    Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Se não tiver, ele vai instalar para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa os seguintes valores:

    • I: Instale o OpenJDK 1.8 (padrão)
    • C: Continuar sem instalar o Java
    • P: Sair. Para essa opção, você precisa instalar o Java.

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

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

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

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

Solução de problemas

Ao tentar instalar em um nó com uma conexão de Internet externa, é possível 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 sua senha da Apigee.
Problemas de conectividade

Teste a conectividade de rede executando o seguinte comando ncat:

nc -v software.apigee.com 443

Você vai receber uma mensagem semelhante a esta:

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

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

telnet software.apigee.com 443

Se os comandos forem executados com êxito, use CTRL+C para interromper a conexão aberta.

Se um dos comandos falhar, você terá conectividade de rede limitada ou nenhuma. Consulte o administrador da 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 seu nome de usuário e 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 estendeu 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:

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

Instalar o utilitário apigee-setup do Edge em um nó sem conexão externa com a Internet

Se os nós de borda estiverem atrás de um firewall ou proibidos de acessar a Internet, crie 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 de Internet requer acesso aos seguintes repositórios locais:

Criar um repositório local da Apigee

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

Depois de criar um repositório local do Apigee, talvez seja necessário atualizá-lo com os arquivos da versão mais recente do Edge. As seções a seguir descrevem como criar e atualizar um repositório local do 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 FTP da Apigee, use essas credenciais.
  2. Faça login no nó como raiz para instalar os RPMs do Edge.
  3. Desative o SELinux conforme descrito acima.
  4. Faça o download do arquivo bootstrap_4.52.02.sh do Edge em /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  5. Instale o utilitário e as dependências do Edge apigee-service: 
    sudo bash /tmp/bootstrap_4.52.02.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á necessário inserir essa informação.

  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 repositório, inclua o --only-new-rpms para baixar apenas os RPMs mais recentes.

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

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

Você tem duas opções para instalar o Edge no repositório local. Você pode fazer o seguinte:

  • Crie um arquivo .tar do repositório, copie-o para um nó e instale o Edge usando o 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 você pode usar seu próprio servidor da Web.

Instalar do arquivo .tar

Para instalar do arquivo .tar:

  1. No nó com o repositório local, use o comando a seguir para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.52.02.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 para o diretório /tmp no novo nó.
  3. No novo nó, desative o SELinux, conforme descrito acima.
  4. No novo nó, verifique se é possível acessar o repositório de utilitários Yum local e o repositório EPEL.
  5. Confira se todos os repositórios externos da Internet estão desativados. Isso deve acontecer porque você está instalando em uma máquina sem acesso à Internet: 
    sudo yum repolist

    Todos os repositórios externos precisam ser desativados, mas o repositório local do Apigee e os repositórios internos precisam estar ativados.

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

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

  7. No novo nó, verifique sua 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.52.02.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 apigee-service do Edge e as dependências de /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Observe que você inclui o caminho para o diretório "repos" 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 do Edge em um nó para mais informações.

Instalar 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ó do repositório:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Por padrão, o Nginx é configurado para usar localhost como 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, caso ele não exista.
    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 exige um nome de usuário:senha de admin:admin. Para mudar 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 sua versão do libdb4 conforme descrito acima.
  8. No nó remoto, faça o download do arquivo bootstrap_4.52.02.sh do Edge para /tmp/bootstrap_4.52.02.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

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

  9. No nó remoto, instale o utilitário e as dependências do Edge apigee-service: 
    sudo bash /tmp/bootstrap_4.52.02.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 repositório.

  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 componentes do Edge no nó remoto. Consulte Instalar componentes do Edge em um nó para mais informações.

Atualizar um repositório local da Apigee

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

Para atualizar o repositório:

  1. Baixe o arquivo Edge bootstrap_4.52.02.sh para /tmp/bootstrap_4.52.02.sh: 
    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. Execute o arquivo bootstrap_4.52.02.sh do Edge: 
    sudo bash/tmp/bootstrap_4.52.02.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 inserir esse valor.

  3. Atualize 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 todo o repositório: 
    /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.52.02

Se você precisar manter instalações do Edge 4.16.0x ou 4.17.0x em um repositório 4.52.02, é possível manter 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.52.02:

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

    Você vai ver um resultado no formato abaixo, em que xyz é o número do build:

    apigee-mirror-4.52.02-0.0.xyz
  2. Use o utilitário apigee-mirror para fazer o download do Edge 4.16.0x/4.17.0x no 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 o mesmo comando para atualizar os repositórios 4.16.0x/4.17.0x depois, especificando os números de versão necessários.

  3. Examine o diretório /opt/apigee/data/apigee-mirror/repos para conferir a estrutura de arquivos: 
    ls /opt/apigee/data/apigee-mirror/repos

    Você vai encontrar 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

    Note que você tem um arquivo de bootstrap 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 agrupa 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 no repositório local ou no arquivo .tar, execute o arquivo de bootstrap correto usando um dos seguintes comandos. Este exemplo instala o Edge 4.17.01:

  • Se você estiver instalando de um arquivo .tar, execute o arquivo de bootstrap correto 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 em "Instalar do arquivo .tar" acima.

  • Se você estiver instalando usando o servidor da Web Nginx, faça o download e execute o arquivo de bootstrap 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.