Procedure-Systel/Production SI/Configuration serveur/Serveur Start & StartMob.md

Configurer un serveur Start / StartMob

1. Prérequis

1. Suivre la procédure Exporter et importer une VM depuis la plateforme de Production pour transférer la VM STARTx vers l'environnement client.
2. Suivre la procédure Préparation d'un serveur Linux.
3. Disposer du DCSR et, en cas de renouvellement d'infrastructure, de l'accès à l'ancien serveur en production afin de reprendre ses options et paramètres.

2. Vérifier la configuration DNS

Sur un serveur Active Directory de la plateforme cible, vérifier la présence des entrées suivantes et les créer si nécessaire :

Nom	Type et cible	Usage
AD1	Alias ou hôte vers AD1	DNS et NTP
AD2	Alias ou hôte vers AD2	DNS et NTP
ServeurActiveMQ1	Alias vers MULTI1	Connexion ActiveMQ
ServeurActiveMQ2	Alias vers MULTI2	Connexion ActiveMQ
SNMP	Alias ou hôte vers SNMP	Supervision SNMP
[SQL] ServeurBD	Alias vers BDSQLVIP	Connexion à la base SQL
[Oracle] BD1	Alias ou hôte vers BD1	Connexion à la base Oracle
[Oracle] BD2	Alias ou hôte vers BD2	Connexion à la base Oracle
mobilite.sdisXX.fr	Alias vers RPINTVIP	Connexion au broker VerneMQ

Adapter les enregistrements au type de plateforme (Production, Formation ou Test) selon le DCSR et la configuration validée de l'environnement.

3. Vérifier les flux réseau

Sur le pare-feu, vérifier les flux suivants et demander leur ouverture au service réseau s'ils sont absents :

Source	Destination	Protocole	Port(s)
STARTx	AD1/AD2	TCP et UDP	53 / 123
STARTx	MULTI1/MULTI2	TCP	61616
STARTx	SNMP	UDP	161 / 162
STARTx	BDVIP (SQL)	TCP	1433
STARTx	BD1/BD2 (Oracle)	TCP	1521
STARTx	NF399	TCP	18080
RPINT1/RPINT2/RPINTVIP	STARTx	TCP	18989
STARTx	RPINT1/RPINT2/RPINTVIP	TCP	1883
TELEMW1/TELEMW2	STARTx	TCP	22 / 8989

4. Récupérer les fichiers StartServer

Récupérer sur le Cloud Systel l'application StartServer/Polux et les fichiers de configuration correspondant à la version de Start utilisée. Le chemin de référence est :

\\cloud\Qualité\Alerte\Version de référence SGO_11x\Version Start\Progs\Polux

Pour un renouvellement d'infrastructure, récupérer les fichiers sur le serveur actuellement en production afin de préserver les options et les paramètres propres au client. Vérifier la version applicable avant le transfert.

1. Se connecter au nouveau serveur Start en SFTP.
2. Ouvrir le répertoire /opt/startserver.
3. Supprimer les fichiers et répertoires devenus inutiles ou incompatibles avec la version à installer. En cas de renouvellement, vérifier leur contenu avant suppression.
4. Déposer les nouveaux fichiers startserver et conf dans /opt/startserver, en remplaçant les fichiers existants lorsque cela est nécessaire.

5. Configurer StartServer

Se connecter en SSH au serveur STARTx.

5.1 Créer le lien symbolique Polux

Dans /opt/startserver, créer ou remplacer le lien Polux.jar pour qu'il pointe vers le fichier JAR de la version transférée :

cd /opt/startserver
ln -s -f Polux-xxx.xxx.xxxx-x.jar Polux.jar

Remplacer Polux-xxx.xxx.xxxx-x.jar par le nom exact du fichier installé.

5.2 Régler la mémoire maximale

Éditer le fichier de service :

nano /opt/startserver/conf/startserver.service.conf

Modifier STARTSERVER_MAX_MEM pour réserver 3 Go de RAM au système. Par exemple, pour un serveur disposant de 30 Go de RAM, définir la valeur à 27 Go. Vérifier la syntaxe et l'unité attendues par le fichier existant.

5.3 Adapter les fichiers de configuration

Éditer config.properties :

nano /opt/startserver/conf/config.properties

Mettre à jour le rôle du serveur ainsi que les adresses IP et noms DNS des serveurs associés, conformément au DCSR et à la configuration de l'ancien serveur.

Dans la section C (MQTT), définir l'identifiant de connexion au broker MQTT avec le nom du rôle du serveur. Utiliser le rôle approprié pour le serveur StartServer principal ou secondaire afin d'identifier clairement chaque connexion au broker.

Parcourir également l'ensemble de config.properties, puis vérifier et adapter, selon le besoin, les fichiers plugins.properties et units.properties présents dans le même répertoire conf. Reprendre les paramètres spécifiques à l'environnement depuis le DCSR ou l'ancien serveur; ne pas déduire de valeurs absentes de cette procédure.

6. Démarrer et vérifier le service

En SSH, démarrer le service puis vérifier son état :

service startserver start
service startserver status

Vérifier que le processus est indiqué comme étant running.

Dans un navigateur, ouvrir l'adresse suivante en remplaçant STARTx par le nom ou l'adresse du serveur :

http://STARTx:8989/systel-rest/poluxeye/#/home

Vérifier que l'application se charge complètement.

7. Sécuriser les comptes système

Modifier les mots de passe des comptes systel et root :

passwd systel
passwd root

Générer des mots de passe conformes à la politique locale et les enregistrer dans RDM. Ne pas inscrire les secrets dans cette procédure.