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:
- 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 o SELinux permanentemente ou defini-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
defina
SELINUX=enabled
.
- Abra
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 utilitário de configuração da Apigee do Edge em um nó com uma Internet externa conexão
Para instalar o Edge em um nó com uma conexão externa de Internet:
- 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 username:password para o site de FTP da Apigee, use-os. credenciais.
- Faça login no seu nó como raiz para instalar os 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 EPEL conforme descrito acima.
- Verifique sua versão do
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
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.50.00.sh
do Edge para/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Instale o utilitário Edge Apigee-service e as dependências:
sudo bash /tmp/bootstrap_4.50.00.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*'
- Use apigee-service para instalar o utilitário de configuração da Apigee:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.
Solução de problemas
Ao tentar instalar em um nó com uma conexão externa de Internet, talvez 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 para testar a conectividade de rede: 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 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 conexão. Verificar com 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ê 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 o mesmo
configuração para o gerenciador de pacotes yum . Verifique as variáveis de ambiente:
echo $http_proxy
Para um proxy HTTP de saída, use uma das seguintes opções:
|
Instalar o Edge Utilitário de configuração da Apigee em um nó sem conexão de Internet externa
Se os nós de borda estiverem protegidos por firewall ou, de alguma outra forma, for proibido acessar na Internet, crie vários repositórios, ou espelhos, com os arquivos que 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ão de Internet exige acesso a os seguintes repositórios locais:
- Repositório do Apigee Edge: conforme descrito em Crie um repositório local da Apigee.
- Repositório Yum (para utilitários como
yum-utils
eyum-plugin-priorities
): sua equipe de operações vai poder fazer essa configuração para você. - Pacotes extras para Enterprise Linux (ou EPEL):a equipe de operações precisa fazer essa configuração para para você.
Criar um repositório local da Apigee
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 da Apigee, 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 da Apigee e como 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ê tiver um nome de usuário:senha no site de FTP da Apigee, use-os. credenciais.
- Faça login no seu nó como raiz para instalar os RPMs do Edge.
- Desative o SELinux conforme descrito acima.
- Faça o download do arquivo
bootstrap_4.50.00.sh
do Edge para/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Instale o utilitário de serviço da Apigee do Edge e as dependências:
sudo bash /tmp/bootstrap_4.50.00.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.
- 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/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. -
(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:
- Execute
bootstrap_4.50.00.sh
no repositório local para instalar o Utilitárioapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.50.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 os componentes do Edge no nó. Consulte Instale os componentes do Edge em um nó para saber mais.
- Execute
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.
Instalar usando o arquivo .tar
Para instalar usando o 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.50.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
/tmp
no novo nó. - No novo nó, desative o SELinux conforme descrito acima.
- No novo nó, verifique se é possível acessar o repositório de utilitários do Yum local e o EPEL repositório.
- Verifique se todos os repositórios externos da Internet estão desativados. Esse é o caso,
que você está instalando em uma máquina sem acesso à Internet):
sudo yum repolist
Todos os repositórios externos devem ser desativados, mas o repositório local da Apigee e os repositórios internos deve ser ativada.
- No novo nó, instale
yum-utils
eyum-plugin-priorities
de seu repositório local:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
Sua equipe de operações ou outro grupo na sua organização precisa configurar um repositório local para você instalar as ferramentas do Yum.
- No novo nó, verifique sua versão do
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.50.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 do Edge e as dependências de
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Inclua o caminho para o diretório repos 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 os componentes do Edge no nó. Consulte Instale os componentes do Edge em um nó para saber mais.
Instalar a partir do 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 é configurado para usar localhost como o nome do servidor e a porta 3939. Para
altere 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 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
- 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 do
libdb4
, conforme descrito acima. - No nó remoto, faça o download do arquivo Edge bootstrap_4.50.00.sh para
/tmp/bootstrap_4.50.00.sh
:curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.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 repo.
- No nó remoto, instale o utilitário Edge
apigee-service
e as dependências:sudo bash /tmp/bootstrap_4.50.00.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.
- No nó remoto, use
apigee-service
para instalar oapigee-setup
utilitário:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 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.50.00.sh mais recente e faça uma nova sincronização.
Para atualizar o repositório:
- Faça o download do arquivo Edge bootstrap_4.50.00.sh para
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Execute o arquivo
bootstrap_4.50.00.sh
do Edge:sudo bash/tmp/bootstrap_4.50.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, você será solicitado a inseri-lo.
- Atualize
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 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.50.00
Se você tiver que manter instalações para o Edge 4.16.0x ou 4.17.0x em um repositório 4.50.00, 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.50.00:
- Verifique se você instalou a versão 4.50.00 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.50.00-0.0.xyz
- 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.
- 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.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
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 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.