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:
- NFS
- SMB
- S3
- NDMP
- HTTP
- Quotas
- Snapshots
The underlying architecture comprises four layers , and the process flow is as follows:
Each layer of the architecture is a follows:
| Component | Description |
| User Interface | Allows users to submit operations with multiple choices, such as REST, CLI, or WebUI. |
| pAPI Handler | Performs different actions according to the requests flowing in |
| Config Manager | Core layer executing different 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:
| File | Location |
| 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 .