2.3.1 Installation procedure (for UNIX)
This subsection explains how to install JP1/IM - Manager and JP1/IM - Agent.
- Organization of this subsection
(1) How to install JP1/IM - Manager
Install JP1/IM - Manager and JP1/IM - Agent as follows:You need root permissions to perform this procedure.
If you install JP1/IM - Manager, JP1/IM - Agent management base for using JP1/IM - Agent is also installed.
-
Terminate all programs.
Before you start the installation, terminate JP1/Base and all programs that require JP1/Base.
If you are performing an upgrade installation, stop JP1/IM - Manager. If a JP1/IM - View is connected, log out.
-
Run the Hitachi Program Product Installer.
Follow the instructions of the Hitachi Program Product Installer. For details about how to use the Hitachi Program Product Installer, see 2.3.2 How to use the Hitachi Program Product Installer (for UNIX).
When JP1/IM - Manager is installed, the file shown below is created as a log. This file contains maintenance information that is used in the event of abnormal termination of installation. Once JP1/IM - Manager has been installed successfully, start it. If there are no problems, delete the following file:
/tmp/HITACHI_JP1_INST_LOG/jp1imm_inst{1|2|3|4|5}.log
- Important
-
If you have upgraded JP1/IM - Manager in an environment in which IM databases have already been set up, use the jimdbupdate command to update the IM databases. If the IM databases have not been updated, a warning message is displayed when JP1/IM - Manager starts.
To perform encrypted communication with JP1/IM - Agent, perform the following steps related to JP1/IM - Agent management base.
-
Setup Server certificate and its key file.
When performing cryptographic communication with integrated agent host, specify the full path of Server certificate file to tls_config.cert_file of imbase common configuration file (jpc_imbasecommon), and the full path of the key file of server certificate in "tls_config.key_file".
For details, see "imbase common configuration file (jpc_imbasecommon.json)" (2. Definition File) in the manual "JP1/Integrated Management 3 - Manager Command, Definition File and API Reference".
(2) Procedure of JP1/IM - Agent installation
(a) Information required before installation
If you are installing JP1/IM - Agent newly, you need the following: Prepare before installation.
|
Item |
Needing to specify |
Description |
|---|---|---|
|
Host name of the install destination JP1/IM - Manager |
Required |
Specifies Host name of the manager host that manages integrated agent to be installed. The name must be resolved to IP address. |
|
Listen port for imbase processes |
Optional |
Specifies the listen port for imbase processes running on the manager host to connect, from 5001 to 65535. When this is omitted, imbase default port (20724) is used. |
|
Listen port for imbaseproxy processes |
Optional |
Specifies the listen port for imbaseproxy processes running on the manager host to which the connection is made, from 5001 to 65535. By default, imbaseproxy defaultport (20725) is used. |
|
Initial secret to connect to imbase for the first time |
Required |
Specifies initial secret to connect to imbase process running on the manager host to connect for the first time. Check from integrated operation viewer. |
|
URL of proxy |
Optional |
If you are connecting to the manager host through a proxy server, specify the proxy URL in "http://host:port" format. The default for when this is omitted is an empty string. |
|
User ID for proxy authentication |
Optional |
When connecting to the manager host, specify ID for authentication of the proxy server when passing through the proxy server. The characters that can be specified are the characters in ASCII encoding 0x20 to 0x7E. You can specify up to 1007-charaters-long string. The default for when this is omitted is an empty string. |
|
Password for Proxy authentication |
Optional |
When connecting to the manager host, specify password for authentication of the proxy server when passing through the proxy server. The characters that can be specified are the characters in ASCII encoding 0x20 to 0x7E. You can specify up to 1007-charaters-long string. The default for when this is omitted is an empty string. |
|
Functions to be used |
Optional |
Allows you to select the function that you use in JP1/IM - Agent. A new install setup the service for the feature you use to start automatically. |
(b) Install Instructions
Follow the procedure below to install.
-
Login agent host with administrator privileges.
You must have root privilege to complete the install process.
-
Install JP1/IM - Agent.
There are two ways to install JP1/IM - Agent:
-
To install by setting the offered media on the drive
-
To install by downloading JP1/IM - Agent packages registered to the manager host#
- #
-
For the procedure for downloading JP1/IM - Agent package, refer to 2.18.6(3) How to Download JP1/IM - Agent Package.
-
-
Setup the environment variables for default settings for the host to be installed.
- For normal, silent, and Remote installations (mandatory)
The parameters required for installation must be setup in the environment-variable # beforehand.
- #
-
For details about environment variable, see "1.3.1(3)(c) Initialization environment variable used by the installer".
-
Terminate all programs.
Close all programs before installing.
Stop JP1/IM - Agent servicing before installing the version upgrade.
-
Install JP1/IM - Agent by executing the downloaded JP1/IM - Agent installer.
Follow the instructions on Hitachi PP Installer# to install.
#: For details about the operating procedure, see "2.3.2 How to use the Hitachi Program Product Installer (for UNIX)".
Select the software you want to install.
-
After the install, change the required settings.
Change required settings described in "2.19.2 Change Setup in JP1/IM - Agent". The mandatory settings should be executed for sure.
After JP1/IM-Agent is newly installed, check whether the/tmp/HITACHI_JP1_INST_LOG/jp1imagent_inst1 displays an error message indicating that jimasetup command or jimasecret command failed to execute. If an error message has been output, check the log file of jimasetup command or jimasecret command and take appropriate action according to the displayed error message.
- Important
-
If you have changed initial secret after you installed JP1/IM - Agent before the first boot of JP1/IM - Agent on integrated agent host, you must uninstall and reinstall integrated agent.
(3) Various Installations
- Upgrade installation
-
If you are upgrading from a previous version of JP1/IM - Manager, first read the notes about upgrading that you will find in 15.2 Upgrading from a previous version of JP1/IM in the JP1/Integrated Management 3 - Manager Overview and System Design Guide.
- Important
-
When performing an upgrade installation on a computer where logical host settings are set, terminate the daemon for JP1/IM - Manager of the logical host before performing the upgrade installation.
- Remote installation using JP1/NETM/DM, JP1/IT Desktop Management 2 and Job Management Partner 1/Software Distribution
-
JP1/IM supports remote installation (software distribution) using JP1/NETM/DM, JP1/IT Desktop Management 2 and Job Management Partner 1/Software Distribution, and you can perform a new installation as well as an upgrade installation of JP1/IM.
The following remote installation methods are available:
- - Update installation
-
- For JP1/IM - Manager
Settings of the installed JP1/IM - Manager is inherited. If JP1/IM - Manager is not installed, updating cannot be installed.
- For JP1/IM - Agent
Settings of the installed JP1/IM - Agent is inherited. If JP1/IM - Agent is not installed, updating cannot be installed.
- - New installation
-
The product is newly installed.
See JP1/NETM/DM, JP1/IT Desktop Management 2 or Job Management Partner 1/Software Distribution Manual for more information.
Be sure to use a JP1/NETM/DM 09-00 or later packager, a JP1/IT Desktop Management 2 packager or a Job Management Partner 1/Software Distribution 09-00 or later packager to package this software product. JP1/NETM/DM is sold only in Japan.