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 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 mudar 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

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

  • Para desativar o SELinux permanentemente ou defini-lo como 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 esse procedimento para definir SELINUX=enabled.

    • Pré-requisito: ativar o repositório EPEL

    É necessário ativar os Pacotes extras para o Enterprise Linux (EPEL, na sigla em inglês) para instalar ou atualizar o Edge ou para criar um repositório local. Para o Red Hat Enterprise Linux (RHEL) 9.x, o Rocky Linux 9.x ou o Oracle Linux 9.x, execute os seguintes comandos:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Pré-requisito para RHEL 9/Rocky 9/Oracle 9

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

    1. Ative os Pacotes extras para o Enterprise Linux (EPEL): 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Desative o Postgres e o Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Para as mudanças de pré-instalação do PostgreSQL e do LDAP, consulte Requisitos de pré-instalação do banco de dados PostgreSQL e Mudanças de pré-instalação do SymasLDAP 2.6.10, respectivamente.

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

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

    1. Receba 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, poderá usar essas credenciais.
    2. Faça login no nó como raiz para instalar os RPMs do Edge
    3. Desative o SELinux.
    4. Ative o repositório EPEL.
    5. Se você estiver instalando no RHEL 9/Rocky 9/Oracle 9, siga as etapas em Pré-requisitos para RHEL 9/Rocky 9/Oracle 9.
    6. Faça o download do arquivo bootstrap_4.54.00.sh do Edge para /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Instale o utilitário apigee-service do Edge e as dependências: 
      sudo bash /tmp/bootstrap_4.54.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 que o insira.

      O Apigee Edge para nuvem privada 4.54.00 exige suporte duplo do Java com o Java 17 e o Java 21 instalados no nó. É necessário instalar o Java 17 e o Java 21 antes de executar o script de inicialização. O instalador só verifica se as duas versões do JDK estão instaladas. Ele não instala o Java automaticamente.

      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 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*'
    8. Use o apigee-service para instalar o utilitário apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    9. 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, você pode encontrar um ou mais dos seguintes erros:

    Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.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

    Teste a conectividade de rede executando o seguinte ncat comando:

    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 nc instalado, execute o seguinte telnet comando:

    telnet software.apigee.com 443

    Se os comandos forem bem-sucedidos, use CTRL + C para cancelar 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 ao yum gerenciador de pacotes. 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 de internet externa

    Se os nós do Edge estiverem atrás de um firewall ou de alguma outra forma 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 de Internet exige acesso a os 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 dependências do Edge. Depois de criar o repositório interno, você poderá 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 lançamento 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. Receba o nome de usuário e a senha da Apigee que você usa para acessar o repositório da Apigee. Se você tiver um nome de usuário:senha para o site FTP da Apigee, poderá usar 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.54.00.sh do Edge para /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Instale o utilitário apigee-service do Edge e as dependências: 
      sudo bash /tmp/bootstrap_4.54.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 que o insira.

    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 /opt/apigee/data/apigee-mirror/repos/ diretório.

      Para minimizar o tamanho do repositório, inclua --only-new-rpms para fazer o download apenas dos 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.54.00.sh no repositório local para instalar o apigee-service utilitário: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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 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 arquivo .tar para um nó e instale o Edge no 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 seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.54.00.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 /tmp diretório 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 local do utilitário Yum e o repositório EPEL.
    5. Verifique se todos os repositórios externos da Internet estão desativados (esse deve ser o caso porque você está instalando em uma máquina sem acesso à Internet): 
      sudo yum repolist

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

    6. Use apigee-service para instalar o utilitário apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. 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 o 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 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 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ó, verifique se o repositório EPEL está ativado localmente.
    5. No novo nó, verifique sua versão do libdb4 conforme descrito acima.
    6. No nó remoto, instale o utilitário apigee-service do Edge e as dependências: 
      sudo bash /tmp/bootstrap_4.54.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 repositório.

    7. No nó remoto, use apigee-service para instalar o apigee-setup utilitário: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    8. 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.54.00.sh mais recente e, em seguida, execute uma nova sincronização.

    Para atualizar o repositório:

    1. Faça o download do arquivo bootstrap_4.54.00.sh do Edge para /tmp/bootstrap_4.54.00.sh: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. Execute o arquivo bootstrap_4.54.00.sh do Edge: 
      sudo bash/tmp/bootstrap_4.54.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 que o insira.

    3. Atualize apigee-mirror: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
    4. Realize 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