Realm Server Checkpoint Restore

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

The data grid's configuration from the realm server 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 servers 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 server.

Procedure

  • Use the following tibdg command is used to restore the grid configuration from a checkpoint into the primary realm server: 
    tibdg [-g <grid_name>] -r <realm_server_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 server can accept realm configuration updates. The <realm_server_URL> must be the URL of the primary realm server.
    Note: This method must not be used if more than one data grid is configured in the realm server or other FTL applications are also configured in the realm.
Related tasks