4.10.2 Installing Application Server on a remote host

To install Application Server on a new remote host, start the Program Product Installer from the provided media, and then select the program to install from the program product installation window. After the installation is complete, set the environment settings.

Prerequisites

The system engineer has root privileges (super user).
Remote host is running.
A prerequisite operating system (OS) and patches are installed.

Intended users

System engineers

Procedure

Ensure that the packages listed in the following table have been applied.

Table 4‒5: Package to be applied for each OS
Package Name	Red Hat Enterprise Linux 5	Red Hat Enterprise Linux Server 6
compat-libstdc++-296 (i386)	Y	--
compat-libstdc++-33 (i386)	Y	--
compat-libstdc++-33 (i686)	--	Y
compat-libstdc++-33 (x86_64)	Y	Y
coreutils (x86_64)	Y	Y
findutils (x86_64)	Y	Y
gdb (x86_64)	Y	Y
glibc (i686)	Y	Y
glibc (i686) 2.5-24 or later	Y^#1	--
glibc (x86_64)	--	Y
glibc (x86_64) 2.5-24 or later	Y^#1	--
glibc-common (x86_64)	--	Y
glibc-common (x86_64) 2.5-24 or later	Y^#1	--
glibc-devel (i386) 2.5-24 or later	Y^#1	--
glibc-devel (i686)	--	Y
glibc-devel (x86_64)	--	Y
glibc-devel (x86_64) 2.5-24 or later	Y^#1	--
glibc-headers (x86_64)	--	Y
glibc-headers (x86_64) 2.5-24 or later	Y^#1	--
glibc-utils (x86_64)	--	Y
glibc-utils (x86_64) 2.5-24 or later	Y^#1	--
gzip (x86_64)	Y	Y
ksh (x86_64)	--	Y
libgcc (i386)	Y	--
libgcc (i686)	--	Y
libstdc++ (i386)	Y	--
libstdc++ (i686)	--	Y
lksctp-tools (x86_64)	Y	Y
ncompress (x86_64)	Y	Y^#2
ncurses (x86_64)	Y	Y
net-tools (x86_64)	Y	Y
nscd (x86_64)	--	Y
nscd (x86_64) 2.5-24 or later	Y^#1	--
nss-softokn-freebl (i686)	Y	Y
procps (x86_64)	Y	Y
rpm (x86_64)	Y	Y
sysstat (x86_64)	Y	Y
tar (x86_64)	Y	Y

Legend

Y: Apply this package

--: Not applicable

#1

These packages might not be included in the installation media, depending on the version of Red Hat Enterprise Linux 5 that is being used.

#2

If Red Hat Enterprise Linux Server 6.2 is used, ncompress (x86_64) version 4.2.4-54.el6_2.1 or later needs to be applied.

To verify whether a package is installed, execute the rpm command. The following example displays both the command execution and execution result of the rpm command:

Example of execution:

#rpm -q --qf  '%{NAME}-%{ARCH}\n'  ncompress

Example of execution result:

ncompress-x86_64

This example displays that the 64 bit ncompress package was installed.

If the message Package package_name is not installed is displayed, this indicates that the package was not installed. In such a case, install the package displayed in package_name. During the installation, also install related packages as required.

Verify whether the language type of the Program Product Installer matches the language on the terminal where you will perform the installation. If the languages do not match, make them the same.
Insert the provided media of the product into the corresponding drive.
Run the mount command to mount the file system of the corresponding media.
In Linux, use the following code:
```
mount -r -o mode=0544 /dev/cdrom 
mount_directory_name_of_filesystem_for_corresponding_media
```
Note that special_file_name_of_device and mount_directory_name_of_filesystem_for_corresponding_media vary depending on the operating system (OS), hardware, and environment.
Start the setup program from the media of the product.
In Linux, use the following code:
```
mount_directory_name_of_filesystem_for_corresponding/x64lin/setup -m 
mount_directory_name_of_filesystem_for_corresponding_media
```
Important note

The details of the directory name and file name of the corresponding media and how to view this information, might differ depending on the computer environment. Use the ls command to verify this information, and enter the displayed file name as is.

The setup program installs the Program Product Installer and program required to start resident processes automatically, on the hard disk. The Program Product Installer starts automatically.
On the main menu of the Program Product Installer, press the I key.
In the program product installation window, move the cursor over the name of the product to be installed (Hitachi Application Server), and then press Spacebar key.

A (<@>) icon, which indicates the selection state appears on the left side of the selected program.
To select and install the programs that will compose the product, move the cursor to the programs that you do not want to install, and then press the Spacebar key.

The [@] icon appears on the left side of programs that are optional. When you press the Spacebar key, the icon within [] changes, and those programs will not be installed.

Note that the @ icon is displayed on the left side of programs that are mandatory.
Ensure that the <@> icon is displayed on the left side of the product to be installed and that [@] or @ is displayed on the left side of the programs to be installed. Then, press the I key.

A message Install PP? (y: install, n: cancel)==> appears at the bottom of the window.
Press the y+ or Y key.

A message Enter the installation path ==>default_installation_destination appears at the bottom of the window.

If you press the Ctrl+n or Ctrl+N, then the installation will stop and you will return to the program product installation window.
Verify the default_installation_destination value and change the installation destination directory as required. Then, press the Enter key.

You can specify only alphanumeric characters, hyphens (-), and underscores (_) in the installation destination.
If the specified installation directory does not exist, a message confirming the creation of the directory appears.
```
The specified path does not exist. Do you want to create the path? 
Specified path: installation_destination
```
Verify the installation_destination and then press the y+ or Y key.

A message Enter a display name ==> default_display_name appears at the bottom of the window.

To reconfigure the installation destination, press the Ctrl+B keys.
Verify the default_display_name, change the display name as required, and then press the Enter key.

A maximum of 40 characters can be specified for the display name. You can only specify alphanumeric characters, hyphens (-), and underscores (_).
The message asking whether you want to continue with the installation with the specified display name and installation destination is displayed in the window.
```
This program product will be installed at the specified path,
with the specified display name.
Do you want to continue?
Specified display name: display_name
Specified path        : installation_directory
```
To change the display name or installation destination, press the n+ or N key. You will be returned to step 10.
Verify the display name and installation destination, and then press the y+ or Y key.

The installation starts.
When a message indicating the end of the installation appears, press the Q key.
On the main menu of the Program Product Installer, press the L key.

The program product list window displays a list of the installed products.
Verify whether the product was installed successfully, and then press the Q key.
On the main menu of the Program Product Installer, press the Q key.

The Program Product Installer closes, and the installation of Application Server is complete.
Set the Time Zone (TZ) environment variable in the configuration file (asenv.conf).
The configuration file (asenv.conf) is stored in installation_directory_for_Java_EE_Server/glassfish/config/asenv.conf. The following is a definition example of a configuration file (asenv.conf):
```
TZ=JST-9
```
Allow the IP address to be resolved from the local host name by specifying an appropriate IP address assigned for the network interface for the local host name in the /etc/hosts file.
Repeat steps 1 to 19 for each remote host that needs to be configured as a request distribution destination.

Postrequisites

Set up Application Server to connect to a remote host.