Prozedur: Schnelles Upgrade von Unica Plan

Plan Vor-Upgrade

Warum und wann dieser Vorgang ausgeführt wird

Anmerkung:
  1. Bestehende Kunden, die ein Upgrade auf JBoss + 12.1 durchführen möchten, müssen die folgenden Schritte durchführen:
    • Die letzten Einträge für alle Benutzer löschen. Anmerkung: Administrator: Bitte teilen Sie allen Benutzern mit, dass sie vor der Migration zu JBoss ihre jeweiligen letzten Einträge löschen müssen.
    • Löschen Sie das Verzeichnis <PLAN_HOME>/recentdata .
    • Migrieren Sie auf JBoss + 12.1.
  2. Für Neukunden, die JBoss + 12.1 installieren, ist keine Änderung erforderlich. Der Grund dafür ist, dass bei ihnen keine aktuellen Elemente vorhanden sind.

Führen Sie bei einem Plan vor dem Upgrade die folgenden Schritte aus:

Prozedur

  1. Import the plan system tables backup from the old version to the system tables schema used in a clean 12.1 environment.
  2. Machen Sie ein Dateisystem-Backup der Quelle und des Ziels der folgenden Ordner:

    <PLAN_HOME>/accountattachments-Verzeichnis.

    <PLAN_HOME>/approvalitems-Verzeichnis.

    <PLAN_HOME>/assets-Verzeichnis.

    <PLAN_HOME>/componentattachments-Verzeichnis.

    <PLAN_HOME>/images-Verzeichnis.

    <PLAN_HOME>/invoiceattachments-Verzeichnis.

    <PLAN_HOME>/planattachments-Verzeichnis.

    <PLAN_HOME>/programattachments-Verzeichnis.

    <PLAN_HOME>/projectattachments-Verzeichnis.

    <PLAN_HOME>/templates-Verzeichnis.

  3. Kopieren Sie alle in Schritt 2 in 12.1 erwähnten Dateien aus den Quellordnern in die jeweiligen Zielordner von Plan bzw. führen Sie sie darin zusammen.
  4. Wenn Sie in der Quellversion die plan_log4j.xml-Datei und die plan_ehcache.xml-Datei angepasst haben, kopieren Sie die plan_log4j.xml-Datei und die plan_ehcache.xml-Datei in den Plan_HOME/conf-Ordner der Zielumgebung.
    Folgende Richtlinien sollten beachtet werden:
    • Stellen Sie für die plan_log4j.xml-Datei sicher, dass die plan_log4j.xml-Datei den log4j2 Konventionen entspricht, wenn die Quellversion älter als 11.1.0 ist. Weitere Informationen finden Sie im Unica Plan Installationshandbuch.
    • Stellen Sie bei der plan_ehcache.xml-Datei sicher, dass Sie das Attribut-Wert-Paar name="PlanEhCacheManager" hinzufügen, wie im folgenden Beispiel gezeigt, falls es nicht vorhanden ist:
      <ehcache updateCheck="false" name="PlanEhCacheManager">
    Anmerkung: Sie können Schritt 4 ignorieren, wenn Sie keine Änderungen an der plan_log4j.xml-Datei und der plan_ehcache.xml-Datei in der Quellversion vorgenommen haben und die Zieldatei ohne Änderungen beibehalten möchten.
  5. Benennen Sie den ext-Ordner auf dem Zielserver unter dem Pfad <PLAN_HOME>/messages/com/hcl/umo/ in ext_data um.
  6. Kopieren Sie für die Unica Plan-Version vor 12.0 den ext-Ordner vom Quellspeicherort <PLAN_HOME>/messages/com/ibm/umo/ und fügen Sie ihn am Zielspeicherort <PLAN_HOME>/messages/com/hcl/umo/ ein. Kopieren Sie für die Unica Plan-Version 12.0 und höher den ext-Ordner vom Quellspeicherort <PLAN_HOME>/messages/com/hcl/umo/ und fügen Sie ihn am Zielspeicherort <PLAN_HOME>/messages/com/hcl/umo/ ein.
  7. Wenn das Quell-Setup Marketingobjekte enthält, kopieren Sie die folgenden Dateien vom Quellspeicherort <PLAN_Home>/conf/en_US zum Zielspeicherort. mo_creatives_state.xml globalstates.xml sysmenu.xml sysmodules.xml
  8. Ändern Sie in <PLAN_HOME>/conf/xx_XX/sysmenu.xml (wobei xx_XX die Ländereinstellung ist) den Wert von <display> in Plan (siehe folgenden xml-Abschnitt). 
    <sysmenu>
     <menugroups>
        <default-startup-item>projectmanagement</default-startup-item>
             <menugroup id='projectmanagement'>
           <display>Plan</display>
  9. Wenn in <PLAN_HOME>/conf/resourcebundles/com/unica/manager/configuration/plan*.properties-Dateien die Version der vorhandenen Unica Plan-Installation vor 12.0 liegt, aktualisieren Sie den Wert von MARKETING_OPERATIONS_SETTINGS auf Plan settings.
  10. Ändern Sie in <PLAN_HOME>/conf/en_US/sysmodules.xml (wobei en_US die Ländereinstellung ist) den Wert von <display> in Plan (siehe folgenden xml-Abschnitt).

    Führen Sie die folgenden Befehle aus unter:

    <sysmodules>
      <section>
           <module id='Analytics'>
                <display>Plan analytics</display>
  11. Führen Sie den folgenden Befehl aus, um die Plankonfiguration zu registrieren: 
    ./configTool.sh -vp -p "Affinium" -f“ <PLAN_HOME>/conf/plan_registration.xml
  12. Stellen Sie sicher, dass die folgenden JVM-Parameter vorhanden sind. Wenn nicht, fügen Sie sie hinzu:
    • Fügen Sie für Version 12.1.0, 12.1.0.1, 12.1.0.2 und 12.1.0.3 die folgenden Parameter hinzu:
      • -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
      • -Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
      • -Dlog4j.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
    • Bei Version 12.1.0.4 fügen Sie, wenn Sie installieren, die folgenden Parameter hinzu. Wenn Sie ein Upgrade von Version 12.1.0 oder höher durchführen, entfernen Sie die oben erwähnten Parameter und fügen Sie die folgenden Parameter hinzu:
      • -Dlog4j.configuration=file:///<Plan_home>\conf\plan_log4j_1x.xml
      • -Dplan.log4j.config=<Plan_home>\conf\plan_log4j.xml
      • -Dplan.log4j.async=true (If not set, deafults to true)
    Anmerkung:
    • Wenn Sie in der Einstellung Dlog4j2.configurationFile=file:///<PLAN_HOME>\conf\plan_log4j.xml die Einstellung plan_log4j.xml angepasst und einige Änderungen vorgenommen haben, um sie an Ihr Unternehmen anzupassen, dann stellen Sie sicher, dass Sie diese Einstellungen in der hier angegebenen plan_log4j.xml gemäß der Dlog4j2.configurationFile vornehmen, die wir jetzt für Sie bereitgestellt haben.
    • Stellen Sie sicher, dass die xml-Datei, auf die log4j2.configurationFile und log4j.configurationFile zeigen, identisch ist und der log4j2-Syntax folgt. Die Datei muss oben die folgenden zwei Zeilen enthalten:
      <?xml version="1.0" encoding="UTF-8"?>
<Configuration packages="com.unica.afc.logger" monitorInterval="60">
    • In Windows enthält der Dateipfad einen Schrägstrich, während er unter UNIX einen Schrägstrich enthalten muss.
    • Stellen Sie sicher, dass Sie den Plan-Anwendungsserver neu starten und die Menüs synchronisieren.

Unica Plan aktualisieren

JDBC-Dateien aktualisieren

Warum und wann dieser Vorgang ausgeführt wird

Falls Sie das in der 12.1-Clean-Installation verwendete Plan-Schema nicht wiederverwenden möchten und lieber ein anderes Benutzerschema verwenden möchten, folgen Sie den weiteren Schritten unten:

Prozedur

  1. Sichern Sie die jdbc.properties Datei aus der 12,1-Umgebung ( Plan/tools/bin/umo_jdbc.properties ). Aktualisieren Sie den Benutzernamen in der 12.1-Platform-Systemdatenbank / Schemaname in der umo_jdbc.properties-Datei.
    Beispiel für umo_jdbc.properties :

    Name: umo_data_source.url

    Beschreibung: #URL-Referenz für die Unica-Plan-System-Tabellendatenbank.

    Beispielwerte für unterstützte Datenbanken sind:

    SQL-Server: jdbc:sqlserver://sqlserverHost:1433;databaseName=databaseName

    IBM DB2: jdbc:db2://db2Host:50000/databaseName

    Oracle: jdbc:oracle:thin:@oracleHost:1521:databaseName

    umo_data_source.url=jdbc:oracle:thin:@<databaseHostName>:1521:<sid>

    Name: umo_data_source.login

    Beschreibung: Name der Anmeldung für die Unica Plan-Datenbank. Das Anmeldekonto muss über Administratorrechte für die Datenbank verfügen.

    Name der Anmeldung für die Unica Plan-Datenbank. Das Anmeldekonto muss über Administratorrechte für die Datenbank verfügen.

    umo_data_source.login=xmsp

    Name: umo_data_source.password

    Beschreibung: Kennwort für die Unica Plan-Datenbank für die Anmelde-ID in der Eigenschaft „umo_data_source.login“

    umo_data_source.password=ENC(+1Kd731xEuzqdDfqjQ9wnw==)

    Anmerkung: Wenn Sie denselben Benutzer in der Platform und in Plan verwendet haben, können Sie das verschlüsselte Kennwort aus der Datei Platform/tools/bin/jdbc.properties entnehmen.
  2. Aktualisieren Sie unter <PLAN_HOME>/tools/bin die Datei „setenv.bat“ mit dem korrekten DB-Treiberpfad für den Parameter DBDRIVER_CLASSPATH.

Upgrade auf 12.1 config

Warum und wann dieser Vorgang ausgeführt wird

Anmerkung: Dieses Verfahren gilt nicht für das schnelle Upgrade von Version 12.0 auf Version 12.1.

Prozedur

  1. Fügen Sie jBoss-logging-3.3.2.Final.jar und im Klassenpfad classmate-1.3.4.jar in setenv hinzu. Diese Dateien befinden sich in <Platform_HOME>/tools/lib.

    Zum Beispiel: Sie können wie folgt im Klassenpfad hinzufügen

    ${TOOLS_LIB}/../../../Platform/tools/lib/jboss-logging-3.3.2.Final.jar:${TOOLS_LIB}/../../../Platform/tools/lib/classmate-1.3.4.jar

  2. Führen Sie die folgenden Befehle unter Platform_Home/tools/bin aus.

    ./configTool.sh -vp -p "Affinium|Plan|umoConfiguration" -f <PLAN_HOME>/conf/plan_approvals_settings_10.0.0.2.xml

    ./configTool.sh -vp -p "Affinium|Plan|umoConfiguration" -f <PLAN_HOME>/conf/plan_workflowservice_settings_10.0.0.2.xml

  3. config_migration.sh in <PLAN_HOME>/tools/bin ausführen. Voraussetzung: Richten Sie <UMO_HOME> in der config_migration.sh-Datei ein oder aktualisieren Sie dies.

    ./config_migration.sh -p -b 8.6.0.0 (Ersetzen Sie 8.6 durch Ihre bestehende Quellversion).

  4. Führen Sie den folgenden Befehl aus, um die encodeCSV-Funktion zu aktivieren:

    configTool -vp -p "Affinium|Plan|umoConfiguration" -f <PLAN_HOME>\conf\Plan_encodeProperty_11.1.xml

    Anmerkung: Stellen Sie sicher, dass die jdbc.properties Datei innerhalb der <PLAN_HOME>/install Position auf die entsprechenden Unica Platform Datenbank verweist.

Upgrade der Plan-Datenbank

Prozedur

  1. Importieren Sie die Datenbank mit den Quellsystemtabellen der VM, die die Neuinstallation von 12.1 Plan enthält.
    1. Führen Sie das Dienstprogramm aus <PLAN_HOME>/tools/bin aus, um das UMOConfigurationMessages_<locale>.properties und das UMOMktObjectConfigurationMessages_<locale>.properties von 8,6 und 12,1 zu verschmelzen. Dieses Dienstprogramm verfügt über keine Parameter: umouilistupgrade.batFühren Sie die Schritte im Abschnitt aus.
    2. Führen Sie das Dienstprogramm umodbsetup aus, um die Datenbank auf 12.1 zu aktualisieren: umodbsetup.bat –t upgrade –m –b 8.6 –L en_USFühren Sie die Schritte im Abschnitt aus. Geben Sie den obigen Befehl in die Eingabeaufforderung ein. Das Kopieren kann zu einem Fehler führen.
    3. Führen Sie den Befehl aus: umodbsetup.bat –t upgrade –b 8.6 Führen Sie die Schritte im Abschnitt aus. Wenn dies nicht funktioniert, können Sie die Datei „umo_upgrade_[8.6.0.0.0]_[12.1.0.0].sql“ in der Plan-Datenbank ausführen. Diese Datei befindet sich im Verzeichnis <PLAN_HOME>\tools\bin.
      Anmerkung: Ersetzen Sie 8.6 durch Ihre bestehende Quellversion.
  2. Wenn die Version des Zielsystems 12.0.0 oder höher ist, führen Sie die folgende Abfrage auf Platform Datenbank aus, um den Namen des Knotens für den Marketingoperationen in Platform Konfigurationen zu aktualisieren: 
    UPDATE usm_configuration SET display_name='Plan' where internal_name='Plan' and display_name_key='Marketing Operations'

Unica Plan nach dem Upgrade

Konfigurationsänderungen von Unica Plan

Warum und wann dieser Vorgang ausgeführt wird

Stellen Sie die WAR-Datei für Unica Plan 12.1.0 bereit und führen Sie das Unica Plan Java-Upgrade wie folgt aus:
Anmerkung:

Informationen zum log4j-Upgrade

Vor 11,1 log4j1x wurde die API von der Plansquelle verwendet.

Für 11,1 und spätere Versionen

  • Die Syntax von <PLAN_HOME>/conf/plan_log4j.xml wurde in Format log4j2 geändert.
    Die Konfigurationsdatei enthält oben die folgenden Zeilen:
    <?xml version="1.0" encoding="UTF-8"?>
<Configuration packages="com.unica.afc.logger" monitorInterval="60">

    Wenn Sie vor dem Upgrade auf 12.1 die Unica Plan-Version auf 11.1 aktualisiert haben, ist am Speicherort <PLAN_HOME>/conf/ eine Datei plan_log4j.11.1.0.0.xml verfügbar, die die zuvor erwähnte Syntax enthält.

    In diesem Fall entspricht die Syntax der Datei plan_log4j.xml am <PLAN_HOME>/conf/-Speicherort nicht dem log4j2-Format

    In einem solchen Fall sollte die Datei plan_log4j.11.1.0.0.xml in den folgenden Eigenschaften verwendet werden:
    • -Dlog4j2.configurationFile
    • -Dlog4j.configurationFile
    Anmerkung:
    Bei 12.1.0.4 sollte plan_log4j.11.1.0.0.xml in den folgenden Eigenschaften verwendet werden:
    • -Dplan.log4j.config=<Plan_home>\conf\plan_log4j.11.1.0.0.xml
  • log4j2x API wird von Plansquelle verwendet.
  • log4j1x API wird immer noch von „unica_common.jar“ innerhalb von Plan JVM verwendet, da die Plattformquelle (was zu unica_common führt) nicht geändert wurde, um log4j2x zu verwenden. Aus diesem Grund stellen wir die plan_log4j_1x.xml (gemäß log4j1x der Syntax) zur Verfügung. Diese Datei wird vom Quellcode in Unica Plan nicht verwendet (gilt nur bis Version 12.1.0.3 und nicht danach).

Prozedur

  1. Melden Sie sich als Benutzer mit Administratorberechtigung an.
  2. Aktualisieren Sie in (Affinium|Einfach|umoConfiguration) den Speicherort für die unten aufgeführten Knoten:

    Vorlagen

    attachmentFolders

    integrationServices

  3. Aktualisieren Sie notifyPlanBaseURL in Affinium|Einfach|umoConfiguration|Benachrichtigungen.
  4. ServerURL in Affinium|Einfach|Navigation aktualisieren.
  5. Wenn sich die neue Anwendungs-URL von der alten unterscheidet, müssen Sie eine Verbindung zur Plan-Datenbank herstellen und auf die Tabelle „UAP_WS_ALERTS“ zugreifen. Die Datensätze in dieser Tabelle können die URL der Anwendung vor dem Upgrade enthalten. Sie müssen diese Tabelle aktualisieren und die alte Anwendungs-URL durch die neue ersetzen.
  6. Starten Sie den Anwendungsserver erneut.
  7. Gehen Sie zu Einstellungen > Plan > Plan-Upgrade.
  8. Aktivieren Sie alle Kontrollkästchen.
  9. Klicken Sie auf die Schaltfläche "Upgrade".
  10. Führen Sie die folgenden Schritte aus:
    1. Greifen Sie von sysmenu.xml der Position aus auf die Datei conf/locale zu.
    2. Wenn Sie conf/locale/<menugroup id="projectmanagement"> in der Datei finden, entfernen Sie den zugehörigen Abschnitt <menugroup id="Operations"> und benennen Sie <menugroup id="projectmanagement"> in <menugroup id="Operations"> um.
    3. Führen Sie Schritt b für alle Locales aus.
    4. Starten Sie die Plan-Webanwendung erneut.
    5. Navigieren Sie auf der Unica Platform-Homepage zu Einstellungen > Plan-Einstellungen
      Die Seite Verwaltungseinstellungen wird angezeigt.
    6. Wählen Sie innerhalb der Systemadministrationseinstellungen und innerhalb der Eingeschränkten Optionen Menüs synchronisieren aus.
  11. Starten Sie Unica Platform und Unica Plan erneut.

Einstellung des Plans - Hilfe Info > Version

Warum und wann dieser Vorgang ausgeführt wird

Ändern Sie die Planversion in der Registrierung von Unica-Platform:

Prozedur

  1. Exportieren Sie die Versionskonfiguration mit dem folgenden Befehl in einer sauberen 12.1-Umgebung.
    configTool.sh -x -p "Affinium|Plan|about" -f <PLATFORM_HOME>/conf/plan_about.xml
  2. Bearbeiten Sie die Datei plan_about.xml, die durch den obigen Befehl erzeugt wurde. Ändern Sie die Version auf „12.1.0.0.GA_BUILD“. 
    <property id="xxxxxx" name="releaseNumber" type="string_property" width="40"> 
<value>12.1.0.0.GA_BUILD</value>
</property> 
    Change display name as below:
 <property id="3214" name="displayName" type="string_property" width="40">
                <value>Unica Plan</value>
        </property>
  3. Importieren Sie die bearbeitete about.xml-Datei mit dem folgenden Befehl:
    configTool.sh -v -i -o -p "Affinium|Plan" -f <PLATFORM_HOME>/conf/plan_about.xml

Funktionsprüfung des Plans nach dem Upgrade

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie die UAT für die Plananwendung durch. Stellen Sie sicher, dass alle Pläne, Programme, Projekte, Aufgaben und Genehmigungen geöffnet sind und dass die Daten erfolgreich importiert werden. Stellen Sie sicher, dass alle Konfigurationsknoten verfügbar sind.

Konfigurieren Sie Unica Insights-Berichte mit Plan

Prozedur

Informationen zu Berichtspaketkonfigurationen finden Sie im Installations- und Konfigurationshandbuch für Unica Insights-Berichte.