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
- 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
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)
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
/usr/IBM/WebSphere/AppClient (Java EE Application client only)
/opt/IBM/WebSphere/AppClient (Java EE Application client only)
C:\Program Files\IBM\WebSphere\AppClient
Non-root
user_home/IBM/WebSphere/AppClient (Java EE Application client only)
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
/usr/IBM/WebSphere/AppServer
/opt/IBM/WebSphere/AppServer
C:\Program Files\IBM\WebSphere\AppServer
Non-root
user_home/IBM/WebSphere/AppServer
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
/usr/IBM/WebSphere/AppServer
/opt/IBM/WebSphere/AppServer
C:\Program Files\IBM\WebSphere\AppServer
Non-root
user_home/IBM/WebSphere/AppServer
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.
product_root/gsk7
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
/usr/IBM/WebSphere/AppServer/profiles/profile_name
/opt/IBM/WebSphere/AppServer/profiles/profile_name
C:\Program Files\IBM\WebSphere\AppServer\profiles\profile_name
Non-root
user_home/IBM/WebSphere/AppServer/profiles/
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
/usr/IBM/WebSphere/Plugins
/opt/IBM/WebSphere/Plugins
C:\Program Files\IBM\WebSphere\Plugins
Non-root
user_home/IBM/WebSphere/Plugins
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
/usr/IBM/WebSphere/UpdateInstaller
/opt/IBM/WebSphere/UpdateInstaller
C:\Program Files\IBM\WebSphere\UpdateInstaller
Non-root
user_home/IBM/WebSphere/UpdateInstaller
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
/usr/IBM/HTTPServer
/opt/IBM/HTTPServer
C:\Program Files\IBM\HTTPServer
Non-root
user_home/IBM/HTTPServer
C:\IBM\HTTPServer
Last updated Nov 11, 2010 1:01:09 PM CST