Directory conventions

References in product information to APP_ROOT, $PROFILE_ROOT, and other directories imply specific default directory locations. This page describes the conventions in use for WebSphere Application Server.

 

Default product locations - z/OS

[z/OS]

APP_ROOT

Refers to the top directory for a WAS node.

The node may be of any type—appserver, dmgr, or unmanaged for example. Each node has its own APP_ROOT. Corresponding product variables are was.install.root and WAS_HOME.

The default varies based on node type. Common defaults are configuration_root/AppServer and configuration_root/DeploymentManager.

configuration_root

Refers to the mount point for the configuration file system (formerly, the configuration HFS) in WAS for z/OS.

The configuration_root contains the various APP_ROOT directories and certain symbolic links associated with them. Each different node type under the configuration_root requires its own cataloged procedures under z/OS.

The default is /wasv7config/cell_name/node_name.

plug-ins_root

Refers to the installation root directory for Web Server plug-ins.

profile_root

Refers to the home directory for a particular instantiated WAS profile.

Corresponding product variables are server.root and user.install.root.

In general, this is the same as APP_ROOT/profiles/profile_name. On z/OS, this will be always be APP_ROOT/profiles/default because only the profile name "default" is used in WAS for z/OS.

smpe_root

Refers to the root directory for product code installed with SMP/E.

The corresponding product variable is smpe.install.root.

The default is /usr/lpp/zWebSphere/V7R0.

 

Default product locations - IBM i

[iSeries]

These file paths are default locations. We can install WAS and other components in any directory where we have write access. We can create profiles in any valid directory where we have write access. Multiple installations of WAS products or components require multiple locations.

app_client_root

The default installation root directory for the Java ™ EE WebSphere Application Client is the /QIBM/ProdData/WebSphere/AppClient/V7/client directory.

app_client_user_data_root

The default Java EE WebSphere Application Client user data root is the /QIBM/UserData/WebSphere/AppClient/V7/client directory.

app_client_profile_root

The default Java EE WebSphere Application Client profile root is the /QIBM/UserData/WebSphere/AppClient/V7/client/profiles/profile_name directory.

APP_ROOT

The default installation root directory for WebSphere Application Server is the directory.

cip_APP_ROOT

The default installation root directory is the directory for a customized installation package (CIP) produced by the Installation Factory.

A CIP is a WAS product bundled with optional maintenance packages, an optional configuration archive, one or more optional enterprise archive files, and other optional files and scripts.

cip_profile_root

The default profile root directory is the directory for a customized installation package (CIP) produced by the Installation Factory.

cip_user_data_root

The default user data root directory is the directory for a customized installation package (CIP) produced by the Installation Factory.

if_root

This directory represents the root directory of the IBM WebSphere Installation Factory. Because we can download and unpack the Installation Factory to any directory on the file system to which we have write access, this directory's location varies by user. The Installation Factory is an Eclipse-based tool which creates installation packages for installing WAS in a reliable and repeatable way, tailored to the specific needs.

iip_root

This directory represents the root directory of an integrated installation package (IIP) produced by the IBM WebSphere Installation Factory. Because we can create and save an IIP to any directory on the file system to which we have write access, this directory's location varies by user. An IIP is an aggregated installation package created with the Installation Factory that can include one or more generally available installation packages, one or more customized installation packages (CIPs), and other user-specified files and directories.

java_home

Table 1. Root directories for supported Java Virtual Machines.

This table shows the root directories for all supported JVMs.

JVM Directory
Classic JVM /QIBM/ProdData/Java 400/jdk6
32–bit IBM Technology for Java /QOpenSys/QIBM/ProdData/Java VM/jdk60/32bit
64–bit IBM Technology for Java /QOpenSys/QIBM/ProdData/Java VM/jdk60/64bit

plugins_profile_root

The default Web server plug-ins profile root is the /QIBM/UserData/WebSphere/Plugins/V7/webserver/profiles/ profile_name directory.

PLUGINS_ROOT

The default installation root directory for Web server plug-ins is the /QIBM/ProdData/WebSphere/Plugins/V7/webserver directory.

plugins_user_data_root

The default Web server plug-ins user data root is the /QIBM/UserData/WebSphere/Plugins/V7/webserver directory.

product_library

product_lib

This is WAS library for the installed product. The product library for each V7.0 installation on the system contains the program and service program objects (similar to .exe, .dll, .so objects) for the installed product. WAS ND v7.0 library name is QWAS7x (where x is A, B, C, and so on). WAS ND v7.0 library for the first WebSphere Application Server V7.0 product installed on the system is QWAS7A. The APP_ROOT/properties/product.properties file contains the value for WAS library of the installation, was.install.library, and is located under the APP_ROOT directory.

profile_root

The default directory for a profile named profile_name for WAS is the directory.

shared_product_library

The shared product library, which contains all of the objects shared by all installations on the system, is QWAS7. This library contains objects such as WAS definition, the subsystem description, the job description, and the job queue.

updi_root

The default installation root directory for the Update Installer for WebSphere Software is the /QIBM/ProdData/WebSphere/UpdateInstaller/V7/updi directory.

user_data_root

The default user data directory for WebSphere Application Server is the directory.

The profiles and profileRegistry subdirectories are created under this directory when you install WAS ND.

WEB_ROOT

The default web server path is /www/web_server_name.

 

Default product locations (distributed)

[AIX Solaris HP-UX Linux Windows]

The following file paths are default locations. We can install WAS ND and other components or create profiles in any directory where you have write access. Multiple installations of WebSphere Application Server products or components require multiple locations. Default values for installation actions by root and non-root users are given. If no non-root values are specified, then the default directory values are applicable to both root and non-root users.

app_client_root

Table 2. Default installation root directories for the WebSphere Application Client.

This table shows the default installation root directories for the WebSphere Application Client.

User Directory
Root

[AIX] /usr/IBM/WebSphere/AppClient (Java EE Application client only)

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/WebSphere/AppClient (Java EE Application client only)

[Windows] <p> C:\Program Files\IBM\WebSphere\AppClient

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/WebSphere/AppClient (Java EE Application client only)

[Windows] <p> C:\IBM\WebSphere\AppClient

APP_ROOT

Table 3. Default installation directories for WAS.

This table shows the default installation directories for WebSphere Application Server.

User Directory
Root

[AIX] /usr/IBM/WebSphere/AppServer

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/WebSphere/AppServer

[Windows] <p> C:\Program Files\IBM\WebSphere\AppServer

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/WebSphere/AppServer

[Windows] <p> C:\IBM\WebSphere\AppServer

cip_APP_ROOT

A customized installation package (CIP) is an installation package created with IBM WebSphere Installation Factory that contains a WAS or feature pack product bundled with one or more maintenance packages, an optional configuration archive, one or more optional enterprise archive files, and other optional files and scripts.

Table 4. Default installation root directories for a CIP.

This table shows the default installation root directories for a CIP.

User Directory
Root

[AIX] /usr/IBM/WebSphere/AppServer

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/WebSphere/AppServer

[Windows] <p> C:\Program Files\IBM\WebSphere\AppServer

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/WebSphere/AppServer

[Windows] <p> C:\IBM\WebSphere\AppServer

component_root

The component installation root directory is any installation root directory described in this topic. Some programs are for use across multiple components. In particular, the Update Installer for WebSphere Software is for use with WAS, Web server plug-ins, the Application Client, and the IBM HTTP Server. All of these components are part of WAS package.

gskit_root

IBM Global Security Kit (GSKit) can now be installed by any user. GSKit is installed locally inside the installing product's directory structure and is no longer installed in a global location on the target system. The following list shows the default installation root directory for V7 of the GSKit, where product_root is the root directory of WAS that is installing GSKit, for example IBM HTTP Server or the Web server plug-in.

[AIX]

[HP-UX]

[Linux]

[Solaris] <p>


product_root/gsk7

[Windows] <p>


product_root\gsk7

if_root

This directory represents the root directory of the IBM WebSphere Installation Factory. Because we can download and unpack the Installation Factory to any directory on the file system to which we have write access, this directory's location varies by user. IBM WebSphere Installation Factory is an Eclipse-based tool which creates installation packages for installing WebSphere Application Server in a reliable and repeatable way, tailored to the specific needs.

iip_root

This directory represents the root directory of an integrated installation package (IIP) produced by the IBM WebSphere Installation Factory. Because we can create and save an IIP to any directory on the file system to which we have write access, this directory's location varies by user. An IIP is an aggregated installation package that can include one or more generally available installation packages, one or more customized installation packages (CIPs), and other user-specified files and directories.

profile_root

Table 5. Default profile directories.

This table shows the default directories for a profile named profile_name on each distributed operating system.

User Directory
Root

[AIX] /usr/IBM/WebSphere/AppServer/profiles/profile_name

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/WebSphere/AppServer/profiles/profile_name

[Windows] <p> C:\Program Files\IBM\WebSphere\AppServer\profiles\profile_name

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/WebSphere/AppServer/profiles/

[Windows] <p> C:\IBM\WebSphere\AppServer\profiles\

PLUGINS_ROOT

Table 6. Default installation root directories for the Web server plug-ins.

This table shows the default installation root directories for the Web server plug-ins for WAS.

User Directory
Root

[AIX] /usr/IBM/WebSphere/Plugins

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/WebSphere/Plugins

[Windows] <p> C:\Program Files\IBM\WebSphere\Plugins

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/WebSphere/Plugins

[Windows] <p> C:\IBM\WebSphere\Plugins

If the Web server plug-ins are installed as part of the IBM HTTP Server installation, the installation location is inside the IBM HTTP Server installation location. For example:

/opt/IBM/HTTPServer/Plugins

updi_root

Table 7. Default installation root directories for the Update Installer for WebSphere Software.

This table shows the default installation root directories for the Update Installer for WebSphere Software.

User Directory
Root

[AIX] /usr/IBM/WebSphere/UpdateInstaller

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/WebSphere/UpdateInstaller

[Windows] <p> C:\Program Files\IBM\WebSphere\UpdateInstaller

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/WebSphere/UpdateInstaller

[Windows] <p> C:\IBM\WebSphere\UpdateInstaller

WEB_ROOT

Table 8. Default installation root directories for the IBM HTTP Server.

This table shows the default installation root directories for the IBM HTTP Server.

User Directory
Root

[AIX] /usr/IBM/HTTPServer

[HP-UX]

[Linux]

[Solaris] <p> /opt/IBM/HTTPServer

[Windows] <p> C:\Program Files\IBM\HTTPServer

Non-root

[AIX]

[HP-UX]

[Linux]

[Solaris] <p> user_home/IBM/HTTPServer

[Windows] <p> C:\IBM\HTTPServer

   



Last updated Nov 11, 2010 1:01:09 PM CST