InforSuiteSIBV6产品入门.doc

InforSuite SIB V6.1快速入门中创软件商用中间件股份有限公司2009 年05 月目录INFORSUITE SIB V6.1 快 速 入 门II目录第 1 章前言. 11.1. 编写目的. 11.2. 符号约定. 11.3. 手册的组织. 21.4. 获得技术支持. 2第 2 章产品安装. 32.1. 硬件环境. 32.2. 软件环境. 32.3. JDK版本. 32.4. 安装InforSuite SIB . 32.4.1. 安装步骤. 42.4.2. 安装目录说明. 17第 3 章一个简单的示例. 203.1. 背景说明. 203.2. 确定构件. 203.3. 演示准备. 203.3.1. 建立数据库. 203.3.2. 建立InforSuite SIB工程. 213.4. 开始演示. 463.4.1. 部署服务. 463.4.2. 服务部署. 473.4.3. 发送SOAP消息. 50前言INFORSUITE SIB V6.1 快 速 入 门1第1章 前言感谢您选用服务集成总线 InforSuite SIB 产品。服务集成总线InforSuite SIB 是中创软件商用中间件股份有限公司软件产品InforSuite 的重要组成部分，是中创软件著名产品InforEAI 的继承和发展。它采用面向服务的体系架构(SOA，Service Oriented Architecture)，遵循Java 业务集成（JBI，JavaBusiness Integeration）规范，是一个基于事件驱动体系结构（EDA，Event DrivenArchitecture）的企业服务总线（ESB，Enterprise Service Bus），提供数据集成、协议转换和业务集成等领域的基础构件，是异构的系统之间基于服务进行组装和互操作的基础平台。本手册简单介绍了 InforSuite SIBV6.1 的产品安装和简单示例。若文档与产品有出入，以最终产品为准。1.1. 编写目的本文档适用于 InforSuite SIB 产品使用人员和负责InforSuite SIB 配置、管理的人员，也可作为应用开发人员参考的资料。1.2. 符号约定本手册使用如表 1-1所示的约定。表 1-1 手册的约定约定 用途Courier New 源代码使用Courier NewTimes New Roman 普通英文单词、命令行使用Times New Roman黑体 关键语句使用黑体前言INFORSUITE SIB V6.1 快 速 入 门2加粗源代码、命令行的关键字、菜单项使用加粗字体1.3. 手册的组织本手册包括以下章节：第二章“产品安装”：介绍了 InforSuite SIB 所需的硬、软件环境及安装步骤。第三章“一个简单示例”：介绍了 InforSuite SIB 的一个简单示例。1.4. 获得技术支持中创软件商用中间件股份有限公司为 InforSuite SIB 提供产品技术支持。用户可以通过以下方式获得技术支持：电话：4006186180传真-mail：网址：当与 InforSuite SIB 的技术支持联系时，请提供以下资料： 运行环境 InforSuite SIB 产品的版本号 问题的详细描述产品安装INFORSUITE SIB V6.1 快 速 入 门3第2章 产品安装2.1. 硬件环境 Pentium 1G（_或更高） 1G 内存 10G 硬盘2.2. 软件环境 Windows 系列 Linux 系列 AIX5.1 以上 其它2.3. JDK 版本InforSuite SIB 推荐运行在jdk1.5 的环境上。如果本机没有jdk，可以在安装的时候选择InforSuite SIB 自带的jdk。2.4. 安装 InforSuite SIBInforSuite SIB 系统提供了安装程序，在安装程序的安装向导提示下，可以轻松完成InforSuite SIB 系统的安装。产品安装 42.4.1. 安装步骤第一步，双击InforSuite SIBV6.1.exe，安装程序将出现如图 2-1所示安装界面。图 2-1 准备安装第二步，将出现如图 2-2所示安装界面,选择安装语言。INFORSUITE SIB V6.1 快 速 入 门产品安装 5图 2-2 选择安装语言第三步，点击“OK”按键后，将出现安装步骤窗口，如图 2-3所示：INFORSUITE SIB V6.1 快 速 入 门产品安装 6图 2-3 用户须知第四步，点击“下一步”按键，进入用户须知，再继续点击“下一步”。进入许可协议。如图 2-4所示：INFORSUITE SIB V6.1 快 速 入 门产品安装 7图 2-4 产品简介第五步，接受许可协议，将出现选择安装位置窗口，如图 2-5所示：INFORSUITE SIB V6.1 快 速 入 门产品安装 8图 2-5 许可协议第六步，点击“下一步”按键，进入选择安装集，如图 2-6所示，点击“完整安装”则表示将安装InforSuite SIB的运行平台、管理平台及开发平台；点击“最小安装”则表示将仅安装InforSuite SIB的运行平台及管理平台，不安装开发平台。INFORSUITE SIB V6.1 快 速 入 门产品安装 9图 2-6 选择安装集第七步，点击“下一步”按键，进入选择安装文件夹，如图 2-7所示，默认文件夹为“C:CVICSEInforSuite”，也可以通过“选择”按键来选择其他文件夹。INFORSUITE SIB V6.1 快 速 入 门产品安装 10图 2-7 选择安装文件夹第八步，点击“下一步”，进入选择JDK，用户可以选择本机的JDK。选择“否”，则进入选择jdk 路径选择的步骤，选择“选择产品自带JDK“本安装程序将会自动安装自带的JDK，选择“选择已安装的JDK”本安装程序将会进入如所示界面，提供选择JDK 路径的界面。INFORSUITE SIB V6.1 快 速 入 门产品安装 11图 2-8 选择JDKINFORSUITE SIB V6.1 快 速 入 门产品安装 12图 2-9 选择JDK 安装路径第九步，点击“下一步”进入选取快捷径文件夹，如图 2-10所示：INFORSUITE SIB V6.1 快 速 入 门产品安装 13图 2-10 选取快捷文件夹第十步，点击“下一步”，进入设置系统服务，选择“设置为系统服务”，InforSuiteSIB 将被设置成系统服务，若是选择“不设置为系统服务”则InforSuite SIB 不作为系统服务。INFORSUITE SIB V6.1 快 速 入 门产品安装 14图 2-11 系统服务第十一步，点击“下一步”，进入“预安装摘要”。在这步请确认安装内容，如图2-12所示：INFORSUITE SIB V6.1 快 速 入 门产品安装 15图 2-12 预安装摘要第十二步，点击“安装”，进入正在安装步骤，如图 2-13所示：INFORSUITE SIB V6.1 快 速 入 门产品安装 16图 2-13 正在安装最后，将出现如图 2-14界面，以示安装完成。INFORSUITE SIB V6.1 快 速 入 门产品安装 17图 2-14 安装完毕至此，InforSuite SIBV3.2 成功地安装到您的主机上。系统缺省安装路径为%SystemDrive%CVICSE。安装完成之后InforSuite SIB 将在系统程序菜单创建一个程序文件夹，支持以快捷方式启动各项服务及应用。2.4.2. 安装目录说明InforSuite SIB安装目录下包括如表 2-1所示的内容，安装目录的主目录通常为InforSuite下的集成目录(通常为INFORSUITE_HOME)。表 2-1 安装企业版的目录清单序号 目录或者文件 内容INFORSUITE SIB V6.1 快 速 入 门产品安装INFORSUITE SIB V6.1 快 速 入 门181 repositorycomcvicseInforSuite SIBcommlibs 第三方公共依赖库目录2 repositorycomcvicseInforSuite SIBInforSuite SIB -componentframework构件框架jar 包目录3 repositorycomcvicseInforSuiteSIBInforSuite SIBjbiJBI 规范API 的jar 包目录4 repositorycomcvicseInforSuiteSIBInforSuite SIB-coreJBI 规范API 核心实现的jar 包目录5 repositorycomcvicseInforSuiteSIBInforSuite SIB-services工具类和基础服务的jar 包目录6 inforsibcomponents 预置的轻量级构件的jar 包目录7 inforsibsharedlibs 预置公共依赖库的jar 包目录8 varInforSuite SIBcomponents 运行态构件的目录9 varInforSuite SIBsharedlibs 运行态共享库的目录10 varInforSuite SIBservice-assemblies 运行态服务组装的目录11 varInforSuite SIBinstall 运行时热部署构件的的目录12 varInforSuite SIBdeploy 运行时热部署服务组装的目录13 varlogsib.log 本产品的日志文件14 varlogsib -services.log 本产品与平台集成部分日志文件15 docsdemosib 本产品的例子指南16 docsInforSuiteSIBVX.X.X 使用手册本产品的使用手册17 perties 包含了本产品的日志配置18 repositorycomcvicseinforsuiteconsoleconsole目录中包括了本产品的管理工具19 repositorycomcvicseinforsuitemodulesinforsuite-sib本产品的 ESB 与InforSuiteAS 集成的jar包的目录20 repositorycomcvicseinforsuitemodulesinforsuite-sib-builder本产品的部署与InforSuiteAS 集成的jar 包的目录21 repositorycomcvicseinforsuiteconfigssib 本产品的ESB 与InforSuiteAS 集成的config 的目录产品安装INFORSUITE SIB V6.1 快 速 入 门1922 repositorycomcvicseinforsuiteconfigssib-deployer本产品的部署与InforSuiteAS 集成的config 的目录23 repositorycomcvicseinforsuiteconfigssib-system-database本产品的数据库与InforSuiteAS 集成的config 的目录一个简单的示例INFORSUITE SIB V6.1 快 速 入 门20第3章 一个简单的示例3.1. 背景说明应用系统（App，我们假设为OA 系统，即办公自动化）有一个数据库表sibtest，我们要从外部发送SOAP 消息对该表进行查询操作，并以soap 消息形式返回结果集。3.2. 确定构件根据需要此例要用的到构件有：HttpProxy、DBManipulation。3.3. 演示准备3.3.1. 建立数据库建立数据库，同时新建用户sib，这个用户在后面配置服务时要用到。建表语句如下：Create Table SIB. SIBTEST (ID INTEGER NOT NULL,NAME VARCHAR(16) NOT NULL,SEX CHAR NOT NULL,BIRTHDAY DATE,ADDRESS VARCHAR(200),PRIMARY KEY (ID) );GO表中数据为：一个简单的示例 21图 3-1 表数据3.3.2. 建立 InforSuite SIB 工程. 新建工程运行Eclipse建立SIB项目与新建java项目步骤相似，选择菜单“File”，如图 3-2所示。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 22图 3-2 选择新建Project选择“InforSuite Studio”目录下的“ServiceAssembly Project”，然后点击“Next”新建SIB 项目。图 3-3 选择新建SIB 项目填入项目名称，然后点击“完成”完成 SIB 项目的建立。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 23图 3-4 填写项目名完成以上操作后，出现Visual Integrator的主界面，如图 3-5所示。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 24图 3-5 项目建立完整视图. 新建包新建包有两种方式。1. 在菜单“文件”中选择“新建”再选择“其他”，即出现如图 3-6所示，选择“InforSuite Studio”中“Service Assembly Package”。2. 选择项目名后点击鼠标右键选择“SIB Studio”中“Service AssemblyPackage”，如图 3-7所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 25图 3-6 新建包INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 26图 3-7 新建包2编辑包名后，如图 3-8所示，选择“Finish”完成，如图 3-9所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 27图 3-8 编辑包名INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 28图 3-9 完成新建包. 新建服务展开项目视图的树，选择SIB的项目，点击鼠标右键，选择“SIB Studio”，如图 3-10：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 29图 3-10 新建服务编辑文件名，如图 3-11所示，点击“Finish”完成，如图 3-12。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 30图 3-11 编辑服务名INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 31图 3-12 完成新建服务红框所示为基础服务调色板，建模时，可以从中拖拽构件至编辑视图。. 配置构件从Protocol Service 处把HttpProxy、DBManipulation 两构件拽到编辑区。把鼠标放到HttpProxy构件的outport端按住左键拖动到DBManipulation构件的inport端连接两构件。如图 3-13所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 32图 3-13 配置构件两构件的具体配置为： HttpProxy 基本信息、SOAP配置分别如图 3-14，图 3-15所示：图 3-14 HttpProxy 配置图（一）INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 33图 3-15 HttpProxy 配置图（二） DBManipulation 连接信息、连接配置分别如图 3-16所示：图 3-16 DBManipulation 配置图（一）INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 34图 3-17 DBManipulation 配置图（二）各属性配置完成后见校验视图没有红色提示即表示可以打包。在模型编辑区点击右键选择“打包”，打包成功显示如图 3-18所示：图 3-18 打包打包成功后在“Project Explorer”视图下会生成一个target 目录，打开如图 3-19所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 35图 3-19 服务保存的路径. 通过 VI 部署用户可在 VI 上进行部署服务，也可到SIB 管理工具上实现服务部署，参考3.4.2节。VI上的部署功能通过访问SIB的管理工具来实现的。主要的部署操作在部署视图与编辑视图中完成，如图 3-20所示，举例说明服务的部署，步骤如下：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 36图 3-20 部署视图展示点击部署视图，可以看到项，这是部署视图的根，所有的服务器都依赖于此节点，且部署视图中只有根与服务器两类元素。1. 新增服务器在部署视图根上点右键选弹出菜单中“新增Sib服务器”项来新建一个服务器，如图 3-21所示：图 3-21 新增Sib 服务器进入服务器信息配置导航页面（编辑功能也是使用此页面）后，需要填写服务器名称、主机名、端口号信息。这些都是必填信息，其中主机名的默认值是localhost表示本地主机，可以填写远程主机的IP如 来代表远程主机。端口的默认值INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 37是8080。填写完后点“完成”如图 3-23所示：图 3-22 新建服务器导航页图 3-23 新建服务器完成这样一个名为 test 的本地服务器就建立成功了。2. 共享库的部署共享库的部署操作，前提是所要登陆的服务器已经启动了。步骤如下：在服务器INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 38上点鼠标右键，在弹出菜单里选选项，如图 3-24所示：图 3-24 共享库的部署编辑视图将会打开一个IE的浏览器，用以登陆管理工具界面，如果登陆失败会如图3-25所示：图 3-25 共享库登陆失败登陆成功如图 3-26所示，在这个界面上可以按管理平台的使用方式去部署、启动、停止和关闭sib的共享库。使用时需要查看3.4.2 节。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 39图 3-26 在vi 编辑视图中打开共享库的管理平台界面3. 构件的部署和服务的部署构件与服务的部署步骤与共享库部署相似，都需要参考3.4.2 节来完成。. 外部数据库资源配置外部数据库资源的操作在VI中的数据库视图中完成，如图 3-27红框部分所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 40图 3-27 数据库视图.1. 新增外部数据库资源在 数据库视图中选中点击右键， 在弹出菜单中选来新增数据库资源，如下图 3-28所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 41图 3-28 新增数据库资源在导航页中填写数据库资源有关的信息，如下图 3-29所示，图中名称部分为用于用户区别各种不同数据库连接所取的名字。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 42图 3-29 数据库连接信息配置必选项填写完整后，连接测试按钮会变得可以使用，如图 3-30所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 43图 3-30 连接测试这里可以不填密码项也能进行连接测试，测试按钮按下后如果测试成功如图 3-31所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 44图 3-31 数据库连接测试正确测试没有通过如图 3-32所示：INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 45图 3-32 数据库连接测试没有通过不管连接是否正确，都可以点完成来新建连接。在排除网络和其他原因造成的问题后可以点编辑来重新测试以前保存的外部数据库连接或删除此资源。如下图 3-33所示：图 3-33 编辑与删除数据库资源INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 463.4. 开始演示3.4.1. 部署服务. 启动 InforSuite SIB 服务选择“开始”“InforSuite”“SIB”“启动服务器”，启动成功提示如图 3-34所示：图 3-34 启动InforSuite SIB. 启动控制台选择“开始”“InforSuite”“SIB”“启动管理工具”或者打开IE浏览器，INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 47输入http:/localhost:8080/console，默认用户名：admin密码：infor如图 3-35所示：图 3-35 启动控制台3.4.2. 服务部署在部署服务之前首先需要部署服务依赖的构件。构件有可能又依赖于某个共享库。所以一般部署分为三步，按顺序分别为构件依赖的共享库、服务依赖的构件、服务组装。INFORSUITE SIB V6.1 快 速 入 门一个简单的示例 4. 部署共享库目录树中选择“服务集成总线”“共享库”，如图 3-36选中系统预设共享库列表中的需要部署的共享库，单击部署即可部署该共享库。本例需要部署InforSuiteSIB-db和InforSuite SIB-saaj两个共享库。图