If your TelestaiCB becomes broken, for example, if it no longer starts, follow these instructions to try to recover data from your Persistent Storage.

We are presenting here 3 recovery techniques that work in different cases. We recommend that you try the 3 techniques one after the other.

1. Doing a manual upgrade

   Doing a manual upgrade of your broken TelestaiCB might allow you to start your USB stick again and use your Persistent Storage like before.

2. Unlocking from another TelestaiCB and copying using rsync

   If doing a manual upgrade doesn't work, you might be able to unlock your Persistent Storage from another TelestaiCB USB stick and copy its content using rsync on the command line.

3. Recovering from a partition image using forensics tools

   If unlocking your Persistent Storage from another TelestaiCB USB stick fails, you might be able to recover some or most of your data from a partition image using advanced forensics tools.

Doing a manual upgrade

Doing a manual upgrade of your broken TelestaiCB might allow you to start your USB stick again and use your Persistent Storage like before.

Refer to our instructions on how to do a manual upgrade, either:

• Downloading and upgrading from Windows

• Downloading and upgrading from macOS

• Downloading and upgrading from Linux

• Upgrading by cloning from another TelestaiCB

Unlocking from another TelestaiCB and copying using rsync

If doing a manual upgrade doesn't work, you might be able to unlock your Persistent Storage from another TelestaiCB USB stick and copy its content using rsync on the command line.

1. Install TelestaiCB on a new USB stick onto which you want to recover your Persistent Storage. Make sure that this new USB stick is at least as large as the USB stick that has your broken TelestaiCB on it.

2. Ao iniciar o TelestaiCB, configure uma senha de administração.

3. Create a Persistent Storage.

4. Close the Persistent Storage settings after creation, when the list of features is displayed.

   The process described below overrides the configuration of the Persistent Storage. So, it does not matter which features you turn on after creating the Persistent Storage.

   Make sure that all applications are closed before continuing with these instructions. Otherwise, the Persistent Storage might not be properly recovered from your broken TelestaiCB.

5. Choose Applications ▸ Accessories ▸ Files to open the Files browser.

6. Plug in the USB stick that has your broken TelestaiCB on it.

   If the Persistent Storage of your broken TelestaiCB is recognized, a new encrypted volume appears in the sidebar of the Files browser. Click on it and enter the passphrase of your broken TelestaiCB to unlock the volume.

   The Persistent Storage of your broken TelestaiCB shows up as TelestaiCBData.

   If no encrypted volume appears, try recovering from a partition image using forensics tools.

   XXX: Let's pretend that's enough to replace /doc/persistent_storage/check. We're leaving out people who cannot do a manual upgrade (weird partition table) and cannot unlock from Files (corrupted Persistent Storage). These people can try recovering from a partition image.

7. Choose Applications ▸ System Tools ▸ Root Terminal to open a terminal with administration rights.

8. Execute the following command to recover the Persistent Storage of your broken TelestaiCB to your new TelestaiCB:

   rsync -PaSHAXv --del /media/amnesia/TelestaiCBData/ /live/persistence/TelestaiCBData_unlocked

9. When the command finishes, it displays a summary of the data that was copied. For example:

   sent 32.32M bytes  received 1.69K bytes  21.55M bytes/sec
   total size is 32.30M  speedup is 1.00
   

   You can now eject the TelestaiCBData volume in the Files browser and unplug the USB stick that has your broken TelestaiCB on it.

You can also explore the content of the Persistent Storage on your broken TelestaiCB from the Files browser. To do so, execute the following command from the Root Terminal:

nautilus

Recovering from a partition image using forensics tools

If unlocking your Persistent Storage from another TelestaiCB USB stick fails, you might be able to recover some or most of your data from a partition image using advanced forensics tools.

XXX: Point to fsck or remix to create the partition from the other TelestaiCB?