A.4 Version changes : JP1 Version 12 JP1/Automatic Operation Configuration Guide

(1) Changes in version 12-60

Windows Server 2022 was added as a supported operating system.
Notes were added regarding the use of products that use the same Common Component.
The import of the service template provided by JP1/AO - Contents was added to the installation procedure.
The description of the files to be copied was changed.
Notes were added to the procedure for enabling the HTTPS connection between a web browser and JP1/AO.
The following operating systems are now supported:
- Red Hat Enterprise Linux 8
- Oracle Linux 8
- CentOS 8
The format of the private key was added to the tips in the procedure for creating public and private keys.
The following items were added as setting items in the user-specified properties file (config_user.properties):
- plugin.adapter.timeout
- task.periodicalTaskArchive.enable
- task.periodicalTaskArchive.period
- task.periodicalTaskArchive.taskCountThreshold
- task.periodicalTaskArchive.taskCountAfterArchive
- task.execute.skip.serverStart
- plugin.wmi.win32.UACAdministratorsExec
- plugin.wmi.win32.CreationFlags.CREATE_NO_WINDOW
Descriptions of the following items, as setting items in the connection-destination property file, were changed:
- wmi.workDirectory.sharedName
- wmi.adapter.id
The following items were added as setting items in the connection-destination property file:
- wmi.win32.UACAdministratorsExec
- wmi.win32.CreationFlags.CREATE_NO_WINDOW
The encryption method for connecting to the LDAP directory server was added.
Changes were made to the procedure (when the JP1/AO server is using Linux) for configuring settings to automatically start the JP1/AO service at the startup of the OS.
A security configuration operation was added to the flow of tasks for linking with Active Directory.
Descriptions of security settings for communication with the LDAP directory server were added.
Descriptions of the definition files used for linking with JP1/IM were changed.
Task confirmation was added to the procedure for changing the host name of the JP1/AO server.
Notes on changing port numbers were added.
The procedure for changing a port number was added.
The procedure for performing an overwrite or upgrade installation was changed.
The procedure for enabling failover of a resource group was changed.
The procedure for changing resource settings was changed.
The procedure for performing an overwrite installation of JP1/AO Content Pack was changed.
A description of how to prepare for uninstallation was added.
The prerequisite conditions for replacing a JP1/AO system were changed.

To Page Top

(2) Changes in version 12-01

Additions and changes were made to the procedures for specifying the settings that automatically start the JP1/AO services when the OS starts, when the JP1/AO server is running in Linux.

To Page Top

(3) Changes in version 12-00

None

To Page Top

(4) Changes in version 11-50

The procedure for enabling HTTPS connections was changed.
The timing for applying the definitions of the user-specified properties file was changed.
The following properties were added to the user-specified properties file: plugin.stdoutSize.wmi, plugin.stdoutSize.ssh, plugin.stdoutSize.telnet, and server.http.port.
The default value for the property notification.jp1event in the user-specified properties file was changed to false.
The property task.ajs.IPBindhost was deleted from the user-specified properties file.
The property server.http.port was added to the items that need to be set to change the communication port while the communication method is HTTP.
The procedure for changing the host name of the JP1/AO server was changed.
The description of the procedure for changing the maximum number of plug-ins that can be executed concurrently was changed.

To Page Top

(5) Changes in version 11-10

The installation of .NET Framework is no longer required when the OS is Windows Server 2012 or Windows Server 2012 R2, and descriptions of this requirement were deleted.
JP1/AO no longer requires JP1/Base as a prerequisite product, and descriptions of this requirement were deleted.
JP1/AO no longer uses JP1/AJS3 as a task processing engine, and content indicating otherwise was deleted.
Adobe Flash Player is no longer required, and descriptions of this requirement were deleted.
A procedure for importing the SSL server certificate into the truststore of Common Component was added.
A note on the procedure for importing the SSL server certificate into the truststore of Common Component was added.
The task monitor properties client.monitor.tasklog.maxfilesize and client.monitor.status.interval were deleted from the setting items in the user-specified properties file.
The uninstallation of JP1/AO is no longer required when changing a host name for a cluster system. Accordingly, the procedure was updated.
Hitachi Automation Director was added as a product that cannot be installed on a device on which JP1/AO is installed.
A list of required OSs for JP1/AO was deleted.
JP1/AJS3 is no longer included in JP1/AO, and therefore the stopcluster command is no longer required. Accordingly, descriptions of this requirement were deleted.
The folder path of Common Component created on the shared disk of JP1/AO was changed.
The task of uninstalling JP1/Base was added for when JP1/Base is not used after upgrading JP1/AO from a version earlier than 11-10 to version 11-10 or later.
The following tasks were added: post-upgrade tasks required for when automatic startup for JP1/AJS3 is enabled and an environment in which JP1/AO coexists with JP1/AJS3 is used.
The JP1/AO installation folder was added to items that require consistency between the replacement-source server and replacement-destination server.
The host name, IP address, and JP1/AO installation folder were added to the items that require consistency between the replacement-source server and replacement-destination server.

To Page Top

(6) Changes in version 11-01

The procedure for automatically starting JP1/AO at OS startup in an environment where JP1/AO and JP1/AJS3 coexist was added.
A cautionary note was added warning that you cannot specify a symbolic link as the installation destination when performing a new installation of JP1/AO in Linux.
The default database folder for the Common Component was added.
The procedure for enabling https connections and the default contents of the user_httpsd.conf file were changed.
A cautionary note was added warning that the JP1/AO login window will not appear if the connection between the Web browser and JP1/AO is configured incorrectly.
The procedure for importing an SSL server certificate into the Common Component was added. This certificate is required for https connections between JP1/AO and external Web servers.
The description of the client.events.refreshinterval and client.editor.upload.maxfilesize properties in the user-specified properties file was changed.

To Page Top

(7) Changes in version 11-00

(a) Changes from the manual (3021-3-082-70)

The following operating systems are now supported:
- Linux 7
- Oracle Linux 6 (x64)
- Oracle Linux 7
- CentOS 6 (x64)
- CentOS 7
- SUSE Linux 12
The following operating systems are no longer supported:
- Linux 5 (AMD/Intel 64)
- Linux 5 Advanced Platform (AMD/Intel 64)
The product was migrated from 32-bit Windows to 64-bit Windows.
The installation folder was changed for the Windows version of JP1/AO and the Common Component.
A description of using JP1/AO in English and Chinese-language environments was added.
The port numbers used for communication between JP1/AO and Web browsers were changed.
JP1/AO can now coexist with JP1/AJS3 version 11.
Hitachi Automation Director was added as a conflicting product for JP1/AO.
A description of the language settings in the JP1/AO server OS was added.
The folders that cannot be specified as the installation destination of JP1/AO were changed.
Items that can be specified in the user-specified properties file (config_user.properties) were added.
Items that can be specified in the connection-destination property file (connection-destination-name.properties) were added.
Tasks required before and after upgrade installation were added.
Service groups were added as a way to manage resources. Accordingly, resource groups were removed.

(b) Changes from the manual (3021-3-313-20(E))

Linux was added as a supported operating system.
The installation folder was changed for the Windows version of JP1/AO and the Common Component.
The port numbers used for communication between JP1/AO and Web browsers were changed.
The product was migrated from 32-bit Windows to 64-bit Windows.
Keyboard interactive authentication was added as an authentication method used for SSH connections with operation target devices.
Items that can be specified in the user-specified properties file (config_user.properties) were added.
Items that can be specified in the connection-destination property file (connection-destination-name.properties) were added.
The procedure to change the maximum number of plug-ins that can be executed concurrently was added.
Descriptions about how to specify whether to back up the database and how to specify the folder in which the database is to be backed up were added.
A prerequisite that the restriction code of the Hitachi Command Suite products must match on the original server and the target server was added.
JP1/AO can now coexist with JP1/AJS3 version 11.
Hitachi Automation Director was added as a conflicting product for JP1/AO.
A description of the language settings in the JP1/AO server OS was added.
The folders that cannot be specified as the installation destination of JP1/AO were changed.
Tasks required before and after upgrade installation were added.
Service groups were added as a way to manage resources. Accordingly, resource groups were removed.

To Page Top

(8) Changes in version 10-52

(a) Changes in the manual (3021-3-082-70)

Linux was added as a supported operating system.
Keyboard interactive authentication was added as an authentication method used for SSH connections with operation target devices.
The plugin.localMode property used to specify whether to use the local execution function was added to the property file (config_user.properties).
The plugin.threadPoolSize property used to specify the maximum number of plug-ins that can be executed concurrently was added to the property file (config_user.properties).
The procedure to change the maximum number of plug-ins that can be executed concurrently was added.
Descriptions about how to specify whether to back up the database and how to specify the folder in which the database is to be backed up were added.
A prerequisite that the restriction code of the Hitachi Command Suite products must match on the original server and the target server was added.

To Page Top

(9) Changes in version 10-50

(a) Changes in the manual (3021-3-082-60)

The HTTPS protocol can now be used to establish a connection between a JP1/AO server and a Web browser.
Public key authentication was added as an authentication method used with operation target devices.
It is now possible to specify an IP address for the task.ajs.IPBindhost property key in the property file (config_user.properties).
The ssh.privateKeyFile property used to specify the absolute path of the private key file for public key authentication was added to the property file (config_user.properties).
The plugin.remoteFileAccess.retry.times property used to specify the number of retries for a remote file manipulation command was added to the property file (config_user.properties).
Active Directory linkage was added as external authentication linkage.
A description about the configuration file for external authentication server linkage (exauth.properties) used to specify the settings required for external authentication linkage was added.
The stopcluster command was added.

Preparation for stopping the JP1/AO service in a cluster environment is now possible.
A cautionary note relating to if the following files are stored in the JP1/AO installation folder was added:
- SSL server certificate files used for HTTPS connections
- Private key files used for HTTPS connections
- Private key files used for public key authentication in SSH connections

(b) Changes in the manual (3021-3-313-20(E))

For the manual issued in December 2014 or later, the title and reference number were changed as shown below.

Before the change:

Job Management Partner 1/Automatic Operation GUI and Command Reference (3021-3-315(E))

After the change:

Job Management Partner 1/Automatic Operation GUI, Command, and API Reference (3021-3-366(E))
Windows Server 2012 R2 was added as an applicable operating system.
The HTTPS protocol can now be used to establish a connection between a JP1/AO server and a Web browser.
Public key authentication was added as an authentication method used with operation target devices.
The action to be taken if more time is required to complete a task in an environment where external networks cannot be connected was added.
The following property keys were added to the property file (config_user.properties):
- task.details.jobnet.status.visible
- packagemanager.extraPresets.maxFiles
- ssh.privateKeyFile
- plugin.remoteCommand.executionDirectory.wmi
- plugin.remoteCommand.executionDirectory.ssh
- plugin.remoteCommand.workDirectory.ssh
- plugin.remoteFileAccess.retry.times
- server.editor.step.perTemplate.maxnum
- server.editor.step.perLayer.maxnum
- client.editor.canvas.maxwidth
- client.editor.canvas.maxhigh
- tasklist.debugger.autodelete.taskRemainingPeriod
- client.debugger.tasklog.maxfilesize
- logger.debugger.TA.MaxFileSize
- client.monitor.tasklog.maxfilesize
- client.monitor.tasklog.refresh.interval
- client.monitor.status.interval
The default value of the logger.TA.MaxFileSize property key in the property file (config_user.properties) was changed to 10240.
It is now possible to specify an IP address for the task.ajs.IPBindhost property key in the property file (config_user.properties).
A definition example of the connection-destination property file was added.
ibm-943 was changed to ibm-943C as a specifiable value for the terminal.charset key in the connection destination property file, and as a character set that can be specified in the character set mapping file.
The character sets that can be specified in the character set mapping file were added.
A description about the configuration file for external authentication server linkage (exauth.properties) used to specify the settings required for external authentication linkage was added.
Active Directory linkage was added as external authentication linkage.
The stopcluster command was added.

Preparation for stopping the JP1/AO service in a cluster environment is now possible.
The step for starting the JP1/Base service was deleted from the procedure for changing the IP address of the JP1/AO server.
A folder for service templates and plug-ins that are in the process of development was added.
A cautionary note relating to the upgrade installation procedure was added.
A cautionary note relating to if the following files are stored in the JP1/AO installation folder was added:
- SSL server certificate files used for HTTPS connections
- Private key files used for HTTPS connections
- Private key files used for public key authentication in SSH connections

To Page Top

(10) Changes in version 10-12

(a) Changes in the manual (3021-3-082-50)

Windows Server 2012 R2 was added as an applicable operating system.
The default value of the logger.TA.MaxFileSize property key in the property file (config_user.properties) was changed to 10240.
The following property keys were added to the property file (config_user.properties):
- task.details.jobnet.status.visible
- packagemanager.extraPresets.maxFiles
- plugin.remoteCommand.executionDirectory.wmi
- plugin.remoteCommand.executionDirectory.ssh
- plugin.remoteCommand.workDirectory.ssh
- tasklist.debugger.autodelete.taskRemainingPeriod
- client.debugger.tasklog.maxfilesize
- logger.debugger.TA.MaxFileSize
- client.monitor.tasklog.maxfilesize
- client.monitor.tasklog.refresh.interval
- client.monitor.status.interval
A folder for service templates and plug-ins that are in the process of development was added.

To Page Top

(11) Changes in version 10-11

(a) Changes in the manual (3021-3-082-40)

The following property keys were added to the property file (config_user.properties):
- server.editor.step.perTemplate.maxnum
- server.editor.step.perLayer.maxnum
- client.editor.canvas.maxwidth
- client.editor.canvas.maxhigh
ibm-943 was changed to ibm-943C as a specifiable value for the terminal.charset key in the connection destination property file, and as a character set that can be specified in the character set mapping file.
A definition example of the connection-destination property file was added.
The character sets that can be specified in the character set mapping file were added.
The action to be taken if more time is required to complete a task in an environment where external networks cannot be connected was added.
The step for starting the JP1/Base service was deleted from the procedure for changing the IP address of the JP1/AO server.
A cautionary note relating to the upgrade installation procedure was added.

To Page Top

(12) Changes in version 10-10

(a) Changes in the manual (3021-3-082-30)

JP1/Automatic Operation Service Template Developer's Guide was added as a supplied manual.
A definition example of the character-set mapping file (charsetMapping_user.properties) was added.
The role and permissions on JP1/AO were added in the description defining permission levels in JP1/Base (JP1/Base link).
Precautions related to the upgrade installation procedure were added.

(b) Changes in the manual (3021-3-313-10(E))

The requirement for installation of .NET Framework 3.5 in Windows Server 2012 was added.
Job Management Partner 1/Automatic Operation Service Template Developer's Guide was added as a supplied manual. In addition, a folder was added for English manuals.
Email notification files now support Chinese environments in addition to the English and Japanese environments.
The connection-destination property file (connection-destination.properties) was added.
The character-set mapping file (charsetMapping_user.properties) was added.
The following property keys were added to the property file (config_user.properties):
- telnet.port.number
- plugin.terminal.prompt.account
- plugin.terminal.prompt.password
- telnet.connect.wait
- telnet.connect.retry.times
- telnet.connect.retry.interval
- logger.Audit.command.useLoginUserID
The role and permissions on JP1/AO were added in the description defining permission levels in JP1/Base (JP1/Base link).
The definition files that are used for linkage with JP1/IM now support English and Chinese environments in addition to the Japanese environment.
Descriptions about how to link JP1/AO with JP1/AJS3 were added.
The procedure for stopping JP1/Base services was deleted from the procedure for changing the IP address of the JP1/AO server.
The section that describes setting up a cluster system was moved from Chapter 1 to Chapter 5.
Descriptions about an overwrite installation of JP1/AO Content Set were added.
A description of an upgrade installation was added.
Precautions related to the upgrade installation procedure were added.

To Page Top

(13) Changes in version 10-02

(a) Changes in the manual (3021-3-082-20)

The requirement for installation of .NET Framework 3.5 in Windows Server 2012 was added.
The connection-destination property file (connection-destination.properties) was added.
The character-set mapping file (charsetMapping_user.properties) was added.
The following property keys were added to the property file (config_user.properties):
- telnet.port.number
- plugin.terminal.prompt.account
- plugin.terminal.prompt.password
- telnet.connect.wait
- telnet.connect.retry.times
- telnet.connect.retry.interval
- logger.Audit.command.useLoginUserID
Descriptions about how to link JP1/AO with JP1/AJS3 were added.
The section that describes setting up a cluster system was moved from Chapter 1 to Chapter 5.
Descriptions about an overwrite installation of JP1/AO Content Set were added.
A description of an upgrade installation was added.

To Page Top

(14) Changes in version 10-01

(a) Changes in the manual (3021-3-082-10)

None

To Page Top