Hitachi

JP1 Version 12 JP1/Base User's Guide


3.3.4 Notes on installing and uninstalling JP1/Base

Organization of this subsection

(1) Installation

(2) Re-installation

(3) Setting the OS environment

At JP1/Base installation, the port numbers listed in C. List of Port Numbers are added to the /etc/services file. This information is removed when JP1/Base is uninstalled.

(4) Uninstallation

(5) Overwrite installation

Note the following if you are performing an overwrite installation of JP1/Base in an environment running an earlier version of a JP1 program:

(6) Notes on performing installation using disk replication (Linux only)

This is a Hitachi program product that supports the installation of replicated disks by JP1/ServerConductor/Deployment Manager and Hitachi Compute Systems Manager Deployment Manager Plug-in, or replication functionality that uses image files provided by virtualized platforms.

When performing disk replication installation, we recommend that you replicate the default settings of each JP1/Base definition file after installation and setup.

However, if you change the settings and then use the same settings in the target replication hosts, note the following points.

(a) Precautions for before replication

Setting the processing environment of the event service

Do not set IP addresses or host names for each parameter in the event server index file, the event server settings file, or the API settings file.

Deleting definition information for system configurations

When defining the target replication host under the system configuration in JP1/IM, delete the previously set configuration information by using the jbsrt_del command.

(b) Precautions for after replication

Initializing the event database

JP1 events might remain in the event database if you restart the computer with an internally generated host name at the time of disk replication installation. Initialize the event database before operation starts.

For operational procedures, see the JP1/ServerConductor/Deployment Manager User's Guide and Hitachi Compute Systems Manager Deployment Manager Plug-in User's Guide. For details about the replication functionality of virtualized platforms, see the product manual.

(7) Notes on the silent installation functionality

This software product can be installed by using the silent installation functionality.

Execute the following command:

In HP-UX:

Supplied-media/IPFHPUX/setup -f -k Product-type-No Path-of-supplied-media

In Solaris:

Supplied-media/SOLARIS/setup -f -k Product-type-No Path-of-supplied-media

In AIX:

Supplied-media/AIX/setup -f -k Product-type-No Path-of-supplied-media

In Linux:

Supplied-media/LINUX/setup -f -k Product-type-No Path-of-supplied-media
Notes on performing silent installation
  • To execute the contents of supplied media directly from a hard drive, copy the contents of the supplied media to a directory on the hard drive whose path does not include any spaces. Then, compare the copied files to the original files (at the binary level, for example) to ensure that they are the same.

  • Check the return value of the execution result to verify that the installation ended successfully. For details about the return values, see the JP1 website.

(8) Procedure for restoring common definition information of a JP1 product that requires JP1/Base

The following describes the procedure for restoring common definition information when reinstalling JP1/Base without uninstalling the JP1 product that requires JP1/Base.

Note: Do not start the JP1/Base service or other JP1 product service during the restore procedure.

And execute the following command to backup the common definition information of all JP1 products in case of performing incorrect procedure to restore the common definition information.

  1. Back up JP1/Base.

    For details on backups, see 3.5.3 Backup and recovery (in UNIX).

    If JP1/IM - Manager is installed, backup the command execution log (ISAM) file. For details about the backup of command execution log (ISAM) file, see the manual JP1/Integrated Management 2 - Manager Administration Guide (Database backup and recovery).

    Collect the log data before you perform the procedure to restore the common definition information in case the integrated trace log is deleted. For details on collecting log data, see 18.4 How to collect data.

  2. Check the output destination of the common definition information backup file.

    Check whether there is sufficient free disk space (1 + 0.4 x number-of-logical-hosts [MB] or more) for the output destination of the common definition information backup file (\tmp\). And check whether the common definition information backup file and output directory have not been locked by applications like editor. And also check for the access permission.

    If there is insufficient free disk space, the common definition information backup file will not be output correctly. For example, the file size of the common definition information backup becomes 0 byte.

    If directory or file has been locked by some application or if you do not have access permission, error message KAVA1871-E will be output during the uninstallation.

  3. Set the following environment variables:

    • # JP1_BASE_UNINST_FORCE=1

    • # export JP1_BASE_UNINST_FORCE

  4. Uninstall JP1/Base.

    Uninstall JP1/Base as prompted by the Hitachi Program Product Installer by referring 3.3.3 Uninstalling JP1/Base.

    Uninstallation can be performed even if the prerequisite products of JP1/Base are installed.

    During the uninstallation, common definition information excluding JP1/Base is output as the common definition information backup file.

    • Physical host: /tmp/JP1_COMDEF/comdef_JP1_DEFAULT.conf

    • Logical host: /tmp/JP1_COMDEF/comdef_logical-host-name.conf

  5. Clear the setting of the JP1_BASE_UNINST_FORCE environment variable.

  6. Reinstall JP1/Base.

    For details on install, see 3.3.1 Installing JP1/Base.

  7. Re-set up JP1/Base.

    If you are operating in a cluster, create a logical host.

    The logical host name (Uppercase/Lowercase) and shared directory name cannot be changed.

    Recover the adapter command configuration file (/opt/jp1base/plugin/conf/*.conf) from the backup in step 1.

    If JP1/IM - Manager is installed, recover the command execution log (ISAM) file from the backup in step 1.

    Recover the event database from the backup in step 1. For details on recovering the event database, see 3.5.3(4)(a) When the forwarding settings file is not configured to forward JP1 events to other hosts.

    Build the JP1/Base environment.

    • When recovering the JP1/Base environment:

      Recover the JP1/Base other definition files, common definition information, and jp1hosts2 information from the backup in step 1.

      For details on recovery, see 3.5.3 (3) Recovering JP1/Base setup information.

    • When rebuilding JP1/Base environment:

      Perform JP1/Base setup again.

      For details on setup, see 3.4 JP1/Base setup.

      And also, perform other settings as necessary.

    If you have set up JP1/Base in the setup of another product, set it up again.

  8. Execute the jbssetcnf command using the common definition information backup file output in step 4.

    Restore the common definitions for JP1 products excluding JP1/Base. Execute the command for the physical host and all logical hosts.

    jbssetcnf common-definition-information-backup-file-name
  9. Delete the common definition information backup file output directory in step 4.

    Delete the common definition information backup file output directory (\tmp\JP1_COMDEF\).