Add documentation for Quescom and StartPhoneServer deployment procedures
This commit is contained in:
Maxime BOURIEAU
@@ -0,0 +1,25 @@
|
||||
---
|
||||
name: Chercheur de procedures
|
||||
description: "Retrouve rapidement dans le depot les commandes, tutoriels, procedures et instructions de configuration ou de mise a jour. Utilisez-le pour chercher une commande ou savoir comment effectuer une operation deja documentee."
|
||||
tools: [read, search]
|
||||
user-invocable: true
|
||||
---
|
||||
|
||||
Tu es specialise dans la recherche de commandes et de procedures dans ce depot de documentation informatique. Reponds en francais.
|
||||
|
||||
## Perimetre
|
||||
- Cherche uniquement dans les documents du depot; ne modifie aucun fichier et n'execute aucune commande.
|
||||
- Retrouve les procedures, tutoriels, commandes, configurations, installations, restaurations, mises a jour et operations d'exploitation.
|
||||
- Ne suppose pas qu'une commande est correcte si elle n'apparait pas dans une source du depot. N'invente jamais de commande ni d'etape.
|
||||
|
||||
## Methode
|
||||
1. Identifie les mots importants de la demande: produit, technologie, operation, environnement ou symptome.
|
||||
2. Recherche dans les noms de fichiers, titres, intertitres et contenu. Essaie des variantes et synonymes utiles, notamment commande, procedure, preparation, configuration, configurer, installation et mise a jour.
|
||||
3. Ouvre le document correspondant et verifie le passage pertinent avant de repondre.
|
||||
4. Si plusieurs documents correspondent, privilegie celui dont le titre et la section repondent le plus directement; ajoute un autre resultat seulement s'il apporte une voie distincte utile.
|
||||
|
||||
## Reponse
|
||||
- Donne une reponse breve en francais, avec le sujet retrouve et un lien Markdown vers le fichier du depot. Ajoute le titre de section pertinent si disponible.
|
||||
- Pour une demande de commande precise, restitue la commande telle qu'elle est ecrite dans la source, avec son contexte ou ses avertissements immediats. Ne la transforme pas.
|
||||
- Pour un tutoriel ou une procedure, indique en une phrase ce qu'il couvre; ne recopie pas la procedure entiere sauf demande explicite.
|
||||
- Si aucun resultat pertinent n'est trouve, dis-le clairement et demande un mot-cle plus precis (par exemple produit, plateforme ou operation). Ne presente pas une correspondance incertaine comme un resultat confirme.
|
||||
@@ -0,0 +1,230 @@
|
||||
# Déploiement de Quescom et de StartPhoneServer
|
||||
|
||||
## Prérequis
|
||||
|
||||
- Disposer des VM StartPhoneServer et Quescom.
|
||||
- Ne plus utiliser l'application Passerelle SMS.
|
||||
- Définir l'URL de retour et l'adresse IP du serveur Quescom (Réseau/TaskForce), ainsi que le login et le mot de passe fournis par Quescom. Ces informations devront être renseignées dans StartPhoneServer.
|
||||
|
||||
## Déploiement et configuration des VM
|
||||
|
||||
Les VM modèles sont disponibles à l'emplacement suivant :
|
||||
|
||||
```text
|
||||
\\cloud\Clients\Sdis08\Recuperation_Systel\VM-Quescom
|
||||
```
|
||||
|
||||
### Configuration réseau
|
||||
|
||||
Adapter les adresses IP en fonction des VLAN et des dispositions du DCI, en coordination avec les experts réseau et la chefferie de projet.
|
||||
|
||||
### VM Quescom (QASAAR) et passerelles
|
||||
|
||||
La VM Quescom, initialement basée sur CentOS 7, doit être mise à jour vers AlmaLinux 10.
|
||||
|
||||
Une fois l'adresse IP définie, le paramétrage de la machine est accessible à l'adresse suivante : `https://IP_VM:9090`.
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
L'application se paramètre ensuite depuis un navigateur à l'adresse `http://IP_VM`.
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
Les paramètres concernés se trouvent dans le menu **Configuration > Passerelles et routes > Routes / Passerelles**.
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
### Configuration DNS
|
||||
|
||||
Ajouter les entrées DNS nécessaires à l'envoi des SMS et au retour des accusés de réception vers StartPhoneServer. Elles doivent être redirigées vers les HA-INT.
|
||||
|
||||
Captures d'écran : `image.png`, `image.png`
|
||||
|
||||
### Configuration du pare-feu
|
||||
|
||||
Configurer les flux suivants :
|
||||
|
||||
| Source | Destination / service | Port ou protocole |
|
||||
| --- | --- | --- |
|
||||
| `Grp_StartPhone` | BD | `1521` (Oracle) ou `1433` (SQL), selon le client |
|
||||
| `Grp_StartPhone` | AMQ | `61616` |
|
||||
| `Grp_StartPhone` | Broker | `1883` (MQTT) ou `10192` (WS) |
|
||||
| `Grp_StartPhone` | `RPINT_VIP` | `443` |
|
||||
| `RPINT_VIP` | Quescom | `443` |
|
||||
|
||||
## Schéma de principe
|
||||
|
||||
Schéma : `schema quescom.png`
|
||||
|
||||
## Configuration de StartPhoneServer
|
||||
|
||||
### Pilotage de Quescom uniquement
|
||||
|
||||
Lors de l'import de la VM fournie, les fichiers de configuration sont déjà renseignés, à l'exception des paramètres propres au SDIS.
|
||||
|
||||
#### `config.properties`
|
||||
|
||||
Partir du fichier `config.properties.quescom.example`, situé dans le répertoire suivant, puis renseigner les paramètres de base (base de données, ActiveMQ, Broker, etc.) :
|
||||
|
||||
```text
|
||||
\\cloud\Qualité\Alerte\Version de référence SGO_117\Version StartPhoneServer\conf
|
||||
```
|
||||
|
||||
#### `plugins.properties`
|
||||
|
||||
Partir du fichier `plugins.properties.quescom.example`, situé dans le même répertoire. Le plugin **(A10) QUESCOM** doit impérativement être activé.
|
||||
|
||||
Dans la section **(B7)**, renseigner les paramètres suivants :
|
||||
|
||||
- `quescomPlugin.url` : URL utilisée pour joindre le serveur Quescom.
|
||||
- `quescomPlugin.login` : login défini avec Quescom dans les prérequis.
|
||||
- `quescomPlugin.password` : mot de passe défini avec Quescom dans les prérequis.
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
#### `units.properties`
|
||||
|
||||
Partir du fichier `units.properties.quescom.example`, situé dans le répertoire de configuration indiqué ci-dessus.
|
||||
|
||||
### Pilotage de la téléphonie en plus de Quescom
|
||||
|
||||
Partir des fichiers `conf.example` standard de StartPhoneServer. Vérifier que le plugin Quescom est activé et que la section **(B7) Quescom** est correctement configurée dans `plugins.properties`.
|
||||
|
||||
## Configuration des HA-INT (HAProxy)
|
||||
|
||||
### Sauvegarde de la configuration
|
||||
|
||||
Sur les deux HA-INT, sauvegarder le fichier `haproxy.cfg` :
|
||||
|
||||
```bash
|
||||
cd /etc/haproxy
|
||||
cp haproxy.cfg haproxy.cfg_avant_ajout_quescom
|
||||
```
|
||||
|
||||
### Configuration du HA inactif
|
||||
|
||||
#### Définir les ACL
|
||||
```haproxy
|
||||
# ACL for PRODUCTION
|
||||
acl LAN_ACL_RETOUR_QUESCOM hdr_dom(host) -i retour-quescom.sdis08.fr
|
||||
acl LAN_ACL_QUESCOMSERVEUR hdr_dom(host) -i quescomserveur.sdis08.fr
|
||||
acl LAN_ACL_STARTPHONE hdr_dom(host) -i startphoneserver.sdis08.fr
|
||||
```
|
||||
|
||||
#### Associer les ACL aux backends
|
||||
|
||||
```haproxy
|
||||
# Backup for PRODUCTION
|
||||
use_backend BACK_LAN_STARTPHONESERVER if LAN_ACL_STARTPHONE
|
||||
use_backend BACK_LAN_STARTPHONESERVER if LAN_ACL_RETOUR_QUESCOM
|
||||
use_backend BACK_LAN_QUESCOMSERVEUR if LAN_ACL_QUESCOMSERVEUR
|
||||
```
|
||||
|
||||
#### Définir le frontend sur le port 8990
|
||||
|
||||
```haproxy
|
||||
######### DON'T TOUCH ##########
|
||||
######## FrontEnd Local ########
|
||||
|
||||
frontend FRONT_LAN_STARTPHONESERVER_8990
|
||||
bind :8990
|
||||
mode http
|
||||
use_backend BACK_LAN_STARTPHONESERVER
|
||||
```
|
||||
|
||||
#### Définir les backends StartPhoneServer et Quescom
|
||||
|
||||
```haproxy
|
||||
######### STARTPHONESERVER ##########
|
||||
######### Retour Quescom ##########
|
||||
|
||||
backend BACK_LAN_STARTPHONESERVER
|
||||
mode http
|
||||
acl h_CI_exists req.hdr(CLIENT-IP) -m found
|
||||
http-request add-header CLIENT-IP %[src] unless h_CI_exists
|
||||
option httpchk GET /systel-rest/poluxeye/info/
|
||||
http-check expect rstring \Wstate\W:\s\WSTARTED\W,
|
||||
### Serveurs STARTPHONE ###
|
||||
server STARTPHONE1 10.xxx.xxx.xx1:8990 check
|
||||
server STARTPHONE2 10.xxx.xxx.xx2:8990 check
|
||||
|
||||
############ QUESCOMSERVEUR ##############
|
||||
backend BACK_LAN_QUESCOMSERVEUR
|
||||
mode http
|
||||
|
||||
# Vérifie si le header CLIENT-IP existe déjà
|
||||
acl h_CI_exists req.hdr(CLIENT-IP) -m found
|
||||
|
||||
# Ajoute l'IP source si le header n'est pas présent
|
||||
http-request add-header CLIENT-IP %[src] unless h_CI_exists
|
||||
|
||||
# Serveur Quescom en HTTPS
|
||||
server QUESCOMSERVEUR 10.108.106.1:443 ssl verify none check maxconn 500 weight 1
|
||||
```
|
||||
|
||||
Vérifier la configuration HAProxy :
|
||||
|
||||
```bash
|
||||
haproxy -c -f /etc/haproxy/haproxy.cfg
|
||||
```
|
||||
|
||||
Redémarrer le service HAProxy :
|
||||
|
||||
```bash
|
||||
service haproxy restart
|
||||
```
|
||||
|
||||
### Configuration du HA actif
|
||||
|
||||
Pour mettre à jour le HA plus rapidement, exécuter la commande suivante :
|
||||
|
||||
```bash
|
||||
haproxyupdate IP_HA_actif
|
||||
```
|
||||
|
||||
## Configuration de START
|
||||
|
||||
Activer l'OCN correspondante dans les OCN2.
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
## Tests de fonctionnement
|
||||
|
||||
Deux méthodes permettent de vérifier le fonctionnement.
|
||||
|
||||
### Depuis START
|
||||
|
||||
1. Dans START, ouvrir **Messagerie > Multi-messagerie**.
|
||||
2. Saisir le texte à envoyer.
|
||||
3. Saisir le numéro de téléphone de test, puis cliquer sur **Ajouter**.
|
||||
4. Cliquer sur **Envoyer** en haut de la page.
|
||||
|
||||
Captures d'écran : `image.png`, `image.png`, `image.png`
|
||||
|
||||
### Depuis la base de données
|
||||
|
||||
Pour envoyer un SMS de test, adapter le texte et le numéro de téléphone dans la requête suivante :
|
||||
|
||||
```sql
|
||||
insert into messages_sms (ID_MESSAGE_SMS,NUM_TEL_DESTINATAIRE,TEXTE_MESSAGE_SMS,ETAT_MESSAGE_SMS)(select max(ID_MESSAGE_SMS)+1, 'numéro de téléphone à renseigner','Test SMS Quescom',0 from messages_sms)
|
||||
|
||||
commit --si oracle
|
||||
```
|
||||
|
||||
### Vérifier l'envoi via Quescom
|
||||
|
||||
Dans les logs de StartPhoneServer, consulter le fichier `QuescomPlugin[MOBILISATION].log`. Il indique les SMS envoyés, le numéro de téléphone, le texte et le statut de l'envoi.
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
## Vérifier le retour Quescom
|
||||
|
||||
Depuis un navigateur, accéder à l'URL suivante en l'adaptant au DNS et au nom de domaine concernés :
|
||||
|
||||
```text
|
||||
https://retour-quescom.bmpm13.fr/systel-rest/quescom/api
|
||||
```
|
||||
|
||||
Capture d'écran : `image.png`
|
||||
|
||||
Si une API se télécharge après avoir cliqué sur **Continuer vers le site**, la configuration du HA-INT pour le retour est correcte.
|
||||
Reference in New Issue
Block a user