Carte做为Windows服务

有一些用例将Carte做为Windows服务运行：

• 当使用命令窗口运行Carte实例时，任何人都会错误地关闭实例而且Carte将关闭。
• Carte.bat命令窗口与调用批处理文件的用户会话相关联，须要保持登陆状态。
• 使用Windows服务，您能够在计算机启动时启动Carte服务，并将其配置为在崩溃后从新启动。

完成如下说明后，您能够将Carte做为Windows服务运行，以下所示：

 

安装说明

1. 从Sourceforge 下载YAJSW（又一个Java Service Wrapper）：http：//sourceforge.net/projects/yajsw/files/（这些说明是针对YAJSW版本11.03编写和测试的）
2. 将文件解压缩到合适的文件夹，例如C：\ Pentaho \ CarteService。注意：不该在任何其余Pentaho Kettle文件夹下建立此文件，由于它独立于Pentaho Kettle版本，而且能够轻松升级到将来的Kettle版本（另请参阅“升级说明”一章）。
3. 当您解压缩YAJSW时，您有一个文件夹C：\ Pentaho \ CarteService \ yajsw-stable-11.03。咱们建议将此文件夹重命名为C：\ Pentaho \ CarteService \ default。这样作的缘由是可能在一台机器上有多个配置，请参阅“一台机器上的多个Carte实例”一章。另外一个缘由是，若是您升级到之后的YAJSW版本，则无需更改对此文件夹的任何引用。注意：咱们将在如下说明中将YAJSW目录引用为<CarteServiceFolder>。
4. 下载准备好的wrapper.conf配置文件（本页附件）。
5. 将下载的wrapper.conf 复制到<CarteServiceFolder> \ conf \ wrapper.conf（替换现有的）。
6. 使用文本编辑器编辑wrapper.conf并手动更改如下条目（您能够在文件中搜索标记### InstallerOrModify ###的便利性）：

参数	样品	说明/注释
参数	样品	说明/注释
wrapper.working.dir	C：/Pentaho/pdi-ee-4.3.0-GA/data-integration	Carte的工做目录。请介意改变反斜线为正斜杠或文件路径双回斜线！ 注意：若是您定义了OS环境变量，则能够在配置中直接访问这些变量并使用此参数。Windows环境变量转换为小写。所以，即便您在计算机上使用例如PATH，也必须 在配置文件中调用$ {path}。
wrapper.app.account		Carte服务将运行的用户账户。若是此处未给出任何内容，则以本地系统账户启动。请咨询系统管理员，了解正确的用户设置。若是您在此处输入房产，请注意删除前导'＃'。
wrapper.app.password		给定账户的密码。若是您在此处输入房产，请注意删除前导'＃'。
wrapper.java.app.jar	。 发射器 pentaho-application-launcher-VERSION.jar	您须要替换此jar文件的版本。
wrapper.java.command	C：/Pentaho/BA-4.5.0-GA/java/bin/java.exe  或 $ {pentaho_java_home} /bin/java.exe	java.exe的路径。请介意改变反斜线为正斜杠或文件路径双回斜线！ 注意：使用安装程序时，已设置PENTAHO_JAVA_HOME系统环境变量。此变量能够在此上下文中使用，但须要以小写形式给出。
wrapper.app.parameter.3	127.0.0.1	Carte侦听IP地址（或动态配置文件），请参阅Carte用户文档以获取更多详细信息。 注意：对于动态集群配置，请将wrapper.app.parameter.3替换为集群配置文件的位置（例如wrapper.app.parameter.3 = C： Pentaho  Kettle  slave_dyn_8083.xml）并删除包装器。 app.parameter.4。
wrapper.app.parameter.4	8081	Carte监听端口，请参阅Carte用户文档以获取更多详细信息。
wrapper.java.additional.1	-Xmx512m	这可能会根据您所需的内存而有所不一样。

测试您的配置

1. 执行<CarteServiceFolder> \ bat \ runConsole.bat
2. 当一切配置正确时，Carte像往常同样启动。
3. 检查您是否能够从本地计算机上的浏览器登陆Carte，例如http：// localhost：8081
4. 测试成功后，您能够经过在新的yajsw系统托盘中选择“中止”或在控制台窗口中使用Ctrl-C来中止Carte。

 

安装Carte即服务

1. 执行<CarteServiceFolder> \ bat \ installService.bat（注意：您应该以管理员身份运行此操做，具体取决于您的操做系统和安全限制。不然，稍后可能会出现一些异常行为，例如，不会生成任何日志文件。）
2. 转到Windows服务，您应该看到已安装的服务（Pentaho DI Carte）。
3. 您能够更改全部设置（例如，启动类型，登陆凭据）
4. 按照“启动和中止Carte服务”一章中的说明启动您的服务并检查您的安装。

启动和中止Carte服务

除了Windows服务中的用户界面以外，还能够经过命令startService.bat或stopServce.bat（在<CarteServiceFolder> \ bat文件夹中）
或经过常规Windows服务启动和中止命令来启动和中止服务，例如
 net start pentaho_carte 
 net stop pentaho_carte 
注意：您须要管理员权限，最终在更改此服务名称时，经过参数wrapper.ntservice.name中的设置替换pentaho_carte

记录和监控

默认状况下，日志记录到文件<CarteServiceFolder> \ log \ wrapper.log。
您能够经过参数wrapper.logfile将此设置更改成其余位置/文件。
注意：请记住根据您的须要清理此日志文件。

也能够经过YAJSW系统托盘得到控制台输出。这是为了在桌面上显示状态图标和菜单。要启动系统托盘，您须要运行<CarteServiceFolder> \ bat \ systemTrayIconW.bat 
您能够建立一个连接以从启动文件夹启动try图标，这样它就能够经过定义systemTrayIconW的连接在用户登陆时自动启动。蝙蝠

更多信息能够在YAJSW文档的“系统托盘支持”一章中找到（http://yajsw.sourceforge.net/#mozTocId451759）

卸载

若是要卸载该服务，能够运行<CarteServiceFolder> \ bat \ uninstallService.bat（具备管理员权限）
或Windows自带的命令：sc delete pentaho_carte 
注意：您须要管理员权限，最终经过参数包装器中的设置替换pentaho_carte更改时的.ntservice.name

若是您收到错误指定的服务已标记为删除，一般只需从新启动Windows便可。

一台机器上的多个Carte实例

若是您须要在一台计算机上安装更多Carte实例，则应该具备<CarteServiceDirectory>的单独文件夹，并将每一个wrapper.conf文件中的如下属性更改成惟一（给定样本）：
wrapper.ntservice.name = pentaho_carte_8081 
wrapper.ntservice。 displayname = Pentaho DI Carte Port 8081 
wrapper.app.parameter.4 = 8081

此外，您须要设置

wrapper.tray = false

不然，启动会抛出IP地址的多个绑定的异常。（这能够经过不一样的配置来解决，但在撰写本文时还没有进一步调查。）

您能够考虑使用选项wrapper.affinity更改每一个实例的进程的CPU亲和性

高级选项和故障排除

咱们在此提供了简单易用的安装说明，以简化初始设置。若是您须要更多的背景下，要调整不一样的选项，优化设置，以YAJSW遇到问题，请参阅大量YAJSW文档在这里：http://yajsw.sourceforge.net/尤为是HTTP：//yajsw.sourceforge。净/ YAJSW％20Configuration％20Parameters.html

Pentaho Kettle升级说明

当您升级到更高版本的Pentaho Kettle版本时，请确保在wrapper.conf文件<CarteServiceDirectory> / conf中最后检查或更改引用wrapper.working.dir到您的Kettle文件夹，最后是wrapper.java.command。

YAJSW升级说明

当您升级到更高版本的YAJSW时，请确保安全并替换位于<CarteServiceDirectory> / conf中的wrapper.conf文件，并最终替换<CarteServiceDirectory> / log中的日志文件。

 

也能够得到系统托盘

在初始启动Windows服务后获取Carte的控制台输出：

当您登陆到carte时，控制台会得到与您经过浏览器得到的信息相同的信息，例如在执行示例转换后：

很是感谢YAJSW（Yet Another Java Service Wrapper）的开发人员提供了将Java程序做为服务包装的优秀解决方案，并感谢Dan将此引发个人注意。