Liberty profile: Directory locations and properties

In the Liberty profile, many directories have properties associated with them. These properties can be used to specify file locations when you configure the server.

Table 1. Runtime environment default directory structure. Column 1 contains a file and directory tree. If a directory has a property associated with it, this is given in column 2. A description of each file or directory is given in Column 3.
Directory or file Property Description
wlp/ wlp.install.dir Root of installation
+- bin/   Scripts for managing the installation. For example, server.
+- clients/   Liberty profile client and thin client libraries. For example restConnector.jar.
   +- jython/   Jython-based scripts
+- dev/   Root for developer resources (APIs, SPIs, specifications, and tools)
   +- api/   Public APIs available for both compile and run time by default
     +- ibm/   APIs available in the Liberty profile
        +- javadoc/   Java™ document archives
     +- spec/   Public specification APIs available for both compile and run time by default
     +- third-party/   Third-party APIs that are available at compile time by default and must be specified in the configuration using the apiTypeVisibility attribute of the classloader element for applications at run time.
   +- spi/   Public SPIs available for both compile and run time by default
     +- ibm/   SPIs available in the Liberty profile
        +- javadoc/   Java document archives for SPI
     +- spec/   Public specification SPIs available for both compile and run time by default
   +- tools/   Ant plug-in for the Liberty profile
+- etc/   User customized server variables that apply to all servers (optional)
   +- server.env   Default server script environment variables (optional)
   +- jvm.options   Default jvm options (optional)
+- lafiles/   License information files
+- lib/   Platform runtime environment
+- templates/   Runtime customization templates and examples
   +- server/   Server template when creating a server
+- usr/ wlp.user.dir User directory
Fix Pack 8550    +- extension/ usr.extension.dir User-developed features
   +- shared/    
      +- apps/ shared.app.dir Shared applications
      +- config/ shared.config.dir Shared configuration files
      +- resources/ shared.resource.dir Shared resource definitions: adapters, data sources
   +- servers/   Shared servers directory
      +- server_name server.config.dir Server configuration directory. Use ${server.config.dir} to reference server-specific configuration (applications).
         +- bootstrap.properties   Server bootstrap properties (optional)
         +- jvm.options   Server JVM options, which replace the values in wlp/etc/jvm.options (optional)
         +- server.env   Server script environment variables, which are merged with wlp/etc/server.env (optional)
         +- server.xml   Server configuration overlays (required)
         +- apps/   Server configuration for applications
         +- dropins/   Server default application dropins folder (optional)
            +- application_name   Application folder or archive (optional)
      +- server_name server.output.dir Server output directory. Use ${server.output.dir} to describe artifacts generated by the server (log files and workarea).
         +- logs/   Server log files, including FFDC logs (directory is present after server is first run)
            +- console.log   Basic server status and operations messages
            +- trace_timestamp.log   Time-stamped trace messages, with the level of detail determined by the current tracing configuration
            +- ffdc/   First Failure Data Capture (FFDC) output directory
               +- ffdc_timestamp/   First Failure Data Capture (FFDC) output that typically includes selective memory dumps of diagnostic data related to the failure of a requested operation
         +- workarea/   Files created by the server as it operates (directory is present after server is first run)

You can use the properties associated with each directory, if any, to specify file locations when you configure the server. For an example, see Deploying applications to the Liberty profile.

Tip: To ensure configuration portability, use the most specific property that is appropriate, and do not rely on the relationship between resources. For example, in some configurations the installation location, ${wlp.install.dir} might not be the parent of the customized instance ${wlp.user.dir}.

Icon that indicates the type of topic Reference topic

Terms and conditions for information centers | Feedback


Timestamp icon Last updated: Wednesday, 22 May 2013
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-mp&topic=rwlp_dirs
File name: rwlp_dirs.html