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

Edge for Private Cloud v. 4.16.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.

Como criar um link simbólico em /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.

Antes de criar o link simbólico, crie um usuário e um grupo com o nome "apigee". Isso é do mesmo grupo e usuário criados pelo Instalador do Edge.

Para criar o link simbólico, siga estas etapas antes de fazer o download do arquivo bootstrap_4.16.05.sh. Você precisa executar todas estas etapas como raiz:

1. Crie a "apigee" usuário e grupo:
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" Apigee
2. Crie um link simbólico de /opt/apigee para a instalação desejada. raiz:
   > ln -Ts /srv/myInstallDir /opt/apigee
   em que /srv/myInstallDir é o local desejado do Edge .
3. Mudar a propriedade da raiz de instalação e do link simbólico para "apigee" usuário:
   > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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 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:
     echo 0 > /selinux/enforce
     (link em inglês)
     Para reativar o SELinux após instalar o Edge:
     echo 1 > /selinux/enforce (link em inglês)
  2. Em um sistema operacional Linux 7.x:
     definir 0
     
     Para reativar o SELinux após instalar o Edge:
     definir aplicação 1
• Para desativar o SELinux permanentemente ou defini-lo para o modo permissivo:
  1. Abra /etc/sysconfig/selinux em uma 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 este procedimento para configure SELINUX=enabled.

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
   Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
3. Desative o SELinux conforme descrito acima.
4. Faça o download do arquivo bootstrap_4.16.05.sh do Edge em /tmp/bootstrap_4.16.05.sh:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh (link em inglês)
5. Instale o utilitário de serviço da Apigee do Edge e as dependências:
   > "sudo bash" /tmp/bootstrap_4.16.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 o pWord, será necessário digitá-lo.
   
   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 o processamento 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:
   > gato /etc/yum.repos.d/apigee.repo
   
   Para ver o conteúdo do repositório, use o comando:
   > sudo yum -v repolist 'apigee*'
6. Use apigee-service para instalar o utilitário de configuração da Apigee:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. 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.

Observação: a Apigee não hospeda todas as dependências de terceiros em nossa repositórios. É preciso fazer o download e instalar essas dependências de repositórios.

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 nó do RedHat ou do CentOS como raiz para instalar os RPMs do Edge.
   Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
3. Confira se você tem a versão mais recente do yum-utils:
   > atualizar sudo yum yum-utils
4. Desative o SELinux conforme descrito acima.
5. Faça o download do arquivo bootstrap_4.16.05.sh do Edge em /tmp/bootstrap_4.16.05.sh:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh (link em inglês)
6. Instale o utilitário de serviço da Apigee do Edge e as dependências:
   > "sudo bash" /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   em que uName:pWord é o nome de usuário e a senha que você recebeu a Apigee. Se você omitir o pWord, será necessário digitá-lo.
7. Instale o apigee-mirror no nó:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
8. Use o apigee-mirror utilitário para sincronizar o repositório da Apigee com /opt/apigee/data/apigee-mirror/repos/ diretório.
   
   Para minimizar o tamanho do repositório, inclua --only-new-rpms para fazer o download apenas do arquivo mais recente. RPMs. 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 seis 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 da no repositório local.
9. (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.16.05.sh no para instalar o utilitário apigee-service:
      > "sudo bash" /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
   2. Use apigee-service para instale o apigee-setup utilitário:
      > /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 Instalar os componentes do Edge em um nó para mais informações.

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 Um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
   
   > /opt/apigee/apigee-service/bin/apigee-service pacote apigee-mirror
2. Copie o arquivo .tar para o nó em que você quer instalar o Edge. Por exemplo, copie-o para diretório /tmp no novo diretório, nó.
3. No novo nó, desative o SELinux conforme descrito acima.
4. No novo nó, descompacte o arquivo para o diretório /tmp:
   > tar -xzf apigee-4.16.05.tar.gz
   
   Esse comando cria um novo diretório, "repos", no diretório que contém o arquivo .tar. Por exemplo: /tmp/repos.
5. Instale o utilitário apigee-service e as dependências do Edge em /tmp/repos:
   > "sudo bash" /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   Inclua o caminho para o diretório repos nesse comando.
6. Use apigee-service para instale o apigee-setup utilitário:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. 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.

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:
      > Reinicialização de /opt/nginx/scripts/apigee-nginx
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ó, desative o SELinux conforme descrito acima.
5. No nó remoto, faça o download do arquivo Edge bootstrap_4.16.05.sh para /tmp/bootstrap_4.16.05.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
   
   em que uName:pWord são o nome de usuário e a senha que você definiu acima para a repo, e remoteRepo é o endereço IP ou nome DNS do repositório nó.
6. No nó remoto, instale o utilitário Edge Apigee-service e as dependências:
   > "sudo bash" /tmp/bootstrap_4.16.05.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 utilitário apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
8. 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.16.05.sh mais recente e execute um novo sincronização:

1. Faça o download do arquivo Edge bootstrap_4.16.05.sh para /tmp/bootstrap_4.16.05.sh:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh (link em inglês)
2. Faça a sincronização:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
3. Se você quiser fazer o download de 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.01 em um repositório 4.16.05

Se você tiver que manter instalações para o Edge 4.16.05 e 4.16.01, poderá manter um que contém as duas versões. A partir desse repositório, é possível instalar o Edge 4.16.05 e 4.16.01.

Para adicionar a versão 4.16.01 a um repositório 4.15.05:

1. Verifique se você instalou a versão 4.16.05 do utilitário apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service versão apigee-mirror
   
   Você verá um resultado no formulário abaixo, em que xyz é o build número:
   apigee-mirror-4.16.05-0.0.xyz
2. Use o apigee-mirror para fazer o download do Edge 4.16.01 no seu repositório. Observe como você prefixa o comando com apigeereleasever=4.16.01:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service sincronização do espelho apigee --only-new-rpms
   
   Use o mesmo comando para atualizar o repositório 4.16.01 depois.
3. Examine /opt/apigee/data/apigee-mirror/repos para conferir a estrutura do arquivo:
   > ls /opt/apigee/data/apigee-mirror/repos
   
   Os seguintes arquivos e diretórios serão exibidos:
   apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh de terceiro
   
   Observe que há um arquivo de inicialização para as duas versões do Edge. O diretório apigee também contém arquivos diretórios para cada versão do Edge.
4. Para empacotar o repositório em um arquivo .tar, use o seguinte comando:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service pacote apigee-mirror
   
   Esse comando empacota os repositórios 4.16.05 e 4.16.01 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 seguintes comandos:

• 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.16.0X.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.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
  > sudo bash /tmp/bootstrap_4.16.0X.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.