12.2.6 Installation in Linux

This subsection describes the installation procedure in Linux.

Note that the names of files and directories on the installation media might be different from the names used in this subsection, depending on the hardware environment. Use the actual file and directory names displayed by the ls command.

To install a JP1/AJS3 series program in Linux:

Log in as superuser to the host on which you want to install the JP1/AJS3 series program. Alternatively, use the su command to become superuser.
Stop the programs linked with JP1/AJS3.
- New installation:
  
  If a program linked with JP1/AJS3 is running on the host on which you want to install JP1/AJS3, stop it.
- Upgrade installation
  
  For details, see 12.2.2(2)(b) About upgrade installations of JP1/AJS3 - Manager and JP1/AJS3 - Agent, or 12.2.2(2)(c) About upgrade installations of JP1/AJS3 - Web Console.
Specify the character encoding set to be used for JP1/AJS3 in the LANG environment variable.

For the character encoding sets available to JP1/AJS3, see 2.4.2(2) Values that can be specified in the LANG environment variable in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.
Set the JP1AJS3_EMBDB_SETUP environment variable.

Set the environment variable only when performing a new installation of JP1/AJS3 - Manager. By setting the JP1AJS3_EMBDB_SETUP environment variable before installation, you can specify whether to automatically set up a scheduler service and an embedded database during installation. When automatic setup is to be performed, you can specify the scale of the embedded database to be set up.

You can skip this step if you are going to set up a scheduler service and configure a small-scale embedded database.

The scheduler service and the embedded database are not automatically set up at installations other than a new installation. For this reason, this procedure is unnecessary other than for when a new installation is performed.

You can specify one of the following values for the JP1AJS3_EMBDB_SETUP environment variable:

s

Specify this value to automatically set up an embedded database in a small-scale model.

m

Specify this value to automatically set up an embedded database in a mediam-scale model.

l

Specify this value to automatically set up an embedded database in a large-scale model.

skip

Specify this value if an embedded database is not to be set up automatically.
Insert the media containing the JP1/AJS3 series program you want to install.
Mount the installation media.

Mount the mount directory as /mnt/dvdrom. For details about commands for mounting, see the documentation for your OS.
Execute the following command to start Hitachi Program Product Installer:
```
/mnt/dvdrom/X64LIN/setup /mnt/dvdrom^#
```
Hitachi Program Product Installer starts, and the initial screen appears.

#:

This example assumes that the mount point directory is /mnt/dvdrom.
On the initial screen, enter I.

A list of programs that can be installed is displayed.
Select the JP1/AJS3 series program you want to install, and then enter I.

The selected program is installed.

You can select a program by moving the cursor to the program, and then pressing the space bar.
When installation of the program has been completed, enter Q.

The Hitachi Program Product Installer initial screen is displayed again.

After JP1/AJS3 - Manager has been installed, check syslog for the KAVS2128-E message. If this message has been output, setup of the scheduler service has failed, in which case take action based on the KAVS2128-E message.

If a scheduler service and an embedded database are not to be automatically set up during installation of JP1/AJS3 - Manager, you need to manually set up a scheduler service and an embedded database or an external database after installation has finished. For details about setup of an embedded database, see 23. Setting Up an Embedded Database. For details about setup of an external database, see 24. Performing setup for using an external database in a cloud environment.

If automatic setup of an embedded database during installation is enabled, the setup of user information (authentication server and JP1 user information) and of the database will be complete when installation finishes. In this state, you can execute a job simply by starting the JP1/AJS3 service. Note, however, that the job will be executed with all of the default settings. For information about changing these settings, see 13. Setup.

Organization of this subsection

(1) Environment in which SELinux is enabled

(1) Environment in which SELinux is enabled

In an environment in which SELinux is enabled, you must set the OS default labels again and configure the security context after installation.

This section describes the procedure for setting the OS default labels again after installing JP1/AJS3 series programs. Note that, if you install multiple products, you must set the OS default labels again after installing all those products.

The procedure for setting the OS default labels again is as follows:

Execute the following command:
```
# touch /.autorelabel
```
The /.autorelabel file is deleted after the OS is restarted. Therefore, relabeling is no longer performed when the OS is restarted again.
Restart the OS.^#

#:

To perform relabeling without restarting the OS, execute the following commands:

For JP1/AJS3 - Manager:

# restorecon -FR /etc/opt/jp1ajs2
# restorecon -FR /opt/jp1ajs2
# restorecon -FR /var/opt/jp1ajs2

For JP1/AJS3 - Agent:

# restorecon -FR /etc/opt/jp1ajs2
# restorecon -FR /opt/jp1ajs2
# restorecon -FR /var/opt/jp1ajs2

For JP1/AJS3 - Web Console:

# restorecon -FR /etc/opt/jp1ajs3web
# restorecon -FR /opt/jp1ajs3web
# restorecon -FR /var/opt/jp1ajs3web
# restorecon -FR /opt/hitachi/HNTRLib2 (Execute this command only in an environment in which JP1/Base is not installed.)

For details about the procedure for configuring the security context, see 15.10.4 SELinux-related settings (Linux only).

To Page Top