Hitachi

JP1 Version 12 JP1/Automatic Operation Service Template Reference


4.5.3 JP1 apply patch (UNIX)

Function

This plug-in applies the correction patch for the JP1 product you installed, on the UNIX execution target server.

This plug-in requires the following server:

- An execution target server

This plug-in will be executed on this server.

This plug-in applies to JP1 Version 11 or later.

The script in this plug-in executes the following command:

- mkdir

-p path-to-the-directory-to-which-the-correction-patch-is-to-be-expanded(JP1.patchDestDirPath property)

- tar

zxf path-to-the-correction-patch-file(JP1.patchSourceFilePath property)

-C path-to-the-directory-to-which-the-correction-patch-is-to-be-expanded(JP1.patchDestDirPath property)

- UPDATE

-f

-D path-to-the-output-file(common.outputLogFile property)

Depending on the correction patch, some other operations (for example, restarting the OS) might be required when applying the patch. See the document RELEASE.TXT "Procedure for applying the patch and how to operate it" provided with the correction patch.

The files and folders in the folder specified as the folder to which the correction patch is to be expanded (JP1.patchDestFolderPath property) are not deleted.

Use situation

Used to apply the correction patch for the JP1 product.

Prerequisites

For the latest support information about [Prerequisite product in the system]/[Prerequisite OS running on the execution target server], see the release notes.

[Prerequisite products in the system]

JP1/Automatic Operation 11-00 or later

[Prerequisite products on the execution target server]

See the documentation provided with the correction patch, and the release notes for the JP1 product to which you want to apply the correction patch.

[Prerequisite OS running on the execution target server]

(1) Red Hat Enterprise Linux Server 6 (32-bit x86), Red Hat Enterprise Linux Server 6 (64-bit x86_64)

(2) Red Hat Enterprise Linux Server 7 (64-bit x86_64)

(3) Red Hat Enterprise Linux Server 8 (64-bit x86_64)

[Requirements for the prerequisite products on the execution target server]

See the documentation provided with the correction patch, and the release notes for the JP1 product to which you want to apply the correction patch.

Cautions

(1) For a plug-in property, do not specify a character string that contains a double quotation mark (") or a single quotation mark (').

(2) For a property that specifies a path, do not specify a character string that contains a single-byte space, an exclamation mark (!), a dollar sign ($), a yen sign (\), or a grave accent mark (`).

Execution privilege

(1) The user who connects to the execution server must have the necessary permissions to apply the correction patch.

Version

02.01.00

Plug-in tags

Configure JP1,Linux

Plug-in name displayed in the task log

jp1commonApplyPatch_Unix

Return code

0: Normal

12: Error (user error): Invalid property

14: File access disabled

21: Error (invalid environment): No command was found. (An error was detected in the plug-in script.)

27: Error (Check the error details from a task log.)

41: Error (error detected in plug-in): Missing property (error detected in plug-in script)

Property list

The following table lists the properties:

Property key

Property name

Description

Default value

I/O type

Required

plugin.destinationHost

Host name of the execution target server

Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported.

--

Input

R

JP1.patchSourceFilePath

Fix patch file path

Specify a fix patch file as a full path.

--

Input

R

JP1.patchDestDirPath

Fix patch expansion destination directory path

Specify the directory, as a full path, where the fix patch is to be expanded.

--

Input

R

common.outputLogFile

Output file path

Specify an output log file as a full path.

--

Input

O

common.returnValue

Return value for the plugin

The return value of this plugin stored.

--

Output

O