4.1 Confirmation of Customization Items

The Management Server transaction needs the following items for customization. Confirm and prepare items required for a cluster transaction which you use.

Table 4.1 Items Required During Customization
Items	OS
Items	Windows	Solaris	Linux
Transaction name	Required	Required	Required
Logical IP address	Required	Required	Required
Shared disk for shared data	Required	Required	Required
Disk resource of shared disk for shared data	Required	Required	Required
Resource type	Unnecessary	Required	Required
Cluster name	Required	Unnecessary	Unnecessary
Network name	Required	Unnecessary	Unnecessary
Network for external connections	Required	Unnecessary	Unnecessary
IP address resource	Required	Unnecessary	Unnecessary
Installing user	Required	Unnecessary	Unnecessary
Logical node name	Required	Required	Required
Communication service/daemon port number for transaction	Required	Required	Required
Access volume	Required	Required	Required
Generic script	Required	Required	Required

Each item is explained below.

Transaction name

Name of cluster transaction.

Logical IP address

IP address for data communication with Web Console and Managed Servers.
It is recommended that you use a new logical IP address for ETERNUS SF Manager.

When allocating a new logical IP address, make sure that existing transactions use the IP address as a failover resource and that adding the IP address resource has no adverse effects on transactions.

If you use an existing logical IP address, share it with ETERNUS SF Manager in order to make sure that no trouble occurs with any other product already using this logical IP address.

Shared disk for shared data

Volume for storing shared data of ETERNUS SF Manager.
With regard to such factors as reliability and update performance, it is recommended that you use a new volume created only for ETERNUS SF Manager.

Note

When you specify a shared disk for shared data, be careful about the following points:

Define the shared disk for shared data as a shared disk of a clustered system.
Allocate a disk that does not use AdvancedCopy Manager to carry out backup and replication.
Allocate a disk that is not used by AdvancedCopy Manager CCM as a copy source, copy destination, or access volume.
On the shared disk for shared data, create a file system.
In order to be used by the file system, make the shared disk mountable.
Use a disk that is not used as a Quorum disk. (for Windows only)

Refer to "Required Disk Space for Operation" in "Operating Environment for ETERNUS SF Manager" in the Installation and Setup Guide for information on the disk space required for ETERNUS SF Manager.

Disk resource of shared disk for shared data

Disk resource name of shared disk for shared data.

Resource type

Cmdline resource for registering scripts that start or stop services/daemons (generic scripts).

Cluster name

Cluster name specified in Windows Server Failover Clustering.

Network name

Dedicated network name for ETERNUS SF Manager that is specified when using a new logical IP address.
ETERNUS SF Manager creates a network resource under this network name.

Network for external connections

Network name for external communication specified in Windows Server Failover Clustering, to be specified when using a new logical IP address.

IP address resource

IP address resource name in which logical IP address is set up, to be specified when using an already existing logical IP address.

Installing user

User name and password that were used when installing ETERNUS SF Manager.

Logical node name

Name of logical server for AdvancedCopy Manager.
The user can freely set any logical node name, consisting of alphanumeric characters up to 8 bytes.

In order to determine to which cluster transaction an executed AdvancedCopy Manager function (e.g. backup management command) belongs, AdvancedCopy Manager assigns a unique name (logical node name) to each cluster transaction. If you specify this logical node name in the environment variable SWSTGNODE and execute an AdvancedCopy Manager command, the executed command identifies the applicable cluster transaction and carry out processing accordingly.

When "Logical IP address" and "Communication service/daemon port number for transaction" (stgxfws_logicalNodeName) are set in the processing for adding the AdvancedCopy Manager server, the applicable cluster transaction is added as a server of AdvancedCopy Manager.

Note

13-character strings of the following list cannot be made into a logical node name for PRIMECLUSTER:
audit, cluster, cmdevs, config, daemon, data, java, log, pid, report, samp, sh, tmp

Communication service/daemon port number for transaction

Port number allocated to the communication service/daemon for transactions of AdvancedCopy Manager. Note that the same port number needs to be specified on both the primary and secondary nodes.
Specify the unused number (the number not used for ports of other daemons/services) between 1024 and 65535.

Point

Ensure that the port number of the communication service/daemon for transaction is different from the port number of the communication service/daemon for local transaction or the other communication services/daemons for transaction.

Access volume

This is a volume for issuing Advanced Copy from the CCM Server to ETERNUS Disk storage systems.
It is required for issuing Advanced Copy to ETERNUS Disk storage systems that operate with Copy command via SAN.

From among the logical volumes in the ETERNUS Disk storage system to be backed up for AdvancedCopy Manager CCM, connect one logical volume as an access volume to all nodes making up a clustered system.

For Windows
Make the environment settings for the connected logical volume so as to allow access from all nodes making up a clustered system to the same physical disk number (Disk # displayed on the disk management screen).
For Solaris or Linux
Make the environment settings for the connected logical volume so as to allow access from all nodes making up a clustered system to the same physical device name.

Point

When specify a device file of ETERNUS Multipath Driver to an access volume in Solaris or Linux, setup the device file name and system. Refer to the ETERNUS Multipath Driver manual for details.

Generic script

Script for starting or stopping services/daemon.

For Windows

Create generic script files for starting and stopping the following services:

Generic script for ETERNUS SF Manager Apache Service / Tomcat Service
Generic script for AdvancedCopy Manager CCM

Information

As generic script samples, the following files are stored in the programDir\Common\sample\cluster directory.
The programDir is "Program Directory" specified at the ETERNUS SF Manager installation.

File Name	Explanation
esfmanager-web.vbs	Sample file of generic script for ETERNUS SF Manager Apache Service
esfmanager-tomcat.vbs	Sample file of generic script for ETERNUS SF Manager Tomcat Service
esfmanager-ccm.vbs	Sample file of generic script for AdvancedCopy Manager CCM

When using the above files, make sure to copy them to a different directory and use the copied file.

Generic Script for ETERNUS SF Manager Apache Service / Tomcat Service

Create the following script file separately for each service. You can freely specify any file name, but the file extension must be ".vbs".

Specify the corresponding service name (either "esfmanagerweb" or "esfmanagertomcat") for serviceName in the script.

Function Online()

    Dim objWmiProvider
    Dim objService
    Dim strServiceState

    ' Check to see if the service is running
    set objWmiProvider = GetObject("winmgmts:/root/cimv2")
    set objService = objWmiProvider.get("win32_service='serviceName'")
    strServiceState = objService.state

    If ucase(strServiceState) = "RUNNING" Then
        Online = True
    Else

        ' If the service is not running, try to start it.
        response = objService.StartService()

        ' response = 0 or 10 indicates that the request to start was accepted
        If ( response <> 0 ) and ( response <> 10 ) Then
            Online = False
        Else
            Online = True
        End If
    End If
End Function

Function Offline()

    Dim objWmiProvider
    Dim objService
    Dim strServiceState

    ' Check to see if the service is running
    set objWmiProvider = GetObject("winmgmts:/root/cimv2")
    set objService = objWmiProvider.get("win32_service='serviceName'")
    strServiceState = objService.state

    If ucase(strServiceState) = "RUNNING" Then

        response = objService.StopService()

        If ( response <> 0 ) and ( response <> 10 ) Then
            Offline = False
        Else
            Offline = True
        End If
    Else
            Offline = True
    End If
End Function

Function Terminate()
    
    Dim objWmiProvider
    Dim objService
    
    ' Stopping the service
    set objWmiProvider = GetObject("winmgmts:/root/cimv2")
    set objService = objWmiProvider.get("win32_service='serviceName'")
    response = objService.StopService()
    
    Resource.LogInformation "Terminate Stop Response: " & response
    
    Terminate = True
End Function

Function LooksAlive()

    Dim objWmiProvider
    Dim objService
    Dim strServiceState

    set objWmiProvider = GetObject("winmgmts:/root/cimv2")
    set objService = objWmiProvider.get("win32_service='serviceName'")
    strServiceState = objService.state

    if ucase(strServiceState) = "RUNNING" Then
        LooksAlive = True
    Else
        LooksAlive = False
    End If
End Function

Function IsAlive()

    Dim objWmiProvider
    Dim objService
    Dim strServiceState

    set objWmiProvider = GetObject("winmgmts:/root/cimv2")
    set objService = objWmiProvider.get("win32_service='serviceName'")
    strServiceState = objService.state

    if ucase(strServiceState) = "RUNNING" Then
        IsAlive= True
    Else
        IsAlive = False
    End If

End Function

Generic Script for AdvancedCopy Manager CCM

This is a script for stopping the management service of AdvancedCopy Manager CCM.

Before the shared disk for shared data goes offline, the following service must be stopped:
In order to stop this service, create a generic script file that executes the "acservice stop" command with the -lan option. Refer to "Command References" in the AdvancedCopy Manager Operation Guide for Copy Control Module for information on the command.

Management service of ETERNUS SF AdvancedCopy Manager CCM

Below is an example of a generic script file. You can freely specify any file name, but the file extension must be ".vbs".

For installDir in the script, specify the directory in which ETERNUS SF Manager is installed.

Dim WshShell
Set WshShell = CreateObject("WScript.Shell")

Function Open( )
    Open = True
End Function

Function Online( )
    Online = True
End Function

Function LooksAlive( )
    LooksAlive = True
End Function

Function IsAlive( )
    IsAlive = True
End Function

Function Offline( )
    Resource.LogInformation "--- start offline ---"
    Set oExec = WshShell.Exec("installDir\CCM\bin\acservice.exe stop -lan")
    Resource.LogInformation oExec.StdOut.ReadAll
    Resource.LogInformation oExec.StdErr.ReadAll
    Resource.LogInformation "--- end offline ---"
    Offline = True
End Function

Function Close( )
    Close = True
End Function

Function Terminate( )
    Terminate = True
End Function

For Solaris or Linux

Create generic scripts (Start/Stop/Check) for the following daemons:

Generic script for ETERNUS SF Manager Apache daemon / Tomcat daemon / Postgres daemon
Generic script for AdvancedCopy Manager CCM
Generic script for AdvancedCopy Manager daemon

Information

As generic script samples, the following files are stored in the "/opt/FJSVesfcm/sample/cluster" directory.

File Name	Explanation
EsfCmdline-Start	Sample file of Start script for ETERNUS SF Manager Apache daemon / Tomcat daemon / Postgres daemon
EsfCmdline-Stop	Sample file of Stop script for ETERNUS SF Manager Apache daemon / Tomcat daemon / Postgres daemon
EsfCmdline-Check	Sample file of Check script for ETERNUS SF Manager Apache daemon / Tomcat daemon / Postgres daemon
CcmCmdline	Sample file of generic script for AdvancedCopy Manager CCM
AcmCmdline	Sample file of generic script for AdvancedCopy Manager daemon

When using the above files, make sure to copy them to a different directory and use the copied file.

Generic Script for ETERNUS SF Manager Apache Daemon / Tomcat Daemon / Postgres Daemon

Create the generic scripts according to the following settings. Specify the unique names to the files.

Type	Owner	Group	Access Permission
Start script	root	root	544
Stop script	root	root	544
Check script	root	root	544

[Start script]

#!/bin/sh

#
# ETERNUS SF Manager daemon start for PRIMECLUSTER
#

/opt/FJSVesfcm/bin/startSFmanager start
if [ $? -ne 0 ]; then
    exit 1
fi

exit 0

[Stop script]

#!/bin/sh

#
# ETERNUS SF Manager daemon stop for PRIMECLUSTER
#

/opt/FJSVesfcm/bin/startSFmanager stop
if [ $? -ne 0 ]; then
    exit 1
fi

exit 0

[Check script]

For Solaris

#!/bin/sh

#
# ETERNUS SF Manager Check script for PRIMECLUSTER
#

PATH=/bin:/usr/bin:/sbin:/usr/sbin
export PATH

check_postgres()
{
    ps -ef | grep '/opt/FJSVesfcm/postgres/bin/postgres' | grep -v grep > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        return 1
    fi

    return 0
}

check_apache()
{
    ps -ef | grep '/opt/FJSVesfcm/apache/bin/httpd' | grep -v grep > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        return 1
    fi;

    return 0
}

check_tomcat()
{
    ps -ef | grep '/opt/FJSVesfcm/JRE/bin/java' | grep 'FJSVesfcm' | grep -v grep > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        return 1
    fi;

    return 0

}

for EXEC in check_postgres check_apache check_tomcat
do
    eval $EXEC
    if [ $? -ne 0 ]; then
        exit 1
    fi
done

exit 0

For Linux

#!/bin/sh

#
# ETERNUS SF Manager Check script for PRIMECLUSTER
#

PATH=/bin:/usr/bin:/sbin:/usr/sbin
export PATH

check_postgres()
{
    ps -ef --cols 90 | grep '/opt/FJSVesfcm/postgres/bin/postgres' | grep -v grep > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        return 1
    fi

    return 0
}

check_apache()
{
    ps -ef --cols 90 | grep '/opt/FJSVesfcm/apache/bin/httpd' | grep -v grep > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        return 1
    fi;

    return 0
}

check_tomcat()
{
    ps -ef --cols 90 | grep '/opt/FJSVesfcm/JRE/bin/java' | grep 'FJSVesfcm' | grep -v grep > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        return 1
    fi;

    return 0

}

for EXEC in check_postgres check_apache check_tomcat
do
    eval $EXEC
    if [ $? -ne 0 ]; then
        exit 1
    fi
done

exit 0

Generic Script for AdvancedCopy Manager CCM

This is a script for stopping the management service of AdvancedCopy Manager CCM.

Management service of ETERNUS SF AdvancedCopy Manager CCM

The example of creating script as the Start/Stop script for PRIMECLUSTER Cmdline resource is shown below.

#!/bin/sh

case $1 in
'start')
        exit 0 ;;
'stop' )
        /opt/FJSVccm/bin/acservice stop -lan
        exit 0 ;;
esac

For register a Cmdline resource, specify "start" to the argument for the Start script, specify "stop" to the argument for the Stop script.
Refer to your cluster software manuals for creating procedure of Start/Stop script.

Generic Script for AdvancedCopy Manager Daemon

It is the script to start/stop the AdvancedCopy Manager daemon from the cluster application (transaction). Read the following explanation and create the start/stop script file for the AdvancedCopy Manager daemon.

Processing when starting cluster transactions

Configure the script so that AdvancedCopy Manager service of the Management Server transaction starts.
Configure the script so that the AdvancedCopy Manager service start command (/opt/FJSVswstf/cluster/MgrStart) is executed when the cluster transaction starts.

Point

In order to have the AdvancedCopy Manager service start command executed, specify the logical node name of the Management Server transaction to be started in the environment variable SWSTGNODE.

Note

Some cluster software requires a notification of start process result. If the process result notification is required, based on the exit status of the AdvancedCopy Manager service start command, configure an appropriate value to notify the cluster software.

Information required for starting the AdvancedCopy Manager service is as follows.

Item	Explanation
Environment variable SWSTGNODE	Logical node name
Name of AdvancedCopy Manager service start command	/opt/FJSVswstf/cluster/MgrStart
Exit status of AdvancedCopy Manager service start command	Completed successfully: 0 Terminated abnormally: 1

Processing when stopping cluster transactions

Configure the script so that AdvancedCopy Manager service of the Management Server transaction stops.
Configure the script so that the AdvancedCopy Manager service stop command (/opt/FJSVswstf/cluster/MgrStop) is executed when the cluster transaction stops.

Point

In order to have the AdvancedCopy Manager service stop command executed, specify the logical node name of the Management Server transaction to be stopped in the environment variable SWSTGNODE.

Note

Some cluster software requires a notification of stop process result. If the process result notification is required, based on the exit status of the AdvancedCopy Manager service stop command, configure an appropriate value to notify the cluster software.

Information required for stopping the AdvancedCopy Manager service is as follows.

Item	Explanation
Environment variable SWSTGNODE	Logical node name
Name of AdvancedCopy Manager service stop command	/opt/FJSVswstf/cluster/MgrStop
Exit status of AdvancedCopy Manager service stop command	Completed successfully: 0 Terminated abnormally: 1

Example

The example of creating script as the Start/Stop script for PRIMECLUSTER Cmdline resource is shown below.

#!/bin/sh
SWSTGNODE=acmnode1
export SWSTGNODE

case $1 in
'start')
        /opt/FJSVswstf/cluster/MgrStart
        exit 0 ;;
'stop' )
        /opt/FJSVswstf/cluster/MgrStop
        exit 0 ;;
esac