Pour plateformes réparties

Création d'un serveur Liberty distant à l'aide des outils de développement

Vous pouvez utiliser les outils de développement pour créer et démarrer un serveur Liberty distant.

Avant de commencer

Vous devez respecter certains prérequis pour votre système local et votre système distant.
  • Le système local est le système sur lequel vous avez installé les outils de développement.
  • Le système distant est le système sur lequel vous avez installé l'environnement d'exécution liberty et créé un serveur liberty.
Vérifiez que vous respectez les prérequis suivants pour votre système local :
  1. Les outils de développement sont installés. Pour plus d'informations, voir Installation des outils de développement Liberty et (facultatif) de Liberty.
  2. L'environnement d'exécution Liberty est installé. Pour plus d'informations, voir Installation de Liberty à l'aide d'archives téléchargées.

Pour votre système distant, assurez-vous d'avoir appelé l'utilitaire configUtility pour le téléchargement et la configuration du fragment remoteAdministration depuis le référentiel. Copiez le texte config qui est extrait par l'utilitaire configUtility dans le fichier server.xml. Pour plus d'informations, voir Liberty :commande configUtility.

Vous pouvez vous inspirer de l'exemple suivant pour votre fichier server.xml :

<server description="new server">
<!-- Enable features-->
<featureManager>
<feature>restConnector-1.0</feature>
</featureManager>

<keyStore id="defaultKeyStore" password="password" />

<quickStartSecurity userName="admin" userPassword="password"/>

<httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="9080" httpsPort="9443"/>

<remoteFileAccess>
<writeDir>${server.config.dir}</writeDir>
<writeDir>${server.output.dir}</writeDir>
<writeDir>${wlp.user.dir}</writeDir>
</remoteFileAccess>
</server>

Procédure

  1. Dans le plan de travail, ouvrez la vue Serveurs en cliquant sur l'onglet Serveurs.
    Conseil : Si la vue Serveurs n'est pas visible, sélectionnez Fenêtre > Afficher la vue > Autre... et entrez Serveur dans le texte de filtre. Sélectionnez ensuite Serveurs.
  2. Cliquez avec le bouton droit de la souris dans la vue Serveurs et sélectionnez Nouveau > Serveur.
  3. Dans la liste des types de serveur, développez IBM et sélectionnez le type de serveur WebSphere Application Server Liberty.
  4. Entrez le nom de l'hôte distant dans la zone Nom d'hôte du serveur.
  5. Cliquez sur Next. La page Environnement d'exécution Liberty s'affiche.

    Vérifiez que l'environnement d'exécution Liberty du système local et du système distant ont les mêmes fonctions installées. De même, vérifiez qu'elles sont configurées pour utiliser le même niveau d'environnement d'exécution Java (JRE). L'environnement d'exécution Liberty du système local est utilisé comme l'environnement d'exécution cible dans l'environnement de développement. Une non-concordance entre l'environnement d'exécution du système local et l'environnement d'exécution du système distant peut causer des problèmes allant des erreurs de configuration aux problèmes de publication des applications.

  6. Conseil : Si vous avez déjà un environnement d'exécution Liberty installé, sautez l'étape 7 et allez directement à la page Nouveau serveur Liberty distant.
    Sélectionnez une installation, procédez à l'installation depuis un fichier archive ou téléchargez et installez (dans le cas de l'édition gratuite conçue pour les développeurs) Liberty.

    Si vous avez déjà installé Liberty, procédez comme suit :

    1. Sélectionnez Choisir une installation existante.
    2. Dans la zone Chemin d'accès, tapez le répertoire (ou naviguez jusqu'au répertoire) dans lequel vous avez installé l'environnement d'exécution Liberty.
    3. Dans la page de l'environnement d'exécution Liberty, cliquez sur Suivant.

      L'environnement de service d'applications est sélectionné ; vous pouvez maintenant passer à l'étape 7.

    Si vous voulez installer Liberty depuis un fichier archive téléchargé précédemment, procédez comme suit :

    1. Sélectionnez Installer depuis une archive ou un référentiel, puis cliquez sur Suivant.
    2. Dans la zone Destination, tapez le répertoire (ou naviguez jusqu'au répertoire) dans lequel vous voulez installer l'environnement d'exécution Liberty.

      Si vous entrez un chemin d'accès qui n'existe pas, un dossier pour ce chemin est créé automatiquement à la fin de l'étape 12.

    3. Sélectionnez Installer un nouvel environnement d'exécution depuis une archive.
    4. Dans la zone Chemin, tapez le répertoire (ou naviguez jusqu'au répertoire) dans lequel se trouve le fichier archive sur le système de fichiers local, puis cliquez sur Suivant.
    5. Dans la page d'installation des modules complémentaires, cliquez sur Installer ou Installer les éléments en attente afin d'effectuer votre sélection de fichiers archive de module complémentaire que vous voulez installer dans l'environnement d'exécution Liberty.
      Vous pouvez installer les fichiers d'archive de module à l'aide de l'une des méthodes suivantes :
      • A partir de votre système de fichiers local
      • En téléchargeant les fichiers
      • En combinant ces deux méthodes, lorsque vous installez plusieurs fichiers archive supplémentaires
      Si le plan de travail est connecté à Internet, la page d'installation des modules complémentaires est renseignée avec des fichiers archive supplémentaires disponibles au téléchargement à partir du site de téléchargement de la communauté WASdev.

      Ce site de téléchargement inclut des modules complémentaires que vous pouvez sélectionner depuis le Référentiel Liberty, comme des fonctions d'exécution, des exemples ou une intégration open source.

      Si vous souhaitez installer des fichiers archive de module complémentaire à partir de votre système de fichiers local, procédez comme suit :
      1. Cliquez sur Ajouter archive.
      2. Dans la zone Archive de module, tapez le nom du ou naviguez jusqu'au fichier archive supplémentaire sur le système de fichiers local.
      3. Cliquez sur OK.
      Si vous voulez installer d'autres fichiers archive de module complémentaire depuis votre système de fichiers local, répétez cette procédure autant de fois que nécessaire.
      Si vous souhaitez installer des fichiers archive de module complémentaire à partir d'un référentiel personnalisé, procédez comme suit :
      1. Pour ajouter le référentiel, cliquez sur Configurer des référentiels.
      2. Cliquez sur Nouveau....
      Les fichiers sont ensuite ajoutés à la liste des fichiers de module complémentaire.

      Une fois que vous avez effectué votre sélection dans la page d'installation des modules complémentaires, cliquez sur Suivant.

    6. Dans la page d'acceptation de la licence, si vous acceptez les dispositions du contrat de licence, sélectionnez l'option indiquant que vous acceptez les dispositions de tous les contrats de licence, puis cliquez sur Suivant.

      Vous pouvez maintenant passer à l'étape 7.

    Si vous voulez télécharger et installer l'édition gratuite de Liberty conçue pour les développeurs, procédez comme suit :

    1. Sélectionnez Installer depuis une archive ou un référentiel, puis cliquez sur Suivant.
    2. Dans la zone Destination, tapez le répertoire (ou naviguez jusqu'au répertoire) dans lequel vous voulez installer l'environnement d'exécution Liberty.

      Si vous entrez un chemin d'accès qui n'existe pas, un dossier pour ce chemin est créé automatiquement à la fin de l'étape 12.

    3. Sélectionnez Télécharger et installer un nouvel environnement d'exécution depuis ibm.com, choisissez une version d'environnement d'exécution, puis cliquez sur Suivant.
    4. Dans la page d'installation des modules complémentaires, cliquez sur Installer ou Installer les éléments en attente afin d'effectuer votre sélection de fichiers archive de module complémentaire que vous voulez installer dans l'environnement d'exécution Liberty.
      Vous pouvez installer les fichiers d'archive de module à l'aide de l'une des méthodes suivantes :
      • A partir de votre système de fichiers local
      • En téléchargeant les fichiers
      • En combinant ces deux méthodes, lorsque vous installez plusieurs fichiers archive supplémentaires
      Si le plan de travail est connecté à Internet, la page d'installation des modules complémentaires est renseignée avec des fichiers archive supplémentaires disponibles au téléchargement à partir du site de téléchargement de la communauté WASdev.

      Ce site de téléchargement inclut des modules complémentaires que vous pouvez sélectionner depuis le Référentiel Liberty, comme des fonctions d'exécution, des exemples ou une intégration open source.

      Si vous souhaitez installer des fichiers archive de module complémentaire à partir de votre système de fichiers local, procédez comme suit :
      1. Cliquez sur Ajouter archive.
      2. Dans la zone Archive de module, tapez le nom du ou naviguez jusqu'au fichier archive supplémentaire sur le système de fichiers local.
      3. Cliquez sur OK.
      Si vous voulez installer d'autres fichiers archive de module complémentaire depuis votre système de fichiers local, répétez cette procédure autant de fois que nécessaire.
      Si vous souhaitez installer des fichiers archive de module complémentaire à partir d'un référentiel personnalisé, procédez comme suit :
      1. Pour ajouter le référentiel, cliquez sur Configurer des référentiels.
      2. Cliquez sur Nouveau....
      Les fichiers sont ensuite ajoutés à la liste des fichiers de module complémentaire.

      Une fois que vous avez effectué votre sélection dans la page d'installation des modules complémentaires, cliquez sur Suivant.

    5. Dans la page d'acceptation de la licence, si vous acceptez les dispositions du contrat de licence, sélectionnez l'option indiquant que vous acceptez les dispositions de tous les contrats de licence, puis cliquez sur Suivant.

      Vous pouvez maintenant passer à l'étape 6.

  7. Si la page Type de serveur Liberty s'affiche, sélectionnez Serveur autonome.
  8. Saisissez les informations relatives à l'ID utilisateur, au mot de passe et au port du serveur distant, puis cliquez sur Vérifier.
    Important :
    • L'ID utilisateur et le mot de passe doivent respecter les données d'identification de sécurité appropriées telles que définies par l'élément de configuration quickStartSecurity ou le registre d'utilisateurs du serveur Liberty distant.
    • Le port est le port HTTPS qui est configuré dans le fichier server.xml.
    Après que vous avez cliqué sur Vérifier, si vous voyez le message ci-après, cela signifie qu'un serveur local ou distant est déjà créé sous le même nom.
    Le serveur Liberty existe déjà
    Pour vérifier cette situation, développez les dossiers ci-après dans la vue Enterprise Explorer et affichez les serveurs répertoriés dans les projets suivants :
    • WebSphere Application Server Liberty
    • WebSphere Application Server Liberty (distant)
    Le répertoire distant figure sur la même page si la connexion est établie. Pour résoudre ce problème de deux serveurs ayant le même nom, vous pouvez renommer le dossier Répertoire distant sur le système distant.
  9. Dans la page Nouveau serveur Liberty distant, cliquez sur Suivant.

    La page Paramètres WebSphere Application Server distant s'affiche.

  10. Si vous ne voulez pas activer le démarrage, l'arrêt et le redémarrage à distance, assurez-vous que l'option permettant d'activer le démarrage à distance du serveur n'est pas sélectionnée, cliquez sur Suivant et passez à l'étape suivante.
  11. Activez le démarrage, l'arrêt et le redémarrage à distance.
    1. Sélectionnez l'option permettant d'activer le démarrage à distance du serveur.
    2. Indiquez si votre serveur distant est installé sur le système d'exploitation Windows ou sur d'autres systèmes d'exploitation.
    3. Entrez l'emplacement de l'installation d'exécution et de la configuration du serveur.

      Pour plus d'informations, voir la rubrique Liberty : Emplacement des répertoires et des propriétés.

    4. Entrez les informations d'authentification du serveur distant.
      Pour l'authentification, exécutez l'une des options ci-après.
      • Pour accéder au serveur distant avec des données d'identification de connexion, entrez vos nom d'utilisateur et mot de passe. Sur les plateformes Windows, utilisez votre nom d'utilisateur et votre mot de passe Windows pour le compte utilisateur qui a accès au serveur. Sur les plateformes autres que Windows, utilisez le nom d'utilisateur et le mot de passe SSH.
      • Pour accéder au serveur distant avec Secure Shell (SSH) à l'aide d'une clé privée, copiez le fichier de clé privée sur l'ordinateur sur lequel le plan de travail est installé, et spécifiez l'emplacement du fichier de clé et l'ID utilisateur.

    Pour plus d'informations sur le démarrage d'un serveur distant, voir la rubrique Starting a remote WebSphere Application Server.

  12. Facultatif : Ajoutez les projets de votre application au serveur. Dans la page Ajout et suppression, dans la liste Disponibles, sélectionnez les projets que vous souhaitez ajouter au serveur et cliquez sur Ajouter. Le projet apparaît dans la liste Configurés.
  13. Cliquez sur Terminer.

Que faire ensuite

  • Edition de la configuration du serveur. Lorsque vous effectuez des éditions, les serveurs distants synchronisent les changements de configuration et la version distante du fichier. Si les fichiers de configuration ne sont pas synchronisés avec le serveur distant, les outils de développeur vous invitent à confirmer avant d'écraser des fichiers distants. Pour plus d'informations, voir la rubrique Administration de Liberty à l'aide des outils de développement qui contient des informations spécifiques aux serveurs distants. Vous pouvez aussi consulter la rubrique Edition de la configuration Liberty avec les outils de développement.
    Restriction : Dans le cas de serveurs distants, les outils ne permettent pas de spécifier des fichiers d'inclusion en utilisant des chemins d'accès absolus dans la configuration du serveur. Pour contourner ce problème, vous pouvez spécifier des chemins d'inclusion en utilisant les variables serveur prédéfinies telles que server.config.dir et shared.config.dir au lieu de chemins absolus.
  • Démarrage ou arrêt du serveur, ajout ou suppression d'applications sur le serveur, et autres tâches. Vous pouvez effectuer ces tâches en utilisant le menu du serveur (cliquez avec le bouton droit de la souris sur le serveur afin d'ouvrir le menu contextuel) ou en sélectionnant les boutons dans la vue Serveurs.
    Conseil : Dans la vue Serveurs, pour exécuter ces tâches, veillez à bien sélectionner l'entrée principale du serveur, et non la sous-entrée qui représente sa configuration, telle que Configuration de serveur [server.xml].
  • [16.0.0.4 et ultérieur]Vous pouvez créer et éditer les fichiers d'environnement de votre serveur. Pour plus d'informations, voir Création et édition de vos fichiers d'environnement de serveur dans la documentation du produit.

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

Nom du fichier : t_creating_remote_server.html