Job Management Partner 1/Software Distribution Setup Guide

[Contents][Glossary][Index][Back][Next]

11.1.2 Creating an environment that enables failover of JP1/Software Distribution

The following shows how to create an environment in which failover of JP1/Software Distribution is enabled.

If the OS is Windows Server 2008, replace Cluster Administrator with Failover Cluster management. If the OS is Windows Server 2012, replace Cluster Administrator with Failover Cluster Manager.

Organization of this subsection
(1) Using Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster to create a group resource
(2) Creating a cluster environment for applying a failover facility to the database server
(3) Creating an environment for using a failover facility
(4) Creating an environment for a system directly under JP1/Software Distribution Manager
(5) Specifying the connection destinations for using components
(6) Settings for an environment containing a firewall
(7) Actions to be taken after a failover

(1) Using Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster to create a group resource

Create a group for JP1/Software Distribution and register the IP address resource, network name resource, and shared disk (physical disk) resource.

The first time Microsoft Cluster Service or Windows Server Failover Cluster is installed, a group named Cluster Group is created. Create a new group separately from Cluster Group. Also, set the server that is running as the executing server as the primary server.

For details about creating a group resource, see the Microsoft Cluster Service or Windows Server Failover Cluster documentation.

(2) Creating a cluster environment for applying a failover facility to the database server

When using Microsoft SQL Server 2012 or Microsoft SQL Server 2008 in a cluster system
You must use the Microsoft SQL Server installation wizard to set up the failover cluster.
Install Microsoft SQL Server on the local disk of the executing server that is part of the cluster. Then, use the failover cluster wizard to set up the clustering service. For details about installing and setting up Microsoft SQL Server, see the manual for the Microsoft SQL Server. To start installation of the failover cluster, choose New SQL Server failover cluster installation at the SQL Server Installation Center. After that, choose Add node to a SQL Server failover cluster to add a standby server.
For details about how to install and set up Microsoft SQL Server, see the Microsoft SQL Server documentation.

When using Microsoft SQL Server 2005 in a cluster system
You must use the installation wizard of Microsoft SQL Server to set up the failover cluster.
Install Microsoft SQL Server on the local disk of the executing server that is part of the cluster. The failover cluster setup is started by selecting the Create a SQL Server failover cluster check box in the Components to Install dialog box. After the failover cluster setup has executed, add the standby server to Selected Nodes in the Cluster Node Configuration dialog box.
For details about how to install and set up Microsoft SQL Server, see the Microsoft SQL Server documentation.

When using Microsoft SQL Server 2000 in a cluster system
You must use the installation wizard of Microsoft SQL Server to set up the failover cluster.
Install Microsoft SQL Server in the local disk of the executing server that is part of the cluster. The failover cluster setup is started by choosing Virtual Server and specifying the name of the virtual server. After the failover cluster setup has executed, use Add Node to install Microsoft SQL Server in the local disk of the standby server. For details about installing and setting up Microsoft SQL Server, see the manual for the Microsoft SQL Server.
When you use Microsoft SQL Server in a cluster system environment, we recommend that you use TCP/IP for communication between Microsoft SQL Server and clients.

When using Microsoft SQL Server 7.0 in a cluster system
You must use the failover cluster wizard of Microsoft SQL Server to set up the clustering service.
Install Microsoft SQL Server in the local disk of the executing server that is part of the cluster. Then, use the failover cluster wizard to set up the clustering service. For details about installing and setting up Microsoft SQL Server, see the manual for the Microsoft SQL Server.

When using Oracle in a cluster system
Install Oracle Fail Safe Server and other software for configuring an Oracle server in the local disks of the executing server and standby server for which a cluster system is being created. Then, use Oracle Fail Safe Manager to set up the clustering service. Be sure to create an instance of an Oracle database on a shared disk. For details about setting up an Oracle cluster environment, see the manual for Oracle Fail Safe.

(3) Creating an environment for using a failover facility

This subsection describes how to create an environment for using the failover facility of JP1/Software Distribution.

(a) Install JP1/Software Distribution Manager on the executing server

Be sure to install and set up JP1/Software Distribution Manager and then set up Database Manager.

Some settings are not displayed, depending on the components to be installed. For the settings that are not listed in the tables below, set them as usual. For details about the installation, setup, and Database Manager settings, see the following chapters:

The following table shows the settings required when Server and Asset Information Manager Subset of JP1/Software Distribution Manager are installed:

Table 11-2 How to set up JP1/Software Distribution Manager

Program Item Setting Server AIM Setup#
Installation Type of JP1/Software Distribution Manager Choose Central manager. Y Y
Components to be installed Choose Server or Asset Information Manager Subset, whichever you will be using. Y Y
Installation directory setting Specify the local drive. Y Y
Database settings (when Microsoft SQL Server is used) If you have configured Microsoft SQL Server in a cluster system, specify the logical host name or logical IP address as the host name of the database server. Y Y
Database settings (when Oracle is used) If you have configured Oracle on a failover cluster system, specify the logical host name or logical IP address as the host name of the database server. Y Y
Package storage directory setting Specify a shared disk. Y --
Software operation history storage directory setting Specify a shared disk or network drive. Y --
Service setting (for new installation only) In Startup type, select Manual. Y --
Connection destination setting (Remote Installation Manager) Specify a logical host name or logical IP address. -- Y
Virtual directory setting for Asset Information Manager Subset Specify a shared disk. -- Y
Setup Cluster Settings page
  • Select the Use in a cluster system environment check box.
  • Specify JP1/Software Distribution Manager's logical host name with domain name.
Y --
Operation Monitoring page If you select the Compress and move the operation history to the storage directory radio button, specify a shared directory under Storage directory. Y --
Audit Log page If you select the Output audit logs check box, specify the local disk in Output directory for audit logs. Y --
SQL Server client network utility
(when Microsoft SQL Server is used)
Network library settings When connecting Microsoft SQL Server in a cluster system, use TCP/IP as the network library for connection. Use the SQL client setup utility to add an entry that uses the logical host name for Microsoft SQL Server. Y Y
Oracle Net8 Assistant or Net Manager
(when Oracle is used)
Create a net service name Create a net service name in the format NETM_logical-host-name.
If you have configured Oracle on a failover cluster system, specify the logical host name for the destination Oracle as the host name used in the address configuration.
Y --
Database Manager (for executing system only) Detailed database settings (for Microsoft SQL Server) Specify a shared disk for all database files. Y --
Detailed tablespace settings (for Oracle) Y --
Database Manager
(for Embedded RDB)
Edit HiRDB.ini (Computer on which Server Core facility is installed has more than one NIC) Specify a logical IP address as the client environment variable PDCLTRCVADDR in the files listed below.
JP1/Software-Distribution-installation-directory\Setup_Input\ini\HiRDB.ini
JP1/Software-Distribution-installation-directory\Setup_Input_HA\ini\HiRDB.ini
Y --
Cluster system environment settings Select the Use in a cluster system environment option, and then select Execution mode or Standby mode. Specify the logical host name and executing host name. Y --
Management database settings Specify a shared disk for the management database area path. Specify a local disk for the work table area path.
Use the same Automatically increase the size check box setting for both active and standby servers.
Y --
Detailed database settings Specify a shared disk for all database files. Y --
Asset Information Manager Subset environment setting (creation of data source or net service) (when Oracle is used) Net service creation If you have configured Oracle on a failover cluster system, specify the logical host name of the target Oracle for Server. -- Y
Asset Information Manager Subset environment setting (Database Manager) (execution mode only when Microsoft SQL Server or Oracle is used) Detailed database settings Specify a shared disk for all database files. -- Y
Asset Information Manager Subset environment setting (Database Manager) (when Embedded RDB is used) Cluster system settings Select the Use in a cluster system environment option, and then select Execution mode or Standby mode. Specify the logical host name and executing host name.
Specify the same port number for both active and standby servers.
-- Y
Detailed database settings Specify a shared disk for the storage folder name.
Specify the same Storage folder name and Size for both active and standby servers.
-- Y

Legend:
Y: Item that requires setting when the component is selected.
--: Item that does not require setting when the component is selected.

#: AIM Subset: Asset Information Manager Subset


If you have already constructed an environment for JP1/Software Distribution Manager for a configuration in which failover does not occur, open Control Panel, choose Administrative Tools, and Services, double-click the service Remote Install Server, and then change the startup type from Automatic to Manual.

If system restart is requested at the end of the installation procedure for JP1/Software Distribution Manager, restart the computer.

(b) Use Cluster Administrator to move the group.

The standby server becomes the owner of the group.

(c) Install JP1/Software Distribution Manager on the standby server

Construct an environment for the standby server. For details about the installation procedure and settings, see (a) Install JP1/Software Distribution Manager on the executing server.

(d) Use Cluster Administrator to move the group.

The standby server becomes the active of the group.

(e) Use Cluster Administrator to create a new JP1/Software Distribution Manager resource.

Tables 11-3 through 11-8 list and describe the settings.

Table 11-3 Resource settings when Server is used

Registered resource Item Setting
Remote Install Server Name Specify any name.
Resource type Set Generic Service.
Group Set the group name that was created by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
Executable owner Set the running system and standby system nodes.
Dependency
  • Set the network name and physical disk that were registered by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
  • If Microsoft SQL Server or Oracle is used and RDBMS is set to the same group, set the resources for RDBMS.
  • If Embedded RDB is used, set the resources for HiRDBClusterService_JN1 presented in Table 11-4.
Generic service parameter Remote Install Server
Registry copy#

For 32-bit OSs
SOFTWARE\HITACHI\NETM/DM

For 64-bit OSs
SOFTWARE\Wow6432Node\Hitachi\NETM/DM

#
The Failover Cluster Manager of Windows Server 2012 cannot perform the registry copy. In Windows Server 2012, use the Windows PowerShell commandlet. The following shows examples if you specify Remote Install Server for the generic service name.

To add the settings:
Add-ClusterCheckpoint -ResourceName "Remote Install Server" -RegistryCheckpoint SOFTWARE\Wow6432Node\Hitachi\NETM/DM

To check the settings:
Get-ClusterCheckpoint -ResourceName "Remote Install Server" -RegistryCheckpoint

To delete the settings:
Remove-ClusterCheckpoint -ResourceName "Remote Install Server" -RegistryCheckpoint

Table 11-4 Resource settings for HiRDB/ClusterService_JN1 when Embedded RDB is used

Registered resource Item Setting
HiRDBClusterService_JN1 Name Specify any name.
Resource type Set Generic Service.
Group Set the group name that was created by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
Executable owner Set the running system and standby system nodes.
Dependency Set the network name and physical disk that were registered by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
Generic service parameter HiRDBClusterService_JN1
Registry copy Not specified

Use Cluster Administrator to set the generic-service resource Remote Install Server to online. Thereafter, to stop and start the Remote Install Server service, use Cluster Administrator to set it to offline or online.

Table 11-5 Resource settings when Asset Information Manager Subset is used

Registered resource Item Setting
Asset Information Synchronous Service Name Specify any name.
Resource type Set Generic Service.
Group Set the group name that was created by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
Executable owner Set the running system and standby system nodes.
Dependency
  • Set the network name and physical disk that were registered by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
  • If Microsoft SQL Server or Oracle is used and RDBMS is set to the same group, set the resources for RDBMS.
  • If Embedded RDB is used, set the resources for HiRDBClusterService_AM1 presented in Table 11-6.
Generic service parameter AssetInformationSynchronousService
Registry copy Not specified

Table 11-6 Resource settings for HiRDB/ClusterService_AM1 when Embedded RDB is used

Registered resource Item Setting
HiRDBClusterService_AM1 Name Specify any name.
Resource type Set Generic Service.
Group Set the group name that was created by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
Executable owner Set the running system and standby system nodes.
Dependency Set the network name and physical disk that were registered by Cluster Administrator of Microsoft Cluster Service or Windows Server Failover Cluster.
Generic service parameter HiRDBClusterService_AM1
Registry copy Not specified

Table 11-7 Resource settings for Microsoft Internet Information Services when Asset Information Manager Subset is used (for Windows 2000 and Windows Server 2003)

Registered resource Item Setting
Microsoft Internet Information Services Name Specify any name.
Resource type Set the following value:

For Windows 2000
IIS Server Instance

Windows Server 2003
General-purpose script
Group Set the group name created by Microsoft Cluster Service's Cluster Administrator.
Executable owner Set the running system and standby system nodes.
Dependency Set the network name and physical disk registered by Microsoft Cluster Service's Cluster Administrator.
Parameter
(for Windows 2000)
Set to the service that is used for failover. In IIS, select the WWW radio button, and then select Default Web Site in the IIS Server combination box.
Script file path
(for Windows Server 2003)
Set the following value:
%systemroot%\System32\Inetsrv\Clusweb.vbs

Table 11-8 Resource settings for Microsoft Internet Information Services when Asset Information Manager Subset is used (for Windows 2008)

Resource type Content input to script file path Dependency
Generic script %systemroot%\System32\Inetsrv\Clusweb.vbs Set the Shared disk and Client access point resources.

#
By default, the script file (Clusweb.vbs) for setting resources in the Windows Server 2008 cluster environment is not installed. If the IIS6 Management Compatibility IIS script tool is installed by execution of a Microsoft Internet Information Services 7.0 role service, the script file is stored in the prescribed path (%systemroot%\System32\Inetsrv).
Therefore, the IIS script tool should be installed before setting resources in a cluster environment. For details about installation methods, see the Microsoft Internet Information Services manual. If you use Microsoft Internet Information Services 7.5 and install the IIS script tool of IIS 6 Management Compatibility, Clusweb.vbs will not be created. Refer to the Microsoft support information KB97059 on the web, and obtain the generic sample script.

(4) Creating an environment for a system directly under JP1/Software Distribution Manager

To set up an environment for a relay system or client immediately below JP1/Software Distribution Manager:

  1. In the TCP/IP definition, set the logical host name or IP address for JP1/Software Distribution Manager.
  2. Perform the setup.
    Specify the logical host name and logical IP address in the settings for the higher server at the connection destination.

(5) Specifying the connection destinations for using components

When you want to use the facilities of JP1/Software Distribution, specify the logical host name or logical IP address of the connection destination during installation.

The following table shows how to specify the connection destination for each component you use.

Table 11-9 Specifying the connection destinations for using components

Component Name of dialog box Setting
Server core facility Server Setup
(AIM page)
If you have constructed Asset Information Manager Subset on a failover cluster system, specify the connection-target logical host name or logical IP address in URL for Asset Information Manager.
Remote Installation Manager Specify Connection Destination
(installer)
For the connection destination of Remote Installation Manager, specify the logical host name or logical IP address.
Software Distribution Manager Logon
(Logon window)
Packager Specify Connection Destination Specify a logical host name or logical IP address for Packager's connection destination.

(6) Settings for an environment containing a firewall

When you use JP1/Software Distribution Manager in a cluster system configuration containing a firewall, specify the logical and physical addresses for the nodes that data passes through.

(7) Actions to be taken after a failover

The table below shows the actions that should be taken by the user in the event of a failover. If you use an Oracle cluster environment as a relational database environment, you can continue the application without re-connection due to a communication error.

Table 11-10 Actions to be taken by the user after a failover

No. When failover occurred Action to be taken after the failover
1 While starting the Inventory Viewer of Remote Installation Manager After a dialog box appears indicating a communication error or a database access error, reconnect to the JP1/Software Distribution server.
2 While registering a job After a dialog box appears indicating a communication error or a database access error, re-register the job.
3 While a job was waiting for execution Re-execute the job.
4 While a job was being executed (20%) Re-execute only the failed job (you do not need to take any action for a job waiting for execution, a job resulting in a startup error, a suspended job, a job placed in installation-rejecting status, a completed job, or a normally terminated job)
5 While re-executing a job that was executed at least 20% For jobs contained in the job execution status folder RETRY_RELAY_SYSTEM, perform steps 3 and 4.
6 After editing an ID group (adding/deleting the relay managing the ID, adding/deleting clients, or changing the password) For the jobs contained in the job execution status folder Edit ID Group, perform steps 3 and 4.
7 When the options that are enabled on the System Configuration page in JP1/Software Distribution Manager's Server Setup dialog box are Apply the system configuration information automatically and Linkage when system configuration is changed For jobs contained in the job execution status folder Edit System Configuration Information, perform steps 3 and 4.
8 While editing a job definition After a dialog box appears indicating a communication error or a database access error, re-create a new job definition. The job definition you were editing is invalid, so delete it.
9 While executing the CSV output utility After a dialog box appears indicating a communication error or a database access error, re-execute the job.
10 While executing Database Manager After a dialog box appears indicating a database access error, take appropriate action for the situation.
  • When a new database is being created:
    Delete the database and then re-execute the job.
  • While management files are being moved:
    Delete the database, re-create it, and then re-execute the job.
  • While the database is being restored:
    Restore the database from its backup and then re-execute the job.
  • While the database is being upgraded:
    Restore the database from its backup and then re-execute the job.
  • When a resource is being moved to a file system:
    Delete all the files from the package storage directory and then re-execute the job.
  • For other cases:
    Restart Database Manager.
11 While executing a command Re-execute the command that returned the communication error or connection error.
12 While the packager was packaging software After a dialog box appears indicating a communication error, use Remote Installation Manager to delete the failed packages and then re-execute packaging.
13 While a client was being registered into an ID group or being deleted from an ID group After a dialog box appears indicating a communication error, re-execute registration into the ID group or deletion from the ID group.
14 While Package Setup Manager was installing a package After the error is detected, reinstall the package.
15 While the Operation Log List window is displayed Close the Operation Log List window, and then re-display it.
16 While Data maintenance and Take operation history tasks are executing The tasks are cancelled. Re-execute the tasks.