Dienstprogramm configTool

Die Eigenschaften und Werte auf der Seite Konfiguration werden in den Systemtabellen gespeichert. Mit dem Dienstprogramm configTool können Sie Konfigurationseinstellungen in und aus Systemtabellen importieren und exportieren.

Verwendung von configTool

Sie können configTool für folgende Zwecke verwenden:

Importieren von Partitions- und Datenquellenvorlagen, die in Campaign bereitgestellt werden, zum Ändern und Duplizieren auf der Seite Konfiguration.

Registrieren (Importieren von Konfigurationseigenschaften) von IBM® EMM-Produkten, wenn das Installationsprogramm die Eigenschaften nicht automatisch in die Datenbank einfügen kann.

Exportieren einer XML-Version der Konfigurationseinstellungen als Sicherung oder um sie in eine andere Installation von IBM® EMM zu importieren.

Löschen von Kategorien, für die es keinen Link Kategorie löschen gibt. Dazu exportieren Sie die Konfiguration mit configTool, löschen anschließend manuell die XML-Datei, die die Kategorie erstellt, und importieren mit configTool die bearbeitete XML-Datei.

Mit diesem Dienstprogramm werden die Tabellen usm_configuration und usm_configuration_values in der Systemtabellendatenbank von Marketing Platform geändert. Diese Tabellen enthalten die Konfigurationseigenschaften und deren Werte. Die besten Ergebnisse erzielen Sie, wenn Sie entweder Sicherungskopien dieser Tabellen erstellen oder die vorhandene Konfiguration mit configTool exportieren und eine Sicherungskopie der resultierenden Datei erstellen. Auf diese Weise haben Sie die Möglichkeit, die Konfiguration wiederherzustellen, sollte es beim Importieren mit configTool zu einem Fehler kommen.

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

Befehle

-d -p "elementPath" [o]

Löschen von Konfigurationseigenschaften und deren Einstellungen mit Angabe eines Pfads in der Hierarchie der Konfigurationseigenschaften.

Im Elementpfad müssen Sie die internen Namen der Kategorien und Eigenschaften angeben. Sie erhalten diese, indem Sie auf der Seite Konfiguration die gewünschte Kategorie oder Eigenschaft auswählen. Der Pfad wird im rechten Fensterbereich in Klammern dargestellt. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und setzen ihn in doppelte Anführungszeichen.

Folgendes beachten:

Mit diesem Befehl können nur Kategorien und Eigenschaften innerhalb einer Anwendung gelöscht werden, jedoch nicht vollständige Anwendungen. Zum Aufheben der Registrierung einer Anwendung verwenden Sie den Befehl -u.

Um Kategorien zu löschen, die auf der Seite Konfiguration nicht über den Link Kategorie löschen verfügen, verwenden Sie die Option -o.

Wenn Sie den Befehl -vp zusammen mit der Option -d ausführen, löscht "configTool" alle untergeordneten Knoten im angegebenen Pfad, wenn diese Knoten in der angegebenen XML-Datei nicht enthalten sind.

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

Importieren von Konfigurationseigenschaften und deren Einstellungen aus einer angegebenen XML-Datei.

Zum Importieren geben Sie einen Pfad zum übergeordneten Element an, in das Sie die Kategorien exportieren möchten. Mit dem Dienstprogramm configTool werden Eigenschaften in die im Pfad angegebene Kategorie importiert.

Sie können Kategorien auf jeder beliebigen Ebene unterhalb Ausgangsebene speichern, nicht aber auf der Ausgangsebene.

Im übergeordneten Elementpfad müssen Sie die internen Namen der Kategorien und Eigenschaften angeben. Sie erhalten diese, indem Sie auf der Seite Konfiguration die erforderliche Kategorie oder Eigenschaft auswählen. Der Pfad wird im rechten Fensterbereich in Klammern dargestellt. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und setzen ihn in doppelte Anführungszeichen.

Sie können die Speicherposition einer Importdatei relativ zum Verzeichnis tools/bin oder auch einen vollständigen Verzeichnispfad angeben. Wenn Sie einen relativen Pfad oder keinen Pfad angeben, sucht configTool zunächst nach der Datei relativ zum Verzeichnis tools/bin.

Standardmäßig wird mit diesem Befehl eine vorhandene Kategorie nicht überschrieben. Mit der Option -o können Sie jedoch das Überschreiben erzwingen.

-x -p "elementPath" -f exportFile

Exportieren von Konfigurationseigenschaften und deren Einstellungen in eine XML-Datei mit einem angegebenen Namen.

Sie können alle Konfigurationseinstellungen exportieren oder den Export begrenzen, indem Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften angeben.

Sie können die Speicherposition einer Importdatei relativ zum aktuellen Verzeichnis oder auch einen vollständigen Verzeichnispfad angeben. Wenn die Dateispezifikation kein Trennzeichen enthält (/ unter UNIX™, / oder \ unter Windows™), schreibt configTool die Datei in das Verzeichnis tools/bin der Marketing Platform-Installation. Wenn Sie die Erweiterung xml nicht hinzufügen, wird sie von configTool automatisch hinzugefügt.

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

Dieser Befehl wird hauptsächlich bei manuellen Upgrades zum Importieren von Konfigurationseigenschaften verwendet. Wenn Sie ein Fixpack mit einer neuen Konfigurationseigenschaft angewendet haben und anschließend aktualisieren, können durch das Importieren einer Konfigurationsdatei im Rahmen eines manuellen Upgrades Werte überschrieben werden, die Sie beim Anwenden des Fixpacks festgelegt haben. Mit dem Befehl -vp stellen Sie sicher, dass beim Importieren keine zuvor festgelegten Konfigurationswerte überschrieben werden.

Nachdem Sie das Dienstprogramm configTool mit der Option "-vp" ausgeführt haben, müssen Sie den Webanwendungsserver, auf dem Marketing Platform bereitgestellt ist, erneut starten, damit die Änderungen übernommen werden.

-r productName -f registrationFile

Registrieren der Anwendung. Die Speicherposition der Registrierungsdatei kann relativ zum Verzeichnis tools/bin oder mit einem vollständigen Pfad angegeben werden. Standardmäßig wird mit diesem Befehl eine vorhandene Konfiguration nicht überschrieben. Sie können aber mit der Option -o das Überschreiben erzwingen. Der Wert des Parameters productName muss einer der oben aufgeführten Produktnamen sein.

Folgendes beachten:

Wenn Sie den Befehl -r ausführen, muss der erste Tag in der XML-Registrierungsdatei der Tag <application> sein.

Mit Ihrem Produkt können andere Dateien bereitgestellt werden, mit denen Sie Konfigurationseigenschaften in die Marketing Platform-Datenbank einfügen können. Verwenden Sie bei diesen Dateien den Befehl -i. Der Befehl -r kann nur für die Datei ausgeführt werden, in der <application> der erste Tag ist.

Die Registrierungsdatei für Marketing Platform lautet Manager_config.xml und der erste Tag ist <Suite>. Um diese Datei bei einer neuen Installation zu registrieren, verwenden Sie das Dienstprogramm populateDb oder führen Sie das Marketing Platform-Installationsprogramm erneut aus, wie im IBM® Marketing Platform-Installationshandbuch beschrieben.

Wenn Sie nach der Erstinstallation andere Produkte als Marketing Platform erneut registrieren möchten, führen Sie configTool zusammen mit dem Befehl -r und der Option -o aus, um die vorhandenen Eigenschaften zu überschreiben.

Das Dienstprogramm configTool verwendet Produktnamen als Parameter für die Befehle zum Registrieren und zum Aufheben der Registrierung von Produkten. Mit dem Release 8.5.0 von IBM® EMM haben sich viele Produktnamen geändert. Die von configTool erkannten Namen sind jedoch gleich geblieben. In der folgenden Liste sind die Produktnamen für configTool den aktuellen Produktnamen gegenübergestellt.

Produktnamen für Registrierung und Aufhebung der Registrierung mit "configTool"
Produktname	In configTool verwendeter Name
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

Aufheben einer mit productName angegebenen Registrierung. Sie müssen keinen Pfad zur Produktkategorie angeben. Geben Sie stattdessen den Produktnamen an. Der Prozess entfernt alle Eigenschaften und Konfigurationseinstellungen des Produkts.

Optionen

-o

Bei Verwendung in Verbindung mit -i oder -r wird eine vorhandene Kategorie oder eine vorhandene Produktregistrierung (Knoten) überschrieben.

Bei Verwendung in Verbindung mit -d können Sie eine Kategorie (Knoten) löschen, die auf der Seite Konfiguration nicht über den Link Kategorie löschen verfügt.

Beispiele

Importieren von Konfigurationseinstellungen aus der Datei Product_config.xml im Verzeichnis conf der Marketing Platform-Installation.

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

Importieren einer der bereitgestellten Campaign-Datenquellenvorlagen in die Campaign-Standardpartition, Partition1. Die Oracle-Datenquellenvorlage OracleTemplate.xml befindet sich bei diesem Beispiel im Verzeichnis tools/bin in der Marketing Platform-Installation.

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

Exportieren aller Konfigurationseinstellungen in die Datei myConfig.xml im Verzeichnis D:\backups.

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

Exportieren einer vorhandenen Campaign-Partition (komplett mit Datenquelleneinträgen), Speichern in der Datei partitionTemplate.xml im Verzeichnis tools/bin in der Marketing Platform-Installation.

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

Manuelles Registrieren der Anwendung "productName" mithilfe der Datei app_config.xml im Standardverzeichnis tools/bin der Marketing Platform-Installation und erzwungenes Überschreiben einer vorhandenen Registrierung dieser Anwendung.

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

Aufheben der Registrierung einer Anwendung mit dem Namen productName.

configTool -u productName