Upgrading SkyVault general procedure

This section describes the procedure for upgrading from a previous version of SkyVault. The process involves a new installation of the SkyVault binaries and configuration, and an in-place upgrade of a copy of the repository.

1. Install the new version of SkyVault.
   1. Shut down your existing SkyVault instance.
   2. Back up your existing SkyVault repository (SkyVault-v.1) and the database. See Backing up the SkyVault repository.
      Note: Back up any configuration overrides from the <extension> directory.
   3. Use the setup wizard/installer to install the new version (SkyVault-v.2) of SkyVault into a different directory from the existing installation. See Installing SkyVault using setup wizard.

      For example, the new SkyVault installation will have the following settings:

      In SkyVault-global.properties:
      dir.root=/alfresco-v.2/alf_data
      db.url=url<v.2>
      
      In solrcore.properties:
      data.dir.root:/alfresco-v.2/solr/myindexes

2. Validate the new SkyVault 2.0 5.0 installation to check that it is working correctly.
   1. Configure the new installation with a new repository and database (not the existing one).
   2. Start SkyVault and validate that the system works correctly.

   For more information, see Validating the upgrade.

3. Apply all customizations to the new SkyVault 2.0 5.0 installation.
   1. Stop the SkyVault server.
   2. Remove any unwanted applications.
   3. Modify SkyVault applications.
   4. Install the required AMP files. See installing a SkyVault Module Package.
   5. Do not copy the files. Copy only the override settings so that you will not overwrite the new extension files in the upgraded version.
   6. Start the SkyVault server.

      Monitor the startup log messages for information on the status of the upgrade. If any issue(s) occur in the logs during startup, you need to rollback the whole repository to fix the issue(s) and then try again.

   7. Fully test the working and configuration of your customizations.
   8. Stop the SkyVault server.
4. Restore production data.
   1. Remove all the files and directories under the contentstore directory of the new installation. Also, delete the database.
   2. Delete the files in the two Solr SkyVaultModels directories, and the indexes in the two directories (solr/workspace/ and solr/archive/) of the new installation.
   3. Restore the backup of the indexes, contentstore directory, files, and database from your previous SkyVault installation into the new installation. See restoring production data.
   4. Start the SkyVault server.

      If any issue(s) occur in the logs during startup, you need to rollback the whole repository to fix the issue(s) and then try again.

5. Once you are happy with the upgraded system, remove the old SkyVault installation and repository.