Ubicaciones de directorio y propiedades

En Liberty, muchos directorios tienen propiedades asociadas con ellos. Estas propiedades se pueden utilizar para especificar las ubicaciones de archivo al configurar el servidor.

Tabla 1. Estructura de directorios predeterminada del entorno de ejecución. La columna 1 contiene un archivo y un árbol de directorio. Si un directorio tiene una propiedad asociada, ésta se muestra en la columna 2. En la columna 3 se muestra una descripción de cada archivo o directorio.
Directorio o archivo Propiedad Descripción
wlp/ wlp.install.dir Raíz de instalación
+- bin/   Scripts para gestionar la instalación. Por ejemplo, server.
+- clients/   Bibliotecas de cliente ligero y de cliente de Liberty. Por ejemplo, restConnector.jar.
   +- jython/   Scripts basados en Jython
+- dev/   Raíz de recursos de desarrollador (API, SPI, especificaciones y herramientas)
   +- api/   Las API públicas disponibles de forma predeterminada para el tiempo de compilación y de ejecución
     +- ibm/   Las API disponibles en Liberty
        +- javadoc/   Archivos de documentos Java™
     +- spec/   Las API de especificación públicas disponibles de forma predeterminada para el tiempo de compilación y de ejecución
     +- third-party/   Las API de terceros que están disponibles en el tiempo de compilación de forma predeterminada y deben especificarse en la configuración utilizando el atributo apiTypeVisibility del elemento classloader para el tiempo de ejecución de las aplicaciones.
   +- spi/   SPI públicas disponibles en tiempo de compilación y en tiempo de ejecución de forma predeterminada
     +- ibm/   Las SPI disponibles en Liberty
        +- javadoc/   Archivados de documentos Java para SPI
     +- spec/   SPI de especificación públicas disponibles en tiempo de compilación y de ejecución de forma predeterminada
   +- tools/   Plugin Ant para Liberty
+- etc/   Variables de servidor personalizadas del usuario que se aplican a todos los servidores (opcional)
   +- server.env   Variables de entorno de script de servidor predeterminadas (opcional)
   +- client.env   Variables de entorno de script de cliente predeterminadas (opcional)
   +- jvm.options   Opciones de JVM predeterminadas (opcional)
+- lafiles/   Archivos de información sobre licencia
+- lib/   Entorno de ejecución de la plataforma
+- templates/   Plantillas de personalización de tiempo de ejecución y ejemplos
   +- server/   Plantilla de servidor cuando se crea un servidor
   +- client/   Plantilla de cliente cuando se crea un cliente
+- usr/ wlp.user.dir Directorio de usuario
   +- extension/ usr.extension.dir Características desarrolladas por el usuario
   +- shared/    
      +- apps/ shared.app.dir Aplicaciones compartidas
      +- config/ shared.config.dir Archivos de configuración compartidos
      +- resources/ shared.resource.dir Definiciones de recursos compartidos: adaptadores, orígenes de datos
      +- stackGroups/ shared.stackgroup.dir Los grupos de pilas compartidos para el despliegue remoto de paquetes e instalables
   +- servers/   Directorio de servidores compartidos
      +- nombre_servidor server.config.dir Directorio de configuración del servidor. Utilice ${server.config.dir} para hacer referencia a la configuración específica del servidor (aplicaciones).
         +- bootstrap.properties   Propiedades del programa de arranque del servidor (opcional)
         +- jvm.options   Opciones de JVM del servidor, que sustituyen a los valores de wlp/etc/jvm.options (opcional)
         +- server.env   Variables de entorno del script de servidor, que se fusionan con wlp/etc/server.env (opcional)
         +- server.xml   Preformatos de configuración del servidor (necesario)
         +- apps/   Configuración del servidor para aplicaciones
         +- dropins/   Carpeta dropins de aplicaciones predeterminada del servidor (opcional)
            +- nombre_aplicación   Carpeta o archivo de aplicación (opcional)
         +- configDropins/   Carpeta dropins de configuración de servidor (opcional)
            +- defaults   Carpeta dropins de configuración de servidor predeterminada (opcional)
            +- overrides   Carpeta dropins de alteraciones temporales de configuración de servidor (opcional)
      +- nombre_servidor server.output.dir El directorio de salida del servidor. Utilice ${server.output.dir} para describir los artefactos generados por el servidor (archivos de registro y área de trabajo).
         +- logs/   Los archivos de registro del servidor, incluidos los registros de FFDC (el directorio está presente después de la primera ejecución del servidor)
            +- console.log   Estado de servidor básico y mensajes de operaciones
            +- trace_indicación_fecha_hora.log   Mensajes de rastreo con indicación de fecha y hora, con el nivel de detalle determinado por la configuración de rastreo actual
            +- ffdc/   Directorio de salida de FFDC (captura de datos en primer error)
               +- ffdc_indicación_fecha_hora/   La salida de captura de datos en primer error (FFDC) que normalmente incluye vuelcos de memoria selectiva de los datos de diagnóstico relacionados con el error de una operación solicitada
         +- workarea/   Archivos creados por el servidor cuando está en funcionamiento (el directorio está presente después de la primera ejecución del servidor)
   +- clients/   Directorio de clientes compartidos
      +- nombre_cliente   Directorio de configuración del cliente.
         +- bootstrap.properties   Propiedades del programa de arranque del cliente (opcional)
         +- client.jvm.options   Opciones de JVM del cliente, que sustituyen a los valores de wlp/etc/client.jvm.options (opcional)
         +- client.xml   Preformatos de configuración del cliente (necesario)
         +- apps/   Configuración del cliente para aplicaciones
         +- logs/   Los archivos de registro del cliente, incluidos los registros de FFDC (el directorio está presente después de la primera ejecución del cliente)
            +- trace_indicación_fecha_hora.log   Mensajes de rastreo con indicación de fecha y hora, con el nivel de detalle determinado por la configuración de rastreo actual
            +- ffdc/   Directorio de salida de FFDC (captura de datos en primer error)
               +- ffdc_indicación_fecha_hora/   La salida de captura de datos en primer error (FFDC) que normalmente incluye vuelcos de memoria selectiva de los datos de diagnóstico relacionados con el error de una operación solicitada
         +- workarea/   Archivos creados por el cliente cuando está en funcionamiento (el directorio está presente después de la primera ejecución del cliente)

Puede utilizar las propiedades asociadas a cada directorio, si existe, para especificar las ubicaciones de archivo al configurar el servidor. Para ver un ejemplo, consulte Despliegue de aplicaciones en Liberty.

Consejo: Para garantizar la portabilidad de la configuración, utilice la propiedad más específica que sea apropiada, y no dependa de la relación entre recursos. Por ejemplo, en algunas configuraciones, la ubicación de instalación, ${wlp.install.dir}, puede no ser el padre de la instancia personalizada ${wlp.user.dir}.

Acceso mediante programación a las propiedades de ubicación

Las propiedades de ubicación se pueden enlazar en el espacio de nombres JNDI bajo los nombres de su elección, utilizando los elementos de configuración jndiEntry del archivo server.xml, por ejemplo:

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

Dichas entradas son accesibles por cualquier código que se ejecuta en el servidor (aplicaciones, bibliotecas compartidas o características) mediante una búsqueda JNDI:

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

Para obtener más información sobre cómo utilizar entradas JNDI en la configuración, consulte Utilización del enlace JNDI para las constantes desde los archivos de configuración del servidor.

El código de característica también puede utilizar una interfaz de programación del sistema (SPI) que proporciona el kernel para resolver los valores de estas propiedades, por ejemplo:

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

Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_dirs.html