Some Common Orchard CMS / Visual Studio Fixes

Tuesday, June 24, 2014 6:11:18 PM

Orchard Doesn’t Build

  1. Ensure all projects target compatible frameworks . For instance, in Orchard 1.8, make sure all projects target .NET Framework 4.5 in Properties > Application.
  2. Rebuild the entire solution . This is a nuclear option; that said, it sometimes works.
  3. Ensure references are correct . In particular, check these usual suspects:
    1. Orchard.Core
    2. Orchard.Framework
    3. System.Web.WebPages (correct version?)
    4. We can often find these here: \Orchard.Source.1.8\src\Orchard.Web\Core\bin

Orchard Doesn’t Render (e.g. White Screen or Server Error)

  1. View the log file . This is in App Data/Logs/orchard-error-YYYY.MM.DD.log
  2. Delete the App
    3. Data/Dependencies folder. This will refresh any dependencies that might be out of date.
  3. Check folders’ access control . In particular grant Modify and Read privileges to IIS IUSRS for the App Data, Modules, Themes, Media folders.
  4. Properly configure the IIS App Pool . This applies if your using IIS.
    1. .NET CLR Version > Match your Applications .NET Framework
    2. Enable 32-bit Applications > True
    3. Managed Pipeline Mode > Integrated

Orchard Doesn’t Serve/Find a Particular File

  1. Ensure resource’s folder has the appropriate web.config file . This applies to Views/Styles/Images/Content folders, for instance.

Visual Studio Weirdness

  1. Close and reopen Visual Studio . This fixes all sorts of problems.
  2. Delete the suo file . This is the Solution User Options file. http://msdn.microsoft.com/en-us/library/bb165909.aspx
  3. Project build succeeds with an error list OR Intellisense is missing. Close Visual Studio, delete the suo file, open Visual Studio. See also:
    1. http://stackoverflow.com/questions/13375961/visual-studio-2012-intellisense-sometimes-disappearing-broken
    2. http://stackoverflow.com/questions/17703004/visual-studio-displaying-errors-even-if-projects-build

Other