Guide d`installation
Transcription
Guide d`installation
Reflection for the Web Guide d'installation version 12.3 © 2016 Attachmate Corporation, une société Micro Focus. Tous droits réservés. Aucune partie de la documentation accompagnant ce produit logiciel d'Attachmate ne peut être reproduite, transmise, transcrite ou traduite dans d'autres langues, à quelque fin ou par quelque moyen que ce soit, sans l'autorisation expresse et écrite d'Attachmate Corporation. Le contenu de la présente documentation est protégé par les lois sur le copyright, même lorsque sa diffusion ne s'accompagne pas d'une version logicielle comprenant un contrat de licence utilisateur final. Le contenu de la présente documentation est fourni à titre d'information uniquement ; par ailleurs, il peut faire l'objet de modifications sans préavis et ne doit en aucun cas être considéré comme un engagement de la part d'Attachmate Corporation. Attachmate Corporation décline toute responsabilité quant aux erreurs ou inexactitudes éventuellement présentes dans le contenu informatif de cette documentation. Attachmate, le logo Attachmate, FileXpress et Reflection sont des marques déposées d'Attachmate Corporation aux ÉtatsUnis. Les autres marques, noms commerciaux ou noms d'entreprises référencés dans ce document sont uniquement utilisés à des fins d'identification et appartiennent à leurs propriétaires respectifs. Table des matières Guide d'installation de Reflection for the Web 12.3 5 1 Nouveautés de la version 12.3 7 Changements au niveau de l'installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 À propos de la mise à niveau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Mise à niveau depuis Reflection for the Web 12.2 ou Reflection for the Web 2014 R2 (12.1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Mise à niveau à partir d'une version antérieure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 En cas de version d'évaluation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2 Introduction 9 Présentation de Reflection for the Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3 Préparation de l'installation 13 Conditions préalables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Configuration système requise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Configuration requise pour le serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Configuration requise pour les sessions terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Configuration requise pour Management and Security Server . . . . . . . . . . . . . . . . . . . . . . 15 4 Utilisation du programme d'installation automatique 17 Installation de Reflection for the Web 12.3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 A. Installer Management and Security Server 12.3 sur le même ordinateur. . . . . . . . . . . . . . . . . . . . 18 Étapes suivantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 B. Utiliser une version existante de Management and Security Server 12.3 sur le même ordinateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Continuez à suivre les instructions du programme d'installation automatique. . . . . . . . . . . 20 Étapes suivantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 C. Utiliser une version existante de Management and Security Server 12.3 sur un autre ordinateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Si vous effectuez une mise à niveau à partir de la version 12.2 . . . . . . . . . . . . . . . . . . . . . 21 Étape 1. Installer Reflection for the Web 12.3 sur un autre ordinateur. . . . . . . . . . . . . . . . . 21 Étape 2. Installer le fichier d'activation Reflection for the Web. . . . . . . . . . . . . . . . . . . . . . 23 Étapes suivantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5 Installation manuelle 25 Conditions préalables et configuration requise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Procédures d'installation manuelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Étape 1. Télécharger et extraire le fichier du produit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Étape 2. Modifier et déployer les fichiers WAR des composants. . . . . . . . . . . . . . . . . . . . . 26 Étape 3. Installer le fichier d'activation Reflection for the Web. . . . . . . . . . . . . . . . . . . . . . 27 Étape 4. Facultatif : installation de produits complémentaires. . . . . . . . . . . . . . . . . . . . . . . 28 Variantes en matière d'installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Installation sans environnement JRE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Installation de composants individuels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Table des matières 3 6 Mise à niveau vers la version 12.3 29 Mise à niveau à partir de Reflection for the Web 12.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Mise à niveau à partir de Reflection for the Web 2014 ou d'une version antérieure . . . . . . . . . . . . . 30 Mise à jour des fichiers d'activation des composants et des produits complémentaires . . . . . . . . . . 30 Utilisation de modèles JSP pour personnaliser les pages ou les sessions . . . . . . . . . . . . . . . . . . . . 31 Mise à niveau de sessions statiques personnalisées. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Pour mettre à niveau des sessions statiques : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 7 Désinstallation de la version 12.3 Termes 4 Guide d'installation 33 35 Guide d'installation de Reflection for the Web 12.3 Le Guide d'installation de Reflection for the Web est également disponible en allemand : English Allemand Reportez-vous à la section Nouveautés de la version 12.3. Guide d'installation de Reflection for the Web 12.3 5 6 Guide d'installation 1 Nouveautés de la version 12.3 1 À partir de la version 12.3, Reflection for the Web est proposé en tant qu'application Web distincte qui nécessite l'installation de la console Host Access Management and Security Server pour configurer et gérer des sessions Web sur une grande variété d'hôtes. Votre licence Reflection for the Web 12.3 vous permet d'utiliser les produits suivants : Host Access Management and Security Server Proxy de sécurité (à l'exception de l'édition limitée) Terminal ID Management Présentation rapide des nouveautés : « Changements au niveau de l'installation » page 7 « À propos de la mise à niveau » page 7 « En cas de version d'évaluation » page 8 Changements au niveau de l'installation La version 12.3 de Reflection for the Web est installée indépendamment de Management and Security Server 12.3. Les deux versions doivent être compatibles. Prenez en compte les options cidessous avant de procéder à l'installation. Installation automatique. Le programme d'installation automatique vous permet d'installer Reflection for the Web et Management and Security Server. Vous pouvez également utiliser une installation existante de Management and Security Server, à condition que les versions soient compatibles. Installation manuelle. Reflection for the Web peut être installé à partir d'un fichier .war. Ce Guide d'installation présente les différentes étapes à suivre pour installer ou mettre à niveau Reflection for the Web. Pour plus d'informations sur l'utilisation des options et des fonctionnalités de Management and Security Server, reportez-vous au Guide d'installation de Host Access Management and Security Server. À propos de la mise à niveau Le processus de mise à niveau varie en fonction de la version déjà installée. Vous trouverez tous les détails nécessaires dans le chapitre consacré à la mise à niveau. Nouveautés de la version 12.3 7 Mise à niveau depuis Reflection for the Web 12.2 ou Reflection for the Web 2014 R2 (12.1) Le programme d'installation automatique de Reflection for the Web vérifie si Management and Security Server a déjà été installé. Plusieurs options sont à votre disposition en fonction des produits ayant été détectés. Le chemin d'installation ne change pas. Mise à niveau à partir d'une version antérieure Si vous procédez à une mise à niveau depuis Reflection for the Web 2014 R1 (12.0) ou Reflection for the Web 2011 (11.0), vous devez tout d'abord installer Reflection for the Web 12.2 avant d'installer la version 12.3. REMARQUE : À partir de la version 12.2, plusieurs composants de Management and Security Server ont été renommés : Le serveur de gestion devient le serveur administratif. Le dossier ReflectionData devient MSSData. Le Gestionnaire d'ID devient Terminal ID Management. Le chemin d'installation par défaut (sous Windows) correspond à C:\Program Files\Micro Focus\MSS. Pour obtenir de l'aide, contactez le support technique. En cas de version d'évaluation Si vous exécutez une version d'évaluation, celle-ci sera totalement fonctionnelle pendant 120 jours. Pendant cette période, vous pouvez installer, configurer et tester Reflection for the Web. Suivez les étapes d'installation présentées dans ce guide, puis parcourez le scénario d'évaluation décrit dans la note technique 2818 (en anglais) : Évaluation de Reflection for the Web. Contactez Micro Focus ou votre revendeur agréé pour obtenir la version complète du logiciel. 8 Guide d'installation 2 Introduction 2 Reflection for the Web 12.3 est une application Web qui nécessite l'installation de Management and Security Server pour créer, sécuriser et gérer des sessions terminal. Le programme d'installation automatique de Reflection for the Web vérifie si une version compatible de Management and Security Server a déjà été installée. Si tel est le cas, vous pouvez utiliser celle qui existe. Sinon, vous avez la possibilité d'installer Management and Security Server dans le cadre de l'installation de Reflection for the Web. REMARQUE : Dans les versions de Reflection for the Web antérieures à la version 12.2, le serveur de gestion était utilisé pour créer et configurer des sessions. Depuis la version 12.2, vous pouvez utiliser le serveur administratif, qui fait partie intégrante de Management and Security Server. Présentation de Reflection for the Web Reflection for the Web propose des applets Java pour déployer des sessions d'émulation terminal Web pour vos utilisateurs. Les sessions terminal de Reflection for the Web sont gérées et sécurisées de façon centralisée à l'aide du serveur administratif de Management and Security Server. À l'aide de Reflection for the Web et de Management and Security Server, vous pouvez configurer des sessions d'émulation terminal basées sur le Web et sécurisées, qui se connectent à des applications hôtes situées à l'intérieur ou à l'extérieur du pare-feu. Voici rapidement la façon dont tout cela fonctionne : 1 Un administrateur installe Reflection for the Web sur un serveur, puis installe Management and Security Server ou utilise une instance existante. 2 L'administrateur utilise la station Web Administrative (dans Management and Security Server) pour créer, configurer et sécuriser les sessions d'émulation terminal. Des paramètres de sécurité facultatifs peuvent être définis session par session. 3 Le lanceur Reflection for the Web est téléchargé sur le poste de travail de l'utilisateur. 4 Un utilisateur clique sur un lien pour démarrer une session terminal. 5 L'utilisateur se connecte au système hôte et communique avec celui-ci à l'aide de l'applet d'émulation téléchargée. ________________________________________________________________________________ Introduction 9 Le diagramme ci-dessous présente l'interaction entre Reflection for the Web, Management and Security Server (le serveur administratif) et le serveur proxy de sécurité afin de renforcer la sécurité. 1. L'utilisateur de Reflection for the Web se connecte au serveur administratif. 2. Il s'authentifie auprès d'un serveur d'annuaire (LDAP/Active Directory) ou d'un autre système de gestion des identités (facultatif). 3. Le serveur d'annuaire fournit une identité d'utilisateur et de groupe (facultatif). 4. Le serveur administratif envoie la session d'émulation au client authentifié. 5. Lorsque le serveur proxy de sécurité, disponible en option, est configuré pour être utilisé par une session, l'applet d'émulation établit une connexion TLS avec ce serveur et lui envoie un jeton signé. 6. Lorsqu'il est présent, le serveur proxy de sécurité valide le jeton de session et établit une connexion au port de l'hôte qu'il spécifie. 7. Lorsqu'aucun serveur proxy de sécurité n'est présent ou qu'aucune session n'est configurée pour l'utiliser, un utilisateur authentifié se connecte directement à l'hôte. Serveur administratif Le serveur administratif, disponible dans Management and Security Server, comprend la station Web Administrative et les fichiers d'émulation de terminal, qui sont tous les deux installés sur un serveur Web. 10 Guide d'installation Après avoir installé Management and Security Server (ou sélectionné une installation existante), vous pouvez ouvrir la station Web Administrative, qui se présente sous la forme d'une application Web autonome. Utilisez la station Web Administrative pour gérer et configurer des sessions terminal Web. Avec Reflection for the Web, les applets Java déploient des sessions d'émulation de terminal pour vos utilisateurs. Composants facultatifs Votre licence Reflection for the Web vous permet d'utiliser ces composants disponibles en option dans Management and Security Server : Serveur proxy de sécurité : fait office de proxy pour les sessions terminal en acheminant le trafic réseau chiffré depuis et vers les postes de travail des utilisateurs. (Le proxy de sécurité n'est pas compris dans l'édition limitée de Reflection for the Web.) Serveur de comptage : surveille l'utilisation des sessions terminal. Terminal ID Management : met en attente les ID terminal, suit l'utilisation des ID et gère les valeurs de délai d'inactivité propres à des utilisateurs spécifiques. Pour plus d'informations sur l'installation, la configuration et l'utilisation de ces composants, consultez le Guide d'installation de Management and Security Server. Introduction 11 12 Guide d'installation 3 Préparation de l'installation 3 Reflection for the Web est une application Web qui nécessite la présence de Management and Security Server. Pendant l'installation, le programme d'installation automatique de Reflection for the Web vérifie si Management and Security Server a déjà été installé sur votre ordinateur et propose les options suivantes : Installer Management and Security Server sur le même ordinateur que Reflection for the Web. Utiliser l'installation locale existante de Management and Security Server sur votre système. Utiliser une installation de Management and Security Server hébergée à distance. REMARQUE : Pour la phase de test initiale, vous pouvez procéder à une installation de Reflection for the Web et de Management and Security Server sur un poste de travail. Nous vous recommandons toutefois d'utiliser un système d'exploitation serveur destiné à la production. Dans ce chapitre : « Conditions préalables » page 13 « Configuration système requise » page 14 Conditions préalables Avant d'installer Reflection for the Web 12.3, vérifiez les points suivants : Votre version de Management and Security Server correspond au moins à la version 12.2. Vous pouvez utiliser une installation existante ou le programme d'installation automatique de Reflection for the Web pour installer la version 12.3. Tout composant Reflection for the Web ou Management and Security Server en cours d'exécution est automatiquement fermé. (Le programme d'installation automatique de la version 12.3 fermera les composants lui-même si vous avez installé une version précédente à l'aide d'un programme d'installation automatique.) Les droits d'accès au compte nécessaires pour installer les composants sur le serveur cible sont disponibles. Si vous prévoyez d'utiliser des certificats client X.509 ou un contrôle d'accès LDAP sécurisé, assurez-vous que le compte utilisé pour exécuter le serveur administratif dispose des droits d'accès en écriture nécessaires pour le fichier de certificats d'autorité de certification Java SDK (cacerts). Sous Windows, l'emplacement par défaut est le suivant : C:\Program Files\Micro Focus\MSS\jre\lib\security Remarque : Si vous effectuez une mise à niveau, l'emplacement Windows reste le suivant : C:\Program Files\Attachmate\ReflectionServer\jre\lib\security Remarque : Les composants disponibles en option, dont le serveur de comptage, le serveur proxy de sécurité et Terminal ID Management, peuvent être installés en même temps que Reflection for the Web ou ajoutés ultérieurement. Préparation de l'installation 13 Configuration système requise Les composants Reflection for the Web peuvent être installés sur un serveur unique ou sur plusieurs serveurs distincts. Reflection for the Web requiert les configurations suivantes : « Configuration requise pour le serveur » page 14 « Configuration requise pour les sessions terminal » page 14 « Configuration requise pour Management and Security Server » page 15 Configuration requise pour le serveur Système d'exploitation de type serveur À des fins de production, un système de type serveur est requis. À des fins de test initial ou d'évaluation, il est possible d'utiliser un poste de travail. Serveur ou serveur d'application exécutant JRE 8 ou une version ultérieure JRE 8 est installé par le programme d'installation automatique. Configuration requise pour les sessions terminal N'importe quel navigateur Web utilisant la version 8 de l'environnement JRE ou une version ultérieure et pouvant exécuter des applets autorisées. Il est possible que les connexions TLS à votre hôte nécessitent l'utilisation de fichiers de politique juridictionnelle à niveau illimité JCE (Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files). Les fichiers de politique juridictionnelle « à portée illimitée » ne contiennent absolument aucune restriction sur les niveaux de cryptographie contrairement aux fichiers de politique cryptographique de portée « puissante » mais limitée, associés à un environnement JRE. Pour appliquer des fichiers de politique juridictionnelle à portée illimitée JCE : 1. Téléchargez les fichiers de politique juridictionnelle à portée illimitée JCE (Java Cryptography Extension) depuis le site d'Oracle ou d'IBM. Veillez à télécharger les mises à jour du fichier de politique appropriées à votre version de Java : Java 8 : http://www.oracle.com/technetwork/java/javase/downloads/index.html IBM : https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=jcesdk 2. Décompressez et extrayez le fichier téléchargé. Le téléchargement comprend un fichier Readme.txt et deux fichiers .jar portant les mêmes noms que les fichiers de politique existants. 3. Localisez les deux fichiers de politique existants : local_policy.jar US_export_policy.jar Sous UNIX, recherchez dans <java-home>/lib/security/ Sous Windows, recherchez dans C:\Program Files\Java\jre<version>\lib\security\ 4. Remplacez les fichiers de politique existants par les fichiers de politique à portée illimitée que vous venez d'extraire. 14 Guide d'installation REMARQUE : Les fichiers de politique juridictionnelle à portée illimitée JCE doivent être appliqués à chaque mise à niveau de votre environnement JRE. Configuration requise pour Management and Security Server La configuration requise pour Management and Security Server est précisée dans le Guide d'installation de Management and Security Server. Préparation de l'installation 15 16 Guide d'installation 4 Utilisation du programme d'installation automatique 4 Le programme d'installation automatique est le moyen le plus simple pour installer Reflection for the Web et vous lancer rapidement. Vous pouvez utiliser le programme d'installation automatique sous Linux, Solaris SPARC64 et Windows. Dans ce chapitre : « Installation de Reflection for the Web 12.3 » page 17 « A. Installer Management and Security Server 12.3 sur le même ordinateur. » page 18 « B. Utiliser une version existante de Management and Security Server 12.3 sur le même ordinateur. » page 20 « C. Utiliser une version existante de Management and Security Server 12.3 sur un autre ordinateur. » page 21 Installation de Reflection for the Web 12.3 Suivez ces étapes pour installer Reflection for the Web à partir d'une nouvelle installation de Management and Security Server ou d'une version existante. 1 Exécutez le programme d'installation automatique correspondant à votre édition et à votre plate- forme Reflection for the Web 12.3. Par exemple : rwebenterprise-12.3.<nnn>-prod-wx64.exe rwebairlines-12.3.<nnn>-prod-linuxx64.sh REMARQUE : Vous pouvez exécuter le programme d'installation automatique en mode console à l'aide d'un paramètre -c . Cette option, fréquemment employée pour les systèmes autres que Windows, utilise une ligne de commande pour les entrées et les sorties plutôt qu'une interface graphique. Tous les écrans présentent les informations dans la console et permettent de saisir les mêmes données que le programme d'installation automatique. 2 Cliquez sur Suivant pour installer Reflection for the Web. 3 Le programme d'installation de Reflection for the Web détecte si Management and Security Server est installé sur le même ordinateur et propose plusieurs options d'installation. Continuez à suivre les instructions de votre scénario d'installation : A. Installer Management and Security Server 12.3 sur le même ordinateur que Reflection for the Web. B. Utiliser une version existante de Management and Security Server 12.3 sur le même ordinateur que Reflection for the Web. C. Utiliser une version existante de Management and Security Server sur un autre ordinateur. Utilisation du programme d'installation automatique 17 A. Installer Management and Security Server 12.3 sur le même ordinateur. Ce scénario concerne les nouvelles installations de Reflection for the Web et de Management and Security Server sur le même ordinateur. Lorsque le programme d'installation automatique ne détecte aucune version de Management and Security Server sur l'ordinateur sur lequel vous souhaitez installer Reflection for the Web, la boîte de dialogue suivante apparaît : 1 Sélectionnez Installer MSS. 2 Cliquez sur Suivant pour lancer l'installation de Management and Security Server (MSS). Suivez toutes les étapes du programme d'installation MSS et exécutez l'utilitaire de configuration initiale pour configurer Management and Security Server. 18 Guide d'installation 3 Lorsque vous y êtes invité, vous avez la possibilité de démarrer les services installés. 4 Une fois l'installation de MSS terminée, les composants installés sont répertoriés. Cliquez sur le lien Serveur administratif pour commencer à utiliser Management and Security Server. 5 L'application Reflection for the Web sera ensuite installée dans Management and Security Server. L'emplacement [Windows] par défaut est le suivant : C:\Program Files\Micro Focus\MSS\server\web\webapps\rweb-client 6 Si vous y êtes invité, redémarrez le serveur MSS. 7 À l'issue de l'installation de Reflection for the Web 12.3, cliquez sur Terminer. Étapes suivantes À ce stade, Reflection for the Web 12.3 est installé. Vous pouvez commencer à utiliser la station Web Administrative pour créer et configurer des sessions. Reportez-vous au Guide d'installation de Management and Security Server pour Configurer le comptage Configurer le serveur proxy de sécurité Configurer Terminal ID Management Configurer les modules complémentaires de Management and Security Server Utilisation du programme d'installation automatique 19 B. Utiliser une version existante de Management and Security Server 12.3 sur le même ordinateur. Lorsque le programme d'installation automatique détecte une version de Management and Security Server, la boîte de dialogue suivante apparaît : REMARQUE : Si une mise à niveau de Management and Security Server est nécessaire et prise en charge, sélectionnez l'option Mettre à niveau l'installation MSS locale existante. Continuez à suivre les instructions du programme d'installation automatique. 1 Sélectionnez Utiliser l'installation MSS locale existante. Cliquez sur Suivant. 2 L'application Reflection for the Web sera installée dans Management and Security Server. L'emplacement [Windows] par défaut est le suivant : C:\Program Files\Micro Focus\MSS\server\web\webapps\rweb-client 3 Si vous y êtes invité, redémarrez le serveur MSS. 4 À l'issue de l'installation de Reflection for the Web 12.3, cliquez sur Terminer. Étapes suivantes À ce stade, Reflection for the Web 12.3 est installé. Vous pouvez commencer à utiliser la station Web Administrative pour créer et configurer des sessions. Reportez-vous au Guide d'installation de Management and Security Server pour Configurer le comptage Configurer le serveur proxy de sécurité Configurer Terminal ID Management 20 Guide d'installation Configurer les modules complémentaires de Management and Security Server C. Utiliser une version existante de Management and Security Server 12.3 sur un autre ordinateur. Si vous sélectionnez l'option Utiliser une version MSS hébergée à distance dans le cadre d'une nouvelle installation de Reflection for the Web 12.3, prenez connaissance de la configuration requise ci-dessous : La version de Management and Security Server doit correspondre à la version 12.3. (Toute version antérieure doit être mise à niveau.) REMARQUE : Lorsque Reflection for the Web et Management and Security Server (MSS) sont installés sur des ordinateurs séparés ou lors de l'utilisation du fichier WAR RWeb dans un programme d'exécution de servlet distinct, nous vous recommandons d'accéder à toutes les applications Web à partir de l'ordinateur exécutant Reflection for the Web. Par exemple : https://rwebhost/mss Lorsque vous êtes prêt, passez à l'Étape 1. Si vous effectuez une mise à niveau à partir de la version 12.2 Si vous effectuez une mise à niveau de Reflection for the Web 12.2 et que vous souhaitez passer à une solution multiserveur (où Management and Security Server et Reflection for the Web sont installés sur des serveurs distincts), procédez comme suit : 1 Installez Management and Security Server 12.3 sur l'ordinateur sur lequel se trouve la version 12.2 de Reflection for the Web : 1a Exécutez le programme d'installation MSS, qui a été placé dans le répertoire mss dans lequel vous avez téléchargé le produit. 1b Pour obtenir de l'aide, consultez le Guide d'installation de Host Access Management and Security Server. 2 Poursuivez l'Étape 1 pour installer Reflection for the Web 12.3 sur un autre ordinateur. Étape 1. Installer Reflection for the Web 12.3 sur un autre ordinateur. Installez Reflection for the Web 12.3 sur un autre ordinateur en tant que produit autonome à l'aide du programme d'installation automatique. Le programme d'installation automatique installe un conteneur d'application Web par défaut et effectue quelques configurations de base. 1 Exécutez le programme d'installation automatique correspondant à votre édition de Reflection for the Web. 2 Lorsque vous y êtes invité, sélectionnez l'option Utiliser une version MSS hébergée à distance. Utilisation du programme d'installation automatique 21 Cliquez sur Suivant et entrez l'emplacement d'installation de Management and Security Server 12.3. 3 Le programme d'installation automatique Reflection for the Web installe : un environnement JRE. des composants serveur, dont un proxy Web pour la gestion des URL /mss, un programme de redirection pour la gestion des URL /rweb et le client d'émulation rweb. 4 Sécurisez la connexion entre Reflection for the Web et Management and Security Server. Entrez vos paramètres : Nom de l'hôte, nom DNS ou adresse IP. Port. La valeur par défaut est 443. Contexte de servlet de gestion. Protocole. La valeur par défaut est HTTPS. 5 À l'issue de l'installation de Reflection for the Web, cliquez sur Terminer. 6 Poursuivez avec l'Étape 2 pour installer le fichier d'activation. 22 Guide d'installation Étape 2. Installer le fichier d'activation Reflection for the Web. Le fichier d'activation Reflection for the Web est nécessaire pour que Management and Security Server puisse interagir avec Reflection for the Web sur un ordinateur différent. Pour installer le fichier d'activation : 1 Ouvrez Management and Security Server > Station Web Administrative > Ressources > À propos de Management and Security Server. 2 Accédez* à l'emplacement dans lequel vous avez téléchargé le programme d'installation automatique Reflection for the Web. Le nom du fichier d'activation se présente de la façon suivante : activation.rweb_<product>_edition-12.3.jaw 3 Sélectionnez le fichier et cliquez sur Installer. 4 Actualisez ensuite votre navigateur ou redémarrez-le. Les fonctionnalités de Reflection for the Web apparaissent dans la station Web Administrative : La boîte de dialogue À propos de affiche votre édition de Reflection for the Web. Le Gestionnaire de session prend en charge les sessions Web. L'option Références > Options avancées permet d'accéder à des exemples de scripts et de codes. * Ou téléchargez le fichier d'activation depuis le site à partir duquel vous avez récupéré Reflection for the Web, puis accédez à cet emplacement. Étapes suivantes À ce stade, Reflection for the Web 12.3 est installé. Vous pouvez commencer à utiliser la station Web Administrative pour créer et configurer des sessions. Reportez-vous au Guide d'installation de Management and Security Server pour Configurer le comptage Configurer le serveur proxy de sécurité Configurer Terminal ID Management Configurer les modules complémentaires de Management and Security Server Utilisation du programme d'installation automatique 23 24 Guide d'installation 5 Installation manuelle 5 Bien qu'il soit recommandé de procéder à une installation automatique, vous pouvez installer Management and Security Server manuellement. Un fichier WAR est disponible pour Reflection for the Web. Effectuez une installation manuelle dans l'une des situations suivantes : Vous souhaitez utiliser un programme d'exécution de servlet différent de celui ayant été installé automatiquement avec le produit. Vous effectuez l'installation sur une plate-forme qui ne prend en charge aucun programme d'installation automatique. Vous ne pouvez pas exécuter le programme d'installation automatique pour toute autre raison. Dans ce chapitre : « Conditions préalables et configuration requise » page 25 « Procédures d'installation manuelle » page 25 « Variantes en matière d'installation » page 28 Conditions préalables et configuration requise Pour une installation manuelle, Reflection for the Web doit être installé sur un hôte différent ou dans un programme d'exécution de servlet autre que Management and Security Server. Host Access Management and Security Server 12.3 doit être installé et accessible depuis le programme d'exécution de servlet de Reflection for the Web. La version 8 ou ultérieure d'un environnement JRE doit être installée. Si vous n'en avez pas encore, téléchargez la toute dernière version depuis le site Web d'Oracle. Vous devez télécharger une version du JRE incluant la JVM du serveur. L'environnement JRE fourni avec le kit JDK inclut la JVM du serveur. REMARQUE : Si votre système requiert un environnement JRE autre que celui par défaut, vous pouvez procéder à cette installation manuelle sous z/OS, Mac et HP-UX, ainsi que d'autres systèmes Linux. Procédures d'installation manuelle Pour installer et configurer manuellement Reflection for the Web, vous devez extraire, modifier et déployer les fichiers WAR des composants, puis activer le produit. « Étape 1. Télécharger et extraire le fichier du produit. » page 26 « Étape 2. Modifier et déployer les fichiers WAR des composants. » page 26 « Étape 3. Installer le fichier d'activation Reflection for the Web. » page 27 « Étape 4. Facultatif : installation de produits complémentaires. » page 28 Installation manuelle 25 Étape 1. Télécharger et extraire le fichier du produit. 1 Depuis le site de téléchargement du produit, récupérez le fichier correspondant à votre édition de Reflection for the Web et à votre plate-forme. Par exemple : rwebenterprise-12.3.<nnn>-prod-war.zip 2 Extrayez le fichier .zip. 3 Dans le répertoire install_manual/components, localisez les trois fichiers war : mss.war rweb.war rweb-client.war Étape 2. Modifier et déployer les fichiers WAR des composants. Pour configurer l'application Web Reflection for the Web, vous devez modifier le fichier web.xml de façon à remplacer les valeurs <placeholder> dans les fichiers mss.war et rweb.war. Puis, chaque fichier WAR doit être déployé. REMARQUE : Lorsque Reflection for the Web et Management and Security Server (MSS) sont installés sur des ordinateurs séparés ou lors de l'utilisation du fichier WAR RWeb dans un programme d'exécution de servlet distinct, nous vous recommandons d'accéder à toutes les applications Web à partir de l'ordinateur ou de l'application exécutant Reflection for the Web. Par exemple : https://rwebhost/mss « A. Modifiez et déployez le fichier mss.war. » page 26 « B. Modifiez et déployez le fichier rweb.war. » page 27 « C. Déployez le fichier rweb-client.war. » page 27 A. Modifiez et déployez le fichier mss.war. Le fichier mss.war correspond au proxy Web MSS, qui est nécessaire pour que Reflection for the Web puisse interagir avec Management and Security Server. 1 Extrayez le fichier mss.war. 2 Accédez au dossier WEB-INF, puis ouvrez le fichier web.xml dans un éditeur de texte. 3 Localisez les trois entrées « trust-store-[placeholder] ». Les entrées « trust-store » sont nécessaires au stockage d'un certificat dans la bibliothèque des certificats autorisés. trust-store-file trust-store-type trust-store-password 4 Remplacez chaque valeur « trust-store-[placeholder] » par la valeur propre à votre configuration. 5 Localisez la variable [mss-url] et remplacez-la par l'URL du serveur MSS. Par exemple : https://msshost/mss 6 Déployez le fichier mss.war auprès de votre programme d'exécution de servlet. 26 Guide d'installation B. Modifiez et déployez le fichier rweb.war. Le fichier rweb.war redirige les demandes des clients du chemin /rweb, utilisé dans les versions Reflection for the Web et Management and Security Server antérieures à la version 12.2, vers le chemin /mss . Modifiez les variables « trust-store » dans le fichier rweb.war : 1 Extrayez le fichier rweb.war. 2 Accédez au dossier WEB-INF, puis ouvrez le fichier web.xml dans un éditeur de texte. 3 Localisez et remplacez les trois entrées « trust-store-[placeholder] » : trust-store-file trust-store-type trust-store-password 4 Déployez le fichier rweb.war auprès de votre programme d'exécution de servlet. C. Déployez le fichier rweb-client.war. 1 Déployez le fichier rweb-client.war auprès de votre programme d'exécution de servlet. REMARQUE : Le fichier web.xml n'a pas besoin d'être modifié. 2 Poursuivez avec l'Étape 3 pour installer le fichier d'activation. Étape 3. Installer le fichier d'activation Reflection for the Web. Le fichier d'activation Reflection for the Web est nécessaire pour que Management and Security Server puisse interagir avec Reflection for the Web sur un ordinateur différent. Pour installer le fichier d'activation : 1 Ouvrez Management and Security Server > Station Web Administrative > Ressources > À propos de Management and Security Server. 2 Accédez* à l'emplacement dans lequel vous avez téléchargé le programme Reflection for the Web. Le nom du fichier d'activation se présente de la façon suivante : activation.rweb_<product>_edition-12.3.jaw 3 Sélectionnez le fichier et cliquez sur Installer. 4 Actualisez votre navigateur ou redémarrez-le. Les fonctionnalités de Reflection for the Web apparaissent dans la station Web Administrative : La boîte de dialogue À propos de affiche votre édition de Reflection for the Web. Le Gestionnaire de session prend en charge les sessions Web. L'option Références > Options avancées permet d'accéder à des exemples de scripts et de codes. * Ou téléchargez le fichier d'activation depuis le site à partir duquel vous avez récupéré Reflection for the Web, puis accédez à cet emplacement. Installation manuelle 27 Étape 4. Facultatif : installation de produits complémentaires. Si vous avez acheté des produits complémentaires, comme Automated Sign-On for Mainframe, vous devez installer le fichier d'activation correspondant. Pour installer le fichier d'activation : 1 Téléchargez le fichier d'activation correspondant au produit complémentaire, dont le format est le suivant : activation.<product_name>.jaw 2 Copiez le contenu du fichier d'activation dans le fichier rweb-client.war à l'emplacement suivant : ex\modules 3 Redémarrez l'application Web. Variantes en matière d'installation « Installation sans environnement JRE » page 28 « Installation de composants individuels » page 28 Installation sans environnement JRE Procédez de la façon suivante. 1 Pour utiliser l'une de ces installations -unix-nojre-, confirmez que vous avez déjà installé un environnement d'exécution Java approprié à votre plate-forme. Par exemple, pour installer Reflection for the Web sur une machine z/Linux, téléchargez l'environnement JRE à partir de l'emplacement suivant : http://www.ibm.com/developerworks/java/jdk/linux/download.html 2 Développez le package que vous souhaitez utiliser, comme rwebenterprise-prod-unix-nojre-manual.tar.gz Remarque : La version de votre environnement JRE doit correspondre à la version 8 ou à une version ultérieure. Installation de composants individuels Les composants suivants font partie de Management and Security Server. Pour installer un composant manuellement, consultez le Guide d'installation de Host Access Management and Security Server. Serveur administratif Serveur de comptage Terminal ID Management Proxy de sécurité 28 Guide d'installation 6 Mise à niveau vers la version 12.3 6 Pour vous préparer à la mise à niveau, reportez-vous aux sections appropriées : « Mise à niveau à partir de Reflection for the Web 12.2 » page 29 « Mise à niveau à partir de Reflection for the Web 2014 ou d'une version antérieure » page 30 « Mise à jour des fichiers d'activation des composants et des produits complémentaires » page 30 « Utilisation de modèles JSP pour personnaliser les pages ou les sessions » page 31 « Mise à niveau de sessions statiques personnalisées » page 31 Mise à niveau à partir de Reflection for the Web 12.2 Pour mettre à niveau Reflection for the Web de la version 12.2 à la version 12.3 : 1 Exécutez le programme d'installation automatique de Reflection for the Web 12.3. Le programme d'installation détecte la version 12.2 de Management and Security Server et vous propose d'effectuer la mise à niveau. 2 Une fois l'option sélectionnée, le programme d'installation de Reflection for the Web lance le programme d'installation de Management and Security Server, qui met à niveau Management and Security Server vers la version 12.3. Mise à niveau vers la version 12.3 29 3 Le programme d'installation de Reflection for the Web termine ensuite l'installation de la version 12.3 de Reflection for the Web. 4 N'oubliez pas de mettre à jour les fichiers d'activation des composants et des produits complémentaires. Mise à niveau à partir de Reflection for the Web 2014 ou d'une version antérieure Pour procéder à la mise à niveau vers Reflection for the Web 12.3 à partir d'une version antérieure : 1 Vous devez tout d'abord installer Reflection for the Web 12.2, qui comprend Management and Security Server 12.2. Pour obtenir de l'aide, consultez la note technique 2875 (en anglais). REMARQUE : À partir de la version 12.2, plusieurs composants de Management and Security Server ont été renommés : Le serveur de gestion devient le serveur administratif. Le dossier ReflectionData devient MSSData. Le Gestionnaire d'ID devient Terminal ID Management. Le chemin d'installation par défaut (sous Windows) correspond à C:\Program Files\Micro Focus\MSS. 2 Procédez ensuite à la mise à niveau à partir de Reflection for the Web 12.2. 3 N'oubliez pas de mettre à jour les fichiers d'activation des composants et des produits complémentaires. Pour obtenir de l'aide, contactez le support technique. Mise à jour des fichiers d'activation des composants et des produits complémentaires Après avoir installé Reflection for the Web, vous devez mettre à jour des fichiers d'activation spécifiques pour garantir le fonctionnement continu de vos composants et produits complémentaires installés. Management and Security Server vérifie la compatibilité des versions et peut être amené à bloquer toute opération tant que les fichiers d'activation ne sont pas mis à jour. Les composants de Reflection for the Web et les produits complémentaires de Management and Security Server sont les suivants : Proxy de sécurité Terminal ID Management Automated Sign-On for Mainframe Micro Focus Advanced Authentication Pour procéder à la mise à niveau : 1 Depuis votre emplacement de téléchargement, récupérez les fichiers d'activation 12.3 de vos composants et de vos produits complémentaires. 2 Placez les fichiers d'activation dans le même répertoire que le programme d'installation de Reflection for the Web. 30 Guide d'installation 3 Exécutez le programme d'installation de Reflection for the Web. Les fichiers d'activation seront propagés aux emplacements définis pour Reflection for the Web et Management and Security Server. REMARQUE : Lorsque les fichiers d'activation se trouvent dans le répertoire du programme d'installation, vous n'avez pas besoin d'utiliser la station Web Administrative pour installer le fichier d'activation, comme l'indique la procédure d'installation du produit. Utilisation de modèles JSP pour personnaliser les pages ou les sessions Si vous avez utilisé des modèles JSP pour personnaliser votre page de connexion/de liste de liens ou vos sessions Reflection for the Web imbriquées, vous pouvez être amené à faire quelques modifications. Il est nécessaire d'apporter des changements à la balise applet pour prendre en compte les modifications apportées aux emplacements d'installation de Management and Security Server et Reflection for the Web 12.3. Pour plus d'informations sur les changements concernant la syntaxe, consultez le fichier templates.txt. Des exemples de modèles sont disponibles dans le dossier templates/samples. Autres références : Note technique 2386 : Utilisation de modèles dans Reflection for the Web Note technique 2580 : Programmation avec Reflection for the Web Mise à niveau de sessions statiques personnalisées Lorsque des sessions terminal sont créées ou modifiées à l'aide du Gestionnaire de session, les sessions protégées sont mises à niveau pendant les procédures de mise à niveau en cas d'utilisation d'un programme d'installation automatique ou pendant la phase de démarrage (lors du démarrage du serveur Web par défaut) après une installation manuelle. Étant donné que Reflection for the Web et Management and Security Server sont des produits distincts dans la version 12.3, il est possible que les pages de sessions statiques personnalisées aient besoin d'être mises à jour manuellement de façon à pouvoir charger l'applet Reflection for the Web depuis son nouvel emplacement d'installation. Cette mise à jour peut éventuellement nécessiter la modification de certains attributs et paramètres de l'applet, comme codebase, archive et cache_archive. Si l'une de ces conditions est remplie, suivez les étapes permettant de mettre à niveau les sessions statiques. Les sessions n'ont pas été enregistrées à l'aide du Gestionnaire de session. Le code HTML de votre ou de vos sessions a été modifié manuellement. Vous souhaitez mettre à niveau les sessions statiques pour une raison quelconque. REMARQUE : Si certains fichiers de définition de clavier ne figurent pas dans un fichier de configuration, vous devez mettre ces fichiers à niveau pour pouvoir mettre à niveau les sessions. Mise à niveau vers la version 12.3 31 Pour mettre à niveau des sessions statiques : 1 Ouvrez une fenêtre d'invite de commandes et modifiez les répertoires afin de trouver l'emplacement ci-dessous. Pour Windows, l'emplacement est le suivant : [installation path]\apache-tomcat\webapps\rweb\WEB-INF\lib 2 Sur la même ligne de commande, entrez la syntaxe appropriée (affichée ci-dessous) sur une seule ligne pour mettre à niveau vos fichiers de configuration spécifiés : Langue. Sur la ligne de commande, incluez la langue à utiliser : allemand (de), anglais (en) ou français (fr). Nom du répertoire ou du fichier relatif ou absolu contenant les fichiers de configuration. (Vous devez pouvoir accéder à ce fichier ou à ce répertoire à partir de la machine sur laquelle vous effectuez la mise à niveau.) Entrez la commande suivante sur une seule ligne : java -classpath RWebServlet.jar com.wrq.util.upgrade.ConfigUpgrade -locale <de|en|fr> <nom du fichier|répertoire> Exemple. Pour mettre à niveau les fichiers de configuration du répertoire de session destiné à la version anglaise, suivez les étapes ci-dessous. 1 À l'invite de commandes, modifiez les répertoires pour parvenir à l'emplacement suivant : C:\Program Files\Micro Focus\MSS\server\web\webapps\rweb-client\WEB-INF\lib 2 Entrez la commande suivante sur une seule ligne : java -classpath RWebServlet.jar com.wrq.util.upgrade.ConfigUpgrade -locale en "C:\Program Files\Micro Focus\MSS\apache-tomcat\webapps\rweb\session" 32 Guide d'installation 7 Désinstallation de la version 12.3 7 Pour procéder à la désinstallation : Sous Windows : Utilisez la fonctionnalité Ajout/Suppression de programmes pour désinstaller Reflection for the Web. Si MSS est installé sur le même ordinateur, vous avez la possibilité de le désinstaller également. Sous Linux ou UNIX : Exécutez le programme de désinstallation situé dans le répertoire d'installation de Reflection for the Web. Si MSS est installé sur le même ordinateur, le programme de désinstallation de Reflection for the Web se trouve dans le répertoire suivant : mss/server/web/webapps/rweb-client. Vous avez également la possibilité de désinstaller MSS. Désinstallation de la version 12.3 33 34 Guide d'installation Termes Environnement d'exécution Java (JRE). Le JRE est un sous-ensemble du JDK pour utilisateurs finaux. Il comprend une machine virtuelle Java et un interpréteur Java, et offre une interface unifiée pour les programmes Java, indépendamment du système d'exploitation sous-jacent. Java Cryptography Extension (JCE). Java Cryptography Extension (JCE) fournit une structure et des implémentations pour le chiffrement, la génération de clés, les protocoles d'accord sur les clés et les algorithmes de code d'authentification des messages (MAC). Java Server Pages (JSP). Une technologie Java permettant aux développeurs de logiciels de fournir des pages Web générées dynamiquement en HTML, XML ou d'autres types de documents. Java Software Development Kit (JDK). L'environnement de développement logiciel JDK (auparavant appelé Java SDK) permet d'écrire des applets ou des applications Java ; il s'agit d'un surensemble de l'environnement d'exécution Java et de la machine virtuelle Java. Machine virtuelle Java (JVM ou VM). La JVM correspond à la partie de Java capable d'interpréter du pseudo-code Java. La JVM faisant partie intégrante du JDK, elle a le même numéro de version. Dans le cas d'un navigateur prenant en charge une version spécifique du JDK, cela inclut la JVM. Termes 35 36 Guide d'installation