Adding a replication server to a grid by cloning

You can add a new server to a grid by cloning an existing replication server in the grid.

Before you begin

The server you are adding to the grid must have the same hardware and operating system as the source server that you are cloning.

Procedure

To add a server to a grid:
Clone an existing replication server in the grid by using the ifxclone utility with the --disposition=ER option. This process is described in Adding a server to the domain by cloning a server.

Example

The following example adds a fifth server, named serv5, to an existing replication domain and to a grid named grid1. The server serv1 is used as the source server.

  1. On the serv1 server, set the value of the ENABLE_SNAPSHOT_COPY configuration parameter to 1 in the onconfig file.
  2. On the serv5 servers, complete the ifxclone prerequisites for all servers, such as setting the required configuration parameters and environment variables.

    Set these environment variables:

    • INFORMIXDIR
    • INFORMIXSERVER
    • INFORMIXSQLHOSTS
    • ONCONFIG

    Set these configuration parameters to the same values on the serv5 server as on the serv1 server:

    • DRAUTO
    • DRINTERVAL
    • DRTIMEOUT
    • LOGBUFF
    • LOGFILES
    • LOGSIZE
    • LTAPEBLK
    • LTAPESIZE
    • ROOTNAME
    • ROOTSIZE
    • PHYSBUFF
    • PHYSFILE
    • STACKSIZE
    • TAPEBLK
    • TAPESIZE
  3. On the serv5 server, create all of the chunks that exist on the serv1 server.
  4. On the serv5 server, run the ifxclone command with the --disposition=ER option to clone the data and the configuration of the serv1 server onto the serv5 server and the --createchunkfile command to create the necessary chunks:
    ifxclone --trusted --source=serv1 --sourceIP=111.222.333.444 
--sourcePort=1230 --target=serv5 --targetIP=111.222.333.777 
--targetPort=1234 --disposition=ER --createchunkfile
    ifxclone --trusted --source=serv1 --sourceIP=111.222.333.444 
--sourcePort=1230 --target=serv5 --targetIP=111.222.333.777 
--targetPort=1234 --disposition=ER
  5. Edit the sqlhosts files on all five servers in the domain so that they each have the following information:
    #dbservername   nettype   hostname              servicename   options
gserv1          group     -                     -             i=143
serv1           ontlitcp  ny.usa.com            1230          g=gserv1
gserv2          group     -                     -             i=144
serv2           ontlitcp  tokyo.japan.com       1231          g=gserv2
gserv3          group     -                     -             i=145
serv3           ontlitcp  rome.italy.com        1232          g=gserv3
gserv4          group     -                     -             i=146
serv4           ontlitcp  perth.australia.com   1233          g=gserv4
gserv5          group     -                     -             i=147
serv5           ontlitcp  helsinki.finland.com  1234          g=gserv5

The server serv5 is automatically added to the grid grid1.