You can initiate a restore for a backed-up tenant from the following two entry points in the obshell Dashboard:
Entry 1: Log in to the obshell Dashboard, go to the TENANTS page, and click Initiate Restore in the upper-right corner.
Entry 2: Log in to the obshell Dashboard, go to the TENANTS page, click the name of the tenant in the tenant list to go to the Overview page, click Backup Restore in the left-side navigation pane to go to the Backup Restore page, and click Initiate Restore in the upper-right corner.
Note
Entry 1 allows you to initiate a restore from the global **TENANTS** page, and you need to specify or modify the storage configuration when initiating a restore. Entry 2 allows you to initiate a restore from the tenant page, and you can reuse the backup storage configuration of the tenant without specifying or modifying it.
Procedure
The following steps are based on Entry Point 1.
Log in to the obshell console.
In the left-side navigation pane, click Tenant Management.
In the upper-right corner of the page that appears, click Initiate Restoration.
When you initiate a restoration on the global page, you need to configure the storage settings for the backed-up file to be restored (this step is only required for Entry Point 1).
After filling in or modifying the settings, click Test.
Note
After you click Test, obshell will test the storage settings for the backed-up file to be restored. If the test is successful, the Restore Source Information section will display the name of the source tenant to be restored. If the test fails, an error message will be displayed. Please make sure to enter the correct storage settings.
Fill in the Restore Source Information section. The restore date must be within the specified time range. To obtain the restore time range, you need to install the oceanbase-ce-utils tool package, which allows the system to parse backup set information. For detailed installation instructions, please refer to Introduction to ob_admin. If no restore time is specified, the latest point-in-time will be restored by default.
Fill in the Restore Target Information section.
Parameter Description Target Tenant Specify a tenant name, which must be unique. The system will create a corresponding tenant based on the specified tenant name and restore the backup content to this tenant. Number of Units per Zone Specify the number of units for each zone. The maximum number of units is determined by the minimum number of OBServer nodes in the zone. Replica Type Valid values: - General Replica: A standard replica that supports all features and data types, including transaction logs, MemTables, and SSTables. It can quickly switch to a leader to provide services.
- Read-Only Replica: Contains complete logs, MemTables, and SSTables. It is recommended for scenarios where read consistency requirements are not high.
Unit Specification The resource specification occupied by the unit. You can manually enter a value within the current configurable range. Number of Units Displays the number of units for each zone. Note
The number of units is consistent with the Number of Units per Zone configuration and cannot be modified.
Zone Priority Specify the priority for the primary replica of the tenant. The zone with the highest priority is considered the primary zone, and there can only be one. If no zone priority is configured, the default priority is Random. The sorting method is as follows: - Select one or more zones from the left list. The left list displays all available zones in the current cluster.
- Click the > button in the middle. The selected zones will be moved to the Priority Sorting list.
- Repeat steps a and b to add zones with lower priorities.
- To adjust the priority, drag and drop zones in the Priority Sorting list to change their order. The priority decreases from top to bottom in the list.
- Click the delete button next to a zone or click Restore to Default to move the zone back to the left list in the Priority Sorting list.
Click Initiate Restore to generate a restore task. You can click View Task to view the restore task progress.