Install WebSphere® Application Server
directly from your IBM® i system.
Before you begin
Prepare for the installation before using this procedure.
See Preparing the operating system for installation on IBM i for more information.
Before
you install WebSphere Application Server, ensure that
your user profile has *ALLOBJ and *SECADM special authorities.
About this task
You can install WebSphere Application Server
from Qshell using the INSTALL command. You
can also use the RUNJVA command to invoke
the installation wizard.
Procedure
- Sign on the IBM i system
with a user profile that has *ALLOBJ and *SECADM special authorities.
- Verify that the host server jobs have started on your IBM i server.
The
host server jobs allow the installation code to run on IBM i. On a CL command
line, enter the following command:
STRHOSTSVR SERVER(*ALL)
- Place the WebSphere Application Server - Express for IBM i disk in the disk
drive of your server. Do not use the WebSphere Application
Server - Express for Windows® disk or any other operating system
disk other than the disk for IBM i.
The application
server product installer is spanned across multiple CDs. If you are
installing the product from the CDs, then you must use the following
procedure or the installation will not proceed:
- Copy both installation CDs into the same parent directory (for
example, WebSphere7) on your hard disk.
- Name the directories DISC1 and DISC2 (for example, WebSphere7/DISC1 and WebSphere7/DISC2).
- If your system's language is not set to English, then set the
language to English for the duration of the installation.
Avoid trouble: If your language is set to something other than
English, the installation will fail.
gotcha
- Run the installer from the DISC1 directory after following the
remaining instructions in this document.
- After you have completed the installation, reset your system's
language to its previous setting if you had changed it during the
installation.
- Use the Copy (CPY) command to create a copy of the responsefile.express.txt file from
the disk.
For example:
CPY OBJ('/QOPT/WEBSPHERE/WAS/responsefile.express.txt') TODIR('/MYDIR')
QOPT
is the disk mount point.
WEBSPHERE is the disk volume label.
/WAS is
the product directory on the disk. This will be referred to in later
steps.
Note: For DVD media, an additional directory prefix is required
before the product directory that reflects the operating system and
architecture of the installation. Using the previous example, the
following installation path applies when you use CD-ROM media:
CPY OBJ('/QOPT/WEBSPHERE/WAS/responsefile.express.txt')
TODIR('/MYDIR')
However, the following installation
path applies when you use DVD media to install the
IBM i version of the product
on the 64-bit architecture:
CPY OBJ('/QOPT/WEBSPHERE/os400_ppc64/WAS/responsefile.express.txt')
TODIR('/MYDIR')
Read the packaging topics for more
information.
- If you have not already done so, read the IBM International
Program License Agreement located in the /WAS/lafiles directory.
If you agree to the terms of the agreement, continue with
the installation process.
- Edit the /MYDIR/responsefile.express.txt file.
For more information about the installation options and values, see Customizing installation response files.
- Change the value for -OPT silentInstallLicenseAcceptance from
false to true.
A value of true indicates that you have
read and accept the terms of the license agreement. This change is
required to run the installation.
- Specify a Java™ Software
Development Kit (SDK) to invoke the installer and configure the product
and profiles. You can force the use of a specific Java SDK
with the i5osjdklocation option in the response file.
New feature: You can now choose to install and
configure the application server product on
IBM i using one of three
supported Java SDKs. Read the "Customizing
the response file" topic for more information.
newfeat
- Various features might not be installed with the product
by default. If you want to use install certain features, uncomment
the -OPT addFeature line for each specific feature
you want to install. Valid features are listed in the response file.
- By default, the PROF_enableAdminSecurity option
is set to true. If you want to enable administrative security during
installation, you must specify values for the PROF_adminUserName and PROF_adminPassword options.
The user ID and password do not need to be a system user
ID and password or an LDAP user ID and password. The ID-and-password
pair specified are stored in the user registry and used for administrative
security for the default profile. Write down the user ID and password.
If
you do not want to enable administrative security, change the value
for the PROF_enableAdminSecurity option from true
to false.
- Change other installation options to suit your installation
requirements.
- Invoke the installation program for WebSphere Application
Server - Express for IBM i.
To
invoke the installation program for WebSphere Application
Server - Express for IBM i, run the INSTALL command
from Qshell or use the RUNJVA command from
the CL command line.
In the following example commands, path/responsefile represents
the fully-qualified path of the responsefile.express.txt file
that you edited.
Results
After you invoke the installation, messages are displayed
that indicate the progress of the installation process. When the setup
program completes, press F3 to exit.
Troubleshooting
Check
the
app_server_root/logs/install/log.txt file
for success, partial success, or failure for an installation. If the
app_server_root/logs/install directory
does not exist, check the following locations for log files:
- user_home/waslogs
- user_home/niflogs/tmp/waslogs
where
user_home is the
home directory for the user performing the installation.
If
the install completes indicating INSTCONFPARTIALSUCCESS, check the
log files located under the user_data_root/profileRegistry/logs/manageprofiles directory
for errors. Do not uninstall and attempt to reinstall. If you cannot
determine the problem, contact IBM Support.
What to do next
For security purposes, if the host servers were not running
prior to installation, it is recommended that you run the End Host
Server (ENDHOSTSVR) command after the installation
is complete.
Next: Go to Installing the WebSphere Application Server group PTF on IBM i to continue the installation.