Instala la utilidad de Apigee de Setup de Edge

Edge para la nube privada v. 4.17.01

Para instalar Edge en un nodo, primero debes instalar la utilidad apigee-setup de Edge. Si te encuentras en un entorno en el que los nodos no tienen una conexión a Internet externa, también debes instalar una copia local del repositorio de Apigee.

Directorio de instalación predeterminado: /opt/apigee

Edge instala todos los archivos en el directorio /opt/apigee. No puedes cambiar este directorio. Sin embargo, si lo desea, puede crear un symlink para asignar /opt/apigee a otra ubicación. Consulta los Requisitos de instalación para obtener más información.

Requisito previo: Inhabilita SELinux

Debes inhabilitar SELinux o configurarlo en modo permisivo para poder instalar la utilidad apigee-setup de Edge o cualquier componente de Edge. Si es necesario, después de instalar Edge, puedes volver a habilitar SELinux.

• Para establecer SELinux de manera temporal en el modo permisivo, ejecuta el siguiente comando:
  1. En un sistema operativo Linux 6.x:
     echo 0 > /selinux/enforce
     
     Para volver a habilitar SELinux después de instalar Edge, sigue estos pasos:
     echo 1 > /selinux/enforce
  2. En un sistema operativo Linux 7.x:
     setenforce 0
     
     Para volver a habilitar SELinux después de instalar Edge, sigue estos pasos:
     setenforce 1
• Para inhabilitar SELinux de forma permanente o establecer el modo permisivo, haz lo siguiente:
  1. Abre /etc/sysconfig/selinux en un editor.
  2. Configura SELINUX=disabled o SELINUX=permissive.
  3. Guarda los cambios.
  4. Reinicia el nodo.
  5. Si es necesario, vuelve a habilitar SELinux después de la instalación de Edge mediante este procedimiento para establecer SELINUX=enabled.

Requisito previo: Habilitar el repositorio de EPEL

Debes habilitar Paquetes adicionales para Enterprise Linux (o EPEL) a fin de instalar o actualizar Edge. El comando que uses dependerá de tu versión de Red Hat/CentOS:

• Para RedHat/CentOS 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 6.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Instala la utilidad de Apigee Setup de un nodo con conexión a Internet externa

Para instalar Edge en un nodo con una conexión a Internet externa, sigue estos pasos:

1. Obtén el nombre de usuario y la contraseña de Apigee que usas para acceder al repositorio de Apigee. Si ya tiene un nombre de usuario:contraseña para el sitio de FTP de Apigee, puede usar esas credenciales.
2. Accede a tu nodo como raíz para instalar los RPM de Edge.
   Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
3. Inhabilita SELinux como se describió anteriormente.
4. Habilita el repositorio de EPEL como se describió anteriormente.
5. Descargue el archivo Edge boot_4.17.01.sh a /tmp/boot_4.17.01.sh:
   > curl https://software.apigee.com/boot_4.17.01.sh -o /tmp/boot_4.17.01.sh
6. Instala la utilidad y las dependencias del apigee-service de Edge:
   > sudo bash /tmp/boot_4.17.01.sh apigeeuser=uName apigeepassword=pWord
   
   , donde uName:pWord es el nombre de usuario y la contraseña que recibió de Apigee. Si omites pWord, se te solicitará que lo ingreses.
   
   De forma predeterminada, el instalador verifica que tengas instalado Java 1.8. Si no lo haces, la instala por ti. Usa la opción JAVA_FIX para especificar cómo controlar la instalación de Java. JAVA_FIX toma los siguientes valores:
   
   I = Instala OpenJDK 1.8 (predeterminado)
   C = Continúa sin instalar Java
   Q = Salir. Para esta opción, debes instalar Java por tu cuenta.
   
   La instalación de la utilidad apigee-service crea el archivo /etc/yum.repos.d/apigee.repo que define el repositorio de Apigee. Para ver el archivo de definición, usa el siguiente comando:
   > cat /etc/yum.repos.d/apigee.repo
   
   Para ver el contenido del repositorio, usa el siguiente comando:
   > sudo yum -v repolist 'apigee*'
7. (Solo para CentOS-6.x y RedHat-6.x) En todos los nodos de Qpid, ejecuta el siguiente comando para asegurarte de descargar la versión de Qpid correcta:
   > yum install apigee-qpidd --disablerepo=epel
8. Use apigee-service para instalar la utilidad apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
9. Use apigee-setup para instalar y configurar los componentes de Edge en el nodo. Consulta Cómo instalar componentes de Edge en un nodo para obtener más información.

Instala la utilidad de Apigee Setup de Edge en un nodo sin conexión a Internet externa

Si tus nodos perimetrales están detrás de un firewall o tienen alguna entrada prohibida para acceder al repositorio de Apigee a través de Internet, debes crear un repositorio local, o un duplicado, del repositorio de Apigee. Esa duplicación debe ser accesible para todos los nodos. Una vez creados, los nodos pueden acceder a esa duplicación local para instalar Edge.

Para crear el repositorio de Apigee interno, necesitas un nodo con acceso a Internet externo a fin de poder descargar los RPM y las dependencias de Edge. Una vez que hayas creado el repositorio interno, puedes moverlo a otro nodo o hacer que los nodos perimetrales puedan acceder a él para su instalación.

Nota: Apigee no aloja todas las dependencias de terceros en nuestros repositorios públicos. Debes descargar e instalar estas dependencias desde repositorios de acceso público.

Después de crear un repositorio de Edge local, es posible que más adelante debas actualizarlo con los archivos de actualización de Edge más recientes. En las siguientes secciones, se describe cómo crear un repositorio local y cómo actualizarlo.

Crear un repositorio local de Apigee

Sigue estos pasos para crear un repositorio de Apigee local:

1. Obtén el nombre de usuario y la contraseña de Apigee que usas para acceder al repositorio de Apigee. Si ya tiene un nombre de usuario:contraseña para el sitio de FTP de Apigee, puede usar esas credenciales.
2. Accede a tu nodo de Red Hat o CentOS como raíz para instalar los RPM de Edge.
   Nota: Si bien la instalación de RPM requiere acceso raíz, puedes realizar la configuración de Edge sin acceso raíz.
3. Asegúrate de tener la versión más reciente de yum-utils:
   > sudo yum update yum-utils
4. Inhabilita SELinux como se describió anteriormente.
5. Habilita el repositorio de EPEL como se describió anteriormente.
6. Descargue el archivo Edge boot_4.17.01.sh a /tmp/boot_4.17.01.sh:
   > curl https://software.apigee.com/boot_4.17.01.sh -o /tmp/boot_4.17.01.sh
7. (Solo para CentOS-6.x y RedHat-6.x) Ejecuta el siguiente comando para asegurarte de descargar la versión correcta de Qpid:
   > yum install apigee-qpidd --disablerepo=epel
8. Instala la utilidad y las dependencias de apigee-service de Edge:
   > sudo bash /tmp/boot_4.17.01.sh apigeeuser=uName apigeepassword=pWord
   
   , donde uName:pWord es el nombre de usuario y la contraseña que recibió de Apigee. Si omites pWord, se te solicitará que lo ingreses.
9. Instale la utilidad apigee-Mirror en el nodo:
   >/opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install
   
   Nota: Si está actualizando un repositorio existente a 4.17.01, solo debe actualizar apigee-Mirror:> opt/apigee/apigee-service/bin/apigee-service apigee
   
10. Usa la utilidad apigee-Mirror para sincronizar el repositorio de Apigee con el directorio /opt/apigee/data/apigee-Mirror/repos/.
    
    Para minimizar el tamaño del repositorio, incluye --only-new-rpms a fin de descargar solo los RPM más recientes. Necesita alrededor de 1.6 GB de espacio en el disco para la descarga:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror sync --only-new-rpms
    
    Si desea descargar el repositorio completo, incluidos los RPM anteriores, omita --only-new-rpms. Necesita alrededor de 6 GB de espacio en disco para la descarga completa:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror sync
    
    Ahora tiene una copia local del repositorio de Apigee. En la siguiente sección, se describe cómo instalar la utilidad apigee-setup de Edge desde el repositorio local.
11. (Opcional) Si deseas instalar Edge desde el repositorio local en el mismo nodo que aloja el repositorio local, primero debes ejecutar los siguientes comandos:
    1. Ejecuta boot_4.17.01.sh desde el repositorio local para instalar la utilidad apigee-service:
       > sudo bash /opt/apigee/data/apigee-Mirror/repos/boot_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-Mirror/repos
    2. Usa apigee-service para instalar la utilidad apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Usa apigee-setup para instalar y configurar los componentes de Edge en el nodo. Consulta Cómo instalar componentes de Edge en un nodo para obtener más información.

Instale apigee-setup en un nodo remoto del repositorio local

Tienes dos opciones para instalar Edge desde el repositorio local. Tienes varias opciones:

• Crea un archivo .tar del repositorio, cópialo en un nodo y, luego, instala Edge desde ese archivo.
• Instale un servidor web en el nodo con el repositorio local para que otros nodos puedan acceder a él. Apigee proporciona el servidor web Nginx para que uses. También puedes usar tu propio servidor web.

Realiza la instalación desde el archivo .tar:

1. En el nodo con el repositorio local, usa el siguiente comando para empaquetar el repositorio local en un único archivo .tar llamado /opt/apigee/data/apigee-Mirror/apigee-4.17.01.tar.gz:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror package
   
2. Copia el archivo .tar en el nodo en el que deseas instalar Edge. Por ejemplo, cópialo en el directorio /tmp, en el nodo nuevo.
3. En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
4. En el nodo nuevo, descarta el archivo en el directorio /tmp:
   > tar -xzf apigee-4.17.01.tar.gz
   
   Este comando crea un directorio nuevo, llamado repositorios, en el directorio que contiene el archivo .tar. Por ejemplo, /tmp/repos.
5. Instala la utilidad y las dependencias de apigee-service de Edge desde /tmp/repos:
   > sudo bash /tmp/repos/boot_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   Observa que incluyes la ruta de acceso al directorio de repositorios en este comando.
6. Usa apigee-service para instalar la utilidad apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. Usa apigee-setup para instalar y configurar los componentes de Edge en el nodo. Consulta Cómo instalar componentes de Edge en un nodo para obtener más información.

Realiza la instalación desde el repositorio mediante el servidor web Nginx:

1. Instala el servidor web Nginx en el nodo del repositorio:
   > opt/apigee/apigee-service/bin/apigee-service apigee-Mirror nginxconfig
2. De forma predeterminada, Nginx está configurado para usar localhost como el nombre del servidor y el puerto 3939. Para cambiar estos valores, haz lo siguiente:
   1. Abre /opt/apigee/customer/application/Mirror.properties en un editor. Crea el archivo si no existe.
   2. Configura los siguientes valores según sea necesario:
      conf_apigee_Mirror_listen_port=3939
      conf_apigee_Mirror_server_name=localhost
   3. Reinicia Nginx:
      > /opt/nginx/scripts/apigee-nginx restart
3. De forma predeterminada, el repositorio requiere un nombre de usuario:contraseña de admin:admin. Para cambiar estas credenciales, configura las siguientes variables de entorno:
   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord
4. En el nodo nuevo, inhabilita SELinux como se describió anteriormente.
5. En el nodo remoto, descargue el archivo boot_4.17.01.sh de Edge en /tmp/boot_4.17.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/boot_4.17.01.sh.
   
   
6. En el nodo remoto, instala la utilidad y las dependencias del apigee-service de Edge:
   > sudo bash /tmp/boot_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
   
   donde:nombre
7. En el nodo remoto, use apigee-service para instalar la utilidad apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
8. Usa apigee-setup para instalar y configurar los componentes de Edge en el nodo remoto. Consulta Cómo instalar componentes de Edge en un nodo para obtener más información.

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean