Correction doc d'install. Script SQL oublié: création des contraintes de références.

## Installation de l'applicatif

## Installation 

### Première obtention des sources et installation du serveur 

Pour ce qui est de l'installation du serveur d'application, n'ayant pas à Caen les compétences 

en déploiement Docker autres que pour le développement (d'où la présence d'un `Dockerfile` et d'un `docker-compose.yml`

dans les sources), nous documenterons une installation à l'ancienne.

Si vous voulez déployer l'application avec Docker, faites-le à partir du `Dockerfile` présent et n'hésitez pas à 

proposer des améliorations pour cette doc d'install!

### Première obtention des sources de l'application

Sur un serveur *Debian Stretch* de préférence, lancez les commandes suivantes pour obtenir les sources de SyGAL :

```bash

git clone https://git.unicaen.fr/open-source/sygal.git /var/www/sygal

```

Ensuite, placez-vous dans le répertoire des sources et jetez un oeil au script `Dockerfile.sh`.

### Configuration du serveur

Sur le serveur, placez-vous dans le répertoire des sources de SyGAL et jetez un oeil au script `Dockerfile.sh`.

Ce script est en quelque sorte l'équivalent du `Dockerfile` traduit en bash. 

(Vous y verrez que le dépôt git d'une image Docker Unicaen est cloné pour lancer 

son script `Dockerfile.sh` qui est lui aussi l'équivalent du `Dockerfile` de l'image 

NB: Vérifiez dans le script `Dockerfile.sh` que vous venez de lancer mais normalement 

`APACHE_CONF_DIR=/etc/apache2` et `PHP_CONF_DIR=/etc/php/7.0`.

### Installation d'une version précise 

### Installation d'une version précise de l'application

Normalement, vous ne devez installer que les versions officielles, c'est à dire les versions taguées, du genre `1.0.9`

par exemple.

### Fichiers de config de l'application

Placez-vous dans le répertoire de l'application puis déscendez dans le répertoire `config/autoload/`.

Placez-vous dans le répertoire de l'application puis descendez dans le répertoire `config/autoload/`.

Supprimez l'extension `.dist` des fichiers suivants :

- `local.php.dist`

#### `secret.local.php`

Concernant la config de connexion au WS, `'UCN'` doit être remplacé par le code établissement choisi lors

de la création de votre établissement dans la base de données (dans le script [`04-init.sql`](04-init.sql)) :

de la création de votre établissement dans la base de données (dans le script [`05-init.sql`](04-init.sql)) :

    'import-api' => [

        'etablissements' => [

                'url'      => 'https://sygal-import-ws:443',

                'proxy'    => false,

                'verify'   => false, // si true et faux certif : cURL error 60: SSL certificate problem: self signed certificate

                'user'     => 'sygal-app',

                'password' => 'xxxxxxxxxxx',

                'user'     => 'xxx',

                'password' => 'yyy',

Renseignez les infos de connexion à la BDD :

                    'CURRENT_SCHEMA' => $user,

La config fournie permet de simuler l'authentification Shibboleth de l'utilisateur 'premierf@univ.fr' 

créé en base de données (dans le script [`04-init.sql`](04-init.sql)) avec le rôle "Administrateur technique".

créé en base de données (dans le script [`05-init.sql`](04-init.sql)) avec le rôle "Administrateur technique".

Cela permet d'accéder aux pages de gestion des droits d'accès.

    'unicaen-auth' => [

                'HTTP_SN'             => 'Premier',

                'HTTP_SUPANNCIVILITE' => 'M.'

Théoriquement, à ce stade l'application SyGAL devrait être accessible.

## Dans l'application SyGAL elle-même

Si vous n'avez rien changé à la config de l'application concernant Shibboleth et si vous cliquez en haut à droite de

la page d'accueil de SyGAL sur "Connexion" puis sur "Fédération d'identité", vous devriez être dans la peau de 

François Premier, administrateur technique de test créé en base de données (dans le script [`04-init.sql`](04-init.sql)).

François Premier, administrateur technique de test créé en base de données (dans le script [`05-init.sql`](04-init.sql)).

### Droits d'accès

- le profil `BDD` au rôle *Bureau des doctorats UCN*

NB: "UCN" n'est qu'un exemple et pour vous ce sera le code établissement choisi lors

de la création de votre établissement dans la base de données (dans le script [`04-init.sql`](04-init.sql)) 

de la création de votre établissement dans la base de données (dans le script [`05-init.sql`](04-init.sql)) 

### Import

Placez-vous dans le répertoire de SyGAL sur le serveur pour lancer l'import puis la synchro des données.

Ce qui suit n'est possible que si le web service d'import de données est installé, si ce n'est pas le cas,

reportez-vous au [README du projet sygal-import-ws](https://git.unicaen.fr/open-source/sygal-import-ws).

reportez-vous au [README du projet sygal-import-ws](https://github.com/EsupPortail/sygal-import-ws).

### Lancement de l'import des données

--

-- Pour faire simple... si le logo de votre COMUE doit figurer sur la page de couverture des thèses

-- (page générée par l'appli), alors vous devez lancer les 2 inserts ci-dessous.

-- (page générée par l'appli), alors personnalisez puis lancez les 2 inserts ci-dessous pour créer

-- un établissement "COMUE" dans la base de données.

--

INSERT INTO STRUCTURE (ID, SOURCE_CODE, SIGLE, LIBELLE, TYPE_STRUCTURE_ID, SOURCE_ID, CODE, HISTO_CREATEUR_ID, HISTO_MODIFICATEUR_ID)

select STRUCTURE_ID_SEQ.nextval, 'COMUE', 'NU', 'Normandie Université', null, 1, 'COMUE', 1, 1 from dual;

select

  STRUCTURE_ID_SEQ.nextval, 'COMUE',

  'NU',                   --> sigle ou abbréviation à personnaliser

  'Normandie Université', --> libellé à personnaliser

  null, 1, 'COMUE', 1, 1

from dual;

INSERT INTO ETABLISSEMENT (ID, STRUCTURE_ID, DOMAINE, SOURCE_ID, SOURCE_CODE, EST_COMUE, EST_MEMBRE, HISTO_CREATEUR_ID, HISTO_MODIFICATEUR_ID)

select ETABLISSEMENT_ID_SEQ.nextval, s.ID, 'normandie-univ.fr', 1, 'COMUE', 1, 0, 1, 1 from STRUCTURE s where s.SOURCE_CODE = 'COMUE';

select

  ETABLISSEMENT_ID_SEQ.nextval, s.ID,

  'normandie-univ.fr', --> domaine à personnaliser

  1, 'COMUE', 1, 0, 1, 1

from STRUCTURE s

where s.SOURCE_CODE = 'COMUE';

--

-- Etablissements

--

--

INSERT INTO STRUCTURE (ID, SOURCE_CODE, SIGLE, LIBELLE, TYPE_STRUCTURE_ID, SOURCE_ID, CODE, HISTO_CREATEUR_ID, HISTO_MODIFICATEUR_ID)

select STRUCTURE_ID_SEQ.nextval, :codeEtablissement, 'Unicaen', 'Université de Caen Normandie', 1, 1, :codeEtablissement, 1, 1 from dual;

select

  STRUCTURE_ID_SEQ.nextval,

  :codeEtablissement,             --> à remplacer par le code choisi *entre apostrophe*, ex: 'UCN'

  'Unicaen',                      --> sigle ou abbréviation à personnaliser

  'Université de Caen Normandie', --> libellé à personnaliser

  1, 1,

  :codeEtablissement,             --> à remplacer par le code choisi *entre apostrophe*, ex: 'UCN'

  1, 1

from dual;

INSERT INTO ETABLISSEMENT (ID, STRUCTURE_ID, DOMAINE, SOURCE_ID, SOURCE_CODE, EST_COMUE, EST_MEMBRE, HISTO_CREATEUR_ID, HISTO_MODIFICATEUR_ID)

select ETABLISSEMENT_ID_SEQ.nextval, s.ID, 'unicaen.fr', 1, :codeEtablissement, 0, 1, 1, 1 from STRUCTURE s where s.SOURCE_CODE = :codeEtablissement;

select

  ETABLISSEMENT_ID_SEQ.nextval, s.ID,

  'unicaen.fr',       --> domaine à personnaliser

  1,

  :codeEtablissement, --> à remplacer par le code choisi *entre apostrophe*, ex: 'UCN'

  0, 1, 1, 1

from STRUCTURE s

where s.SOURCE_CODE = :codeEtablissement; --> à remplacer par le code choisi *entre apostrophe*, ex: 'UCN'

--

-- Sources de données importables.

-- Sources de données importables, ex: Apogée.

--

INSERT INTO SOURCE (ID, CODE, LIBELLE, IMPORTABLE, ETABLISSEMENT_ID)

  SELECT 2, SOURCE_CODE||'::apogee', 'Apogée '||SOURCE_CODE, 1, ID from STRUCTURE where SOURCE_CODE = :codeEtablissement;

  SELECT 2, SOURCE_CODE||'::apogee', 'Apogée '||SOURCE_CODE, 1, ID

  from STRUCTURE where SOURCE_CODE = :codeEtablissement; --> à remplacer par le code choisi *entre apostrophe*, ex: 'UCN'

--

-- Rôles par établissement.

  s.ID,

1

FROM tmp, STRUCTURE s

WHERE s.SOURCE_CODE = :codeEtablissement;

WHERE s.SOURCE_CODE = :codeEtablissement; --> à remplacer par le code choisi *entre apostrophe*, ex: 'UCN'

--

-- Création de l'individu/utilisateur de test

## Scripts SQL dans le répertoire [`02-inserts`](02-inserts)

Vous pouvez lancer ces scripts sans les modifier et dans l'ordre que vous voulez.

Vous pouvez lancer ces scripts sans les modifier et dans l'ordre que vous voulez puisque les contraintes de références

entre tables ne sont pas encore créées.

Si l'erreur Oracle `ORA-00922: option erronée ou absente` est rencontrée à la première ligne d'un script, 

c'est que `set define off ;` n'est pas supporté par le client SQL que vous utilisez. 

Si cette erreur a bloqué les INSERT situés après, supprimez cette ligne et relancez le script.

## Script SQL [`03-crea-comue.sql`](03-crea-comue.sql)

## Script SQL [`03-oracle-generate-ref-constraints-SYGAL.sql`](03-oracle-generate-ref-constraints-SYGAL.sql)

Lisez ce script pour décider si vous devez le lancer.

Vous pouvez lancer ce script sans modifier quoi que ce soit.

## Script SQL [`04-crea-comue.sql`](04-crea-comue.sql)

Lisez ce script pour décider si vous devez l'utiliser.

## Script SQL [`05-init.sql`](05-init.sql)

Vous devez adapter ce script avant de le lancer :

- Remplacez `'Unicaen'` par le sigle ou raccourci de votre établissement, 

  ex 'URN', 'Unilim'.

## Script SQL [`04-init.sql`](04-init.sql)

- Remplacez `'Université de Caen Normandie'` par le nom complet de votre étblissement, 

  ex: 'Université de Rouen Normandie', 'Université de Limoges'

Avant de lancer ce script vous devez décider d'un code représentant votre établissement dans l'application, 

ex: 'UCN', 'UNILIM', 'UTLN'.

- Décidez d'un code identifiant votre établissement dans l'application, ex: 'UCN', 'UNILIM'.

Si votre client SQL ne supporte pas l'utilisation de paramètre du genre :codeEtablissement, remplacez dans ce script

toutes les occurences de ":codeEtablissement" par le code choisi *entre apostrophe*, ex: `'UCN'`.

  Si vous préférez ou si votre client SQL ne supporte pas l'utilisation de paramètre du genre :codeEtablissement, 

  remplacez dans ce script toutes les occurences de ":codeEtablissement" par le code choisi *entre apostrophe*, 

  ex: `'UCN'`. Si votre client SQL supporte les motifs du genre :codeEtablissement, il vous demandera de saisir 

  une valeur pour ce paramètre lorsque vous lancerez le script : entrez le code choisi *entre apostrophe*.

Si votre client SQL supporte les motifs du genre :codeEtablissement, il vous demandera de saisir une valeur 

pour ce parameètre : entrez le code choisi *entre apostrophe*, ex: `'UCN'`.

Une fois ces adaptations faites, vous pouvez lancer le script.