Commit 1f47b674 authored by Laurent Lécluse's avatar Laurent Lécluse
Browse files

MAJ Docs

parent a4f71349
......@@ -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
......
......@@ -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 |
......
......@@ -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
......
......@@ -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' => '',
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment