Maxime BOURIEAU
128 lines
5.1 KiB
Markdown
128 lines
5.1 KiB
Markdown
# 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. |