Revision as of 12:03, 22 July 2021

Abaixo descrevo os procedimentos para instalar o My File Gateway 2.0 no IBM Sterling B2BI 6.1.0.

A documentação oficial está no link Accessing myFileGateway 2.0, mas falta bastante informação.

No meu ambiente precisava alta disponibilidade, e segurança. Então para fazer funcionar o ambiente sugiro as seguintes recomendações:

Configurar o node 1 usando apenas o protocolo http
Configurar o node 2 usando apenas o protocolo http
Alterar para o protocolo https, ajustando as variáveis e portas
Configurar o funcionamento através do balanceador

Instalação do MyFile Gateway 2.0

Primeiro você deve instalar o Sterling File Gateway durante a instalação do IBM Sterling B2B Integrator.

IBM Sterling B2B: Instalação usando Installation Manager - Node 1

Durante a instalação defini o meu base_port=5000

Anote os dados do passo 22). Informe as informações do MyFG 2.0

Use HTTPs Protocol: Desmarcar
Gateway Service hostname or IP Address: <ip_do_node1_do_sfg>
Gateway Service Port: <base_port + 78>
ASI Service hostname or IP Address: <ip_do_node1_do_sfg>
ASI Service Port: <base_port>
Rest Http Service hostname or IP Address: Deixar vazio
Rest Http Service Port: <base_port + 60>

Importante:

Caso não tenha anotado, tome nota das variáveis no arquivo sandbox.cfg e server.xml.

Variáveis na sandbox.cfg

Localização: /home/siuser/SI/properties/sandbox.cfg.

Variável	Valor	Meus Valores	Descrição
API_GATEWAY_IP	<hostname_do_sfg> ou <balanceador>	-	Example
API_GATEWAY_PORT	<porta do libery>	5078(LIBERTY_PORT) ou 5079(LIBERTY_HTTPS_PORT)	Porta do Liberty profile. Você pode verificar verificando a variável LIBERTY_PORT no arquivo sandbox.cfg ou verificar no server.xml
ASI_SERVICE_HOST	<hostname_do_sfg> ou <balanceador>	-	Example
ASI_SERVICE_PORT	<base_port>	5000(http) ou 5001(https	Example
REST_HTTP_SERVER_ADAPTER_SERVICE_HOST	<hostname_do_sfg> ou <balanceador>	-	Example
REST_HTTP_SERVER_ADAPTER_SERVICE_PORT	<base_port + 60>	5060 (REST_HTTP_SERVER_PORT)	Example
MYFG_PROTOCOL	http	http	use http ou https
LIBERTY_PORT	<base_port + 78>	5078	porta https do liberty
LIBERTY_HTTPS_PORT	<base_port + 79>	5079	porta http do liberty

Variáveis na server.xml

Localização: /home/siuser/SI/liberty/wlp/usr/servers/SIServer/server.xml.

Variável	Valor	Meus Valores	Descrição
httpPort	<porta http do liberty>	5078(http)	porta http do liberty, igual ao LIBERTY_PORT do sandbox.cfg
httpsPort	<porta https do liberty>	5079(https)	porta https do liberty, igual ao LIBERTY_PORT do sandbox.cfg

Instalação do b2biAPIs.jar

Precisamos instalar o b2biAPI.jar. Este arquivo fica no diretório dos pacotes de instalação do B2Bi, extraído do arquivo STR_B2BI_V6.1.0_FOR_MP_ML.zip. Confirme a existência deste arquivo.

/home/siuser/installers/si/packages/b2biAPIs_60010000.jar

Instalando o b2biAPIs.jar

cd /home/siuser/IBM/SI/bin

./InstallService.sh /home/siuser/installers/si/packages/b2biAPIs_60010000.jar

Faça a instalação em cada node do SFG.

Configurando a opção de API User

Após instalar o b2biAPIs_60010000.jar, vai aparecer uma nova permissão APIUser.

Você deve abrir o dashboard do SB2Bi, ir em Operations -> Accounts. E definir esta opção para o usuário.

Deploy

Após a instalação execute os comandos:

cd /home/siuser/IBM/SI/bin

./hardstop.sh

./deployer.sh

./run.sh

Acessar usando a url

'''http://localhost:<base_port>/myfg'''

Ajustes

Caso você faça ajustes no sandbox.cfg e server.xml. Execute os comandos:

cd /home/siuser/IBM/SI/bin

./hardstop.sh

./deployer.sh

./run.sh

Dicas:

Você deve logar com um usuário que tenha acesso ao My Filegateway
Ao executar o comando deployer.sh, ele realiza updates no arquivo app-prod-env-config.js. verifique se as variáveis neste arquivo foram alteradas.
Para verificar as informações do liberty, verifique o arquivo server.xml, o mesmo fica no diretório

/home/siuser/SI/liberty/wlp/usr/servers/SIServer/server.xml

Ver também

Artigos sobre IBM Sterling

@@ Line 24: / Line 24: @@
 * Use HTTPs Protocol: '''Desmarcar'''
 * Gateway Service hostname or IP Address: '''<ip_do_node1_do_sfg>'''
-* Gateway Service Port: '''<base_port + 74>'''
+* Gateway Service Port: '''<base_port + 78>'''
 * ASI Service hostname or IP Address: '''<ip_do_node1_do_sfg>'''
 * ASI Service Port: '''<base_port>'''
@@ Line 45: / Line 45: @@
 | API_GATEWAY_IP || <hostname_do_sfg> ou <balanceador> || - || Example
 |-
-| API_GATEWAY_PORT || <porta do libery> || 5074(http) ou 5075(https)  ||
+| API_GATEWAY_PORT || <porta do libery> || 5078(LIBERTY_PORT) ou 5079(LIBERTY_HTTPS_PORT)  ||
 Porta do Liberty profile. Você pode verificar verificando a variável LIBERTY_PORT no arquivo sandbox.cfg ou verificar no server.xml
 |-
@@ Line 54: / Line 54: @@
 | REST_HTTP_SERVER_ADAPTER_SERVICE_HOST || <hostname_do_sfg> ou <balanceador> || - || Example
 |-
-| REST_HTTP_SERVER_ADAPTER_SERVICE_PORT || <base_port + 60>  || 5060 || Example
+| REST_HTTP_SERVER_ADAPTER_SERVICE_PORT || <base_port + 60>  || 5060 (REST_HTTP_SERVER_PORT) || Example
 |-
 | MYFG_PROTOCOL || http || http || use http ou https
 |-
-| LIBERTY_PORT || <base_port + 74> || 5074 || porta https do liberty
+| LIBERTY_PORT || <base_port + 78> || 5078 || porta https do liberty
 |-
-| LIBERTY_HTTPS_PORT || <base_port + 75>  || 5075 || porta http do liberty
+| LIBERTY_HTTPS_PORT || <base_port + 79>  || 5079 || porta http do liberty
 |}
@@ Line 71: / Line 71: @@
 ! Variável !! Valor !! Meus Valores !! Descrição
 |-
-| httpPort || <porta http do liberty>  || 5074(http) || porta http do liberty, igual ao LIBERTY_PORT do sandbox.cfg
+| httpPort || <porta http do liberty>  || 5078(http) || porta http do liberty, igual ao LIBERTY_PORT do sandbox.cfg
 |-
-| httpsPort || <porta https do liberty> || 5075(https)|| porta https do liberty, igual ao LIBERTY_PORT do sandbox.cfg
+| httpsPort || <porta https do liberty> || 5079(https)|| porta https do liberty, igual ao LIBERTY_PORT do sandbox.cfg
 |}