ETERNUS SF Storage Cruiser V16.9.1 / AdvancedCopy Manager V16.9.1 Cluster Environment Setup Guide

8.2.2 Customization Procedure

Follow the procedure below to set up a Managed Server transaction.

Point

For explanatory purposes, the command execution examples in this section use the following settings:

• <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>: /acmdata01

• Logical node name: acmnode1

Note

Perform the procedures by root (super user).

1. Restart the system.

   Restart all primary and secondary nodes that create Managed Server transactions.

2. If you add a Managed Server transaction to an existing cluster transaction, stop the cluster transaction.

   Refer to your cluster software manuals for the procedure for stopping cluster transactions.

3. Customize the primary node.

   On the primary node, perform from step a to step j.

   1. Mount the shared disk.

      Mount the shared disk for shared data of AdvancedCopy Manager.

   2. Register port numbers.

      Use the "vi" command etc. of OS, and describe the port number and the following service name of the transaction communication daemon in /etc/services file.

      • Transaction communication daemon: stgxfws_logicalNodeName

      Note

      Describe the same port number on the primary node and all secondary nodes.
      Specify the same value as Swstgnode in "Table 8.2 Setting Items of swcluster.ini File" for logicalNodeName.

   3. Edit the /opt/FJSVswstf/cluster/swcluster.ini file.

      Table 8.1 Setting Items of swcluster.ini File

      Item Name	Explanation
      Env_N	Logical node name. Specify the same value as Swstgnode in "Table 8.2 Setting Items of swcluster.ini File". For N, specify a non-duplicate value from 1 to 20.
      BusiType	AdvancedCopy Manager server type. Specify "2".
      Business	Name of cluster transaction.
      ShareEtc	Name of the environment setting directory for cluster transactions. <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt
      ShareVar	Name of working directory for cluster transactions. <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt
      MountPoint	Mount point of shared disk for shared data of AdvancedCopy Manager.
      NodeName	Name of primary node (Host name of primary node).

      Modify or add the portions in italics according to your system environment.

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_N=<Logical node name>
      [<Logical node name>]
      Type=Primary
      BusiType=<AdvancedCopy Manager server type>
      Business=<Name of cluster transaction>
      ShareEtc=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt
      ShareVar=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt
      MountPoint=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=<Name of primary node (Host name of primary node)>
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

      Example

      When creating the first cluster transactions on the same server, the example for editing the swcluster.ini file is as follows.

      [Before editing]

      [ClusterCommon]
      Cluster=OFF
      Max=20
      StartTimeOut=300
      StopTimeOut=300

      [After editing]

      The italicized portions are the changes and additions to the original file.

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_1=acmnode1
      [acmnode1]
      Type=Primary
      BusiType=2
      Business=acmbiz01
      ShareEtc=/acmdata01/etc/opt
      ShareVar=/acmdata01/var/opt
      MountPoint=/acmdata01
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

      Example

      When cluster transactions have already been created on the same server, the example for editing the swcluster.ini file is as follows.

      [Before editing]

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_2=acmnode2
      [acmnode2]
      Type=Primary
      BusiType=2
      Business=acmbiz02
      ShareEtc=/acmdata02/etc/opt
      ShareVar=/acmdata02/var/opt
      MountPoint=/acmdata02
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

      [After editing]

      The italicized portions are the additions to the original file.

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_2=acmnode2
      Env_1=acmnode1
      [acmnode2]
      Type=Primary
      BusiType=2
      Business=acmbiz02
      ShareEtc=/acmdata02/etc/opt
      ShareVar=/acmdata02/var/opt
      MountPoint=/acmdata02
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure
      [acmnode1]
      Type=Primary
      BusiType=2
      Business=acmbiz01
      ShareEtc=/acmdata01/etc/opt
      ShareVar=/acmdata01/var/opt
      MountPoint=/acmdata01
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

   4. Create directories on the shared disk for shared data of AdvancedCopy Manager.

      Create each directory in below structure.

      <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>
      +---/etc
      |   ---/opt
      |       ---/swstorage
      +---/var
          ---/opt
              ---/swstorage

      Example

      The example of creating directories is as follows.

      # mkdir -p /acmdata01/etc/opt/swstorage
      # chmod -R 755 /acmdata01/etc/opt/swstorage
      # chown -R root:root /acmdata01/etc/opt/swstorage
      # mkdir -p /acmdata01/var/opt/swstorage
      # chmod -R 755 /acmdata01/var/opt/swstorage
      # chown -R root:root /acmdata01/var/opt/swstorage

   5. Create the <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt/swstorage/clsetup.ini file.

      Table 8.2 Setting Items of swcluster.ini File

      Item Name	Explanation
      Swstgnode	Logical node name. Use only alphanumeric characters up to 8 bytes for logical node name. Refer to "Logical node name" in "7.3 Confirmation of Customization Items" about other restrictions for logical node name.
      Business	Name of cluster transaction.
      ShareEtc	Name of the environment setting directory for cluster transactions. <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt
      ShareVar	Name of working directory for cluster transactions. <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt
      MountPoint	Mount point of shared disk for shared data of AdvancedCopy Manager.
      NodeName	Name of primary node (Host name of primary node).
      BusiType	AdvancedCopy Manager server type. Specify "2".
      Type
      Version	Version of AdvancedCopy Manager. Specify the same value as for the [Common]-"Version" character string in the /etc/opt/swstorage/swstg.ini file.
      Language	Language used for AdvancedCopy Manager. Specify one of the following text strings according to the language to be used for AdvancedCopy Manager: For Japanese: JAPANESE For English: ENGLISH

      Modify the portions in italics according to your system environment.

      [Cluster]
      System=GEN
      Swstgnode=<Logical node name>
      Business=<Name of cluster transaction>
      ShareEtc=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt
      ShareVar=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt
      MountPoint=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=<Name of primary node (Host name of primary node)>
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      BusiType=<AdvancedCopy Manager server type>
      ResourceType=Procedure
      [StorageMGR]
      Version=<Version of AdvancedCopy Manager>
      Edition=EE
      Type=<AdvancedCopy Manager server type>
      AFSType=1
      Language=<Language used for AdvancedCopy Manager>
      [Secondary]
      Setup=YES
      Date=00/00/00 00:00:00
      [Primary]
      Date=00/00/00 00:00:00
      Setup=YES

      Example

      The example for editing the clsetup.ini file is as follows. The italicized portions are the changes to the original file.

      [Cluster]
      System=GEN
      Swstgnode=acmnode1
      Business=acmbiz01
      ShareEtc=/acmdata01/etc/opt
      ShareVar=/acmdata01/var/opt
      MountPoint=/acmdata01
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      BusiType=2
      ResourceType=Procedure
      [StorageMGR]
      Version=V16.9.1
      Edition=EE
      Type=2
      AFSType=1
      Language=ENGLISH
      [Secondary]
      Setup=YES
      Date=00/00/00 00:00:00
      [Primary]
      Date=00/00/00 00:00:00
      Setup=YES

   6. Copy the /etc/opt/swstorage/swstg.ini file.

      Copy the swstg.ini file to the following copy destination.

      Copy Source File	Copy Destination File
      /etc/opt/swstorage/swstg.ini	<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt/swstorage/swstg.ini

      Example

      The copy execution example is as follows.

      # cp -p /etc/opt/swstorage/swstg.ini /acmdata01/etc/opt/swstorage/swstg.ini

   7. Edit the <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt/swstorage/swstg.ini file.

      Table 8.3 Setting Items of swstg.ini File

      Item Name	Explanation
      Type	AdvancedCopy Manager server type. Specify "2".

      Note

      After starting operation, the program in this product may add/modify/delete parameters other than those of "Table 8.3 Setting Items of swstg.ini File" for the swstg.ini file. For this reason, do not add/modify/delete parameters other than those of "Table 8.3 Setting Items of swstg.ini File".

      Modify the portions in italics according to your system environment.

      [Common]
      Edition=EE
      Version=V16.9.1
      Type=<AdvancedCopy Manager server type>
      AFSType=1
      Language=ENGLISH
      BaseDir_Opt=/opt
      BaseDir_Var=/var/opt
      BaseDir_Etc=/etc/opt
      [Install]
      FJSVswstf=20101116
      FJSVswtrc=20101116
      FJSVgrapi=20101116
      FJSVswsts=20101116
      FJSVswsrp=20101116

      Example

      The example for editing the swstg.ini file is as follows. The italicized portions are the changes to the original file.

      [Common]
      Edition=EE
      Version=V16.9.1
      Type=2
      AFSType=1
      Language=ENGLISH
      BaseDir_Opt=/opt
      BaseDir_Var=/var/opt
      BaseDir_Etc=/etc/opt
      [Install]
      FJSVswstf=20101116
      FJSVswtrc=20101116
      FJSVgrapi=20101116
      FJSVswsts=20101116
      FJSVswsrp=20101116

   8. Create symbolic links to the directories in the shared disk for shared data of AdvancedCopy Manager.

      Specify the same value as Swstgnode in "Table 8.2 Setting Items of swcluster.ini File" for logicalNodeName of link target directories.

      Link Source Directory	Link Target Directory (Symbolic Link File)
      <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt/swstorage	/etc/opt/swstorage/logicalNodeName
      <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt/swstorage	/var/opt/swstorage/logicalNodeName

      Example

      The example of creating symbolic links is as follows.

      # ln -s /acmdata01/etc/opt/swstorage /etc/opt/swstorage/acmnode1
      # ln -s /acmdata01/var/opt/swstorage /var/opt/swstorage/acmnode1

   9. Prepare a generic script.

      Follow the procedure below to prepare a generic script to be used on the primary node.

      1. In the AdvancedCopy Manager's agent program directory on the primary node, store the generic script file that you created in "7.3 Confirmation of Customization Items".

      2. Set up the access privilege for the stored generic script file.

         Specify the authority that the root (super user) can access.

   10. Execute the following commands in the given sequence.

       Sequence of Execution	Command Name
       1	"clset_FJSVswstf" command
       2	"clset_FJSVswsts" command
       3	"clset_FJSVswsrp" command

       Example

       The command execution example is as follows.

       # /opt/FJSVswstf/bin/clset_FJSVswstf -f /acmdata01/etc/opt/swstorage/clsetup.ini -t Primary
       clset_FJSVswstf completed
       # /opt/FJSVswsts/bin/clset_FJSVswsts -f /acmdata01/etc/opt/swstorage/clsetup.ini -t Primary
       clset_FJSVswsts completed
       # /opt/FJSVswsrp/bin/clset_FJSVswsrp -f /acmdata01/etc/opt/swstorage/clsetup.ini -t Primary
       clset_FJSVswsrp completed

   11. Unmount the shared disk.

       Unmount the shared disk for shared data of AdvancedCopy Manager.

4. Customize the secondary nodes.

   On the secondary node A, perform from step a to step f.
   In addition, if you use a Cascade system or a Priority Transfer system, perform from step a to step f on the secondary node B.

   1. Mount the shared disk.

      Mount the shared disk for shared data of AdvancedCopy Manager.

   2. Register port numbers.

      Use the "vi" command etc. of OS, and describe the port number and the following service name of the transaction communication daemon in /etc/services file.

      • Transaction communication daemon: stgxfws_logicalNodeName

      Note

      Describe the same port number on the primary node and all secondary nodes.
      Specify the same value as Swstgnode in "Table 8.2 Setting Items of swcluster.ini File" for logicalNodeName.

   3. Edit the /opt/FJSVswstf/cluster/swcluster.ini file.

      Table 8.4 Setting Items of swcluster.ini File

      Item Name	Explanation
      Env_N	Logical node name. Specify the same value as Swstgnode in "Table 8.2 Setting Items of swcluster.ini File". For N, specify a non-duplicate value from 1 to 20.
      BusiType	AdvancedCopy Manager server type. Specify "2".
      Business	Name of cluster transaction.
      ShareEtc	Name of the environment setting directory for cluster transactions. <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt
      ShareVar	Name of working directory for cluster transactions. <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt
      MountPoint	Mount point of shared disk for shared data of AdvancedCopy Manager.
      NodeName	Name of primary node (Host name of primary node).

      Modify or add the portions in italics according to your system environment.

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_N=<Logical node name>
      [<Logical node name>]
      Type=Secondary
      BusiType=<AdvancedCopy Manager server type>
      Business=<Name of cluster transaction>
      ShareEtc=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt
      ShareVar=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt
      MountPoint=<Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=<Name of primary node (Host name of primary node)>
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

      Example

      When creating the first cluster transactions on the same server, the example for editing the swcluster.ini file is as follows.

      [Before editing]

      [ClusterCommon]
      Cluster=OFF
      Max=20
      StartTimeOut=300
      StopTimeOut=300

      [After editing]

      The italicized portions are the changes and additions to the original file.

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_1=acmnode1
      [acmnode1]
      Type=Secondary
      BusiType=2
      Business=acmbiz01
      ShareEtc=/acmdata01/etc/opt
      ShareVar=/acmdata01/var/opt
      MountPoint=/acmdata01
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

      Example

      When cluster transactions have already been created on the same server, the example for editing the swcluster.ini file is as follows.

      [Before editing]

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_2=acmnode2
      [acmnode2]
      Type=Secondary
      BusiType=2
      Business=acmbiz02
      ShareEtc=/acmdata02/etc/opt
      ShareVar=/acmdata02/var/opt
      MountPoint=/acmdata02
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

      [After editing]

      The italicized portions are the additions to the original file.

      [ClusterCommon]
      Cluster=ON
      Max=20
      StartTimeOut=300
      StopTimeOut=300
      System=GEN
      Env_2=acmnode2
      Env_1=acmnode1
      [acmnode2]
      Type=Secondary
      BusiType=2
      Business=acmbiz02
      ShareEtc=/acmdata02/etc/opt
      ShareVar=/acmdata02/var/opt
      MountPoint=/acmdata02
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure
      [acmnode1]
      Type=Secondary
      BusiType=2
      Business=acmbiz01
      ShareEtc=/acmdata01/etc/opt
      ShareVar=/acmdata01/var/opt
      MountPoint=/acmdata01
      IPAddr=
      IPUseType=0
      IPRscName=
      Hostname=
      NodeName=m40001
      ClusterName=
      DiskName=
      GroupName=
      SubNetMask=
      MSCSNetName=
      Date=00/00/00 00:00:00
      Setup=YES
      ResourceType=Procedure

   4. Create symbolic links to the directories in the shared disk for shared data of AdvancedCopy Manager.

      Specify the same value as Swstgnode in "Table 8.2 Setting Items of swcluster.ini File" for logicalNodeName of link target directories.

      Link Source Directory	Link Target Directory (Symbolic Link File)
      <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc/opt/swstorage	/etc/opt/swstorage/logicalNodeName
      <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var/opt/swstorage	/var/opt/swstorage/logicalNodeName

      Example

      The example of creating symbolic links is as follows.

      # ln -s /acmdata01/etc/opt/swstorage /etc/opt/swstorage/acmnode1
      # ln -s /acmdata01/var/opt/swstorage /var/opt/swstorage/acmnode1

   5. Prepare a generic script.

      Follow the procedure below to prepare a generic script to be used on the secondary node.

      1. In the AdvancedCopy Manager's agent program directory on the secondary node, store the generic script file that you created in "7.3 Confirmation of Customization Items".

      2. Set up the access privilege for the stored generic script file.

         Specify the authority that the root (super user) can access.

   6. Execute the following commands in the given sequence.

      Sequence of Execution	Command Name
      1	"clset_FJSVswstf" command
      2	"clset_FJSVswsts" command
      3	"clset_FJSVswsrp" command

      Example

      The command execution example is as follows.

      # /opt/FJSVswstf/bin/clset_FJSVswstf -f /acmdata01/etc/opt/swstorage/clsetup.ini -t Secondary
      clset_FJSVswstf completed
      # /opt/FJSVswsts/bin/clset_FJSVswsts -f /acmdata01/etc/opt/swstorage/clsetup.ini -t Secondary
      clset_FJSVswsts completed
      # /opt/FJSVswsrp/bin/clset_FJSVswsrp -f /acmdata01/etc/opt/swstorage/clsetup.ini -t Secondary
      clset_FJSVswsrp completed

   7. Unmount the shared disk.

      Unmount the shared disk for shared data of AdvancedCopy Manager.

5. On the primary node, create a cluster transaction and resources.

   Refer to your cluster software manuals for the procedure for creating them.

6. On the primary node, register the AdvancedCopy Manager service to your cluster software.

   Set the script that was prepared in step 3-i in your cluster software so as to enable the AdvancedCopy Manager service to be started and stopped with the Managed Server transactions.
   Refer to your cluster software manuals for the setup methods.

   Point

   To get the AdvancedCopy Manager service start command executed, configure your cluster software so that all of the following conditions are fulfilled:
   In addition, the first and second conditions must be configured as a resource dependency.

   • Data communication is possible with the failover IP address for AdvancedCopy Manager.

   • The file system in the shared disk for shared data of AdvancedCopy Manager is mounted.

   • The logical node name of the Managed Server transactions is set to the environment variable SWSTGNODE.

   Example

   The example of creating a generic 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/AgtStart
           exit 0 ;;
   'stop' )
           /opt/FJSVswstf/cluster/AgtStop
           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.

   Register the following resources as cluster resources to the cluster transaction.

   • Failover IP address for AdvancedCopy Manager

   • Shared disk for shared data of AdvancedCopy Manager

   In addition, register cluster resources so that the file system in the shared disk for shared data of AdvancedCopy Manager is mounted when starting the cluster transaction.

7. On the primary node, start the AdvancedCopy Manager service that has been registered to the cluster software.

8. On the primary node, back up the environment.

   As a safeguard against accidental loss of data or file corruption, using the "cp" command etc. of OS, back up the following directories in the shared disk for shared data of AdvancedCopy Manager:

   • <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/etc

   • <Mountpoint-of-shared-disk-for-shared-data-of-AdvancedCopy-Manager>/var

The customization is completed.