Général:FAQ MiseEnServiceSQWareManager

Généralités

Limites de cette section

Cette section n’a pas la prétention de traiter tous les cas possibles d'installations.
Elle fait "juste" voir comment mettre en service SQWareManager.

Vérifications préalables

Vérifiez d'abord que les prérequis sont en place (JAVA pour "SQWareManager Connector" et un vhost pour "SQWareManager Web".

Principe de fonctionnement

"SQWareManager Connector" est l'API qui permet d'accéder aux SGBD via JDBC.
L'interface graphique, "SQWareManager Web" est une application Laravel/react, elle possède sa propre "clé" (param APP_KEY).
"SQWareManager Web" doit pouvoir accéder à l'API de connexion de SQWareWeb (param SQW_DBSQWARE_API_TOKEN).
"SQWareManager Web" doit pouvoir accéder à l'API "SQWareManager Connector" (param SQW_CONNECTOR_TOKEN).

Paramétrage

SQWareManager Web

Création du fichier de paramétrage "vierge" :

cd $HOME/dbSQWare/SQWareManager/
cp SQWareManager_Web/.env.production.example SQWareManager_Web.env

Génération de la clé Laravel :

cd $HOME/dbSQWare/SQWareManager/SQWareManager_Web
php artisan key:generate
#La clé APP_KEY doit s'être générée (attention à ne pas la modifier, c'est elle qui sert aux chiffrements de l'application !)

Récupération du token SQWareWeb :

my
MariaDB [dbsqware_db]> select token_id from tsqw_TokenStatic where dbalias='SQWareManager';
#Mettre la valeur dans => SQW_DBSQWARE_API_TOKEN

Génération de la clé "SQWareManager Connector" :

openssl rand -base64 48
#Mettre la valeur dans => SQW_CONNECTOR_TOKEN (devra être mise également côté Connector)

Autres paramètres :

APP_URL=https://sqwaremanager.dbsqware.local/
#Mettre votre URL

Paramètres de connexion à la DB :

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=dbsqware_db
DB_USERNAME=dbsqware_user
DB_PASSWORD=sqw

Paramètres pour l'envoie de mail, important pour l'initialisation des comptes et alertes de sécurité :

MAIL_MAILER=smtp
MAIL_HOST=mysmtp.local
MAIL_PORT=587
MAIL_USERNAME=mail_adm@local.org
MAIL_PASSWORD=XyZ123
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=no-reply@local.org
MAIL_FROM_NAME="${APP_NAME}"
MAIL_REPLY_ADDRESS=contact@local.com