Installationshandbuch › So führen Sie ein Upgrade von CA Business Service Insight durch

So führen Sie ein Upgrade von CA Business Service Insight durch

Für Systemadministratoren ist es wichtig, dass Sie CA Business Service Insight regelmäßig aktualisieren. Upgrades stellen sicher, dass Sie von allen neuen Funktionen und Fixes profitieren.

Die Upgrade-Datei erkennt, auf welchem Server das Programm ausgeführt wird, und aktualisiert die erforderlichen Dateien. Führen Sie als Erstes ein Upgrade für den Anwendungsserver durch, auf dem sich der Alarmservice befindet. Das Migrationsskript wird automatisch auf dem Anwendungsserver ausgeführt, der den Alarm-Service enthält.

Um ein Upgrade zu einer Umgebung mit mehreren Servern durchzuführen, führen Sie den Upgrade-Vorgang als Erstes für den Anwendungsserver durch. Führen Sie anschließend das Upgrade für den Webserver durch. Beim Upgrade des Anwendungsservers wird die Datenbankmigration automatisch ausgeführt.

Folgen Sie diesem Szenario, um den Prozess zu durchlaufen:

1. Überprüfen Sie die Voraussetzungen.
2. Sichern Sie Dateien und Ordner.
3. Bereiten Sie sich auf das Upgrade vor.
4. Überprüfen Sie das Vorhandensein der Website.
5. Führen Sie das Upgrade von CA Business Service Insight durch.
6. Schließen Sie das Upgrade ab.
7. (Optional) Aktualisieren Sie die Proxy-Zeichenfolge.
8. (Optional) Aktualisieren Sie die API.

Überprüfen der Voraussetzungen

Um sicherzustellen, dass Sie das Upgrade abschließen können, überprüfen Sie die folgenden Voraussetzungen:

• Version 7.0 SP1 oder höher von CA Business Service Insight ist installiert.
• Sie verfügen über SYSDBA-Zugriffsrechte.
• Jeder Tablespace in der Datenbank verfügt über mindestens 15 Prozent freien Speicher.

  Hinweis: Wenn "autoextend" aktiviert ist, stellen Sie sicher, dass die maximale Datendateigröße mindestens 15 Prozent über der aktuellen Größe der Datendatei liegt.

• Der freie Speicherplatz auf allen physischen Geräten, auf denen sich Datenbank-Tablespaces befinden, entspricht mindestens 15 Prozent der Gesamtgröße aller Tablespaces auf dem Gerät.
• Oracle OLEDB Provider ist auf Anwendungs- und Webservern installiert.

Sichern von Dateien und Ordnern

Um sicherzustellen, dass Sie während eines Upgrade keine Informationen verlieren, erstellen Sie Sicherheitskopien der folgenden Dateien und Ordner.

Hinweis: Um ein Rollback auszuführen, deinstallieren Sie alle Versionen, installieren Sie die Vorgängerversion, und importieren Sie die gesicherten Daten.

Gehen Sie wie folgt vor:

1. Erstellen Sie einen Speicherauszug der Datenbank.
2. Sicher Sie alle anwenderspezifischen Dateien. Folgende Dateien können anwenderspezifisch angepasst werden:
   • LoginCommon.asp
   • RedirectToLogin.asp
   • SilentLogin.asp
   • AcceptLogin.asp
   • Web.config
   • Registry.xml
   • Index.asp (für Single Sign-On)
   • logo.jpg
   • logo.gif
   • logobg.gif
   • logout1.gif
   • logout2.gif
   • Reportlogo (und andere Logos wie Dash- oder Berichtsexport)
3. (Optional) Sichern die das Sprachpaket.

Vorbereiten auf das Upgrade

Um den Erfolg des Upgrade sicherzustellen, führen Sie die folgenden Aufgaben aus, bevor Sie mit dem Upgrade beginnen.

Gehen Sie wie folgt vor:

1. Wenn Sie eine regionale Spracheinstellung verwenden, bei der es sich nicht um Englisch handeln, ändern Sie die Spracheinstellung in "Englisch (USA)" um.

   Hinweis: Die Verwendung einer anderen Spracheinstellung für das Upgrade kann Fehler verursachen.

2. Halten Sie alle Oblicore-Services an.
3. Halten Sie den Webserver in "IIS-Manager" an.

   Wichtig! Halten Sie den WWW-Dienst bzw. den IIS-Verwaltungsdienst nicht an.

4. Starten Sie den Distributed Transaction Coordinator-Service.

   Wichtig! Der Distributed Transaction Coordinator-Service ist nur für Upgrades erforderlich.

5. Führen Sie "oblicore_privs.sql" aus. Das Skript befindet sich auf der Installations-CD im Ordner "SetupDB\Migration".
6. Stellen Sie sicher, dass der Parameter "job_queue_processes" in der Datei "Init.ora" auf 2 gesetzt ist.

Überprüfen des Vorhandenseins der Website

Um sicherzustellen, dass die Website funktioniert, stellen Sie sicher, dass sie auf dem Server vorhanden ist. Wählen Sie die passende Option für Ihre Servertopologie.

Gehen Sie wie folgt vor:

Der Server wird ausschließlich als Anwendungsserver verwendet:

1. Öffnen Sie in der Registrierung auf dem Anwendungsserver den Eintrag: HKEY_LOCAL_MACHINE\SOFTWARE\Oblicore\Install Data.
2. Löschen Sie, wenn vorhanden, den Zeichenfolgenwert "WWWRootFolderLocation".

Der Server wird nicht ausschließlich als Anwendungsserver verwendet:

1. Öffnen Sie in der Registrierung auf dem Webserver oder Webservices-Server den Eintrag: HKEY_LOCAL_MACHINE\SOFTWARE\Oblicore\Install Data.
2. Stellen Sie sicher, dass der Zeichenfolgenwert "WWWRootFolderLocation" vorhanden ist.
3. Überprüfen Sie, ob die Daten für diesen Zeichenfolgenwert den Ordnerpfad für den Webordner enthalten.

Hinweis: Auf 64-Bit-Systeme ist der Eintrag: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432node\Oblicore\Install Data.

Durchführen des Upgrade von CA Business Service Insight

Um von neuen Funktionen in CA Business Service Insight zu profitieren, führen Sie ein Upgrade auf die aktuellste Version durch.

Gehen Sie wie folgt vor:

1. Doppelklicken Sie im Serverordner auf "Cloud_Insight_Server_8.2.5.exe", und klicken Sie auf "Weiter".
2. Wählen Sie die Installationssprache aus, und klicken Sie auf "OK".
3. Klicken Sie auf "Install".
4. Klicken Sie im Installationsassistenten auf "Weiter".
5. Akzeptieren Sie die Lizenzvereinbarung, und klicken Sie auf "Weiter".
6. Wählen Sie den Speicherort der Drittanbieter-CD aus, und klicken Sie auf "Weiter".
7. (Optional) Wählen Sie "Aufräumen" aus, und klicken Sie auf "Weiter", wenn Sie das Installationsprogramm auffordert, ältere JBoss-Komponenten zu bereinigen.

   Hinweis: Diese Aufforderung wird nur angezeigt, wenn eine Vorgängerversion von JBoss installiert ist.

   Das Upgrade-Dialogfeld wird öffnet und zeigt die Upgrade-Dialoge an.

8. Tippen Sie in jedem Dialogfeld, das geöffnet wird, den angeforderten Parameterwert ein, und klicken Sie auf "Weiter".

   Hinweis: Weitere Informationen finden Sie unter Sie Upgrade-Dialogfelder.

9. Überprüfen Sie die Richtigkeit der Einstellungen, und klicken Sie auf "Weiter".

   Die Installation wird gestartet.

   Wenn Sie "Migrationsskript ausführen" ausgewählt haben, befolgen Sie die Anweisungen.

10. Klicken Sie auf "Fertig stellen", um das Upgrade zu bestätigen.

    Das System wird neu gestartet.

Upgrade-Dialogfelder

Der Installationsassistent enthält Dialogfelder, die von CA Business Service Insight verwendet werden, um Informationen zu aktualisieren. Es werden nur jene Dialogfelder geöffnet, die für die Funktionen, die Sie auswählen, relevant sind.

In der folgenden Tabelle sind die Upgrade-Dialogfelder und die dazugehörigen Parameter und Werte aufgelistet:

Wichtig! Verwenden Sie keine Doppelbyte-Zeichen für Einträge, die mit einem Doppeldolch (‡) markiert sind.

Hinweis: Bestimmte Zeichen werden von der Namenskonvention von Oracle nicht unterstützt. Informationen zu spezifischen Anforderungen (z. B. ASCII) und Einschränkungen (z. B. Sonderzeichen und Doppelbyte-Zeichen) finden Sie im Dokumentationsmaterial von Oracle.

In der folgenden Tabelle sind Konfigurationsdateien und die dazugehörigen Parameter beschrieben.

Wichtig! Weisen Sie den Einträgen in der folgenden Konfigurationstabelle keine Doppelbyte-Zeichen zu.

Hinweis: Die Werte für Parameter, die mit einem Asterisk (*) gekennzeichnet sind, müssen mit einem einfachen Anführungszeichen anfangen und mit einem umgekehrten Schrägstrich und einem einfachen Anführungszeichen enden, z. B. ‘C:\Temp\’.

Abschließen des Upgrade

Um das Upgrade abzuschließen, führen Sie die folgenden Aufgaben aus.

Wichtig! Melden Sie sich nach dem CA Business Service Insight-Upgrade als sadmin an. Das Standardkennwort ist sadmin.

Gehen Sie wie folgt vor:

1. Starten Sie alle Server neu.
2. Starten Sie den Webserver in "IIS-Manager".
3. (Optional) Um von einem öffentlichen zu einem privaten Synonym zu wechseln, rufen Sie einen der folgenden Vorgänge für die Datenbank auf:

   begin
   prc_recreate_all_synonyms ('YES');
   end
   

   - oder -

   exec prc_recreate_all_synonyms ('YES');
   

4. (Optional) Sperren Sie das Konto "oblidbadmin" in der Datenbank. Führen Sie den folgenden Befehl aus, während Sie mit der Datenbank verbunden sind:

   alter user oblidbadmin account lock;
   

5. (Optional) Ändern Sie das Kennwort für "oblidbadmin". Führen Sie den folgenden Befehl aus, während Sie mit der Datenbank verbunden sind:

   alter user oblidbadmin identified by ‘<Neues_Kennwort>’;
   

6. Stellen Sie sicher, dass die Zeitverschiebung mit der ausgewählten Zeitzone übereinstimmt.
7. Stellen Sie sicher, dass die Angaben für die Sommerzeit zu Ihrem Standort passen.

   Sie verwenden nun die aktuellste Version von CA Business Service Insight.

Aktualisieren der Proxy-Zeichenfolge

Ein Reverse-Proxy leitet Support-Anfragen an die Website weiter. In diesen Anfragen wird die Präfixzeichenfolge in den Wert für "ProxyPrefix" und der Schlüssel in den Abschnitt "AppSettings" der Datei "web.config" eingefügt. Diese Präfixzeichenfolge wird konfiguriert, um die Anfrage zur Website in der Proxy-Konfiguration umzuleiten. Um Reverse-Proxys zu verwenden, aktualisieren Sie die Proxy-Zeichenfolge.

Gehen Sie wie folgt vor:

1. Stellen Sie sicher, dass die Website korrekt an den Reverse-Proxy weitergeleitet wird. Stellen Sie sicher, dass der Proxy-Wert richtig geschrieben und zwischen den zwei Schrägstrichen ("/Präfix/") platziert ist.

   Wenn zum Beispiel das der Website zugeordnete Präfix "ca" lautet, wird die Datei "Web.config" folgendermaßen aktualisiert:

   <appSettings>
   <add key="ProxyPrefix" value="/ca/" />
   </appSettings>
   

   Wenn der ProxyPrefix-Schlüssel nicht vorhanden ist oder der entsprechende Wert aus einer leeren Zeichenfolge besteht, arbeitet die Website im normalen Modus.

2. Fügen Sie eine Kopfzeile zur Proxy-Konfiguration hinzu. Der Kopfzeilenschlüssel muss folgendermaßen aussehen: "X-Forwarded-CA-Oblicore-Proxy".

   Wenn die URL für den Oblicore-Zugriff auf dem Webanwendungs-Proxy beispielsweise http://proxy/ca/ ist (in diesem Fall ist "ca" das Präfix), wird die Datei "web.config" folgendermaßen aktualisiert:

   <appSettings>
   <add key="ProxyPrefix" value="/ca/" />
   </appSettings>
   

   Zusätzlich zu dieser Aktualisierung wird in der Konfigurationsdatei der Proxy-Webanwendung eine neue Kopfzeile mit folgendem Schlüsselnamen hinzugefügt: "X-Forwarded-CA-Oblicore-Proxy".

Aktualisieren der API

Um den API-Code von Versionen vor 8.1 zu verwenden, aktualisieren Sie die API.

Hinweis: Detaillierte Informationen finden Sie im CA Business Service Insight-SDK-Handbuch unter "API Backwards Compatibility".

Gehen Sie wie folgt vor:

1. Verwenden Sie die WSDL von 8.2.5, um die Proxy-Klassen für die Services für Vertrag, Portfolio und Repository zu erstellen. Verwenden Sie die WSDL der letzten Installation für Versionen vor 8.0.
2. Kompilieren Sie Ihren API-Code neu.

   Hinweis: Wenn Kompilierungsfehler vorliegen, suchen Sie den Code, der manuell geändert werden muss. Aktualisieren Sie den Code gemäß der Änderungen, die an der neuen API vorgenommen wurden (Feldreihenfolge, Typ). Kompilieren Sie Ihren API-Code erneut, nachdem Sie diese Änderungen vorgenommen haben.