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