configTool

Die Eigenschaften und Werte auf der Seite Konfiguration werden in den Systemtabellen gespeichert. Verwenden Sie das Dienstprogramm configTool, um die Konfigurationseinstellungen in die Systemtabellen zu importieren bzw. aus diesen zu exportieren.

Verwendung von "configTool"

Das Dienstprogramm configTool kann zu folgenden Zwecken eingesetzt werden.

Zum Importieren der in Campaign bereitgestellten Partitions- und Datenquellenvorlagen, die Sie anschließend über die Seite Konfiguration ändern und duplizieren können.

Zum Registrieren (Importieren von Konfigurationseigenschaften für) von IBM EMM-Produkten, wenn das Installationsprogramm die Eigenschaften der Datenbank nicht automatisch hinzufügen kann.

Zum Exportieren einer XML-Version der Konfigurationseinstellungen für die Sicherung oder zum Importieren in eine andere Installation von IBM EMM.

Zum Löschen von Kategorien, für die es keinen Link Kategorie löschen gibt. Verwenden Sie hierzu configTool, um Ihre Konfiguration zu exportieren. Löschen Sie anschließend manuell die XML, die die Kategorie erstellt, und verwenden Sie configTool, um die bearbeitete XML zu importieren.

Dieses Dienstprogramm ändert die Tabellen usm_configuration und usm_configuration_values in der Marketing Platform-Systemtabellendatenbank, die die Konfigurationseigenschaften und die zugehörigen Werte enthält. Um optimale Ergebnisse zu erzielen, sollten Sie entweder Sicherheitskopien dieser Tabellen anlegen oder Ihre bestehenden Konfigurationen mit configTool exportieren und die Ergebnisdatei sichern. Damit haben Sie die Möglichkeit, Ihre Konfiguration wiederherzustellen, wenn Ihnen beim Importieren mit configTool Fehler unterlaufen.

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 Sie Konfigurationseigenschaften und deren Einstellungen, indem Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften.

Der Elementpfad (elementPath) muss die internen Namen der Kategorien und Eigenschaften verwenden. Diese können Sie über die Seite Konfiguration abrufen, indem Sie dort die gewünschte Kategorie oder Eigenschaft auswählen und den Pfad verwenden, der im rechten Fensterbereich in Klammern angezeigt wird. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und schließen Sie den Pfad in doppelte Anführungszeichen ein.

Folgendes beachten:

Mit diesem Befehl können keine kompletten Anwendungen, sondern nur Kategorien und Eigenschaften innerhalb einer Anwendung gelöscht werden. Verwenden Sie den Befehl -u, um die Registrierung für eine komplette Anwendung aufzuheben.

Verwenden Sie zum Löschen von Kategorien, für die es auf der Seite Konfiguration keinen Link Kategorie löschen gibt, die Option -o.

Wenn Sie -d mit dem Befehl -vp verwenden, löscht das Dienstprogramm "configTool" alle untergeordneten Knoten in dem von Ihnen angegebenen Pfad, sofern diese Knoten nicht in der von Ihnen angegebenen XML-Datei enthalten sind.

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

Konfigurationseigenschaften und die zugehörigen Einstellungen aus einer angegebenen XML-Datei importieren.

Geben Sie zum Importieren einen Pfad zu dem übergeordneten Element ein, unter dem Sie die Kategorien importieren möchten. Das Dienstprogramm configTool importiert Eigenschaften unter der Kategorie, die Sie im Pfad angeben.

Sie können Kategorien auf jeder Ebene unter der obersten Ebene hinzufügen. In die Ebene der obersten Kategorie können Sie jedoch keine Kategorie hinzufügen.

Der übergeordnete Elementpfad (parentElementPath) muss die internen Namen der Kategorien und Eigenschaften verwenden. Diese können Sie über die Seite Konfiguration abrufen, indem Sie dort die erforderliche Kategorie oder Eigenschaft auswählen und den Pfad verwenden, der im rechten Fensterbereich in Klammern angezeigt wird. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und schließen Sie den Pfad in doppelte Anführungszeichen ein.

Sie können eine Speicherposition für die Importdatei relativ zum Verzeichnis tools/bin oder einen vollständigen Verzeichnispfad angeben. Ungeachtet dessen, ob Sie einen relativen Pfad oder keinen Pfad angeben, sucht configTool zuerst nach der Datei mit Bezug zum Verzeichnis tools/bin.

Standardmäßig überschreibt dieser Befehl keine bestehende Kategorie, jedoch können Sie mit der Option -o das Überschreiben erzwingen.

-x -p "elementPath" -f exportFile

Konfigurationseigenschaften und die zugehörigen Einstellungen in eine XML-Datei mit einem bestimmten Namen exportieren.

Sie können alle Konfigurationseigenschaften exportieren oder den Export auf eine bestimmte Kategorie beschränken, indem Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften festlegen.

Der Elementpfad (elementPath) muss die internen Namen der Kategorien und Eigenschaften verwenden. Diese können Sie über die Seite Konfiguration abrufen, indem Sie die gewünschte Kategorie oder Eigenschaft auswählen und den Pfad verwenden, der im rechten Fensterbereich in Klammern angezeigt wird. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und schließen Sie den Pfad in doppelte Anführungszeichen ein.

Sie können für die Exportdatei eine Speicherposition mit Bezug auf das aktuelle Verzeichnis oder einen vollständigen Verzeichnispfad festlegen. Falls die Dateispezifikation kein Trennzeichen enthält (/ unter UNIX™ / oder \ unter Windows™), schreibt configTool die Datei in das Verzeichnis tools/bin in Ihrer Marketing Platform-Installation. Falls Sie die Dateierweiterung xml nicht angeben, wird sie von configTool hinzugefügt.

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

Dieser Befehl wird vorwiegend bei manuellen Upgrades für das Importieren von Konfigurationseigenschaften verwendet. Wenn Sie ein Fixpack angewendet haben, das eine neue Konfigurationseigenschaft enthält, und dann ein Upgrade durchführen, wobei im Rahmen eines manuellen Upgradeprozesses eine Konfigurationsdatei importiert wird, kann dies dazu führen, dass die bei der Anwendung des Fixpacks festgelegten Werte überschrieben werden. Der Befehl -vp stellt sicher, dass die zuvor festgelegten Konfigurationswerte durch den Import nicht überschrieben werden.

Wenn Sie das Dienstprogramm configTool mit der Option -vp verwendet haben, müssen Sie den Webanwendungsserver, auf dem Marketing Platform bereitgestellt ist, erneut starten, damit die Änderungen wirksam werden.

-r productName -f registrationFile

Registrieren Sie die Anwendung. Die Speicherposition der Registrierungsdatei kann sich auf das Verzeichnis tools/bin beziehen oder ein vollständiger Pfad sein. Standardmäßig überschreibt dieser Befehl keine bestehende Konfiguration, jedoch können Sie mit der Option -o das Überschreiben erzwingen. Der Parameter productName muss einer der zuvor aufgelisteten Namen sein.

Folgendes beachten:

Wenn Sie den Befehl -r verwenden, muss die Registrierungsdatei <application> als ersten Tag in der XML enthalten.

In Ihrem Produkt können andere Dateien enthalten sein, die Sie verwenden können, um Konfigurationseinstellungen in die Marketing Platform-Datenbank einzufügen. Verwenden Sie für diese Dateien den Befehl -i. Nur die Datei, in der der Tag <application> als erster Tag enthalten ist, kann mit dem Befehl -r verwendet werden.

Die Registrierungsdatei für Marketing Platform hat den Namen Manager_config.xml und der erste Tag lautet <Suite>. Um diese Datei in einer neuen Installation zu registrieren, verwenden Sie das Dienstprogramm populateDb oder führen Sie das Installationsprogramm Marketing Platform gemäß der Beschreibung im IBM Marketing Platform-Installationshandbuch erneut aus.

Verwenden Sie nach der Erstinstallation zur Aufhebung der Registrierung für alle anderen Produkte mit Ausnahme von Marketing Platform das Dienstprogramm configTool mit dem Befehl -r und der Option -o, um die vorhandenen Eigenschaften zu überschreiben.

Das Dienstprogramm configTool verwendet Produktnamen als Parameter mit den Befehlen, die zur Registrierung von Produkten und zur Aufhebung von Produktregistrierungen verwendet werden. Bei dem Release 8.5.0 von IBM EMM wurden viele Produktnamen geändert. Die in configTool anerkannten Namen haben sich jedoch nicht geändert. Die gültigen Produktnamen für die Nutzung mit configTool sowie die aktuellen Namen der Produkte sind nachfolgend aufgeführt.

Produktnamen für die Registrierung und Aufhebung der Registrierung von 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

Heben Sie die Registrierung einer Anwendung auf, die über productName angegeben wird. Sie müssen keinen Pfad zur Produktkategorie angeben. Der Produktname reicht aus, muss aber angegeben werden. Bei diesem Prozess werden alle Eigenschaften und Konfigurationseinstellungen für das Produkt entfernt.

Optionen

-o

In Verbindung mit -i oder -r wird eine bestehende Kategorie oder Produktregistrierung (Knoten) überschrieben.

In Verbindung mit -d können Sie eine Kategorie (Knoten) löschen, für die es auf der Seite Konfiguration keinen Link Kategorie löschen gibt.

Beispiele

Konfigurationseinstellungen aus einer Datei mit dem Namen Product_config.xml im Verzeichnis conf in der Marketing Platform-Installation importieren.

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

Eine der bereitgestellten Campaign-Datenquellenvorlagen in die Campaign-Standardpartition, partition1, importieren. Bei dem Beispiel wird davon ausgegangen, dass Sie die Oracle-Datenquellenvorlage, OracleTemplate.xml, im Verzeichnis tools/bin in der Marketing Platform-Installation gespeichert haben.

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

Alle Konfigurationseinstellungen in eine Datei mit dem Namen myConfig.xml im Verzeichnis D:\backups exportieren.

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

Eine bestehende Campaign-Partition (komplett mit Datenquelleneinträgen) exportieren, in der Datei partitionTemplate.xml speichern und im Standardverzeichnis tools/bin unter der Marketing Platform-Installation speichern.

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

Eine Anwendung mit dem Namen "productName" mithilfe einer Datei namens app_config.xml, die sich im Standardverzeichnis tools/bin in der Marketing Platform-Installation befindet, manuell registrieren und das Überschreiben einer bestehenden Registrierung dieser Anwendung erzwingen.

configTool -r productName -f app_config.xml -o

Die Registrierung der Anwendung mit dem Namen "productName" aufheben.

configTool -u productName