Procedure-Systel/Production SI/Configuration serveur/Serveur StartWeb.md

Configurer un serveur StartWeb

1. Prérequis

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

2. Vérifier le DNS

Sur un serveur Active Directory de la plateforme cible, vérifier les 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
SNMP	Alias ou hôte vers SNMP	Supervision SNMP

Vérifier les autres noms DNS requis pour l'environnement dans le DCSR et dans la configuration de la plateforme.

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)
STARTWEBx	AD1/AD2	TCP et UDP	53 / 123
STARTWEBx	SNMP	UDP	161 / 162
RPINT1/RPINT2/RPINTVIP	STARTWEBx	TCP	443
TELEMW1/TELEMW2	STARTWEBx	TCP	22 / 443

4. Vérifier NGINX

Une fois les prérequis réseau vérifiés, se connecter au serveur en SSH avec le compte root.

Le portail StartWeb utilise NGINX, préconfiguré pour écouter sur le port 443. Le certificat autosigné se trouve dans :

/etc/ssl/private/nginx/

La procédure source indique une longue durée de validité du certificat. Vérifier sa validité conformément aux exigences de l'environnement.

5. Installer StartWeb

5.1 Récupérer et transférer l'archive

Récupérer sur le Cloud Systel l'application portail correspondant à la version de Start utilisée :

\\cloud\Qualité\Alerte\Version de référence SGO_11x\Version StartWeb\startweb-xxx.xxx.zip

Transférer l'archive par SFTP vers /tmp ou /home/systel sur la VM StartWeb. En cas de renouvellement, sauvegarder au préalable les fichiers de configuration existants qui doivent être conservés.

Déplacer l'archive sélectionnée dans /var/www/html. Adapter le chemin source et le nom de fichier à l'emplacement et à la version réellement transférés. Exemple de nom fourni dans la procédure source : startweb-485.117.2503-3(54195).zip.

5.2 Nettoyer et déployer les fichiers

Dans /var/www/html, identifier les archives présentes et confirmer le nom exact de l'archive à installer. Supprimer uniquement les anciennes archives de template, sans supprimer l'archive sélectionnée. Ne pas utiliser rm /var/www/html/startweb-4* après avoir déplacé l'archive : ce motif correspond également à l'archive StartWeb choisie.

Avant de supprimer le répertoire StartWeb existant, vérifier son contenu et sauvegarder les fichiers à conserver. Supprimer ou déplacer l'ancien répertoire uniquement lorsque son remplacement est confirmé.

Se placer dans le répertoire Web, puis extraire l'archive sélectionnée en indiquant son nom exact :

cd /var/www/html
unzip startweb-xxx.xxx.zip

Remplacer startweb-xxx.xxx.zip par le nom réel de l'archive. Renommer ensuite release en StartWeb en respectant les majuscules :

mv release/ StartWeb/

6. Configurer StartWeb

Se placer dans le répertoire de configuration :

cd /var/www/html/StartWeb/conf/

Créer les fichiers de configuration actifs à partir des modèles .example :

cp parametrageService.js.example parametrageService.js && cp routesBlackList.json.example routesBlackList.json

Éditer parametrageService.js pour l'adapter à l'infrastructure et aux serveurs disponibles :

nano parametrageService.js

Les valeurs propres au client sont à reprendre du DCSR, de l'ancien serveur ou d'une configuration validée. Une copie du fichier de référence peut également être disponible dans /var/www/ sur la VM Template. Dans ce cas, la copier puis l'adapter avant utilisation :

cp /var/www/parametrageService.js /var/www/html/StartWeb/conf/

Après modification, aucun redémarrage de NGINX n'est requis selon la procédure source : les changements sont pris en compte directement.

7. Déployer StartMob

La configuration de StartWeb et StartWebMob est désormais identique. Depuis /var/www/html, copier le répertoire StartWeb vers StartWebMob, en respectant les majuscules :

cp -r /var/www/html/StartWeb/ /var/www/html/StartWebMob/

Si StartWebMob existe déjà, vérifier son contenu et le sauvegarder ou le remplacer avant la copie, afin d'éviter de créer un répertoire imbriqué.

8. Vérifier le fonctionnement

Sur la page de supervision du RPINTVIP, vérifier que la ligne correspondant au serveur STARTWEBx est verte.

9. Sécuriser les comptes système

Modifier les mots de passe des comptes systel et root :

passwd systel
passwd root

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