Configuration de Centre d'administration

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 :

  1. 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 .
  2. 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.
  3. 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
  4. 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. Pour plus d'informations sur la constitution d'un package de serveurs et d'environnements d'exécution Liberty pour leur déploiement sur d'autres hôtes, consultez Conditionnement d'un serveur Liberty avec les outils de développement et Conditionnement d'un serveur 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 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

  1. 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.

  2. Ouvrez un éditeur sur le fichier server.xml du serveur Liberty et configurez le serveur pour le Centre d'administration.
    1. Ajoutez la fonction adminCenter-1.0 au gestionnaire de fonctions.
      <featureManager>
         <feature>adminCenter-1.0</feature>
      </featureManager>
    2. 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.
    3. 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 Setting up BasicRegistry and role mapping on Liberty.

    4. 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" />
    5. 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.

  3. 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.

    Multimédia 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>

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

Nom du fichier : twlp_ui_setup.html