Disaster recovery

If a device with Edge Data Store (EDS (Edge Data Store)) installed fails, use the following procedures to recover data from the failed device and restore it to a new device. The disaster recovery process is similar for both Windows and Linux systems and includes the following steps:

• Back up the EDS (Edge Data Store) data from the failed device to another location.

• Install EDS (Edge Data Store) on a new device. For instructions, see Installation.

• Move the backed-up data to the new device.

• Restore the backed-up data files to the new device.

• Reenter credentials.

Windows recovery

Use the following procedures to recover EDS (Edge Data Store) data from a Windows device. You need administrative access on the device to successfully restore on a Windows system.

Create a backup of EDS (Edge Data Store) data from the failed device

To create a backup of data from the failed device:

1. If your device is still able to boot, verify that EDS (Edge Data Store) service has stopped. Use the Windows Task Manager to stop the EDS (Edge Data Store) service.

2. Locate the storage and configuration files.

   Note: Windows storage and configuration files are stored in the following locations:

   Definition:

   - `C:\ProgramData\OSIsoft\EdgeDataStore\Configuration`

   - `C:\ProgramData\OSIsoft\EdgeDataStore\Storage`

   Stream data files are stored in the following locations:

   - Default namespace: `C:\ProgramData\OSIsoft\EdgeDataStore\Storage\data\default\default`

   - Diagnostics namespace: `C:\ProgramData\OSIsoft\EdgeDataStore\Storage\data\default\diagnostics`

   The ProgramData folder is typically hidden; to view it, go to the View tab in Windows Explorer and select the Hidden Items checkbox.

   Windows Explorer

3. Create a .zip or .tar file containing the storage and configuration directories, and move it to a USB (Universal Serial Bus) device or other safe location. File transfer can be done with WinSCP (Windows Secure Copy), SFTP (Simple File Transfer Protocol), or external device.

   .zip

   .tar

Delete default storage and configuration folders

When EDS (Edge Data Store) is installed on the new device, the new system has a default configuration. To delete the default storage and configuration folders on the new device:

4. Use the Windows Task Manager to stop the EDS (Edge Data Store) service.

5. Once the service has stopped, navigate to the C:\ProgramData\OSIsoft\EdgeDataStore directory, and delete the default storage and configuration folders from the new device.

Restore backed up data files

To restore the data files on the new device:

6. Copy or unzip the backup storage and configuration files into the C:\ProgramData\OSIsoft\EdgeDataStore directory.

   Note: The C: drive may not be the default drive letter of your system. Refer to My Computer, This PC, or open a command prompt to verify the default drive letter.

7. Use the Windows Task Manager to restart the EDS (Edge Data Store) service.

Reenter credentials

All credentials are encrypted for security purposes, so they cannot be copied or transferred. After the the storage and configuration files are copied to the new system, and the service has started, follow these steps to enter credentials:

8. Reenter the credentials for the operating system using API (Application Programming Interface) calls.

9. After updating, restart the EDS (Edge Data Store) service.

   The new EDS (Edge Data Store) device runs as the previous device, and contains all the data up to the point when the previous device failed.

Linux recovery

Use the following procedures to recover EDS (Edge Data Store) data from a Linux device. Root access on the Linux device is required.

Create a backup of EDS (Edge Data Store) data from the failed device

To create a backup of data from the failed device:

10. If your device is still able to boot, open a terminal window and verify that EDS (Edge Data Store) service has stopped using the following command:

    sudo systemctl stop osisoft.edgedatastore

11. Locate the storage and configuration files.

    Note: Linux storage and configuration files are stored in the following locations:

    Definition:

    - `/usr/share/OSIsoft/EdgeDataStore/Configuration`

    - `/usr/share/OSIsoft/EdgeDataStore/Storage`

    Stream data files are stored in the following locations:

    - Default namespace: `/usr/share/OSIsoft/EdgeDataStore/Storage/data/default/default`

    - Diagnostics namespace: `/usr/share/OSIsoft/EdgeDataStore/Storage/data/default/diagnostics`

12. Create a .zip or .tar file containing the storage and configuration directories, and move it to a USB (Universal Serial Bus) device or other safe location. Use WinSCP, SFTP (Simple File Transfer Protocol), or the external device to transfer the file.

    WinSCP

    Note: Using the cp command may result in a change in file ownership to the current user.

Move the files to the new device

When EDS (Edge Data Store) is installed on the new device, the new system has a default configuration. To copy the backed up storage and configuration folders to the new device:

13. Open a terminal window and stop the EDS (Edge Data Store) service using the following command:

    sudo systemctl stop osisoft.edgedatastore

14. Once the service has stopped, navigate to the /usr/share/OSIsoft/EdgeDataStore directory and extract the zip or tar file in that directory using WinSCP, SFTP (Simple File Transfer Protocol), or external device.

    WinSCP

Restore backed up data files

To restore the data files on the new device:

15. Delete the default storage and configuration folders from the /usr/share/OSIsoft/EdgeDataStore directory.

16. Copy or unzip the backup storage and configuration files into the EdgeDataStore directory.

17. If the ownership of the two directories does not match, update it to edgedatastore for the user and group.

18. Start the EDS (Edge Data Store) service with the following command:

    sudo systemctl start osisoft.edgedatastore

19. Verify that EDS (Edge Data Store) is running with the following command:

    sudo systemctl status osisoft.edgedatastore

    Note: Default directory permissions are set to 755, and each subsequent file is 644. If you do not use tar it is possible to have permission issues with the recovery files. Tar matches via string name rather than the account ID/UID.

Reenter credentials

All credentials are encrypted for security purposes, so they cannot be copied or transferred. After the the storage and configuration files are copied to the new system, and the service has started, follow these steps to enter credentials:

20. Re-enter the credentials for the operating system using API (Application Programming Interface) calls.

21. After updating, restart the EDS (Edge Data Store) service.

    The new EDS (Edge Data Store) device runs as the previous device, and contains all the data up to the point when the previous device failed.