configTool

Die Eigenschaften und Werte auf der Seite Konfiguration werden in den Systemtabellen gespeichert. Sie können das Dienstprogramm configTool verwenden, um Konfigurationseinstellungen aus den Systemtabellen zu importieren oder exportieren.

Einsatzmöglichkeiten für "configTool"

In den folgenden Situationen können Sie configTool verwenden:

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

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

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

Löschen von Kategorien, die nicht über den Link Kategorie löschen verfügen. Dabei verwenden Sie configTool, um die Konfiguration zu exportieren. Anschließend löschen Sie die XML-Datei, die die Kategorie erstellt, und verwenden configTool, um die bearbeitete XML-Datei zu importieren.

Dieses Dienstprogramm modifiziert die Tabellen usm_configuration und usm_configuration_values in der Marketing Platform-Systemtabellendatenbank, die die Konfigurationseinstellungen und die zugehörigen Werte enthalten. Um die besten Ergebnisse zu erzielen, erstellen Sie entweder Sicherheitskopien dieser Tabellen oder exportieren die aktuellen Konfigurationen mit configTool und sichern die so erstellte Datei. So haben Sie die Möglichkeit, die Konfiguration wiederherzustellen, falls der Import mit configTool fehlschlägt.

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 Konfigurationseinstellungen und den entsprechenden Einstellungen durch Festlegen eines Pfads in der Konfigurationseigenschaftenhierarchie.

Im Elementpfad müssen die internen Namen von Kategorien und Eigenschaften verwendet werden. Diese können Sie abrufen, indem Sie zur Seite Konfiguration navigieren, die gewünschte Kategorie oder Eigenschaft und den Pfad auswählen, der im rechten Fensterbereich in Klammern angezeigt wird. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaft mit dem Zeichen | und setzen ihn in doppelte Anführungszeichen.

Beachten Sie Folgendes:

Mit diesem Befehl können keine vollständigwn Anwendungen, sondern nur Kategorien und Eigenschaften in einer Anwendung gelöscht werden. Verwenden Sie den Befehl -u, um die komplette Registrierung einer Anwendung aufzuheben.

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 -d mit dem Befehl -vp verwenden, löscht das DienstprogrammconfigToolalle untergeordneten Knoten, die Sie im Pfad angegeben haben (falls diese Knoten nicht in der von Ihnen angegebenen XML-Datei enthalten sind).

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

Importieren von Konfigurationseinstellungen mit den entsprechenden Einstellungswerten aus einer festgelegten XML-Datei.

Zum Importieren geben Sie den Pfad zu dem übergeordneten Element an, unter welchem Sie die Kategorien speichern möchten. Das Dienstprogramm configTool importiert Eigenschaften in der Kategorie, die Sie im Pfad angegeben haben.

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

Im übergeordneten Elementpfad müssen die internen Namen von Kategorien und Eigenschaften verwendet werden. Diese können Sie abrufen, indem Sie zur Seite Konfiguration navigieren, die gewünschte Kategorie oder Eigenschaft und den Pfad auswählen, der im rechten Fensterbereich in Klammern angezeigt wird. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaft mit dem Zeichen | verwenden und setzen den Pfad in doppelte Anführungszeichen.

Sie können die Speicherposition der Importdatei relativ zum Verzeichnis tools/bin oder einen vollständigen Verzeichnispfad angeben. Unabhängig davon, ob Sie einen relativen Pfad oder keinen Pfad festlegen, sucht configTool die Datei zuerst in relativer Position zum Verzeichnis tools/bin.

Standardmäßig werden bestehende Kategorien nicht überschrieben. Falls Sie das wünschen, können Sie jedoch die Option -o verwenden.

-x -p "elementPath" -f exportFile

Exportieren von Konfigurationseinstellungen und deren Einstellungswerten in eine XML-Datei mit festgelegtem Namen.

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

Für den Elementpfad müssen die internen Namen der Kategorien und Eigenschaften verwendet werden. Diese können Sie abrufen, indem Sie zur Seite Konfiguration navigieren, die gewünschte Kategorie oder Eigenschaft und den Pfad auswählen, der im rechten Fensterbereich in Klammern angezeigt wird. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaft mit dem Zeichen | und setzen den Pfad in doppelte Anführungszeichen.

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

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

Dieser Befehl wird hauptsächlich bei manuellen Upgrades verwendet, um Konfigurationseigenschaften zu importieren. Wenn Sie ein Fixpack mit einer neuen Konfigurationseigenschaft angewendet haben und anschließend ein Upgrade durchführen, werden mit dem Importieren einer Konfigurationsdatei als Teil eines manuellen Upgradeprozesses Werte überschrieben, die festgelegt wurden, als das Fixpack angewendet wurde. Der Befehl -vp verhindert, dass mit dem Import zuvor festgelegte Konfigurationswerte überschrieben werden.

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

-r productName -f registrationFile

Registrieren der Anwendung. Die Speicherposition der Registrierungsdatei kann relativ zum Verzeichnis tools/bin oder als vollständiger Verzeichnispfad angegeben werden. Standardmäßig werden bestehende Konfigurationen nicht überschrieben. Falls Sie dies jedoch wünschen, können Sie die Option -o verwenden. Der Parameter productName muss einer der oben aufgeführten Namen sein.

Beachten Sie Folgendes:

Wenn Sie den Befehl -r verwenden, muss der erste Tag in der XML-Datei der Registrierung <application> sein.

Zusammen mit dem Produkt können andere Dateien zur Verfügung gestellt werden, mit deren Hilfe Sie Konfigurationseinstellungen in die Marketing Platform-Datenbank einfügen können. Verwenden Sie für diese Dateien den Befehl -i. Nur die Datei, deren erster Tag <application> ist, kann mit dem Befehl -r verwendet werden.

Der Name der Registrierungsdatei für Marketing Platform ist Manager_config.xml und der erste Tag ist <Suite>. Um diese Datei in 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.

Verwenden Sie nach der Erstinstallation für die erneute Registrierung aller Produkte außer Marketing Platform configTool mit dem Befehl -r und -o, um die bestehenden Eigenschaften zu überschreiben.

Das Dienstprogramm configTool verwendet Produktnamen als Parameter mit den Befehlen, die zur Registrierung und Aufhebung von Produktregistrierungen eingesetzt werden. Mit dem Release 8.5.0 von IBM® EMM haben sich viele Produktnamen geändert. Die in configTool verwendeten 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 die 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

Registrierung einer mit productName angegebenen Anwendung aufheben. Sie müssen der Produktkategorie keinen Pfad hinzufügen, der Produktname ist ausreichend und erforderlich. Der Prozess entfernt alle Eigenschaften und Konfigurationseinstellungen für das Produkt.

Optionen

-o

Überschreibt in Verbindung mit -i oder -r eine bestehende Kategorie oder Produktregistrierung (Knoten).

Bei Verwendung mit -d können Sie eine Kategorie (Knoten) löschen, die auf der Seite Konfiguration keinen Link Kategorie löschen enthält.

Beispiele

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

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

Exportieren einer bestehenden Campaign-Partition (vollständig, mit Datenquelleneinträgen), Speichern in der Datei partitionTemplate.xml und Speichern im Standardverzeichnis tools/bin unter der Marketing Platform-Installation.

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

Manuelles Registrieren der Anwendung "productName" mit der Datei app_config.xml, die im Standardverzeichnis tools/bin unter der Marketing Platform-Installation gespeichert ist, und Überschreiben einer bestehenden Registrierung dieser Anwendung.

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

Aufheben der Registrierung einer Anwendung "productName".

configTool -u productName