Procedure-Systel/Production SI/Configurer un serveur INTERSGO.md

Configuration d'un serveur INTERSGO

1. Prérequis

• Suivre la procédure Exporter et importer une VM depuis la plateforme de Production pour importer la VM INTERSGOx dans l'environnement client.
• Suivre la procédure Préparation d'un serveur Linux pour préparer la VM.
• Disposer du DCSR et d'un accès à l'ancien serveur INTERSGO de production.

2. Configurer le DNS

Sur un serveur AD de la plateforme cible, vérifier la présence des entrées DNS ci-dessous et les créer si nécessaire :

• AD1 : entrée ou alias vers AD1 pour DNS et NTP.
• AD2 : entrée ou alias vers AD2 pour DNS et NTP.
• ServeurActiveMQ1 : alias vers MULTI1 pour ActiveMQ.
• ServeurActiveMQ2 : alias vers MULTI2 pour ActiveMQ.
• SQL : alias ServeurBD vers BDSQLVIP pour la connexion à la base de données.
• Oracle : entrées BD1 et BD2 vers les serveurs correspondants pour la connexion à la base de données.

Adapter les noms et destinations selon qu'il s'agit d'une plateforme de production, de formation ou de test, en suivant le DCSR et la configuration de référence.

3. Vérifier les flux réseau

Sur le pare-feu, vérifier que les flux suivants sont autorisés. Demander leur ouverture au service réseau s'ils sont absents.

Source	Destination	Protocole	Ports
INTERSGOx	AD1/AD2	TCP et UDP	53, 123
INTERSGOx	MULTI1/MULTI2	TCP	61616
INTERSGOx	BDVIP (SQL)	TCP	1433
INTERSGOx	BD1/BD2 (Oracle)	TCP	1521
RPINT1/RPINT2/RPINT_VIP	INTERSGOx	TCP	443, 18080, 10443, 1518, 20443
TELEMW1/TELEMW2	INTERSGOx	TCP	22, 443, 18080, 4848

4. Récupérer les fichiers de l'ancien serveur

Depuis l'ancien serveur INTERSGO1 de production, récupérer en SFTP avec FileZilla ou WinSCP les répertoires suivants :

/opt/glassfish3/keystore
/opt/glassfish3/distribution/xsd

Récupérer également les fichiers suivants :

/opt/glassfish3/glassfish/domains/domain1/config/cacerts.jks
/opt/glassfish3/glassfish/domains/domain1/config/keystore.jks

Transférer ces éléments vers le nouveau serveur aux mêmes emplacements. Avant le transfert, remplacer ou supprimer les fichiers déjà présents si nécessaire.

5. Configurer GlassFish depuis le portail d'administration

5.1 Se connecter

Depuis un serveur TELEMW Windows, ouvrir l'interface d'administration à l'adresse suivante :

https://INTERSGOx:4848

Se connecter avec le compte d'administration prévu et récupérer son mot de passe dans RDM. Ne pas conserver de mot de passe en clair dans cette procédure.

5.2 Paramétrer Java

Ouvrir les paramètres Java dans le portail d'administration.

• Modifier -Xmx5120m pour définir la mémoire maximale de GlassFish à la mémoire totale de la VM moins 1 Go. Pour une VM de 6 Go, la valeur par défaut est 5120m.
• Conserver -Xms1024m, qui définit la mémoire minimale à 1 Go.
• Le paramètre -DACTIVEMQ_IP=ServeurActiveMQ1;ServeurActiveMQ2 correspond aux serveurs ActiveMQ. Le modifier uniquement pour les plateformes de test ou de formation, selon leur configuration.

5.3 Paramétrer la base de données

Ouvrir les paramètres de la base de données StartPool. Vérifier et adapter si nécessaire l'utilisateur, le mot de passe, le nom de la VM et la chaîne de connexion en fonction de l'environnement cible. Récupérer les identifiants dans RDM.

Pour tester la connexion, ouvrir l'onglet General, puis cliquer sur Ping.

La VM est préconfigurée pour une base SQL. Pour utiliser Oracle, adapter l'ensemble des paramètres à partir de la configuration de la VM existante.

5.4 Vérifier les paramètres du serveur

Ouvrir les paramètres du serveur et comparer leur configuration avec celle du serveur actuel. Reporter sur la nouvelle VM les paramètres validés pour le client.

5.5 Vérifier les processus d'écoute HTTP

Ouvrir les paramètres des processus d'écoute HTTP. Pour chaque port, vérifier la configuration de l'ancien serveur : activation, sécurisation et certificat. Si un port requis n'existe pas sur la nouvelle VM, le créer avec les paramètres validés.

6. Déployer l'application ServeurSGO

Récupérer sur le Cloud Systel la version de ServeurSGO correspondant à la version de Start utilisée.

Emplacement des versions de référence :

\\cloud\Qualité\Alerte\Version de référence SGO_11x\Version WebCIS\ServeurSGO\ServeurSGO_485.11x.xxxx-x.war

Autre emplacement possible :

\\cloud\Qualité\Production_Version\Publiée\SGO_4.85.117\Archives

Dans le portail GlassFish, ouvrir les paramètres Applications, puis cliquer sur Déployer. Charger le fichier .war, sélectionner le serveur et saisir ServeurSGO comme racine du contexte. Valider avec OK.

Vérifier le déploiement depuis un navigateur en utilisant l'URL correspondant à la plateforme :

http://INTERSGO1:18080/ServeurSGO/
http://INTERSGO1:18080/ServeurSGO/fr/

7. Mettre à jour les paramètres en base de données

Depuis un outil de requête SQL, par exemple SQL Server Management Studio sur un serveur BD ou TELEMW, consulter la table SGO_DESCRIPTION :

SELECT * FROM SGO_DESCRIPTION;

Mettre à jour les adresses IP du serveur INTERSGO ou du réseau associé selon les valeurs propres au client. Les modifications exactes doivent être déterminées à partir des paramètres existants et du DCSR.

Exemple de mise à jour des deux adresses IP :

UPDATE SGO_DESCRIPTION SET ADRESSE_IP3 = '10.182.9.41' WHERE ID = '3';
UPDATE SGO_DESCRIPTION SET ADRESSE_IP2 = '10.182.9.41' WHERE ID = '4';

Ajouter les requêtes nécessaires dans le fichier suivant sur BD1 afin que les nouveaux paramètres soient appliqués lors de la bascule :

D:\Requetes\1- MiseAJourDesParametresEnBaseSTART.sql

8. Gérer les comptes système

Modifier les mots de passe des comptes systel et root avec les commandes suivantes :

passwd systel
passwd root

Générer des mots de passe robustes et les enregistrer dans RDM.

9. Dépannage : activer les journaux GlassFish

En cas de problème de fonctionnement, activer les journaux GlassFish depuis le portail d'administration et consulter les événements correspondant à l'incident. Les options exactes d'activation ne figurant que dans les captures d'origine, les confirmer selon la version installée ou auprès de l'équipe responsable.