MAJ Docs

CHANGELOG.md

@@ -3,7 +3,7 @@ title: "Changements intervenus sur OSE"
 author: Laurent Lécluse - DSI - Unicaen
 ---
 
-# OSE 9.0 alpha
+# OSE 9.0-zf2 et 9.0-zf3
 
 ## Correction de bugs
 
@@ -19,9 +19,21 @@ author: Laurent Lécluse - DSI - Unicaen
 
 ## Nouveautés
 
+* Deux éditions de OSE sont disponibles :
+    * 9.0-zf2 basée sur le Zend Framework 2 et qui requiert PHP7.0 (édition "historique")
+    * 9.0-zf3 basée sur le Zend Framework 3 et qui requiert PHP7.3
 * Ajout d'un nouveau contrôle lors des demandes de mise en paiement : il n'est plus possible de payer plus d'heures que d'HETD même si des HETD ont déjà été payées à tort
 * La vue matérialisée MV_EXT_SERVVICE a été créée pour être exploitée pour alimenter des outils de pilotage (BO, etc).
 
+## Notes de mise à jour
+
+Si vous mettez à jour à partir des versions :
+
+* 8.2.* : pas de soucis, un ./bin/ose update suffit.
+* 8.1.* : lancez ./bin/ose update normalement. Vous rencontrerez un message d'erreur dû à un bug lié à cette version (PHP Fatal error:  Uncaught Error: Call to undefined method OseAdmin::getOseAppliId()).
+Pour pallier à cela, il vous faudra exécuter ensuite la commande ./bin/ose update-bdd pour que tout rentre dans l'ordre.
+* < 8.1 : mettez d'abord à jour en version 8.1.4, puis mettez à jour en 9.0.
+
 # OSE 8.2.2
 
 ## Correction de bugs

INSTALL.md

@@ -295,26 +295,47 @@ Enfin, ajouter à votre fichier /etc/hosts la ligne suivante :
 
 OSE sera accessible sur votre machine, à l'adresse http://ose-test.localhost
 
-# Création de la base de données
-Créez une base de données avec un utilisateur pour OSE, un schéma, puis un tablespace vides.
-Un script d'initialisation vous est fourni (fichier [bdd/install.sql](bdd/install.sql)). Il vous revient de le lancer pour peupler la base de données.
-
-Attention à bien veiller à ce que les accents soient correctement traités.
-Les caractères du fichier sont en **UTF8**.
-
 # Configuration technique
 Personnalisez le fichier `config.local.php` pour adapter OSE à votre établissement.
+Une attention toute particulière doit être prise pour configurer les paramètres de base de données, car ces derniers
+seront utiles pour terminer la procédure d'installation.
+
+# Création de la base de données
+Créez une base de données avec un utilisateur pour OSE, un schéma, puis un tablespace vides.
 
-# Mode installation
-Allez ensuite sur OSE. Par défaut, le mode installation est activé.
+Les droits de l'utilisateur Ose doivent être les suivants :
 
-Ce mode vous permettra de :
+```sql
+GRANT "CONNECT" TO "OSE";
+GRANT "RESOURCE" TO "OSE";
+GRANT "SELECT_CATALOG_ROLE" TO "OSE";
+GRANT CREATE JOB TO "OSE";
+GRANT FLASHBACK ANY TABLE TO "OSE";
+GRANT DEBUG ANY PROCEDURE TO "OSE";
+GRANT DEBUG CONNECT SESSION TO "OSE";
+GRANT SELECT ANY DICTIONARY TO "OSE";
+GRANT ON COMMIT REFRESH TO "OSE";
+GRANT CREATE MATERIALIZED VIEW TO "OSE";
+GRANT CREATE DATABASE LINK TO "OSE";
+GRANT CREATE VIEW TO "OSE";
+GRANT DROP PUBLIC SYNONYM TO "OSE";
+GRANT CREATE PUBLIC SYNONYM TO "OSE";
+GRANT UNLIMITED TABLESPACE TO "OSE";
+GRANT ALTER SESSION TO "OSE";
+GRANT SELECT ON "SYS"."DBA_ROLE_PRIVS" TO "OSE";
+GRANT SELECT ON "SYS"."DBA_TAB_PRIVS" TO "OSE";
+GRANT SELECT ON "SYS"."DBA_ROLES" TO "OSE";
+GRANT FLASHBACK ON "SYS"."ALL_SOURCE" TO "OSE";
+GRANT EXECUTE ON "SYS"."DBMS_LOCK" TO "OSE";
+GRANT EXECUTE ON "SYS"."DBMS_ALERT" TO "OSE";
+```
 
-*  vérifier que toutes les dépendances nécessaires au bon fonctionnement de l'application sont satisfaites
-*  contrôler que les paramètres de configuration que vous avez choisi fonctionnent correctement
-*  Choisir ou changer le mot de passe de l'utilisateur `oseappli`, qui est administrateur de l'application.
+Une fois la base de données créée, il faut mettre en place les tables, les vues, etc.
+Cela se fait au moyen de la commande suivante (depuis le répertoire de OSE) :
 
-Une fois cette étape terminée, il convient de passer OSE en mode production. Cela se fait dans le fichier de configuration `config.local.php`, en positionnant à `false` `global/modeInstallation`.
+```bash
+./bin/ose install-bdd
+``` 
 
 # Mise en place des tâches CRON
 Des tâches CRON doivent être lancée sur votre serveur régulièrement pour mettre à jour certaines données
@@ -329,7 +350,7 @@ Il est suivi de l'action à exécuter, puis éventuellement de paramètres à pr
 
 Exemple d'utilisation pour lancer une tâche de synchronisation appelée `synchro`:
 ```bash
-/usr/bin/php /var/www/ose/bin/ose synchronisation synchro
+/usr/bin/php [votre dossier ose]/bin/ose synchronisation synchro
 ```
 
 | Usage                 | Fréquence             | Action de script      |

UPDATE.md

@@ -10,13 +10,19 @@ titlepage-rule-height: 1
 
 # Procédure de mise à jour
 
+## Avant de débuter
+
+[La liste des changements](CHANGELOG.md) recense les changements apportés par les différentes versions de l'application.
+Vous êtes invités à consulter cette page, car y sont mentionnées des "notes de mise à jour" par version qu'il
+convient de lire attentivement avant de démarrer toute opération.
+
 ## Mode maintenance
 Placez OSE en mode maintenance. Dans le fichier `config.local.php` :
 
 * `maintenance/modeMaintenance` doit passer à `true`.
 * `maintenance/messageInfo` peut être personnalisé pour informer les utilisateurs.
 
-## Mise à jour des fichiers
+## Mise à jour
 
 * Si les fichiers sources de OSE ont été modifiés manuellement (hors fichier de configuration local), veillez à remettre la copie
 de travail dans son état originel au moyen de la commande suivante :
@@ -24,16 +30,10 @@ de travail dans son état originel au moyen de la commande suivante :
 
 * Dans le répertoire de l'application, exécutez `./bin/ose update`, puis suivez les instructions.
 
-## Mise à jour de la base de données
-
-* Dans le répertoire `bdd/update`, si un fichier `.sql` corresopnd à la nouvelle version installée,
-exécutez les requêtes dans SQL Developer pour mettre à jour la base de données.
-
-## Tests
+La base de données sera également mise à jour (structures et données).
 
-[La liste des changements](CHANGELOG.md) 
-recense les changements apportés par les différentes versions de l'application.
-Vous êtes invité à tester prioritairement ces changements.
+Si au niveau base de données vous rencontrez des erreurs, une nouvelle mise à jour de la base de données pourra être lancée
+au moyen de la commande `./bin/ose update-bdd`. 
 
 ## Passage en production
 

config.local.php.default

@@ -4,7 +4,7 @@ return [
     /* Paramètres généraux */
     'global' => [
         /* Détermine si l'installation de OSE est faite ou non. Pour pouvoir lancer OSE, positionnez à false */
-        'modeInstallation' => true,
+        'modeInstallation' => false,
 
         /* Accès en mode HTTP ou HTTPS */
         'scheme'           => '',