Skip to Content

SDK do SAP

As integrações SAP do CMS — RFC/BAPI e IDoc — dependem do SAP NetWeaver RFC SDK, uma biblioteca nativa distribuída pela SAP.

Ela não acompanha o CMS: é licenciada pela SAP e entregue por contrato, então cada instalação usa a SDK baixada pelo próprio cliente, com o usuário S da sua empresa. A instalação é feita por um administrador, na aba SDK SAP em Configurações › Parâmetros, sem acesso ao servidor e sem reconstruir nada.

Enquanto a SDK não está instalada

  • O CMS funciona normalmente — a dependência é só das integrações SAP.
  • Em Conexões Externas, os tipos SAP RFC e SAP IDoc aparecem na lista desabilitados, com o motivo e um atalho para a tela de instalação.
  • Conexões SAP que já existiam continuam visíveis e editáveis, com aviso. Elas não são escondidas: numa instalação restaurada em outro servidor, integrações sumirem da tela seria pior que vê-las sinalizadas.

Instalando

Baixar a SDK no SAP Support Portal

Software Downloads → SAP NW RFC SDK 7.50 → variante Linux on x86_64. O arquivo vem em .zip (a partir da versão 7.50 não é mais .SAR, então não é preciso o SAPCAR).

O pacote do Windows tem nome quase idêntico ao de Linux — muda um dígito no fim (nwrfc750P_19-70002752.zip é Linux; ...-70002755.zip é Windows). Os conectores do CMS rodam em containers Linux; se o pacote errado for enviado, o CMS identifica e diz exatamente isso.

Enviar pela tela

Configurações › Parâmetros › aba SDK SAP → Escolher arquivo → Enviar e instalar. Envie o .zip como foi baixado, sem descompactar.

Aguardar os conectores reiniciarem

O CMS valida o pacote, grava os arquivos e reinicia os dois conectores SAP — biblioteca nativa só é carregada no início do processo. Em alguns segundos a aba mostra SDK instalada com a versão lida do próprio binário (ex.: 7.50 PL18) e os dois conectores marcados como carregados.

O que a validação recusa

SituaçãoO que o CMS responde
Pacote do Windows (contém sapnwrfc.dll)Identifica o pacote e pede a variante Linux on x86_64
Variante de AIX, IBM i ou HP-UXAvisa que o binário não é uma biblioteca Linux (ELF)
SDK de outra arquitetura (ARM64, PowerPC…)Diz para qual arquitetura o pacote é e qual era a esperada
Zip sem lib/libsapnwrfc.so ou sem os headersAvisa que não é um SAP NW RFC SDK completo
Zip com caminho de arquivo inseguroRecusa o pacote inteiro

Nada é apagado antes de o pacote novo estar íntegro em disco: se a validação falhar, a instalação anterior continua no lugar.

Onde a SDK fica

Uma pasta só, montada nos containers em /usr/local/sap/nwrfcsdk — é o caminho que o node-rfc procura. No servidor, a pasta é definida por SAP_SDK_PATH (padrão ./data/nwrfcsdk). O cms-api monta com escrita, porque é quem recebe o upload; os dois conectores montam somente leitura.

Atualizar e remover

Enviar um pacote novo substitui o anterior — é assim que se aplica um patch level mais recente. Remover apaga a biblioteca do servidor: os conectores voltam ao modo simulado e as conexões SAP ficam indisponíveis até um novo envio. As duas ações ficam registradas no log de auditoria, com usuário, data e o arquivo enviado.

Export de configuração

O export registra no manifesto apenas metadados — se aquela instalação tinha a SDK e em que versão. O binário nunca entra num arquivo exportado: são dezenas de MB de material licenciado pela SAP, que não podem viajar de uma instalação para outra.

Ao importar num servidor sem a SDK, a configuração entra normalmente e o resultado traz um aviso lembrando que as conexões SAP só funcionarão depois da instalação.