WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Preparing Linux systems for installation

This topic describes how to prepare a Linux system for installing WebSphere Application Server.

Before you begin

Why and when to perform this task

Steps for this task

  1. Download and install the Mozilla Firefox Web browser so that you can use the launchpad application on the product disc and the Gnome and KDE shortcut menu entries for WebSphere Application Server Network Deployment.

    If you do not have the Firefox browser, download and install the browser from http://www.mozilla.org/products/firefox/.

  2. Provide adequate disk space.
    Attention:
    730 MB for the /opt/IBM/WebSphere/AppServer directory before creating profiles
    30 MB for the Deployment manager profile
    200 MB for an Application Server profile with the Sample applications
    10 MB for an unfederated custom profile
    100 MB for the /tmp directory
    830 MB total requirement
    200 MB for the /usr/IBM/WebSphere/plugins directory
    25 MB for the /usr/ibm/gsk7 directory

    The run-time module is gskkm.rte.

    110 MB for the /opt/IBMIHS directory
    25 MB for the /opt/ibm/gsk7 directory

    The run-time module is gsk7bas.i386.rpm for Linux distributed platforms and gsk7bas.s390.rpm for Linux for S/390 platforms.

    Attention:
    550 MB maximum for the /opt/IBM/WebSphere/AST directory
  3. Verify that prerequisites and corequisites are at the required release levels.
  4. [Version 6.0.2]Increase the ulimit setting in the bash command shell profile to prevent addNode and importWasprofile problems.

    The addNode command script can fail when adding a node, or the importWasprofile command can fail when importing a configuration archive. The importWasprofile command might fail during the installation of a customized installation package (CIP) when the CIP includes a customized profile.

    Set a higher ulimit setting for the kernel in the bash shell profile script, which is loaded at login time for the session.

    Set the ulimit on your Linux command shells by adding the command to your shell profile script. The shell profile script is usually found under your home directory:
    1. cd ~
    2. vi .bashrc
    3. ulimit -n 8192

    See http://www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&uid=swg2 1223909http://www.ibm.com/support/docview.wss?rs=180&context=SSEQTP&uid=swg2 1223909 for more information.

  5. RHEL 4 only: Provide necessary prerequisites for Red Hat Enterprise Linux 4.

    A Linux package registration limitation prevents the prerequisites checker program from examining prerequisite packages on Linux systems. Verify that the following prerequisite packages are installed. See Installing and verifying Linux packages for more information.

    Installing packages for all hardware platforms

    Install the following packages on any hardware platform:

    compat-libstdc++-33-3.2.3-47.3
    Required for C++ run-time compatibility. Used by such components as GSKit, the Java 2 Software Development Kit (SDK), and the Web server plug-ins, for example.
    compat-db-4.1.25-9
    Required by IBM HTTP Server. Some of the modules use the libraries contained within this package.
    xorg-x11-deprecated-libs-6.8.1 or xorg-x11-deprecated-libs-6.8.2
    Required by the Java 2 SDK to provide printing functions for graphical user interfaces. Without this package, Swing-based applications and AWT-based applications, such as InstallShield for Multiplatforms (ISMP), cannot instantiate.
    rpm-build-4.3.3-7_nonptl
    Required by ISMP to properly register products within the RPM database.

    These packages are part of the Red Hat Enterprise Linux 4 operating system, but are not installed by default. You can also install a later release of any of these packages if Red Hat provides new packages as errata.

    Selecting packages for hardware platforms that are capable of running both 32-bit and 64-bit applications

    Hardware platforms capable of running both 32-bit and 64-bit applications include Opteron, EM64T, iSeries, pSeries (PowerPC), and zSeries (S/390 64-bit) machines.

    By default, RHEL 4 only installs 64-bit run-time support on these platforms. However, various applications included with WebSphere Application Server V6.x products and packages also require the 32-bit run-time support. Therefore, you must also install the 32-bit run-time support.

    Install the following required 32-bit packages by selecting to customize the packages during the RHEL 4 installation. Or, customize packages on an existing RHEL 4 system by issuing the system-config-packages command from a graphical terminal.

    Install the Compatibility Architecture Support under the System category. Optionally install the Compatibility Architecture Development Support under the Development category if you intend to build C or C++ libraries for use with both 32-bit and 64-bit applications.

    Platforms that support both 32-bit and 64-bit applications require both the 32-bit and 64-bit versions of the following packages:
    • compat-libstdc++-33-3.2.3-47.3
    • compat-db-4.1.25-9
    • xorg-x11-deprecated-libs-6.8.1 or xorg-x11-deprecated-libs-6.8.2

    Run the rpm -qa | grep package_name command to verify that you have both versions of each package. Substitute the name of each package for the package_name variable.

    Installed packages are displayed in the reply to the command. If you do not get two replies for each package, you have only one version of the package installed. You must then install the missing package.

    Installing additional packages for specific platforms

    In addition to the packages that are common to all platforms, install the following packages on hardware platforms capable of running both 32-bit and 64-bit applications, before installing WebSphere Application Server products and packages.

    x86 platforms and Opteron or EM64T platforms: compat-libstdc++-296-2.96-132.7.2
    The compat-libstdc++-296-2.96-132.7.2 package is required for C++ run-time compatibility. The package is used by such components as GSKit, the Java 2 SDK, and the Web server plug-ins, for example.
    z/Series (S/390) platforms: compat-libstdc++-295-2.95.3-81
    The compat-libstdc++-295-2.95.3-81 package is required for C++ run-time compatibility. The package is used by such components as GsKit, the Java 2 SDK, and the Web server plug-ins, for example.

    Install both the 32-bit version and the 64-bit version of the package on 64-bit z/Series hardware platforms.

    Problems encountered when you do not install required packages

    If you do not install all of the required packages, the Installation wizard cannot start. Error messages indicate missing libraries, the inability to load graphical interfaces, or other errors that occur during the installation.

    After installing the V6.0 WebSphere Application Server product or package, install the latest refresh pack. The RHEL 4 operating system is supported beginning with V6.0.1 (Refresh Pack 1).

    See Preparing RHEL 4 for the installation of WebSphere Application Server V6.0.1 and V6.0.2 products for more information.

  6. RHEL 3 only: Provide necessary prerequisites for Red Hat Enterprise Linux 3.

    A Linux package registration limitation prevents the prerequisites checker program from examining prerequisite packages on Linux systems. Verify that the following prerequisite packages are installed.

    xSeries platforms: Install the following packages on Red Hat Enterprise Linux 3 for xSeries platforms:
    • compat-libstdc++-7.3-2.96.122

      Required for C++ run-time compatibility. Used by such components as GSKit, the Java 2 Software Development Kit (SDK), and Web server plug-ins for WebSphere Application Server.

    • compat-db-4.0.14-5

      Required by some IBM HTTP Server modules. The modules use the libraries contained within this RPM package.

    • rpm-build-4.2.1-4.2

      InstallShield for Multiplatforms (ISMP) requires the package to properly register products with the Red Hat Package Manager (RPM) database.

    The following additional RPM packages are recommended for developing and building Java Native Interface (JNI) libraries for use by your Java 2 Enterprise Edition (J2EE™) applications. If you do not intend to compile JNI libraries on the system, you do not have to install the following packages:

    • compat-gcc-7.3-2.96.122
    • compat-libstdc++-devel-7.3-2.96.122
    • compat-glibc-7.x-2.2.4.32.5
    • compat-gcc-c++-7.3-2.96.122

    iSeries platforms and pSeries platforms: Install the rpm-build-4.2.1-4.2 package. InstallShield for Multiplatforms (ISMP) requires the package to properly register products with the Red Hat Package Manager (RPM) database.

    S/390 (z/VM and VM/ESA) platforms: You must install the following packages on Red Hat Enterprise Linux 3 for S/390 (z/VM and VM/ESA) platforms:
    • compat-db-4.0.14-5

      Required by some IBM HTTP Server modules. The modules use the libraries contained within this RPM package.

    • compat-pwdb-0.62-3
    • compat-libstdc++-7.2-2.95.3.77

      Required for C++ run-time compatibility. Used by such components as GSKit, the Java 2 Software Development Kit (SDK), and Web server plug-ins for WebSphere Application Server.

    • rpm-build-4.2.1-4.2

      Required by InstallShield for Multiplatforms (ISMP) to properly register products with the Red Hat Package Manager (RPM) database.

    You can install a later release of any of these packages.

  7. RHEL 3 only: Upgrade Red Hat Enterprise Linux 3 to service level 2 (update 2) or service level 3 (update 3).

    Upgrade the RHEL 3 service level by downloading and installing the service updates from Red Hat.

    If you do not upgrade the service level, certain national language issues in the released version of GLIBC included in Red Hat Enterprise Linux V3 might cause Java Virtual Machine (JVM) failures due to segmentation faults. These failures can occur during installation when the locale is set to anything other than an English locale.

  8. SLES 9 only: Apply SLES 9 SP1 on PowerPC 64-bit platforms to avoid a known problem.

    SLES 9 SP1 is the officially supported platform for PowerPC 64-bit machines.

    A known problem in the SLES 9 GA kernel (LTC 9288) is documented in the SDK guide for the 142SR1a release. The problem results in a 64-bit WebSphere Application Server hang indicated by the following error messages:
    00000014 RecoveryManag A WTRN0028I: Transaction service recovering 0 transactions. 
    0000000a ResourceMgrIm I WSVR0049I: Binding DefaultTimerManager as tm/default 
    0000000a WorkAreaServi A ACWA0002I: WorkArea service not enabled on dmgr. 
    0000000a AppProfileCom I ACIN0007I: The application profiling service started successfully. 
    0000000a CacheServiceI I DYNA0048I: WebSphere Dynamic Cache initialized successfully. 
    00000015 LogAdapter E DCSV9416E: An internal error occurred. 
             Exception is Clock not changed in 10002 rounds. 
    00000015 LogAdapter E DCSV9416E: An internal error occurred. 
             Exception is Clock not changed in 10002 rounds.
  9. SLES 8 only: Prepare the SuSE Linux Enterprise Server 8.0 - Powered by UnitedLinux 1.0 operating platform for WebSphere Application Server installation.
    1. Install SP3 for the United Linux 1.0 operating platform to let you use the Launchpad.

      It is your responsibility to install this service pack. The prereqChecker function of the installer cannot detect service pack versions definitively on United Linux. Kernel unames and versions between 8.0 and 8.0.3 are identical. No signature RPM denotes a service pack install.

    2. Use the IBM Software Developer Kit (SDK) that WebSphere Application Server provides to support the Java 2 SDK on the SuSE Linux Enterprise System 8.0 (SLES 8) operating system to avoid potential problems when uninstalling an interim fix or a fix pack. To use the IBM Developer Kit, remove the java2-jre-1.3.1-524 and java2-1.3.1-524 RPMs from the machine before installing WebSphere Application Server.

    SLES 9 does not require an additional service pack.

  10. SLES 8 only: Correct font problems on SuSE Linux Enterprise Server 8.0 in Simplified Chinese and Traditional Chinese locales.

    On the Linux for Power platform that SuSE Linux Enterprise Server 8.0 provides, a missing package causes a font problem. The ttf-hanyi package is not installed during the normal product installation of the SuSE 8.0 operating system. The missing package causes the Installation wizard for WebSphere Application Server products to display garbled characters in the Simplified Chinese locale and in the Traditional Chinese locale.

    Copy the ttf-hanyi-2021016-0.noarch.rpm package on the SuSE 8.0 for i386 CD to the Power PC system. Install the package on the Power PC machine and reboot the machine to solve the problem.

Result

What to do next

See Preparing to install Network Deployment on a Linux system for the next step in the overall procedure, which is selecting the type of installation to perform.




Sub-topics
Installing and verifying Linux packages

Related tasks
Preparing to install Network Deployment on a Linux system
Preparing the operating system for product installation

Task topic    

Terms of Use | Feedback

Last updated: Dec 11, 2005 4:07:15 PM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tins_linuxsetup.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)