ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/admin/refrepos.htm

147 lines
10 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
<title>Administrative repository</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h3><a name="refrepos"></a>Administrative repository</h3>
<p>WebSphere Application Server - Express stores configuration data for each application server instance in XML documents, which reside in a cascading hierarchy of directories beneath the root directory for the instance. This hierarchy of directories makes up the administrative repository for a WebSphere Application Server - Express instance. The configuration documents describe the servers, nodes, applications, and resources that are part of the instance.</p>
<p><strong>Hierarchy of configuration directories</strong></p>
<p>The administrative repository for each instance starts with the config directory located directly under the root directory for the instance. For the myAppSvr instance, the administrative respository is contained in the /QIBM/UserData/WebASE51/ASE/myAppSvr/config directory.</p>
<p>The administrative repository for an instance contains the following directories and files:</p>
<ul>
<li><p><strong>/config</strong><br>
The config directory is the repository root directory for an instance. It contains a single file, plugin-cfg-service.xmi. The plugin-cfg-service file defines the custom service that causes the Web server plugin file, plugin-cfg.xml, to be regenerated each time the application server is started.
<!--Commented out by Rachel Pobocik 2/20/03. This page will not be available at GA. Will be added in a refresh-->
<!--For more information about custom services, see <a href="../program/custserv.htm">Custom services</a>.--></p></li>
<li><p><strong>/config/cells</strong><br>
The cells subdirectory contains a single subdirectory for the cell to which the instance belongs. The <tt>cells</tt> directory also contains the Web server plugin file, plugin-cfg.xml. The Web server plugin that runs in your HTTP server instance uses this file to determine which web resources are installed in your instance.</p></li>
<li><p><strong>/config/cells/<em>cellname</em></strong><br>
For an instance of WebSphere Application Server - Express, the cell name is <em>hostname_instance</em>, where <em>hostname</em> is the iSeries system host name, and <em>instance</em> is the name of the instance.</p>
<p>The cell directory contains these files, which provide configuration data for the cell and for all of the nodes in the cell:</p>
<ul>
<li>admin-authz.xml<br>
Contains configuration data for authorizations to administrative functions.</li>
<li>cell.xml<br>
Contains configuration data for the cell.</li>
<li>filter.policy<br>
Enterprise applications use app.policy and was.policy files. The filter.policy file contains permissions that the WebSphere Application Server - Express runtime code removes from the app.policy and was.policy files.</li>
<li>integral-jms-authorizations.xml<br>
This file is not used by WebSphere Application Server - Express.</li>
<li>multibroker.xml<br>
This file is not used by WebSphere Application Server - Express.</li>
<li>namestore.xml<br>
Contains persistent name binding data for the naming service.</li>
<li>naming-authz.xml<br>
Contains the configuration information for authorizations to naming service functions.</li>
<li>pmirm.xml<br>
This file is not used by WebSphere Application Server - Express.</li>
<li>resources.xml<br>
Defines the resources that enterprise applications use. Resources include JDBC providers, data sources, and mail providers.</li>
<li>security.xml<br>
Contains configuration data for the security service.</li>
<li>variables.xml<br>
Contains configuration variables used to specify directory paths. The variables can then be substitiuted for the actual path when specifying locations for log files, JDBC implmentation classes, and application install paths.</li>
<li>virtualhosts.xml<br>
Contains configuration data for virtual hosts and their MIME types.</li>
</ul><p></p></li>
<li><p><strong>/config/cells/<em>cellname</em>/applications</strong><br>
The applications subdirectory contains a subdirectory for each application deployed in the cell.</p></li>
<li><p><strong>/config/cells/<em>cellname</em>/applications/<em>application</em></strong><br>
The names of the applications subdirectories match the names of the application's EAR files. For example, if an application is packaged in App1.ear, its subdirectory is also named App1.ear. Each deployed application subdirectory contains the EAR file for the application and a deployments subdirectory. The deployments subdirectory contains these files and subdirectories:</p>
<ul>
<li>deployment.xml<br>
The file that contains configuration data on the application deployment.</li>
<li>META-INF<br>
The subdirectory that contains a J2EE application deployment descriptor file as well as IBM deployment extensions files and bindings files.</li>
<li>Subdirectories for all WAR and JAR files in the application. These subdirectories contain the XML and XMI configuration files for the web modules and enterprise bean modules that are included in the application.</li>
</ul><p></p></li>
<li><p><strong>/config/cells/<em>cellname</em>/nodes</strong><br>
The nodes subdirectory contains a subdirectory for the instance node.</p></li>
<li><p><strong>/config/cells/<em>cellname</em>/nodes/<em>nodename</em></strong><br>
Node names for instances of WebSphere Application Server - Express are <em>hostname_instance</em>, where <em>hostname</em> is the iSeries system host name, and <em>instance</em> is the name of the instance.</p>
<p>Each node subdirectory contains these files:</p>
<p><strong>Note:</strong> Some of these files have the same names as those in the containing cell directory. The configurations specified in node-level documents override the configurations specified in cell documents having the same name.</p>
<ul>
<li>app.policy<br>
Contains default security permissions for application code.</li>
<li>library.policy<br>
Contains security permissions for shared libraries.</li>
<li>namestore.xml<br>
Contains persistent name binding data for the naming service.</li>
<li>node.xml<br>
Contains the configuration data for the node.</li>
<li>resources.xml<br>
Defines the resources that enterprise applications use. Resources include JDBC providers, data sources, and mail providers.</li>
<li>serverindex.xml<br>
Specifies the TCP/IP ports for special endpoints for each server under the node. Port values of services such as the naming service, SOAP service, and security services are specified here. This file also contains information on which enterprise applications are installed on each server.</li>
<li>spi.policy<br>Contains security permissions for service provider libraries such as resource providers.</li>
<li>variables.xml<br>
Contains configuration variables used to specify directory paths. The variables can then be substitiuted for the actual path when specifying locations for WebSphere log files, JDBC implmentation classes, and application install paths.</li>
</ul><p></p></li>
<li><p><strong>/config/cells/<em>cellname</em>/nodes/<em>nodename</em>/servers/<em>servername</em></strong><br>
The name of the subdirectory corresponds to the name of the server. The name of the application server is the same as the name of your instance.</p>
<p>The server directory contains a server.xml file, which provides configuration data specific to the server process. The server can also have files such as variables.xml and resources.xml, which provide additional configuration data that applies only to the server process.</p>
<p>The server subdirectory can contain any of these files:</p>
<p><strong>Note:</strong> Some of these files have the same names as those in the containing node or cell directory. The configurations specified in server-level documents override the configurations specified in node and cell documents having the same name.</p>
<ul>
<li>namestore-cell.xml<br>
Contains persistent cell-level name binding data for the naming service.</li>
<li>namestore-node.xml<br>
Contains persistent node-level name binding data for the naming service.</li>
<li>resources.xml<br>
Defines the resources that enterprise applications use. Resources include JDBC providers, data sources, and mail providers.</li>
<li>server.xml<br>
Contains configuration data for the services and components that run in the server process.</li>
<li>variables.xml<br>
Contains configuration variables used to specify directory paths. The variables can then be substitiuted for the actual path when specifying locations for WebSphere log files, JDBC implementation classes, and application install paths.</li>
</ul><p></p></li>
<li><p><strong>config/templates</strong><br>
The templates directory contains two subdirectories, named default and system, which contain template XML files for several configuration object types such as servers and JDBC providers.</p>
<p>The WebSphere administrative console uses these templates when displaying default properties for a resource you are creating. You can also use these templates with the wsadmin scripting tool to create new resources based on the templates.</p></li>
</ul>
<p>Here is an example of the structure.</p>
<pre>
<strong>config</strong>
<strong>cells</strong>
<strong>cell1</strong>
cell.xml resources.xml virtualhosts.xml variables.xml security.xml
<strong>applications</strong>
<strong>sampleApp1</strong>
deployment.xml
<strong>META-INF</strong>
application.xml ibm-application-ext.xml ibm-application-bnd.xml
<strong>sampleApp2</strong>
deployment.xml
<strong>META-INF</strong>
application.xml ibm-application-ext.xml ibm-application-bnd.xml
<strong>nodes</strong>
<strong>nodeX</strong>
node.xml variables.xml resources.xml serverindex.xml
<strong>servers</strong>
<strong>serverA</strong>
server.xml variables.xml</pre>
</body>
</html>