Si vous utilisez Host Publisher V4, HATS V4 LE, HATS V5 LE, HATS V4, V5, V6, V7.0 ou V7.1, vous pouvez faire migrer vos projets vers HATS V7.5.1.
Pour plus d'informations sur la migration à partir de HATS LE, voir Migration à partir de HATS LE.
Si vous utilisez une version de Host Publisher antérieure à V4.0, vous devez d'abord effectuer une migration de vos applications Host Publisher vers Host Publisher V4.0 en suivant les instructions appropriées. Accédez à la page http://www.ibm.com/software/awdtools/hats/support/index.html et saisissez la chaîne de recherche "How to migrate Host Publisher". Pour plus d'informations, voir HATS pour les utilisateurs de Host Publisher.
La migration d'un projet HATS à partir d'une version antérieure est constituée de deux étapes.
Si une version antérieure de HATS est installée, vous devez d'abord exporter votre projet vers un fichier zip ou un fichier Project Interchange avant de pouvoir l'importer et le migrer vers HATS V7.5.1. Pour plus d'informations sur l'exportation des projets HATS, consultez la documentation de la version antérieure de HATS.
Après avoir exporté votre projet à partir d'une version antérieure de HATS, vous devez l'importer en tant que fichier Project Interchange dans votre espace de travail HATS V7.5.1. Pour plus d'informations sur l'importation de projets Web HATS et de client enrichi, voir Exportation et importation de projets Web HATS et Exportation et importation de projets de client enrichi HATS.
Si vous avez enregistré vos projets HATS dans Rational ClearCase, vous devez créer une vue instantanée qui contient ces projets, puis les importer dans votre espace de travail HATS V7.5.1 en sélectionnant Fichier > Importer > Général > Projets existants dans l'espace de travail. Au cours de l'importation, ne sélectionnez pas l'option Copier les projets dans l'espace de travail. Une fois les projets importés dans votre espace de travail HATS V7.5.1, vous avez la possibilité de les migrer vers HATS V7.5.1. Lors de la migration, les fichiers qui doivent être mis à jour sont automatiquement réservés dans Rational ClearCase.
L'assistant de migration d'espace de travail Rational SDP s'affiche lorsqu'un projet est importé dans l'espace de travail et qu'il requiert un certain niveau de migration Rational SDP. Cet assistant permet d'effectuer quelques tâches simples de migration de projets Rational SDP. Si le projet vise une exécution non prise en charge, il vous oblige à choisir une exécution cible prise en charge. Lorsque vous vous préparez à exécuter l'assistant de migration HATS, vous devez commencer par exécuter l'assistant de migration d'espace de travail Rational SDP.
Lorsque vous passez à la perspective HATS et qu'un projet créé avec une version antérieure de HATS se trouve dans votre espace de travail HATS V7.5.1, vous recevrez un message vous informant que l'espace de travail contient un projet HATS qui doit faire l'objet d'une migration.
Utilisez l'assistant de migration HATS pour faire migrer ce projet vers HATS V7.5.1 avant de chercher à identifier les éventuelles erreurs indiquées dans la vue Problems car une migration peut éliminer certaines ou toutes ces erreurs.
Pour utiliser l'assistant de migration HATS, procédez comme suit :
Lorsque vous faites migrer des projets HATS issus d'une version antérieure de HATS vers HATS V7.5.1, les transformations figurant dans les projets sont également migrées. Les modifications apportées aux transformations dépendent de la version de HATS à partir de laquelle vous effectuez la migration. Toutes les transformations sont sauvegardées dans le dossier MigrationBackup avant la migration.
HATS V5 introduisait de nouveaux composants et objets fenêtre. Les composants et objets fenêtre de HATS V4 étaient pris en charge mais obsolètes dans HATS V5 et V6. Les composants et objets fenêtre de HATS V4 ne sont pas pris en charge dans HATS V7.5.1. Si vos projets comportent des composants et objets fenêtre HATS V4, vous avez la possibilité, durant la migration, de les faire migrer vers des composants et objets fenêtre de HATS V7.5.1 ou d'annuler la migration du projet. Si vous optez pour la migration, votre projet pourra avoir un rendu légèrement différent. Prenez soin de tester soigneusement les projets ayant fait l'objet d'une migration.
Si vous disposez de composants et objets fenêtre de sous-fichier HATS V4, ils sont migrés vers des composants et objets fenêtre de sous-fichier HATS V5. Si vous disposez de composants et objets fenêtre de sous-fichier HATS V5, ils ne sont pas affectés. Il existe de nouveaux composants et objets fenêtre de sous-fichier (comportant plus de fonctions) pour HATS V6 et les versions ultérieures. Vous pouvez utiliser ces nouveaux composants et objets fenêtre plutôt que les anciens pour effectuer vos recherches. Pour plus d'informations, voir Sous-fichier.
Dans HATS V4, si vous optiez pour un composant de touche de fonction et que vous le rendiez en tant qu'objet fenêtre Liste déroulante (sélection) ou Bouton d'option (sélection), vous pouviez choisir entre la soumission automatique ou l'affichage d'un bouton d'envoi. Si vous avez choisi le bouton d'envoi, celui-ci n'apparaît plus suite à la migration du projet HATS V4 vers HATS V7.5.1. Dans HATS V7.5.1, il n'est plus possible d'indiquer un bouton d'envoi.
Toutes les paires HATS V4 DefaultExtract/DefaultWidget sont migrées vers le rendu par défaut de HATS V7.5.1. Comme ce mappage risque de ne pas produire les résultats originaux attendus, la procédure de migration HATS V7.5.1 affiche et consigne un message indiquant qu'une paire DefaultExtract/DefaultWidget a été migrée vers le rendu par défaut. Dans ce cas, il est conseillé de vérifier la transformation et d'apporter les modifications nécessaires.
Les composants et objets fenêtre personnalisés qui étendent ou sont appariés avec des composants et objets fenêtre de HATS V4 ne peuvent pas être migrés et conservent les résultats d'origine. Lorsque la migration de HATS V7.5.1 détecte cette situation, elle affiche et consigne un message indiquant que la transformation contient des composants et objets fenêtre HATS V4 ne pouvant être migrés. Dans ce cas, vous devez réviser la transformation et la faire migrer manuellement.
Si, dans les versions antérieures de HATS, vous aviez activé la fonction d'avance automatique en ajoutant la ligne turnAutoTabOn(); au fichier lxgwfunctions.js, vous devez désormais utiliser le paramètre Activer l'avance de zone automatique dans la section Paramètres client de l'onglet Autres de l'éditeur des paramètres du projet. Pour plus d'informations, voir Paramètres client.
La procédure de migration de HATS crée un dossier de sauvegarde appelé MigrationBackup dans le répertoire contenant le projet. Ce dossier contient des copies des fichiers de l'ancien projet avant leur écrasement par la procédure de migration. Ces fichiers sont sauvegardés afin que vous puissiez les comparer et les fusionner avec les nouveaux fichiers HATS V7.5.1. Ne vous inquiétez pas concernant d'éventuels incidents, car ces fichiers ne sont plus utilisés par l'application. Une fois que vous êtes sûr que tous les fichiers sauvegardés ont été comparés et fusionnés, vous pouvez supprimer le dossier MigrationBackup.
Si vous migrez un projet créé avant HATS V7.0.0.2, que vous choisissez d'implémenter l'option Activer les couleurs d'avant-plan et que vous utilisez un modèle utilisant la feuille de style blacktheme.css, vous devez mettre à jour manuellement cette feuille de style de l'une des manières suivantes :
color: lime;Cela permet aux couleurs d'avant-plan d'être représentées sur les touches de fonction. Il entraîne toutefois la représentation des autres boutons générés par un objet fenêtre HATS dans une couleur par défaut.
.HBLUE {
color: #3c9dff;
}
input.HBLUE {
white-space: normal;
letter-spacing: normal;
}dans
.HBLUE, input.HBLUE {
color: #3c9dff;
white-space: normal;
letter-spacing: normal;
}Répétez cette procédure pour chaque couleur.Vous pouvez également créer un projet factice et copier les fichiers CSS du thème de ce projet dans votre projet. Notez que toutes les modifications apportées aux fichiers CSS seront remplacées.
Si vous disposez de projets HATS V5 comportant des beans d'accès EJB, vous pouvez rencontrer des erreurs de compilation ou d'exécution commençant par "HPubReqCompleteEvent cannot be resolved." Pour y remédier, régénérez les beans d'accès EJB.
Pour utiliser le paramètre Rendu avec une police monospace (espace simple) pour l'objet fenêtre de zone avec un projet créé dans une version antérieure à HATS V7.0, vous devez mettre à jour les fichiers CSS de la manière suivante :
.HF {
font-family: courier new, monospace;
}Un nouveau paramètre, enforceImmediacy, est ajouté à chaque règle globale importée dans HATS V7.5.1 à partir de HATS V5. Si ce paramètre est vrai, la règle globale a le même comportement que dans HATS V5 lorsque l'option Zone d'entrée la plus proche uniquement est sélectionnée pour l'option Transformation du masque Recherche par texte environnant. Si ce paramètre est faux (par défaut), la règle globale a le même comportement que dans HATS V7.5.1.
Pour que les nouvelles règles globales définies aient le même comportement que les règles globales de HATS version 5, vous devez ajouter et définir le paramètre enforceImmediacy sur true. Pour cela, à partir de l'onglet Source de l'éditeur des paramètres de projet, ajoutez le paramètre suivant à la baliseglobalRules componentSettings :
<setting name="enforceImmediacy" value="true"/>
Dans les versions HATS antérieures à la version 7, la valeur d'une variable globale saisie dans une invite insérée dans une transformation à l'aide de l'option Afficher une invite pour la variable globale avec zone de saisie peut avoir été tronquée en raison de l'espacement incorrect de certains caractères.
Dans cette version de HATS, les valeurs de variable globale demandées par une transformation sont espacées correctement pour éviter qu'elles soient tronquées. Les variables globales insérées dans une transformation à l'aide de l'option Affichage de la variable globale sous la forme de texte statique ne sont pas affectées par ce changement. Les invites de variable globale insérées dans une transformation dans une version antérieure à HATS V7 ne sont pas mises à jour automatiquement lors de la migration et elles ne sont donc pas affectées par ce changement.
Si vous voulez utiliser le support HATS pour la compression HTTP dans les projets migrés de HATS V5.0.x, V6.0 et V6.0.1, vous devez ajouter manuellement le filtre de compression au fichier Web Deployment Descriptor (web.xml). Pour ajouter le filtre de compression au fichier web.xml :
<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>
<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>
Les applications liées HATS, WebFacing et HATS/WebFacing migrées vers HATS V7.5.1 doivent être redéployées dans l'environnement de production afin de prendre en compte le support IBM® Tivoli License Manager pour le nouveau fichier de signatures de HATS V7.5.1.
ITLM détecte les applications Web déployées en tant que fichiers d'archive d'entreprise (fichiers EAR) sur les serveurs WebSphere Application Server pris en charge. Etant donné que les projets Web WebFacing sont créés indépendamment des fichiers EAR associés, le fichier de signatures ITLM doit être inclus manuellement. Procédez comme suit pour permettre à ITLM de détecter les applications Web WebFacing.
<répertoire_installation_partagé>\plugins\com.ibm.hats_nnn\où répertoire_installation_partagé correspond au répertoire des ressources partagées dans lequel vous avez installé l'offre HATS à l'aide d'IBM Installation Manager et nnn correspond à la version et au niveau de compilation de HATS.
Si vous avez activé la détection ITLM pour un ancien projet WebFacing et que vous migrez ce projet vers la version V7.5.1, vous devez supprimer le fichier de signatures existant (par exemple WDHT0700.sys2 si l'ancien projet WebFacing date de la version 7.0) du fichier EAR associé au projet et ajouter le fichier de signatures de la version V7.5.1 (HATS0705.sys2) avant le déploiement.
Lors de la migration vers HATS V7.5.1, le fichier was.policy de sécurité Java™ 2 de WebSphere Application Server est écrasé. Si vous avez personnalisé le fichier was.policy dans une version antérieure à HATS V7.5, vous devez le personnaliser à nouveau après la migration.
Dans les versions antérieures du terminal hôte de HATS, la touche Pause correspondait à l'action d'effacement de l'hôte. Dans le terminal hôte de HATS V7 et d'une version ultérieure, , c'est la touche Echap qui correspond à l'action d'effacement de l'hôte.
Dans les versions de HATS antérieures à HATS V6, la combinaison de touches Ctrl+R permettait, dans les sessions bidirectionnelles, d'inverser l'écran. Dans HATS V6 et versions ultérieures, la combinaison de touches Ctrl+R correspond à une restauration de l'hôte pour les sessions bidirectionnelles et non bidirectionnelles ; la combinaison de touches Alt+Entrée permet quant à elle d'effectuer une inversion dans le cas de sessions bidirectionnelles.
Si vous migrez un projet client enrichi antérieur à HATS V7.5 ciblé pour Lotus Expeditor vers HATS V7.5.1, les affectations de touches pour Lotus Notes sont ajoutées au projet. Celles-ci sont également ajoutées aux projets ciblés pour Lotus Expeditor si vous mettez à jour HATS V7.5.0.x vers V7.5.1 à l'aide d'IBM Installation Manager.
Si après une migration vous ne parvenez pas à lancer un projet client enrichi dans l'environnement de test, créez une nouvelle configuration de lancement pour l'utilisation dans l'environnement de test. Pour ce faire, dans la vue Projets HATS, cliquez avec le bouton droit sur le projet et sélectionnez Exécuter ou Déboguer. La fenêtre Run (or Debug) Configurations s'affiche. Si le projet est ciblé pour Eclipse RCP, cliquez avec le bouton droit sur Application Eclipse et sélectionnez Nouveau. Si le projet est ciblé pour Lotus Notes ou Lotus Expeditor, cliquez avec le bouton droit sur Services client et sélectionnez Nouveau. Modifiez le nom et l'emplacement de la configuration de lancement si vous le souhaitez. Cette fenêtre permet également de supprimer les anciennes configurations de lancement. Cliquez sur Exécuter (ou Déboguer) pour lancer le projet dans l'environnement de test.
Le paramètre Navigation à l'aide des touches fléchées des applications client enrichi utilisant le thème Emulateur de terminal classique est activé après la migration.
Les chaînes dans une langue autre que l'anglais qui sont incluses dans les modèles et les transformations d'un projet de client enrichi HATS généré à l'aide de HATS V7.0 ou de V7.0.0.1 ne sont pas compilées correctement lorsque le projet est exporté en tant que fonction. Pour résoudre ce problème, éditez le fichier build.properties situé dans le dossier principal du projet après avoir migré le projet vers HATS V7.5.1. Ajoutez la ligne suivante au bas du fichier build.properties :
javacCustomEncodings.library.jar = src/rcpproject/templates/[UTF-8], src/rcpproject/transformations/[UTF-8]
où rcpproject correspond au nom du projet de client enrichi.
Pour activer complètement le module d'exécution HATS V7.5.1 pour la production, vous devez indiquer vos paramètres de licence dans l'assistant Paramètres de licence. Vous devez exécuter cette procédure même pour les projets dont les modules d'exécution étaient complètement activés dans des versions antérieures de HATS. Pour plus d'informations sur la spécification des paramètres de licence, voir Activation de l'exécution HATS et de la configuration de la licence dans HATS - Guide d'initiation
Lors se la migration, HATS V7.5.1 convertit les fichiers de classe de certificat SSL, les fichiers CustomizedCAs.classen fichiers de clés PKCS12 sous les noms nom_app-CustomizedCAs.p12 et les mots de passe de hats, où nom_app correspond au nom du projet. A l'issue de la migration, vous devez utiliser l'outil Gestion des certificats (également appelé IBM Key Management ou iKeyMan) pour modifier les mots de passe pour les nouveaux fichiers de clés et les vérifier à l'aide de l'éditeur de connexions. Pour plus d'informations, voir Sécurité.
A partir de HATS V7, les modes de test Exécuter sur le serveur (pour les projets Web) et Exécuter (pour les projets client enrichi) peuvent être utilisés pour modifier et tester les paramètres d'exécution déployés dans l'environnement de production. Notez que les modifications apportées aux paramètres d'exécution au cours du test dans ce mode sont conservées et deviennent effectives lorsque vous déployez l'application HATS dans l'environnement de production.
Les modes de test Déboguer sur le serveur (pour les projets Web) et Déboguer (pour les projets client enrichi) peuvent être utilisés pour modifier et tester les paramètres d'exécution sans modifier les paramètres déployés dans l'environnement de production.
Pour plus d'informations sur la modification des paramètres d'exécution pour les projets Web, voir Lancement de la console d'administration depuis HATS Toolkit. Pour plus d'informations sur la modification des paramètres d'exécution pour les projets client enrichi, voir Administration des applications client enrichi HATS.
Avant HATS version 7, la recherche du composant hôte d'adresse URL s'effectuait à la fois dans les zones d'entrée et protégées. A partir de la version 7, elle s'effectue uniquement dans les zones protégées non masquées.
Lorsqu'un projet Web HATS est migré vers HATS V7.5.1 sans le projet EAR associé, Web Express Logon (WEL) ne peut pas s'exécuter pas correctement. Les informations de configuration WEL d'un projet Web sont stockées dans son projet EAR associé. Si le projet EAR associé n'est pas importé et migré, ces informations sont alors perdues.
Si vous importez les projets Web et EAR dans l'espace de travail en tant que fichiers Project Interchange et vous migrez le projet Web, le projet EAR associé est également migré et les informations de configuration WEL sont conservées.
A partir de HATS V7, JSSE (Java Secure Socket Extension) est utilisé à la fois par HATS DCAS/RACF/JDBC et par les modules d'extension des programmes de mappage de données d'identification DCAS/RACF basés sur les certificats pour les connexions sécurisées au serveur DCAS. En conséquence, tenez compte des modifications suivantes apportées aux paramètres d'initialisation du module d'extension.
Ce paramètre définit une base de données de type fichier de clés. Un fichier de clés doit être indiqué pour donner accès au certificat client DCAS, ainsi qu'au certificat du serveur DCAS. Ce certificat établit une connexion client sécurisée et authentifiée avec le serveur DCAS. Ce paramètre constitue une référence au fichier de clés à utiliser. Le module d'extension DCAS est le client DCAS. Le fichier de clés doit être stocké dans un fichier .ear.
Ce paramètre définit le mot de passe pour le fichier de clés.
La migration des portlets HATS V4 n'est pas prise en charge. Si vous souhaitez utiliser un projet Web HATS V4 existant comme portlet, vous devez d'abord le faire migrer vers HATS V7.5.1. Une fois le projet migré, vous pouvez générer un portlet HATS V7.5.1 à partir de ce projet. Pour plus d'informations, voir Génération de portlets à partir de projets Web HATS.
Si HATS LE est installé sur votre ordinateur, vous devez tout d'abord exporter votre application pour pouvoir l'importer dans HATS V7.5.1. Pour exporter l'application HATS LE de la console d'administration HATS LE vers un fichier .zip, procédez comme indiqué ci-après.
Une fois l'application HATS LE exportée en tant que fichier .zip, importez-la dans HATS V7.5.1 en procédant comme suit :
Pour utiliser le certificat SSL dans HATS V7.5.1, vous devez créer un fichier de clés PKCS12 et y ajouter un certificat SSL. Si vous ne disposez plus de ce certificat, contactez votre administrateur de serveur Telnet pour en obtenir un. Pour plus d'informations, voir Activation de la fonction de sécurité SSL.
Si vous êtes un utilisateur expérimenté d'IBM WebSphere Host Publisher, vous devez modifier vos habitudes pour pouvoir développer des projets avec HATS. Voici les principales différences existant entre HATS et Host Publisher pour le développement de projets :
Si vous importez une application Host Publisher V4.0 (et non une application Host Publisher V4.0.1) :
Si vous utilisez Host Publisher version 4.0, vous pouvez effectuer la migration de projets entiers ou simplement celle des objets d'intégration inclus dans les projets existants. Lorsque vous importez des fichiers .ear Host Publisher, les objets d'intégration restent intégrés dans le fichier .jar.
Si l'objet d'intégration se trouvait dans un module Web, le fichier .jar se trouve dans le répertoire WEB-INF/LIB. Si l'objet d'intégration se trouvait dans un module EJB, le fichier .jar se trouve dans le répertoire imported_classes\IntegrationObject. Les beans d'accès EJB restent également dans le fichier .jar, dans le répertoire WEB-INF/LIB du module Web.
Si vous importez un fichier .ear et que vous modifiez la macro pour laquelle un objet d'intégration a été créé, vous disposez du fichier .jar de l'objet d'intégration d'origine qui a été importé, ainsi que du code source Java source. Une fois que vous avez régénéré l'objet d'intégration pour HATS, vous pouvez supprimer le fichier .jar importé.
Tenez compte des remarques suivantes lors de la migration à partir de Host Publisher V4 :
Vous pouvez importer des projets Host Publisher V4 dans HATS sous forme de nouveaux projets ou comme partie intégrante d'un projet HATS existant.
Vous pouvez aussi importer des objets d'intégration individuels Host Publisher dans un projet HATS existant.
Le portlet de découpage fourni avec WebSphere Portal Server V6.x équivaut, en termes de fonctionnalité, au portlet Host Publischer V4. Vous pouvez créer un portlet de découpage pointant sur une application HATS basée sur des objets d'intégration ou sur une application ayant fait l'objet d'une migration à partir de Host Publisher V4, et remplacer le portlet Host Publisher V4 par le portlet que vous venez de créer. Le portlet Host Publisher V4 n'est plus pris en charge.
Pour plus d'informations sur l'intégration d'applications HATS basées sur des objets d'intégration avec WebSphere Portal, voir HATS Web Application Programmer's Guide.
Si vous souhaitez faire migrer le niveau de prise en charge J2EE dans vos projets HATS, procédez comme suit :