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.
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
- Activez l'édition des fichiers dans le répertoire de
configuration du serveur.
- 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.
- Ajoutez l'élément
remoteFileAccess
suivant dans le fichier de configuration du serveur.
<remoteFileAccess>
<writeDir>${server.config.dir}</writeDir>
</remoteFileAccess>
- 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.
- 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 :
- 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.
- Affichez ou éditez un fichier de configuration dans l'outil de configuration serveur.
- Dans la boîte à outils, sélectionnez
.
- 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.
- 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.
- 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.
- 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 :
- Sélectionnez
.
- Activez ou désactivez un ou plusieurs paramètres.
- Sélectionnez Close.
Que faire ensuite
Pour revenir à la boîte à outil, cliquez sur l'icône
.