Emplacement des répertoires et des propriétés
Dans 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.
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 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 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 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 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 | |
+- server/ | Modèle de serveur lors de la création d'un serveur | |
+- client/ | Modèle client lors de la création d'un client | |
+- 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 |
+- stackGroups/ | shared.stackgroup.dir | Groupes de pile partagés pour le déploiement à distance de packages et de packages installables |
+- servers/ | Répertoire commun à tous les serveurs | |
+- nom_serveur | 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) | |
+- configDropins/ | Dossier utilisé par défaut sur ce serveur pour le dépôt de configuration de serveur (facultatif) | |
+- defaults | Dossier utilisé par défaut sur ce serveur pour le dépôt de configuration de serveur (facultatif) | |
+- overrides | Dossier utilisé par défaut sur ce serveur pour le dépôt de substitutions de configuration de serveur (facultatif) | |
+- nom_serveur | 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_horodatage.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. | |
+- 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_horodatage.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 Liberty.
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}");