Differences

This shows you the differences between two versions of the page.

--- en:how_to_use_the_backup_restore_feature [2024/02/21 17:37]
jake
+++ en:how_to_use_the_backup_restore_feature [2024/02/27 16:45] (current)
jake [How to Use the 'Backup & Restore' Feature with BioStar 2]
@@ Line 6: / Line 6: @@
 Thanks to this new function, users can back up the necessary data on BioStar 2 more easily and conveniently. \\
-''Note:''\\
+<callout type="primary" icon="true"> If you have an issue with this feature in BioStar 2 v2.9.4 or v2.9.5, please refer to the linked article below. https://support.supremainc.com/en/support/solutions/articles/24000088219 \\
-If you have an issue with this feature in BioStar 2 v2.9.4 or v2.9.5, please refer to the linked article below. \\ https://support.supremainc.com/en/support/solutions/articles/24000088219 \\
+</callout>
-==== Background ====
+===== Background =====
 Until v.2.9.2, or lower versions, users needed to manually backup the necessary files, such as a database or enckey file, to prepare for any unexpected problems. However, this must be done manually, which may be cumbersome, and there is potential for issues during the backup, such as missing some mandatory files.
-''Note:'' \\
+<callout type="primary" icon="true">
-- If the MSSQL database and BioStar 2 are installed on different PCs, BioStar 2 System Backup and Restore CANNOT be used. \\
+  * If the MSSQL database and BioStar 2 are installed on different PCs, BioStar 2 System Backup and Restore CANNOT be used. \\
-- If BioStar 2 version at the time of backup is different from the current version, the restoration will not proceed. \\
+  * If BioStar 2 version at the time of the backup is different from the current version, the restoration will not proceed. \\
+</callout>
-==== Summary ====
+===== Summary =====
-**1. Backup:** \\
+==== 1. Backup: ====
 Users can back up the necessary data automatically and regularly by using the new function SYSTEM BACKUP in the Settings of BioStar 2. \\
 {{:en:backup_icon.png?100|}} \\
@@ Line 29: / Line 29: @@
 **1) Database** \\
-* AC \\
+  * AC \\
-* TA \\
+  * TA \\
-* VIDEO \\
+  * VIDEO \\
+**2) Folders** \\
+  * cert \\
+  * lic\\
+  * util - The path in reference to "system.conf."\\
+  * imagelog\\
+  * upload (located in C:\Program Files\BioStar 2(x64)\nginx\html) → **This folder will be only included in backup data if there is any file. The file is generated only if you set the Graphic Map View in MONITORING of BioStar 2.** \\
+  * conf (located in C:\Program Files\BioStar 2(x64)\nginx)\\
+  * records (located in C:\Program Files\BioStar 2(x64)\ve)\\
+  * db (C:\Program Files\BioStar 2(x64)\ve)\\
+**3) CONF files** \\
+  * setting.conf \\
+  * system.conf \\
+  * server_url.conf \\
+  * log.conf \\
+  * sysbackup.conf \\
+==== 2. Restore: ====
+Users can restore the backup data by using an extra application named **biostar-restore** located at **C:\Program Files\BioStar 2(x64).** \\
+{{:en:restore_icon.png?100|}}
+===== Major Features =====
+==== 1. Set the cycle for backup of the data ====
+Users can back up the files in BioStar 2 automatically and periodically according to the selected option in **Frequency** of **Automatic System Backup.**
+{{:en:pic1.png?400|}}
+<callout type="primary" icon="true">
+There are a total of four options **(Not Use / Daily / Weekly / Monthly)** on **Frequency** \\
+</callout>
+  * Not Use: If selecting this option, the data will not be backed up regularly and automatically. Instead, you can back up the data by clicking the "Backup Now" in "General." \\ {{:en:pic2.png?400|}}
+  * Daily: If selecting it, the data will be backed up at the set time daily \\ {{:en:pic3.png?400|}}
+  * Weekly: If selecting it, the data will be backed up at the set time and day weekly \\ {{:en:pic4.png?400|}}
+  * Monthly: If selecting it, the data will be backed up at the set time and date monthly \\ {{:en:pic5.png?400|}}
+<callout type="primary" icon="true">
+Users can see the last time the data was backed up, indicated by the red line below in the General
+</callout>
+  * Example) \\ {{:en:pic6.png?400|}}
+==== 2. Set the number of files to keep ====
+Users can define the maximum number of backup files to keep by setting **"Number of Backup Files to Keep"** in the General section of BioStar 2. Once a specific number is set, the oldest backup data will be deleted when the number of backup files exceeds this limit.
+<callout type="primary" icon="true">
+The allowable number range is **from 1 to 100**
+</callout>
+  * Example) \\ {{:en:pic7.png?400|}}
+==== 3. Use the extra application to restore ====
+Restoring the data is processed through the extra tool named "biostar-restore." The tool will be automatically installed when installing BioStar 2 v.2.9.3 and located in C:\Program Files\BioStar 2(x64).
+Since the specific tool for data restoration is separate from BioStar 2, users can attempt to restore data when BioStar 2 isn't running normally due to configuration problems or database issues. \\
+==== 4. Restorable depending on the backup data version ====
+If the backup data was generated using a version lower than the current one, it cannot be restored through this new function. \\
+**Example)** \\
+If the backup data is generated in v.2.9.3, it CANNOT be restored in v.2.9.4 or a higher version of BioStar 2. \\
+<callout type="primary" icon="true">
+Suprema plans to improve the above restriction, but the specific plan is not fixed \\
+</callout>
+===== Precautions =====
+In the case of using **MSSQL**, you will meet the two types of warning popups below and CANNOT each function normally if you don't assign the **sysadmin** of the **Server Role** to the database user. \\
+__If you are in the above case, please check first if the sysadmin has already been assigned to the user.__ \\
+{{:en:pic8.png?400|}}
+  * **Error Case 1.** \\ {{:en:pic9.png?300|}} \\
+  * **Error Case 2.** \\ {{:en:pic10.png?300|}} \\
+===== Execution Procedure =====
+==== Step 1. Backup (based on the case of using the function manually) ====
+=== Step 1-1. ===
+Go to **SYSTEM BACKUP** in **Settings** after logging into BioStar 2 \\ {{:en:pic11.png?300|}}
+=== Step 1-2. ===
+Click **Backup Now** \\ {{:en:pic12.png?300|}}
+<callout type="primary" icon="true">
+Backup File Path: Set the path to save the backup file. The save path must be set to a directory that has already been created
+</callout>
+=== Step 1-3. ===
+Go to **C:\Program Files\BioStar 2(x64)\Backupgenerated correctly** and check if the file is the correct one generated when you tried to make it. \\ {{:en:pic13.png?300|}}
+==== Step 2. Restore ====
+=== Step 2-1. ===
+Run the application named **biostar-restore** located at **C:\Program Files\BioStar 2(x64)** \\ {{:en:pic14.png?300|}}
+=== Step 2-2. ===
+  * **1) If using Maria DB,** \\ Select the file and apply it after clicking the **Select File** button. Then, put the **root password** on your **Maria DB** and click the **Restore** button. \\ {{:en:pic15.png?300|}}
+  * **2) If using MSSQL,** \\ Select the file and apply it after clicking the **Select File** button. Then, click the **Restore** button. \\ {{:en:pic16.png?300|}}
+=== Step 2-3. ===
+Then, you will see an additional popup appear below. Then, click Yes. \\ {{:en:pic17.png?300|}}
+=== Step 2-4. ===
+Finally, the restoration is completed normally if you see the popup below. \\
+However, please note that the popup does not disappear even when the restoration is completed normally. \\ {{:en:pic18.png?400|}}
+=== Step 2-5. ===
+You must log into BioStar 2 again once the restoration has been completed. After logging into BioStar 2, please check whether the restoration has been completed normally.