Aller au contenu

Dupplication d'instances

Information

Cette documentation prévoit la dupplication d'une première instance de Edge Gateway Windows.
Elle peut être suivie pour de nouvelles instances en remplaçant le suffixe -2 par -3 ou toutes autres valeurs non utilisées.

Prérequis

Pour réaliser les opérations suivantes, les droits administrateurs de la machine sont requis.

La dupplication d'instance permet pour chacune des instances de pouvoir se connecter à un autre Mediation Controller.
Sur un même serveur Windows il est donc possible de se connecter à plusieurs tenant cyberelements.io et/ou plusieurs plateformes cyberelements Cleanroom.

La première étape consiste à duppliquer le répertoire <INSTALLDIR>\IPdiva\IPdivaGateway\.

Exemple

Avec une installation dans le répertoire par défaut, il sera nécessaire de copier le répertoire IPdivaGateway pour IPdivaGateway-2 :

C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway\
C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\

Puis il est nécessaire de rennomer l'exécutable IPdivaGateway.exe avec le même suffixe que celui utilisé pour la copie du répertoire ci-dessus.

Exemple

L'exécutable IPdivaGateway.exe devient IPdivaGateway-2.exe :

C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\bin\IPdivaGateway.exe
C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\bin\IPdivaGateway-2.exe

Modifiez le fichier <INSTALLDIR>\IPdiva\IPdivaGateway<SUFFIX>\conf\gateway.xml (modifications lignes 17 et 19 et ajout en ligne 22) :

16
17
18
19
20
21
22
23
<ssl>
    <cert>C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway<SUFFIX>\conf\ssl\my-edge-gateway-windows.p12</cert>
    <password>MyP@ss0rd</password>
    <ca-dir>C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway<SUFFIX>\conf</ca-dir>
    <cipherlist>!ADH:!AECDH:!MD5:kEECDH+AES:kEDH+AES:AES256+RSA:3DES+RSA</cipherlist>
</ssl>
<rpclisten>127.0.0.1:<RPC_PORT></rpclisten>
<proxy>

Remplacez :

  • <SUFFIX> par le suffixe utilisé lors de la copie du répertoire IPdivaGateway
  • <RPC_PORT> par un numéro de port TCP disponible sur la machine, il est commun pour la première instance de Edge Gateway d'utiliser le port 9080 et de l'incrémenter pour les suivantes

Exemple

En poursuivant l'exemple où le suffixe choisi est -2 et qu'il s'agit de la seconde instance de Edge Gateway, le port TCP retenu est donc 9081, le fichier C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\gateway.xml serait modifié de cette manière : 

16
17
18
19
20
21
22
23
<ssl>
    <cert>C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\ssl\my-edge-gateway-windows.p12</cert>
    <password>MyP@ss0rd</password>
    <ca-dir>C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf</ca-dir>
    <cipherlist>!ADH:!AECDH:!MD5:kEECDH+AES:kEDH+AES:AES256+RSA:3DES+RSA</cipherlist>
</ssl>
<rpclisten>127.0.0.1:9081</rpclisten>
<proxy>
Fichier complet 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<gateway>
    <server>my-tenant.cyberelements.io:443:ssl</server>
    <ticket>
        <hmac/>
    </ticket>
    <pipe>
        <ping-timeout>60000</ping-timeout>
        <push-timeout>20000</push-timeout>
        <pop-timeout>20000</pop-timeout>
        <fifo-sent-len>200000</fifo-sent-len>
        <rout-max-lock>20000</rout-max-lock>
    </pipe>
    <timeout>
        <reconnect>15000</reconnect>
    </timeout>
    <ssl>
        <cert>C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\ssl\my-edge-gateway-windows.p12</cert>
        <password>MyP@ss0rd</password>
        <ca-dir>C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf</ca-dir>
        <cipherlist>!ADH:!AECDH:!MD5:kEECDH+AES:kEDH+AES:AES256+RSA:3DES+RSA</cipherlist>
    </ssl>
    <rpclisten>127.0.0.1:9081</rpclisten>
    <proxy>
        <type/>
        <address/>
        <login/>
        <password/>
        <domain/>
    </proxy>
    <webaccess>
        <useragent>true</useragent>
        <autoauth>true</autoauth>
        <forceauth>false</forceauth>
    </webaccess>
</gateway>

Modifiez ensuite le fichier <INSTALLDIR>\IPdiva\IPdivaGateway-2\conf\gwmonitor.xml (modification ligne 3 et ajout ligne 9) :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<gwmonitor>
 <upgrade-server>http://127.0.0.1:6060/IPdivaGateway.exe</upgrade-server>
 <gwxmlrpc>127.0.0.1:<RPC_PORT></gwxmlrpc>
 <mode>udp</mode>
 <restart>true</restart>
 <upgrade>true</upgrade>
 <restart-range>4:0-5:0</restart-range>
 <upgrade-range>1:0-2:0</upgrade-range>
 <suffix><SUFFIX></suffix>
</gwmonitor>

Remplacez :

  • <RPC_PORT> par le port TCP choisi précédemment
  • <SUFFIX> par le suffixe utilisé lors de la copie du répertoire IPdivaGateway

Exemple

Avec le port RPC 9081 et le suffixe -2 le fichier C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\gwmonitor.xml serait modifié de la manière suivante :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<gwmonitor>
 <upgrade-server>http://127.0.0.1:6060/IPdivaGateway.exe</upgrade-server>
 <gwxmlrpc>127.0.0.1:9081</gwxmlrpc>
 <mode>udp</mode>
 <restart>true</restart>
 <upgrade>true</upgrade>
 <restart-range>4:0-5:0</restart-range>
 <upgrade-range>1:0-2:0</upgrade-range>
 <suffix>-2</suffix>
</gwmonitor>

Avec un invite de commandes cmd en tant qu'administrateur, nous allons créer un service Windows pour démarrer automatiquement la nouvelle instance de Edge Gateway Windows :

1
sc create "IPdiva Gateway<SUFFIX>" binPath= "\"<INSTALLDIR>\IPdiva\IPdivaGateway<SUFFIX>\IPdivaGateway<SUFFIX>.exe\"" type= own start= auto

Remplacez :

  • <INSTALLDIR> par le répertoire dans lequel la Edge Gateway Windows a été installée
  • <SUFFIX> par le suffixe utilisé lors de la copie du répertoire IPdivaGateway

Exemple

Avec une installation dans le répertoire par défaut et le suffixe -2, la commande de création du service est la suivante : 

1
sc create "IPdiva Gateway-2" binPath= "\"C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\IPdivaGateway-2.exe\"" type= own start= auto

Finalement il ne reste plus qu'à configurer manuellement la nouvelle instance pour qu'elle puisse se connecter : Configurer manuellement l'instance de Edge Gateway