Edition des fichiers de configuration du serveur dans le Centre d'administration

Vous pouvez utiliser l'outil de configuration serveur pour visualiser et éditer les fichiers de configuration du serveur dans la topologie Liberty. L'outil de configuration serveur permet d'afficher les fichiers de configuration, par exemple server.xml, dans deux modes. Le mode Design affiche le contenu des fichiers de configuration au moyen de commandes graphiques avec une documentation en ligne. Le mode Source donne un accès direct au texte des fichiers et offre des fonctions d'assistance de contenu. Vous pouvez personnaliser les modes, par exemple, pour ajouter ou retirer des descriptions de paramètre en mode Design, ou pour ajouter ou retirer des numéros de ligne en mode Source. Pour pouvoir éditer des fichiers, vous devez d'abord ajouter l'élément remoteFileAccess dans le fichier de configuration du serveur ; sinon, les fichiers s'affichent en mode lecture seule.

Pourquoi et quand exécuter cette tâche

Vous pouvez afficher et éditer les fichiers de configuration pour les serveurs Liberty qui utilisent la fonction adminCenter-1.0 et pour les membres de la collectivité Liberty qui ne se trouvent pas dans des conteneurs Docker. Vous ne pouvez pas afficher ni éditer les fichiers de configuration pour les membres de la collectivité Liberty figurant dans les conteneurs Docker ou pour les membres de la collectivité Node.js.

Multimédia Regarder : La vidéo Getting started with the Server Configuration Tool for WebSphere Liberty montre comment activer et utiliser l'outil.

Vous pouvez essayer l'outil de configuration serveur dans un bac à sable, ouvrir une vidéo, et parcourir des informations supplémentaires sur l'outil à l'adresse : http://serverconfig.mybluemix.net/.

Procédure

  1. Activez l'édition des fichiers dans le répertoire de configuration du serveur.
    1. Ouvrez un éditeur dans le fichier de configuration du serveur.

      Le fichier de configuration d'un serveur comporte généralement un nom de chemin tel que wlp/usr/servers/server_name/server.xml.

    2. Ajoutez l'élément remoteFileAccess suivant dans le fichier de configuration du serveur.
      <remoteFileAccess>
          <writeDir>${server.config.dir}</writeDir>
      </remoteFileAccess>
    3. Sauvegardez les changements apportés au fichier.

    Pour éditer les fichiers de configuration du serveur pour une collectivité, vous devez effectuer des actions supplémentaires, en particulier pour les membres de la collectivité. Un message d'erreur peut s'afficher si vous ne réalisez pas les actions supplémentaires.

    Remarque : A partir de la version 8.5.5.9, certaines erreurs s'affichent dans l'outil de configuration serveur. Si vous utilisez une version antérieure de Liberty ou si l'erreur ne contient pas de description, consultez l'onglet Réseau du débogueur du navigateur pour connaître l'origine du problème. Pour obtenir des informations sur des erreurs spécifiques, voir Traitement des incidents du centre d'administration.
    1. Vérifiez que le paramètre d'environnement PATH de l'installation Java est correct. Pour éviter un problème Java introuvable, effectuez l'une des actions suivantes :
      • Spécifiez le paramètre --hostJavaHome dans une commande de collectivité updateHost. Pour réaliser l'étape b en même temps, spécifiez également le paramètre --hostWritePath. Exemple :
        wlp/bin/collective updateHost memberHost --host=collectiveHost --port=controllerHTTPSPort 
        --user=controllerAdmin --password=controllerAdminPassword --hostWritePath=/liberty/wlp/usr/servers --hostJavaHome=/opt/ibm/java-i386-70
      • Créez un lien vers Java dans /usr/bin. Par exemple : /usr/bin/java -> /opt/ibm/java-i386-70/jre/bin/java
      • Ajoutez Java à la variable d'environnement PATH. Voir Définition de la variable JAVA_HOME pour les membres de collectivité et les contrôleurs Liberty.

        Pour plateformes LINUXExportez le chemin (PATH) dans .bashrc.

        Pour plateformes WindowsCréez une variable d'environnement JAVA_HOME pointant vers le dossier Java. Ajoutez %JAVA_HOME%/bin à la variable PATH, en utilisant un point-virgule comme séparateur.

    2. Définissez hostWritePath sur le contrôleur pour lui permettre d'accéder aux fichiers de configuration des membres. Exécutez la commande de collectivité updateHost avec le paramètre --hostWritePath :
      wlp/bin/collective updateHost memberHost --host=collectiveHost --port=controllerHTTPSPort 
      --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcUserPassword=osUserPassword 
      --hostReadPath=serversPath --hostWritePath=serversPath

    Après avoir activé l'édition, les fichiers de configuration du serveur tels que le fichier server.xml et tout autre fichier inclus cessent d'être en lecture seule dans l'outil de configuration serveur. Vous pouvez modifier les paramètres d'éléments et les valeurs de paramètres ou éditer les fichiers.

  2. Affichez ou éditez un fichier de configuration dans l'outil de configuration serveur.
    1. Dans la boîte à outils, sélectionnez Icône Outil de configuration serveur.
    2. Si Centre d'administration s'exécute sur un contrôleur de collectivité, sélectionnez le serveur qui contient le fichier de configuration que vous souhaitez afficher ou éditer.
    3. Une fois un fichier ouvert pour édition, vous pouvez basculer entre les modes Conception et Source.

      En mode Conception, sélectionnez des éléments de la configuration pour afficher les fonctions activées et les valeurs de paramètre.

      En mode Source, placez le curseur sur des éléments ou des paramètres pour afficher la documentation correspondante. Vous pouvez appuyer sur Ctrl+Espace pour utiliser l'assistant de contenu, qui vous aide à ajouter de nouveaux éléments, paramètres et valeurs.

    4. Une fois que vous avez terminé d'utiliser un fichier, sélectionnez Sauvegarder pour sauvegarder les modifications apportées au fichier, puis Fermer pour revenir à la page principale de l'outil. Pour annuler les modifications, sélectionnez Fermer puis confirmez que vous ne souhaitez pas sauvegarder vos modifications.
  3. Facultatif : Personnalisez les paramètres par défaut pour le mode Design ou Source.

    Par défaut, le mode Design utilise des libellés étendus pour les éléments de fichier. Ces libellés affichent les noms d'élément tels que featureManager sous la forme Feature Manager. De plus, le mode Design affiche les descriptions de paramètre par défaut. Le mode Source affiche les numéros de ligne par défaut. Pour modifier un paramètre par défaut :

    1. Sélectionnez icône Paramètres.
    2. Activez ou désactivez un ou plusieurs paramètres.
    3. Sélectionnez Close.

    L'outil de configuration serveur s'ouvre avec le fichier server.xml en mode Design

Que faire ensuite

Pour revenir à la boîte à outil, cliquez sur l'icône Boîte à outils.


Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_ui_config.html