Von einer früheren Version aktualisieren

Reflection for the Web 5.x oder 6.x deinstallieren

Wenn auf Ihren lokalen Computern und Servern eine veraltete Version von Reflection for the Web installiert oder zwischengespeichert ist, gehen Sie zum Aktualisieren auf die aktuelle Version von Reflection for the Web nach dieser Anleitung vor. Führen Sie beim Aktualisieren die genannten Schritte unbedingt in der angegebenen Reihenfolge aus.

So aktualisieren Sie von Reflection for the Web 5.x oder 6.x:

1. Deinstallieren von Reflection for the Web 5.x oder 6.x
2. Installieren der Reflection for the Web 9.0-Komponenten
3. Aktualisieren veralteter Dateien

Schritt 1: Deinstallieren Sie die Reflection for the Web 5.x- oder 6.x-Komponenten.

Hinweis: Bei allen Installationsmethoden gilt: Wenn Sie den Abschnitt UDC-Zuordnung des Einsatzmanagers zum Zuweisen von benutzerdefinierten Zeichen zu EBCDIC-Werten verwendet haben und diese Belegung beibehalten möchten, kopieren und speichern Sie die Datei udc.xml, die sich im Verzeichnis [Installation von Reflection-Management-Server]/ReflectionData/ befindet.

Hinweis: Bei allen Installationsmethoden gilt: Wenn Sie Tastaturbelegungen mit dem Befehl Tastaturbelegung exportieren in der Reflection-Sitzung exportiert haben, aktualisieren Sie diese Dateien, bevor Sie die Version 5.x oder 6.x. deinstallieren. Weitere Informationen finden Sie unter Aktualisieren der externen Tastaturbelegungsdateien.

Entfernen Sie Reflection for the Web 5.x- oder 6.x-Dateien von Ihrem Server. So deinstallieren Sie eine ältere Version:

• Wenn Sie ein automatisches Installationsprogramm verwendet haben, führen Sie eines der folgenden Verfahren durch:
  
  
  • Windows: Klicken Sie auf Start > Programme > WRQ Reflection for the Web > Deinstallation von WRQ Reflection for the Web.
    
    
  • Windows: Führen Sie die Datei uninstaller.exe aus dem Verzeichnis [Installationsverzeichnis]\_uninst\ aus.
    
    
  • Linux oder Solaris: Führen Sie die Datei "uninstaller.sh" im Verzeichnis "[Installationsordner]/utilities/" aus. Wechseln Sie in das Verzeichnis, und geben Sie folgenden Befehl ein:
    
    ./uninstaller.sh
    
    
  Bei der Durchführung eines dieser Verfahren bleibt die Konfiguration des Reflection-Management-Servers und des Sicherheits-Proxy-Servers erhalten. Sie werden aufgefordert, geänderte Dateien während des Deinstallationsprozesses zu speichern.
  
  
• Wenn Sie die Installation mit Hilfe von Archivdateien vorgenommen haben, sichern Sie zunächst diese Dateien und Ordner, und deinstallieren Sie dann die folgende Software:
  
  
  1. Reflection-Management-Server:
     
     Kopieren und speichern Sie die web.xml-Datei im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/WEB-INF/.
     
     Kopieren und speichern Sie alle Dateien, die Sie im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/ oder
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/WEB-INF/jsp/ gespeichert haben.
     
     Kopieren und speichern Sie alle nicht geschützten, statischen Sitzungen im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/session/.
     Diese Sitzungen können auch in anderen Unterverzeichnissen des Verzeichnisses webapps gespeichert werden.
     
     Kopieren und speichern Sie das Verzeichnis
     [Installation von Reflection-Management-Server]/ReflectionData/.
     
     Kopieren und speichern Sie die Datei "cacerts" im Verzeichnis
     "[Installation von Reflection Management-Server]/_jvm/lib/security/".
     
     
  2. Sicherheits-Proxy-Server:
     
     Kopieren und speichern Sie das Verzeichnis
     [Sicherheits-Proxy-Installation]/conf/ und das Verzeichnis
     [Sicherheits-Proxy-Installation]/keystores/.
     Auf diese Weise werden die Datei server.properties und Ihre Zertifikate gespeichert.
     
     
  3. Nutzungsüberwachungs-Server:
     
     Kopieren und speichern Sie die web.xml-Datei im Verzeichnis
     [Nutzungsüberwachungs-Server-Installation]/jakarta-tomcat-[Versionsnummer]/webapps/rwebmeter/WEB-INF/.
     
     
  4. Servlet-Runner:
     
     Kopieren und speichern Sie den Tomcat-Keystore im Verzeichnis
     [Tomcat-Installation]/jakarta-tomcat-[Versionsnummer]/conf/.
     
     
  5. Löschen Sie die Installationsverzeichnisse der Reflection for the Web-Komponenten.
     
     

Schritt 2: Installieren der Reflection for the Web 9.0-Komponenten

Installieren Sie nun die Reflection for the Web 9.0-Komponenten. Beim Aktualisieren von einer früheren Version führen Sie die folgenden Schritte aus:

• Installieren Sie Reflection for the Web 9.0 in einem Verzeichnis, auf das vom Web-Server nicht zugegriffen werden kann. Installieren Sie Reflection for the Web 9.0 in derselben Verzeichnisstruktur, die für Reflection for the Web 5.x oder 6.x verwendet wird.
  
  
• Wählen Sie ein Installationsverfahren aus, und befolgen Sie die entsprechenden Anweisungen.

Schritt 3: Aktualisieren veralteter Dateien

Wenn Sie die Installation mit einem automatischen Installationsprogramm durchgeführt haben:

Die Reflection Management-Server- und Servlet-Runner-Einstellungen wurden beibehalten. Es sind keine weiteren Aktualisierungsschritte erforderlich, wenn Sie keine Benutzeranpassungen an Dateien vorgenommen haben oder Zertifikate zur Liste der vertrauenswürdigen Zertifikate des Servers hinzugefügt haben. Führen Sie die Schritte unten durch, um Benutzereinstellungen beizubehalten oder um importierte Zertifikate beizubehalten. Befolgen Sie die Schritte im Abschnitt Bei allen Installationsmethoden gilt, um JCE-Policy-Dateien, UDC-Dateien und andere individuelle Dateien oder Zertifikate zu aktualisieren. Befolgen Sie die Anweisungen im Abschnitt Statische Sitzungen aktualisieren, um Sitzungen zu aktualisieren, die nicht mit dem Sitzungsmanager gespeichert bzw. die manuell bearbeitet wurden.

Die Aktualisierung des Sicherheits-Proxy-Servers ist abgeschlossen. Um sicherzustellen, dass Sie vorhandene sichere Sitzungen bearbeiten oder neue sichere Sitzungen im Sitzungsmanager erstellen können, exportieren Sie die Sicherheits-Proxy-Servereinstellungen in Administrative WebStation. Führen Sie den Sicherheits-Proxy-Server aus. Klicken Sie auf Speichern, um die Einstellungen zu speichern. Sie werden aufgefordert, die Einstellungen in den Management-Server zu exportieren. Stellen Sie sicher, dass Name, Anschluss und Kontext des Management-Servers korrekt sind, und klicken Sie auf Exportieren.

Die Aktualisierung des Nutzungsüberwachungs-Servers wird bei diesem Installationsprozess nicht unterstützt. Um die Einstellungen der vorherigen Installation in die neue Installation zu übertragen, öffnen Sie die web.xml-Datei in einem Texteditor. Verwenden Sie diese Informationen als Referenz, wenn Sie die Version 9.0 des Nutzungsüberwachungs-Servers mit Hilfe der Oberfläche zur Nutzungsüberwachungskonfiguration konfigurieren. Ausführliche Informationen zur Konfiguration erhalten Sie unter Einrichten der Nutzungsüberwachungskomponente.

Wenn Sie die Installation anhand von Archivdateien durchgeführt haben:

Stellen Sie sicher, dass diese Dateien ordnungsgemäß kopiert oder bearbeitet wurden.

• Reflection-Management-Server:
  
  
  1. Kopieren Sie das alte ReflectionData-Verzeichnis in die neue Verzeichnisstruktur des Management-Servers von Reflection.
     
     
  2. Eine neue web.xml-Datei wurde im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/WEB-INF/ erstellt.
     Öffnen Sie die neue Datei in einem Texteditor.
     
     
  3. Geben Sie in der neuen web.xml-Datei für
     rwebdata_Platzhalter_für_Speicherort und
     https_Platzhalter_für_Anschluss die Werte aus der web.xml-Datei ein, die Sie in Schritt 1 gespeichert haben. Sie können die Werte aus der gespeicherten Datei kopieren und in die neue Datei einfügen, oder Sie können die Werte direkt eingeben.
     
     
  4. Speichern Sie die neue web.xml-Datei.
     
     
  5. Kopieren Sie die Datei alte Datei "cacerts" in das Verzeichnis
     "[Installation von Reflection Management-Server]/_jvm/lib/security/".
     
     
• Sicherheits-Proxy-Server:
  
  Kopieren Sie die Verzeichnisse /conf/ und /keystores/, die Sie in Schritt 1 gespeichert haben, in die neue Installation des Sicherheits-Proxy-Servers.
  
  Um sicherzustellen, dass Sie vorhandene sichere Sitzungen bearbeiten oder neue sichere Sitzungen im Sitzungsmanager erstellen können, exportieren Sie die Sicherheits-Proxy-Servereinstellungen in Administrative WebStation. Führen Sie den Sicherheits-Proxy-Server aus. Klicken Sie auf Speichern, um die Einstellungen zu speichern. Sie werden aufgefordert, die Einstellungen in den Management-Server zu exportieren. Stellen Sie sicher, dass Name, Anschluss und Kontext des Management-Servers korrekt sind, und klicken Sie auf Exportieren.
  
  
• Servlet-Runner:
  
  Kopieren Sie den gespeicherten Tomcat-Keystore in
  [Installationspfad]/jakarta-tomcat-[Versionsnummer]/conf/.
  
  Öffnen Sie in einem Texteditor die Datei [Installationspfad]/jakarta-tomcat-[Versionsnummer]/conf/server.xml.
  Nehmen Sie die erforderlichen Änderungen am HTTP- oder HTTPS-Anschluss vor.

Für alle Installationsarten gilt Folgendes:

• JCE-Policy-Dateien:
  
  Wenn Sie die JCE Unlimited Strength Policy-Dateien von der Sun-Website zur Unterstützung von 192-Bit- und 256-Bit-AES-Verschlüsselung in der vorherigen Version von Reflection installiert haben, werden die heruntergeladenen Dateien bei einer automatischen Installation vom Management-Server ohne vorherige Warnung deinstalliert. Wenn Sie ein automatisches Installationsprogramm verwendet haben, wurde JRE Version 5.0 installiert. Um die Unterstützung der AES-Verschlüsselung mit 192 und 256 Bit beizubehalten, laden Sie die neueste Version der JCE Unlimited Strength Policy-Datei von der Sun-Website herunter und installieren diese. Weitere Informationen finden Sie in der Online-Hilfe zum Sicherheits-Proxy-Assistenten (Sicherheits-Proxy-Assistent > Proxys > Hinzufügen oder Ändern > Hinzufügen oder Ändern > Hilfe).
  
  
• UDC-Zuordnung
  
  Wenn Sie Ihre Einstellungen der UDC-Zuordnung durch Speichern der Datei udc.xml (siehe Schritt 1) gespeichert haben, kopieren Sie diese Datei nun in das neue Verzeichnis ReflectionData der Version 9.0.
  
  
• JNLP-Sitzungen:
  
  Wenn Sie JNLP-Sitzungen in Version 5.x erstellt haben, müssen Sie diese Sitzungen so modifizieren, dass sie in Reflection for the Web Version 9.0 eingesetzt werden können. Weitere Informationen über das Ausführen und Ändern von JNLP-Sitzungen erhalten Sie im technischen Hinweis 1729. (Die technischen Hinweise stehen nur in englischer Sprache zur Verfügung.)
  
  
• Servlet-Runner:
  
  Wenn Sie die Datei "tomcat.zip" installiert haben, aktualisieren Sie Ihr JDK auf Java 2 (Version 5.0 empfohlen).
  
  
• Nutzungsüberwachungs-Server:
  
  Verwenden Sie die in der web.xml-Datei gespeicherten Einstellungen, um den neuen Nutzungsüberwachungs-Server zu konfigurieren. Öffnen Sie die web.xml-Datei in einem Texteditor, und verwenden Sie die folgenden Einstellungen als Referenz bei der Konfiguration des Nutzungsüberwachungs-Servers Version 9.0. Ausführliche Informationen zur Konfiguration erhalten Sie in der Anleitung Einrichten des Nutzungsüberwachungs-Servers.
  
  
• Vertrauenswürdige Zertifikate:
  
  Automatische Installation: Wenn Sie der Liste der vertrauenswürdigen Zertifikate des Management-Servers Zertifikate hinzugefügt haben, werden die importierten Zertifikate in der Datei cacerts gespeichert. Diese Datei wurde bei der Deinstallation der vorherigen Version automatisch im Stammverzeichnis der Installation von Reflection Management-Server gespeichert und umbenannt. Der neue Name wird erstellt, indem ein Unterstrich und eine dreistellige Nummer an den ursprünglichen Dateinamen angehängt werden, z. B. cacerts_000. Kopieren Sie diese Datei in das neue Verzeichnis
  [Installation von Reflection Management-Server]/_jvm/lib/security/,
  und benennen Sie die Datei in cacerts um.
  
  
• Benutzerdefinierte Dateien:
  
  Informationen zum Beibehalten ungeschützter statischer Sitzungen finden Sie im Abschnitt Statische Sitzungen aktualisieren. (Die technischen Hinweise stehen nur in englischer Sprache zur Verfügung.)
  
  So behalten Sie die Einstellungen bei, wenn Sie die Datei LauncherHTML.jsp aus der Installation von Version 6.x gespeichert haben:
  
  
  1. Öffnen Sie in einem Texteditor die ursprüngliche Datei LauncherHTML.jsp, die sich in Version 6.x im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/WEB-INF/jsp/ befindet.
     
     
  2. Ersetzen Sie die ersten beiden Zeilen der alten Datei durch die folgenden beiden Zeilen:
     
         <%@ page import="com.wrq.java13plus.management.core.GmAsset" %>
    <%@ page import="com.wrq.java13plus.management.gm.LauncherStartAction" %>
     
     
  3. Speichern Sie die Datei LauncherHTML.jsp in der neuen Installation von Reflection for the Web im Verzeichnis [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/gm/.
     
     
  So behalten Sie die Einstellungen bei, wenn Sie die Datei ReflectionClient.html aus der Installation von Version 5.1 gespeichert haben:
  
  
  1. Öffnen Sie in einem Texteditor die ursprüngliche Datei ReflectionClient.html, die sich in Version 5.1 im Verzeichnis
     [Installation von Reflection-Management-Server]/ReflectionData/ befindet.
     
     
  2. Öffnen Sie in einem Texteditor die ursprüngliche Datei LauncherHTML.jsp, die sich im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/gm befindet.
     
     
  3. Kopieren Sie die Einstellungen für Farbe, Ränder und Schriftart aus der Datei ReflectionClient.html in LauncherHTML.jsp.
     
     
  4. Speichern Sie die JSP-Datei.
     
     
  So behalten Sie die Einstellungen bei, wenn Sie die Datei LoginPage.jsp aus der Installation von Version 5.0 gespeichert haben:
  
  
  1. Öffnen Sie in einem Texteditor die ursprüngliche Datei LoginPage.jsp, die sich in Version 5.0 im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-4.0.1/webapps/rweb/ befindet.
     
     
  2. Öffnen Sie in einem Texteditor die ursprüngliche Datei LauncherHTML.jsp, die sich im Verzeichnis
     [Installation von Reflection-Management-Server]/jakarta-tomcat-[Versionsnummer]/webapps/rweb/gm befindet.
     
     
  3. Kopieren Sie die Einstellungen für Farbe, Ränder und Schriftart aus der Datei LoginPage.jsp in LauncherHTML.jsp.
     
     
  4. Speichern Sie die JSP-Datei.
     
     
• IIS-Integration:
  
  Ist Ihre vorherige Installation von Reflection for the Web in IIS integriert, erkennt das automatische Installationsprogramm die Integration und behält die Einstellungen bei. Wenn Sie diese Einstellungen ändern möchten oder zur Installation die Archivdateien verwenden, starten Sie den IIS-Assistenten (Start > Programme > Attachmate Reflection for the Web > Dienstprogramme > IIS-Assistent). Weitere Informationen hierzu finden Sie unter Ausführen des IIS-Assistenten. Geben Sie die HTTPS-Anschlussnummer ein, klicken Sie auf Weiter und anschließend auf Fertig stellen.
  
  
• BEA-Portal-Integration:
  
  Wenn Reflection for the Web Version 6.x mit Ihrem BEA-Portal integriert war, ändern Sie den vorhandenen Code in Ihrer Portlet-JSP. Der Code zum Anzeigen einer Sitzung lautet nun:
  
  

  .....
<%= new com.wrq.java13plus.management.portal.RWebBrokerWLP().getContent(request, "<RWeb URL>/RWebSession.do?link=<Sitzungsname>&portal=true&appletOnly=true") %>
.....

  
  So zeigen Sie die Endbenutzer-Verbindungsliste an:
  
  .....
<%= new com.wrq.java13plus.management.portal.RWebBrokerWLP().getContent(request, "<RWeb URL>/LoginPage.do&appletOnly=true") %>
.....