This topic describes how to install WebSphere Application Server products as the root user on a Linux platform or on a UNIX-based platform, or from a user ID that belongs to the administrator group on a Windows platform.
Before you begin
You cannot install the product correctly as a non-root user on a Linux or UNIX-based operating system platform, or from a user ID on a Windows platform that is not part of the administrators group. If you back up the product CD-ROM on a Linux or UNIX platform, do so as root. Backup copies made from non-root users do not preserve the correct file attributes and do not work.
In addition, Linux and UNIX installers must verify that the umask setting is 022. To verify the umask setting, issue the following command:
umask
To set the umask setting to 022, issue the following command:
umask 022
Linux platforms and Solaris operating environments
On Linux platforms or Solaris operating environments, make sure that the /etc directory contains a shadow password file. The shadow password file is named shadow and is in the /etc directory. If the shadow password file does not exist, an error occurs after enabling global security and configuring the user registry as local operating system.
To create the shadow file, run the pwconv command (with no parameters). This command creates an /etc/shadow file from the /etc/passwd file. After creating the shadow file, you can configure local operating system security.
Some steps of the installation procedure on a Windows platform require the user to belong to the administrator group and have the following advanced user rights, Act as part of the operating system and Log on as a service.
IBM Support offers tutorials on various WebSphere Application Server installation topics. See WebSphere education on demand: Installation best practices tutorials for more information. One topic describes installing new or coexisting versions.
Integration Server Version | WebSphere Application Server (base) | Network Deployment | ||||
V5.0.x | V5.1.0.x | V5.1.1.x | V5.0.x | V5.1.0.x | V5.1.1.x | |
V5.1.0.x | No | Yes | No | No | Yes | No |
V5.1.1 | No | No | Yes | No | No | Yes |
Read through this topic and its related topics to prepare for installation and to make yourself familiar with installation options, before you start to use the installation tools.
Review the prerequisite requirements on the System requirements for IBM WebSphere Business Integration Server Foundation Web site to get started.
After verifying prerequisites, read these topics before installing the product:
If you encounter a problem such as not having enough disk space or temporary space or not having prerequisite packages on your Linux or UNIX-based system, cancel the installation, make the required changes, and restart the installation to pick up the changes that you made.
The installation uses InstallShield for Multiplatforms (ISMP) to perform the installation. You can use the Installation wizard or perform the installation from a command line, using the silent installation method.
The Installation wizard does not support hot keys, such as Alt-Y. You can tab to the Yes key and press Enter to select it, for example.
Although you can create multiple servers on a base WebSphere Application Server node, the servers all share one set of configuration files. Changes that you make to one server affect the others. There is a possibility that configuration documents might become corrupted. Use configuration instances to create multiple servers, each with its own set of configuration files. Or install the Network Deployment product to create and manage multiple base Application Servers.
Install the
base product before installing the Network Deployment product when installing
both products on the same machine. The embedded messaging feature that is
included in the default installation requires this specific order of installation.
This topic describes installing the
Enterprise product, using the installation image on the product CD-ROM labeled, Enterprise
Application Server. The Enterprise product package also contains CD-ROMs
for installing the WebSphere Application Server Network Deployment product
and the base WebSphere Application Server product.
The Enterprise product requires the base WebSphere Application Server product. If the base product is not present, the Enterprise Installation wizard installs a version of the base product in an umbrella installation, with the base features that the Enterprise product requires. If the base product is present, the Enterprise Installation wizard updates the base installation, if necessary, to install any base features that are required.
You can use the CD-ROM labeled Enterprise Application Server to install the base product. You can perform an umbrella installation, which installs both the Enterprise product and the base product during the same installation procedure. The umbrella installation of the Enterprise product installs the base WebSphere Application Server product without these features:
To install a Web server plug-in or another base product feature that is not available during the umbrella installation, you can find the full-featured base product installation image on the Enterprise Application Server CD-ROM as well, in a separate directory, the WAS directory.
You can install the IBM HTTP Server separately with its InstallIHS command script, by accessing the IHS folder on the CD-ROM labeled Enterprise Application Server. The InstallIHS command does not install the binary plug-in for the IBM HTTP Server, which you must also install to use HTTP Server.
Using InstallIHS does let you retain the Web server if you uninstall the Application Server. Installing the IBM HTTP Server product as a feature of the base IBM WebSphere Application Server product includes the Web server in the uninstaller program for the base Application Server. In this case, if you uninstall the base WebSphere Application Server, you also uninstall its features, including IBM HTTP Server.
This topic is available in Adobe PDF format, on the product CD-ROMs, and online in an information center that is available from the IBM WebSphere Application Server Web site at http://publib.boulder.ibm.com/infocenter/ws51help/index.jsp . When possible, access the most current version of this information by selecting the information center. The information center displays in the language of your machine locale.
Why and when to perform this task
The Launchpad tool lets you access the product overview, the readme.html file, and installation guides. You also use the Launchpad during the installation procedure to install the product. See Using the Launchpad to start the installation for more information.The Installation wizard performs the following actions:
If the node is part of a cell, unfederate the node with the removeNode command. Uninstall any interim fixes, Fix Pack 2, and Fix Pack 1 before installing new features. After installing the features, reinstall Fix Pack 2 and any interim fixes to bring the node back to its previous fix level.
If you plan to install
the Enterprise product on a node that you federate into a cell, you must also
install the product on the Network Deployment node, to provide Enterprise
administrative extensions that extend the administrative console and the scripting
facility. When installing on an existing Network Deployment node, the Installation
wizard automatically installs the administrative console extensions feature.
It does not install the base product, or the Enterprise programming model
extensions that extend the base product.
If you have both the base WebSphere Application Server product
and the Network Deployment product on the same machine, the Installation wizard
for the Enterprise product installation displays a panel for you to select
whether you want to install the administrative console extensions feature
on the Network Deployment product, or the programming model extensions on
the base product.
Steps for this task
Look for severe errors that the installer records in the /logs/WAS.PMI.install.log file in the installation root directory to verify that no file system or other unusual errors occurred during installation.
If the /logs/log.txt file and the /logs/WAS.PMI.install.log file do not contain a record of any problems but problems exist, verify or troubleshoot the installation as described in Troubleshooting the installation and Installation component troubleshooting tips.
Results
The Installation wizard configures the product. It is not necessary to perform further configuration at this time.