Montée de version

Sommaire
  1. Passage de SCENARIserver4.0 à SCENARIserver4.1

Passage de SCENARIserver4.0 à SCENARIserver4.1⚓

Paramétrage du serveur⚓

Les fichiers de configuration de la webapp n'ont que peu évolué entre SCENARIserver4.0 et SCENARIserver4.1 (hormis une réorganisation mineure).

Néanmoins, de façon générale pour toute nouvelle version, il convient de reporter dans ces nouveaux fichiers de configuration les ajustements que vous avez réalisé pour votre précédent système.

AttentionÉvolution de la configuration LDAP [DB uniquemennt]⚓

L'évolution du paramétrage de la connexion LDAP nécessite d'opérer un ajustement sur les différents utilisateurs déjà déclarés.

Pour réaliser cela automatiquement, si un contexte LDAP était déjà actif dans votre système en 4.0, il vous faudra exécuter le script batch "apps/dbMigrFrom40To41" présent dans l'application SCENARIbatch.

Données utilisateur⚓

SCENARIserver [db]⚓

La compatibilité ascendante est assurée. Ainsi, dans un environnement 4.1, il suffit de référencer le même jeu de données (variable de configuration server.work.path) que celui précédemment exploité en 4.0 pour qu'une transformation automatique de celui-ci soit opérée lors du premier lancement.

Répertoires concernés :

  • [server.work.path]/javaserver/db;
  • [server.work.path]/javaserver/blobs ;
  • [server.work.path]/javaserver/privData ;
RemarqueFichier txLog [db]⚓

La structure du fichier de log [server.work.path]/javaserver/db/txlog.otx a changé dans SCENARI4.1. Ce fichier, exploité uniquement pour enregistrer des logs transactionnels, peut être supprimé avant la migration SCENARIserver4.1.

Si cette suppression n'est pas réalisée, l'erreur ci-dessous peut se produire, et sera à ignorer (aucune incidence fonctionnelle) :

1
INFO: Server startup in 4225 ms
2
15 juil. 2014 12:14:56 com.orientechnologies.common.log.OLogManager log
3
ATTENTION: Error on opening the txlog file 'File: txlog.otx os-size=1000000, stored=998976, filled=998976, max=536870912', reset it
4
com.orientechnologies.common.io.OIOException: You cannot access outside the file size (998976 bytes). You have requested portion -83439842--83439841 bytes. File: File: txlog.otx os-size=1000000, stored=998976, filled=998976, max=536870912
5
 at com.orientechnologies.orient.core.storage.fs.OAbstractFile.checkRegions(OAbstractFile.java:363)
6
 at com.orientechnologies.orient.core.storage.fs.OFileClassic.checkRegions(OFileClassic.java:230)
7
 at com.orientechnologies.orient.core.storage.fs.OFileClassic.readByte(OFileClassic.java:120)
8
 at com.orientechnologies.orient.core.storage.impl.local.OTxSegment.scanForTransactionsToRecover(OTxSegment.java:233)
9
 at com.orientechnologies.orient.core.storage.impl.local.OTxSegment.recoverTransactions(OTxSegment.java:200)
10
 at com.orientechnologies.orient.core.storage.impl.local.OTxSegment.open(OTxSegment.java:87)
Attention

  • Avant de réaliser cette montée de version, il convient de réaliser une sauvegarde complète des données ;

  • La phase de transformation automatique des données peut durer plusieurs minutes en fonction de la taille de la base de données. Son début est signifié par les lignes suivantes dans le fichier de log :

    1
    1--- Info : Tue Jul 15 11:54:30 CEST 2014 (DbScheduler:repos) ---
    2
    Start database migration DbVersion 'core' from 0 to 1. (class eu.scenari.orient.init.migr.DbMigrCore0_1)
    3
    4
    5
    1--- Info : Tue Jul 15 11:54:35 CEST 2014 (DbScheduler:repos) ---
    6
    Start rebuild Db : repos - local-sc:D:/scenari/data/scserver41/javaserver/db
    La fin (et la réussite ) de cette étape seront indiqué par ces lignes :
    1
    1--- Info : Tue Jul 15 11:56:13 CEST 2014 (DbScheduler:repos) ---
    2
    End rebuild Db: repos in 98280ms
    3
    4
    5
    1--- Info : Tue Jul 15 11:56:13 CEST 2014 (DbScheduler:repos) ---
    6
    End database migration DbVersion 'core' from 0 to 1
    Un arrêt du serveur pendant cette phase de migration peut conduire à une perte des données, et nécessitera l'utilisation d'un backup.
  • Les données de la 4.1 ne peuvent pas être utilisées dans un contexte 4.0 (pas de compatibilité descendante) ;
SCENARIserverLite⚓
Aucune transformation de donnée n'est opérée : les structures de donnée sont  iso-fonctionnelles.
Répertoires concernés :
  • [server.work.path]/javaserver/wsps ;
  • [server.work.path]/javaserver/privData ;
Données applicatives⚓
Répertoire temporaire⚓
Le répertoire temporaire paramétré via la variable server.temp.path peut être purgé.
Modèle documentaire⚓
Le ou les modèles documentaires (wsppack) installés et exploités dans une version X.Y de scenari sont incompatibles avec toute version X.Y+1 (le système l'indiquera clairement).
Il convient donc d'installer sur SCENARIserver4.1 le ou les modèles documentaires dédiés.
Répertoires concernés à purger donc :
  • [server.work.path]/javaserver/pack ;
  • [server.work.path]/javaserver/updt ;