{"ArticleId":null,"Name":"Where to start when something is wrong","Content":"\n\u003Cp\u003EMost problems have one of a handful of causes. Before you dig deeper, go through this routine - it solves or narrows down the majority of cases.\u003C/p\u003E\n\n\u003Ch2 id=\u0022routine\u0022\u003EThe routine\u003C/h2\u003E\n\u003Col\u003E\n\u003Cli\u003E\u003Cstrong\u003ERead the System information warnings.\u003C/strong\u003E \u003Cstrong\u003ESystem \u2192 System information\u003C/strong\u003E checks the store URL, primary currencies, weight and dimension, and payment methods. Fix anything that is not green.\u003C/li\u003E\n\u003Cli\u003E\u003Cstrong\u003ERead the log.\u003C/strong\u003E GrandNode logs through .NET logging - the console, \u003Ccode\u003Edocker logs\u003C/code\u003E, the IIS stdout log or Application Insights, depending on hosting. An exception message names the cause far more often than the symptom suggests. See \u003Ca href=\u0022/system-maintenance\u0022\u003EMaintenance tools and logs\u003C/a\u003E.\u003C/li\u003E\n\u003Cli\u003E\u003Cstrong\u003EClear the cache.\u003C/strong\u003E Gear menu \u2192 \u003Cstrong\u003EClear memory cache\u003C/strong\u003E, especially after changing data outside the admin.\u003C/li\u003E\n\u003Cli\u003E\u003Cstrong\u003ECheck the store scope.\u003C/strong\u003E On a multi-store installation, a setting saved for one store overrides the shared value for the whole settings group. Look at the setting with that store selected.\u003C/li\u003E\n\u003Cli\u003E\u003Cstrong\u003ERestart\u003C/strong\u003E (gear menu \u2192 \u003Cstrong\u003ERestart application\u003C/strong\u003E) after installing plugins, editing \u003Ccode\u003Eappsettings.json\u003C/code\u003E or changing scheduled tasks.\u003C/li\u003E\n\u003Cli\u003E\u003Cstrong\u003EReproduce in a private window\u003C/strong\u003E, to rule out the browser cache and your own customer session.\u003C/li\u003E\n\u003C/ol\u003E\n\u003Cfigure\u003E\u003Cimg src=\u0022/Plugins/Theme.GrandNodeCom/Content/kb/system/system-info.webp\u0022 alt=\u0022System information with version, environment, server time, paths and the Warnings list\u0022 width=\u00221440\u0022 height=\u0022981\u0022 loading=\u0022lazy\u0022\u003E\u003Cfigcaption\u003ESystem \u2192 System information: the warnings at the bottom are the first thing to check.\u003C/figcaption\u003E\u003C/figure\u003E\n\n\u003Ch2 id=\u0022report\u0022\u003EReporting a problem\u003C/h2\u003E\n\u003Cp\u003EWhen you ask for help - in GitHub Discussions or from your support provider - include:\u003C/p\u003E\n\u003Cul\u003E\n\u003Cli\u003Ethe GrandNode version and git commit from System information, and the hosting (Docker, IIS, Linux);\u003C/li\u003E\n\u003Cli\u003Eexact steps to reproduce and what you expected;\u003C/li\u003E\n\u003Cli\u003Ethe full error from the log, not a screenshot of the error page;\u003C/li\u003E\n\u003Cli\u003Ewhich plugins and theme are active.\u003C/li\u003E\n\u003C/ul\u003E\n\n\u003Ch2 id=\u0022related\u0022\u003ERelated\u003C/h2\u003E\n\u003Cul\u003E\n\u003Cli\u003E\u003Ca href=\u0022/system-overview\u0022\u003ESystem tools: an overview\u003C/a\u003E\u003C/li\u003E\n\u003Cli\u003E\u003Ca href=\u0022/system-appsettings\u0022\u003EApplication settings (appsettings.json)\u003C/a\u003E\u003C/li\u003E\n\u003C/ul\u003E\n","ParentCategoryId":"6abe3a3b04b9d0a2009fec01","SeName":"troubleshooting-first-steps","MetaKeywords":null,"MetaDescription":"A short routine for diagnosing GrandNode problems: system warnings, the log, cache, store settings, restart, and what to put in a report.","MetaTitle":null,"AllowComments":false,"Captcha":{"ReCaptchaChallengeField":null,"ReCaptchaResponseField":null,"ReCaptchaResponseValue":null,"ReCaptchaResponse":null},"RelatedArticles":[],"CategoryBreadcrumb":[{"Name":"Troubleshooting and FAQ","Description":null,"IsCurrent":false,"Children":null,"Parent":null,"SeName":"docs-troubleshooting","Id":"6abe3a3b04b9d0a2009fec01","UserFields":[]}],"AddNewComment":{"CommentText":null,"DisplayCaptcha":false,"Id":null,"UserFields":[]},"Comments":[],"Id":"6abe3a3b04b9d0a2009fec03","UserFields":[]}