Le Centre d'administration est une interface utilisateur Web qui s'exécute sur des serveurs
Liberty version 8.5.5.2 ou ultérieure. Après avoir installé Liberty et créé un serveur, configurez le fichier server.xml.
Avant de commencer
Installez WebSphere Application Server Liberty avec le Centre d'administration
Liberty ("Centre d'administration"). La rubrique
Installation des actifs du référentiel Liberty répertorie les diverses méthodes
d'installation d'actifs (Centre d'administration, par exemple). La méthode
la plus rapide pour installer le Centre d'administration consiste à exécuter la commande
installUtility ou featureManager :
- Si ce n'est déjà fait, installez WebSphere Application Server Liberty
version 8.5.5.2 ou ultérieure.
Restriction : Prenez soin d'utiliser une machine virtuelle
Java (JVM) prenant en charge les produits Liberty et SSL (Secure Sockets Layer).
N'utilisez pas de JVM IBM disponible
avec un produit WebSphere Application Server Traditional,
tel que Network Deployment, pour votre installation Liberty avec le Centre d'administration. Par défaut, la machine virtuelle Java IBM disponible avec un produit traditionnel pointe vers des classes de sécurité qui ne sont disponibles qu'avec un produit traditionnel, et non vers les classes de sécurité requises par
le Centre d'administration. L'utilisation d'une machine virtuelle Java IBM disponible avec un produit traditionnel 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. Par exemple, ouvrez une fenêtre de commande depuis c:\wlp.
- Exécutez une commande pour installer la fonction adminCenter-1.0.
Pour la version 8.5.5.6 ou ultérieure,
exécutez la commande
installUtility.
bin/installUtility install adminCenter-1.0
Pour la version
8.5.5.5 ou antérieure, exécutez la commande
featureManager.
bin/featureManager install adminCenter-1.0 --when-file-exists=ignore
- Pour l'édition Liberty Developers, exécutez une commande pour installer la fonction collectiveController-1.0.
Pour la version 8.5.5.6 ou ultérieure,
exécutez la commande
installUtility.
bin/installUtility install collectiveController-1.0
Pour la version
8.5.5.5 ou antérieure, exécutez la commande
featureManager.
bin/featureManager install collectiveController-1.0 --when-file-exists=ignore
Cette
étape s'applique uniquement à l'édition Developers et non aux éditions Network Deployment, z/OS ou Core de Liberty. Vous pouvez aussi
installer la fonction
collectiveController-1.0
avant d'installer la fonction
adminCenter-1.0.
Pour plus d'informations, allez sur le site WASdev, sélectionnez l'onglet
Downloads, puis recherchez l'actif Centre d'administration dans le Référentiel Liberty.
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 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. Les informations ci-après traitent de conditionnement.
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 Liberty autonome.
Pour activer le Centre d'administration sur un contrôleur de collectivité, voir
Configuration d'une collectivité
Liberty. 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 Liberty ne comporte pas de serveur, créez un serveur 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
Liberty et configurez le serveur pour le Centre d'administration.
- Ajoutez la fonction adminCenter-1.0
au gestionnaire de fonctions.
<featureManager>
<feature>adminCenter-1.0</feature>
</featureManager>
Pour obtenir des mises à jour du statut du serveur et des applications en temps opportun dans l'outil d'exploration, ajoutez également la fonction websocket-1.1 ou
websocket-1.0 à la configuration du serveur.
<featureManager>
<feature>adminCenter-1.0</feature>
<feature>websocket-1.1</feature>
</featureManager>
WebSocket offre une vue en temps réel de la topologie, quelle que soit la taille. En l'absence de la fonction WebSocket, Centre d'administration effectue des
recherches de mises à jour régulières et fréquentes.
- 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 fichier
jvm.options,
consultez
Personnalisation de l'environnement 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 Exemple : Utilisation de BasicRegistry et du mappage de rôle sur 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.
Regarder : La vidéo
Setting
up Admin Center illustre la procédure. [Retranscription]
Exemple : fichier server.xml définissant deux utilisateurs autorisés
<server description="new server">
<!-- Enable features -->
<featureManager>
<feature>adminCenter-1.0</feature>
</featureManager>
<!-- Define the host name for use by the collective.
If the host name needs to be changed, the server should be
removed from the collective and re-joined. -->
<variable name="defaultHostName" value="localhost" />
<!-- Define an Administrator and non-Administrator -->
<basicRegistry id="basic">
<user name="admin" password="adminpwd" />
<user name="nonadmin" password="nonadminpwd" />
</basicRegistry>
<!-- Assign 'admin' to Administrator -->
<administrator-role>
<user>admin</user>
</administrator-role>
<keyStore id="defaultKeyStore" password="Liberty" />
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="9443" />
</server>