jumpmindmetl用户指南

《jumpmindmetl用户指南》由会员分享，可在线阅读，更多相关《jumpmindmetl用户指南（123页珍藏版）》请在金锄头文库上搜索。

1、 变更记录变更记录 版本号版本号 修改点说明修改点说明 变更人变更人 变更日期变更日期 0.0.1 整篇创建 2017-06-01 注：对该文件内容增加、删除或修改均需填写此修订记录，详细记载变更信息，以保证其 可追溯性。 参考资料： /metl/user-guide-2.0.4.r.63.html 阅读指南： 1 【】需要详细解释的内容； 2 【】需要特别注意的内容； 2 目目 录录 1. 前言前言 本用户指南介绍了 Metl，一个简洁的基于 Web 的系统集成平台，可以通过 Web 服务实现几种不同风格的数据集成，包括基于文件的提取/转换/加载（ETL） ，消息 传递和远程过程调用。本指

2、南适用于要安装软件、配置集成和管理其操作的用户、 开发人员和管理员。 感谢开源社区的所有成员， 他们的反馈和贡献帮助我们构建更 好的软件和文档。该版本的指南是在 2017-05-11 生成的。 4 2. 介绍介绍 Metl 是一个简洁的基于 Web 的集成平台，允许通过 Web 服务进行几种不同风 格的数据集成，包括：消息传递，基于文件的提取/转换/加载（ETL）和远程过程 调用。Metl 旨在解决相对简单的日常系统整合任务，而无需自定义编码、使用重 型的基础架构或需要高成本的花费。 它可以部署在云端或内部数据中心， 并且被设 计为允许开发人员通过编写自己的组件来扩展以满足他们自己的需求的架构

3、， 这些 组件可以被现有的 Metl 基础架构所包含和利用。 2.1. 概览概览 Metl 是一个 Web 应用程序。它可以作为 Web 应用程序包（war）文件部署到 应用程序服务器（即 Tomcat，JBoss，Websphere）中，或者可以作为附属在 Jetty Servlet 容器下的 war 文件单独部署。详见安装部分。 一旦安装，Web 应用程序就可以通过 Web 浏览器访问，并用于 设计，部署和管 理系统集成。 名词 解释 本系统、本平 台 即：Metl 的一个已安装且运行的实例 项目(Project) 多个待集成的业务系统的需求按照业务层次或类别可以将其分组或打包 成一个或多

4、个项目。项目是以逻辑方式将集成组合在一起的一种方案。 例如，一个项目代表包含某个系统内部或外部的所有相关需要集成内容 的总体。项目包含流程，模型和资源。 模型(Models) 定义在流程中流转的数据的数据结构。处理结构化数据时，可以通过建 模来定义数据。模型功能用来定义数据的属性或字段。模型与模型之间 可以是关联关系或层次结构关系的。 资源 表示与数据读取或写入的物理端点的连接配置。平台中提供了以下资源 类型： 数据库 - 与 JDBC 兼容的关系数据库的 JDBC 连接 目录 - 与文件系统的连接。本地，FTP，SFTP 和 SMB 都支持 HTTP 资源 - 与 REST 或基于 SOAP

5、 的服务的 HTTP 连接 邮件会话 - 可用于发送和接收电子邮件的 SMTP 连接 代理 一旦流程设计和配置完成，它们就可以被部署到要运行的代理（Agent： 一种配置好的物理运行环境）中。当流程部署到代理中时，其相关资源 也将部署到该代理中，并且可以为每个代理部署不同的配置。 5 2.1. 用例用例 本指南提到的一些样例： 平面文件数据集成（Flat File Data Integrations） RDBMS 数据集成（RDBMS Data Integrations） Pub / Sub（基于队列）数据集成（Pub / Sub (Queue based) Data Integrations

6、） 基于 API /服务的数据集成（API / Service Based Data Integrations） 2.2. 为什么为什么选择选择 Metl? 系统集成可以在几个小时内进行配置并开始运行，与之相对的是那些需要在 几天或几周内进行硬编码的解决方案 Metl 易于安装。只需下载.war 文件并运行 Metl 是基于网络（B/S）的，没有需要安装在客户端桌面的工具模块。可以在 本地部署，也可以在数据中心或云端部署 Metl 不需要重量级的基础设施。任何 windows 或 linux 操作系统架构都可以 安装 Metl 是开源的，没有黑盒部分。如果需要请下载源码去编写自己的组件 Met

7、l 已被证明能够在大型集成方案中使用 Metl 是免费的 整个工具集是根据 GPL 许可证开源的 Metl 被 JumpMind，Inc.支持，可以为任何需求提供专业的支持和服务 6 2.1. 系统要求系统要求 Metl 是以 Java 语言编写的，需要 Java 运行时环境（JRE）标准版（SE）或 Java 开发工具包（JDK）标准版（SE）。支持大多数主要操作系统和数据库。最 低操作系统要求是： Java SE - 运行时环境或开发套件版本 8 或更高版本 内存 - 1（GB）可用 磁盘 - 256（MB）可用 Metl 可从 Web 控制台进行访问，Web 控制台需要以下受支持的 We

8、b 浏览器之 一： Google Chrome 23 或更新版本 Internet Explorer 8 或更新版本 Mozilla Firefox 17 或更新版本 Safari 6 或更新版本 2.1. 许可许可 METL 是根据 GNU 通用公共许可证（GPL）3.0 版许可的免费软件。有关许 可证的全文，请参阅 http:/www.gnu.org/licenses/gpl.html。该项目包括由 JumpMind （http:/ 开发的软件和多个贡献者社区。 METL 根据一个或多个贡献者许可协议授权给 JumpMind 作为版权所有者。METL 和 METL 徽标是 JumpMind

9、 的商标。 7 3. 正文正文 3.1. 安装安装 Metl 作为 Web 应用程序存档（war）文件提供。可以以两种不同的方式部署.war 文件。 使用 Metl 的嵌入式 Jetty 服务器独立部署 部署到现有的 servlet 容器（即 Tomcat，JBoss，Websphere，Oracle Application Server 等） 3.1.1. 使用使用 Metl 的嵌入式的嵌入式 Jetty 服务器独立部署服务器独立部署 运行 Metl 的最简单方法是使用其内部 Jetty 容器独立运行它。为了独立运行 Metl，只需从命令行运行以下命令即可。 必须安装 Java 8 运行时环

10、境，并添加了 java 的运行路径。 java -jar metl.war 在上面显示的最简单的形式中，Metl 将根据登录用户的主目录（即 /users/myusername/.metl 基于 linux 的系统）和（c：/users/myusername/.metl 基于 Windows 的系统）选择配置目录。并且在这种形式下，metl 将使用基于文件的 H2 数据库作为 Metl 数据存储。 3.1.2. 部署到现有的部署到现有的 servlet 容器容器 为了将 Metl 部署到现有的 servlet 容器，只需将 metl.war 文件复制到应用程序服 务器的 deploy 目录即可

11、。 8 3.1.3. 指定指定 Metl 配置目录配置目录 可以通过指定系统属性 org.jumpmind.metl.ui.init.config.dir 来设置默认配置目录。 java -Dorg.jumpmind.metl.ui.init.config.dir=/opt/metl - jar metl.war 3.1.4. 应用程序属性文件（应用程序属性文件（metl.properties） 如果在配置目录此文件不存在，Metl 将在其配置目录中创建一个默认属性文件。 属性文件命名为 metl.properties，并具有以下内容： db.driver=org.h2.Driver db.u

12、rl=jdbc:h2:./metl-dev execution.retention.time.ms=3600000 execution.retention.time.ms.cancelled=60000 log.to.console.enabled=true log.to.file.enabled=true table.prefix=METL #log.file= 为 metl 替换一个另外的数据库资源用于配置流程和存储运行时数据就是简单的 在 metl.properties 文件中指定 jdbc 驱动程序和 url 地址： db.driver=net.sourceforge.jtds.jdb

13、c.Driver db.url=jdbc:jtds:sqlserver:/myserver:1433/mydatabase db.user=myuserid db.password=mypassword 默认情况下，Metl 使用 DBCP 数据库连接池。除上述之外，所有 DBCP 配置设 置都可以在 metl.properties 文件中设置，包括： db.validation.query= db.pool.initial.size= db.pool.max.active= db.pool.max.idle= db.pool.min.idle= db.pool.max.wait.millis

14、= db.pool.min.evictable.idle.millis= db.test.on.borrow= db.test.on.return= db.test.while.idle= 9 3.1.5. 安装安装 Metl 服务服务 Metl 可以安装为 linux / unix 或 windows 服务。要安装 Metl 作为服务，请从命令 行运行以下命令。 java -Dorg.jumpmind.metl.ui.init.config.dir = / opt / metl -jar metl.war install 默认情况下，Metl 将以服务名称为“metl”的服务进行安装。名为

15、metl_service.conf 的服务配置文件将被写入配置目录，可用于进一步配置 Metl 服 务。 3.1.6. 启动启动 Metl 服务服务 要启动 Metl 服务，请从命令行运行以下命令 java -Dorg.jumpmind.metl.ui.init.config.dir = / opt / metl -jar metl.war start 或者，使用操作系统工具启动和停止服务。 如：在 linux 上输入：service metl start 对于 Windows，请使用本地服务控制面板启动 Metl 服务。 3.1.7. 停止停止 Metl 服务服务 要停止 Metl 服务，请

16、从命令行运行以下命令： java -Dorg.jumpmind.metl.ui.init.config.dir = / opt / metl -jar metl.war stop 或者，使用操作系统工具启动和停止服务。 如：在 linux 上输入：service metl stop 对于 Windows，请使用本地服务控制面板停止 Metl 服务。 3.1.8. 卸载卸载 Metl 服务服务 要卸载 Metl 服务，请从命令行运行以下命令： 10 java -Dorg.jumpmind.metl.ui.init.config.dir = / opt / metl -jar metl.war uninstall 3.2. 管理管理模块主界面模块主界面 一旦 Metl 已经启动，它可以通过 Web 浏览器进行访问，如下所示： http:/myservername:myport/metl 如果 Me