Setting Up a Planned Cutover to a Mirror Grid

A cutover is a point in time when you transition from the primary grid to a mirror grid. A planned cutover is when the transition is planned and when the original primary grid does not fail completely.

Procedure
1. Stop writes to the primary grid (maintenance mode can be used to achieve this).
2. Ensure that a final checkpoint is taken (this can be manual or periodic) after the writes have been completed at the primary grid.
3. Ensure that the final checkpoint has been successfully mirrored to the mirror grid with the following command:

   tibdg -r http://rs1:8080 -g DR1 checkpoint list

   This command lists the checkpoint ID, the name of the checkpoint, the location of the checkpoint, and the timestamp on the console window.

   Tip: You must periodically check the output of the command to determine whether the checkpoint you took has been mirrored.
4. Stop the primary grid including the primary grid's realm service.
5. Select a new data grid that is going to be the primary grid.
6. Restart the realm service of the new primary grid as the "primary" realm service by omitting the satelliteof configuration option.
7. Restart the processes of the new data grid that becomes the primary grid.
8. Use the following command to activate that selected mirror grid as the new primary grid:

   tibdg -r http://rs1:8080 gridset setPrimary Gridset DR1  

9. Restart all mirror grids (including the old primary grid) by restarting their realm services as "satellite" realm services (specifying the satelliteof configuration option and referencing the new "primary" realm service).
   
   Note:  The old primary grid must have all processes stopped and the tibftlserver data directory must be backed up and then cleared prior to being restarted as a new satellite tibftlserver.
10. Restart the remaining mirror grid processes.