# About this guide

This is the installation guide for the SnowMirror Drive product. For complete documentation, please refer to the Admin and User Guide. - Admin Guide - User Manual

# Manual Installation through Update Sets guide

Each release has 2 different version PATCH and FRESH INSTALL

### Fresh Install:

- Should be used when the application is not yet installed on the instance
- Contains all the changes for the specific version, contains all system properties, but some have empty values that needs to be filled as part of the installation
- Ensures that the application can be installed on a brand new instance, contains everything

#### Installation Steps

Go to "Retrieved Update Sets" > Click on "Import Update Set from XML" > Select the XML file that contains the version you want to upload and upload it

1 - Import the XML file - If the XML has been imported successfully, open the record with it's name that is on state "Loaded"

- Click "Preview Update Set Batch"

- If there are any conflicts, just click on "Accept remote update" for each

- Once there are no conflicts click "Commit Update Set Batch"

2 - The fix script called `GVS_OFFLOAD Setup Application` needs to be executed as it initializes some of the parts of the application - Use the option "Proceed in Background" while running it - This script can take up to a few minutes to finish

3 - Swap to "Data offloader" scoped application, needed to edit properties in the configuration and to run the fix script without any issue

4 - Go to "SnowMirror Drive > Workspace > Settings"

5 - In the "Basic Setup" menu go through each section:

- The first is "Delete attachment data". Check the checkbox if you want to delete them after the upload (checked by default).

- Then specify how many days attachments should remain in ServiceNow (7 days by default).

- In the next section define the tables you want to exclude from the upload (only entitlement_data by default).

- The last setting is to enter the SnowMirror Drive application license key. Please reach out to SnowMirror Drive support to acquire a license key.

6 - In the "Storage Setup" menu click on "New" and set up at least 1 Azure or AWS remote storage for the application by going through the steps. You can find detailed scenarios under [Configuration of Storages] in the User Guide.

7 - (Optional) In the "Advanced Setup" menu go through the settings and change them if needed.

8 - Go to "SnowMirror Drive > Workspace > Attachment rules" and click "Create New Attachment Rule". You can find detailed scenarios under [Configuration of Attachment Rules]in the User Guide.

9 - Fill the Name, Storage and Table fields, and add condition if needed. Click "Submit"

10 - Enable the Attachment Rule by the Enabled/Disabled toggle on the panel.

11 - Go to "SnowMirror Drive > Workspace > Home" under the "Transfer status" tab enable the automatic upload of attachments

### Patch Version Install

- Should be used when the application is already installed on the instance
- Contains all the changes for the specific version, but doesn't overwrite anything specific for the instance
- Only includes the 2 XML for the scoped and global applications

#### Installation Steps

Go to "Retrieved Update Sets" > Click on "Import Update Set from XML" > Select the XML file that contains the version you want to upload and upload it

1 - Import the Global XML file - If the XML has been imported successfully, open the record with it's name that is on state "Loaded"

- Preview Update Set

- If there are any conflicts, just click on "Accept remote update" for each

- Once there are no conflicts commit the update set

2 - Import the Scoped XML file - If the XML has been imported successfully, open the record with it's name that is on state "Loaded" - Preview the record - If there are any conflicts, just click on "Accept remote update" for each - Once there are no conflicts commit the update set

3 - (Optional) The fix script called "GVS_OFFLOAD Setup Application" can be executed as it runs some of the jobs which are responsible for refreshing the data on the Workspace