# 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.