Realm Service Checkpoint Restore

When an ActiveSpaces checkpoint is created for a data grid, the data grid's configuration from the realm service is saved as part of that checkpoint.

The data grid's configuration from the realm service can be found in the following file on any node of the copyset that was first configured for your data grid: 
<node_data_dir>/checkpoints/<timestamp>_<epoch>_<counter>_<checkpoint_name>/metadata
/realmserver-grid.json
The ActiveSpaces administrative command-line tool tibdg is used to restore a data grid's configuration into a realm.

Prerequisites

To restore your data grid configuration into a realm you must ensure that you first complete the following steps:
  1. Ensure your realm services have been restored using a backup database associated with the checkpoint.
  2. Copy the realmserver-grid.json file to a location that is easily accessible when you run tibdg.
  3. Load the realmserver-grid.json grid configuration into the realm service.

Procedure

  • Use the following tibdg command is used to restore the grid configuration from a checkpoint into the primary realm service: 
    tibdg [-g <grid_name>] -r <realm_service_URL> grid load -rollback \<grid_config_json_file>
    For example, tibdg -r http://10.0.1.25:8080 grid load -rollback ./realmserver-grid.json . Remember that in a realm only the primary realm service can accept realm configuration updates. The <realm_service_URL> must be the URL of the primary realm service.
    Note: This method must not be used if more than one data grid is configured in the realm service or other FTL applications are also configured in the realm.
Related tasks