Migration auf HATS V7.5.1

Als Benutzer von Host Publisher Version 4, HATS Version 4 LE, HATS Version 5 LE, HATS Version 4, Version 5, Version 6, Version 7.0 oder Version 7.1 können Sie Ihre Projekte auf HATS V7.5.1 migrieren.

Informationen zur Migration ausgehend von HATS LE finden Sie unter Migration von HATS LE.

Wenn Sie eine ältere Version von Host Publisher als V4.0 verwenden, müssen Sie zunächst die Anweisungen zur Migration der Host Publisher-Anwendungen auf Host Publisher V4.0 befolgen. Rufen Sie die Webseite"http://www.ibm.com/software/awdtools/hats/support/index.html" auf und geben Sie dort den Suchausdruck "How to migrate Host Publisher" ein. Weitere Informationen können Sie unter HATS für Benutzer von Host Publisher nachlesen.

HATS-Migration

Die Migration eines HATS-Projekts aus einem Vorgängerrelease von HATS erfolgt in zwei Schritten.

  1. Importieren Sie das Projekt als Projektaustauschdatei, oder entnehmen Sie es aus einem Code-Repository (z. B. CVS), und stellen Sie es in den Arbeitsbereich von HATS V7.5.1.
  2. Migrieren Sie das Projekt mit dem HATS-Migrationsassistenten.

HATS-Projekt importieren

Falls bereits ein Vorgängerrelease von HATS installiert ist, müssen Sie zunächst Ihr Projekt in eine komprimierte Datei oder eine Projektaustauschdatei exportieren, bevor Sie es importieren und auf HATS V7.5.1 migrieren können. Informationen zum Export von HATS-Projekten enthält die Dokumentation für das Vorgängerrelease von HATS.

Nachdem Sie das Projekt aus einem Vorgängerrelease von HATS exportiert haben, müssen Sie es als Projektaustauschdatei in den Arbeitsbereich von HATS V7.5.1 importieren. Weitere Informationen zum Import von HATS-Webprojekten und HATS-Rich-Client-Projekten finden Sie unter HATS-Webprojekte exportieren und importieren und HATS-Rich-Client-Projekte exportieren und importieren.

Anmerkung:
Ein Projekt aus HATS V4, das als komprimierte Datei über WebSphere Studio Application Developer (WSAD) V4 exportiert wurde, kann nicht als Projektaustauschdatei importiert und infolgedessen nicht migriert werden. Ein Projekt aus HATS V4, das über WSAD V5 als komprimierte Datei exportiert wurde, kann importiert und auf HATS V7.5.1 migriert werden.

Falls Sie Ihre HATS-Projekte in Rational ClearCase gespeichert haben, sollten Sie eine statische Sicht erstellen, die diese Projekte enthält, und die Projekte dann in den Arbeitsbereich von HATS V7.5.1 importieren. Hierzu verwenden Sie die Optionen Datei > Importieren > Allgemein > Vorhandene Projekte in Arbeitsbereich. Wählen Sie während des Imports nicht die Option Projekte in Arbeitsbereich kopieren aus. Nachdem die Projekte in den Arbeitsbereich von HATS V7.5.1 importiert wurden, können Sie die Projekte auf HATS V7.5.1 migrieren. Während der Migration werden Projekte, die aktualisiert werden müssen, automatisch aus Rational ClearCase entnommen.

Migration des Rational SDP-Arbeitsbereichs

Der Assistent für die Migration des Rational SDP-Arbeitsbereichs wird angezeigt, wenn ein Projekt in den Arbeitsbereich importiert wird und ein gewisses Maß an Rational SDP-Migration erforderlich ist. Dieser Assistent führt eine gewisse Grundmigration für Rational SDP-Projekte aus und zwingt Sie, falls das Projekt eine nicht unterstützte Laufzeit zum Ziel hat, eine unterstützte Ziellaufzeit auszuwählen. Als Vorbereitung auf die Ausführung des HATS-Migrationsassistenten sollen Sie zuerst den Assistenten für die Migration des Rational SDP-Arbeitsbereichs ausführen.

HATS-Migrationsassistenten verwenden

Wenn Sie in die HATS-Perspektive wechseln und der Arbeitsbereich von HATS V7.5.1 ein Projekt enthält, das mit einem Vorgängerrelease von HATS erstellt wurde, wird die Nachricht ausgegeben, dass der Arbeitsbereich ein HATS-Projekt enthält, dessen Migration erforderlich ist.

Dieses Projekt sollten Sie mit dem HATS-Migrationsassistenten auf HATS V7.5.1 migrieren, bevor Sie die Fehler untersuchen, die in der Sicht Fehler angezeigt werden, weil durch die Migration möglicherweise einige oder alle Fehler eliminiert werden.

Führen Sie die folgenden Schritte aus, um den HATS-Migrationsassistenten zu verwenden:

  1. Klicken Sie in der Sicht HATS-Projekte mit der rechten Maustaste auf das Projekt, und wählen Sie die Option Projekt migrieren aus.
  2. Wenn dem HATS-Projekt, das Sie für die Migration ausgewählt haben, andere Projekte aus einem Vorgängerrelease von HATS zugeordnet sind, werden diese Projekte - wie auch alle zugeordneten EAR-Projekte von HATS - ebenfalls migriert.
  3. Klicken Sie auf OK, um die Migration zu starten.
  4. Ist dem Projekt kein EAR-Projekt zugeordnet, müssen Sie nach der Migration das WAR-Projekt zuordnen. Anweisungen für die Zuordnung eines WAR-Projekts zu einem EAR-Projekt enthält der Abschnitt HATS-Webprojekte in andere EAR-Datei verschieben.
Anmerkungen:
  1. Prüfen Sie im Anschluss an die Migration die Details im Migrationsbericht.
  2. Wenn für ein HATS-Webprojekt oder -Portletprojekt, das migriert wird, eine nicht unterstützte Laufzeit als Ziel angegeben ist (falls der Assistent für die Migration des Rational SDP-Arbeitsbereichs nicht ausgeführt wurde) oder nicht unterstützte WebSphere-Facetten angegeben sind, legt der HATS-Migrationsassistent für die Ziellaufzeit und die Facetten die niedrigste unterstützte Stufe von WebSphere Application Server für Webprojekte und die niedrigste unterstützte Serverstufe von WebSphere Portal für Portletprojekte fest. Es wird eine entsprechende Nachricht angezeigt und protokolliert, dass diese Änderung vorgenommen wurde.
  3. Falls Sie nach der Migration den Fehler empfangen, dass die Ziellaufzeit nicht definiert ist, bearbeiten Sie die Eigenschaften für das Projekt, und wählen Sie die entsprechende Ziellaufzeit aus. Klicken Sie hierzu mit der rechten Maustaste auf das Projekt, und wählen Sie die Option Eigenschaften aus. Wählen Sie im Fenster "Eigenschaften" die Einstellung für die Ziellaufzeiten aus. Wählen Sie in der Liste mit den Laufzeiten die entsprechende Laufzeit aus.
  4. Die Migration eines Projekts aus einem Vorgängerrelease von HATS auf HATS V7.5.1 kann nicht rückgängig gemacht werden.

HATS-Umsetzungen migrieren

Wenn Sie HATS-Projekte aus einem Vorgängerrelease von HATS auf HATS V7.5.1 migrieren, werden die Umsetzungen in den Projekten ebenfalls migriert. Welche Änderungen hierbei an den Umsetzungen vorgenommen werden, ist von dem HATS-Release abhängig, das als Ausgangspunkt für die Migration dient. Alle Umsetzungen werden vor der Migration im Ordner "MigrationBackup" gespeichert.

Spezielle Hinweise zu Komponenten und Fensterobjekten aus HATS V4

In HATS V5 wurden neue Komponenten und Fensterobjekte eingeführt. Komponenten und Fensterobjekte aus HATS V4 wurden zwar unterstützt, galten jedoch sowohl in HATS V5 als auch in HATS V6 als veraltet. In HATS V7.5.1 werden Komponenten und Fensterobjekte aus HATS V4 nicht unterstützt. Falls Ihre Projekte Komponenten und Fensterobjekte aus HATS V4 enthalten, haben Sie bei der Migration die Möglichkeit, diese auf Komponenten und Fensterobjekte für HATS V7.5.1 migrieren zu lassen oder die Projektmigration abzubrechen. Wenn Sie sich für die Migration der Projekte entscheiden, wird Ihr Projekt möglicherweise anders wiedergegeben. Denken Sie daher daran, migrierte Projekte sorgfältig zu testen.

Wenn Sie Subdateikomponenten und -fensterobjekte aus HATS V4 verwendet haben, werden diese auf Subdateikomponenten und -fensterobjekte aus HATS V5 migriert. Subdateikomponenten und -fensterobjekte, die aus HATS V5 stammen, werden unverändert übernommen. Bei HATS V6 und höher gibt es neue (und funktional erweiterte) Subdateikomponenten und -fensterobjekte. Es kann daher sinnvoll sein, die neuen Komponenten und Fensterobjekte anstelle der alten Elemente zu verwenden. Weitere Informationen können Sie unter Subdatei nachlesen.

Wenn Sie in HATS V4 eine Komponente "Funktionstaste" ausgewählt und entweder mit einem Fensterobjekt "Dropdown (Auswahl)" oder "Radioknopf (Auswahl)" wiedergegeben haben, konnten Sie auswählen, dass entweder eine automatische Übergabe verwendet oder ein Übergabeknopf angezeigt werden sollte. Falls Sie das Anzeigen eines Übergabeknopfes ausgewählt hatten, wird dieser Knopf bei einer Migration des Projekts aus HATS V4 auf HATS V7.5.1 nicht mehr angezeigt. In HATS V7.5.1 wurde die Funktion zum Anzeigen eines Übergabeknopfes entfernt.

Alle Paare "DefaultExtract/DefaultWidget" aus HATS Version 4 werden auf die Standardwiedergabe von HATS V7.5.1 migriert. Da diese Zuordnung möglicherweise nicht die ursprünglich beabsichtigten Ergebnisse erzielt, wird bei der Migration auf HATS V7.5.1 die Nachricht angezeigt und protokolliert, dass ein Paar "DefaultExtract/DefaultWidget" in die Standardwiedergabe migriert wurde. In diesem Fall sollten Sie die Umsetzung überprüfen und ggfs. erforderliche Anpassungen vornehmen.

Angepasste Komponenten und Fensterobjekte, die Komponenten und Fensterobjekte aus HATS V4 erweitern bzw. mit diesen paarweise verbunden sind, können nicht migriert werden und erzielen weiterhin die ursprünglichen Ergebnisse. Wenn dies von der Migration auf HATS V7.5.1 festgestellt wird, wird die Nachricht angezeigt und protokolliert, dass die Umsetzung Komponenten und Fensterobjekte aus HATS V4 enthält, die nicht migriert werden können. In diesem Fall müssen Sie die Umsetzung überprüfen und manuell migrieren.

Spezielle Hinweise für die Migration

Automatisches Springen nach vorn

Falls Sie in Vorgängerversionen von HATS die Funktion "Automatisches Springen nach vorn" aktiviert hatten, indem Sie die Zeile turnAutoTabOn(); zur Datei "lxgwfunctions.js" hinzugefügt hatten, müssen Sie künftig hierzu die Einstellung Funktion für automatisches Springen zum nächsten Feld aktivieren im Abschnitt "Clienteinstellungen" der Registerkarte Andere im Editor "Projekteinstellungen" verwenden. Weitere Informationen können Sie unter Clienteinstellungen nachlesen.

Sicherungsdateien

Die HATS-Migration erstellt im Projektverzeichnis einen Sicherungsordner namens MigrationBackup. Dieser Ordner enthält Kopien der Dateien aus dem alten Projekt, die vor deren Überschreibung durch den Migrationsprozess erstellt wurden. Diese Dateien werden gespeichert, damit Sie die Möglichkeit haben, sie mit neuen Dateien aus HATS V7.5.1 zu vergleichen und zu mischen. Gegebenenfalls auftretende Probleme müssen Sie nicht beunruhigen, denn diese Dateien werden von der Anwendung nicht mehr verwendet. Wenn Sie das Vergleichen und Mischen aller gespeicherten Dateien beendet haben, können Sie den Ordner MigrationBackup löschen.

Anmerkung:
Bevor Sie den Ordner "MigrationBackup" löschen, können Sie ein migriertes Projekt in WebSphere Application Server publizieren, um sein Verhalten zu testen. Durch den Ordner "MigrationBackup" verursachte Fehler in der Liste der Aufgaben können jedoch Probleme beim Publizieren auf WebSphere Application Server verursachen. Um dies zu vermeiden, können Sie entweder den Ordner "MigrationBackup" aus dem Projekt entfernen oder zulassen, dass Anwendungen, die Fehler enthalten, auf einem Server publiziert werden können. Damit Anwendungen, die Fehler enthalten, auf einem Server publiziert werden können, wählen Sie in der Menüleiste von Rational SDP die Optionen Fenster > Vorgaben > Server > WebSphere Application Server aus und wählen Sie dann die Option zum Publizieren von Anwendungen, die Fehler enthalten, auf einem Server zulassen (Allow applications containing errors to be published on a server) aus.

Fensterobjekt "Knopf"

Falls Sie ein Projekt migrieren, das vor HATS V7.0.0.2 erstellt wurde, hierbei die Implementierung der Option Vordergrundfarben aktivieren auswählen und eine Schablone einsetzen, die das Style-Sheet "blacktheme.css" verwendet, müssen Sie das Style-Sheet "blacktheme.css" mit einem der folgenden Verfahren manuell aktualisieren:

  1. Entfernen Sie die folgende Zeile aus der Deklaration "input.HATSBUTTON":
    color: lime;
    Hierdurch wird die Wiedergabe von Vordergrundfarben bei Funktionstasten ermöglicht. Andere Knöpfe, die durch ein HATS-Fensterobjekt generiert werden, werden jedoch in einer Standardfarbe wiedergegeben.
  2. Kombinieren Sie die farbbezogenen CSS-Deklarationen für alle Farben. Nehmen Sie beispielsweise die folgende Änderung vor:
    .HBLUE {
           color: #3c9dff;
    }
    input.HBLUE {
           white-space: normal;
           letter-spacing: normal;
    }
    to
    .HBLUE, input.HBLUE {
            color: #3c9dff;
            white-space: normal;
            letter-spacing: normal;
    }
    Wiederholen Sie diese Änderung für alle Farben.

Alternativ zur manuellen Bearbeitung des Style-Sheets "blacktheme.css" können Sie ein neues Pseudoprojekt erstellen und die CSS-Themendateien aus diesem Projekt in Ihr Projekt kopieren. Bitte beachten Sie, dass alle Änderungen, die Sie an den CSS-Dateien vorgenommen haben, hierdurch überschrieben werden.

EJB-Access-Beans

Falls Projekte aus HATS V5 vorhanden sind, die EJB-Access-Beans enthalten, treten möglicherweise Kompilierungs- oder Laufzeitfehler auf, die mit der Angabe "HPubReqCompleteEvent cannot be resolved" beginnen. Um dies zu korrigieren, müssen Sie die EJB-Access-Beans neu generieren.

Fensterobjekt "Feld"

Wenn Sie für das Fensterobjekt "Feld" die Einstellung In Monospaceschrift wiedergeben verwenden wollen und Ihr Projekt ursprünglich in einem Release vor HATS V7.0 erstellt wurde, müssen Sie die CSS-Dateien folgendermaßen aktualisieren:

  1. Fügen Sie die folgende Klasse zu den Dateien "whitetheme.css", "graytheme.css", "monochrometheme.css", "tantheme.css" und "blacktheme.css" hinzu:
    .HF {
      font-family: courier new, monospace;
    }
  2. Entfernen Sie die Angabe font-family: monospace aus allen Klassen H-color (HATS-Farbe) in allen CSS-Dateien.

Globale Regeln

Die neue Einstellung enforceImmediacy wird zu jeder globalen Regel hinzugefügt, die aus HATS V5 in HATS V7.5.1 importiert wird. Ist diese Einstellung auf "true" gesetzt, verhält sich die globale Regel so wie in HATS V5, wenn die Einstellung Nur nächstliegendes Eingabefeld für die Option Umsetzung des Musters Eingabefelder nach umgebendem Text suchen ausgewählt ist. Hat diese Einstellung den Wert "false" (dies entspricht dem Standardwert), verhält sich die globale Regel wie in HATS V7.5.1.

Damit sich neu definierte globale Regeln wie die globalen Regeln in HATS V5 verhalten, müssen Sie die Einstellung enforceImmediacy hinzufügen und auf den Wert "true" setzen. Hierzu fügen Sie auf der Registerkarte Quelle im Editor "Projekteinstellungen" die folgende Einstellung zum Tag "globalRules componentSettings" hinzu:

<setting name="enforceImmediacy" value="true"/>

Globale Variablen

Vor HATS Version 7 wurde der Wert einer globalen Variablen, der unter Verwendung der Option Den Wert der globalen Variablen über Eingabefenster anfordern bei einer Umsetzung in eine eingefügte Eingabeaufforderung eingegeben wurde, möglicherweise abgeschnitten, weil für einige Zeichen keine ordnungsgemäßen Escape-Zeichen verwendet wurden.

In dieser HATS-Version werden für die Werte globaler Variablen, die durch eine Umsetzung angefordert werden, die richtigen Escape-Zeichen verwendet, um das Abschneiden zu verhindern. Globale Variablen, die bei einer Umsetzung mit der Option Wert der globalen Variablen als statischen Text anzeigen eingefügt werden, sind von dieser Änderung nicht betroffen. Eingabeaufforderungen für globale Variablen, die in einer älteren Version als HATS V7 in eine Umsetzung eingefügt wurden, werden bei der Migration nicht automatisch aktualisiert, weshalb diese Änderung auf sie keine Auswirkung hat.

HTTP-Komprimierung

Falls Sie in Projekten, die ausgehend von HATS V5.0.x, V6.0 und V6.0.1 migriert wurden, die HATS-Unterstützung für die HTTP-Komprimierung verwenden wollen, müssen Sie den Komprimierungsfilter manuell zur Datei mit dem Webimplementierungsdeskriptor (web.xml) hinzufügen. So fügen Sie den Komprimierungsfilter zur Datei "web.xml" hinzu:

  1. Wechseln Sie in HATS Toolkit in die Navigatorsicht der HATS-Perspektive.
  2. Öffnen Sie die Datei "web.xml", die sich im Ordner "Web Content\WEB-INF" Ihres Projekts befindet.
  3. Klicken Sie auf die Registerkarte Quelle, um die Quelle dieser Datei anzuzeigen.
  4. Kopieren Sie die folgenden Anweisungen nach der letzten definierten Servletzuordnung in die Datei (suchen Sie nach dem letzten Vorkommen von </servlet-mapping>):
    <filter>
       <description>Provides compression for output from HATS entry
                    servlet</description>
       <display-name>CompressionFilter</display-name>
       <filter-name>CompressionFilter</filter-name>
       <filter-class>com.ibm.hats.runtime.filters.CompressionFilter</filter-class>
    </filter>
       
  5. Kopieren Sie die folgenden Anweisungen nach der letzten definierten Filterzuordnung in die Datei (suchen Sie nach dem letzten Vorkommen von </filter-mapping>):
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <servlet-name>EntryServlet</servlet-name>
       <dispatcher>ERROR</dispatcher>
       <dispatcher>FORWARD</dispatcher>
       <dispatcher>INCLUDE</dispatcher>
       <dispatcher>REQUEST</dispatcher>
    </filter-mapping>
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <url-pattern>/</url-pattern>
    </filter-mapping>
    <filter-mapping>
       <filter-name>CompressionFilter</filter-name>
       <url-pattern>/index.jsp</url-pattern>
    </filter-mapping>
       
  6. Speichern Sie die Datei.
Anmerkung:
Wenn Sie dieses Projekt bereits auf dem Server ausgeführt haben, müssen Sie die Anwendung erneut publizieren, damit WebSphere Application Server die Änderung an der Datei "web.xml" übernehmen kann.

IBM Tivoli License Manager

HATS, WebFacing und mit HATS/WebFacing verknüpfte Anwendungen, die auf HATS V7.5.1 migriert werden, müssen in der Produktionsumgebung erneut implementiert werden, damit die Unterstützung von IBM® Tivoli License Manager für die neue Signaturdatei von HATS V7.5.1 übernommen wird.

WebFacing-Webanwendungen

ITLM erkennt Webanwendungen, die als EAR-Datei (Enterprise Archive) für unterstützte WebSphere Application Server implementiert wurden. Da WebFacing-Webprojekte unabhängig von zugeordneten EAR-Dateien erstellt werden, muss die ITLM-Signaturdatei manuell eingeschlossen werden. So aktivieren Sie die ITLM-Erkennung von WebFacing-Webanwendungen:

  1. Erstellen Sie einen Ordner namens itlm, und zwar direkt unter der zugeordneten EAR-Datei des WebFacing-Projekts.
  2. Suchen Sie im Plug-in-Verzeichnis von HATS nach der Signaturdatei namens HATS0705.sys2:
    <gemeinsames_installationsverzeichnis>\plugins\com.ibm.hats_nnn\
    (Hierbei steht gemeinsames_installationsverzeichnis für das Verzeichnis für gemeinsam genutzte Ressourcen, in dem Sie das HATS-Angebot mit IBM Installation Manager installiert haben und nnn gibt die Version und die Buildstufe von HATS an).
  3. Kopieren Sie die Signaturdatei aus dem Ordner "plugins" in den zuvor erstellten Ordner itlm.
  4. Exportieren Sie das Projekt als EAR-Datei, und implementieren Sie es erneut. ITLM ist nun in der Lage, die Anwendung zu erkennen.

Falls Sie die ITLM-Erkennung für ein altes WebFacing-Projekt aktiviert hatten und dieses Projekt auf V7.5.1 migrieren, müssen Sie vor der erneuten Implementierung die vorhandene Signaturdatei (zum Beispiel WDHT0700.sys2, wenn das alte WebFacing-Projekt aus Version 7.0 stammt) aus der dem Projekt zugeordneten EAR-Datei entfernen und die Signaturdatei für V7.5.1 (HATS0705.sys2) hinzufügen.

Anmerkung:
WebFacing-Portlets werden nicht erkannt, weil sie nicht als EAR-Datei implementiert werden können.

Java 2-Sicherheit

Bei der Migration auf HATS V7.5.1 wird die Java™ 2-Sicherheitsdatei "was.policy" von WebSphere Application Server überschrieben. Wenn Sie die Datei "was.policy" in einem Projekt einer Vorgängerversion von HATS V7.5 angepasst hatten, müssen Sie diese Datei nach der Migration erneut anpassen.

Tastaturzuordnungen

In älteren Versionen des HATS-Host-Terminals war die Taste "Pause" der Hostaktion [clear] (= (Inhalt löschen) zugeordnet. Ab einschließlich dem Host-Terminal von HATS Version 7 ist nun die Taste "Esc" der Hostaktion [clear] (= Inhalt löschen) zugeordnet.

Bei älteren HATS-Versionen als V6 wurde die Tastenkombination Strg+R in bidirektionalen Sitzungen verwendet, um die Anzeige umzukehren. Ab HATS V6 ist die Tastenkombination Strg+R bei bidirektionalen und nicht-bidirektionalen Sitzungen einem Hostbefehl RESET (Zurücksetzen) zugeordnet. Zum Umkehren der Anzeige von bidirektionalen Sitzungen wird die Tastenkombination Alt+Eingabetaste verwendet.

Rich-Client-Anwendungen

Lotus Notes-Tastaturzuordnungen

Bei der Migration eines in einer älteren Version als HATS V7.5 erstellten Rich-Client-Projekts auf HATS V7.5.1, das für Lotus Expeditor bestimmt ist, werden die Tastaturzuordnungen für Lotus Notes zu dem Projekt hinzugefügt. Diese Tastaturzuordnungen werden auch zu Projekten hinzugefügt, die für Lotus Expeditor bestimmt sind, wenn Sie Ihre HATS V7.5.0.x-Installation mit IBM Installation Manager auf V7.5.1 aktualisieren.

Startkonfigurationen

Wenn Sie ein Rich-Client-Projekt nach dessen Migration nicht in der Testumgebung starten können, müssen Sie eine neue Startkonfiguration für die Verwendung in der Testumgebung erstellen. Klicken Sie dazu mit der rechten Maustaste auf die Sicht "HATS-Projekte" und wählen Sie Ausführen oder Debug aus. Das Fenster zum Ausführen oder Debuggen von Konfigurationen wird angezeigt. Klicken Sie, wenn das Projekt für Eclipse RCP bestimmt ist, mit der rechten Maustaste auf Eclipse-Anwendung und wählen Sie Neu aus. Klicken Sie, wenn das Projekt für Lotus Notes oder Lotus Expeditor bestimmt ist, mit der rechten Maustaste auf Client-Services und wählen Sie Neu aus. Ändern Sie den Namen und die Speicherposition der Startkonfiguration entsprechend Ihren Anforderungen. Sie können in diesem Fenster auch alte Startkonfigurationen löschen. Klicken Sie auf Ausführen (bzw. Debug), um das Projekt in der Testumgebung zu starten.

Themen

Bei Rich-Client-Anwendungen, die das Thema Klassischer Terminalemulator verwenden, ist nach der Migration die Einstellung Navigation per Pfeiltasten aktiviert.

Zeichenfolgen mit anderer Sprache als amerikanisches Englisch in Schablonen und Umsetzungen

Zeichenfolgen mit einer anderen Sprache als amerikanisches Englisch, die in Schablonen oder Umsetzungen eines mit HATS V7.0 oder V7.0.0.1 erstellten HATS-Rich-Client-Projekts enthalten sind, werden nicht korrekt kompiliert, wenn das Projekt als Feature exportiert wird. Als Ausweichlösung für dieses Problem müssen Sie nach der Migration des Projekts auf HATS V7.5.1 die Datei "build.properties" bearbeiten, die sich im Stammordner des Projekts befindet. Fügen Sie die folgende Zeile am Ende der Datei "build.properties" hinzu:

javacCustomEncodings.library.jar = src/rcp-projekt/templates/[UTF-8],
 src/rcp-projekt/transformations/[UTF-8]

Hierbei steht rcp-projekt für den Namen des Rich-Client-Projekts.

Laufzeitaktivierung

Zur vollständigen Aktivierung der Laufzeit von HATS V7.5.1 für die Produktion müssen Sie die Lizenzeinstellungen mit dem Assistenten "Lizenzeinstellungen" angeben. Dies müssen Sie auch für Projekte vornehmen, deren Laufzeiten in HATS vollständig aktiviert waren. Informationen zur Angabe der Lizenzeinstellungen finden Sie unter Aktivieren von HATS-Laufzeiteinstellungen und HATS-Lizenzeinstellungen im Handbuch HATS Erste Schritte.

Anmerkung:
HATS-Webanwendungen, deren Laufzeiten nicht vollständig aktiviert werden, sind auf nur zwei Laufzeithostverbindungen beschränkt. HATS-Rich-Client-Anwendungen, deren Laufzeiten nicht vollständig aktiviert werden, können zwar in der lokalen Testumgebung eine unbegrenzte Anzahl an Hostverbindungen herstellen, jedoch keine Hostverbindung in einer implementierten Produktionsumgebung.

Secure Sockets Layer (SSL)

Während der Migration konvertiert HATS V7.5.1 SSL-Zertifikatsklassendateien (Dateien CustomizedCAs.class) in PKCS12-Keystore-Dateien mit dem Namen anwendungsname-CustomizedCAs.p12 und dem Kennwort hats (anwendungsname steht für den Projektnamen). Nach der Migration sollten Sie die Kennwörter für die neuen Keystore-Dateien mit dem Tool für das Zertifikatsmanagement (auch IBM Key Management oder iKeyMan genannt) ändern und die Dateien mit dem Verbindungseditor prüfen. Weitere Informationen können Sie unter Sicherheit nachlesen.

Testmodi

Ab HATS Version können Sie mit den Testmodi "Ausführen auf Server" (bei Webprojekten) bzw. "Ausführen" (bei Rich-Client-Projekten) die Laufzeiteinstellungen ändern und testen, die in der Produktionsumgebung implementiert werden. Bitte beachten Sie, dass alle Änderungen, die Sie bei einem Test in diesem Modus an den Laufzeiteinstellungen vornehmen, erhalten bleiben und bei der Implementierung der HATS-Anwendung in einer Produktionsumgebung wirksam werden.

Mit den Testmodi "Debug auf Server" (bei Webprojekten) und "Debug" (bei Rich-Client-Projekten) können Sie die Laufzeiteinstellungen ändern und testen, ohne hierbei die Einstellungen zu ändern, die in der Produktionsumgebung implementiert werden.

Weitere Informationen zur Änderung von Laufzeiteinstellungen für Webprojekte finden Sie unter Administrationskonsole in HATS Toolkit starten. Zusätzliche Angaben zur Änderung der Laufzeiteinstellungen von Rich-Client-Projekten enthält der Abschnitt HATS-Rich-Client-Anwendungen verwalten.

Hostkomponente "URL-Adresse"

Vor HATS Version 7 suchte die Hostkomponente "URL-Adresse" sowohl in Eingabefeldern als auch in geschützten Feldern. Ab HATS Version 7 sucht die Hostkomponente "URL-Adresse" nur in geschützten und nicht verdeckten Feldern.

Web Express Logon (WEL)

Bei der Migration eines HATS-Webprojekts auf HATS V7.5.1 ohne zugehöriges EAR-Projekt funktioniert Web Express Logon (WEL) nicht ordnungsgemäß. Die WEL-Konfigurationsdaten eines Webprojekts befinden sich in den ihm zugeordneten EAR-Projekt. Wird das zugeordnete EAR-Projekt nicht importiert und migriert, gehen diese Informationen verloren.

Wenn Sie das Web- und das EAR-Projekt jeweils als Projektaustauschdatei in den Arbeitsbereich importieren und das Webprojekt migrieren, wird das zugeordnete EAR-Projekt ebenfalls migriert und die WEL-Konfigurationsdaten gehen nicht verloren.

Ab HATS Version 7 wird JSSE (Java Secure Socket Extension) sowohl von HATS DCAS/RACF/JDBC als auch von den zertifikatsbasierten DCAS/RACF-Plug-ins für den Berechtigungsnachweismapper verwendet, um sichere Verbindungen zum DCAS-Server herzustellen. Infolgedessen müssen Sie die folgenden Änderungen an den Initialisierungsparametern für die Plug-ins berücksichtigen:

CMPI_DCAS_KEYRING_FILE
Dieser Parameter ist veraltet und sollte nicht verwendet werden. Wird er jedoch verwendet, wird er in HATS V7.5.1 zusammen mit dem veralteten Parameter CMPI_DCAS_KEYRING_PASSWORD und unter der Voraussetzung unterstützt, dass der Schlüsselring den Typ "pkcs12" hat. Verwenden Sie stattdessen den Parameter CMPI_DCAS_TRUSTSTORE. Weitere Informationen können Sie unter Initialisierungsparameter nachlesen.

Dieser Parameter gibt eine Schlüsselringdatenbank an. Ein Schlüsselring muss angegeben werden, um den Zugriff auf das DCAS-Clientzertifikat wie auch das Zertifikat des DCAS-Servers zu ermöglichen. Die Zertifikate stellen eine über den Client authentifizierte sichere Verbindung zum DCAS-Server her. Dieser Parameter ist ein Dateiverweis auf den Schlüsselring, der verwendet werden muss. Das DCAS-Plug-in ist der DCAS-Client. Die Schlüsselringdatei muss in der EAR-Datei gespeichert sein.

CMPI_DCAS_KEYRING_PASSWORD
Dieser Parameter ist veraltet und sollte nicht verwendet werden. Wird er jedoch verwendet, wird er in HATS V7.5.1 zusammen mit dem veralteten Parameter CMPI_DCAS_KEYRING_FILE und unter der Voraussetzung unterstützt, dass der Schlüsselring den Typ "pkcs12" hat. Verwenden Sie stattdessen den Parameter CMPI_DCAS_TRUSTSTORE_PASSWORD. Weitere Informationen können Sie unter Initialisierungsparameter nachlesen.

Dieser Parameter gibt das Kennwort für die Schlüsselringdatenbank an.

Portlets aus HATS V4

Die Migration von Portlets aus HATS V4 wird nicht unterstützt. Wenn Sie ein vorhandenes Webprojekt aus HATS V4 als Portlet verwenden wollen, müssen Sie es zuerst auf HATS V7.5.1 migrieren. Nach der Migration des Projekts können Sie ausgehend von dem Projekt ein Portletprojekt von HATS V7.5.1 generieren. Weitere Informationen finden Sie unter Portlets aus HATS-Webprojekten generieren.

Migration von HATS LE

Falls gegenwärtig HATS LE installiert ist, müssen Sie zunächst Ihre Anwendung exportieren, bevor Sie sie in HATS V7.5.1 importieren können. So exportieren Sie die HATS LE-Anwendung über die Administrationskonsole von HATS LE in eine ZIP-Datei:

  1. Starten Sie die Administrationskonsole von HATS LE, indem Sie die folgende URL-Adresse in Ihrem Web-Browser eingeben: http://<servername>/HATSLE/admin. Hierbei steht <servername> für den Namen des Servers, auf dem die HATS LE-Anwendung ausgeführt wird.
  2. Wählen Sie die Option Erweitert aus.
  3. Wählen Sie die Option Paket aus.
  4. Laden Sie das Paket herunter, und speichern Sie es als ZIP-Datei.

Nach dem Export der HATS LE-Anwendung in eine ZIP-Datei importieren Sie sie folgendermaßen in HATS V7.5.1:

  1. Klicken Sie auf die Optionen Datei > Importieren, um den Importassistenten zu öffnen.
  2. Wählen Sie die Optionen HATS > HATS LE-Anwendung aus, und klicken Sie auf Weiter.
  3. Geben Sie im Feld Name der ZIP-Datei die Position und den Namen der ZIP-Datei ein. Wenn Sie auf den Knopf Durchsuchen klicken, können Sie auch nach der ZIP-Datei suchen und sie auswählen.
  4. Geben Sie im Feld Neuer Projektname einen Projektnamen an, oder übernehmen Sie den bereitgestellten Namen.
  5. Legen Sie die Position für das Projekt fest, oder übernehmen Sie die Standardposition.
  6. Geben Sie im Feld Enterprise Application-Projekt einen Namen für das EAR-Projekt an, oder wählen Sie ein vorhandenes Projekt in der Dropdown-Liste aus.
  7. Klicken Sie auf Fertig stellen.
Anmerkungen:
  1. Falls für die Verbindung in der HATS LE-Anwendung SSL aktiviert ist, empfangen Sie bei der Migration der Anwendung auf HATS V7.5.1 eine Warnung, und das SSL-Zertifikat wird nicht migriert.

    Damit das SSL-Zertifikat in HATS V7.5.1 verwendet werden kann, müssen Sie eine PKCS12-Keystore-Datei erstellen und das SSL-Zertifikat zu dieser Datei hinzufügen. Wenn das SSL-Zertifikat nicht mehr verfügbar ist, sollten Sie es sich beim Administrator des Telnet-Servers besorgen. Weitere Informationen können Sie unter SSL-Sicherheit aktivieren nachlesen.

  2. Die Funktionalität für Mehrfachverbindungen von HATS LE V5 geht bei der Migration auf HATS V7.5.1 verloren. Die Standardverbindung in der Anwendung aus HATS LE V5 wird zur Standardverbindung im Projekt von HATS V7.5.1. Die anderen in HATS LE V5 konfigurierten Verbindungen werden im Projekt von HATS V7.5.1 zu Hintergrundverbindungen.

HATS für Benutzer von Host Publisher

Als erfahrener Benutzer von IBM WebSphere Host Publisher müssen Sie Ihre Strategie bei der Entwicklung von Projekten mit HATS anpassen. Bei den Entwicklungsmethoden für Projekte bestehen zwischen HATS und Host Publisher einige wichtige Unterschiede:

Anmerkung:
Falls Sie Integrationsobjekte von Host Publisher mit einer geänderten Schablone erstellt haben, müssen Sie die Integrationsobjekte erneut erstellen, indem Sie ähnliche Änderungen an der HATS-Schablone für Integrationsobjekte vornehmen und anschließend die Integrationsobjekte aus Makros neu generieren. Weitere Informationen zur Verwendung von Schablonen für die Anpassung von Integrationsobjekten enthält das Handbuch HATS Web Application Programmer's Guide.

Für den Import einer Anwendung aus Host Publisher V4.0 gilt (im Unterschied zu einer Anwendung aus Host Publisher V4.0.1) Folgendes:

Migration von Host Publisher Version 4

Wenn Sie gegenwärtig Host Publisher V4 verwenden, können Sie entweder vollständige Projekte oder aber nur die Integrationsobjekte aus den vorhandenen Projekten migrieren. Beim Import von EAR-Dateien aus Host Publisher bleiben die Integrationsobjekte in der JAR-Datei gepackt.

Falls das Integrationsobjekt Teil eines Webmoduls war, befindet sich die JAR-Datei im Verzeichnis "WEB-INF/LIB". Befindet sich das Integrationsobjekt in einem EJB-Modul, steht die JAR-Datei im Verzeichnis "imported_classes\IntegrationObject". Die EJB-Access-Beans bleiben ebenfalls in der JAR-Datei aus dem Verzeichnis "WEB-INF/LIB" des Webmoduls gepackt.

Wenn Sie eine EAR-Datei importieren und das Makro ändern, für das ein Integrationsobjekt erstellt wurde, steht die ursprüngliche JAR-Datei des Integrationsobjekts, die importiert wurde, ebenso zur Verfügung wie die Java-Quelle. Nachdem Sie das Integrationsobjekt für HATS neu generiert haben, können Sie die importierte JAR-Datei löschen.

Bei einer von Host Publisher V4 ausgehenden Migration sollten Sie die folgenden Hinweise beachten:

Assistent "Host Publisher-EAR-Datei importieren"

Sie können Projekte aus Host Publisher V4 in HATS als neue HATS-Projekte oder als Teil eines vorhandenen HATS-Projekts importieren.

  1. Klicken Sie auf die Optionen Datei > Importieren > HATS > Host Publisher V4-EAR, um den Assistenten "Host Publisher-EAR-Datei importieren" zu öffnen.
  2. Geben Sie die EAR-Datei, die Sie importieren wollen, im Feld Name der EAR-Datei an.
  3. Legen Sie fest, ob die EAR-Datei für ein neues HATS-Projekt oder für ein vorhandenes HATS-Projekt verwendet werden soll.
  4. Im Abschnitt Optionen können Sie die Einstellung Ressourcen ohne Warnung überschreiben durch Auswahl des Markierungsfelds festlegen.
  5. Falls Sie in Host Publisher die Verschlüsselung verwendet haben, können Sie den Chiffrierschlüssel im Textfeld Chiffrierschlüssel für Benutzerliste eingeben.
  6. Klicken Sie auf Fertig stellen.

Host Publisher-Integrationsobjekt importieren

In ein vorhandenes HATS-Projekt können Sie auch einzelne Host Publisher-Integrationsobjekte importieren.

  1. Klicken Sie auf die Optionen Datei > Importieren > HATS > Host Publisher V4-Integrationsobjekt, um den Assistenten "Host Publisher-Integrationsobjekt importieren" zu öffnen.
  2. Geben Sie die Position der Integrationsobjekte, die Sie importieren wollen, im Feld Verzeichnis für Host Publisher-Integrationsobjekte an.
  3. Wählen Sie die zu importierenden Integrationsobjekte im Feld Zu importierende Integrationsobjekte auswählen aus.
  4. Wählen Sie das HATS-Projekt in der Dropdown-Liste HATS-Projekt auswählen aus.
  5. Durch Auswahl des jeweiligen Markierungsfelds können Sie die Optionen Ressourcen ohne Warnung überschreiben und Importierte Integrationsobjekte erneut generieren aktivieren.
    Anmerkung:
    Falls verkettete Integrationsobjekte vorhanden sind, müssen Sie die Option Importierte Integrationsobjekte erneut generieren unbedingt auswählen. Dies stellt sicher, dass die Verkettungsinformationen erhalten bleiben. Nachdem Sie die verketteten Integrationsobjekte importiert haben, sind die Statusinformationen in der Java-Quelle vorhanden und werden bei Verwendung des Assistenten "Verkettetes Integrationsobjekt erstellen" bereits eingegeben. Weitere Informationen zu verketteten Integrationsobjekten finden Sie unter Verkettung von Integrationsobjekten.
  6. Klicken Sie auf Fertig stellen.
Anmerkung:
Beim Import von Integrationsobjekten wird die Verbindungskonfiguration, die dem Integrationsobjekt zugeordnet ist, zum HATS-Projekt hinzugefügt.

Host Publisher V4-Portlets migrieren

Das Clipping-Portlet, das mit WebSphere Portal Server Version 6.x ausgeliefert wird, entspricht in seiner Funktionalität dem Portlet von Host Publisher Version 4. Sie können ein Clipping-Portlet, das auf eine integrationsobjektbasierte HATS-Anwendung oder auf eine aus Host Publisher V4 migrierte Anwendung zeigt, erstellen und als Ersatz für das Host Publisher V4-Portlet verwenden. Das Host Publisher V4-Portlet wird nicht mehr unterstützt.

Informationen zur engeren Integration von integrationsobjektbasierten Anwendungen in WebSphere Portal enthält das Handbuch HATS Web Application Programmer's Guide.

J2EE-Migration

Wenn Sie die Stufe der J2EE-Unterstützung in Ihren HATS-Projekten migrieren möchten, führen Sie die folgenden Schritte aus:

  1. Wechseln Sie in Rational SDP in die Navigatorsicht.
  2. Klicken Sie mit der rechten Maustaste auf das EAR-Projekt, in dem Ihr HATS-Projekt enthalten ist, und wählen Sie die Optionen Java EE > J2EE-Migrationsassistent aus.
  3. Klicken Sie in der Begrüßungsseite auf Weiter.
  4. Wählen Sie in der Enterprise Application-Anzeige die entsprechende J2EE-Version aus und wählen Sie das Markierungsfeld Alle Modulprojekte migrieren ab.
    Anmerkung:
    Durch die Abwahl dieser Option können Sie einzeln prüfen, welche Projekte migriert werden sollen. Falls das EAR-Projekt ein HATS-EJB-Projekt enthält, dürfen Sie es nicht auswählen, damit das EAR-Projekt erfolgreich migriert wird.
  5. Wählen Sie in der (möglicherweise aufgerufenen) Anzeige "EJB-Modul" keine HATS-EJB-Projekte aus.
  6. Wählen Sie in der Anzeige "Webprojekte" alle HATS-Webprojekte aus.
  7. Klicken Sie auf Fertig stellen.