configTool

When to use configTool

You might want to use configTool for the following reasons.

• To import partition and data source templates that are supplied with Campaign, which you can then modify and duplicate by using the Configuration page.
• To register (import configuration properties for) HCL® Marketing Software products, if the product installer is unable to add the properties to the database automatically.
• To export an XML version of configuration settings for backup or to import into a different installation of HCL Marketing Software.
• To delete categories that do not have the Delete Category link. You do this by using configTool to export your configuration, then manually deleting the XML that creates the category, and by using configTool to import the edited XML.

Syntax

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

Commands

-d -p "elementPath" [o]

Delete configuration properties and their settings, specifying a path in the configuration property hierarchy.

The element path must use the internal names of categories and properties. You can obtain them by going to the Configuration page, selecting the wanted category or property, and looking at the path that is displayed in parentheses in the right pane. Delimit a path in the configuration property hierarchy by using the | character, and surround the path with double quotation marks.

Note the following.

• Only categories and properties within an application can be deleted by using this command, not whole applications. Use the -u command to unregister a whole application.
• To delete categories that do not have the Delete Category link on the Configuration page, use the -o option.

When you use -d with the -vp command, the configTool deletes any child nodes in the path you specify if those nodes are not included in the XML file you specify.

-i -p "parentElementPath" -f importFile [o]

Import configuration properties and their settings from a specified XML file.

To import, you specify a path to the parent element under which you want to import your categories. The configTool utility imports properties under the category you specify in the path.

You can add categories at any level below the top level, but you cannot add a category at same level as the top category.

The parent element path must use the internal names of categories and properties. You can obtain them by going to the Configuration page, selecting the required category or property, and looking at the path that is displayed in parentheses in the right pane. Delimit a path in the configuration property hierarchy by using the | character, and surround the path with double quotation marks.

You can specify an import file location relative to the tools/bin directory or you can specify a full directory path. If you specify a relative path or no path, configTool first looks for the file relative to the tools/bin directory.

By default, this command does not overwrite an existing category, but you can use the -o option to force an overwrite.

-x -p "elementPath" -f exportFile

Export configuration properties and their settings to an XML file with a specified name.

You can export all configuration properties or limit the export to a specific category by specifying a path in the configuration property hierarchy.

The element path must use the internal names of categories and properties, which you can obtain by going to the Configuration page, selecting the wanted category or property, and looking at the path that is displayed in parentheses in the right pane. Delimit a path in the configuration property hierarchy by using the | character, and surround the path with double quotation marks.

You can specify an export file location relative to the current directory or you can specify a full directory path. If the file specification does not contain a separator (/ on UNIX™, / or \ on Windows™), configTool writes the file to the tools/bin directory under your Marketing Platform installation. If you do not provide the xml extension, configTool adds it.

-vp -p "elementPath" -f importFile [-d]

This command is used mainly in manual upgrades, to import configuration properties. If you applied a fix pack that contains a new configuration property, and you then upgrade, importing a configuration file as part of a manual upgrade process can override values that were set when the fix pack was applied. The -vp command ensures that the import does not override previously set configuration values.

When you use -d with the -vp command, the configTool deletes any child nodes in the path you specify if those nodes are not included in the XML file you specify.

-r productName -f registrationFile

Register the application. The registration file location can be relative to the tools/bin directory or can be a full path. By default, this command does not overwrite an existing configuration, but you can use the -o option to force an overwrite. The productName parameter must be one of those names that are listed above.

Note the following.

• When you use the -r command, the registration file must have <application> as the first tag in the XML.

  Other files can be provided with your product that you can use to insert configuration properties into the Marketing Platform database. For these files, use the -i command. Only the file that has the <application> tag as the first tag can be used with the -r command.

• The registration file for the Marketing Platform is named Manager_config.xml, and the first tag is <Suite>. To register this file on a new installation, use the populateDb utility, or rerun the Marketing Platform installer as described in the HCL® Marketing Platform Installation Guide.
• After the initial installation, to re-register products other than the Marketing Platform, use configTool with the -r command and -o to overwrite the existing properties.

The configTool utility uses product names as parameters with the commands that register and unregister products. With the 8.5.0 release of HCL Marketing Software, many product names changed. However, the names that are recognized by configTool did not change. The valid product names for use with configTool are listed below, along with the current names of the products.

Unregister an application that is specified by productName. You do not have to include a path to the product category; the product name is sufficient, and it is required. The process removes all properties and configuration settings for the product.

Options

-o

When used with -i or -r, it overwrites an existing category or product registration (node).

When used with -d, you can delete a category (node) that does not have the Delete Category link on the Configuration page.

Examples

• Import configuration settings from a file named Product_config.xml in the conf directory under the Marketing Platform installation.

  configTool -i -p "Affinium" -f Product_config.xml

• Import one of the supplied Campaign data source templates into the default Campaign partition, partition1. The example assumes that you placed the Oracle data source template, OracleTemplate.xml, in the tools/bin directory under the Marketing Platform installation.

  configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml

• Export all configuration settings to a file named myConfig.xml in the D:\backups directory.

  configTool -x -f D:\backups\myConfig.xml

• Export an existing Campaign partition (complete with data source entries), save it to a file named partitionTemplate.xml, and store it in the default tools/bin directory under the Marketing Platform installation.

  configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml

• Manually register an application named productName, by using a file named app_config.xml in the default tools/bin directory under the Marketing Platform installation, and force it to overwrite an existing registration of this application.

  configTool -r product Name -f app_config.xml -o

• Unregister an application named productName.

  configTool -u productName