Actualización de un clúster con una base de datos separada y el módulo Data Hub

Requisitos previos:

Antes de realizar la actualización, asegúrese de leer las notas correspondientes a la nueva versión. Las notas de la versión contienen importante información de compatibilidad, rutas de actualización compatibles y recomendaciones para las copias de seguridad de datos específicas para los módulos.
Aplique las últimas actualizaciones del producto disponibles para su sistema operativo, especialmente las que solucionan problemas relacionados con Java.
IMPORTANTE: Le recomendamos crear una copia de seguridad antes de actualizar para que pueda recuperar sus flujos, configuración de seguridad y otras configuraciones, si se produce un error durante la actualización.

En este procedimiento se describe cómo actualizar Spectrum™ Technology Platform cuando ha separado la base de datos de configuración del servidor y ha instalado el módulo Data Hub. El proceso de actualización consta de estos pasos:

Detenga el clúster del servidor.
Detenga el clúster de la base de datos de configuración.
Actualice el último nodo que se detuvo en el clúster de la base de datos de configuración.
Actualice los otros nodos del clúster de la base de datos de configuración.
Actualice el servidor principal del módulo Data Hub en el clúster de servidores.
Actualice los servidores no principales en el clúster de servidores.

Para actualizar un clúster con una base de datos de configuración separada y el módulo Data Hub, siga este procedimiento:

Realice una copia de seguridad del servidor. Para obtener instrucciones para hacerlo, consulte la Guía de administración.

Importante: Le recomendamos crear una copia de seguridad antes de actualizar para que pueda recuperar sus flujos, configuración de seguridad y otras configuraciones, si se produce un error durante la actualización.
Abra el Relationship Analysis Client y haga clic en Administrar. Seleccione el modelo al que desea hacer una copia de seguridad y haga clic en Copia de seguridad.
Además de realizar una copia de seguridad de sus modelos, realice también una copia de seguridad de los archivos de propiedades:
- server\modules\hub\hub.properties
- server\modules\db\neo4j.properties
Identifique qué nodo actúa como servidor principal para el módulo Data Hub.
1. Abra un navegador web y vaya a:
  
  http://LoadBalancer:8080/jmx-console/HttpAdaptor/list
2. Desplácese hasta el dominio neo4j.org domain.
  
  Encontrará un conjunto de objetos para cada modelo. El atributo Role en el objeto HighAvailability indica si un servidor es el principal de un modelo.
3. Si tiene más de un modelo y cada modelo tiene un servidor principal diferente, debe hacer que un servidor sea el principal de todos los modelos. Para hacerlo, reinicie el clúster y luego abra el Relationship Analysis Client usando el nombre del host o la dirección IP de uno de los nodos, en lugar del equilibrador de carga. En el Relationship Analysis Client, abra cada modelo ejecutando una consulta en cada uno. Esto hará que el servidor al que esté conectado se convierta en el principal de cada modelo.
Detenga todos los nodos no principales del clúster del servidor. Luego, detenga el servidor principal en último lugar. Detenga los nodos de uno por vez en lugar de detenerlos todos juntos.

Importante: Asegúrese de que Spectrum™ Technology Platform se detenga sin errores. Si un servidor no se detiene adecuadamente, los modelos del módulo Data Hub en el servidor no se abrirán correctamente tras la actualización. Para asegurarse de que Spectrum™ Technology Platform se detenga sin problemas, examine el archivo SpectrumDirectory\server\app\repository\logs\wrapper.log en busca de errores durante el cierre.
Detenga todos los nodos del clúster de la base de datos de configuración. Anote el último nodo que detuvo en el clúster de la base de datos de configuración. Debe iniciar este nodo primero después de actualizar.
En el último nodo que apague en el clúster de la base de datos de configuración, ejecute installdb.sh. El instalador actualiza la base de datos de configuración.

Aviso: El primer nodo que actualice debe ser el último nodo que se detuvo. Esto se debe a que, en algunos sistemas operativos, la base de datos de configuración se iniciará automáticamente al finalizar el proceso de actualización. Si el primer nodo que se inicia no es el último nodo que se detuvo, podrían perderse datos como el historial de trabajos y la configuración. Si no sabe cuál fue el nodo que se detuvo último, busque el registro contenedor del nodo y consulte la marca de tiempo del mensaje de apagado. Encontrará el registro contenedor en: Spectrum Location\server\app\repository\logs\wrapper.log.
Configure el clúster de la base de datos.
1. Edite el archivo server/app/conf/spectrum-container.properties como se describe en Propiedades de un clúster de base de datos de configuración.
2. Guarde y cierre el archivo spectrum-container.properties.
3. Inicie el último nodo que se detuvo en la base de datos de configuración. Para iniciar la base de datos de configuración, cambie el directorio de trabajo al directorio bin del servidor de Spectrum™ Technology Platform, invoque el archivo de configuración y luego escriba el siguiente comando: ./server.start .
  
  Aviso: El primer nodo que encienda debe ser el último nodo que se detuvo, y ese nodo debe ser un nodo de raíz. Si se enciende otro nodo primero, se pueden perder datos, como el historial de trabajo y los parámetros de configuración. Si no sabe cuál fue el nodo que se detuvo último, busque el registro contenedor del nodo y consulte la marca de tiempo del mensaje de apagado. Encontrará el registro contenedor en: Spectrum Location\server\app\repository\logs\wrapper.log.
4. Después de que la base de datos de configuración actualizada se inicia por completo, repita los pasos anteriores para actualizar e iniciar cada uno de los servidores restantes del clúster de la base de datos de configuración.
Actualice el servidor principal del módulo Data Hub en el clúster de servidores.
1. Si está actualizando desde la versión Spectrum™ Technology Platform 10.0 o una posterior, cada directorio de modelos debe contener un archivo version.data. Revise todos los subdirectorios de model.ModelName ubicados en SpectrumDirectory/server/modules/hub/db para confirmar que contengan un archivo version.data. Si a cualquier directorio de modelos le falta este archivo, copie el correspondiente archivo version.data desde uno de los nodos no principales.
2. Ejecute el instalador de Spectrum™ Technology Platform para actualizar el servidor principal a la nueva versión de Spectrum™ Technology Platform.
3. Abra el archivo SpectrumFolder\server\modules\hub\hub.properties en un editor y confirme que la propiedad hub.neo4j.database.type esté establecida en embedded:
```
hub.neo4j.database.type=embedded
```
4. Abra el archivo SpectrumFolder\server\modules\hub\db\neo4j.properties en un editor y establezca la propiedad allow_store_upgrade en true:
```
allow_store_upgrade=true
```
5. Inicie el servidor de Spectrum™ Technology Platform.
6. Abra cada modelo en el Relationship Analysis Client y ejecute una consulta. Cualquier consulta es suficiente.
7. Detenga el servidor de Spectrum™ Technology Platform.
8. Abra el archivo SpectrumFolder\server\modules\hub\hub.properties en un editor y establezca la propiedad hub.neo4j.database.type en ha:
```
hub.neo4j.database.type=ha
```
9. Compare los archivos de propiedades de los que hizo una copia de seguridad con los archivos instalados y realice los cambios que sean necesarios. No sobrescriba los archivos nuevos con los antiguos, ya que los archivos nuevos pueden contener propiedades que no se encuentran en los antiguos.
Actualice los servidores no principales del módulo Data Hub en el clúster de servidores.

Importante: Al instalar cada servidor, seleccione la opción Solo servidor en el instalador y proporcione el host y el puerto de uno o más de los servidores de la base de datos de configuración. Puede averiguar el puerto en el archivo InstallationLocation\Database\repository\spectrum-container.properties. El puerto se especifica en la propiedad spectrum.repository.server.connector.bolt.port.
1. Elimine los modelos del directorio SpectrumDirectory\server\modules\hub\db.
  
  Aviso: No elimine los modelos del servidor maestro.
2. En uno de los servidores no principales, ejecute el instalador de Spectrum™ Technology Platform para actualizar la nueva versión de Spectrum™ Technology Platform.
3. Abra el archivo SpectrumFolder\server\modules\hub\hub.properties en un editor y establezca la propiedad hub.neo4j.database.type en ha:
```
hub.neo4j.database.type=ha
```
4. Compare los archivos de propiedades de los que hizo una copia de seguridad con los archivos instalados y realice los cambios que sean necesarios. No sobrescriba los archivos nuevos con los antiguos, ya que los archivos nuevos pueden contener propiedades que no se encuentran en los antiguos.
5. Copie los directorios SpectrumFolder\server\modules\hub\db\model.* desde el servidor principal al servidor no principal.
6. Repita estos pasos para cada servidor no principal del clúster.
Inicie el clúster.
1. Inicie el servidor maestro, seguido de los servidores no maestros.
2. Asegúrese de que todos los servidores del clúster estén funcionando. Revise si hay errores en SpectrumFolder\server\app\repository\wrapper.log.
3. Mientras está conectado directamente al servidor principal (pasando por alto el equilibrador de carga), abra cada modelo, uno a la vez, y revise si hay errores en el archivo wrapper.log.