...
| Argument | Purpose | Examples | ||
|---|---|---|---|---|
-backupRecordStore | To backup the record store where the persisted events are saved. This |
The above command backs up all the tables in the DAS record store to the | ||
-backupFileSystem | To backup the file system where data relating to the indexing of events. |
The above command backs up indexing information relating to all the tables in DAS to the | ||
-dir <directory> | Directory used as the target when backing up the record store/file system, or as the source when restoring already backed up record store/file system. The directly should be specified in every command issued to backup or restore data. |
The above argument in all the other examples specifies the | ||
-restoreRecordStore | To restore a record store. Before you use this command, the record store you want to restore should be already backed up. |
The above command restores record store data currently saved in the | ||
-restoreFileSystem | To restore a file system. Before you use this command, the file system you want to restore should be already backed up. |
The above command restores indexing related data currently saved in the | ||
| -enableIndexing Indexing is by default deleteTables | Deletes the specified table list. You need to specify the table list to be deleted using the -tables parameter. |
| ||
| -purge | Allows data purging for a given time range. | ./analytics-backup.sh -purge -table "tempTable" -tenantId -1234 | ||
-enableIndexing | Indexing is disabled in the data restoration step , this by default. This is because , if the target DAS server is already running, then that server will also index the same data , and will lead to causing an index corruption. So if we are sure if the If you are certain that the target DAS server is not uprunning, we you can chose to index the data right at the time of restoring the data, by enabling this setting. Even in default setting, after the data is restored, when the DAS server is started up, it will anyway index the new data it is restored by using this argument. If this argument is not used while the target DAS server is not running, the data restored from the time the target server is started up is indexed in the usual way. |
The above command restores both record store data and indexing related data currently saved in the | ||
-reindexEvents | This switch will make the tool re-index the data already there in a table. This can be useful in a scenario such as, an index getting where an the indexing is corrupted for some reason, or if some of the older data was is not index since indexed because it was not mentioned in the schema etc.. |
The above command restores both record store data and indexing related data currently saved in the | ||
-tables <table list> | This argument is used to specify the list of event tables that should be backed up or restored.
|
The above command backs up the data of
The above command restores record store data of | ||
| This argument is used to select the tenant ID(s) of which the events should be backed up. |
The above command backs up all the event tables of the | ||
-disableStaging | This argument is used to disable staging. Staging involves including the indication whether the data is indexed or not when backing up/restoring the DAS record store. This task incurs a greater system overhead. Therefore, it is allowed to disable staging when the number of records being backed up/restored is high. Backing up and restoring the file system via -backupFileSystem and -restoreFileSystem allows you to preserve the indexing which would enable searches to be carried out on restored data. |
The above command backs up all the event tables in the DAS record store. Indications of whether data is indexed or not are removed before backing up the records. | ||
| This argument specifies the starting time (inclusive) when defining the time period that should be considered when backing up/restoring events.
|
The above command backs up all the data in the DAS record store created between 12.45PM on 11th October 2015 to 5.00PM on 15th October 2015. The data is backed up in the | ||
| This argument specifies the ending time (inclusive) when defining the time period that should be considered when backing up/restoring events.
|
The above command backs up all the data in the DAS record store created between 12.45PM on 11th October 2015 to 5.00PM on 15th October 2015. The data is backed up in the |
| Info |
|---|
All the arguments described in the above table are displayed in your console when you run the |
Sample commands
Backing up data
| Code Block | ||
|---|---|---|
| ||
./analytics-backup.sh -restoreRecordStore -tables Table1,Table2,Table3 -backupFileSystem -timeFrom 15-08-11-08:00:00 -timeTo 15-10-15-22:30:00 -dir /home/user/backup |
The above command backs up the records of the Table1, Table2, Table3 event tables as well as the related indexing information in the /home/user/backup directory. Only the data entered between 8.00 AM on 11th August 2015 and 10.30 PM on 15th October 2015 are selected to be backed up.
Restoring data
| Code Block | ||
|---|---|---|
| ||
./analytics-backup.sh -restoreRecordStore -tables Table1,Table2,Table3 -restoreRecordStore -timeFrom 15-08-11-09:00:00 -timeTo 15-08-11-10:00:00 -dir /home/user/backup |
The above command restores records of the Table1, Table2, Table3 event tables as well as the related indexing information from the /home/user/backup directory. Only data entered between 9.00 - 10.00 AM on 11th August 2015 are selected to be restored.
Searching restored data
In order to enable searching for persisted data, WSO2 indexes events using Apache Lucene (for more information, see Configuring Indexes). The persisted data is saved in the record store and the information relating to the indices of that data is stored in the file system. Therefore, if you want to carry out searches once you restore backed up data, you need to restore both the record store and the file system. If you restore only the record store it will not be possible to carry out searches for the restored data using the Data Explorer. For more information on searching using the Data Explorer, see Searching Data by Categories.