Skip navigation.

8.1 Supported Configurations: Novell SUSE LINUX Enterprise Server 9 on IBM zSeries

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Novell SUSE LINUX Enterprise Server 9 on IBM zSeries with WebLogic Server 8.1 SP4

Provides full support for WebLogic Server. WebLogic Workshop, WebLogic Integration, and WebLogic Portal are not supported. See below for Design and Development Tools support.


This section provides the following information:

Related Information


Configuration Requirements

Table 1-1 Requirements for WebLogic Server 8.1 SP4 on Novell SUSE LINUX Enterprise Server 9 on IBM zSeries 

Operating System Version and Patches

Novell SUSE LINUX Enterprise Server (SLES) 9 for IBM zSeries with Kernel 2.6.5-7.97-s390x #1 SMP and later SUSE service packs and errata

Chip Architecture and Minimum Processor Speed

IBM zSeries


IBM SDK 1.4.2_Sr1a

This SDK must be downloaded from the IBM Web site. For instructions, see Downloading and Installing the IBM Developer Kit for 31-bit zSeries (S/390).

Design and Development Tools

Supports WebLogic Server development tools.


512 MB required; 1 GB recommended

Performance Pack



Node Manager



BEA jDrivers for Oracle




Known Issues

This section provides workarounds for the following limitations:

SDK Tool Exception with UTF-8 Encoding

When UTF-8 encoding is used, some SDK tools throw a

To avoid this exception, remove the UTF-8 suffix from all locale-specific environment variables. For example, if the default locale setting for your system is en_US.UTF-8, then complete the following steps:

  1. In a text editor, open the following script:
  2. $WL_HOME/common/bin/
  3. At the beginning of the script, set the LANG variable as follows:
  4. export LANG="en_US.ISO8859_1"

For more information, see:


JAVA_HOME is the directory in which the SDK is installed on your machine.

WebLogic Server Stops Responding

If WebLogic Server stops responding after working properly for some time, there may be a problem with running IBM SDK 1.4.2_Sr1a on SUSE LINUX Enterprise Server 9. This disruption may be caused by an SDK problem related to the return() function from the finally block.

To avoid this situation, complete the following procedure:

  1. In a text editor, open the $WL_HOME/common/bin/ script.
  2. At the beginning of the script, check whether the JITC_COMPILEOPT environment variable is set as follows:
  3. JITC_COMPILEOPT=NQCOPYPROPA{weblogic/socket/MuxableSocketDiscriminator}{isMessageComplete}
  4. If it is not already set as shown here, set JITC_COMPILOPT now:
  5. export JITC_COMPILEOPT=NQCOPYPROPA{weblogic/socket/MuxableSocketDiscriminator}{isMessageComplete}
  6. Restart WebLogic Server.

Limitations on Use of setuid

The setuid function does not work with the IBM SDK, due to the way the current Linux thread model works. When you use ports lower than 1024, you cannot use the setuid function to switch from the root ID to a non-privileged user ID.

IIOP Thin Client Is Not Supported

The IIOP thin client is not supported due to dependencies on the SDK. Only thin-client applications are affected by this issue.

To work around this limitation, run:

Note: wlkeytool is not supported for Novell SUSE LINUX Enterprise Server 9 on IBM zSeries.

For more information about known issues with any components of this release, see the appropriate Release Notes document. For a complete list of Release Notes supporting WebLogic Platform 8.1, see:


Download and Installation Instructions

This section provides instructions for the following procedures:

Downloading and Installing the IBM Developer Kit for 31-bit zSeries (S/390)

Before you can install and run WebLogic Server 8.1 SP4 on your Novell SUSE LINUX Enterprise Server 9 configuration, you must obtain an IBM Developer Kit for 31-bit zSeries (S/390) from IBM. To download this kit, complete the following procedure:

  1. Go to the following IBM download site:
  3. Select "IBM SDK for 31-bit zSeries (S/390), Version 142 SR1a."
  4. Register and accept the license agreement.
  5. The IBM Developer Kit for Linux, Java 2 Technology Edition for 31-bit zSeries (S/390) download page is displayed.

  6. Follow the instructions displayed to download and install the SDK.
  7. Set the JAVA_HOME environment variable to the directory in which IBM SDK 1.4.2 SR1a is installed, and export JAVA_HOME. For example:
  8. export JAVA_HOME=/opt/IBMJava2-s390-142Sr1a
  9. Make sure that your PATH variable includes $JAVA_HOME/bin. For example:
  10. export PATH=$JAVA_HOME/bin;$PATH:.

Downloading the WebLogic Server 8.1 SP4 Installer

  1. Go to the BEA downloads site:
  3. Find your WebLogic Server release and Service Pack on the downloads page.
  4. Select "SUSE LINUX 9.0 ES for IBM zSeries."
  5. Download the WebLogic Server installer: pj_server814_generic.jar.
  6. Download the supplemental JAR file: wls81sp4_zlinux_supp.jar.

Installing WebLogic Server 8.1 SP4

  1. Set the WL_HOME environment variable to the pathname for the weblogic81 directory in your WebLogic Server installation directory. For example:
  2. export WL_HOME=/home/bea/weblogic81
  3. Install WebLogic Server 8.1 SP4 by running the following command:
  4. $ java -jar pj_server814_generic.jar -mode=console

    Note: The argument is optional. BEA recommends that you include this argument when the amount of space available in /tmp is insufficient.

    For a detailed procedure for installing WebLogic Server with .jar files in console-mode, see Installing WebLogic Platform:

    Copy the wls81sp4_zlinux_supp.jar file to $WL_HOME/server/lib.

  5. Go to the $WL_HOME/server/lib directory:
  6. $ cd $WL_HOME/server/lib
  7. Remove old native objects from the $WL_HOME/server/lib/linux/s390 library:
  8. $ rm linux/s390/*
  9. Extract the contents of the wls81sp4_zlinux_supp.jar file to $WL_HOME/server/lib:
  10. $ jar -xvf wls81sp4_zlinux_supp.jar

    Change the permissions on the files:

    $ chmod -R 755 $WL_HOME/server/lib/linux/s390/*
  11. In a text editor, open the $WL_HOME/common/bin/ script and make the following changes:


Back to Top Previous Next