Para instalar o Edge em um nó, primeiro instale o utilitário de configuração da Apigee do Edge. Se você estiver em um ambiente em que os nós não têm uma conexão de Internet externa, instale uma 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 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, depois de instalar o Edge, você poderá reativar o SELinux.
- Para definir temporariamente o SELinux para o modo permissivo, execute o seguinte
comando:
- Em um sistema operacional Linux 8.x:
sudo setenforce 0
Para reativar o SELinux depois de instalar o Edge:
sudo setenforce 1
- Em um sistema operacional Linux 7.x:
sudo setenforce 0
Para reativar o SELinux depois de instalar o Edge:
sudo setenforce 1
- 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 8.x:
- Para desativar permanentemente o SELinux ou defini-lo para o modo permissivo:
- Abra
/etc/sysconfig/selinux
em um editor. - Defina
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 esse procedimento para
definir
SELINUX=enabled
.
- Abra
Pré-requisito: ativar o repositório EPEL
Ative os Pacotes extras do 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 o Red Hat Enterprise Linux (Firebase) 8.0, consulte Pré-requisitos do RM 8 (em inglês).
- 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 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 CentOS 7.4
No RedHat 7.4 e CentOS 7.4, verifique a versão dos RPMs libdb4
antes de fazer a instalação. O Edge requer a versão 4.8, e algumas versões do RedHat 7.4 e CentOS 7.4 vêm com uma versão mais recente. Se você tiver uma versão mais recente, desinstale-a para que o Instalador do Edge
instale a versão 4.8.
Use o seguinte comando para verificar sua versão:
rpm -qa | grep libdb4
Se a versão da RPM libdb4
for mais recente que a 4.8, desinstale-a.
Pré-requisitos do OpenCensus 8
Se você estiver instalando o Edge em um servidor com o Red Hat Enterprise Linux (AOSP) 8, siga estas etapas antes de realizar a instalação:
- Ative os Pacotes extras para o Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Desativar o Postgres e o NGINX:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Instale o Python 2 e crie um link simbólico:
sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python
Instalar o utilitário de configuração da Apigee 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:
- 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 username:password para o site de FTP da Apigee, vai poder usar 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.
- Ative o repositório EPEL.
- Confira a versão
do
libdb4
. - Se você estiver instalando no php 8, siga as etapas em Pré-requisitos para o RM 8.
- Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
sudo yum-config-manager --enable ol7_optional_latest
- Se você estiver instalando na AWS, execute os seguintes 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
- Faça o download do arquivo
bootstrap_4.51.00.sh
do Edge em/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Instale o utilitário e as dependências do serviço da Apigee do Edge:
sudo bash /tmp/bootstrap_4.51.00.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 o campo pWord, será necessário inseri-lo.
Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, ele vai instalar o pacote 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 acessar 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ário "apigee-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 do Edge em um nó para saber mais.
Solução de problemas
Ao tentar instalar em um nó com uma conexão de Internet externa, é possível que você encontre 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 senha da Apigee. |
Problemas de conectividade | Execute o seguinte 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 o 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ê tem conectividade de rede limitada ou nenhuma conectividade de rede. Verifique com o administrador da rede. |
Credenciais incorretas | Verifique se o nome de usuário e a senha estão corretos. Por exemplo, verifique se você recebeu um erro ao tentar usar o seguinte comando com o nome de usuário e a 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 suas variáveis de ambiente:
echo $http_proxy
Para um proxy HTTP de saída, use uma das seguintes opções:
|
Instalar o utilitário de configuração da Apigee do Edge em um nó sem conexão externa de Internet
Se os nós de borda estiverem protegidos por firewall ou, de alguma forma, forem 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 para 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:
- Repositório Apigee Edge: conforme descrito em Criar um repositório local da Apigee.
- Repositório do Yum (para utilitários como
yum-utils
eyum-plugin-priorities
): sua equipe de operações poderá configurar isso para você. - Pacotes extras para o Enterprise Linux (ou EPEL):sua equipe de operações vai conseguir configurar isso para você.
Criar um repositório local da Apigee
Para criar o repositório interno da Apigee, é necessário ter 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 local da Apigee, talvez seja necessário atualizá-lo mais tarde com os arquivos de lançamento do Edge mais recentes. As seções a seguir descrevem como criar um repositório local da Apigee e atualizá-lo.
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 de FTP da Apigee, poderá usar essas credenciais.
- Faça login no nó como raiz para instalar as RPMs do Edge.
- Desative o SELinux conforme descrito acima.
- Faça o download do arquivo
bootstrap_4.51.00.sh
do Edge em/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Instale o utilitário e as dependências do serviço Apigee Edge:
sudo bash /tmp/bootstrap_4.51.00.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 o campo pWord, será necessário 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 repositório, 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 RPMs mais antigas, omita
--only-new-rpms
. São necessários 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. A próxima seção descreve como instalar o utilitário
apigee-setup
do Edge a partir do repositório local. -
(Opcional) Se você quiser instalar o Edge a partir do repositório local no mesmo
nó que hospeda o repositório local, primeiro execute os comandos a seguir:
- Execute
bootstrap_4.51.00.sh
a partir do repositório local para instalar o utilitárioapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.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 de borda no nó. Consulte Instalar componentes do Edge em um nó para saber mais.
- Execute
Instalar o apigee-setup em um nó remoto do repositório local
Você tem duas opções para instalar o Edge pelo repositório local. você tem as seguintes opções:
- Crie um arquivo .tar do repositório, copie-o em um nó e instale o Edge a partir desse arquivo.
- 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 a partir do arquivo .tar
Para instalar a partir do arquivo .tar:
- 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.51.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Copie o arquivo .tar para o nó em que você quer instalar o Edge. Por exemplo, copie-o para o diretório
/tmp
no novo nó. - No novo nó, desative o SELinux conforme descrito acima.
- No novo nó, verifique se você pode acessar o repositório local do utilitário Yum e o repositório EPEL.
- Verifique se todos os repositórios de Internet externos estão desativados. É necessário fazer isso porque
você está instalando em uma máquina sem acesso à Internet:
sudo yum repolist
Todos os repositórios externos precisam ser desativados, mas os repositórios locais e internos precisam estar ativados.
- No novo nó, instale
yum-utils
eyum-plugin-priorities
do seu repositório local:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
Sua equipe de operações ou outro grupo da organização precisa configurar um repositório local para que você possa instalar as ferramentas do Yum.
- No novo nó, verifique sua versão de
libdb4
conforme descrito acima. - Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
sudo yum-config-manager --enable ol7_optional_latest
- 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
- No novo nó, descompacte o arquivo no diretório /tmp:
tar -xzf apigee-4.51.00.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 da Apigee e as dependências de
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.51.00.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 de borda no nó. Consulte Instalar componentes do Edge em um nó para saber mais.
Instalar pelo repositório usando o servidor da Web NGINX
Para instalar a partir do repositório usando o servidor da Web NGINX:
- Instale o servidor da Web NGINX no nó do repositório:
opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- Por padrão, o NGINX está configurado para usar o localhost como o nome do servidor e a porta 3939. Para mudar esses valores, faça o seguinte:
- 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 repositório requer um username:password de
admin:admin
. Para alterar essas credenciais, defina as seguintes variáveis de ambiente:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- 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.
- No novo nó, verifique se o repositório EPEL local está ativado.
- No novo nó, verifique sua versão de
libdb4
conforme descrito acima. - No nó remoto, faça o download do arquivo Edge bootstrap_4.51.00.sh para
/tmp/bootstrap_4.51.00.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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 repositório.
- No nó remoto, instale o utilitário
apigee-service
e as dependências do Edge:sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
Em que uName:pWord é 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 componentes de borda no nó remoto. Consulte Instalar componentes do Edge em um nó para saber mais.
Atualizar um repositório local da Apigee
Para atualizar o repositório, faça o download do arquivo bootstrap_4.51.00.sh mais recente e execute uma nova sincronização.
Para atualizar o repositório:
- Faça o download do arquivo Edge bootstrap_4.51.00.sh para
/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Execute o arquivo
bootstrap_4.51.00.sh
do Edge:sudo bash/tmp/bootstrap_4.51.00.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, será solicitado que o insira.
- Atualizar
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- Faça a sincronização:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- Se você quiser armazenar 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 Edge 4.16.0x/4.17.0x em um repositório 4.51.00
Se você precisar manter instalações para o Edge 4.16.0x ou 4.17.0x em um repositório 4.51.00, mantenha 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.51.00:
- Verifique se você instalou a versão 4.51.00 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.51.00-0.0.xyz
- Use o utilitário
apigee-mirror
para fazer o download do Edge 4.16.0x/4.17.0x para 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 esse mesmo comando para atualizar posteriormente os repositórios 4.16.0x/4.17.0x, 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 bootstrap_4.18.01.sh bootstrap_4.18.05.sh bootstrap_4.19.01.sh thirdparty
Observe que há 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 repositório.
Para instalar o Edge a partir do repositório local ou do arquivo .tar, execute o arquivo de inicialização correto usando um dos comandos a seguir. Este exemplo instala o Edge 4.17.01:
- Se a instalação for feita com 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 usando o 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 o servidor da Web NGINX" acima.