Ir para o conteúdo

Duplicação de instância

Informação

Esta documentação descreve como duplicar uma primeira instância de Edge Gateway Windows.
Pode ser seguida para novas instâncias, substituindo o sufixo -2 por -3 ou por qualquer outro valor não utilizado.

Pré-requisitos

Para realizar as operações seguintes, são necessários direitos de administrador na máquina.

A duplicação de instâncias permite que cada instância se ligue a uma plataforma CyberElements diferente.
No mesmo servidor Windows é, por conseguinte, possível ligar-se a vários tenants cyberelements.

A primeira etapa consiste em duplicar o diretório <INSTALLDIR>\IPdiva\IPdivaGateway\.

Exemplo

Com uma instalação no diretório predefinido, será necessário copiar o diretório IPdivaGateway para IPdivaGateway-2:

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

É necessário depois renomear o executável IPdivaGateway.exe com o mesmo sufixo utilizado na cópia do diretório anterior.

Exemplo

O executável IPdivaGateway.exe passa a 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

Modifique o ficheiro <INSTALLDIR>\IPdiva\IPdivaGateway<SUFFIX>\conf\gateway.xml (alterações nas linhas 17 e 19 e adição na linha 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>

Substitua:

  • <SUFFIX> pelo sufixo utilizado ao copiar o diretório IPdivaGateway
  • <RPC_PORT> por um número de porta TCP disponível na máquina; é habitual que a primeira instância de Edge Gateway utilize a porta 9080 e que esta seja incrementada nas instâncias seguintes

Exemplo

Continuando com o exemplo em que o sufixo escolhido é -2 e se trata da segunda instância de Edge Gateway, com a porta TCP 9081 selecionada, o ficheiro C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\gateway.xml seria modificado da seguinte forma:

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>
Ficheiro completo 
 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>

Modifique depois o ficheiro <INSTALLDIR>\IPdiva\IPdivaGateway-2\conf\gwmonitor.xml (alteração da linha 3 e adição da linha 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>

Substitua:

  • <RPC_PORT> pela porta TCP selecionada previamente
  • <SUFFIX> pelo sufixo utilizado ao copiar o diretório IPdivaGateway

Exemplo

Com a porta RPC 9081 e o sufixo -2, o ficheiro C:\Program Files (x86)\Systancia\IPdiva\IPdivaGateway-2\conf\gwmonitor.xml seria modificado da seguinte forma:

 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>

A partir de uma linha de comandos cmd como administrador, vamos criar um serviço Windows para iniciar automaticamente a nova instância de Edge Gateway Windows:

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

Substitua:

  • <INSTALLDIR> pelo diretório no qual o Edge Gateway Windows foi instalado
  • <SUFFIX> pelo sufixo utilizado ao copiar o diretório IPdivaGateway

Exemplo

Com uma instalação no diretório predefinido e o sufixo -2, o comando de criação do serviço é o seguinte:

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

Por último, resta apenas configurar manualmente a nova instância para que possa ligar-se: Configurar manualmente a instância de Edge Gateway