WorkspaceData backup and restoration
Dashboards and other Web environment data are stored in the WorkspaceData
table in the DbInternal
namespace. It can be backed up by exporting/importing CSV using the WorkspaceDataTool
, by copying the intraday table, or by copying the most recent WorkspaceDataSnapshot
. However, the preferred method is the Deephaven backup script.
Workspace data tool
To export/import with the WorkspaceDataTool
, use the following commands:
# Export Workspace data:
sudo -u irisadmin /usr/illumon/latest/bin/iris workspace_data_tool -c -t Workspace -f [workspace_filename].csv
# Restore Workspace data:
sudo -u irisadmin /usr/illumon/latest/bin/iris workspace_data_tool -rc -f [workspace_filename].csv
# Export Dashboard data:
sudo -u irisadmin /usr/illumon/latest/bin/iris workspace_data_tool -c -t Dashboard -f [dashboard_filename].csv
# Restore Dashboard data:
sudo -u irisadmin /usr/illumon/latest/bin/iris workspace_data_tool -rc -f [dashboard_filename].csv
For a complete listing of options, see the full workspace_data_tool documentation.
Once the restoration steps are completed, restart the WebClientData
Persistent Query.
Intraday table migration
You can copy the WorkspaceData
table by following the instructions in the related Table migration document.
WorkspaceDataSnapshot
historical migration
Alternatively, if historical changes of items with the table are not required, the contents of WorkspaceData
may be transferred using a single WorkspaceDataSnapshot
partition by ensuring a new snapshot is taken (by manually executing the WorkspaceSnapshot
Persistent Query) and copying it to the new deployment. The latest snapshot can be found with the following command on the source host:
find /db/Systems/DbInternal/Partitions -name 'WorkspaceDataSnapshot' | sort -t '/' -k6
Once the latest snapshot has been identified, the single partition may be copied to the target or made available through NFS, if possible.