# 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](https://snow-mirror.com/snowmirror-drive/public/v2.0/admin_guide_2.0.html)
- [User Manual](https://snow-mirror.com/snowmirror-drive/public/v2.0/user_guide_2.0.html)

# 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

![image3.png](../assets/images/User guide/image3.png)

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

![image105.png](../assets/images/User guide/image105.png)

  - Click "Preview Update Set Batch"

![image107.png](../assets/images/User guide/image107.png)

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

![image108.png](../assets/images/User guide/image108.png)

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

![image109.png](../assets/images/User guide/image109.png)
![image110.png](../assets/images/User guide/image110.png)

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

![image111.png](../assets/images/User guide/image111.png)
![image112.png](../assets/images/User guide/image112.png)

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

![image12.png](../assets/images/User guide/image12.png)

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

![image45.png](../assets/images/User guide/image45.png)

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).

![image46.png](../assets/images/User guide/image46.png)

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

![image47.png](../assets/images/User guide/image47.png)

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

![image48.png](../assets/images/User guide/image48.png)

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

![image49.png](../assets/images/User guide/image49.png)

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.


![image50.png](../assets/images/User guide/image50.png)

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

![image51.png](../assets/images/User guide/image51.png)

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.

![image52.png](../assets/images/User guide/image52.png)

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

![image53.png](../assets/images/User guide/image53.png)

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

![image54.png](../assets/images/User guide/image54.png)

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

![image55_2.png](../assets/images/User guide/image55_2.png)



### 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

![image3.png](../assets/images/User guide/image3.png)

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"

![image5.png](../assets/images/User guide/image5.png)

  - Preview Update Set

![image6.png](../assets/images/User guide/image6.png)

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

  - Once there are no conflicts commit the update set

![image7.png](../assets/images/User guide/image7.png)


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

![image8.png](../assets/images/User guide/image8.png)
![image9.png](../assets/images/User guide/image9.png)

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

![image111.png](../assets/images/User guide/image111.png)
![image112.png](../assets/images/User guide/image112.png) 