Ga naar inhoud

Duplicatie van een instantie

Informatie

Deze documentatie beschrijft hoe een eerste instantie van de Edge Gateway Windows wordt gedupliceerd.
Zij kan voor nieuwe instanties worden gevolgd door het suffix -2 te vervangen door -3 of door andere niet-gebruikte waarden.

Voorwaarden

Voor de volgende bewerkingen zijn beheerdersrechten op de machine vereist.

De duplicatie van instanties maakt het mogelijk dat elke instantie verbinding maakt met een ander CyberElements-platform.
Op dezelfde Windows-server is het dus mogelijk verbinding te maken met meerdere CyberElements-tenants.

De eerste stap bestaat erin de map <INSTALLDIR>\IPdiva\IPdivaGateway\ te dupliceren.

Voorbeeld

Bij een installatie in de standaardmap moet de map IPdivaGateway worden gekopieerd naar IPdivaGateway-2:

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

Vervolgens moet het uitvoerbare bestand IPdivaGateway.exe worden hernoemd met hetzelfde suffix als het suffix dat hierboven voor de kopie van de map is gebruikt.

Voorbeeld

Het uitvoerbare bestand IPdivaGateway.exe wordt 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

Wijzig het bestand <INSTALLDIR>\IPdiva\IPdivaGateway<SUFFIX>\conf\gateway.xml (wijziging van de regels 17 en 19 en toevoeging op regel 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>

Vervang:

  • <SUFFIX> door het suffix dat bij het kopiëren van de map IPdivaGateway is gebruikt
  • <RPC_PORT> door een op de machine beschikbaar TCP-poortnummer; gebruikelijk is dat de eerste instantie van de Edge Gateway poort 9080 gebruikt en dat deze voor de volgende instanties wordt verhoogd

Voorbeeld

Om bij het voorbeeld te blijven waarin het gekozen suffix -2 is en het om de tweede instantie van de Edge Gateway gaat, met de gekozen TCP-poort 9081, zou het bestand C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\gateway.xml als volgt worden gewijzigd:

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>
Volledig bestand
 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>

Wijzig daarna het bestand <INSTALLDIR>\IPdiva\IPdivaGateway-2\conf\gwmonitor.xml (wijziging van regel 3 en toevoeging op regel 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>

Vervang:

  • <RPC_PORT> door de eerder gekozen TCP-poort
  • <SUFFIX> door het suffix dat bij het kopiëren van de map IPdivaGateway is gebruikt

Voorbeeld

Met de RPC-poort 9081 en het suffix -2 zou het bestand C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\gwmonitor.xml als volgt worden gewijzigd:

 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>

Via een opdrachtprompt cmd als beheerder maakt u een Windows-service aan om de nieuwe instantie van de Edge Gateway Windows automatisch te starten:

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

Vervang:

  • <INSTALLDIR> door de map waarin de Edge Gateway Windows is geïnstalleerd
  • <SUFFIX> door het suffix dat bij het kopiëren van de map IPdivaGateway is gebruikt

Voorbeeld

Bij een installatie in de standaardmap en het suffix -2 is de opdracht om de service aan te maken als volgt:

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

Tot slot hoeft de nieuwe instantie alleen nog handmatig te worden geconfigureerd zodat zij verbinding kan maken: De Edge Gateway-instantie handmatig configureren