Edge para nuvem privada v. 4.16.09
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.
Criando um link simbólico de /opt/apigee
O Edge instala todos os arquivos no diretório /opt/apigee. Não é possível alterar esse diretório. No entanto, é possível criar um link simbólico para mapear /opt/apigee para outro local.
Antes de criar o link simbólico, você precisa criar um usuário e um grupo com o nome "apigee". Esse é o mesmo grupo e usuário criados pelo Instalador do Edge.
Para criar o link simbólico, execute estas etapas antes de fazer o download do arquivo bootstrap_4.16.09.sh. Realize todas estas etapas como raiz:
- Crie o usuário e o grupo "apigee":
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee - Crie um link simbólico de /opt/apigee para a raiz de instalação
desejada:
> ln -Ts /srv/myInstallDir /opt/apigee
em que /srv/myInstallDir é o local pretendido dos arquivos do Edge. - Mude a propriedade da raiz e do link simbólico para o usuário "apigee":
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee
Pré-requisito: desativar o SELinux
Desative o SELinux ou defina-o no 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 o SELinux temporariamente para o modo permissivo, execute este
comando:
- Em um sistema operacional Linux 6.x:
echo 0 > /selinux/enforce
Para reativar o SELinux depois de instalar o Edge:
echo 1 > /selinux/enforce - Em um sistema operacional Linux 7.x:
setenforce 0
Para reativar o SELinux depois de instalar o Edge:
setenforce 1
- Em um sistema operacional Linux 6.x:
- Para desativar permanentemente o SELinux ou defini-lo para o modo permissivo:
- Abra /etc/sysconfig/selinux em um editor.
- Defina SELINUX=Disabled ou SELINUX=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.
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 externa à Internet:
- 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
Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem esse acesso. - Desative o SELinux conforme descrito acima.
- Faça o download do arquivo Edge bootstrap_4.16.09.sh para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - Instale o utilitário e as dependências do serviço Edge apigee:
> sudo bash /tmp/bootstrap_4.16.09.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 pWord, será solicitado que o insira.
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 OpenJDK 1.8 (padrão)
C = Continuar sem instalar o Java
Q = 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 acessar 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.
Instalar o utilitário de configuração da Apigee do Edge em um nó sem conexão de Internet externa
Se os nós do Edge estiverem protegidos por 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. Dessa forma, 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 nos nossos repositórios públicos. É preciso fazer o download e a instalação dessas dependências a partir de repositórios acessíveis publicamente.
Depois de criar um repositório local do Edge, 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 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 de FTP da Apigee, poderá usar essas credenciais.
- Faça login no seu nó RedHat ou CentOS como raiz para instalar as RPMs do Edge.
Observação: embora a instalação da RPM exija acesso raiz, é possível executar a configuração do Edge sem acesso raiz. - Confira se você tem a versão mais recente do yum-utils:
> sudo yum update yum-utils - Desative o SELinux conforme descrito acima.
- Faça o download do arquivo Edge bootstrap_4.16.09.sh para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - Instale o utilitário apigee-service do Edge e
as dependências:
> sudo bash /tmp/bootstrap_4.16.09.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 pWord, será solicitado que o insira. - Instale o utilitário apigee-mirror
no nó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
Observação: se você estiver atualizando um repositório para a versão 4.16.09, basta atualizar apigee-mirror:
>apigee-apigee/apigee-service/bin/bq-service (em inglês) - 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 --only-new-rpms para fazer o download apenas das RPMs mais recentes. Você vai precisar 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 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. Na próxima seção, descrevemos 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.16.09.sh do repositório local para instalar o utilitário apigee-service:
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/apigee-mirror repos - 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.
- Execute bootstrap_4.16.09.sh do repositório local para instalar o utilitário apigee-service:
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, mas também é possível usar seu próprio servidor da Web.
Instale a partir do arquivo .tar:
- No nó com o repositório local, use o comando a seguir para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror - 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ó, remova o arquivo para o diretório /tmp:
> tar -xzf apigee-4.16.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 apigee-service do Edge e as dependências de /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Você inclui o caminho para o diretório de repositórios neste comando. - 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.
Instale 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 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 estes 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
- Por padrão, o repositório requer um nome de usuário e senha admin:admin. Para alterar essas credenciais,
defina as seguintes variáveis de ambiente:
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord - No novo nó, desative o SELinux conforme descrito acima.
- No nó remoto, faça o download do arquivo
do Edge bootstrap_4.16.09.sh do nome de usuário
/tmp/bootstrap_4.16.09.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh Reposh, /tmp/bootstrap_4.16.09.sh
- No nó remoto, instale o utilitário e as dependências do Edge apigee-service:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigee protocol e http://
o uWord, em que uremoteRepo. - No nó remoto, 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ó 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.16.09.sh mais recente e execute uma nova sincronização:
- Faça o download do arquivo Edge bootstrap_4.16.09.sh para /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - Execute o arquivo bootstrap_4.16.09.sh do Edge:
> sudo bash /tmp/bootstrap_4.16.09.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 pWord, será necessário inseri-lo. - Atualizar apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror atualização - Faça a sincronização:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms - Se você quiser fazer o download do repositório inteiro:
> /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/4.16.05 em um repositório 4.16.09
Se você precisar manter instalações do Edge 4.16.01 e 4.16.05 em um repositório 4.16.09, 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.01/4.16.05 a um repositório 4.16.09:
- Verifique se você instalou a versão 4.16.09 do utilitário apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
O resultado aparecerá no formulário abaixo, em que xyz é o número da versão:
apigee-mirror-4.16.09-0.0. - Use o utilitário apigee-mirror
para fazer o download do Edge 4.16.01 ou 4.16.05 para seu repositório. Observe o prefixo do comando
com apigeereleasever=4.16.01 ou apigeereleasever=4.16.05:
> apigeever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms=4.16.05. - Examine o diretório /opt/apigee/data/apigee-mirror/repos
para ver 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.rpmparty.rpm party bootstrap
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.16.01 /opt/apigee/apigee-service/bin/apigee-service pacote apigee-mirror
Esse comando empacota os repositórios 4.16.09 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 do arquivo .tar, execute o arquivo de inicialização correto usando um dos seguintes comandos:
- Se estiver fazendo a instalação com 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 do arquivo .tar" acima. - Se estiver fazendo a instalação usando o servidor da Web Nginx, faça o download e execute o arquivo de inicialização correto
do repo:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh