Cómo reinstalar y restablecer componentes

En este documento, se describe la reinstalación y el restablecimiento de un componente de Edge. Usar este procedimiento si debes 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 anteriores 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia 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 nodo de ZooKeeper que forma parte de un ensamble, puedes crear un nodo nuevo con el mismo nombre de host/dirección IP y reinstalar ZooKeeper. Cuando el nuevo nodo de ZooKeeper se una al El ensamble de ZooKeeper obtendrá los resúmenes más recientes del líder y comenzará a atender a los clientes. No es necesario restablecer 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 usa al instalar 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. Vuelve a instalar 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia 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 nodo de Cassandra que forma parte de un ensamble, 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 necesitas restablecer los datos de las copias de seguridad. Las réplicas disponibles en otros nodos se pueden usar para restablecer los datos del nodo con errores. Estos pasos suelen ser aplicables si falla un nodo del clúster de Cassandra debido a un mal funcionamiento del hardware, etcétera.

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 en él los pasos de arranque habituales de Apigee.

Si todavía 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 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, debes tener un nodo con la misma dirección IP que el nodo que falló y está listo para la instalación del software de Apigee. Completa los pasos siguientes:

1. Identificar los nodos de origen del centro de datos
   1. En cualquier nodo de Cassandra operativo 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 mostrará 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 aparecen en la lista son los nodos de origen que utilizan 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 de origen tiene 2 IP: 10.1.0.1 & 10.1.0.2. Si el nodo que quieres restablecer es 10.1.0.1, agrega una línea como esta:
      

      conf_cassandra_seeds="10.1.0.2"

5. Guarda el archivo, asegúrate de que sea de propiedad y de modo que el usuario de Apigee pueda leerla:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Instala el software 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 tardar mucho tiempo en función de la cantidad de datos que haya para transmitir desde otros nodos, la capacidad de procesamiento de tu 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 vuelva a funcionar, usa comandos estándar como los siguientes 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 esté funcionando correctamente, vuelve a editar el archivo /opt/apigee/customer/application/cassandra.properties y quita las líneas que agregaste antes 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 que se ejecuta de forma independiente como principal

1. Detén el servidor de administración, el servidor Qpid y el servidor 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. Vuelve a instalar 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 PostgreSQL, no especificas la ruta de acceso al directorio a el archivo de copia de seguridad ni se debe especificar el archivo ".dump" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia 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

PosgreSQL que se ejecuta en espera

1. Vuelve a instalar 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 Postgres Server 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 Postgres Server a partir del 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia de seguridad del componente.

5. Inicia Postgres Server 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 Qpid Server y Qpidd antiguos:

   /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. Restablecer 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia de seguridad del componente.

5. Iniciar Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Vuelve a instalar el servidor Qpid:

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

7. Restablecer 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia 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

OpenLDAP

1. Detén el OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. Vuelve a instalar OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. Quita los directorios OpenLDAP antiguos:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. Restablecer OpenLDAP:

   /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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia de seguridad del componente.

5. Reinicia OpenLDAP:

   /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. Detener 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. Reinstala 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del 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 Message Processor:

   /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. Vuelve a instalar Message Processor:

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

4. Restablece el procesador de mensajes 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia 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 de router antiguos:

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

3. Vuelve a instalar 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia de seguridad del componente.

5. Reiniciar el router:
   

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

IU de Edge

1. IU de detención:

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

2. Quita los directorios de IU anteriores:

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

3. Vuelve a instalar la IU:
   

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

4. Restablece la IU a partir del 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 debes especificar la ruta de acceso del directorio a la copia de seguridad ni especificar el directorio "backup-" el prefijo ".tar.gz" . Solo especificas fecha y hora del nombre del archivo de la 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 del directorio de copia de seguridad del componente.

5. Reiniciar IU:
   

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

Completa la recuperación del sitio

1. Detén todos los nodos componentes. Ten en cuenta que el orden de detención de los subsistemas es importante: primero, detener todos los nodos de Edge y, luego, detener todos los nodos del almacén 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 de inicio del subsistemas es importante:
   1. Inicia el clúster de ZooKeeper
   2. Inicia el clúster de Cassandra
   3. Asegúrate de que el OpenLDAP esté funcionando
   4. Iniciar qpid
   5. Asegúrate de que la base de datos de PostgreSQL esté en funcionamiento
   6. Iniciar el servidor de administración
   7. Iniciar routers y procesadores de mensajes
   8. Iniciar el servidor Qpid
   9. Inicia el servidor de Postgres
   10. Iniciar la IU de Apigee