WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Default installation directories for the product, profiles, and tools

References in product information to install_root, user_data_root, profile_root, updi_root, and cip_proc_server_root, represent specific default directory locations for the product installation, profile configuration files, and tools. This topic describes the conventions in use for WebSphere® ESB. The meaning of these variables can differ based on whether you are installing the product on a clean server or on one with an existing installation of WebSphere Application Server, WebSphere Application Server Network Deployment, or WebSphere Enterprise Service Bus. They can also differ depending on whether you are performing the installation as a root (Administrator on a Windows® system) or non-root user.

Limitations of non-root installers

For Linux operating systemFor UNIX operating systemFor Windows operating system Root, Administrator, and non-root users can install the product. The default directories the installation wizard provides will differ based on whether the user has root (Administrator) privileges.

For Linux operating systemFor UNIX operating systemFor Windows operating system Root and Administrator users can register shared products and install into system-owned directories (globally shared resources that are available to all users), while non-root users cannot. Non-root users can install only into directories they own.

Variables used in the documentation

Several variables representing specific default directories are used throughout the documentation. These file paths are default locations. You can install the product and other components and create profiles in any directory for which you have write access. Multiple installations of WebSphere ESB products or components, of course, require multiple locations.

Here are the main variables used in the documentation:

For i5/OS operating system Note: On i5/OS® platforms: To perform an installation on an i5/OS system, you must have a user profile with *SECADM and *ALLOBJ special authorities.
For Linux operating systemFor UNIX operating systemFor Windows operating system On Linux®, UNIX®, and Windows platforms: install_root
Installation location of WebSphere ESB. WebSphere ESB is always installed in the same location as the WebSphere Application Server Network Deployment installation with which it is associated.
For i5/OS operating system On i5/OS platforms: user_data_root
The default user data directory for WebSphere ESB. The user_data_root is different from install_root, and they cannot be the same location. The profiles and profileRegistry subdirectories are created under this directory when you install the product.
profile_root
Location of a WebSphere ESB profile.
updi_root
Installation location of the Update Installer for WebSphere Software.
cip_proc_server_root
Installation location of a customized installation package (CIP) produced by the Installation Factory. A CIP is a WebSphere ESB product bundled with one or more maintenance packages and other optional files and scripts.

Default directories on a clean server

The following tables show the default installation locations of WebSphere ESB, WebSphere ESB profiles, the Update Installer for WebSphere Software, and a customized installation package (CIP) produced by the Installation Factory, when there is not an existing installation of any other WebSphere product.

Table 1 shows the default installation root directory into which the installation wizard installs both WebSphere ESB and WebSphere Application Server Network Deployment for both root (Administrator) and non-root users:
Table 1. install_root default directory
Default install_root for root or Administrator users Default install_root for non-root users

For AIX operating system On AIX® platforms: /usr/IBM/WebSphere/ESB

For AIX operating system On AIX platforms: user_home/IBM/WebSphere/ESB

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: /opt/IBM/WebSphere/ESB

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: user_home/IBM/WebSphere/ESB

For Linux operating system On Linux platforms: /opt/ibm/WebSphere/ESB

For Linux operating system On Linux platforms: user_home/ibm/WebSphere/ESB

For Windows operating system On Windows platforms: C:\Program Files\IBM\WebSphere\ESB

For Windows operating system On Windows platforms: C:\IBM\WebSphere\ESB

Table 2 shows the default installation directory for a profile named profile_name for both root (Administrator) and non-root users:
Table 2. profile_root default directory
Default profile_root for root or Administrator users Default profile_root for non-root users

For AIX operating system On AIX platforms: /usr/IBM/WebSphere/ESB/profiles/profile_name

For AIX operating system On AIX platforms: user_home/IBM/WebSphere/ESB/profiles/profile_name

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: /opt/IBM/WebSphere/ESB/profiles/profile_name

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: user_home/IBM/WebSphere/ESB/profiles/profile_name

For Linux operating system On Linux platforms: /opt/ibm/WebSphere/ESB/profiles/profile_name

For Linux operating system On Linux platforms: user_home/ibm/WebSphere/ESB/profiles/profile_name

For Windows operating system On Windows platforms: C:\Program Files\IBM\WebSphere\ESB\profiles\profile_name

For Windows operating system On Windows platforms: C:\IBM\WebSphere\ESB\profiles\profile_name

Table 3 shows the default installation directory for the Update Installer for WebSphere Software for both root (Administrator) and non-root users:
Table 3. updi_root default directory
Default updi_root for root or Administrator users Default updi_root for non-root users

For AIX operating system On AIX platforms: /usr/IBM/WebSphere/UpdateInstaller

For AIX operating system On AIX platforms: user_home/IBM/WebSphere/UpdateInstaller

For HP-UX operating systemFor Linux operating systemFor Solaris operating system On HP-UX, Linux, and Solaris platforms: /opt/IBM/WebSphere/UpdateInstaller

For HP-UX operating systemFor Linux operating systemFor Solaris operating system On HP-UX, Linux, and Solaris platforms: user_home/IBM/WebSphere/UpdateInstaller

For Windows operating system On Windows platforms: C:\Program Files\IBM\WebSphere\UpdateInstaller

For Windows operating system On Windows platforms: C:\IBM\WebSphere\UpdateInstaller

For Linux operating systemFor UNIX operating systemFor Windows operating system On Linux, UNIX, and Windows platforms: Table 4 shows the default installation directory for both root (Administrator) and non-root users for a customized installation package (CIP) produced by the Installation Factory. The cip_uid variable is the CIP unique ID generated during creation of the build definition file. You can override the generated value in the Build definition wizard. Use a unique value to allow multiple CIPs to install on the system.
Table 4. cip_proc_server_root default directory
Default cip_proc_server_root for root or Administrator users Default cip_proc_server_root for non-root users

For AIX operating system On AIX platforms: /usr/IBM/WebSphere/ESB/cip/cip_uid

For AIX operating system On AIX platforms: user_home/IBM/WebSphere/ESB/cip/cip_uid

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: /opt/IBM/WebSphere/ESB/cip/cip_uid

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: user_home/IBM/WebSphere/ESB/cip/cip_uid

For Linux operating system On Linux platforms: /opt/ibm/WebSphere/ESB/cip/cip_uid

For Linux operating system On Linux platforms: user_home/ibm/WebSphere/ESB/cip/cip_uid

For Windows operating system On Windows platforms: C:\Program Files\IBM\WebSphere\ESB\cip\cip_uid

For Windows operating system On Windows platforms: C:\IBM\WebSphere\ESB\cip\cip_uid

Table 5 shows the default directories for the i5/OS platform.

Table 5. i5/OS default directories on a clean server
Default directory variable Default directory

install_root

For i5/OS operating system On i5/OS platforms: /QIBM/ProdData/WebSphere/ESB

updi_root

For i5/OS operating system On i5/OS platforms: /QIBM/ProdData/WebSphere/UpdateInstaller

user_data_root

For i5/OS operating system On i5/OS platforms: /QIBM/UserData/WebSphere/ESB/

profile_root

For i5/OS operating system On i5/OS platforms: /QIBM/UserData/WebSphere/ESB/profiles/profile_name

Default directories when an installation of WebSphere Application Server or WebSphere Application Server Network Deployment exists

When an installation of a supported version of WebSphere Application Server or WebSphere Application Server Network Deployment exists on a server and you elect to install WebSphere ESB on top of it, WebSphere ESB is installed into the same location. Table 6 shows the default installation root directory in such a case for both root (Administrator) and non-root users:
Table 6. install_root default directory when an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment exists
Default install_root for root or Administrator users Default install_root for non-root users

For AIX operating system On AIX platforms: /usr/IBM/WebSphere/AppServer

For AIX operating system On AIX platforms: user_home/IBM/WebSphere/AppServer

For HP-UX operating systemFor Linux operating systemFor Solaris operating system On HP-UX, Linux, and Solaris platforms: /opt/IBM/WebSphere/AppServer

For HP-UX operating systemFor Linux operating systemFor Solaris operating system On HP-UX, Linux, and Solaris platforms: user_home/IBM/WebSphere/AppServer

For Windows operating system On Windows platforms: C:\Program Files\IBM\WebSphere\AppServer

For Windows operating system On Windows platforms: C:\IBM\WebSphere\AppServer

Default directories for profile_root, updi_root, and cip_proc_server_root are handled similarly.

Table 7 shows the default directories for the i5/OS platform.

Table 7. i5/OS default directories when an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment exists
Default directory variable Default directory

install_root

For i5/OS operating system On i5/OS platforms: /QIBM/ProdData/WebSphere/ESB/V61/ND

user_data_root

For i5/OS operating system On i5/OS platforms: /QIBM/UserData/WebSphere/ESB/V61/ND

profile_root

For i5/OS operating system On i5/OS platforms: /QIBM/UserData/WebSphere/ESB/V61/NDprofile_name01

Default directories when a WebSphere ESB installation exists

When an installation of WebSphere ESB exists on a server, if you run the installation wizard to initiate a second installation of the product, the installation wizard detects the existing installation and appends a number to the second default directory. For instance, if WebSphere ESB exists in the default directory /opt/IBM/WebSphere/ESB and you then run the installation wizard a second time, the wizard will offer the default installation location of /opt/IBM/WebSphere/ESB1 for the second product installation on the Installation location panel. Table 8 shows the default installation root directory in such a case for both root (Administrator) and non-root users:
Table 8. install_root default directory when an existing installation of WebSphere ESB exists
Default install_root for root or Administrator users Default install_root for non-root users

For AIX operating system On AIX platforms: /usr/IBM/WebSphere/ESB1

For AIX operating system On AIX platforms: user_home/IBM/WebSphere/ESB1

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: /opt/IBM/WebSphere/ESB1

For HP-UX operating systemFor Solaris operating system On HP-UX and Solaris platforms: user_home/IBM/WebSphere/ESB1

For Linux operating system On Linux platforms: /opt/ibm/WebSphere/ESB1

For Linux operating system On Linux platforms: user_home/ibm/WebSphere/ESB1

For Windows operating system On Windows platforms: C:\Program Files\IBM\WebSphere\ESB1

For Windows operating system On Windows platforms: C:\IBM\WebSphere\ESB1

Important: This scenario assumes that a second installation of WebSphere Application Server Network Deployment without WebSphere ESB already installed over it does not exist on the server. If one does, you can install WebSphere ESB into that same directory (/opt/IBM/WebSphere/AppServer for instance) or you can install a new installation of both WebSphere ESB and WebSphere Application Server Network Deployment into the directories as listed previously.

Table 9 shows the default directories for the i5/OS platform.

Table 9. i5/OS default directories when a WebSphere ESB installation exists
Default directory variable Default directory

install_root

For i5/OS operating system On i5/OS platforms: /QIBM/ProdData/WebSphere/ESB1

user_data_root

For i5/OS operating system On i5/OS platforms: /QIBM/UserData/WebSphere/ESB1

profile_root

For i5/OS operating system On i5/OS platforms: /QIBM/UserData/WebSphere/ProcServer1/profiles/profile_name01


reference Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rins_installation_paths.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).