Cómo reinstalar y restablecer componentes

En este documento, se explica cómo reinstalar y restablecer un componente de Edge. Usa este procedimiento si debes reinstalar 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. Reinstala 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-" o 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 conjunto, puedes crear un nodo nuevo con el mismo nombre de host o dirección IP y reinstalar 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. Reinstala 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-" o 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 debes volver a instalar Cassandra y seguir algunos pasos adicionales. No es necesario que restablezcas los datos a partir de las 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 falla un nodo del clúster de Cassandra debido a un mal funcionamiento del hardware, etc.

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

Si aún puedes 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 semilla del centro de datos.
   1. En cualquier nodo de Cassandra operativo en el mismo centro de datos que el nodo que se restablece, ejecuta el siguiente comando:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. El resultado será 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 semilla 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 semilla (la dirección IP del nodo aparece en la lista de nodos semilla del paso 1), agrega otra línea al archivo:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. Por ejemplo, en la instancia anterior, la lista de semillas 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. Internamente, el programa de configuración intentará iniciar el servicio de Cassandra. Esto puede tardar mucho tiempo según la cantidad de datos que se transmitan desde otros nodos, la capacidad de procesamiento de tu red, etcétera.
9. [Opción avanzada] Para acelerar la transmisión de datos, puedes ejecutar los siguientes comandos de nodetool en el nodo:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Una vez que el nodo de Cassandra vuelva a estar en funcionamiento, usa comandos estándar como los que se muestran a continuación para verificar que el nodo se haya unido correctamente al anillo:
    

    /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

PosgreSQL ejecutándose 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 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 Qpid y el servidor 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 Standby

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. Reinstala 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-" o 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 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, Qpid Server y Postgres Server 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. Reinstala 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-" o 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. Reinstala el servidor Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. Restablece el servidor 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-" o 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.

8. Reinicia los servidores Qpid, Qpidd y 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. Reinstala 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-" o 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 SymasLDAP:

   /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 del servidor de administración anterior:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. Reinstala el servidor de administración:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server install

4. Restablece el servidor de administración a partir del 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-" o 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 el servidor de administración:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

Message Processor

1. Detener el procesador de mensajes:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. Quita los directorios antiguos de Message Processor:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. Reinstala el procesador de mensajes:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. Restablece Message Processor a partir del 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-" o 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 el procesador de mensajes:

   /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 del router antiguos:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. Reinstala 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-" o 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 el router:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

IU de Edge

1. Detener la IU:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. Quita los directorios de IU antiguos:

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. IU de reinstalación:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui install

4. Restablece la IU desde el archivo de copia de seguridad:

   /opt/apigee/apigee-service/bin/apigee-service edge-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-" o 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. IU de reinicio:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

Recuperación completa del sitio

1. Detiene todos los nodos de componentes. Ten en cuenta que el orden en que se detienen 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 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. Iniciar el servidor de administración
   7. Inicia los routers y los procesadores de mensajes
   8. Cómo iniciar el servidor de Qpid
   9. Inicia el servidor de Postgres
   10. Inicia la IU de Apigee