ETL-Plus-安装配置指南.doc

学习资料收集于网络，仅供参考概述指南入门本指南帮助ETL Plus使用人员了解系统的结构，逐步熟悉ETL Plus产品的安装及部署。使用下表快速访问ETL Plus安装配置指南：若要了解请参见安装摘要主要讲述了成功安装ETL Plus所需要完成的任务和系统要求，并介绍了产品安装光盘。ETL Plus默认安装讲述ETL Plus默认安装包的安装条件以及安装和卸载过程。ETL Plus手动安装讲述手工部署ETL Plus到应用服务器 （Tomcat、JBoss、Websphere、Weblogic等）和手工创建知识库的操作过程。系统配置和应用讲述授权文件申请、系统配置和系统应用的过程。文档规范下列规范用于在ETL Plus安装配置指南中区分文本元素。规范用于粗体加粗表示按钮名，如：单击 确定 按钮尖括号带尖括号表示路径、字符串中的参数，如：路径，其中是ETL Plus的安装路径。标志采用醒目标志来表示在操作过程中应该特别注意的地方，这些标志的意义如下： 注意：提醒操作中应该注意的事项& 说明：对操作内容的描述进行必要的补充和说明对读者的要求本指南的读者对象为ETL Plus的高级使用者。他必须具备以下条件：(1) 有大型数据库系统维护的经验。(2) 熟悉数据库的安装和配置。(3) 熟悉一些应用服务器的安装和部署。学习资料1 安装摘要1.1 安装摘要ETL Plus安装有两种办法：l 默认安装：默认安装包仅供在Windows操作系统上使用，用户点击ETL Plus.exe进行安装，根据向导一步步操作即可完成安装部署。默认安装中调度服务器和管理平台使用Tomcat作为应用服务器、示例库使用MySQL数据库，安装完毕通过 系统环境配置 页面指定License后即可登录使用。该方法适用于初次试用ETL Plus产品或者是无特殊应用服务器和知识库要求的用户。l 手动安装：手工安装包可在Windows或Unix / Linux等操作系统上使用。根据实际项目需要选择应用服务器（Tomcat / JBoss / Weblogic / WebSphere）和知识库（MySQL / Oracle / DB2），由用户手工将etlplus.war和scheduler.war应用包部署到应用服务器上，再通过 系统环境配置 页面手动配置知识库和指定License后登录使用。该方法适用于有其他应用服务器或知识库要求的用户。要成功的使用ETL Plus，请关注如下步骤：l 创建知识库：选择ETL Plus默认安装使用MySQL作为知识库，也可以选择手工配置其他知识库（如Oracle）。l 增加JDBC驱动：etlplus.war和scheduler.war中没有包含所有支持的数据库JDBC驱动程序，所以需要根据实际情况手工增加相应版本的数据库驱动程序，并清除多余的相关驱动文件。l 配置应用服务器：选择ETL Plus默认安装则使用Tomcat作为应用服务器，无须额外配置；也可以选择手工将ETL Plus部署到WebSphere或WebLogic应用服务器。l 启动ETL Plus应用服务器：在使用ETL Plus客户端组件之前必须启动ETL Plus应用服务器，在工作完成并关闭客户端组件之后停止该服务器。l 申请License：在登录使用ETL Plus产品之前需要 申请License 获得产品的许可验证，具体操作请参见申请License。l 系统配置：应用服务器启动后，需要访问 系统环境配置 页面来进行知识库连接、授权文件等信息的配置，具体操作请参见系统配置小节。1.2 系统要求在Microsoft Windows上安装ETL Plus，所需要满足的系统要求。ETL Plus应用服务器系统要求组件要求处理器2CPU，推荐4CPU内存最低4G，推荐32G以上磁盘空间2*146GB操作系统下列操作系统之一：l Windows 2000 / 2003l HP-UNIXl Linux网络连接TCP/IP应用服务器下列服务器之一：l Tomcat 5.5以上l Tomcat 3.2.6以上l WebSphere 6.1或以上l BEA WebLogic 9.0或以上关系数据库服务器下列服务器之一：l Microsoft SQL Server l DB2l Oraclel MySQLETL Plus客户端产品系统要求组件要求处理器CPUp4以上内存最低1024MB RAM，推荐2048MB RAM磁盘空间200MB操作系统：l Windows 2000 / XP / 2003Web浏览器Microsoft Internet Explorer 6以上其他l Excel 2000、XP、2003l 推荐分辨率10247681.3 安装光盘介绍将产品安装光盘放入光驱中，将会自动运行安装向导。如果没有自动启动，请运行光盘根目录下的ETL Plus.exe安装文件。在安装向导首页右边显示的主要内容如下表：安装光盘内容说明选项说明产品安装进入产品安装的欢迎界面浏览光盘浏览光盘内容访问我们访问公司网站联系我们查看相关技术支持信息2 ETL Plus默认安装使用ETL Plus安装包配置ETL Plus流程如下：根据向导安装ETL Plus启动所有相关服务器进行系统配置登录使用申请License本章将向您讲述将ETL Plus默认安装Tomcat应用服务器和MySQL知识库所需要的信息和步骤。2.1 安装之前默认安装ETL Plus之前请仔细阅读以下说明：l 如果选择安装示例库，那么安装程序会自动创建MySQL服务和知识库。l 如果是升级ETL Plus并且安装目录没变，那么安装程序会自动检测原来MySQL数据是否存在，若存在则安装过程将不再初始化知识库。l 如果以前安装过MySQL或者使用到6677端口，那么ETL Plus安装程序将不能正确创建知识库。建议如下：(1) 如果情况允许，请手工停止使用6677端口的程序后再继续安装。此后，注意不要同时使用ETL Plus和原来使用6677端口的程序，以防端口冲突。(2) 如果6677端口不能停止，请直接安装ETL Plus后手工去创建知识库，具体操作步骤参照手工创建知识库。l 如果要更改默认知识库，请参看后续章节 手工创建知识库、增加数据库驱动程序、系统配置。2.2 安装ETL Plus& 说明在安装期间，若想退出产品安装向导，可单击任何一个界面上的 取消 按钮。在Windows平台安装ETL Plus，请执行下列操作：(1) 运行安装程序之前，退出所有正在运行的程序。(2) 在安装向导首页中选择产品安装，弹出“欢迎”窗口。(3) 单击 下一步 按钮，弹出“许可证协议”窗口。许可证协议窗口(4) 仔细阅读许可证协议后，并选择“我接受许可证协议中的条款”，单击 下一步 按钮，弹出“客户信息”窗口。客户信息窗口(5) 单击 下一步 按钮，弹出“选择目的地位置”窗口。(6) （可选）单击 浏览 按钮重新定义安装路径。默认安装路径为：系统盘符:LongTopETL Plus。 注意设置安装路径时需要注意路径中不能存在“空格”。(7) 单击 下一步 按钮， 弹出“选择安装程序将安装的功能”窗口。 注意在此步骤中，如果选择了“示例库”功能，下面步骤中将会进入 “自定义知识库服务端口”窗口，否则将不进入该窗口。在此步骤中，如果选择了“调度服务器”、“管理平台”、“代理程序”、“监听程序”中任何一个功能，下面步骤中都将进入“选择Java虚拟机目的地位置”窗口，否则将不进入该窗口。(8) 单击 下一步 按钮，弹出“选择Java虚拟机目的地位置”窗口。 注意Java虚拟机版本必须是1.5或以上版本，如果没有请到网上下载并安装之后重新执行本安装程序。(9) 单击 下一步 按钮，弹出“自定义知识库服务端口”窗口。点击 检测服务端口，检测当前端口是否被其他应用程序占用。 注意该窗口上显示了程序默认安装的示例库etlplus的超级用户及其密码，具体以安装程序为准。(10) 单击 下一步 按钮，弹出“可以安装该程序了”窗口。(11) 单击 下一步 按钮，弹出“安装状态”窗口。(12) 单击 下一步 按钮。安装完成后，弹出“安装完成”窗口。(13) 单击 完成 按钮。2.3 卸载ETL Plus如果要卸载ETL Plus产品，请执行下列操作：(1) 运行安装程序之前，退出所有正在运行的程序。(2) 运行“开始程序LongTop ETL Plus卸载ETL Plus”，将弹出“卸载确认”对话框。(3) 选择 除去，单击 下一步 按钮将弹出提示窗口。(4) 选择 是 将弹出“安装状态”窗口，程序进入卸载过程。(5) 卸载完成后将弹出“卸载完成”窗口。& 说明如果有安装示例库，则该界面上存在“是否删除所有数据文件”选项。如果选中该项，点击完成后原安装目录下的所有数据都将删除。再次安装时将重新初始化知识库和示例库。如果不选中该项，点击完成后原安装目录下的所有数据都将保留。3 ETL Plus手动安装使用服务器应用包etlplus.war和scheduler.war手工安装配置ETL Plus的完整流程如下：进行系统配置创建知识库启动所有相关服务申请License登录使用手工部署ETL Plus本章将向您讲述为ETL Plus手工创建知识库和手工部署到其它应用服务器的操作步骤。3.1 手工创建知识库ETL Plus目前支持MySQL、SQL Server、Oracle和DB2作为知识库。ETL Plus连接空的知识库后，将自动进行知识库的初始化。新建知识库步骤：(1) 登录数据库服务器；(2) 新建一个空库，如：EtlplusRepository，并将空库授权给相应的用户；(3) 记录服务器地址、端口号、用户名、密码等，在部署完ETL Plus后进行系统配置。3.2 增加数据库驱动程序（可选）为了保证ETL Plus能够正确的连接知识库和各种数据源，必须将各个项目实际用到的数据库驱动程序文件手工压缩到war包中。操作过程如下：(1) 使用WinRAR或其他工具打开etlplus.war和scheduler.war；(2) 清除etlplus.war和scheduler.war中已经存在的该数据库其它版本的驱动程序；(3) 将当前项目使用的数据库的驱动程序文件（*.jar）添加到etlplus.war WEB-INF lib和scheduler.war WEB-INF lib下；(4) 保存etlplus.war和scheduler.war文件。为了便于检查数据源连接方面的问题，下面列出各个关系数据库对应的jar文件名：数据库名称Jar包名称备注SQL Serversqljdbc.jarSQL Server 2005 msbase.jarSQL Server 2000mssqlserver.jarmsutil.jarMySQLmysql.jarOracleClasses12.zipOracle9iclasses12.jarOracle10gDb2db2java.zipdb2jcc.jardb2jcc_license_cu.jar3.3 部署ETL Plus管理平台、调度服务器3.3.1 部署到Tomcat 5.* 上安装完成Tomcat后，将ETL Plus应用部署到Tomcat上，请执行下列操作：(1) 检测环境变量中是否存在JAVA_HOME变量，如果不存在，则请增加环境变量或手工修改binstartup.bat文件指定java虚拟机的路径。(2) 将etlplus.war和scheduler.war包复制到webapps目录下。(3) 修改/conf/server.xml中的服务端口号设置，比如http服务端口8080，可能在该主机上已经被占用，可修改为其它未被占用的任一端口，如8000，通过netstat -na查看已经占用的各端口。(4) 运行binstartup.bat启动Tomcat服务器。(5) 登陆etlplus管理平台配置页面，http:/ip:port/etlplus/config。(6) 配置知识库连接，上传License文件，保存。(7) 访问http:/ip:port/etlplus进入管理平台，在系统配置中新建调度服务器，其中：主机IP和通讯端口为当前服务器的IP和端口，应用名称为scheduler。(8) 登陆scheduler配置页面，http:/ip:port/scheduler/config。(9) 配置知识库连接，上传License，保存。3.3.2 部署到JBoss 4.0.3SP1及以上版本安装完成Jboss后，将ETL Plus应用部署到Jboss上，请执行下列操作：(1) 检测环境变量中是否存在JAVA_HOME变量，如果不存在，则请增加环境变量或手工修改binrun.bat文件指定java虚拟机的路径。(2) 将etlplus.war和scheduler.war包复制到 serverdefaultdeploy目录下。(3) 运行binrun.bat启动Tomcat服务器。(4) 登陆etlplus配置页面，http:/ip:port/etlplus/config。(5) 配置知识库连接，上传License文件，保存。(6) 访问http:/ip:port/etlplus进入管理平台，在系统配置中新建调度服务器，其中：主机IP和通讯端口为当前服务器的IP和端口，应用名称为scheduler。(7) 登陆scheduler配置页面，http:/ip:port/scheduler/config。(8) 配置知识库连接，上传License，保存。3.3.3 部署到Websphere 6.1上 注意设置安装路径时路径中最好不要存在“空格”。安装完成WebSphere 6.1后，将ETL Plus应用服务器部署到WebSphere上。请执行下列操作： 部署etlplus.war(1) 在控制台界面左侧的导航栏中选择：应用程序 安装新的应用程序。“准备应用程序安装”界面(2) 在控制台界面右侧的“新应用程序的路径”中，填入ear文件的路径，并输入上下文根为“etlplus”，然后单击 下一步，将显示“步骤1：选择安装选项”界面。步骤1：“选择安装选项”界面(3) 单击 下一步，将显示“步骤2：将模块映射到服务器”界面。步骤2：将模块映射到服务器(4) 选取所有选项。(5) 单击 下一步，将显示“步骤3：映射Web模块的虚拟主机”界面。步骤3：映射Web模块的虚拟主机(6) 选取所有选项。(7) 单击 下一步，将显示“步骤4：总结”界面。步骤4：总结(8) 确定配置无误，选择 完成，ETL Plus应用程序已安装。 安装完成后，将出现提示语言：应用程序etlplus安装成功。(9) 单击 保存 ，保存设置。(10) 启动etlplus应用。(11) 登陆etlplus配置页面，http:/ip:port/etlplus/config。(12) 配置知识库连接，上传License文件，保存进入管理平台。(13) 访问http:/ip:port/etlplus进入管理平台，在系统配置中新建调度服务器，其中：主机IP、通讯端口和应用名为下一步部署scheduler.war的服务器的IP、端口，应用名。 部署scheduler.war(1) 在控制台界面左侧的导航栏中选择：应用程序 安装新的应用程序。(2) “准备应用程序安装”界面(3) 在控制台界面右侧的“新应用程序的路径”中，填入ear文件的路径，并输入上下文根为“scheduler”，然后单击 下一步，将显示“步骤1：选择安装选项”界面。(4) 单击 下一步，将显示“步骤2：将模块映射到服务器”界面。(5) 选取所有选项。(6) 单击 下一步，将显示“步骤3：映射Web模块的虚拟主机”界面。(7) 选取所有选项。(8) 单击 下一步，将显示“步骤4：总结”界面。(9) 确定配置无误，选择 完成，ETL Plus应用程序已安装。 安装完成后，将出现提示语言：应用程序scheduler安装成功。(10) 单击 保存 ，保存设置。(11) 启动scheduler应用。(12) 登陆scheduler配置页面，http:/ip:port/scheduler/config。(13) 配置知识库连接，上传License，保存。3.3.4 部署到WebLogic 9.0上安装完成WebLogic 9.0后，将ETL Plus应用服务器部署到WebLogic上。请执行下列操作： 部署etlplus.war(1) 利用WebLogic的“Configuration Wizard”新建一个域服务器，可以命名为ETL Plus_domain。(2) 启动ETL Plus_domain域服务器，在IE浏览器中输入http:/:7001/console，进入WebLogic Server Console；(3) 输入有管理员权限的用户名和密码后，单击 登录 ；(4) 在控制台左侧选择ETL Plus对应域服务器ETL Plus_domain下的Deployments。如图：在控制台右侧的Deployments一栏中点击 Install 按钮；(5) 选择发布的etlplus.war文件，点击 Next 按钮；(6) 后续的步骤按照默认选择进行发布直至完成；(7) 单击 Finish 按钮，再在控制台左侧的导航栏“Change Center”中点击“Activate Changes”保存并激活上面的设置。 (8) 最后点击start按钮，启动应用。(9) 登陆etlplus配置页面，http:/ip:port/etlplus/config。(10) 配置知识库连接，上传License文件，保存进入管理平台。(11) 访问http:/ip:port/etlplus进入管理平台，在系统配置中新建调度服务器，其中：主机IP、通讯端口和应用名为下一步部署scheduler.war的服务器的IP、端口，应用名。 部署scheduler.war(1) 在控制台左侧选择ETL Plus对应域服务器ETL Plus_domain下的Deployments。(2) 在控制台右侧的Deployments一栏中点击 Install 按钮；(3) 选择发布的scheduler.war文件，点击 Next 按钮；(4) 后续的步骤按照默认选择进行发布直至完成；(5) 单击 Finish 按钮，再在控制台左侧的导航栏“Change Center”中点击“Activate Changes”保存并激活上面的设置。 (6) 最后点击start按钮，启动应用。(7) 登陆scheduler配置页面，http:/ip:port/scheduler/config。(8) 配置知识库连接，上传License，保存。3.4 部署代理服务器(1) 将代理服务器目录复制到对应的机器上(2) 用记事本打开perties文件，设置代理服务器端口号（与管理平台配置的一样）(3) 用记事本打开perties文件，设置代理服务器的log文件输出位置。如：log4j.appender.A1.File=./logs/etlagent.log。其他设置项可以保留默认值。(4) 若代理服务器需要访问数据库，请将相应的数据库JDBC驱动复制到deploylib目录下，数据库驱动名称请参考增加JDBC驱动中的表格内容。(5) 启动代理服务器Windows平台：运行start.batLinux/Unix平台：运行./start.sh3.5 部署监听服务器(1) 将代理服务器目录复制到对应的机器上(2) 用记事本打开perties文件，设置监听目录位置。如：baseDir=./filelistener 或 baseDir=c:/filelistener。监听服务器启动后会自动创建目录结构(3) 用记事本打开perties文件，设置调度服务器URL地址。如：schedulerServer=44:5553/scheduler(4) 用记事本打开perties文件，设置监听服务器的log文件输出位置。如：log4j.appender.A1.File=./logs/etlagent.log。其他设置项可以保留默认值。(5) 用记事本打开perties，配置线程池。一般情况下可采用默认设置，不必更改。(6) 启动监听服务器Windows平台：运行start.batLinux/Unix平台：运行./start.sh3.6 更新ETL Plus如果本地已经手工部署过ETL Plus旧版本（如V1.0），而ETL Plus又发布了新的版本（如V2.0），请执行下列操作更新版本：(1) 备份原有的etlplus.war文件。(2) 使用WinRAR或其他工具打开新版本的 etlplus.war，根据实际情况增加项目使用的数据库JDBC驱动程序，步骤参看增加JDBC驱动。(3) 重新在应用服务器中部署新的etlplus.war和scheduler.war包，步骤参看手工部署ETL Plus到应用服务器。4 系统配置和应用本章将向您讲述将ETL Plus安装部署完毕后，所需要进行的系统配置过程。4.1 申请License运行ETL Plus之前，您必须申请License以获得产品的许可验证。获取License文件步骤如下：(1) 将ETL Plus服务器所在机器的IP地址发到etlplus，并在邮件中注明项目或客户名称、申请License的用途以及License的有效期限。(2) 东南融通将尽快返回LT-License.xml文件。4.2 系统配置在安装部署完ETL Plus后，需要进行一些初始配置。具体步骤如下：(1) 服务器成功部署，并启动服务器。(2) 登录到ETL Plus配置管理页面，地址为http:/server:port /etlplus/vision/config.jsp；l 如果是首次启动配置，需要设置管理员账号和密码，以便下次登录配置界面时验证，防止他人篡改知识库等信息。注：这里设置的用户仅管理系统配置界面，与ETL Plus系统登录用户无关。l 如果是再次启动配置，提示输入系统配置管理员的用户名和密码登录。(3) 点击 确定，进入配置页面，设置ETL Plus系统的配置文件bof-config.xml的存放路径、知识库信息、服务器日志信息、授权文件信息等。4.2.1 系统配置界面4.2.2 配置文件（bof-config.xml）bof-config.xml是ETL Plus的配置文件，用于存储知识库连接、服务器日志属性、授权文件路径等信息，在系统配置完毕自动生成。该文件可自由指定存放在服务器的某个位置上，存放路径最好不包括空格。4.2.3 知识库设置知识库是指用于存储ETL Plus系统相关信息的数据库。各个设置项含义说明如下：l 数据库类型：可选择MySQL、Oracle、DB2、MSSQL五种类型之一；l 服务器地址：知识库所在的服务器地址，包括端口号；l 最大连接数：允许连接知识库的最大个数；l 数据库名：知识库的名字；l 用户名、密码：访问知识库的用户和密码。设置完信息后，点击 测试知识库连接 可验证知识库