Loading...
Area: Episerver Customer-Centric DXP
Applies to versions: Not applicable

Self-service troubleshooting

Recommendations [hide]

This topic provides guidance for handling issues that might occur during deployment through the DXP Management Portal with Episerver Customer-Centric Digital Experience Platform (DXP). Issues are often related to performance, storage, or configuration issues. 

If you have issues when deploying to Production and need urgent assistance, contact Episerver (24/7): Worldwide: +46 8 555 827 50; North America: 1-(877)-383-0885 (Toll Free); United Kingdom: +44 800 066 4784 (Toll Free); Australia: +61 2 9248 7215.

The file size of web app is too big (over 900 MB)

To enhance performance, scalability and management, you should store all content on DXP web apps using BLOB storage (and/or SQL database). The web app's local file system is meant for code only, and therefore normally does not have large amounts of disk space. 

To improve stability and performance further, the underlying web app is using local cache, which also has a limited size; see Azure App Service Local Cache overview (Microsoft). This limit is currently set to 900 MB.

The deployment engine for DXP verifies that the web app is below this limit. If the limit is exceeded, it may affect the ability to swap a new slot into production, and the time it takes to warm up a new instance during scale outs, and the reliability of backups, to name a few examples.

The implementation of an ipSecurity section in web.config

This is not supported because it will not work reliably in DXP. See Restricting environment access for information about implementng IP restrictions in a supported way.

Metadata file could not be found for DXP Service

During DXP deployment to preproduction or production environments, the following error message may appear when the application starts: 

error CS0006: Metadata file 'D:\local\Temporary ASP.NET Files\root\X\X.dll' could not be found.

The dll is most often App_Code.dll or App_global.asax.dll but it may be any top-level file.

Note: Top-level files include the global.asax file and all files in the bin and App_Code folders.

If this error occurs, set the optimizeCompilations attribute of the compilation element in web.config to false.

For DXP Service, optimizeCompilations does not improve anything; you cannot update individual files without restarting an app service because the App Service Local Cache feature is enabled. Also, the deployment flow always deploys to an empty wwwroot in the slot that is in a stopped state, and after files are deployed, it starts up and warms up; that starts the compilation (for preproduction and production environments). See also: Understanding ASP.NET Dynamic Compilation.

Do you find this information helpful? Please log in to provide feedback.

Last updated: Apr 02, 2020

Recommendations [hide]