Vinyl upgrade guide¶

Introduction¶

This is the instruction guide for upgrading an existing installation of Vinyl to version 3.0+. If you are installing for the first time, please refer to the installation instructions for your Vinyl version and server system.

This guide assumes that the root directory for the currently installed version of Vinyl is C:\inetpub\wwwroot\Vinyl and that the system already has the prerequisite software and framework installed and configured.

Prerequisites¶

Microsoft .NET Framework 4.7.2 or higher is required for Vinyl 3.0 or higher. Earlier versions of .NET Framework are not supported with Vinyl 3.0 or higher. This prerequisite should be checked if you are upgrading from Vinyl 2.6 or lower and confirmed prior to upgrading to the current version of Vinyl.

To check the .NET version currently installed:

• Powershell command to check .NET version:

  Get-ChildItem "HKLM:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\" | Get-ItemPropertyValue -Name Release | ForEach-Object
  

• If Powershell command does not work, follow Microsoft's article to check and determine version:

  https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed

Upgrade instructions¶

Preparing for upgrade¶

1. Make a note of the current Vinyl version you are running, in case you need to restore to this version.

2. Stop IIS. You can do this by entering the IIS Manager, selecting the appropriate web server, and clicking the Stop button at the top right of the Actions pane.

3. Backup your database(s) in case you need to recover them later.

Deploying new software¶

1. Download the archive (Vinyl-3.0.xxxxx.zip).

2. Move the contents of your previous Vinyl root directory to a backup folder.

3. Extract the new archive to a temporary directory (e.g. C:\Vinyl-3.0.xxxxx)

4. Copy the contents of the website directory to the Vinyl application root directory (e.g. C:\inetpub\wwwroot\Vinyl).

   Note

   On this step, be sure to drill into the folder structure until you see contents under website.

5. Copy the Connection.xml file from your backup directory into the Vinyl bin directory.

6. If you have any customizations in the Config directory, copy over these to the new Config directory.

7. Delete the temporary directory you created.

Configuration¶

1. Open the IIS Manager

2. Expand the Vinyl folder.

3. Right click the App_Data folder and choose the Edit Permissions... option.

4. Select the Security tab.

5. Click the Edit button to launch the Permissions for App_Data dialog box.

6. Click the Add... button to launch the Select Users or Groups dialog box.

7. Provide the name IIS AppPool\Vinyl in the bottom field.

8. Check Allow Full Control in the Permissions field, then click the OK button to close the Permissions for App_Data dialog box.

9. Click the OK button to close the App_Data Properties dialog box.

10. Restart IIS by selecting the server and clicking the Start button in the Actions pane.

Suggested test sequence¶

1. Launch your web browser.

2. Navigate to http://localhost/Vinyl/

3. Vinyl will automatically update the database(s). The system will begin responding normally once the upgrade completes.