Archive and Restore Repository Projects

Archive projects contained in a repository and restore projects that were previously archived. Archiving a repository project means compressing the content of a project into a *.vsc file. Either archive the complete version of a project, including the modification history and all comments, or archive the latest version of a project checked into a repository. Then restore the archived file in another repository. The archived file can then be restored in another repository. Performing updates or connecting to controllers is unavailable after restoring a project archived at the latest version.
TIP: To reduce the time taken to perform archive and restore operations, have a different repository folder for each project.
Restore AADvance projects archived with
AADvance-Trusted SIS Workstation software®
version 1.1 or
AADvance® Workbench
version 2.1. Projects archived from
AADvance-Trusted SIS Workstation software
version 1.1 cannot be restored in previous versions of the
AADvance Workbench
or
AADvance-Trusted SIS Workstation software
.
TIP: Before archiving a project at the latest version, it is recommended to label the version of the project, ensuring the version control history displays the expected description after project restoration.
To archive and restore repository projects
To start
AADvance-Trusted SIS Workstation software
with the
Windows
administrator privileges required for AADvance projects, right-click the
SIS Workstation
Windows
desktop shortcut and select
Run as administrator
. Then, continue with one of the procedures in this table.
Task
Procedure
Archive a repository project
  1. From the required view, select the project to archive.
  2. From the
    File
    menu, point to
    Version Control
    , and then click
    Archive
    .
  3. In the
    Archive Project
    dialog box, indicate whether to archive the complete project history or the latest version, and then click
    Archive
    .
  4. In the
    Save As
    dialog box, specify a name and storage location for the archive file, and then click
    Save
    .
Restore a repository project
Restore AADvance projects archived with
AADvance-Trusted SIS Workstation software
version 1.1 or
AADvance Workbench
version 2.1.
TIP: Before restoring the project, limit the Projects location path length to 70 characters. Setting a longer path may exceed the maximum length of 260 characters supported by
Windows
operating systems.
When setting the project location, specify a local path; network paths may cause unexpected results.
  1. From the
    File
    menu, click
    New Project
    .
  2. In the
    New Project
    dialog box, from the
    AADvance
    tab, click
    Restore
    in the
    Project Types
    .
  3. In the
    Templates
    list, click the
    Restore Project from an Archive
    template, and then click
    Browse
    .
  4. In the
    Select Archive File
    dialog box, locate the project archive, and then click
    Open
    .
  5. The default name and storage location for archive files is the project name and folder.
  6. In the
    New Project
    dialog box, click
    OK
    .
  7. (Optional) To update the project, perform a Get version on the download or update actions that correspond to the application version running on the controller.
Restore multiple versions of the same project
When restoring multiple versions of the same project, the AADvance project archive significantly increases in size.
  1. At the production site, archive the live project.
  2. On the engineering computer, delete the old application from the AADvance Projects directory.
  3. Create a new repository folder. Select
    File
    >
    Version Control
    , click
    Select Repository
    , and browse to select the new repository.
  4. Restore the archived file.
  5. Make the required changes and then build the project.
  6. Check in all pending changes and then archive the project.
  7. At the production site, delete the old application from the AADvance Projects directory.
  8. Create a new repository folder. Select
    File >
    Version Control
    , click
    Select Repository
    , and browse to select the new repository.
  9. Restore the archived file and perform a
    Build All
    command.
  10. Perform a Get version on the download or update actions that correspond to the application version running on the controller.
  11. Perform an update on the controllers.
From the
Application View
, perform version control operations for all elements. From the
Communication View
and
Equipment View
, perform version control operations for projects and controllers.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal