Skip to content

Instantly share code, notes, and snippets.

@cabal95

cabal95/RockIt-SDK-Upgrade.md

Last active March 24, 2017 21:45
Show Gist options
  • Save cabal95/4bf31632bef3a16369a84498df96a6e9 to your computer and use it in GitHub Desktop.
Save cabal95/4bf31632bef3a16369a84498df96a6e9 to your computer and use it in GitHub Desktop.
Download ZIP
Steps I had to take to upgrade RockIt SDK from 5.0 to 6.2
Raw
RockIt-SDK-Upgrade.md
  1. Take a snapshot of your dev environment. I had to roll back a couple times even with following these steps.
  2. Update all projects in solution to reference DLLs inside the RockWeb folder rather than using NuGet package references.
    a. This means remove all the non-system (i.e. referencing C:\Program Files...) DLLs and re-add them to point at the RockWeb\bin*.dll version of the files.
    b. You will also need to remove any packages from the packages.config of the project(s).
  3. Update all projects in solution that reference RockWeb DLLs to be set to Copy Local = False
  4. Clean Solution from Build Menu
    a. Set Configuration to Debug and then Clean Solution.
    b. Set Configuration to Release and then Clean Solution.
    c. Set Configuration back to Debug.
  5. Delete all RockWeb/bin/???.dll.refresh files.
  6. Build and Run RockWeb
  7. Attempt upgrade to latest version of SDK. If upgrade fails with file in use error then you will need to do the upgrade without Visual Studio.
    a. To upgrade without Visual Studio open a command prompt.
    b. cd "C:\Program Files\IIS Express"
    c. iisexpress /site:RockWeb
    d. Open your browser and navigate to normal Rock SDK URL and perform upgrade.
  8. Update the RockWeb .NET version if needed
  9. Clean Solution again (both Debug and Release)
  10. Delete the packages folder (NuGet cache) from the solution folder.
  11. Run the RockWeb site and hope you didn't miss anything.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment