OneFS 9.2 introduces the ability to export a cluster’s configuration, which can then be used to perform a configuration restore to the original cluster, or to an alternate cluster that also supports this feature. A configuration export and import can be performed via either the OneFS CLI or platform API, and encompasses the following OneFS components for configuration backup and restore:
The underlying architecture comprises four layers , and the process flow is as follows:
Each layer of the architecture is a follows:
|User Interface||Allows users to submit operations with multiple choices, such as REST, CLI, or WebUI.|
|pAPI Handler||Performs diﬀerent actions according to the requests ﬂowing in|
|Config Manager||Core layer executing diﬀerent jobs which are called by PAPI handlers.|
|Database||Lightweight database manage asynchronous jobs, tracing state and receiving task data.|
By default, configuration backup and restore files reside at:
|Backup JSON file:||/ifs/data/Isilon_Support/config_mgr/backup/<JobID>/<component>_<JobID>.json|
|Restore JSON file:||/ifs/data/Isilon_Support/config_mgr/restore/<JobID>/<component>_<JobID>.json|
The log file for configuration manager is located at /var/log/config_mgr.log and can be useful to monitor the progress of a config backup and restore.
So let’s take a look at this cluster configuration management process:
The following procedure steps through the export and import of a cluster’s NFS and SMB configuration – within the same cluster:
- Open an SSH connection to any node in the cluster and log in using the root account.
- Create several SMB shares and NFS exports using the following CLI command
# isi smb shares create --create-path --name=test --path=/ifs/test # isi smb shares create --create-path --name=test2 --path=/ifs/test2 # isi nfs exports create --paths=/ifs/test # isi nfs exports create --paths=/ifs/test2
- Export the NFS and SMB configuration using the following CLI command
# isi cluster config exports create --components=nfs,smb --verbose
As indicated in the output below, the job ID for this export task is ‘ PScale-20210524105345’
Are you sure you want to export cluster configuration? (yes/[no]): yes This may take a few seconds, please wait a moment Created export task ' PScale-20210524105345'
- To view the results of the export operation, use the following CLI command:
# isi cluster config exports view PScale-20210524105345
As displayed in the output below, the backup JSON files are located at /ifs/data/Isilon_Support/config_mgr/backup/PScale-20210524105345
ID: PScale-20210524105345 Status: Successful Done: ['nfs', 'smb'] Failed:  Pending:  Message: Path: /ifs/data/Isilon_Support/config_mgr/backup/PScale-20210524105345
- The JSON files can be viewed under /ifs/data/Isilon_Support/config_mgr/backup/ PScale-20210524105345. OneFS will generate a separate configuration backup JSON file for each component (ie. SMB and NFS in this example):
# ls /ifs/data/Isilon_Support/config_mgr/backup/PScale-20210524105345 backup_readme.json nfs_PScale-20210524105345.json smb_PScale-20210524105345.json
- Delete all the SMB shares and NFS exports using the following commands:
# isi smb shares delete test # isi smb shares delete test2 # isi nfs exports delete 9 # isi nfs exports delete 10
- Use the following CLI command to restore the SMB and NFS configuration:
# isi cluster config imports create PScale-20210524105345 --components=smb,nfs
- From the output below, the import job ID is ‘ PScale-20210524105345’
Are you sure you want to import cluster configuration? (yes/[no]): yes This may take a few seconds, please wait a moment Created import task ' PScale-20210524105345'
- To view the restore results, use the following command:
# isi cluster config imports view PScale-20210524105345 ID: PScale-20210524110659 Export ID: PScale-20210524105345 Status: Successful Done: ['nfs', 'smb'] Failed:  Pending:  Message: Path: /ifs/data/Isilon_Support/config_mgr/restore/ PScale-20210524110659
- Verify that the SMB shares and NFS exports are restored:
# isi smb shares list Share Name Path ---------------------- test /ifs/test test2 /ifs/test2 ---------------------- Total: 2
# isi nfs exports list ID Zone Paths Description ----------------------------------- 11 System /ifs/test 12 System /ifs/test2 ----------------------------------- Total: 2
A WebUI management component for this feature will be included in a future release, as will the ability to run a diff, or comparison, between two exported configurations .