Emplacement des répertoires et des propriétés

Dans le profil Liberty, de nombreux répertoires ont des propriétés qui leur sont associées. Ces propriétés permettent de spécifier l'emplacement des fichiers lorsque vous configurez le serveur.

Tableau 1. Structure de répertoires par défaut de l'environnement d'exécution. La colonne 1 contient un fichier et une arborescence de répertoires. Si un répertoire est défini par une propriété, celle-ci est indiquée dans la colonne 2. Une description de chaque fichier ou répertoire est fournie dans la colonne 3.
Répertoire ou fichier Propriété Description
wlp/ wlp.install.dir Racine de l'installation
+- bin/   Scripts pour la gestion de l'installation. Exemple : server.
+- clients/   Client de profil Liberty et bibliothèques de client léger Exemple : restConnector.jar.
   +- jython/   Scripts en langage Jython
+- dev/   Racine pour les ressources de développeur (API, SPI, spécifications et outils)
   +- api/   API publiques. Par défaut, elles sont disponibles tant à la compilation qu'à l'exécution.
     +- ibm/   API disponibles dans le profil Liberty
        +- javadoc/   Archives de documents Java™
     +- spec/   API de spécification publiques. Par défaut, elles sont disponibles tant à la compilation qu'à l'exécution.
     +- third-party/   API tierces disponibles par défaut au cours de la compilation et qui doivent être spécifiées dans la configuration avec l'attribut apiTypeVisibility de l'élément classloader pour les applications à l'exécution.
   +- spi/   Interfaces SPI publiques pour la compilation et l'exécution par défaut
     +- ibm/   Interfaces SPI disponibles dans le profil Liberty
        +- javadoc/   Archives de document Java pour interface SPI
     +- spec/   Interfaces SPI de spécification publiques disponibles pour la compilation et l'exécution par défaut
   +- tools/   Plug-in Ant pour le profil Liberty
+- etc/   Variables de serveur personnalisées par l'utilisateur et qui s'appliquent à tous les serveurs (facultatif)
   +- server.env   Variables d'environnement pour le script 'server' par défaut (facultatif)
   +- client.env   Variables d'environnement pour le script 'client' par défaut (facultatif)
   +- jvm.options   Options de JVM par défaut (facultatif)
+- lafiles/   Fichiers d'informations sur la licence
+- lib/   Environnement d'exécution de la plateforme
+- templates/   Modèles et exemples de personnalisation de l'exécution
[8.5.5.6 ou ultérieure]   +- client/ [8.5.5.6 ou ultérieure]  [8.5.5.6 ou ultérieure][8.5.5.6 ou ultérieure]Modèle client lors de la création d'un client
   +- server/   Modèle de serveur lors de la création d'un serveur
+- usr/ wlp.user.dir Répertoire utilisateur
   +- extension/ usr.extension.dir Fonctions développées par l'utilisateur
   +- shared/    
      +- apps/ shared.app.dir Applications partagées
      +- config/ shared.config.dir Fichiers de configuration partagés
      +- resources/ shared.resource.dir Définitions des ressources partagées : adaptateurs, sources de données
   +- servers/   Répertoire commun à tous les serveurs
      +- server_name server.config.dir Répertoire de configuration du serveur. Utilisez ${server.config.dir} pour référencer la configuration propre au serveur (applications).
         +- bootstrap.properties   Fichier de propriétés d'amorçage du serveur (facultatif)
         +- jvm.options   Options de la machine virtuelle Java du serveur, qui remplacent les valeurs qui figurent dans le fichier wlp/etc/jvm.options (facultatif)
         +- server.env   Variables d'environnement de script de serveur, qui sont fusionnées avec wlp/etc/server.env (facultatif)
         +- server.xml   Chevauchements de configuration de serveur (requis)
         +- apps/   Configuration des applications de ce serveur
         +- dropins/   Dossier utilisé par défaut sur ce serveur pour le dépôt d'applications (facultatif)
            +- nom_application   Dossier ou archive d'une application (facultatif)
[8.5.5.5 ou ultérieure]         +- configDropins/ [8.5.5.5 ou ultérieure]  [8.5.5.5 ou ultérieure]Dossier utilisé par défaut sur ce serveur pour le dépôt de configuration de serveur (facultatif)
[8.5.5.5 ou ultérieure]            +- defaults [8.5.5.5 ou ultérieure]  [8.5.5.5 ou ultérieure]Dossier utilisé par défaut sur ce serveur pour le dépôt de configuration de serveur (facultatif)
[8.5.5.5 ou ultérieure]            +- overrides [8.5.5.5 ou ultérieure]  [8.5.5.5 ou ultérieure]Dossier utilisé par défaut sur ce serveur pour le dépôt de substitutions de configuration de serveur (facultatif)
      +- server_name server.output.dir Répertoire de sortie du serveur. Utilisez ${server.output.dir} pour décrire les artefacts générés par le serveur (fichiers journaux et zone de travail).
         +- logs/   Fichiers journaux du serveur, notamment les journaux de l'outil de diagnostic de premier niveau (le répertoire est présent après la première exécution du serveur)
            +- console.log   Messages rendant compte de l'état et des opérations du serveur
            +- trace_timestamp.log   Messages de trace horodatés, avec le niveau de détail déterminé par la configuration de traçage en vigueur au moment où ils sont consignés
            +- ffdc/   Répertoire de sortie des journaux FFDC (diagnostic de premier niveau)
               +- ffdc_horodatage/   Sortie de l'outil de diagnostic de premier niveau qui inclut généralement des clichés de mémoire sélectifs des données de diagnostic liées à l'échec d'une opération demandée
         +- workarea/   Fichiers créés par le serveur lors de son exécution. Ce répertoire est créé à la première exécution du serveur.
[8.5.5.6 ou ultérieure]   +- clients/   Répertoire commun à tous les clients
      +- nom_client   Répertoire de configuration du client.
         +- bootstrap.properties   Fichier de propriétés d'amorçage du client (facultatif)
         +- client.jvm.options   Options de la machine virtuelle Java du client, qui remplacent les valeurs qui figurent dans le fichier wlp/etc/client.jvm.options (facultatif)
         +- client.xml   Chevauchements de configuration de client (requis)
         +- apps/   Configuration des applications de ce client
         +- logs/   Fichiers journaux du client, notamment les journaux de l'outil de diagnostic de premier niveau (le répertoire est présent après la première exécution du client)
            +- trace_timestamp.log   Messages de trace horodatés, avec le niveau de détail déterminé par la configuration de traçage en vigueur au moment où ils sont consignés
            +- ffdc/   Répertoire de sortie des journaux FFDC (diagnostic de premier niveau)
               +- ffdc_horodatage/   Sortie de l'outil de diagnostic de premier niveau qui inclut généralement des clichés de mémoire sélectifs des données de diagnostic liées à l'échec d'une opération demandée
         +- workarea/   Fichiers créés par le client lors de son exécution. Ce répertoire est créé à la première exécution du client.

Vous pouvez utiliser les propriétés associées à chaque répertoire, le cas échéant, pour spécifier l'emplacement des fichiers lorsque vous configurez le serveur. Pour un exemple, voir Déploiement d'applications dans le profil Liberty.

Conseil : Pour garantir la portabilité de votre configuration, utilisez la propriété adéquate la plus spécifique qui soit et ne comptez pas sur les relations entre ressources. Par exemple, dans certaines configurations, l'emplacement de l'installation, ${wlp.install.dir}, peut ne pas être le parent de l'instance personnalisée ${wlp.user.dir}.

Accès par programmation aux propriétés d'emplacement

Les propriétés d'emplacement peuvent être liées à l'espace nom JNDI sous les noms de votre choix, à l'aide d'éléments de configuration jndiEntry dans le fichier server.xml, par exemple :

<jndiEntry jndiName="serverName" value="${wlp.server.name}"/>

Ces entrées sont accessibles par tout code qui s'exécute dans le serveur (applications, bibliothèques partagées ou fonctions) via une recherche JNDI :

Object serverName = new InitialContext().lookup("serverName");

Pour plus d'informations sur la manière d'utiliser les entrées JNDI dans la configuration, voir Utilisation de liaisons JNDI pour lier des constantes depuis un fichier de configuration de serveur.

Le code de fonction peut également utiliser une interface de programmation système (SPI) fournie par le noyau pour résoudre les valeurs de ces propriétés, par exemple :

ServiceReference <WsLocationAdmin>locationAdminRef = bundleContext.getServiceReference(WsLocationAdmin.class);
WsLocationAdmin locationAdmin = bundleContext.getService(locationAdminRef);
String serverName = locationAdmin.resolveString("${wlp.server.name}");

Icône indiquant le type de rubrique Rubrique de référence

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_dirs
Nom du fichier : rwlp_dirs.html