IBM TM1 Planning Analytics Upgrade per Skript

IBM TM1 Planning Analytics Upgrade per Skript – geht das? Kurze Antwort: Ja! Wie das funktioniert und worauf man achten sollte, möchte ich im Folgenden erläutern.

Backup der Konfigurationen

Die meisten TM1 Installationen sind sicherlich auf Windows Servern anzutreffen, möglicherweise wurden Windows IIS Server für die Cognos Authentifizierung konfiguriert und sicherlich wurden einige Dateien in den IBM Installationsverzeichnissen editiert, um z.B. TM1 Web und Planning Analytics Workspace zu konfigurieren.

Im Nachhinein nun alle notwendigen Konfigurationen, z.B. in der pmhub.html eingetragene URLs und spezifische Konfigurationen in *.properties zu finden und zu sichern, macht wenig Spaß. Selten kann man eine neue/plain Installation mit dem Windows Server für die PROD vergleichen, also muss man manuell suchen – weitere Tipps, zur Planung und Vorbereitung eines TM1 Planning Analytics Upgrade.

Der Aufwand soll sich lohnen (und einmalig bleiben), also schreiben wir alle angepassten Dateien und Konfigurationen inkl. dem Dateipfad auf und bereiten das Skript vor. Tipp: z.B. im Installationsverzeichnis für den PA Spreadsheet Service gibt eine „preservered“ Datei – hier sind alle Dateien aufgelistet, die grundsätzlich vor einem TM1 Planning Analytics Upgrade gesichert werden sollten.

Das Skript (z.B.: upgrade.bat) kann wie folgt aussehen:

:: Backup Ordner erstellen

MKDIR "C:\ibm\cognos\backup_upgrade\tm1web\configuration\"
MKDIR "C:\ibm\cognos\backup_upgrade\tm1web\webapps\tm1web\WEB-INF\configuration\"
MKDIR "C:\ibm\cognos\backup_upgrade\tm1web\jre\lib\security\"
MKDIR "C:\ibm\cognos\backup_upgrade\tm1web\bin64\ssl\"
MKDIR "C:\ibm\cognos\backup_upgrade\tm1web\wlp\usr\servers\tm1web\"

MKDIR "C:\ibm\cognos\backup_upgrade\cognos\webcontent\"
MKDIR "C:\ibm\cognos\backup_upgrade\cognos\webcontent\bi\"
MKDIR "C:\ibm\cognos\backup_upgrade\cognos\webcontent\tm1\web\"


:: tm1web - spreadsheet service
:: Files and directories to be preserved during an upgrade - lt. tm1preserved Datei, danke IBM!

COPY "C:\ibm\cognos\tm1web\configuration\tm1preserved.txt" "C:\ibm\cognos\backup_upgrade\tm1web\configuration\"
COPY "C:\ibm\cognos\tm1web\configuration\coglocale.xml" "C:\ibm\cognos\backup_upgrade\tm1web\configuration\"
COPY "C:\ibm\cognos\tm1web\webapps\tm1web\WEB-INF\configuration\tm1web_config.xml" "C:\ibm\cognos\backup_upgrade\tm1web\webapps\tm1web\WEB-INF\configuration\"
COPY "C:\ibm\cognos\tm1web\webapps\tm1web\WEB-INF\web.xml" "C:\ibm\cognos\backup_upgrade\tm1web\webapps\tm1web\WEB-INF\"
COPY "C:\ibm\cognos\tm1web\jre\lib\security\cacerts" "C:\ibm\cognos\backup_upgrade\tm1web\jre\lib\security\"
COPY "C:\ibm\cognos\tm1web\bin64\ssl\tm1store" "C:\ibm\cognos\backup_upgrade\tm1web\bin64\ssl\"
COPY "C:\ibm\cognos\tm1web\bin64\ssl\ibmtm1.crl" "C:\ibm\cognos\backup_upgrade\tm1web\bin64\ssl\"
COPY "C:\ibm\cognos\tm1web\bin64\ssl\ibmtm1.kdb" "C:\ibm\cognos\backup_upgrade\tm1web\bin64\ssl\"
COPY "C:\ibm\cognos\tm1web\bin64\ssl\ibmtm1.rdb" "C:\ibm\cognos\backup_upgrade\tm1web\bin64\ssl\"
COPY "C:\ibm\cognos\tm1web\bin64\ssl\ibmtm1.sth" "C:\ibm\cognos\backup_upgrade\tm1web\bin64\ssl\"
COPY "C:\ibm\cognos\tm1web\wlp\usr\servers\tm1web\jvm.options" "C:\ibm\cognos\backup_upgrade\tm1web\wlp\usr\servers\tm1web\"
COPY "C:\ibm\cognos\tm1web\wlp\usr\servers\tm1web\server.xml" "C:\ibm\cognos\backup_upgrade\tm1web\wlp\usr\servers\tm1web\"
COPY "C:\ibm\cognos\tm1web\wlp\usr\servers\tm1web\bootstrap.properties" "C:\ibm\cognos\backup_upgrade\tm1web\wlp\usr\servers\tm1web\"


:: Cognos Analytics webcontent bzw. Login

COPY "C:\ibm\cognos\analytics\webcontent\pmhub.html" "C:\ibm\cognos\backup_upgrade\cognos\webcontent\pmhub.html"
COPY "C:\ibm\cognos\analytics\webcontent\planning.html" "C:\ibm\cognos\backup_upgrade\cognos\webcontent\planning.html"
COPY "C:\ibm\cognos\analytics\webcontent\bi\pmhub.html" "C:\ibm\cognos\backup_upgrade\cognos\webcontent\bi\pmhub.html"
COPY "C:\ibm\cognos\analytics\webcontent\bi\planning.html" "C:\ibm\cognos\backup_upgrade\cognos\webcontent\bi\planning.html"
:: hier findet sich URL Whitelisting
COPY "C:\ibm\cognos\analytics\webcontent\tm1\web\tm1web.html" "C:\ibm\cognos\backup_upgrade\cognos\webcontent\tm1\web\tm1web.html"

Vorsicht! Ohne Sichtprüfung sollten die aktualisierten Dateien nicht mit den Backups überschrieben werden. Die analoge Ordnerstruktur für die Backups hilft den Überblick zu behalten.

Stille Installation unattended install

Die IBM Installer sind bereits für das Ausführen per Skript vorbereitet, z.B. hier erläutert. Lediglich die *.ats Datei ist anzupassen und dann kann die Installation wie folgt gestartet werden.

:: unattended IBM Installation
:: C:\ibm\cognos\tm1_64\instlog hier das *.ats File anpassen
:: <install dir>\issetup -s location\filename.ats

@echo IBM Installer running...

C:\Install\PA_Upgrade\tm1_winx64h_2.0.914.2_ml\winx64h\issetup -s C:\Install\PA_Upgrade\tm1_winx64h_2.0.914.2_ml\winx64h\response.ats

@echo IBM Installer done!

Erledigt – fertig ist das Upgrade! Nicht ganz, aber fast.

Was ist nach Upgrade von TM1 Planning Analytics zu erledigen?

• Prüfen der vorher gesicherten Konfigurationsdateien
• IBM TM1 Planning Analytics Dienste wieder starten
• Verwendete Clients, wie TM1 Architect, Planning Analytics for Excel und Co. für die Softwareverteilung paketieren und den Kolleg:innen bereitstellen

Wie weit kann ich das TM1 Planning Analytics Upgrade noch automatisieren?

Natürlich kann es nach einem Upgrade trotz bester Vorbereitung „irgendwo nicht rund laufen“. Ärgerlich, wenn das Upgrade Skript bereits auf den nächsten Server läuft und z.B. der Fehler im Anmeldemechanismus erst bei den Controller:innen auffällt.

Um die Automatisierung vorzubereiten, fragen wir uns – was muss ich nach einem Upgrade eigentlich testen und wie arbeiten meine Kolleg:innen mit Planning Analytics? Falls im Team z.B. Python Kenntnisse (zu Unit Testing von Web Applications) vorhanden sind, können wir einige Tests automatisieren:

• Sind die Web Komponenten erreichbar?
• Kann sich testuser@winAD-domain.de erfolgreich anmelden
• …

Aber wofür der ganze Aufwand, wenn das TM1 Planning Analytics Upgrade manuell auch fix geht? Nun ja, alle drei bis sechs Monate veröffentlicht die IBM aktualisierte TM1 Planning Analytics Komponenten, Planning Analytics Workspace sogar monatlich. Mindestens einmal im Jahr würde ich auch vermeintlich kleine Planungsanwendungen aktualisieren, zum einen weil Fehler korrigiert und neue Features ausgerollt werden. Vor allem aber unterstützen die regelmäßigen Updates der Features mich dabei die TM1 Modelle schlank zu halten und mich von „alten Zöpfen“ zu trennen – ehe die Komplexität des Modells einen effizienten Planungsprozess negativ beeinflusst.