How to Use the System Configuration Backup and Restore Feature?

1. Operation Guide

Scenario 1: Device Replacement

A new device has FygoOS installed, and you plan to transfer all hard drives from the old device to the new one, hoping to fully restore the system configuration and file user permissions. Steps for configuration migration:

1. On the old device, go to "System Settings" - "Backup and Restore" - "System Configuration", and click "Export" to obtain the bin file;
   
2. Shut down the old device and remove all hard drives. Before proceeding: if SSD cache is mounted, it is recommended to unmount it first, especially read-write cache;
   
3. With the new device powered on, insert all hard drives, go to "System Settings" - "Backup and Restore" - "System Configuration", and click "Import" to upload the bin file;
   
4. Select the configuration items to restore. For this scenario, it is recommended to select all. See below for detailed configuration descriptions;
   
5. Wait for the restore to complete.
   Tip: When two system drives exist, verify the BIOS boot order to ensure the new system boots correctly.

Scenario 2: System Reinstallation

You plan to reinstall FygoOS on the system drive and want to fully restore the system configuration and file user permissions. Steps for configuration restore:

1. Before reinstalling, go to "System Settings" - "Backup and Restore" - "System Configuration", and click "Export" to obtain the bin file;
   
2. Shut down the device, perform the system installation following the System Installation Guide, and complete the installation and initialization;
   
3. After entering the new system, go to "System Settings" - "Backup and Restore" - "System Configuration", and click "Import" to upload the bin file;
   
4. Select the configuration items to restore. For this scenario, it is recommended to select all. See below for detailed configuration descriptions;
   
5. Wait for the restore to complete.

Scenario 3: Regular Backup

Steps for routine backup and restore:

1. Go to "System Settings" - "Backup and Restore" - "System Configuration", and click "Export" to obtain the bin file. It is recommended to export manually on a regular basis;
   
2. When a restore is needed, perform the system configuration restore at the same path and upload the bin file;
   
3. Select the configuration items to restore as needed, such as selecting only the firewall. See below for detailed configuration descriptions;
   
4. Wait for the restore to complete.

2. Feature Limitations

• System version consistency: Since system configurations may change with version upgrades, it is recommended to keep the system version consistent during backup and restore for optimal results. When system versions differ, some restore items may not restore correctly.
• Backup and restore scope: The system configuration backup and restore feature only covers configuration data within System Settings. It does not include: Network Settings, port configuration, Fygo account, Fygo Connect, and UPS configuration, which need to be managed manually.

3. Restore Configuration Details

3.1 Users and User Groups

Restore behavior:

1. Do not overwrite conflicts: Automatically restores users/user groups from the backup. If an ID conflict exists, the conflicting item will be skipped, and existing users/user groups will not be affected.
   
2. Overwrite conflicts: Automatically restores users/user groups from the backup. If an ID conflict exists, the conflicting item will be overwritten. Non-conflicting users/user groups will not be affected.
   

Details:

1. Cases where overwriting may still fail and require manual handling: users with the same username but different IDs; the target user has running processes that prevent modification, such as SMB or SSH sessions; the user performing the restore operation will be skipped by default.
   
2. Conflict criteria: Based on user/user group ID, which is related to the creation order. Note: The user ID also serves as the user's home directory name. After restore, verify that data permissions match expectations.

3.2 Volume Settings

Restore behavior:
Restores the volume mount order from the backup to prevent service issues caused by path changes.

Details:

1. When all hard drives are inserted: Volumes will be restored to "Available" status.
   
2. When not all hard drives are inserted: Volumes will show as "Damaged" or "Removed". Inserting the hard drives will allow recovery.
   
3. SSD cache backup and restore is not currently supported. Recommended workflow: Before removing hard drives from the old device, unmount the SSD cache first; after mounting hard drives on the new device and completing the restore, reconfigure the SSD cache. Important: If read-write cache is not unmounted before migration, it may cause irreparable volume damage.

3.3 File Sharing Protocol Settings

Restore behavior:
Restores the protocol enable status and global configuration from the backup, including SMB, WebDAV, FTP, NFS, and DLNA.

Details:
Dependency: To restore each user's "visible folder scope" configuration in file sharing protocols, ensure that "Users and User Groups" and "Volume Settings" are also restored, especially in device replacement scenarios.

3.4 Application Settings

Restore behavior:
Restores application permissions and access settings from the backup.

Details:

1. Only settings are restored; applications will not be installed automatically. Applications must be installed before the restore can take effect.
   
2. The current version does not support restoring "Folder Authorization Scope". This will be added in a future version.
   

3.5 DDNS

Restore behavior:
Retains the current configuration and merges DDNS configurations from the backup.

Details:

1. If a domain conflict exists, the conflicting entry will be skipped.
   
2. In device replacement scenarios, since network interfaces may not match, restored DDNS configurations will be disabled by default. You can manually select a network interface and enable them after the restore.
   

3.6 SSH

Restore behavior:
Restores the SSH enable status and port number settings from the backup.

3.7 Firewall

Restore behavior:
Restores the firewall enable status from the backup and overwrites the firewall rule list.

Details:

1. Rules targeting specific network interfaces will be skipped.
   
2. "Advanced Settings - LAN - Allow Access by Default" will be checked by default to prevent access loss after restore. You can adjust this as needed after the restore.