Mise à niveau à partir d'une version antérieure

Reflection for the Web 5.x ou 6.x

Si une version obsolète de Reflection for the Web est installée ou en mémoire cache sur vos ordinateurs et serveurs locaux, utilisez les instructions suivantes pour procéder à la mise à niveau vers la version actuelle de Reflection for the Web. Lors de la mise à niveau, il est vivement recommandé de suivre les étapes dans l'ordre où elles sont présentées sur cette page.

Pour procéder à la mise à niveau à partir de Reflection for the Web 5.x ou 6.x :

1. Désinstallation de Reflection for the Web 5.x ou 6.x
2. Installation des composants de Reflection for the Web 9.5
3. Mise à niveau des fichiers obsolètes

Etape 1 : Désinstallation des composants de Reflection for the Web 5.x ou 6.x

Remarque : Sur toutes les plates-formes, si vous avez utilisé la section Définition UDC du Gestionnaire de déploiement pour attribuer des caractères personnalisés aux valeurs EBCDIC et que vous souhaitez conserver ces associations, enregistrez une copie du fichier udc.xml situé dans le répertoire [installation du serveur de gestion de Reflection]/ReflectionData/.

Remarque : Pour toutes les méthodes d'installation, si vous avez exporté des fichiers de définition de clavier à l'aide de la commande Exporter clavier dans la session Reflection, mettez à niveau ces fichiers avant de désinstaller la version 5.x ou 6.x. Consultez la section Mise à niveau des fichiers de définition du clavier externe pour plus d'informations.

Supprimez les fichiers Reflection for the Web5.x ou 6.x sur le serveur. Pour désinstaller une version antérieure :

• Si vous avez utilisé un programme d'installation automatique, procédez comme suit :
  
  
  • Windows : Sélectionnez Démarrer > Programmes > WRQ Reflection for the Web > Désinstallation de WRQ Reflection for the Web.
    
    
  • Windows : Exécutez le programme uninstaller.exe qui se trouve dans le dossier [dossier d'installation]\_uninst\.
    
    
  • Linux ou Solaris : Exécutez le programme uninstaller.jar qui se trouve dans le répertoire [dossier d'installation]/utilities/. Sélectionnez le répertoire et tapez la commande suivante :
    
    ./uninstaller.sh
    
    
  Lorsque vous effectuez l'une de ces opérations, vous conservez la configuration du serveur de gestion de Reflection et du serveur proxy de sécurité. Lors de la désinstallation, le programme vous propose de sauvegarder les fichiers modifiés.
  
  
• Si vous avez effectué l'installation à l'aide de fichiers d'archive, conservez ces fichiers et dossiers, puis procédez à la désinstallation :
  
  
  1. Serveur de gestion de Reflection:
     
     Copiez et sauvegardez le fichier web.xml dans le répertoire
     [Installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/WEB-INF/.
     
     Copiez et sauvegardez tous les fichiers que vous avez personnalisés dans le répertoire
     [Installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/ ou
     [Installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/WEB-INF/jsp/.
     
     Copiez et sauvegardez les sessions statiques non protégées dans le répertoire
     [Installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/session/.
     Vous pouvez également enregistrer ces sessions dans d'autres répertoires figurant dans le dossier webapps.
     
     Copiez et sauvegardez le répertoire
     [Installation du serveur de gestion de Reflection]/ReflectionData/.
     
     Copiez et sauvegardez vos fichiers cacerts dans le répertoire
     [installation du serveur de gestion de Reflection]/_jvm/lib/security/ directory.
     
     
  2. Serveur proxy de sécurité :
     
     Copiez et sauvegardez les répertoires
     [installation du proxy de sécurité]/conf/ et
     [installation du proxy de sécurité]/keystores/.
     Vous conservez ainsi votre fichier server.properties et vos certificats.
     
     
  3. Serveur de comptage :
     
     Copiez le fichier web.xml et enregistrez-le dans le répertoire
     [installation du serveur de comptage]/jakarta-tomcat-[numéro de version]/webapps/rwebmeter/WEB-INF/.
     
     
  4. Programme d'exécution de servlet :
     
     Copiez la bibliothèque de stockage de clés Tomcat et enregistrez-la dans le répertoire
     [installation tomcat]/jakarta-tomcat-[numéro de version]/conf/.
     
     
  5. Supprimez les répertoires dans lesquels vous avez installé les composants de Reflection for the Web.
     
     

Etape 2 : Installation des composants de Reflection for the Web 9.5

Installez maintenant les composants de Reflection for the Web 9.5. Lorsque vous procédez à la mise à niveau à partir d'une version antérieure :

• Installez Reflection for the Web 9.5 dans un répertoire non accessible via un serveur Web. Ce répertoire ne doit pas être accessible à votre serveur Web. Installez Reflection for the Web 9.5 dans la même structure de répertoires que Reflection for the Web 5x ou 6x.
  
  
• Sélectionnez et suivez une procédure d'installation.

Etape 3 : Mise à niveau des fichiers obsolètes

Si vous avez procédé à l'installation à l'aide d'un programme d'installation automatique :

Vous conservez la configuration du serveur de gestion de Reflection et du programme d'exécution de servlet. La mise à niveau ne requiert aucune autre opération lorsque vous n'avez personnalisé aucun fichier ou lorsque vous n'avez ajouté aucun certificat à la liste des certificats autorisés du serveur de gestion. Suivez les étapes ci-après pour conserver des paramètres personnalisés ou des certificats importés. Exécutez la procédure décrite ci-après dans Pour tous les types d'installation pour mettre à niveau les fichiers JCE, UDC, d'autres fichiers personnalisés, ou encore des certificats. Suivez la procédure décrite dans la section Mise à niveau des sessions statiques pour mettre à niveau des sessions qui n'ont pas été enregistrées à l'aide du Gestionnaire de session ou qui ont été modifiées manuellement.

La mise à niveau du serveur proxy de sécurité est terminée. Pour pouvoir modifier les sessions sécurisées existantes ou en créer de nouvelles dans le Gestionnaire de session, exportez les paramètres de configuration du serveur proxy de sécurité vers la station Web Administrative. Exécutez l'Assistant du serveur proxy de sécurité. Cliquez sur Enregistrer pour enregistrer les paramètres. Le système vous demande d'exporter les paramètres vers le serveur de gestion. Vérifiez que le nom, le port et le contexte associés au serveur de gestion sont appropriés, puis cliquez sur Exporter.

La mise à niveau du serveur de comptage n'est pas prise en charge dans le cadre de cette procédure d'installation. Pour reprendre les paramètres de l'installation précédente dans la nouvelle installation, ouvrez le fichier web.xml dans un éditeur de texte. Servez-vous de ces informations comme référence lorsque vous configurez le serveur de comptage de la version 9.5 à l'aide de l'interface de configuration prévue à cet effet. Pour obtenir des informations détaillées sur la configuration, consultez la section Configuration du serveur de comptage.

Si vous avez procédé à l'installation à l'aide de fichiers d'archive :

Vérifiez que ces fichiers sont correctement copiés ou édités.

• Serveur de gestion de Reflection:
  
  
  1. Copiez l'ancien répertoire ReflectionData dans la nouvelle structure de répertoires du serveur de gestion de Reflection.
     
     
  2. Un nouveau fichier web.xml a été créé dans le répertoire
     [installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/WEB-INF/.
     Ouvrez ce fichier dans un éditeur de texte.
     
     
  3. Dans ce nouveau fichier, insérez les valeurs de
     rwebdata_location_placeholder et de
     https_port_placeholder issues du fichier web.xml que vous avez sauvegardé pendant la première étape. Vous pouvez procéder par copier-coller ou taper directement les valeurs.
     
     
  4. Enregistrez le fichier web.xml.
     
     
  5. Copiez et sauvegardez vos fichiers cacerts dans le répertoire
     [installation du serveur de gestion de Reflection]/_jvm/lib/security/.
     
     
• Serveur proxy de sécurité :
  
  Copiez les répertoires /conf/ et /keystores/ que vous avez conservés à l'étape 1 dans la nouvelle installation du serveur proxy de sécurité.
  
  Pour pouvoir modifier les sessions sécurisées existantes ou en créer de nouvelles dans le Gestionnaire de session, exportez les paramètres de configuration du serveur proxy de sécurité vers la station Web Administrative. Exécutez l'Assistant du serveur proxy de sécurité. Cliquez sur Enregistrer pour enregistrer les paramètres. Le système vous demande d'exporter les paramètres vers le serveur de gestion. Vérifiez que le nom, le port et le contexte associés au serveur de gestion sont appropriés, puis cliquez sur Exporter.
  
  
• Programme d'exécution de servlet:
  
  Copiez la bibliothèque de stockage de clés Tomcat que vous avez sauvegardée dans le répertoire
  [répertoire d'installation]/jakarta-tomcat-[numéro de version]/conf/.
  
  Dans un éditeur de texte, ouvrez le fichier [répertoire d'installation]/jakarta-tomcat-[numéro de version]/conf/server.xml.
  Apportez les modifications nécessaires en ce qui concerne le port HTTP ou le port HTTPS.

Pour tous les types d'installation :

• Fichiers JCE:
  
  Si vous avez installé les fichiers JCE à niveau illimité à partir du site Web de Sun pour le chiffrement AES 192 bits et 256 bits dans votre version précédente de Reflection, les fichiers téléchargés sont désinstallés du serveur de gestion sans notification lors des désinstallations automatiques. Si vous avez effectué une installation automatique, JRE version 5.0 a été installé. Pour pouvoir continuer à bénéficier du chiffrement AES 192 bits et 256 bits, téléchargez la version la plus récente des fichiers JCE à niveau illimité sur le site Web de Sun et installez-la. Pour plus d'informations, consultez l'aide de l'Assistant Serveur proxy de sécurité (Assistant Serveur proxy de sécurité > Serveurs proxy > Ajouter ou Modifier > Ajout ou Modification > Aide).
  
  
• Définition UDC:
  
  Si vous avez conservé vos paramètres de définition UDC en enregistrant le fichier udc.xml au cours de l'étape 1, copiez ce fichier dans le nouveau répertoire ReflectionData de la version 9.5.
  
  
• Sessions JNLP:
  
  Si vous avez créé des sessions JNLP dans la version 5.x, vous devez les modifier pour qu'elles fonctionnent dans Reflection for the Web version 9.5. Pour plus d'informations sur l'exécution et la modification de sessions JNLP, consultez la Note technique 1729. (Les notes techniques ne sont disponibles qu'en anglais.)
  
  
• Programme d'exécution de servlet:
  
  Si vous avez installé tomcat.zip, mettez à jour le kit JDK avec Java 2 (nous recommandons la version 5.0).
  
  
• Serveur de comptage :
  
  Reprenez les paramètres enregistrés dans le fichier web.xml pour configurer le nouveau serveur de comptage. Ouvrez le fichier web.xml dans un éditeur de texte et utilisez ces paramètres comme référence lorsque vous configurez le serveur de comptage de la version 9.5. Pour obtenir des informations détaillées sur la configuration, consultez le tutoriel Configuration du serveur de comptage.
  
  
• Certificats autorisés :
  
  Installation automatique : Si vous avez ajouté des certificats à la liste de certificats autorisés du serveur de gestion, les certificats importés sont stockés dans le fichier cacerts. Lors de la désinstallation de la version précédente, ce fichier a été automatiquement enregistré et renommé sous la racine du répertoire d'installation du serveur de gestion de Reflection. Le nouveau nom est créé en ajoutant un trait de soulignement et un nombre à trois chiffres au nom de fichier d'origine. Par exemple : cacerts_000. Copiez ce fichier dans le nouveau répertoire [Installation du serveur de gestion de Reflection]/_jvm/lib/security/, puis renommez-le (cacerts).
  
  
• Fichiers personnalisés :
  
  Pour conserver des sessions statiques non protégées, consultez la section Mise à niveau des sessions statiques. (Les notes techniques ne sont disponibles qu'en anglais.)
  
  Pour conserver vos paramètres si vous avez sauvegardé le fichier LauncherHTML.jsp dans l'installation de la version 6.x, procédez comme suit :
  
  
  1. A l'aide d'un éditeur de texte, ouvrez le fichier LauncherHTML.jsp d'origine. Dans la version 6.x, il figure dans le répertoire
     [installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/WEB-INF/jsp/.
     
     
  2. Remplacez les deux premières lignes de l'ancien fichier par celles-ci :
     
         <%@ page import="com.wrq.java13plus.management.core.GmAsset" %>
    <%@ page import="com.wrq.java13plus.management.gm.LauncherStartAction" %>
     
     
  3. Enregistrez le fichier LauncherHTML.jsp dans le répertoire [installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/gm/ de la nouvelle installation.
     
     
  Pour conserver vos paramètres si vous avez sauvegardé le fichier ReflectionClient.html dans l'installation de la version 5.1, procédez comme suit :
  
  
  1. A l'aide d'un éditeur de texte, ouvrez le fichier ReflectionClient.html d'origine. Dans la version 5.1, il se trouve dans le répertoire
     [installation du serveur de gestion de Reflection]/ReflectionData/.
     
     
  2. A l'aide d'un éditeur de texte, ouvrez le nouveau fichier LauncherHTML.jsp qui figure dans le répertoire
     [installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/gm.
     
     
  3. Dans le fichier ReflectionClient.html, copiez les paramètres relatifs aux couleurs, aux marges et aux polices, puis insérez-les dans le fichier LauncherHTML.jsp.
     
     
  4. Enregistrez le fichier JSP.
     
     
  Pour conserver vos paramètres si vous avez sauvegardé le fichier LoginPage.jsp dans l'installation de la version 5.0, procédez comme suit :
  
  
  1. A l'aide d'un éditeur de texte, ouvrez le fichier LoginPage.jsp d'origine. Dans la version 5.0, il figure dans le répertoire
     [installation du serveur de gestion de Reflection]/jakarta-tomcat-4.0.1/webapps/rweb/.
     
     
  2. A l'aide d'un éditeur de texte, ouvrez le nouveau fichier LauncherHTML.jsp qui figure dans le répertoire
     [installation du serveur de gestion de Reflection]/jakarta-tomcat-[numéro de version]/webapps/rweb/gm.
     
     
  3. Dans le fichier LoginPage.jsp, copiez les paramètres relatifs aux couleurs, aux marges et aux polices, puis insérez-les dans le fichier LauncherHTML.jsp.
     
     
  4. Enregistrez le fichier JSP.
     
     
• Intégration IIS :
  
  Si votre installation précédente de Reflection for the Web était intégrée à IIS, le programme d'installation automatique a détecté cette intégration et a conservé vos paramètres. Pour modifier ces paramètres ou si vous avez effectué l'installation à l'aide des fichiers d'archive, ouvrez l'Assistant IIS (Démarrer > Programmes > Attachmate Reflection for the Web > Utilitaires > Assistant IIS). Pour plus d'informations, consultez la section Exécution de l'Assistant IIS. Saisissez le numéro du port HTTPS, cliquez sur Suivant, puis sur Terminer.
  
  
• Intégration de portails BEA :
  
  Si vous avez intégré Reflection for the Web version 6.x à un portail BEA, modifiez le code JSP de votre portlet. Désormais, le code permettant d'afficher une session est le suivant :
  
  

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

  
  Pour afficher la liste des liens de l'utilisateur final :
  
  .....
<%= new com.wrq.java13plus.management.portal.RWebBrokerWLP().getContent(request, "<RWeb URL>/LoginPage.do&appletOnly=true") %>
.....