Red Hat APPLICATION STACK 1.1 RELEASE Instruction Manual

Red Hat Application Stack V.1.1 Release
Notes
1.1
ISBN: N/A
Publication date:

Red Hat Application Stack V.1...

Red Hat Application Stack V.1.1 Release Notes
Copyright ©2006-2007 Red Hat, Inc.

Red Hat Application Stack V.1...

1. Introduction ........................................................................................................... 1
1. Overview of This Release ............................................................................... 1
2. Installation Prerequisites ................................................................................. 1
3. Package-specific Notes .................................................................................. 1
2. Configuring the Java Environment ........................................................................... 3
1. Install a supported SDK .................................................................................. 3
1.1. Installing a 32-bit Sun SDK .................................................................. 3
1.2. Installing a BEA or IBM SDK ................................................................ 5
2. Install the jbossas package ............................................................................ 6
2.1. Using up2date / RHN (Preferred Method) ............................................. 6
2.2. Using up2date / DVD .......................................................................... 7
3. Installing Red Hat Application Stack ........................................................................ 9
4. Using JBoss AS ....................................................................................................13
1. Using the Linux service (production) ..........................................................13
2. Using run.sh (development) ........................................................................15
3. Creating copies of JBOSS_HOME ....................................................................16
4. Using the jbossas-* commands from any directory ...................................16
5. Running multiple instances of JBoss AS ....................................................17
5.1. Running multiple instances of JBoss AS using different sets of ports .....18
5.2. Running multiple instances of JBoss AS binding to different local IP
addresses ................................................................................................19
6. More Information ...........................................................................................20
5. Known Issues .......................................................................................................21
6. Export Control .......................................................................................................23
v

vi

Introduction
1. Overview of This Release
Red Hat Application Stack is a set of software components that have been tested and certified
to work together in an integrated fashion. Red Hat Application Stack is designed for dynamic
web applications for both the LAMP and Java platforms.
2. Installation Prerequisites
• Red Hat Application Stack V.1.1 has been tested and certified on Red Hat Enterprise Linux 4
U4 systems. It is not certified for use with earlier versions of Red Hat Enterprise Linux. Please
follow the separate instructions for installing Red Hat Enterprise Linux 4 before installing Red
Hat Application Stack V.1.1.
• Red Hat Application Stack V.1.1 is available for 32- and 64-bit Intel architectures only (i386
and x86_64).
• Red Hat Application Stack V.1.1 includes JBoss AS 4.0.5, for running web applications in a
standard middleware environment. Note that JBoss AS uses an embedded Tomcat and does
not require a stand-alone Tomcat. Before installing and running JBoss AS you will require a
working installation of Java 1.4 or 1.5. Currently Red Hat Application Stack is certified with the
Sun JVM version 1.4.2 update 13 or later, 1.5.0 update 11 or later, and the latest BEA JVM
available through RHN. Please refer to Chapter 2, Configuring the Java Environment for
instructions on configuring the Java environment for JBoss AS.
• Red Hat Application Stack V.1.1 also includes JBoss EJB3 1.0.0-RC9, available as a
technology preview. You will need a working Java 1.5 installation in order to use this package.
3. Package-specific Notes
In most cases, Red Hat Application Stack contains more recent versions of packages than
those that are included in Red Hat Enterprise Linux. Installing Red Hat Application Stack may
update/overwrite these packages. Please ensure you review the complete package list before
beginning the installation process.
Chapter 1.
1

2

Configuring the Java Environment
JBoss AS relies on an installed JVM, such as those by Sun, or BEA. The BEA JVM is available
from the Red Hat Enterprise Linux (AS/ES) Extras channel. The Sun SDK must be downloaded
directly from Sun (instructions below).
THIS RELEASE HAS BEEN CERTIFIED WITH THE SUN
AND BEA JVMS.
Currently Red Hat Application Stack is certified with the Sun JVM version 1.4.2
update 13 or later, 1.5.0 update 11 or later and the latest BEA JVM available
through RHN. This may change in future releases.
1. Install a supported SDK
1.1. Installing a 32-bit Sun SDK
1. Get the Sun JDK 5.0 from:
http://java.sun.com/javase/downloads/index_jdk5.jsp
by choosing the "JDK 5.0 Update N" "Download" button, and then choosing "RPM in
self-extracting file" for Linux on the page that displays after pressing the button.
Note
If you don't need/want to use the SysV service scripts you can also install the
"Linux self-extracting file" instead.
Important
Do NOT install the "Linux x64" version of the SDK.
If you prefer the older Java 1.4.2 SDK, get it from:
http://java.sun.com/j2se/1.4.2/download.html [ http://java.sun.com/j2se/1.4.2/download.html]
by choosing the "Download J2SE SDK" link and from there the "RPM in self-extracting file"
Chapter 2.
3

for Linux.
Note
If you don't want/need to use the SysV service scripts you can also install the
"self-extracting file" for Linux instead.
2. Install java-1.4.2-sun-compat or java-1.5.0-sun-compat (optional)
This step is only necessary if you want to use the SysV service scripts, which we recommend
for production servers.
If you just plan on doing cd $JBOSS_HOME and ./run.sh, which should be done just for
development, you can skip this step and the next.
Download and install the appropriate -compat RPM from JPackage at:
ftp://jpackage.hmdc.harvard.edu/JPackage/1.7/generic/RPMS.non-free/
Make sure to match the version of the -compat package to the SDK you've installed in the
first step. The -compat RPM requires that the RPM self-extracting file from Sun be used in
the previous step, not the plain (non-RPM) one.
For instance, for a Sun SDK 1.5.0_11 you should get:
ftp://jpackage.hmdc.harvard.edu/JPackage/1.7/generic/RPMS.non-free/java-1.5.0-sun-compat-1.5.0.11-1jpp.i586.rpm
and for a Sun SDK 1.4.2_13 you should use:
ftp://jpackage.hmdc.harvard.edu/JPackage/1.7/generic/RPMS.non-free/java-1.4.2-sun-compat-1.4.2.13-1jpp.i586.rpm
Note
If the -compat RPM for the latest Sun release is not yet available, contact
support or request an update in the mailing list.
For more details see http://jpackage.org/
3. Selecting alternatives for java,javac and java_sdk_VERSION (optional, where VERSION =
1.4.2 or 1.5.0 depending on what version java "java" and "javac" are being set to)
This is only needed if you performed the second step above and you want to use the SysV
service script and/or want this installed SDK to be the default java and javac in the system.
This choice can often be overridden by setting the JAVA_HOME environment variable.
Chapter 2. Configuring the Ja...
4