Domain Directory Contents
By default, Oracle WebLogic Server creates domain directories under Oracle
Middleware MW_HOME
/user_projects/domains
directory.
This section describes the contents of the domain directory and its subfolders.
In this section, domain-name
, deployment-name
,
and server-name
represent names that you
define when you create a domain.
Individual applications in a domain might create additional files and directories in the domain directory.
If you have not yet created a domain, you can see an example of an existing
domain directory by looking in WL_HOME
/examples/domains/wl_server
where WL_HOME
is the directory in which
you installed Oracle WebLogic Server.
autodeploy
This directory provides a quick way to deploy applications in a development server. When the Oracle WebLogic Server instance is running in development mode, it automatically deploys any applications or modules that you place in this directory.
The files you place in this directory can be Java EE applications, such as:
-
An EAR file
-
A WAR, EJB JAR, RAR, or CAR archived module
-
An exploded archive directory for either an application or a module
bin
This directory contains scripts that are used in the process of starting and
stopping the Administration Server and the Managed Servers in the domain. These
scripts are generally provided as .sh
files for UNIX
and .cmd
files for Windows.
The bin
directory can optionally contain other scripts of
domain-wide interest, such as scripts to start and stop database management
systems, full-text search engine processes, and such. For more information,
see Oracle Fusion Middleware Managing Server Startup and Shutdown for
Oracle WebLogic Server.
config
This directory contains the current configuration and deployment state of the
domain. The central domain configuration file, config.xml
,
resides in this directory.
config/configCache
Contains data that is used to optimize performance when validating changes in the domain‘s configuration documents. This data is internal to Oracle WebLogic Server and does not need to be backed up.
config/diagnostics
This directory contains system modules for instrumentation in the WebLogic Diagnostic Framework. For more information, see Oracle Fusion Middleware Configuring and Using the Diagnostics Framework for Oracle WebLogic Server.
config/jdbc
This directory contains system modules for JDBC: global JDBC modules that can be configured directly from JMX (as opposed to JSR-88). For more information, see Database Connectivity for Oracle WebLogic Server.
config/jms
This directory contains system modules for JMS: global JMS modules that can be configured directly from JMX (as opposed to JSR-88). For more information, see Messaging for Oracle WebLogic Server.
config/nodemanager
This directory holds configuration information for connection to the Node Manager. For more information, see "Node Manager Configuration and Log Files" in the Oracle Fusion Middleware Node Manager Administrator‘s Guide for Oracle WebLogic Server.
config/security
This directory contains system modules for the security framework. It contains one security provider configuration extension for each kind of security provider in the domain‘s current realm. For more information, see Oracle Fusion Middleware Understanding Security for Oracle WebLogic Server.
configArchive
This directory contains a set of JAR files that save the domain‘s
configuration state. Just before pending changes to the configuration are
activated, the domain‘s existing configuration state, consisting of
the config.xml
file and the other related configuration
files, is saved in a versioned JAR file with a name
like config.jar#1
, config.jar#2
, and
such.
The maximum number of versioned JAR files to be kept is specified by
the archiveConfigurationCount
attribute
of DomainMBean
. Once this maximum number is reached, the
oldest conversion archive is deleted before a new one is created.
console-ext
This directory contains extensions to the Administration Console, which enable you to add content to the Oracle WebLogic Server Administration Console, replace content, and change the logos, styles and colors without modifying the files that are installed with Oracle WebLogic Server. For example, you can add content that provides custom monitoring and management facilities for your applications. See Oracle Fusion Middleware Extending the Administration Console for Oracle WebLogic Server.
init-info
This directory contains files used for WebLogic domain provisioning. You should not modify any files in this directory.
lib
JAR files you put in this directory are made available (within a separate
system level classloader) to all Java EE applications running on WebLogic Server
instances in the domain. For more information, see "Adding
JARs to the Domain /lib
Directory" in Oracle Fusion Middleware Developing Applications for Oracle
WebLogic Server.
pending
This directory contains domain configuration files representing configuration changes that have been requested, but not yet activated. Once the configuration changes have been activated, the configuration files are deleted from this directory. For more information, see Chapter 4, "Managing Configuration Changes".
security
This directory holds those security-related files that are the same for every Oracle WebLogic Server instance in the domain:
-
SerializedSystemIni.dat
This directory also holds security-related files that are only needed by the domain‘s Administration Server:
-
DefaultAuthorizerInit.ldift
-
DefaultAuthenticatorInit.ldift
-
DefaultRoleMapperInit.ldift
-
XACMLRoleMapperInit.ldift
For more information, see Oracle Fusion Middleware Understanding Security for Oracle WebLogic Server.
servers
This directory contains one subdirectory for each Oracle WebLogic Server instance in the domain. The subdirectories contain data that is specific to each server instance.
servers/server-name
This directory is the server directory for the Oracle WebLogic Server instance with the same name as the directory.
servers/server-name/cache
This directory holds directories and files that contain cached data. By "cached" we mean that the data is a copy, possibly in a processed form (compiled, translated, or reformatted), of other data.
servers/server-name/data
This directory holds files that maintain persistent per-server state used to run the Oracle WebLogic Server instance, other than security state, as opposed to temporary, cached or historical information. Files in this directory are important data that must be retained as the Oracle WebLogic Server instance is brought up, is brought down, crashes, restarts, or is upgraded to a new version.
servers/server-name/data/ldap
This directory holds the embedded LDAP database. The run-time security state for the Oracle WebLogic Server instance is persisted in this directory.
servers/server-name/data/store
This directory holds WebLogic persistent stores. For each persistent store,
there is a subdirectory that holds the files that represent the persistent
store. The name of the subdirectory is the name of the persistent store. By
convention there is one store named default
.
servers/server-name/logs
This directory holds logs and diagnostic information. This information is historical in nature. It is not crucial to the operation of the server, and can be deleted (while the Oracle WebLogic Server instance is down, at least) without affecting proper operation. However, the information can be quite useful for debugging or auditing purposes and should not be deleted without good reason.
servers/server-name/logs/diagnostic_images
This directory holds information created by the Server Image Capture component of the WebLogic Diagnostic Framework. For more information, see Oracle Fusion Middleware Configuring and Using the Diagnostics Framework for Oracle WebLogic Server.
servers/server-name/logs/jmsServers
This directory contains one subdirectory for each JMS server in the Oracle WebLogic Server instance. Each such subdirectory contains the logs for that JMS server. The name of the subdirectory is the name of the JMS server.
servers/server-name/security
This directory holds security-related files that can be or must be different
for each Oracle WebLogic Server instance. The
file boot.properties
is an example of a file that resides
here because it can differ from one server to the next. This directory also
maintains files related to SSL keys.
servers/server-name/tmp
This directory holds temporary directories and files that are created while a server instance is running. For example, a JMS paging directory is automatically created here unless another location is specified. Files in this directory must be left alone while the server is running, but may be freely deleted when the server instance is shut down.
A Server‘s Root Directory
All instances of Oracle WebLogic Server use a root directory to store their working copy of the domain‘s configuration files, to store run-time data, and to provide the context for any relative pathnames in the server‘s configuration. An Administration Server always uses the domain directory as its root directory. A Managed Server can use the domain directory but can also use any other directory that you define.
For example, if you start a Managed Server on a computer that does not share a file system with the computer that hosts the Administration Server, the Managed Server will create its own root directory. The server will copy data from the domain directory to this root directory and will write run-time data in this directory.
You can specify the path and name of the server root directory for each server instance. You can specify a common server root directory for multiple server instances hosted on a single computer or you can specify a different server root directory for each server. A domain may have one or more server root directories.
Specifying a Server Root Directory
You can specify the path for the server root directory by one of the following means:
-
Use the
-Dweblogic.RootDirectory=
path
option when starting a Oracle WebLogic Server instance from command line. For example, the following command starts an Oracle WebLogic Server instance and usesc:\MyServerRootDirectory
as the server root directory:java -Dweblogic.RootDirectory=c:\MyServerRootDirectory weblogic.Server
-
If you use Node Manager to start an Oracle WebLogic Server instance, you can specify a server root directory with the Root Directory attribute in the Administration Console on the Environment > Servers > server_name > Configuration > Server Start page.
If you do not use one of the above means to specify a server root directory, the path and name of the server root directory depend on whether a server instance is a Managed Server or the Administration Server and whether or not you use Node Manager to start the server instance. These variations are discussed in the next sections.
Server Root Directory for an Administration Server
An Administration Server uses its server root directory as a repository for
the domain‘s configuration data (such as config.xml
) and
security resources (such as the default, embedded LDAP server).
To determine the root directory for an Administration Server, Oracle WebLogic Server does the following:
-
If the server‘s startup command includes the
-Dweblogic.RootDirectory=
path
option, then the value ofpath
is the server root directory. -
If
-Dweblogic.RootDirectory=
path
is not specified, then the working directory is the server root directory.
If Oracle WebLogic Server cannot find
a config.xml
file, then it offers to create one. You can
use this method to create a new domain. For more information, see "Using
the weblogic.Server Command Line to Create a Domain" in the Oracle Fusion Middleware Command Reference for Oracle WebLogic
Server.
Server Root Directory for a Managed Server Started with Node Manager
If you use the Node Manager to start a Managed Server, the root directory is located on the computer that hosts the Node Manager process. To determine the location of the server‘s root directory, Oracle WebLogic Server does the following:
-
If you specified a root directory in the Administration Console on the Environment > Servers > server-name > Configuration > Server Start page, then the directory you specified is the server root directory.
-
If you did not specify a root directory in the Administration Console, then the server root directory is:
MW_HOME\user_projects\domains\domain-name\servers\managed-server-name
where
MW_HOME
is the directory in which you installed Oracle WebLogic Server on the Node Manager‘s host computer.
Server Root Directory for a Managed Server Not Started with Node Manager
If you do not use the Node Manager to start a Managed Server (and therefore
use the java weblogic.Server
command or a script that
calls that command), Oracle WebLogic Server does the following to determine the
root directory:
-
If the server‘s startup command includes the
-Dweblogic.RootDirectory=
path
option, then the value ofpath
is the server‘s root directory. -
If
-Dweblogic.RootDirectory=
path
is not specified, then the working (current) directory is the root directory. For example, if you run theweblogic.Server
command fromc:\config\MyManagedServer
, thenc:\config\MyManagedServer
is the root directory.
To make it easier to maintain your domain configurations and applications across upgrades of Oracle WebLogic Server software, it is recommended that the server root directory not be the same as the installation directory for the Oracle WebLogic Server software.
参考:http://docs.oracle.com/cd/E23943_01/web.1111/e13716/config_files.htm#autoId15