[Version 5.0.2 and later]Installing the product

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.


Release compatibility for WebSphere Business Integration Server Foundation
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


See Installing interim fixes, cumulative fixes, and fix packs for information about installing fix packs, such as Fix Pack 1 for V5.1.0.

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.

Installation tip

Operating platform Tip in Platform-specific tips for installing and migrating
All platforms Installing WebSphere Application Server products in order on the same machine, when installing the embedded messaging component



[5.0 only]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.

[5.0 only]

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:

[5.0 only]

[5.0 only]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.

[5.0 only]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

  1. Install WebSphere Business Integration Server Foundation on your operating platform.
    Use one of the following procedures:
  2. [5.0 only]Look in the /logs/WAS.PMI.install.log file in the installation root directory for installation status.
    If you performed an umbrella installation of the base product, also examine the /logs/log.txt file. ISMP records a success message in the /logs/WAS.PMI.install.log file: "INSTFIN: The installation is complete." The logs are the only source of status information for a silent installation.

    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.


Related tasks
Installing WebSphere Application Server products
Related reference
Platform-specific tips for installing and migrating
Tips for installing the embedded messaging feature
setup.response
setup_nd.response
Port number settings in WebSphere Application Server versions
Installation: Resources for learning



Searchable topic ID:   tins_install
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/tins_install.html

Library | Support | Terms of Use | Feedback