Cómo reinstalar y restablecer componentes

En este documento, se explica cómo reinstalar y restablecer un componente de Edge. Usa este procedimiento si tienes que volver a instalar el componente de Edge antes de restablecer la copia de seguridad.

Apache ZooKeeper

Restablece un nodo independiente

  1. Detén ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  2. Quita los directorios antiguos de ZooKeeper:
    /opt/apigee/data/apigee-zookeeper
    /opt/apigee/etc/apigee-zookeeper.d
  3. Vuelve a instalar ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
  4. Restablece ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad, ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copias de seguridad del componente.

  5. Reinicia todos los componentes:
    /opt/apigee/apigee-service/bin/apigee-all restart

Restablece un nodo del clúster

Si falla un solo nodo de ZooKeeper que forma parte de un ensamble, puedes crear un nodo nuevo con el mismo nombre de host o dirección IP y volver a instalar ZooKeeper. Cuando el nuevo nodo de ZooKeeper se une al conjunto de ZooKeeper, obtiene las instantáneas más recientes del líder y comienza a atender a los clientes. No es necesario que restablezcas los datos en esta instancia.

  1. Vuelve a instalar ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
  2. Ejecuta la configuración en el nodo de ZooKeeper con el mismo archivo de configuración que se usó cuando se instaló el nodo original:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile
  3. Inicia ZooKeeper:
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Restablece un clúster completo

  1. Detén el clúster completo.
  2. Restablece todos los nodos de ZooKeeper desde el archivo de copia de seguridad como se describió anteriormente para un solo nodo.
  3. Inicia el clúster de ZooKeeper.
  4. Reinicia todos los componentes.

Apache Cassandra

Restablece un nodo independiente

  1. Detén Cassandra:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  2. Quita el directorio anterior de Cassandra:
    /opt/apigee/data/apigee-cassandra
  3. Reinstala Cassandra:
    /apigee/apigee-service/bin/apigee-service apigee-cassandra install
  4. Restablece Cassandra:
    /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copias de seguridad del componente.

  5. Reinicia todos los componentes:
    /apigee/apigee-service/bin/apigee-all restart

Restablece un nodo del clúster

Si falla un solo nodo de Cassandra que forma parte de un conjunto, puedes crear un nodo nuevo con el mismo nombre de host o dirección IP. Solo necesitas volver a instalar Cassandra y seguir algunos pasos adicionales. No es necesario que restablezcas los datos a partir de copias de seguridad. Las réplicas disponibles en otros nodos se pueden usar para restablecer los datos en el nodo con errores. Por lo general, estos pasos se aplican si un nodo de tu clúster de Cassandra falla debido a un mal funcionamiento del hardware, etc.

Si ya no se puede acceder al nodo que falló, destrúyelo y aísla su red para asegurarte de que no pueda volver a unirse accidentalmente al clúster de Cassandra. Luego, abre un nodo nuevo con la misma dirección IP que el nodo original y ejecuta los pasos habituales de arranque de Apigee en él.

Si aún se puede acceder al nodo y quieres volver a usarlo, sigue estos pasos:

  1. Detén el proceso de Cassandra en el nodo:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  2. Desinstala el software de Cassandra del nodo:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  3. Borra el directorio de datos del nodo:
    rm -rf /opt/apigee/data/apigee-cassandra

Después de completar los pasos anteriores, deberías tener un nodo con la misma dirección IP que el nodo que falló y que está listo para la instalación del software de Apigee. Completa los pasos siguientes:

  1. Identifica los nodos de origen del centro de datos.
    1. En cualquier nodo de Cassandra operativo que se encuentre en el mismo centro de datos que el nodo que se está restableciendo, ejecuta el siguiente comando:
      apigee-service apigee-cassandra configure -search conf_cassandra_seeds
    2. Se generará un resultado similar al siguiente:
      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK
    3. Consulta la última línea del resultado. Las direcciones IP separadas por comas que se indican son los nodos de origen que usan los nodos de este centro de datos.
  2. En el nodo nuevo que se está restableciendo, crea o edita el siguiente archivo:
    vi /opt/apigee/customer/application/cassandra.properties
  3. Add the following line:
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>
  4. Si este nodo es uno de los nodos de origen (la dirección IP del nodo aparece en la lista de nodos de origen del paso 1), agrega otra línea en el archivo:
    conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"
    1. Por ejemplo, en la instancia anterior, la lista semilla tiene 2 IPs: 10.1.0.1 y 10.1.0.2. Si el nodo que se restablece es 10.1.0.1, agrega una línea como esta:
      conf_cassandra_seeds="10.1.0.2"
  5. Guarda el archivo y asegúrate de que el usuario de Apigee sea el propietario y pueda leerlo:
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  6. Instala el software de Cassandra:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
  7. Ejecuta la configuración de Cassandra:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>
  8. La configuración intentará iniciar el servicio de Cassandra de forma interna. Esto puede llevar mucho tiempo según la cantidad de datos que se deban transmitir desde otros nodos, la capacidad de procesamiento de la red, etcétera.
  9. [Opción avanzada] Puedes acelerar la transmisión de datos ejecutando los siguientes comandos de nodetool en el nodo:
    nodetool setstreamthroughput <value>
    nodetool setcompactionthroughput <value>
  10. Una vez que el nodo de Cassandra se haya restablecido, usa comandos estándar como los que se muestran a continuación para verificar que el nodo se haya unido al anillo correctamente:
    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status
  11. Una vez que valides que el nodo se ejecuta correctamente, vuelve a editar el archivo /opt/apigee/customer/application/cassandra.properties y quita las líneas que agregaste anteriormente en este procedimiento en los pasos 3 y 4.
  12. Reinicia el servicio de Cassandra en el nodo:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

Restablece un clúster completo

  1. Detén el clúster completo.
  2. Restablece todos los nodos de Cassandra desde el archivo de copia de seguridad.
  3. Inicia el clúster de Cassandra.
  4. Reinicia todos los componentes.

Base de datos de PostgreSQL

PostgreSQL que se ejecuta de forma independiente o como principal

  1. Detén el servidor de administración, el servidor de Qpid y el servidor de Postgres en todos los nodos:
    /apigee/apigee-service/bin/apigee-service edge-management-server stop
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  2. Reinstala la base de datos de PostgreSQL:
    /apigee/apigee-service/bin/apigee-service apigee-postgresql install 
  3. Inicia PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  4. Restablece la base de datos de PostgreSQL desde el archivo de copia de seguridad:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces el componente de PostgreSQL, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el sufijo ".dump". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copias de seguridad del componente.

  5. Inicia el servidor de administración, el servidor de Qpid y el servidor de Postgres en todos los nodos:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PostgreSQL se ejecuta como en espera

  1. Reinstala la base de datos de PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install
  2. Vuelve a configurar la base de datos de PostgreSQL con el mismo archivo de configuración que usaste para instalarla:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile
  3. Inicia PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Servidor de Postgres

  1. Detén el servidor de Postgres en todos los nodos principales y en espera:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  2. Quita los directorios antiguos del servidor de Postgres:
    /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d
  3. Vuelve a instalar el servidor de Postgres:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install
  4. Restablece el servidor de Postgres desde el archivo de copia de seguridad:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copia de seguridad del componente.

  5. Inicia el servidor de Postgres en todos los nodos principales y en espera:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Servidor Qpid y Qpidd

  1. Detén Qpidd, el servidor de Qpid y el servidor de Postgres en todos los nodos:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
  2. Quita los directorios antiguos de Qpid Server y Qpidd:
    /opt/apigee/data/edge-qpid-server
    /opt/apigee/etc/edge-qpid-server.d
    /opt/apigee/data/apigee-qpidd
    /opt/apigee/etc/apigee-qpidd.d 
  3. Vuelve a instalar Qpidd:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 
  4. Restablece Qpidd:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copias de seguridad del componente.

  5. Inicia Qpidd:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 
  6. Vuelve a instalar el servidor de Qpid:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install
  7. Restablece el servidor de Qpid:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad, ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copia de seguridad del componente.

  8. Reinicia el servidor de Qpid, Qpidd y los servidores de Postgres en todos los nodos:
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

SymasLDAP

  1. Detén SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
  2. Vuelve a instalar SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install
  3. Quita los directorios antiguos de SymasLDAP:
    /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d
  4. Restablece SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copia de seguridad del componente.

  5. Para reiniciar SymasLDAP, haz lo siguiente:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start
  6. Reinicia todos los servidores de administración:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Servidor de administración

  1. Detén el servidor de administración:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  2. Quita los directorios antiguos del servidor de administración:
    /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d
  3. Vuelve a instalar el servidor de administración:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server install
  4. Restablece el servidor de administración desde el archivo de copia de seguridad:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad, ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copia de seguridad del componente.

  5. Reinicia el servidor de administración:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

Message Processor

  1. Detener el Message Processor:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
  2. Quita los directorios antiguos del Message Processor:
    /opt/apigee/data/edge-message-processor
    /opt/apigee/etc/edge-message-processor.d
  3. Vuelve a instalar el Message Processor:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install
  4. Restablece Message Processor desde el archivo de copia de seguridad:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad, ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copia de seguridad del componente.

  5. Reinicia el Message Processor:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

Router

  1. Detener el router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  2. Quita los directorios antiguos del router:
    /opt/apigee/data/edge-router
    /opt/apigee/etc/edge-router.d
  3. Cómo reinstalar el router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router install
  4. Restablece el router desde el archivo de copia de seguridad:
    /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copia de seguridad del componente.

  5. Reinicia el router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

Nueva IU de Edge

  1. Detén la IU de New Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Quita los directorios de la IU de New Edge anterior:
    /opt/apigee/data/edge-management-ui
    /opt/apigee/etc/edge-management-ui.d
  3. Vuelve a instalar la nueva IU de Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install
  4. Restablece la IU de Edge nueva desde el archivo de copia de seguridad:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restore 2019.03.17,14.40.41

    Ten en cuenta que, cuando restableces un componente, no especificas la ruta de acceso del directorio al archivo de copia de seguridad ni el prefijo "backup-" ni el sufijo ".tar.gz". Solo debes especificar la parte de fecha y hora del nombre del archivo de copia de seguridad.

    De manera opcional, puedes omitir el archivo de copia de seguridad en el comando restore y Edge usará el archivo de copia de seguridad más reciente en el directorio de copias de seguridad del componente.

  5. Reinicia la nueva IU de Edge:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

Recuperación completa del sitio

  1. Detén todos los nodos de componentes. Ten en cuenta que el orden de detención de los subsistemas es importante: primero detén todos los nodos de Edge y, luego, todos los nodos de almacenes de datos.
  2. Restablece todos los componentes como se describió anteriormente.
  3. Ahora, inicia todos los componentes en el siguiente orden. Ten en cuenta que el orden en el que se inician los subsistemas es importante:
    1. Inicia el clúster de ZooKeeper
    2. Inicia el clúster de Cassandra
    3. Asegúrate de que SymasLDAP esté en funcionamiento
    4. Inicia qpid
    5. Asegúrate de que la base de datos de PostgreSQL esté en funcionamiento
    6. Inicia el servidor de administración
    7. Inicia routers y Message Processors
    8. Inicia el servidor de Qpid
    9. Inicia el servidor de Postgres
    10. Inicia la nueva IU de Edge