Última revisão: 30/09/2025
Slack: Carlos.pires@ibm.com
IBM Sterling B2B Integrator — Guia Completo de Instalação (GUI e Silent)
Este documento tem foco total na instalação do IBM Sterling B2B Integrator (B2Bi) em Linux x86_64, abrangendo planejamento, pré‑requisitos, preparo do SO, instalação com IBM Installation Manager (GUI e modo silencioso) e uma verificação mínima do resultado. Após detalhar a instalação, são adicionadas seções de pós‑instalação, tuning, validação, automação, operação, checklist, troubleshooting, anexos e referências.
Sumário
1) Escopo e versões suportadas
2) Planejamento de instalação (decisões mínimas)
3) Pré‑requisitos de sistema operacional (Linux)
4) Pré‑requisitos de banco de dados (DB2/Oracle/SQL Server)
5) Mídia necessária e preparação dos arquivos
6) Instalação do IBM Installation Manager (IIM)
7) Instalação do B2Bi (GUI) — passo a passo detalhado
7.1) Instalação silenciosa (response file) — alternativa
7.2) Verificações mínimas pós‑instalador (smoke test)
8) Pós‑instalação essencial
9) Tuning e boas práticas (macetes)
10) Validação e smoke tests (detalhado)
11) Automação (silent install com response file)
12) Operação: start/stop, logs e serviço systemd
13) Checklist rápido de instalação
14) Troubleshooting — erros comuns e correções
15) Anexos — comandos úteis e templates
16) Referências oficiais
1) Escopo e versões suportadas
Guia orientado às linhas 6.1.x/6.2.x do B2Bi. Sempre valide na sua subversão os requisitos de JDK, SO e Fix Packs. Caso utilize 6.1.2.1, um JDK 8 update compatível é requerido. Ajuste este guia conforme o release específico.
2) Planejamento de instalação (decisões mínimas)
· Local de instalação (ex.: /home/siuser/IBM/SI) e local da mídia (/home/siuser/installers).
· Banco de dados: DB2, Oracle ou SQL Server provisionado, usuário/schema exclusivo, e reachability de rede.
· Portas: porta base (ex.: 5000) + ~200 portas consecutivas livres (5000–5199, por exemplo).
· Recursos: CPU ≥ 8 vCPUs, RAM ≥ 16 GB (exemplo prático), armazenamento rápido (binários, logs e dados separados).
· SMTP (opcional durante a instalação): host/porta/credenciais.
Dica: Defina nomes e caminhos sem espaços para simplificar o uso do `imcl` e de scripts.
3) Pré‑requisitos de sistema operacional (Linux)
Execute como root: criar usuário de serviço, diretórios e limites de sistema.
# criar usuário e diretórios
useradd siuser
passwd siuser
mkdir -p /home/siuser/installers/{logs,si,jdk}
chown -R siuser:siuser /home/siuser/installers
# limites recomendados (edite /etc/security/limits.conf)
echo 'siuser soft nofile 4096' >> /etc/security/limits.conf
echo 'siuser hard nofile 8196' >> /etc/security/limits.conf
echo 'siuser soft memlock 3000000' >> /etc/security/limits.conf
echo 'siuser hard memlock 3000000' >> /etc/security/limits.conf
echo 'siuser soft nproc 16000' >> /etc/security/limits.conf
echo 'siuser hard nproc 16000' >> /etc/security/limits.conf
echo 'siuser soft stack 512000' >> /etc/security/limits.conf
echo 'siuser hard stack 512000' >> /etc/security/limits.conf
# pacotes úteis
yum install -y unzip tar which
# ou
apt-get update && apt-get install -y unzip tar procps
· Timezone/NTP configurados; DNS com forward/reverse resolvendo o hostname.
· SELinux/Firewall: permitir porta base + range. Em ambientes restritivos, crie regras explícitas.
# Exemplo firewalld
firewall-cmd --permanent --add-port=5000-5199/tcp
firewall-cmd --reload
ATENÇÃO: Evite senhas com '&' em telas e arquivos de propriedades do instalador.
4) Pré‑requisitos de banco de dados (DB2/Oracle/SQL Server)
Tenha schema e usuário dedicados. Coloque o driver JDBC em local acessível (ex.: /home/siuser/installers).
Exemplos de URLs JDBC (ajuste host/porta/DB/schema):
# DB2
jdbc:db2://db2-host:50000/B2BDB:sslConnection=false;
Driver: com.ibm.db2.jcc.DB2Driver (db2jcc4.jar)
# Oracle (SID)
jdbc:oracle:thin:@//ora-host:1521/ORCL
# Oracle (Service Name)
jdbc:oracle:thin:@//ora-host:1521/ORCLPDB1
# SQL Server
jdbc:sqlserver://mssql-host:1433;databaseName=B2BDB;encrypt=false;
Dica: Valide conectividade: do host do B2Bi, use `telnet <db-host> <porta>` ou `nc -vz`.
5) Mídia necessária e preparação dos arquivos
· B2Bi: STR_B2BI_V6.x.y_FOR_MP_ML.zip
· JDK suportado para a sua subversão (ex.: IBM JDK 8.0.7.x).
· Driver JDBC (ex.: db2jcc4.jar).
· Políticas JCE compatíveis com o JDK, se aplicável.
cd /home/siuser/installers
unzip STR_B2BI_V6.1.0_FOR_MP_ML.zip -d si
unzip si/Common_Repo.zip -d si
unzip si/InstallationManager/IM_Linux.zip
unzip SB2BISFG6.1.0_JAVA_SDK_JRE_MP_ML.zip -d jdk
cd jdk
tar -xzvf ibm-java-sdk-8.0-6.NNNNNNNN-linux-x86_64.tgz
Dica: Confirme o caminho do repository.xml/repository.config.
6) Instalação do IBM Installation Manager (IIM)
GUI: execute o IBMIM e siga os prompts. Console (imcl):
cd /home/siuser/installers/IM_Linux
./tools/imcl install com.ibm.cic.agent -acceptLicense -installationDirectory /home/siuser/IBM/InstallationManager -repositories /home/siuser/installers/IM_Linux/repository.xml -log /home/siuser/installers/logs/iim.log
# ver versão e pacotes
./tools/imcl -version
./tools/imcl listAvailablePackages -repositories /home/siuser/installers/si/repository.config
7) Instalação do B2Bi (GUI) — passo a passo detalhado
· Abra o IIM: /home/siuser/IBM/InstallationManager/eclipse/IBMIM
· File → Preferences → Repositories → adicione o repositório da mídia do B2Bi.
· Clique em Install → selecione 'IBM Sterling B2B Integrator' (+ 'Sterling File Gateway' se necessário).
· Aceite licenças.
· Selecione diretório compartilhado/default conforme padrão sugerido.
· Selecione o diretório de instalação (ex.: /home/siuser/IBM/SI).
· Aponte o JDK suportado (pasta extraída).
· Informe IP (ou 0.0.0.0) e Porta base (ex.: 5000). Lembre do range ~200 portas.
· Defina a passphrase do sistema.
· SMTP (opcional): informar servidor/porta/credenciais.
· Banco de dados: selecione o tipo, informe URL/usuário/senha e clique em Test.
· Revise o resumo e clique em Install. Aguarde concluir.
ATENÇÃO: Se não selecionar o SFG aqui, a instalação posterior é via InstallService.
7.1) Instalação silenciosa (response file) — alternativa
Exemplo mínimo de response.xml (ajuste offering IDs/versões/caminhos):
<?xml version='1.0' encoding='UTF-8'?>
<agent-input>
<server>
<repository location='/home/siuser/installers/si/repository.config'/>
</server>
<profile id='IBM B2Bi' installLocation='/home/siuser/IBM/SI'/>
<install>
<offering id='com.ibm.b2bi.si' version='6.1.0' profile='IBM B2Bi'/>
<!-- opcional -->
<!-- <offering id='com.ibm.b2bi.sfg' version='6.1.0' profile='IBM B2Bi'/> -->
</install>
</agent-input>
/home/siuser/IBM/InstallationManager/eclipse/tools/imcl input response.xml -acceptLicense -log /home/siuser/installers/logs/b2bi_silent.log
Dica: Use `listAvailablePackages` para descobrir offering IDs/versões corretas do seu repo.
7.2) Verificações mínimas pós‑instalador (smoke test)
· Acesse a UI do B2Bi como admin.
· Administration → Business Process → Manager → pesquise 'Validation_Sample_BPML'.
· Execute e confirme status 'Success'.
8) Pós‑instalação essencial
· Aplicar Fix Packs e IFs compatíveis com sua versão.
· Configurar certificados SSL/TLS e stores.
· Criar usuários, roles e políticas de senha iniciais.
· Separar diretórios de logs e configurar rotação.
· Backup inicial do diretório de instalação e export de configurações básicas.
9) Tuning e boas práticas (macetes)
· Escolha porta base com 200 portas livres.
· Evite '&' em senhas/propriedades do instalador.
· Ajuste JVM (Xms/Xmx) conforme memória do host; monitore GC nos primeiros dias.
· DNS reverso/hostname coerentes evitam erros intermitentes em integrações.
· Para bancos remotos, avalie pool de conexões e keepalive.
10) Validação e smoke tests (detalhado)
· Validar autenticação na UI e permissões de menu.
· Executar BP de validação e checar steps.
· Verificar logs de inicialização (erros/exceptions).
11) Automação (silent install com response file)
· Diferencie response files por ambiente (DEV/QA/PRD).
· Parametrize caminhos e offering IDs em templates.
· Versione os response files em repositório Git interno.
# exemplos úteis
/home/siuser/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages
/home/siuser/IBM/InstallationManager/eclipse/tools/imcl listAvailablePackages -repositories /home/siuser/installers/si/repository.config
12) Operação: start/stop, logs e serviço systemd
cd /home/siuser/IBM/SI/bin
./run.sh # start
./stop.sh # stop (quando aplicável)
Exemplo de service systemd:
# /etc/systemd/system/b2bi.service
[Unit]
Description=IBM Sterling B2B Integrator
After=network.target
[Service]
Type=forking
User=siuser
WorkingDirectory=/home/siuser/IBM/SI/bin
ExecStart=/home/siuser/IBM/SI/bin/run.sh
ExecStop=/home/siuser/IBM/SI/bin/stop.sh
Restart=on-failure
[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable b2bi
systemctl start b2bi
13) Checklist rápido de instalação
· Usuário de serviço criado + ulimits aplicados
· Mídia descompactada + repositório do IIM acessível
· IIM instalado (GUI ou imcl)
· Offering IDs confirmados no repo
· B2Bi (e SFG, se preciso) selecionados
· JDK suportado configurado
· DB conectado (Test OK)
· Porta base + range livre
· Smoke test (Validation_Sample_BPML) OK
· Backup inicial executado
14) Troubleshooting — erros comuns e correções
· Error: key '&ORA_PASS;' has unset value → remova '&' da senha ou escape conforme recomendação.
· imcl não encontra repos → use caminhos absolutos e confirme repository.config.
· Porta em uso → altere porta base ou libere a faixa.
· Falha JDBC → confirme driver, classe e URL; teste reachability de rede.
· Permissões/ulimit insuficiente → refaça logoff/logon de 'siuser' e valide `ulimit -a`.
15) Anexos — comandos úteis e templates
# Descobrir offerings e versões
/home/siuser/IBM/InstallationManager/eclipse/tools/imcl listAvailablePackages -repositories /home/siuser/installers/si/repository.config
# Instalação silenciosa
/home/siuser/IBM/InstallationManager/eclipse/tools/imcl input response.xml -acceptLicense -log /home/siuser/installers/logs/b2bi_silent.log
# Atualizar IIM
/home/siuser/installers/IM_Linux/tools/imcl install com.ibm.cic.agent -acceptLicense -installationDirectory /home/siuser/IBM/InstallationManager -repositories /home/siuser/installers/IM_Linux/repository.xml
16) Referências oficiais
• IBM Docs — Installing Sterling B2B Integrator with IBM Installation Manager (GUI/response file)
• IBM Docs — Installation Manager (imcl) commands
• IBM Docs — Sterling File Gateway install options
• Release notes e requisitos de sistema da sua versão
.png)
.png)
.png)
0 Comentários