Restoring Solr Metadata

Scenario

Solr metadata needs to be restored in the following scenarios: Data is modified or deleted unexpectedly and needs to be restored. After an administrator performs major operations (such as upgrade and data adjustment) on ZooKeeper, an exception occurs or the expected result is not achieved. The Solr component is faulty and becomes unavailable. Data is migrated to a new cluster.

System administrators can create a Solr restoration task on FusionInsight Manager. Only manual restoration tasks are supported.

• Data restoration can be performed only when the system version is consistent with that during data backup.
• To restore Solr metadata when the service is running properly, you are advised to manually back up the latest Solr metadata before restoration. Otherwise, the Solr metadata that is generated after the data backup and before the data restoration will be lost.

Impact on the System

• Before restoring the metadata, you need to stop the Solr service. During this period, all upper-layer applications are affected and cannot work properly.
• After the metadata is restored, the data generated after the data backup and before the data restoration is lost.
• After the metadata is restored, the upper-layer applications of Solr need to be started.

Prerequisites

• If you need to restore data from a remote Solr, prepare a standby cluster. If the active cluster is deployed in security mode and the active and standby clusters are not managed by the same FusionInsight Manager, mutual trust must be configured. For details, see Configuring Cross-Manager Mutual Trust Between Clusters. If the active cluster is deployed in normal mode, no mutual trust is required.

• You have checked the path for storing Solr metadata backup files.
• The Solr service has been stopped before its metadata is restored.
• You have logged in to FusionInsight Manager. For details, see Logging In to FusionInsight Manager.

Procedure

1. On FusionInsight Manager, choose O&M > Backup and Restoration > Backup Management.
2. In the row where the specified backup task is located, choose More > View History in the Operation column to display the historical execution records of the backup task.

   In the window that is displayed, select a success record and click View in the Backup Path column to view its backup path information and find the following information:

   • Backup Object: indicates the backup data source.
   • Backup Path: indicates the full path where backup files are stored.

     Select the correct path, and manually copy the full path of backup files in Backup Path.

3. On FusionInsight Manager, choose O&M > Backup and Restoration > Restoration Management.
4. Click Create.
5. Set Task Name to the name of the restoration task.
6. Select the desired cluster from Recovery Object.
7. In Restoration Configuration, select Solr under Metadata and other data.
   

   If multiple Solr services are installed, select the Solr service to be restored.

8. Select a backup directory type for Path Type.

   The configurations vary based on backup directory types:

   • LocalDir: indicates that the backup files are stored on the local disk of the active management node.

     If you select this option, you also need to set Source Path, which indicates the backup file to be restored, for example, Version_Data source_Task execution time.tar.gz.

   • NFS: indicates that backup files are stored in NAS using the NFS protocol.
     If you select this option, configure the following parameters:

     • IP Mode: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, IPv4 or IPv6.

     • Server IP Address: indicates the IP address of the NAS server.
     • Source Path: indicates the complete path of the backup file on the NAS server, for example, Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time.tar.gz.
   • RemoteHDFS: indicates that the backup files are stored in the HDFS directory of the standby cluster.
     If you select this option, configure the following parameters:

     • Source NameService Name: indicates the NameService name of the backup data cluster, for example, hacluster. You can obtain it from the NameService Management page of HDFS of the standby cluster.
     • IP Mode: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, IPv4 or IPv6.
     • Source Active NameNode IP Address: indicates the service plane IP address of the active NameNode in the standby cluster.
     • Source Standby NameNode IP Address: indicates the service plane IP address of the standby NameNode in the standby cluster.
     • Source NameNode RPC Port: indicates the value of dfs.namenode.rpc.port in the HDFS basic configuration of the standby cluster.
     • Source Path: indicates the full path of HDFS directory for storing backup data of the standby cluster, for example, Backup path/Backup task name_Data source_Task creation time.
   • CIFS: indicates that backup files are stored in NAS using the CIFS protocol.
     If you select this option, configure the following parameters:

     • IP Mode: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, IPv4 or IPv6.

     • Server IP Address: indicates the IP address of the NAS server.
     • Port: indicates the port number used to connect to the NAS server over the CIFS protocol. The default value is 445.
     • Username: indicates the username set when the CIFS protocol is configured.
     • Password: indicates the password set when the CIFS protocol is configured.
     • Source Path: indicates the complete path of the backup file on the NAS server, for example, Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time.tar.gz.
   • SFTP: indicates that backup files are stored in the backup server using the SFTP protocol.
     If you select this option, configure the following parameters:

     • IP Mode: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, IPv4 or IPv6.

     • Server IP Address: indicates the IP address of the server where the backup data is stored.
     • Port: indicates the port number used to connect to the backup server over the SFTP protocol. The default value is 22.
     • Username: indicates the username for connecting to the server using the SFTP protocol.
     • Password: indicates the password for connecting to the server using the SFTP protocol.
     • Source Path: indicates the complete path of the backup file on the backup server, for example, Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time.tar.gz.

9. Click OK.
10. In the restoration task list, locate the row where the created task is located, and click Start in the Operation column.
    • After the restoration is successful, the progress bar is in green.
    • After the restoration is successful, the restoration task cannot be executed again.
    • If the restoration task fails during the first execution, rectify the fault and click Retry to execute the task again.

11. Log in to FusionInsight Manager and restart the Solr service.