Table of Contents
Last updated: 2024-06-26

Migration


Install/Uninstall and settings scripts referenced in this article can be found here.

Migration impact levels


  • 8 New ShareAspace model upgrade
    • ShareAspace model has changed
    • Frameworks / pre-requirements have changed in a non-backwards compatible way
    • Data migration required / custom mappers rebuilt
    • API integrations need to be updated / verified
    • Interaction documentation revised / changes to customer documentation required
  • 7 Full environment upgrade
    • Frameworks / pre-requirements have changed in a non-backwards compatible way
    • Data migration required / custom mappers rebuilt
    • API integrations need to be updated / verified
    • Interaction documentation revised / changes to customer documentation required
  • 6 Full product upgrade
    • Data migration required / custom mappers rebuilt
    • API integrations & configurations need to be updated / verified
    • Interaction documentation revised / changes to customer documentation required
  • 5 DataStorage / Layout upgrade
    • Data migration required / custom mappers rebuilt
  • 4 Full external upgrade
    • API integrations & configurations need to be updated / verified
    • Documentation revised / changes to customer documentation required
  • 3 External integration upgrade
    • API integrations & configurations need to be updated / verified
  • 2 External process upgrade
    • Documentation revised / changes to customer documentation required
  • 1 Internal upgrade
    • Only major revision changes to non-exposed components

Backup/restore installation without changing version


By file

Backup | |Task |Role |Script |Comment | |--|------------------------------------|------------------|------------------|--------| |1.|Stop ShareAspace Host service |Installation admin| |Optional| |2.|Backup folders |Installation admin|folders-backup.ps1| | |3.|Start ShareAspace Host service |Installation admin| | | Restore | |Task |Role |Script |Comment | |--|-----------------------------------|------------------|-------------------|--------| |1.|Stop ShareAspace Host service |Installation admin| | | |2.|Restore folders |Installation admin|folders-restore.ps1| | |5.|Start ShareAspace Host service |Installation admin| | |

Migrate installation for impact levels 1-2


By file

Task Role Script Comment
1. Stop ShareAspace Host service Installation admin
2. Backup configuration files Installation admin settings-fetch.ps1
3. Uninstall old MSI:s Installation admin msi-uninstall-all.ps1
4. Install new MSI:s Installation admin msi-install-all.ps1
5. Restore configuration files Installation admin settings-deploy.ps1
6. Start ShareAspace Host service Installation admin

Migrate installation for impact levels 3-4


By file

Task Role Script Comment
1. Stop ShareAspace Host service Installation admin
2. Backup configuration files Installation admin settings-fetch.ps1
3. Uninstall old MSI:s Installation admin msi-uninstall-all.ps1
4. Install new MSI:s Installation admin msi-install-all.ps1
5. Restore configuration files Installation admin settings-deploy.ps1
6. Start ShareAspace Host service Installation admin
7. Upload new DataExchange tasks Installation admin

Migrate installation for impact levels 5-7


By file

Task Role Script Comment
1. Stop ShareAspace Host service Installation admin
2. Backup folders Installation admin fetch-folders.ps1
3. Backup configuration files Installation admin settings-fetch.ps1
4. Uninstall old MSI:s Installation admin msi-uninstall-all.ps1
5. Install new MSI:s Installation admin msi-install-all.ps1
6. Restore configuration files Installation admin settings-deploy.ps1
7. Run migration tool Installation admin
8. Restore folders Installation admin
9. Start ShareAspace Host service Installation admin
10. Upload new DataExchange tasks Installation admin

Level 8 migration from ShareAspace 1.7 to ShareAspace 1.8


Note

Migration path and migration tooling for moving from ShareAspace 1.7 to ShareAspace 1.8 will be added in future service pack release on ShareAspace 1.8.