Le Centre d'administration est une interface utilisateur Web qui s'exécute sur des serveurs de profil
Liberty version 8.5.5.2 ou ultérieure. Après avoir installé le profil Liberty et créé un serveur, configurez le fichier server.xml.
Avant de commencer
Installez le profil WebSphere Application Server Liberty avec le Centre d'administration
Liberty ("Centre d'administration"). La rubrique Installation d'actifs du référentiel Liberty répertorie les diverses méthodes d'installation d'actifs (par exemple, le Centre d'administration). La méthode la plus rapide pour installer le Centre d'administration consiste à exécuter la commande featureManager :
- Si ce n'est déjà fait, installez WebSphere Application
Server Liberty Profile version 8.5.5.2 ou ultérieure.
Restriction : Prenez soin d'utiliser une machine virtuelle
Java (JVM) prenant en charge les produits de profil Liberty et SSL (Secure Sockets Layer). N'utilisez pas de JVM IBM disponible avec un produit de profil profil complet de WebSphere Application Server,
tel que Network Deployment, pour votre installation de profil Liberty avec le Centre d'administration.
Par défaut, La machine virtuelle Java IBM disponible avec le profil complet
pointe vers des classes de sécurité qui ne sont disponibles qu'avec
un profil complet, et non vers les classes de sécurité requises par
le Centre d'administration. L'utilisation d'une JVM IBM disponible avec un produit de profil complet peut empêcher l'affichage du Centre d'administration dans un navigateur .
- Ouvrez une fenêtre de commande au niveau du répertoire principal de l'installation Liberty Profile. Par exemple, ouvrez une fenêtre de commande depuis c:\wlp.
- Lancez la commande featureManager pour installer la fonction adminCenter-1.0 :
bin/featureManager install adminCenter-1.0 --when-file-exists=ignore
Pour l'édition Developers du profil Liberty,
exécutez la commande featureManager pour installer
la fonction collectiveController-1.0 :bin/featureManager install collectiveController-1.0 --when-file-exists=ignore
Cette
étape s'applique uniquement pour l'édition
Developers et non pour les éditions Network
Deployment, z/OS ou Core du profil Liberty. Vous pouvez aussi
installer la fonction
collectiveController-1.0
avant d'installer la fonction
adminCenter-1.0.
![[Mise à jour - Janvier 2015]](../deltaend.gif)
Pour plus
d'informations, accédez au site Web
WASdev,
sélectionnez l'onglet Downloads, puis le
bouton FEATURE pour l'actif
du Centre d'administration.
Pour installer le
Centre d'administration sur des
hôtes ne pouvant pas accéder au référentiel Liberty hébergé sur
Internet, installez d'abord le profil Liberty et la fonction
Centre d'administration sur un
hôte pouvant accéder à Internet. Transférez ensuite l'installation sur les hôtes cible. Pour plus d'informations sur la constitution d'un package de serveurs de profil et d'environnements d'exécution pour leur déploiement sur d'autres hôtes, voir Conditionnement d'un serveur de profil Liberty avec les outils de développement et Conditionnement d'un serveur de profil Liberty depuis l'invite de commande.
Pourquoi et quand exécuter cette tâche
Vous pouvez installer le Centre d'administration sur des serveurs autonomes et sur des contrôleurs de collectivité. Cette rubrique s'adresse à la configuration d'un serveur de profil Liberty autonome.
Pour activer le Centre d'administration sur un contrôleur de collectivité, voir Configuration d'une collectivité Liberty et l'exemple dans la rubrique Déploiement de ressources à l'aide du Centre d'administration. Vérifiez que le fichier server.xml du contrôleur de collectivité inclut l'entrée <feature>adminCenter-1.0</feature> dans la configuration du gestionnaire de fonctions et définit une valeur host dans l'élément httpEndpoint (par exemple, host="*" si vous désirez que tous les hôtes puissent accéder au contrôleur de collectivité).
Procédure
- Si votre installation du profil Liberty ne comporte pas de serveur, créez un serveur de profil Liberty.
Par exemple depuis une fenêtre de commande au niveau du répertoire wlp/bin, créez un serveur nommé myServer.
server create myServer
L'exemple de commande ajoute des fichiers de serveur au répertoire wlp/usr/servers/myServer.
- Ouvrez un éditeur sur le fichier server.xml du serveur de profil
Liberty et configurez le serveur pour le Centre d'administration.
- Ajoutez la fonction adminCenter-1.0
au gestionnaire de fonctions.
<featureManager>
<feature>jsp-2.2</feature>
<feature>adminCenter-1.0</feature>
</featureManager>
- Ajoutez un ou plusieurs utilisateurs pour configurer une connexion sécurisée. Par
exemple :
<quickStartSecurity userName="admin" userPassword="adminpwd" />
Si des noms d'utilisateur ou des mots de passe comportent des caractères non anglais,
créez le fichier
jvm.options pour le serveur et définissez le codage client
par défaut sur UTF-8 :
-Ddefault.client.encoding=UTF-8
Pour plus d'informations
sur le fchier
jvm.options,
voir
Personnalisation de l'environnement du profil Liberty.
- Pour protéger les fichiers de clés contenant des données d'identification pour authentification auprès du serveur, définissez un fichier de clés et affectez-lui un mot de passe.
<keyStore id="defaultKeyStore" password="Liberty" />
Pour consulter un exemple de fichier server.xml qui définit un administrateur, un utilisateur non administrateur et un fichier de clés, reportez-vous à la section Exemple dans cette même rubrique. Pour plus d'informations sur la définition de plusieurs administrateurs, voir Configuration de BasicRegistry et du mappage de rôle dans le profil Liberty.
- Pour accéder au Centre d'administration depuis un smartphone, une tablette ou un ordinateur distant,
veillez à ce que le fichier server.xml définisse l'attribut
host de l'élément httpEndpoint à * (astérisque) ou à un nom d'hôte défini. Par défaut, l'attribut
host reçoit la valeur localhost.
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="9443" />
- Enregistrez vos modifications dans le fichier server.xml.
Si vous avez défini le codage client par défaut sur UTF-8 pour les caractères non anglais
dans le fichier jvm.options et si le registre d'utilisateurs
se trouve dans les éléments quickStartSecurity ou basicRegistry,
qui stocke les noms d'utilisateur et les mots de passe dans le fichier server.xml,
sauvegardez le fichier server.xml au format UTF-8.
- Si le serveur n'est pas en cours d'exécution, démarrez-le.
Par exemple, depuis une fenêtre de commande dans le répertoire wlp/bin,
entrez une commande run ou start.
server run myServer
Recherchez des messages de serveur indiquant que l'application Web adminCenter est en opération. Une fois que le Centre d'administration est en opération, vous pouvez pointer un navigateur Web vers cette application et vous connecter. Voir Connexion au Centre d'administration
Lecture : La vidéo Configuration du Centre d'administration illustre la procédure. [Transcription]
Exemple : fichier server.xml définissant deux utilisateurs autorisés
<server description="new server">
<!-- Activation des fonctions -->
<featureManager>
<feature>adminCenter-1.0</feature>
</featureManager>
<!-- Définition du nom d'hôte à utiliser par la collectivité.
Si le nom d'hôte doit être modifié, le serveur doit être
retiré de la collectivité, puis rattaché à nouveau. -->
<variable name="defaultHostName" value="localhost" />
<!-- Définition d'un administateur et d'un utilisateur non administrateur -->
<basicRegistry id="basic">
<user name="admin" password="adminpwd" />
<user name="nonadmin" password="nonadminpwd" />
</basicRegistry>
<!-- Affectation du rôle 'admin' à l'administrateur -->
<administrator-role>
<user>admin</user>
</administrator-role>
<keyStore id="defaultKeyStore" password="Liberty" />
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="9443" />
</server>