Procédure de mise-à-jour Workey

Avant d'entreprendre la mise-à-jour d'un serveur Workey, assurez-vous :
D’avoir pris connaissance de l'ensemble des notes de version depuis la version de départ jusqu'à la version cible.
Celles-ci indiquent les éventuelles modifications complémentaires à apporter à la configuration cible.

Cette procédure n'est valable que pour des installations standards de Workey. Elle ne prend pas en considération d'éventuels développements spécifiques ou tout autresmodules optionnels.

Prérequis

Récupérer le livrable de la release cible.
Passer le serveur en mode Maintenance, depuis la console d'administration.
Arrêter le serveur Workey (Tomcat). Ex: systemctl stop Logilec_demo.service

Maintenance On/Off

maintenance_on_off le_serveur_est_en_maintenance

Réaliser la sauvegarde des éléments suivants :
• la base de données socle de Workey: schéma et données
• le répertoire /webapps de Tomcat. Notamment le fichier workey.war et le répertoire /workey (correspondant au war décompressé par Tomcat).
• le fichier de propriétés servant à configurer Workey.
• l'arborescence des répertoires de travail de Workey.

D'une manière générale, il est recommandé de réaliser une sauvegarde préalable de tout fichier que vous seriez amené à modifier durant la mise-à-jour.

backup

Installation

  • Décompresser le livrable de la release cible dans /tmp.
  • Dans le répertoire /webapps
    • Supprimer le fichier workey.war existant
    • Supprimer le répertoire workey; celui-ci correspondant au fichier workey.war décompressé par Tomcat.
  • Recopier le fichier workey.war
    du répertoire /tmp du livrable décompressé -> vers le répertoire /webapps

Configuration

Effectuer toute modification de configuration qui serait mentionnée dans les notes de version

Démarrage

Le processus de mise-à-jour se poursuivra au redémarrage du serveur Workey.
La finalisation du mise-a-jour est susceptible de nécessiter un temps de traitement significatif, en fonction de la volumétrie de la base socle.

La procédure de mise-à-jour est achevée une fois le démarrage complet du serveur effectué.

Depuis la console d'administration : Désactiver le mode Maintenance.

Workey SQL Patcher

Objet

Le Workey SQL Patcher (WSQLP) permet d'effectuer les modifications du schéma d'une base de données socle Workey existante, afin quelle puisse être compatible avec un serveur Workey 6.
A partir de la version 6.x, Workey s'appuie sur le serveur Tomcat et le moteur de persistence Hibernate.
Les versions antérieures s'appuyaient sur le serveur d'application JBoss.
Cette version du WSQLP couvre les modifications de schéma pour les versions de Workey: depuis les versions 3.5.2, jusqu'à la version cible de l'outil (celui-ci est toujours livré pour une version spécifique).

Prérequis

L'usage du WSQLP nécessite:

  • une base socle Workey existante (dans l'une des versions applicables),
  • un JRE 7 installé sur le poste depuis lequel sera exécuté le programme.

Le WSQLP modifie une base socle Workey pour une version cible donnée. Il s'agit d'une opération non réversible.
Vous devrez donc avoir préalablement fait une sauvegarde complète de votre base socle.

Livrables

Le WSQLP est fourni avec le livrable d'installation (ou de mise-à-jour) de Workey.
Une fois ce livrable décompressé, le WSQLP est situé sous l'arborescence /tools

Deux versions de l'outil sont fournies :

workey-patcher(x86).exe, l'exécutable Windows 32bits -> son exécution requiert qu'une JVM 32-bits soit préalablement installée.
workey-patcher.exe, l'exécutable Windows 64bits -> son exécution requiert qu'une JVM 64-bits soit préalablement installée.

Lancement de workey-patcher

Le workey-patcher(x86).exe est une application en mode console. lancer_workey_patch86

Au lancement de workey-patcher(x86).exe, l'utilisateur sera invité à saisir chacune de ces informations... workey_patcher_powershell

-------------- Enter database connection parameters ---------------------------

User input | DBMS product name: Microsoft SQL Server
User input | DBMS IP Address (or server name): 172.25.156.1
User input | Database name: wky_fecamp
User input | Database username: sa
User input | Database password: <undisclosed>

-------------- Building internal type mapping ---------------------------------

Si tout se passe bien, nous avons ce résultat à la fin.

-------------- Committing all statements --------------------------------------
  Total time spent is 360ms

  Workey Patcher finished on Wed Mar 02 16:00:17 CET 2022
_______________________________________________________________________________

Procédure de mise-à-jour Workey envoyés par Efalia
W6 update documentation
WorkeySQLPatcher6-0-0