Add installation and configuration guides for Nutanix and Synology NAS, along with server preparation instructions for Linux and Windows environments.

2026-10-15 08:58:51 +02:00
parent 968130672a
commit 735c4b2d58
23 changed files with 721 additions and 0 deletions
@@ -0,0 +1,128 @@
+ # 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 :
+
+```text
+/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 :
+
+```text
+\\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 :
+
+```bash
+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 :
+
+```bash
+mv release/ StartWeb/
+```
+
+## 6. Configurer StartWeb
+
+Se placer dans le répertoire de configuration :
+
+```bash
+cd /var/www/html/StartWeb/conf/
+```
+
+Créer les fichiers de configuration actifs à partir des modèles `.example` :
+
+```bash
+cp parametrageService.js.example parametrageService.js && cp routesBlackList.json.example routesBlackList.json
+```
+
+Éditer `parametrageService.js` pour l'adapter à l'infrastructure et aux serveurs disponibles :
+
+```bash
+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 :
+
+```bash
+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 :
+
+```bash
+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` :
+
+```bash
+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.