This topic describes how to prepare an HP-UX system for
the installation of IBM WebSphere Application Server, Version 6 products.
Before you begin
The installation uses an InstallShield MultiPlatform
(ISMP) wizard. You can use the graphical interface of the wizard.
You can also use the wizard in silent mode.
Silent
mode is a command line invocation with a parameter that identifies
an options response file. Edit the options response file before installing.
If you encounter a problem such as needing more temporary
space or missing prerequisite packages on your operating system, cancel
the installation, make the required changes, and restart the installation.
About this task
Preparing the operating
system involves such changes as allocating disk space and installing
patches to the operating system. IBM® tests WebSphere® Application Server
products on each operating system platform. Such tests verify whether
an operating system change is required for WebSphere Application Server products to
run correctly. Without the required changes, WebSphere Application Server products do
not run correctly.
Procedure
- Log on to the operating system.
Log on as root. You cannot install the product
correctly as a non-root user.
If
you create a copy of the product CD-ROM or DVD, do so as root. Copies
made from non-root users do not preserve the correct file attributes
and do not work.
Select a umask that allows the owner to read/write
to the files, and allows others to access them according to the prevailing
system policy. For root, a umask of 022 is recommended. For non-root
users a umask of 002 or 022 can be used, depending on whether the
users share the group. To verify the umask setting, issue the following
command:
umask
To set the umask setting
to 022, issue the following command:
umask 022
- Optional: Download and install
the Mozilla Web browser so that you can use the launchpad application
on the product disc.
If you do not have the Mozilla
Web browser, download and install the browser from http://www.mozilla.org.
- Optional: Export the location
of the supported browser.
Export the location of the
supported browser using a command that identifies the actual location
of the browser.
If the Mozilla package is in the
/opt/bin/mozilla directory,
for example, use the following command:
export BROWSER=/opt/bin/mozilla
- Stop all WebSphere Application
Server-related Java™ processes
on the machine where you are installing the product.
- Stop any Web server process such as the IBM HTTP Server.
- Provide adequate disk space.
Attention:
The Network Deployment product
requires the following disk space:
- 780 MB for the /opt/IBM/WebSphere/AppServer directory
before creating profiles
The installation root directory includes
the core product files. This size does not include space for profiles
or applications. Profiles require 40 MB of temp space in addition
to the sizes shown. Profiles have the following space requirements:
- 30 MB for the Deployment manager profile
This size does not include space for Sample
applications that you might install. The size also does not include
space for applications that you might deploy.
- 200 MB for an application server profile with the Sample applications
This size does not include space for applications
that you might develop and install.
- 10 MB for an unfederated custom profile
This size does not include space for applications
that you might develop and install. The requirement does include space
for the node agent. However, you must federate a custom profile to
create an operational managed node.
After
federating a custom profile, the resulting managed node contains a
functional node agent only. Use the deployment manager to create server
processes on the managed node.
- 100 MB for the /tmp directory
The temporary directory is the working directory
for the installation program.
- 880 MB total requirement
This amount is the total space requirement
when installing the product from the disc and when not installing
service. Installing profiles requires more space.
The IBM HTTP Server product requires the following
space:
On SPARC 32-bit platforms, the
following space is required for the IBM WebSphere Application Server
Clients:
- 150 MB for the app_client_root directory
The amount of space required to install the
application clients is actually less than 150 MB. The amount of space
depends on the clients that you install as features.
The
following space is required for the Update Installer:
- 200 MB for the /opt/IBM/WebSphere/UpdateInstaller directory
-
The installation wizard for each
component displays required space on the confirmation panel before
you install the product files and selected features. The installation
wizard also warns you if you do not have enough space to install the
product.
If you plan to migrate applications
and the configuration from a previous version, verify that the application
objects have enough disk space. As a rough guideline, plan for space
equal to 110 percent of the size of the application objects:
- For Version 4.0.x: The size of enterprise archive (EAR)
files
- For Version 5.0.x: The size of EAR files
- Set kernel values to support Application Server. Several
HP-UX kernel values are typically too small for the product.
To
set kernel parameters, perform the following steps:
- Log into the host machine as root.
- Determine the physical memory, which you must know to avoid setting
certain kernel parameters above the physical capacity:
- Start the HP-UX System Administration Manager (SAM) utility with
the /usr/sbin/sam command.
- Select Performance Monitors > System Properties > Memory.
- Note the value for Physical Memory and click OK.
- Exit from the SAM utility.
- Set the maxfiles and maxfiles_lim parameters to at least 4096.
The following table recommends 8000 and 8196, respectively. You must
first edit the /usr/conf/master.d/core-hpux file,
so the SAM utility can set values greater than 2048:
- Open the /usr/conf/master.d/core-hpux file
in a text editor.
- Change the line," *range maxfiles<=2048" to "*range maxfiles<=60000"
- Change the line, "*range maxfiles_lim<=2048" to "*range maxfiles_lim<=60000"
- Save and close the file. Old values might be stored in the /var/sam/boot.config file.
Force the SAM utility to create a new boot.config file:
- Move the existing version of the /var/sam/boot.config file
to another location, such as the /tmp directory.
- Start the SAM utility.
- Select Kernel Configuration > Configurable Parameters.
When the Kernel Configuration window opens, a new boot.config file
exists.
Alternatively, rebuild the
boot.config file
with the following command:
# /usr/sam/lbin/getkinfo -b
- Set new kernel parameter values:
- Start the SAM utility.
- Click Kernel Configuration > Configurable Parameters.
- For each of the parameters in the following table, perform this
procedure:
- Highlight the parameter to change.
- Click Actions > Modify Configurable Parameter.
- Type the new value in the Formula/Value field.
- Click OK.
Change typical kernel settings for running WebSphere Application
Server in the order shown in the following table:
Parameter |
Value |
STRMSGSZ |
65535 |
dbc_max_pct |
25 |
maxdsiz |
805306358 (0x30000000) |
maxdsiz |
2048000000 (when running multiple
profiles on the same system) |
maxfiles_lim |
8196 (Change this one before maxfiles.) |
maxfiles |
8000 |
maxssiz |
8388608 |
maxswapchunks |
8192 |
maxusers |
512 |
nkthread |
7219 |
max_thread_proc |
3000 |
nproc |
4116 (Change this one before maxuprc) |
maxuprc |
512 |
msgtql |
2046 |
msgmap |
2048 |
msgssz |
32 (Change this one before msgmax) |
msgseg |
32767 (Change this one before msgmax) |
msgmnb |
65535 (0x10000) (Change this one before msgmax) |
msgmnb |
131070 (when running multiple profiles on the
same system) |
msgmax |
65535 (0x10000) |
msgmax |
131070 (when running multiple profiles
on the same system) |
msgmni |
50 |
nfile |
58145 |
nflocks |
3000 |
ninode |
60000 |
npty |
2024 |
nstrpty |
1024 |
nstrtel |
60 |
sema |
1 |
semaem |
16384 (0x4000) |
semmns |
16384 (0x4000) (Change this one before semmap) |
semmni |
2048 (Change this one before semmap) |
semmap |
514 |
semmnu |
1024 |
semume |
200 |
semvmx |
32767 |
shmem |
1 |
shmmax |
2147483647 (0x7FFFFFFF) |
shmmni |
1024 |
shmseg |
1024 |
When WebSphere Application Server and IBM DB2 are on
the same machine, some kernel values are higher than those shown in
the preceding table.
See the Recommended HP-UX kernel configuration parameters
for DB2 V8 Web page for more information.
- Click Actions > Process New Kernel.
- Click Yes on the information window to
confirm your decision to restart the machine.
Follow the on-screen
instructions to restart your machine and to enable the new settings.
- If you plan to redirect displays to non-HP machines, do the following
before running the WebSphere Application Server installation wizard:
- Issue the following command to obtain information on all the public
locales that are accessible to your application:
# locale -a
- Choose a value for your system from the output that is displayed
and set the LANG environment variable to this value. Here is an example
command that sets the value of LANG to en_US.iso88591
# export LANG=en_US.iso8859
- Verify that prerequisites and corequisites are at the required
release levels.
Although the installation wizard checks
for prerequisite operating system patches with the prereqChecker application,
review the prerequisites on the Supported hardware and software Web
site if you have not done so already.
Refer to the documentation
for non-IBM prerequisite and corequisite products to learn how to
migrate to their supported versions.
- Verify the system cp command
when using emacs or other freeware.
If you have emacs
or other freeware installed on your operating system, verify that
the system
cp command is used.
- Type which cp at the command prompt before
running the installation program for the WebSphere Application Server product.
- Remove the freeware directory from your PATH
if the resulting directory output includes freeware.
For example, assume that the output is similar to the following message: .../freeware/bin/cp.
If so, remove the directory from the PATH.
- Install the WebSphere Application
Server product.
- Add the freeware directory back to the PATH.
If you install with a cp command that
is part of a freeware package, the installation might appear to complete
successfully, but the Java 2
SDK that the product installs might have missing files in the app_server_root/java directory.
Missing
files can destroy required symbolic links. If you remove the freeware cp command
from the PATH, you can install the Application Server product successfully.
- Verify that the Java 2 SDK on the installation image disc is
functioning correctly, if you created your own disc.
For
example, you might have downloaded an installation image from Passport Advantage®,
or you might have copied an installation image onto a backup disc.
In either case, perform the following steps to verify that the disc
contains a valid Java 2 software
development kit (SDK).
- Change directories to the /mnt/JDK/repository/prereq.jdk/java/bin directory
on the product CD-ROM or DVD. For example:
cd /mnt/JDK/repository/prereq.jdk/java/bin
- Verify the Java 2
SDK version. Type the following command:
./java -version
The
command completes successfully with no errors when the Java 2 SDK is intact.
Results
This
procedure results in preparing the operating system for installing
the product.
What to do next
After
preparing the operating system for installation, you can install the WebSphere Application Server
product.
See Preparing to install Network Deployment on an HP-UX system for
the next step in the overall procedure, which is selecting the type
of installation to perform.