9.5 Modification de l'environnement d'exécution Java

Par défaut, Reflection X Advantage installe et utilise un environnement d'exécution Java privé (JRE). Cet environnement JRE installé est configuré correctement de manière à prendre entièrement en charge l'ensemble des composants Reflection X Advantage. Il est également possible de configurer Reflection X Advantage sous Windows de façon à ce qu'il utilise un environnement JRE différent. Les informations suivantes s'adressent aux administrateurs qui souhaitent configurer Reflection X Advantage de façon à utiliser un environnement JRE installé séparément.

REMARQUE :

  • Si nécessaire, Micro Focus mettra à disposition des packages d'installation Java mis à jour de façon à proposer aux clients des mises à jour de sécurité Java. Ces packages peuvent être téléchargés et appliqués indépendamment des mises à jour relatives au package Reflection X Advantage principal. Si vous mettez à jour l'environnement JRE à l'aide d'un package Java fourni par Micro Focus, votre environnement JRE sera configuré correctement de façon automatique. Les informations ci-dessous ne sont pas nécessaires pour ces installations ; elles sont fournies aux utilisateurs qui souhaitent mettre à jour leur environnement JRE sans utiliser de programme d'installation Micro Focus.

  • Si vous souhaitez utiliser l'environnement JRE privé installé par le package Java fourni par Micro Focus, vous devez sélectionner le composant Java Runtime Environment (JRE) dans l'arborescence des composants d'installation. Parallèlement à l'exécution du programme d'installation Java associé, ce composant modifie les paramètres du registre Windows permettant de configurer Reflection X Advantage de façon à ce qu'il utilise l'environnement d'exécution Java privé.

  • Si vous souhaitez utiliser un environnement d'exécution Java (JRE) personnalisé, assurez-vous que le niveau binaire de cet environnement correspond à celui de Reflection X Advantage. Par exemple, une installation 32 bits de Reflection X Advantage nécessite un environnement JRE 32 bits.

Recherche d'un environnement JRE

Reflection X Advantage exécuté sous Windows utilise l'ordre de recherche suivant afin de localiser un environnement JRE sur votre système.

  • Environnement JRE privé installé avec Reflection X Advantage lorsque vous incluez le composant « Java Runtime Environment (JRE) ».

  • Chemin spécifié dans une variable d'environnement appelée RXA_JRE_HOME. Reportez-vous aux instructions ci-dessous au sujet de la configuration de cette variable.

  • Système JRE déjà installé sur votre système à l'aide du programme d'installation Oracle.

Si aucun environnement JRE n'est disponible, les applications Reflection X Advantage ne s'exécuteront pas et les fichiers journaux des applications Reflection X Advantage comporteront un message précisant que l'application n'a pas pu démarrer en raison de la non-disponibilité de la machine virtuelle Java (JVM). (Ce message apparaît également en tant qu'avertissement dans le journal des événements Windows.)

Les fichiers journaux des applications Reflection X Advantage fournissent des informations sur le type d'environnement JRE utilisé. Recherchez « JVM_EXE." Par exemple:

INFO [...] JVM_EXE is: C:\Program Files\Common Files\Micro Focus\JDK\Java8\jre\bin\java.exe 

Messages d'erreur et d'avertissement JRE dans les fichiers journaux

En mode domaine, l'environnement JRE doit être configuré pour une cryptographie à portée illimitée. Il s'agit de la configuration par défaut depuis Java 8u161. Si vous utilisez une version antérieure de Java ou que vous disposez d'une configuration JRE différente de la configuration par défaut, reportez-vous à l'Étape 3 : configuration de Java pour une cryptographie à portée illimitée.

  • Une erreur fatale est consignée dans le fichier rxs.log lorsque vous tentez de démarrer le service Reflection X à l'aide d'un environnement JRE non configuré en vue d'une cryptographie à portée illimitée.

Les avertissements sont consignés dans les fichiers journaux des applications si :

  • L'environnement JRE en cours d'exécution est plus ancien que la version commercialisée avec cette version de Reflection X Advantage.

  • L'environnement JRE en cours d'exécution concerne un environnement « client » et non « serveur ». Pour résoudre ce problème, reportez-vous aux instructions ci-dessous au sujet de l'installation d'un kit de développement logiciel Java (JDK) à partir du site Oracle.

  • Vous exécutez le Gestionnaire X à partir d'un environnement JRE non configuré en vue d'une cryptographie à portée illimitée. Ni les algorithmes de cryptographie contrôlés à l'exportation ni le mode FIPS ne seront disponibles. Pour résoudre ce problème, reportez-vous à l'Étape 3 : configuration de Java pour une cryptographie à portée illimitée.

Installation et configuration d'un environnement JRE

Utilisez les procédures suivantes pour configurer Reflection X Advantage en cours d'exécution sur une plate-forme Windows de façon à ce qu'il utilise un environnement JRE différent de la version par défaut.

L'environnement JRE par défaut installé depuis un navigateur concerne un environnement « client » et non « serveur ». Reflection X Advantage exige un environnement serveur pour pouvoir fonctionner de façon optimale. Vous pouvez le télécharger et l'installer depuis le site Web d'Oracle.

Étape 1 : Installation d'un kit de développement logiciel Java à partir du site Oracle

  1. Accédez à la page de téléchargement des produits Java SE.

    Téléchargez et installez l'environnement d'exécution Java qui présente le même niveau binaire que Reflection X Advantage en utilisant le téléchargement JDK (qui installe l'environnement JRE serveur) ou le téléchargement JRE serveur.

    Téléchargez la mise à jour la plus récente de la version Java principale comprise dans Reflection X Advantage. Pour la version 17.0, téléchargez la mise à jour la plus récente de Java 8.

  2. Après avoir installé l'environnement d'exécution Java, exécutez la commande suivante pour confirmer que la version JRE indiquée correspond à celle que vous avez téléchargée :

    /<java-path>/bin/java -version

    Par exemple :

    # /jdk/jdk1.8.0_ nn /jre/bin/java -version

    java version "1.8.0_ nn "

    Java(TM) SE Runtime Environment (version 1.8.0_ nn -b01)

La procédure suivante vous permet de configurer une variable d'environnement qui pousse les applications Reflection X Advantage à utiliser l'environnement d'exécution Java approprié.

Étape 2 : Configuration de la variable RXA_JRE_HOME

  1. Ouvrez les propriétés système Windows (Démarrer > Panneau de configuration > Système > Paramètres système avancés).

  2. Dans l'onglet Paramètres système avancés, cliquez sur Variables d'environnement.

  3. Sous Variables système, cliquez sur Nouvelle, définissez une nouvelle variable de la façon suivante, puis cliquez sur OK.

    Nom de la variable

    RXA_JRE_HOME

    Valeur de la variable

    Emplacement de l'environnement d'exécution Java référencé dans le chemin d'installation du kit de développement logiciel Java. Il s'agit de l'environnement d'exécution Java configuré pour un environnement serveur. Par exemple :

    C:\Program Files\Java\jdk1.8.0_ <nn> \jre

  4. Cliquez sur OK pour fermer les boîtes de dialogue ouvertes.

Étape 3 : configuration de Java pour une cryptographie à portée illimitée

Depuis Java 8u161, la cryptographie à portée illimitée correspond à la configuration par défaut. Si vous utilisez Java 8u152 ou une version antérieure (non recommandé pour RXA 17.0) ou que vous utilisez une configuration JRE différente de la configuration par défaut, vous devez veiller à ce que votre environnement JRE soit configuré pour une cryptographie à portée illimitée.

Les étapes suivantes ne devraient être nécessaires que si vous disposez d'une configuration JRE différente de la configuration par défaut ou que si vous utilisez Java 8u152 ou une version antérieure :

REMARQUE :Vous devez appliquer les fichiers de politique juridictionnelle à portée illimitée après chaque mise à niveau de votre environnement d'exécution Java.

  1. Accédez à la page de téléchargement des produits Java SE.

  2. Téléchargez les fichiers de politique juridictionnelle à portée illimitée JCE (Java Cryptography Extension).

  3. Décompressez les fichiers téléchargés et cherchez les deux suivants.

    local_policy.jar

    US_export_policy.jar

  4. Copiez les fichiers de politique dans le dossier <répertoire racine java>\jre\lib\security en écrasant les fichiers présents dans votre dossier JRE. Par exemple :

    C:\Program Files\Java\jdk1.8.0_ <nn> \jre\lib\security

Désinstallation de l'environnement JRE par défaut

Si vous installez un environnement JRE différent après avoir installé l'environnement JRE par défaut avec Reflection, vous devez désinstaller celui par défaut. Pour ce faire, suivez la procédure ci-dessous :

Pour désinstaller l'environnement JRE Micro Focus par défaut

  1. Pour ouvrir le Panneau de configuration Programmes et fonctionnalités, sélectionnez Démarrer > Panneau de configuration > Programmes et fonctionnalités. (Dans les anciens systèmes Windows, ce Panneau de configuration s'appelle Ajout/Suppression de programmes.)

  2. Sélectionnez l'entrée correspondant au nom de votre produit Reflection, pas l'entrée Java, puis cliquez sur Change (Modifier).

  3. Dans l'onglet Sélection des composants, cliquez sur l'icône située à gauche de Java Runtime Environment (JRE) et sélectionnez Ce composant ne sera pas disponible.

  4. Cliquez sur Continuer.