Backup & restore a controller

// The controller creates the backup in the background, this call returns immediately
robot.Rws.Controller.CreateBackup("$temp/mybackup");

// Poll the state until the controller is done
BackupState state = robot.Rws.Controller.GetBackupState();

while (state == BackupState.BackupInProgress)
{
    Thread.Sleep(1000);
    state = robot.Rws.Controller.GetBackupState();
}

if (state != BackupState.BackupReady)
{
    Console.WriteLine($"The backup failed : {state}");
    return;
}


// What the backup contains
BackupSystemInfo backup = robot.Rws.Controller.GetBackupInfo("$temp/mybackup");
Console.WriteLine($"{backup.SystemName}, RobotWare {backup.RobotWareVersion}");
Console.WriteLine($"{backup.OptionCount} option(s) : {string.Join(", ", backup.Options)}");

string backupPath = "$temp/mybackup";

    // 1. Ask the controller for a backup and wait until it is finished
    robot.Rws.Controller.CreateBackup(backupPath);

    BackupState state = robot.Rws.Controller.GetBackupState();

    while (state == BackupState.BackupInProgress || state == BackupState.InitState)
    {
        Thread.Sleep(1000);
        state = robot.Rws.Controller.GetBackupState();
    }

    if (state != BackupState.BackupReady)
        throw new Exception($"The backup failed : {state}");

    // 2. A backup is a directory on the controller. Copy it to the PC, file by file.
    DownloadDirectory(robot, backupPath, @"C:\backups\mybackup");
    

// Copies a directory of the controller and everything under it to a directory of the PC
static void DownloadDirectory(AbbController robot, string controllerPath, string localPath)
{
    Directory.CreateDirectory(localPath);

    DirectoryListing listing = robot.Rws.File.ListDirectory(controllerPath);

    foreach (FileItem file in listing.Files)
    {
        robot.Rws.File.GetFileToDestination(controllerPath + "/" + file.Name,
                                            Path.Combine(localPath, file.Name));
    }

    foreach (DirectoryItem directory in listing.Directories)
    {
        DownloadDirectory(robot, controllerPath + "/" + directory.Name,
                          Path.Combine(localPath, directory.Name));
    }
}

// A text file, UTF-8 by default
string text = robot.Rws.File.GetFileAsText("$home/notes.txt");

// Another encoding when the file is not UTF-8
string latin = robot.Rws.File.GetFileAsText("$home/notes.txt", Encoding.GetEncoding("iso-8859-1"));

// A binary file
byte[] bytes = robot.Rws.File.GetFileAsBytes("$home/backup.zip");

// Straight to a file of the PC
robot.Rws.File.GetFileToDestination("$home/backup.zip", @"C:\temp\backup.zip");


// As a stream, to copy the content without keeping a second copy of it
using (Stream source = robot.Rws.File.GetFileAsReadonlyStream("$home/backup.zip"))
using (FileStream destination = System.IO.File.Create(@"C:\temp\backup.zip"))
{
    source.CopyTo(destination);
}

// From a string, UTF-8 by default
robot.Rws.File.UploadFileFromText("$home/notes.txt", "Written by the SDK");

// From raw bytes
robot.Rws.File.UploadFileFromBytes("$home/data.bin", new byte[] { 1, 2, 3, 4 });

// From a file of the PC
robot.Rws.File.UploadFileFromPath("$home/MyModule.mod", @"C:\temp\MyModule.mod");

// From a stream, for a large file
using (FileStream source = System.IO.File.OpenRead(@"C:\temp\MyModule.mod"))
{
    robot.Rws.File.UploadFileFromStream("$home/MyModule.mod", source);
}

// Check the backup before restoring it
CheckRestoreResult check = robot.Rws.Controller.CheckRestore("$temp/mybackup");

if (!check.IsAccepted)
{
    Console.WriteLine($"The backup cannot be restored : {check.Status} {check.Path}");
    return;
}


// The controller restarts as soon as the restore is accepted
robot.Rws.Controller.RestoreBackup("$temp/mybackup");

// A backup taken on another controller has a different system id.
// Ignore the mismatch to restore it anyway, and keep the backup folder.
robot.Rws.Controller.RestoreBackup("$temp/mybackup",
                                   BackupRestoreIgnore.SystemId,
                                   false);

// Restore only the RAPID modules, not the configuration
robot.Rws.Controller.RestoreBackup("$temp/mybackup",
                                   BackupRestoreIgnore.All,
                                   true,
                                   true,
                                   true,
                                   BackupRestoreInclude.Modules);