configTool 实用程序

“配置”页面上的属性和值存储在系统表中。可使用 configTool 实用程序来将配置设置导入到系统表中以及从系统表导出配置设置。

何时使用 configTool

您可能出于下列原因要使用 configTool。

导入 Campaign 随附的分区和数据源模板，然后，可通过使用“配置”页面来对它们进行修改和复制。

当产品安装程序无法自动将属性添加至数据库时，注册 IBM® EMM 产品（导入其配置属性）。

导出配置设置的 XML 版本以进行备份，或导入到 IBM® EMM 的另一安装中。

删除没有删除类别链接的类别。执行此操作的方法是通过使用 configTool 来导出配置，然后手动删除创建该类别的 XML，并通过使用 configTool 来导入已编辑的 XML。

此实用程序会修改 Marketing Platform 系统表数据库中的 usm_configuration 和 usm_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]

通过指定配置属性层次结构中的路径，删除除配置属性及其设置。

元素路径必须使用类别和属性的内部名称。可通过以下方式来获取这些名称：转至“配置”页面，选择所需类别或属性，然后查看显示在右侧窗格中括号内的路径。可通过使用 | 字符来对配置属性层次结构中的路径进行定界，并用双引号将该路径引起来。

请注意以下几点：

通过使用此命令，只能删除应用程序内的类别和属性，不能删除整个应用程序。使用 -u 命令可取消注册应用程序。

要删除在“配置”页面上没有删除类别链接的类别，请使用 -o 选项。

将 -d 与 -vp 命令配合使用时，configTool 会删除指定的路径中的任何子节点（如果这些节点未包括在指定的 XML 文件中）。

-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 命令配合使用时，configTool 会删除指定的路径中的任何子节点（如果这些节点未包括在指定的 XML 文件中）。

-r productName -f registrationFile

注册应用程序。注册文件位置可以相对于 tools/bin 目录，也可以是完整路径。缺省情况下，此命令不会覆盖现有配置别，但是您可以使用 -o 选项来强制覆盖。productName 参数必须是上面列示的那些名称的其中一个。

请注意以下几点：

使用 -r 命令时，注册文件必须将 <application> 作为 XML 中的第一个标记。

您的产品可附带其他文件，可使用它们来将配置属性插入到 Marketing Platform 数据库中。对于这些文件，请使用 -i 命令。只有将 <application> 标记作为第一个标记的文件才能与 -r 命令配合使用。

Marketing Platform 的注册文件名为 Manager_config.xml，并且第一个标记是 <Suite>。要对新安装注册此文件，请使用 populateDb 实用程序，或重新运行 Marketing Platform 安装程序，如《IBM® Marketing Platform 安装指南》中所述。

在初始安装之后，要重新注册除了 Marketing Platform 之外的产品，请将 configTool 与 -r 命令和 -o 配合使用，以覆盖现有属性。

configTool 实用程序使用产品名称作为注册和取消注册产品的命令的参数。对于 IBM® EMM 的 8.5.0 发行版，许多产品名称已更改。但是，由 configTool 识别的名称未更改。下面列示了与 configTool 配合使用的有效产品名称以及产品的当前名称。

configTool 注册和注销的产品名称
产品名称	在 configTool 中使用的名称
Marketing Platform	Manager
Campaign	Campaign
Distributed Marketing	Collaborate
eMessage	emessage
Interact	interact
Contact Optimization	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
Digital Analytics for On Premises	NetInsight
Opportunity Detection	Detect
Leads	Leads
Interaction History	InteractionHistory
Attribution Modeler	AttributionModeler
IBM® SPSS® Modeler Advantage Enterprise Marketing Management Edition	SPSS
Digital Analytics	Coremetrics

-u productName

可取消注册由 productName 指定的应用程序。不必包括产品类别的路径；提供产品名称便已足够，并且必须提供产品名称。该流程会除去该产品的所有属性和配置设置。

选项

-o

与 -i 或 -r 配合使用时，它会覆盖现有类别或产品注册（节点）。

与 -d 配合使用时，可删除在“配置”页面上没有删除类别链接的类别（节点）。

示例

从 Marketing Platform 安装目录下的 conf 目录中名为 Product_config.xml 的文件导入配置设置。

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

将所有配置设置导出到 D:\backups 目录下名为 myConfig.xml 的文件中。

configTool -x -f D:\backups\myConfig.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

取消注册名为 productName 的应用程序。

configTool -u productName