This PowerShell script transforms session recording files from the legacy Devolutions recording server to the Devolutions Gateway session recording format, allowing you to migrate without losing previous recordings. Once the files have been converted to the new format, they will need to be re-indexed from Devolutions Server so that they can be found in their new location for playback from Devolutions Gateway.
Re-indexing enables the detection of records present on the Devolutions Gateway side, making it possible to manually transfer the files and then re-index. However, it is not possible to simply drag and drop the files into the folder; a specific format needs to be adhered to.
Download the MigrateRecordings.ps1 and run it from an elevated PowerShell terminal with the legacy recording output path as a parameter:
PS > .\MigrateRecordings.ps1 -LegacyPath "C:\inetpub\recording\output"
Migrating recordings to 'C:\ProgramData\Devolutions\Gateway\recordings'
Migrating 7e05bf2d-c97b-44eb-b256-351b3e2ef1f0 (075503d9-d016-496e-b0aa-cab8b020ce2d)
Migrating 2115ab16-308c-4eb4-a871-73bc8fd69022 (0f366b0e-e09d-4f57-b290-779f46fb68fd)
Migrating 479930c5-705a-4051-9edf-bdc2748452a4 (39a7d0ec-339e-4086-8d73-fbf455e1038a)
Migrating 2e3d219b-48a3-432a-b214-f11b8ddaa32e (b3409164-078b-4013-b4f6-9a4663d3df98)
If Devolutions Gateway is configured to use a non-default location, the -RecordingsPath
can be used to override the default destination path. You can also perform the migration on one machine to manually copy the files over to the Devolutions Gateway recordings path on a different machine.
A sample legacy.zip file containing legacy recordings is available for reference and testing this script.