Edge para nuvem privada v. 4.17.09
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 6.x:
> sudo echo 0 > /selinux/enforce
Para reativar o SELinux após a instalação do Edge:
> sudo echo 1 > /selinux/enforce
- 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:
- Para desativar permanentemente o SELinux ou configurá-lo para o modo permissivo:
- Abra
/etc/sysconfig/selinux
em um editor. - Definir
SELINUX=disabled
ouSELINUX=permissive
- Salve suas edições.
- Reinicie o nó.
- Se necessário, reative o SELinux após a instalação do Edge repetindo este procedimento para definir
SELINUX=enabled
.
- Abra
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 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 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.
Você pode usar o seguinte comando para verificar sua versão:
> rpm -qa | grep libdb
Se a versão da RPM libdb4
for posterior à 4.8, use o seguinte comando para substituir as RPMs:
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
Se você precisar fazer o download dessas RPMs, siga estas instruções:
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
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:
- 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.
- Faça login no nó como raiz para instalar as RPMs do Edge
- Instale
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Desative o SELinux conforme descrito acima.
- Ative o repositório do EPEL conforme descrito acima.
- 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
- Faça o download do arquivo
bootstrap_4.17.09.sh
do Edge para/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Instale o utilitário de serviço de borda da Apigee e as dependências:
> sudo bash /tmp/bootstrap_4.17.09.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*'
- Use
apigee-service
para instalar o utilitárioapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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 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 atrás de um firewall ou de alguma outra forma forem proibidos de acessar o repositório da Apigee pela Internet, será necessário criar um repositório local, ou espelho, do repositório da Apigee. Esse espelho precisa estar acessível a todos os nós. Depois de criados, os nós podem acessar o espelho local para instalar o Edge.
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 Edge local, 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 e como atualizá-lo.
Criar um repositório local da Apigee
Para criar um repositório local da Apigee:
- 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.
- Faça login no nó como raiz para instalar as RPMs do Edge.
- Instale
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- Desative o SELinux conforme descrito acima.
- Ative o repositório do EPEL conforme descrito acima.
- 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
- Faça o download do arquivo
bootstrap_4.17.09.sh
do Edge para/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Instale o utilitário de borda
apigee-service
e as dependências:> sudo bash /tmp/bootstrap_4.17.09.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.
- Instale o utilitário
apigee-mirror
no nó:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- 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. -
(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:
- Execute
bootstrap_4.17.09.sh
no repositório local para instalar o utilitárioapigee-service
:> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- Use
apigee-service
para instalar o utilitárioapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Use
apigee-setup
para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes de Edge em um nó para mais informações.
- Execute
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 você pode usar seu próprio servidor da Web.
Instale a partir do arquivo .tar:
- 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.17.09.tar.gz
:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 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ó. - Instale
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- No novo nó, desative o SELinux conforme descrito acima.
- Ative o repositório do EPEL conforme descrito acima.
- No novo nó, descompacte o arquivo no diretório /tmp:
> tar -xzf apigee-4.17.09.tar.gz
Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo
/tmp/repos.
- Instale o utilitário de serviço de borda da Apigee e as dependências do
/tmp/repos
:> sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observe que você incluiu o caminho para o diretório de repositórios nesse comando.
- Use
apigee-service
para instalar o utilitárioapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Use
apigee-setup
para instalar e configurar componentes do Edge no nó. Consulte Instalar componentes de Edge em um nó para mais informações.
Instale a partir do repositório usando o servidor da Web Nginx:
- Instale o servidor da Web Nginx no nó de repositório:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Por padrão, o Nginx é configurado para usar o localhost como o nome do servidor e a porta 3939. Para mudar esses valores:
- Abra
/opt/apigee/customer/application/mirror.properties
em um editor. Crie o arquivo se ele não existir. - Defina os seguintes valores conforme necessário:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- Reinicie o Nginx:
> /opt/nginx/scripts/apigee-nginx restart
- Abra
- 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
- Instale
yum-utils
eyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- No novo nó, desative o SELinux conforme descrito acima.
- Ative o repositório do EPEL conforme descrito acima.
- No nó remoto, faça o download do arquivo Edge bootstrap_4.17.09.sh para
/tmp/bootstrap_4.17.09.sh
:> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.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.
- No nó remoto, instale o utilitário de borda
apigee-service
e as dependências:> sudo bash /tmp/bootstrap_4.17.09.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.
- No nó remoto, use
apigee-service
para instalar o utilitárioapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Use
apigee-setup
para instalar e configurar os componentes do Edge no nó remoto. Consulte Instalar componentes de 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.17.09.sh mais recente e execute uma nova sincronização:
- Faça o download do arquivo Edge bootstrap_4.17.09.sh para
/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Execute o arquivo Edge
bootstrap_4.17.09.sh
:> sudo bash /tmp/bootstrap_4.17.09.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.
- Atualizar
apigee-mirror
:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Execute a sincronização:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- 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 repo 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.17.09
Se você precisar manter instalações para o Edge 4.16.0x ou 4.17.01/4.17.05 em um repositório 4.17.09, 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.17.09:
- Verifique se você instalou a versão 4.17.09 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.17.09-0.0.xyz
- Use o utilitário
apigee-mirror
para fazer o download do Edge 4.16.0x/4.17.01/4.17/05 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.05 especificando os números de versão necessários.
- 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 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. - 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 com o servidor da Web Nginx, faça o download e execute o arquivo de inicialização correto a partir 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 do repositório usando o servidor da Web Nginx" acima.