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

Edge para nuvem privada v4.18.05

Para instalar o Edge em um nó, primeiro instale o utilitário de configuração Edge apigee-setup. Se você estiver em um em que os nós não tenham uma conexão externa com a Internet, você também precisa instalar 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 isso 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

Antes de instalar o Edge, desative o SELinux ou configure-o para o modo permissivo Utilitário apigee-setup ou qualquer Edge componentes de solução. Se necessário, depois de instalar o Edge, você poderá reativar o SELinux.

  • Para definir o SELinux para o modo permissivo temporariamente, execute o seguinte comando:
    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
    2. Em um sistema operacional Linux 7.x: 
      sudo setenforce 0

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

      sudo setenforce 1
  • Para desativar o SELinux permanentemente ou defini-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 defina SELINUX=enabled.

Pré-requisito: ativar o repositório EPEL

Ative a opção Pacotes extras para Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge ou para criar um repositório local. A que você usa 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: verificar libdb4 no RedHat 7.4 e CentOS 7.4

No RedHat 7.4 e no CentOS 7.4, verifique a versão das RPMs libdb4 antes da instalação. Borda requer a versão 4.8 e algumas versões do RedHat 7.4 e CentOS 7.4 vêm com um para uma versão mais recente. Se você tiver uma versão mais recente, desinstale-a para que o instalador do Edge faça o seguinte: e instale a versão 4.8.

Use o seguinte comando para verificar sua versão:

rpm -qa | grep libdb4

Se você notar que a versão do RPM libdb4 é posterior à versão 4.8, desinstale reimplantá-lo.

Instalar o Edge Utilitário 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 externa de 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ê tiver um nome de usuário:senha no site de FTP da Apigee, use-os. credenciais.
  2. Faça login no seu nó como raiz 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 conforme descrito acima.
  5. Ative o repositório EPEL conforme descrito acima.
  6. Verifique sua versão do libdb4, conforme descrito acima.
  7. Se você estiver instalando no Oracle 7.x, execute o seguinte comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  8. Se você estiver instalando na AWS, execute o seguinte 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
  9. Faça o download do arquivo bootstrap_4.18.05.sh do Edge para /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  10. Instale o utilitário Edge Apigee-service e as dependências: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

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

    Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o instala para você. Use a opção JAVA_FIX para especificar 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*'
  11. Use apigee-service para instalar o utilitário de configuração da Apigee:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. Use o apigee-setup para instalar e configurar os componentes do Edge no nó. Consulte Instalar os componentes do Edge em um nó para mais informações.

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

Se os nós de borda estiverem protegidos por firewall ou, de alguma outra forma, for proibido acessar repositório da Apigee na Internet, crie um repositório local, ou espelho, do repositório da Apigee. 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 Internet externa para fazer o download de RPMs e dependências do Edge. Depois de criar o perfil repositório de dados, é possível movê-lo para outro nó ou torná-lo acessível aos nós do Edge para e instalação.

Depois de criar um repositório local do Edge, talvez seja necessário atualizá-lo com a versão mais recente Arquivos da versão de borda. As seções a seguir descrevem como criar um repositório local e como e atualizá-lo.

Criar um repositório local da Apigee

Para criar um repositório da Apigee local:

  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 nome de usuário:senha no site de FTP da Apigee, use-os. credenciais.
  2. Faça login no seu 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.18.05.sh do Edge para /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  5. Instale o utilitário de serviço da Apigee do Edge e as dependências: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    Em que uName:pWord são o nome de usuário e a senha que você recebeu a Apigee. Se você omitir pWord, será solicitado que a 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/.

    Para minimizar o tamanho do repositório, inclua o --only-new-rpms para fazer o download apenas do as 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 de todo o repositório, incluindo RPMs mais antigas, omita --only-new-rpms. Você precisa de aproximadamente 6 GB de espaço em disco para fazer 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 do repositório local.

  8. (Opcional) Se quiser instalar o Edge a partir do repositório local no mesmo nó que hospeda o repositório local, primeiro execute os seguintes comandos:
    1. Execute bootstrap_4.18.05.sh no repositório local para instalar o Utilitário apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.05.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 os componentes do Edge no nó. Consulte Instale os componentes do Edge em um nó para saber mais.

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

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

  • Crie um arquivo .tar do repositório, copie-o em um nó e instale o Edge a partir dele 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, ou você pode 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.18.05.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 /tmp no novo nó.
  3. No novo nó, desative o SELinux conforme descrito acima.
  4. No novo nó, ative o repositório EPEL conforme descrito acima.
  5. No novo nó, verifique se você desativou todos os repositórios externos da Internet. Quando você executa comando a seguir, todos os repositórios externos serão exibidos como desativados, mas o repositório local da Apigee e qualquer um dos seus repositórios internos precisa estar ativado: 
    sudo yum repolist
  6. No novo nó, instale yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  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.18.05.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 da Apigee do Edge e as dependências de /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Inclua 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 os componentes do Edge no nó. Consulte Instale os 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ó do repositório:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Por padrão, o Nginx é configurado para usar localhost como o nome do servidor e a porta 3939. Para altere 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 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ó, ative o repositório EPEL conforme descrito acima.
  7. No novo nó, verifique sua versão do libdb4, conforme descrito acima.
  8. No nó remoto, faça o download do arquivo Edge bootstrap_4.18.05.sh para /tmp/bootstrap_4.18.05.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.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 repo.

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

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

Atualizar um repositório da Apigee local

Para atualizar o repositório, faça o download do arquivo bootstrap_4.18.05.sh mais recente e execute um novo sysnc:

  1. Faça o download do arquivo Edge bootstrap_4.18.05.sh para /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. Execute o arquivo bootstrap_4.18.05.sh do Edge: 
    sudo bash/tmp/bootstrap_4.18.05.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 pWord, você será solicitado a inseri-lo.

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

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

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

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

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

    apigee-mirror-4.18.05-0.0.xyz
  2. Usar a 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 posteriormente os repositórios 4.16.0x/4.17.0x especificando o números de versão.

  3. Examine o diretório /opt/apigee/data/apigee-mirror/repos para ver o arquivo estrutura: 
    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.05.sh
thirdparty

    Observe que há um arquivo de inicialização para todas as versões do Edge. O 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 arquivo .tar, basta executar o bootstrap correto usando um dos comandos a seguir. Este exemplo instala o Edge 4.17.01:

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