《使用AgentService将Agent发布为Windows系统服务》由会员分享，可在线阅读，更多相关《使用AgentService将Agent发布为Windows系统服务（17页珍藏版）》请在金锄头文库上搜索。
1、使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 1 页，共 17 页使用使用 AgentServiceAgentService 将将 AgentAgent 发布为发布为 WindowsWindows 系统服务系统服务编制人员：编制人员： 熊广熊广编制部门：编制部门： 软件工程研发中心软件工程研发中心模版文件版本：模版文件版本： V1.3.0适用项目范围：适用项目范围： 研发项目研发项目使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V
2、1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 2 页，共 17 页使用使用 AgentServiceAgentService 将将 AgentAgent 发布为发布为 WindowsWindows 系统服系统服务务一 前言前言在 ODI 中运行开发好的集成项目，每次需要手动进入 ODI 安装目录 BIN 目录下，启动AGENT，在命令行中敲入如 agentscheduler “-port=20910“ “-name=local_agent“ “-v=5“等的启动命令。这种方法复杂、繁琐，用户需要记住启动命令，每次均需手工键盘敲入；而且当服务器因故重
3、启时，又需要重新手工启动 Agent 服务；注销用户时，Agent 服务也连带着注销了，对于需要 24 小时运行的数据集成项目来说来说非常不方便，需要大量的人工干预去启停服务。基于此考虑，本文档介绍使用 ODI 提供的 agentservice 方法将 agent 发布为 Windows的系统服务，以后直接在 Windows 的服务窗口中即能对发布的 Agent 进行启停，而且系统重启后服务也会自动启动。二二 工具介绍工具介绍 Agentservice.bat 是 ODI 自带提供的一个小工具（提示：当运行 setup 安装 ODI 时，必须选择 Tools 选项以安装 java Wrappe
4、r 工具，agentservice 对 agent 的发布会用到该工具） 。在 Windows NT, 2000,2003 或 XP 平台下，能够使用该工具将代理注册为系统服务。以后对数据集成项目的运行就可以直接在服务窗口中进行启停，而且每次重启系统后，服务会自动运行，不需要手动干预，当集成项目作废时也可以通过 agentservice 卸载服务。Agentservice.bat 位于 ODI 安装目录oracledibin 下，如图所示：使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，
5、保留所有权利。 第 3 页，共 17 页运行参数及说明：运行参数及说明：agentservice.bat命令的语法及说明如下所示：agentservice.bat -i|-r -a|-s 各个参数的详细说明如下：参数参数描述描述-i|-r-i 发布为服务-r 卸载服务-a|-s-a 安装listener agent （该命令会调用snpsagent.conf文件中的参数）-s 安装Scheduler agent （该命令调snpsagentscheduler.conf文件中的参数） 发布为服务Agent 的物理名称，该参数为必选项Agrnt 的监听端口号Wrapper配置文件的名称，该文件必须
6、位于ODI安装目录的ools/wrapper/conf/子目录下，该参数为可选使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 4 页，共 17 页三三 前提配置前提配置 在运行 agentservice 前还需要进行相关的一些配置工作，具体如下：1、安装 ODI 时必须选择 Tools 选项以安装 java Wrapper 工具，agentservice 对agent 的发布会用到该工具，一般在安装过程中选择为 FULL 安装即可，如下所示：2、在运行 agentse
7、rvice 前要确保 ODI 安装目录下的/bin/odiparams.bat 文件之前被正确配置过，该文件中定义了 Agent 启动的环境信息，发布为服务时将会使用到此文件中定义到的参数，如下图所示：使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 5 页，共 17 页编辑 odiparams.bat，修改其参数，如下图显示了其部分内容，在此部分中修改定义了工作资料库和主存储库的 JDBC DRIVER 类型、连接地址、用户名、ENCODE 后的登陆密码等等，Agen
8、t 启动运行后就是根据此参数运行其中的内容。另外一般在 ODI 安装时即会要求机行此文件的配置修改，此处只需确认无误即可；如果在安装后没有配置该文件，则需要重新配置，具体的配置方法参见ODI 安装、部署手册 。使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 6 页，共 17 页3、修改 ODI 安装目录oracleditoolswrapperconf 下的 snpsagent.conf 文件，该配置文件定义了服务如何启动使用 AgentService 将 Agent
9、发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 7 页，共 17 页此文件的以下内容需要修改：（1）需要添加 wrapper.java.classpath：在 ODI 中新增加的驱动，需要在此处添加，以使服务运行时能找到这些驱动。如打开 snpsagent.conf（可用 TXTX 或 UltraEdit 等编辑软件打开）下图添加了 ODI 安装目录下 LIB 和 DRIVER 文件夹下的驱动，以后新增加的驱动必须在此处添加定义。我们在附录中给出了一个通用型的配置文件，其中定义了大部分会用到的驱动路径，在一般情况下
10、实施人员可以将此部分的配置内容直接拷贝过去进行配置。使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 8 页，共 17 页（2）还可以定义发布服务的 log 文件地址，及详细程度等，如下图中默认日志的文件名为 agentservice.log，格式为 LPTM，日志级别为 INFO。此处一般不需修改，用默认配置即可。至此，前提配置已完成，可以运行 Agentservice 发布服务了。四四 使用操作使用操作1、启动 Windows 命令窗口 （cmd 窗口） ，进入 O
11、DI 安装目录oracledibin2、启动 agentservice.bat 使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 9 页，共 17 页启动参数如下：agentservice.bat -i|-r -a|-s 启动示例如下：agentservice.bat i s Agent_Test 20915此处的 Agent_Test 为在 Topology 中定义的一个代理物理名称；20915 为其监听端口号端口号，实施过程中根据实际的定义更改此处的代理名和端口号；
12、wrapper_configuration_file 一般不需要指定；i 表示添加一个代理进系统服务；s 表示添加的是 Scheduler agent。启动 agentservice 发布此代理为服务，可以看到该代理被注册成为了系统服务使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 10 页，共 17 页3、打开控制面板/管理工具/服务，可以看此代理已经被发布为服务使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件
13、状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 11 页，共 17 页4、点击可查看服务详细信息并启动服务，服务启动后，以后系统重启，服务会自动重启，不需要再手工启动5、打开 ODI 安装目录oracledibin 下的 agentservice.log 文件，可以看到服务运行的日志内容，如下图所示：使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 12 页，共 17 页6、若此 Agent 下有实际运行的接口或包等，可以在 Operator 中
14、看到，集成项目已经开始运行了使用 AgentService 将 Agent 发布为系统服务文件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 13 页，共 17 页7、至此该 Agent 已经成功的发布为了 Windows 系统服务，如果有多个 Agent 需要发布，可依次方法注册为多个系统服务；另外如果项目有变更或作废，需要从系统服务中卸载此代理，则只需运行如：agentservice.bat r s Agent_Test 20915Agent 就从系统服务中卸载掉了使用 AgentService 将 Agent 发布为系统服务文
15、件编号：文件版本：V1.0密级：内部文件状态：生效日期：版权所有 江苏金智科技股份有限公司，保留所有权利。 第 14 页，共 17 页五五 附件：附件：snpsagent.confsnpsagent.conf 配置参考示例配置参考示例配置文件中的关键参数以绿色高亮显示# Java wrapper Properties properties file for an Agent Scheduler# Note that most parameters are set in the odiparams.bat file, or on# the agentservice.bat command line.# They are displayed in this file for information.#*# * Set the path to reference the jvm used for your Agent# This parameter is read in odiparams.bat# mand=java.exewrapper.working.dir=./././bin/# Java Main class.wrapper.java.mainclass=org.tanukisoftware.wrapper.Wrapper
