Content Comparison

Overview

These are the steps to update Unity manually which is a to copy/paste over the current files on the customer’s Unity server. The majority of customers are setup All Unity instances for commerce are set up to auto-deploy Unity but Sugarbush and Killington still need to be done manually and sometimes new customers may not be setup for auto-deploy yet. Also sometimes the auto-deploy fails for various reasons. Typically dev ops will ask us to manually update Unity.

Instructions

...

Download Unity_drop.zip from file share. You may need to be granted access to this Azure location.

1. https://portal.azure.com/#blade/Microsoft_Azure_Storage/ContainerMenuBlade/overview/storageAccountId/%2Fsubscriptions%2F34c7ba34-f99c-4fc6-ad3b-2c242a94701a%2FresourceGroups%2FAspenwareUnity%2Fproviders%2FMicrosoft.Storage%2FstorageAccounts%2Funityfileshare/path/aspenwareunityappliance/etag/"0x8D77EB0014413B1"

Newest Unity build ends up in one of these two folders:

...

Look for the date/time that is closest to when dev ops kicks off the build. Sometimes it ends up in _develop and sometimes it ends up in _master.

...

we still manually update/deploy Unity for the scanning app and sometimes for the Unity instance resort tools is using.

Detailed Guide

1. Get correct version of Unity files

   1. To verify the version, check the build.json file

2. Connect to customer’s Unity server (connections are in Last Pass) and upload

...

1. files (I typically put in Downloads directory but it can go anywhere).

2. Open IIS (Internet Information Services) and locate the instance that needs to be updated.

3. Stop the Application Pool being used by the Unity instance

   1. Click the entry under Sites (i.e. UnityTestEldora below) and select Basic Settings to see which App Pool is being used

   2. Image ModifiedImage Modified

      From the main IIS window, click Application Pools and find the entry on the right and click Stop (or right click to select Stop)

   3. Image Modified

4. Navigate to main IIS page and right click on Site (i.e. UnityTestEldora) and select Explore to go to the location of the Unity files.

5. Unzip uploaded Unity

...

1. files

2. Backup existing files. I usually copy files and put in Downloads directory (i.e. UnityProd_backup_20210318) but they can be copied anywhere.

3. Copy

...

1. UnityAPI.Web - File Type: Application

2. All .dll’s - File Type: Application Extension

3. UnityAPI.Web.exe - File Type: CONFIG File

4. build - File Type: JSON File

5. UnityAPI.Web - File Type: XML Document

...

Restart IIS App Pools

...

1. all new files except:

   1. Config directory - not used so no need to copy over

   2. Logs directory

   3. appsettings.json - contains customer specific values

   4. identity-config.json - contains customer specific values

   5. rtp-config.json - contains customer specific values

   6. siriusware-config.json - contains customer specific values (only exists for SW customers)

      Image AddedImage Added

2. Start app pool.

3. Test updated Unity instance in Swagger (Doc: How to Test Unity in Swagger )

4. Test logging into site (if applicable)

Versions

As of 12/10/2024, the min version of Unity needed for the scanning app v1.1.29 (or greater), is v3.47 which is attached below. This attachment does not include the config files, rtp-config.json, appsettings.json or identity-config.json (so therefore this cannot be used for a new install).