configTool

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

Verwendung von configTool

Die Verwendung von configTool empfiehlt sich bei folgenden Aufgaben:

Zum Importieren von im Lieferumfang von Campaign enthaltenen Partitions- und Datenquellenvorlagen, die Sie anschließend auf der Seite Konfiguration ändern und duplizieren können

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

Zum Exportieren einer XML-Version der Konfigurationseinstellungen zu Sicherungszwecken oder zum Importieren in eine andere Installation von IBM EMM

Zum Löschen von Kategorien, die nicht den Link Kategorie löschen aufweisen. Dazu exportieren Sie mit configTool Ihre Konfiguration, löschen dann manuell die XML-Datei, die die Kategorie erstellt, und importieren mit configTool die bearbeitete XML-Datei.

Dieses Dienstprogramm ändert die Tabellen usm_configuration und usm_configuration_values in der Marketing Platform-Systemtabellendatenbank, die die Konfigurationseigenschaften und deren Werte enthalten. Die besten Ergebnisse erzielen Sie, wenn Sie entweder Sicherungskopien dieser Tabellen erstellen oder die vorhandenen Konfiguration mit configTool exportieren und die Ergebnisdatei sichern, um die Konfiguration wiederherstellen zu können, falls beim Importieren mit configTool ein Fehler auftritt.

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öscht Konfigurationseigenschaften und deren Einstellungen und gibt einen Pfad in der Konfigurationseigenschaftshierarchie an.

Der Elementpfad muss die internen Namen von Kategorien und Eigenschaften verwenden. Diese können Sie abrufen, indem Sie die Seite Konfiguration öffnen, die gewünschte Kategorie oder Eigenschaft auswählen und den Pfad beachten, der im rechten Bereich in Klammern angezeigt wird. Verwenden Sie zur Begrenzung eines Pfads in der Konfigurationseigenschaftshierarchie das Zeichen | und schließen Sie den Pfad in doppelte Anführungszeichen ein.

Folgendes beachten:

Mit diesem Befehl können nur Kategorien und Eigenschaften in einer Anwendung gelöscht werden, nicht die ganze Anwendung. Verwenden Sie den Befehl -u, um die Registrierung einer ganzen Anwendung aufzuheben.

Zum Löschen von Kategorien, die nicht den Link Kategorie löschen auf der Seite Konfiguration aufweisen, müssen Sie die Option -o verwenden.

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

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

Importiert Konfigurationseigenschaften und deren Einstellungen aus einer angegebenen XML-Datei.

Geben Sie zum Importieren einen Pfad zu dem übergeordneten Element an, unter dem Sie Ihre Kategorien importieren wollen. Das Dienstprogramm configTool importiert Eigenschaften unter der Kategorie, die Sie im Pfad angeben.

Sie können Kategorien auf einer beliebigen Ebene unterhalb der höchsten Ebene hinzufügen, jedoch keine Kategorie auf derselben Ebene wie die oberste Kategorie.

Der Pfad des übergeordneten Elementpfads muss die internen Namen von Kategorien und Eigenschaften verwenden. Diese können Sie abrufen, indem Sie die Seite Konfiguration öffnen, die erforderliche Kategorie oder Eigenschaft auswählen und den Pfad beachten, der im rechten Bereich in Klammern angezeigt wird. Verwenden Sie zur Begrenzung eines Pfads in der Konfigurationseigenschaftshierarchie das Zeichen | und schließen Sie den Pfad in doppelte Anführungszeichen ein.

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

Standardmäßig überschreibt dieser Befehl eine vorhandene Kategorie nicht, aber mit der Option -o können Sie die Überschreibung erzwingen.

-x -p "elementPath" -f exportFile

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

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

Sie können eine Speicherposition der Exportdatei relativ zum aktuellen Verzeichnis oder einen vollständigen Verzeichnispfad angeben. Wenn in der Dateiangabe kein Trennzeichen (/ unter UNIX™, / oder \ unter Windows™) enthalten ist, schreibt configTool die Datei in das Verzeichnis tools/bin in Ihrer 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 zum Importieren von Konfigurationseigenschaften verwendet. Wenn Sie ein Fixpack angewendet haben, das eine neue Konfigurationseigenschaft enthält, und dann ein Upgrade durchführen, kann das Importieren einer Konfigurationsdatei im Rahmen eines manuellen Upgrades bewirken, dass bei der Anwendung des Fixpacks festgelegte Werte überschrieben werden. Mit dem Befehl -vp wird sichergestellt, dass der Import keine zuvor festgelegten Konfigurationswerte überschreibt.

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

-r productName -f registrationFile

Registriert die Anwendung. Die Speicherposition der Registrierungsdatei kann relativ zum Verzeichnis tools/bin oder mit einem vollständigen Pfad angegeben werden. Standardmäßig überschreibt dieser Befehl eine vorhandene Konfiguration nicht, aber mit der Option -o können Sie die Überschreibung erzwingen. Der Parameter productName muss einer der oben aufgeführten Namen sein.

Folgendes beachten:

Bei Verwendung des Befehls -r muss die Registrierungsdatei <application> als erster Tag in der XML-Datei enthalten.

Im Lieferumfang Ihres Produkts können andere Dateien enthalten sein, mit denen Sie Konfigurationseigenschaften 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.

Die Registrierungsdatei für Marketing Platform hat die Bezeichnung Manager_config.xml und der erste Tag ist <Suite>. Registrieren Sie diese Datei bei einer Neuinstallation mit dem Dienstprogramm populateDb oder führen Sie das Installationsprogramm von Marketing Platform erneut aus, wie im IBM Marketing Platform-Installationshandbuch beschrieben.

Verwenden Sie nach der Erstinstallation zur erneuten Registrierung von anderen Produkten als Marketing Platform das Dienstprogramm configTool mit dem Befehl -r und mit -o, um die vorhandenen Eigenschaften zu überschreiben.

Das Dienstprogramm configTool verwendet Produktnamen als Parameter bei den Befehlen zur Registrierung von Produkten und zur Aufhebung der Registrierung. Mit dem Release 8.5.0 von IBM EMM haben sich viele Produktnamen geändert. Die von configTool erkannten Namen wurden jedoch nicht geändert. Die gültigen Produktnamen, die mit configTool verwendet werden können, sowie die aktuellen Namen der Produkte sind unten aufgeführt.

Produktnamen zur Registrierung bzw. Aufhebung der Registrierung durch 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

Hebt die Registrierung einer mit productName angegebenen Anwendung auf. Sie brauchen keinen Pfad zur Produktkategorie anzugeben. Der Produktname ist erforderlich und ausreichend. Bei dem Prozess werden alle Eigenschaften und Konfigurationseinstellungen des Produkts entfernt.

Optionen

-o

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

Bei Verwendung mit -d können Sie eine Kategorie (Knoten) löschen, die nicht den Link Kategorie löschen auf der Seite Konfiguration aufweist.

Beispiele

Importieren Sie Konfigurationseinstellungen aus einer Datei namens Product_config.xml in das Verzeichnis conf in der Marketing Platform-Installation.

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

Importieren Sie eine der bereitgestellten Campaign-Datenquellenvorlagen in die Campaign-Standardpartition 'partition1'. In dem Beispiel wird vorausgesetzt, dass Sie die Oracle-Datenquellenvorlage OracleTemplate.xml im Verzeichnis tools/bin in der Marketing Platform-Installation platziert haben.

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

Exportieren Sie alle Konfigurationseinstellungen in eine Datei namens myConfig.xml im Verzeichnis D:\backups.

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

Exportieren Sie eine vorhandene Campaign-Partition (mit Datenquelleneinträgen), speichern Sie sie in einer Datei namens partitionTemplate.xml im Standardverzeichnis tools/bin in der Marketing Platform-Installation.

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

Registrieren Sie eine Anwendung namens productName manuell mithilfe einer Datei namens app_config.xml im Standardverzeichnis tools/bin in der Marketing Platform-Installation und erzwingen Sie die Überschreibung einer vorhandenen Registrierung dieser Anwendung durch diese Datei.

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

Heben Sie die Registrierung einer Anwendung namens productName auf.

configTool -u productName