在集成服务器上安装用户定义扩展运行时文件

在要测试其功能的集成服务器上安装用户定义扩展的已编译运行时文件。如果用户定义节点使用定制编译器，请将用户定义节点插件安装到要部署节点的集成服务器上。

准备工作

使用编译 Java 用户定义节点或编译 C 用户定义扩展中描述的过程来创建和编译用户定义扩展。
- 为使用 C 创建的扩展创建的文件依赖于操作系统：
  动态链接库 (DLL) ，以文件类型 .lil命名。
  
  共享对象，同样具有文件类型 .lil。
- 对于 Java 节点，这是文件类型为 .jar (在所有操作系统上) 的 Java 归档文件 (JAR)。
如果您已创建了一个用户定义节点，还必须完成《 IBM App Connect Enterprise 工具包》中“创建用户定义节点的用户界面表示 ”一节所述的任务。
如果用户定义节点包含定制编译器，那么必须打包用户定义节点项目; 请参阅打包和分发用户定义节点项目。

关于此任务

此任务指示您停止并重新启动集成服务器。此操作在所有情况下都是必需的，但如果您停止并重新启动集成服务器，那么应确保关注特定集成服务器的任何人知道最近进行了更改。

此任务仅适用于以 Java 或 C 编写的用户定义节点。如果用户定义节点包含定制编译器，那么必须将已编译的运行时文件和用户定义节点插件安装到集成服务器。如果用户定义节点未包含定制编译器，请仅将经过编译的运行时文件安装到集成服务器。

要在集成服务器上安装运行时文件和用户定义节点插件文件，请完成以下步骤：

过程

停止要在其上安装已编译或打包的用户定义扩展文件 (扩展名为 .lil， .jar， .par， .pdb或 .lel的文件) 的集成服务器
在所有情况下都是必需的，没有例外。
如果还没有用于此操作的目录，请进行创建。

例如：

C:\Work\Development\Demo\Plugins\bin

警告：
请勿将 .lil, .jar, .par, .pdb, 或 .lel 文件放置在 IBM App Connect Enterprise 安装目录中，因为这些文件可能会被覆盖。
将用户定义文件放到该目录中，并确保集成服务器可以访问它。
例如，在 Linux® 上，请对该文件使用 chmod 755* 命令。如果用户定义节点包含定制编译器，请将用户定义插件文件放入同一目录。
重新启动集成服务器，以实施更改并确保检测到新文件。
对需要用户定义扩展文件和用户定义节点插件文件的每个集成服务器重复上述步骤。如果所有集成服务器都在同一类型的操作系统上，那么您只需构建用户定义扩展文件一次，然后将其分发到各个系统。

如果您有一个包含 Linux 和 Windows 集成服务器的集群，那么必须在每种操作系统类型上单独构建用户定义的扩展文件。

在 Windows 上， .pdb 文件提供在发生访问违例或其他软件故障时显示堆栈诊断信息时使用的符号信息。
对于 C 用户定义的扩展，请将 .pdb 文件存储在与其对应的 .lil 文件所在的目录中。
通过更新 server.conf.yaml 配置文件将目录添加到 LILPATH。

例如：

lilPath: C:\Work\Development\Demo\Plugins\bin

结果

集成服务器在初始化期间装入用户定义扩展文件。装入文件后，集成服务器将调用用户定义扩展中的注册函数，并记录用户定义扩展支持的节点或解析器。

C 用户定义扩展实现可支持多个节点或解析器类型的节点或解析器工厂。有关更多信息，请参阅节点和解析器工厂行为。 Java 用户不需要编写节点工厂。