Para instalar o Edge em um nó, primeiro instale o utilitário apigee-setup do Edge. Se você estiver em um ambiente em que os nós não tenham uma conexão de Internet externa, instale também 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 mudar 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
É necessário desativar o SELinux ou definir 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ê pode reativar o SELinux.
- Abra
/etc/sysconfig/selinux
em um editor. - Definir
SELINUX=disabled
ouSELINUX=permissive
- Salve as 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
.
Pré-requisito: ativar o repositório EPEL
É necessário ativar os Extra Packages for 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 Red Hat/CentOS/Oracle 8.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
- Para Red Hat/CentOS/Oracle 9.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm
- Ative Pacotes extras para
Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- Desative o Postgres e o Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Ative os pacotes extras para o Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- Desative o Postgres e o Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- Acesse 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, poderá usar essas credenciais.
- Faça login no seu nó como root para instalar os RPMs do Edge
- Desative o SELinux.
- Ative o repositório EPEL.
- Se você estiver instalando no RHEL 9/Rocky 9/Oracle 9, siga as etapas em Pré-requisitos para o RHEL 9/Rocky 9/Oracle 9.
- Faça o download do arquivo
bootstrap_4.53.00.sh
do Edge para/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instale o utilitário Edge Apigee-service e as dependências:
sudo bash /tmp/bootstrap_4.53.00.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 que você o insira.
Por padrão, o instalador verifica se o Java 1.8 está instalado. Se você não fizer isso, ele o instalará para você. Use a opção
JAVA_FIX
para especificar como processar a instalação do Java.JAVA_FIX
aceita 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.
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 conferir 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.
- Adicionar uma configuração de proxy HTTP em
/etc/yum.conf
- Adição de configuração de proxy HTTP global em
/etc/environment
- Repositório do Apigee Edge:conforme descrito em Criar um repositório local do Apigee.
- Pacotes extras para Enterprise Linux (ou EPEL):sua equipe de operações pode configurar isso para você.
- Acesse o nome de usuário e a senha do Apigee que você usa para acessar o repositório do Apigee. Se você já tiver um nome de usuário e uma senha para o site de ftp da Apigee, poderá usar essas credenciais.
- Faça login no nó como raiz para instalar os RPMs do Edge.
- Desative o SELinux conforme descrito acima.
- Faça o download do arquivo
bootstrap_4.53.00.sh
do Edge para/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Instale o utilitário e as dependências do serviço apigee do Edge:
sudo bash /tmp/bootstrap_4.53.00.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 que você o 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 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. -
(Opcional) Se você quiser instalar o Edge do repositório local no mesmo
nó que hospeda o repositório local, primeiro execute os seguintes comandos:
- Execute
bootstrap_4.53.00.sh
a partir do repositório local para instalar o utilitárioapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.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 do Edge no nó. Consulte Instalar componentes do Edge em um nó para mais informações.
- Execute
- Crie um arquivo .tar do repositório, copie-o para 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.
- No nó com o repositório local, use o comando abaixo para empacotar o repositório local em um
único arquivo .tar chamado
/opt/apigee/data/apigee-mirror/apigee-4.53.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 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 de utilitários Yum local e o repositório EPEL.
- Verifique se todos os repositórios externos da Internet estão desativados (isso deve acontecer porque
você está instalando em uma máquina sem acesso à Internet):
sudo yum repolist
Todos os repositórios externos precisam ser desativados, mas o repositório local do Apigee e os repositórios internos precisam estar ativados.
- 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 Instalar componentes do Edge em um nó para mais informações. - 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
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 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
- No novo nó, verifique se o repositório EPEL está ativado localmente.
- No novo nó, verifique sua versão do
libdb4
, conforme descrito acima. - No nó remoto, instale o utilitário Edge
apigee-service
e as dependências:sudo bash /tmp/bootstrap_4.53.00.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.
- 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 do Edge no nó remoto. Consulte Instalar os componentes do Edge em um nó para mais informações. - Faça o download do arquivo Edge bootstrap_4.53.00.sh para
/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- Execute o arquivo
bootstrap_4.53.00.sh
do Edge:sudo bash/tmp/bootstrap_4.53.00.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 que o insira.
- 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
Pré-requisitos para RHEL 8/Rocky 8/Oracle 8
Se você estiver instalando o Edge em um servidor que executa o Red Hat Enterprise Linux (RHEL) 8, siga estas etapas antes de realizar a instalação:
Pré-requisito para RHEL 9/Rocky 9/Oracle 9
Se você estiver instalando o Edge em um servidor com Red Hat Enterprise Linux (RHEL) 9, Rocky 9 ou Oracle 9, siga estas etapas antes de realizar a instalação:
Para as mudanças de pré-instalação do PostgreSQL e do LDAP, consulte Requisitos de pré-instalação do banco de dados do PostgreSQL e Mudanças de pré-instalação do OpenLDAP 2.4, respectivamente.
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:
Solução de problemas
Ao tentar instalar em um nó com uma conexão de Internet externa, você pode encontrar um ou mais dos seguintes erros:
Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.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 do Apigee. |
Problemas de conectividade | Para testar a conectividade de rede, 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 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ê terá conectividade de rede limitada ou nenhuma. 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ê recebe um erro ao tentar usar o comando a seguir com seu nome de usuário e senha do 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 as 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 Edge 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 impedidos de acessar a Internet, crie vários repositórios ou espelhos que contenham os arquivos necessários durante a instalação. Esses espelhos precisam ser 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ões de Internet requer acesso aos seguintes repositórios locais:
Criar um repositório local da Apigee
Para criar o repositório interno da Apigee, é necessário um nó com acesso externo à Internet para fazer o download de RPMs e dependências do Edge. Depois de criar o repositório interno, você pode movê-lo para outro nó ou torná-lo acessível aos nós do Edge para instalação.
Depois de criar um repositório local do Apigee, talvez seja necessário atualizá-lo com os arquivos de lançamento mais recentes do Edge. As seções a seguir descrevem como criar um repositório local do Apigee e como atualizá-lo.
Para criar um repositório da Apigee local:
Instalar o apigee-setup em um nó remoto do repositório local
Você tem duas opções para instalar o Edge do repositório local. Você pode fazer o seguinte:
Instalar do arquivo .tar
Para instalar usando o arquivo .tar:
Instalar do repositório usando o servidor da Web Nginx
Para instalar do repositório usando o servidor da Web Nginx:
Atualizar um repositório local da Apigee
Para atualizar o repositório, faça o download do arquivo bootstrap_4.53.00.sh mais recente e execute uma nova sincronização.
Para atualizar o repositório:
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