configTool
配置”页面上的属性和值存储在系统表中。您可以使用 configTool 实用程序将配置设置导出到系统表,或者从这些系统表导入配置设置。
何时使用 configTool
您可能要使用 configTool 的原因如下。
*
导入 Campaign 随附的分区和数据源模板,随后可以使用“配置”页面对它们进行修改和复制。
*
*
*
删除没有删除类别链接的类别。执行此操作的方法是使用 configTool 导出配置,然后手动删除创建该类别的 XML,并使用 configTool 导入编辑过的 XML。
*
此实用程序会修改 Marketing Platform 系统表数据库中的 usm_configurationusm_configuration_values 表,此数据库包含配置属性及其值。为了取得最好的效果,请创建这些表的备份副本,或者使用 configTool 导出现有配置并备份产生的文件,以便您在使用 configTool 导入出错时,可以复原配置。
语法
configTool -d -p "elementPath" [-o]
configTool -i -p "parent ElementPath" -f importFile [-o]
configTool -x -p "elementPath" -f exportFile
configTool -vp -p "elementPath" -f importFile [-d]
configTool -r productName -f registrationFile [-o] configTool -u productName
命令
-d -p "elementPath" [o]
通过指定配置属性层次结构中的路径,删除除配置属性及其设置。
元素路径必须使用类别和属性的内部名称。您可以通过以下方法获取这些内部名称:转至“配置”页面,选择所需的类别或属性,然后查看显示在右侧窗格中括号内的路径。使用 | 字符定界配置属性层次结构中的路径,并使用双引号括起路径。
请注意以下几点:
*
*
要删除在“配置”页面上没有删除类别链接的类别,请使用 -o 选项。
-d-vp 命令一起使用时,如果指定的路径中的任何子节点未包含在指定的 XML 文件中,那么 configTool 会将这些节点删除。
-i -p "parentElementPath" -f importFile [o]
从指定的 XML 文件导入配置属性及其设置。
要进行导入,应指定要将类别导入到其下的父元素的路径。configTool 实用程序会将属性导入到您在路径中指定的类别下面。
可以在顶级下面的任何级别添加类别,但不能在与顶级类别相同的级别添加类别。
父元素路径必须使用类别和属性的内部名称。您可以通过以下方法获取这些内部名称:转至“配置”页面,选择所需的类别或属性,然后查看显示在右侧窗格中括号内的路径。使用 | 字符定界配置属性层次结构中的路径,并使用双引号括起路径。
您可以指定相对于 tools/bin 目录的导入文件位置,也可以指定完整目录路径。如果您指定相对路径或不指定路径,那么 configTool 会先查找相对于 tools/bin 目录的文件。
缺省情况下,此命令不会覆盖现有类别,但是您可以使用 -o 选项来强制覆盖。
-x -p "elementPath" -f exportFile
将配置属性及其设置导出到具有指定名称的 XML 文件。
通过指定配置属性层次结构中的路径,您可以导出所有配置属性,或者将导出限制为特定类别。
元素路径必须使用类别和属性的内部名称,获取这些内部名称的方法是转至“配置”页面,选择所需的类别或属性,然后查看显示在右侧窗格中括号内的路径。使用 | 字符定界配置属性层次结构中的路径,并使用双引号括起路径。
您可以指定相对于当前目录的导入文件位置,也可以指定完整目录路径。如果文件规范不包含分隔符(在 UNIX 上是 /,在 Windows 上是 / 或 \),那么 configTool 会将文件写入 Marketing Platform 安装下的 tools/bin 目录。如果您不提供 xml 扩展名,那么 configTool 会添加该扩展名。
-vp -p "elementPath" -f importFile [-d]
此命令主要用于手动升级,以导入配置属性。如果已应用包含新配置属性的修订包,然后进行升级,那么在手动升级过程中导入配置文件会覆盖在应用该修订包时设置的值。使用 -vp 命令可确保导入不会覆盖先前设置的配置值。
*
configTool 实用程序与 -vp 选项结合使用后,必须重新启动部署了 Marketing Platform 的 Web 应用程序服务器,从而应用更改。
-d-vp 命令一起使用时,如果指定的路径中的任何子节点未包含在指定的 XML 文件中,那么 configTool 会将这些节点删除。
-r productName -f registrationFile
注册应用程序。注册文件位置可以相对于 tools/bin 目录,也可以是完整路径。缺省情况下,此命令不会覆盖现有配置别,但是您可以使用 -o 选项来强制覆盖。productName 参数必须是上面列示的名称之一。
请注意以下几点:
*
当您使用 -r 命令时,注册文件必须包含 <application> 作为 XML 中的第一个标记。
您的产品可能还提供了其他文件,您可以用于将配置属性插入 Marketing Platform 数据库。对于这些文件,请使用 -i 命令。只有包含 <application> 标记作为第一个标记的文件可以与 -r 命令一起使用。
*
Marketing Platform 的注册文件命名为 Manager_config.xml,而第一个标记为 <Suite>。要在新安装上注册此文件,请使用 populateDb 实用程序,或者按《IBM® Marketing Platform 安装指南》中的描述重新运行 Marketing Platform 安装程序。
*
在初始安装之后,要重新注册除 Marketing Platform 之外的产品,请将 configTool-r 命令和 -o 配合使用,以覆盖现有的属性。
configTool 实用程序使用产品名称作为注册和取消注册产品的命令的参数。使用 8.5.0 发行版的 IBM® EMM,许多产品名称都已更改。但是,由 configTool 识别的名称尚未更改。下列列示了与 configTool 配合使用的有效产品名称以及产品的当前名称。
IBM® SPSS® Modeler Advantage Enterprise Marketing Management Edition
-u productName
取消注册由 productName 指定的应用程序。您不必包括产品类别的路径;必须提供产品名称,且仅需提供产品名称。此过程会除去该产品的所有属性和配置设置。
选项
-o
当与 -i-r 配合使用时,会覆盖现有类别或产品注册(节点)。
-d 配合使用时,您可以删除在“配置”页面上没有删除类别链接的类别(节点)。
示例
*
Marketing Platform 安装下 conf 目录中文件名为 Product_config.xml 的文件导入配置设置。
configTool -i -p "Affinium" -f Product_config.xml
*
导出现有的 Campaign 分区(通过数据源条目完成),将它保存到名为 partitionTemplate.xml 的文件,并将该文件存储在 Marketing Platform 安装下的缺省 tools/bin 目录中。
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
使用 Marketing Platform 安装下缺省 tools/bin 目录中名为 app_config.xml 的文件,手册注册名为 productName 的应用程序,并强制它覆盖此应用程序的现有注册。
configTool -r product Name -f app_config.xml -o
*
configTool -u productName