Modification documentation suite a nouvelle instalation, hock biblio mmpdf version

  "description": "",

  "require": {

    "mpdf/mpdf": "8.0.4 as 7.1.7",

    "unicaen/app": "^3.0",

    "unicaen/auth": "^3.2.0",

    "oro/doctrine-extensions": "^1.2",

> Attention : le [ - ] indique que le service est INACTIF

#### Sous systemd la commande a utiliser est la suivante

```

systemctl list-unit-files --type=service | grep elastic

```

> Attention: l'état disabled indique que le service est INACTIF

```

elasticsearch.service                      disabled 

```

### Elasticsearch en tant que service

Vous pouvez tester l'état du service avec la commande `service elasticsearch status` :

Si vous êtes sous systemd, utilisez la commande `systemctl status elasticsearch.service` :

```

● elasticsearch.service - Elasticsearch

   Loaded: loaded (/usr/lib/systemd/system/elasticsearch.service; enabled; vendor preset: enabled)

xxx@zzzz:~$ déconnexion

```

Installez également le client postgresql qui sera necessaire pour importer la structure initale de la base de donnée :

```bash

# Postgresql (ou autre selon le client de BDD utilisé)

apt-get install postgresql postgresql-client postgresql-client-common

```

Vérification du bon fonctionnement

```

sudo -i -u postgres

apt install gearman-job-server

# Status du deamon

systemctl status gearman-job-server.service

# ou (selon que vous utilisiez systemd ou non selon votre version debian)

service gearman-job-server status

# Surveiller les tâches en attentes

watch "gearadmin --status | sort -n | column -t"

# Dans le cas ou vous avez un message "gearadmin not found", installez le nécessaire

apt-get install gearman-tools

```

### Création de la base de données vide

Création de l'utilisateur/bdd locale si besoin :

```bash

su - postgres

psql

```

### Création de l'utilisateur

Puis création de l'utilisateur/bdd :

```sql

CREATE USER oscar WITH PASSWORD 'azerty';

CREATE DATABASE oscar_dev;

GRANT ALL PRIVILEGES ON DATABASE oscar_dev to oscar;

\q

```

### Structure de données initiales

Les données "de base" sont à disposition dans

le dépôt dans le fichier : `install/oscar-install.sql`.

Par défaut, l'extension *Gearman* n'est pas activée dans le `php.ini`. Éditez les fichier **/etc/php/7.3/cli/php.ini** et **/etc/php/7.3/apache2/php.ini** en ajoutant la ligne :

```bash

psql -h localhost -U oscar oscar_dev < install/oscar-install.sql

```ini

; /etc/php/7.3/cli/php.ini - /etc/php/7.3/apache2/php.ini

extension=gearman

```

> La structure initiale n'est pas forcement à jour, vous devez donc procéder à la **Mise à jour du modèle** présenté dans le point suivant.

Ensuite il faut configurer le *Worker Oscar* qui se chargera de réaliser les tâches disponibles sur le serveur :

```bash

# On lance le service

service oscarworker start

# Si vous utilisez systemd

systemctl start oscarworker.service

# On regarde si tout est OK

journalctl -u oscarworker.service -f

Etape détaillée dans [Installation de Gearman](./install-gearman.md)

## Installation de la base de données

### Création de la base de données vide

> La structure initiale n'est pas forcement à jour, vous devez donc procéder à la **Mise à jour du modèle** présenté dans le point suivant.

## Configuration d'oscar

### Configuration éditable 

Assurez vous qu'il est accessible en écriture

### Base de données

### Base de données configuration

Oscar est conçu pour fonctionner avec une base de données *Postgresql*.

Pour **mettre à jour les privilèges**, executez la commande : 

```bash

php public/index.php oscar patch checkPrivilegesJSON

php bin/oscar.php check:privileges

```

> Executer cette commande jusqu'à obtenir un message "Les privilèges sont à jour" (sera prochainement corrigé).

Vous pouvez tester la configuration avec la commande :

```bash

$ php public/index.php oscar test:config

php bin/oscar.php check:config

```

Assurez vous que les modules PHP requis sont bien détectés avec la mention "Installed" et que la base de données réponds. A cette étape, Oscar est fonctionnel mais il reste encore quelques paramètres à configurer.

a2enmod rewrite

a2enmod ssl

service apache2 reload

# Si sous systemd

systemctl restart apache2.service

```

Éditer le fichier de configuration apache2 :

Puis on commence par créer un compte d'autentification :

```bash

php public/index.php oscar auth:add

php bin/oscar.php auth:add

```

Puis on lui attribue le rôle "Administrateur" :

```bash

php public/index.php oscar auth:promote <USER> Administrateur

php bin/oscar.php auth:promote

```

Utiliser ensuite le navigateur pour vous rendre sur oscar et utiliser l'identifiant **admin** avec la mot de passe **password** pour vous connecter en tant qu'administrateur.