• Issue with Visitor Group Geographic Location criteria

    Description This article describes an issue when using the built-in (Geographic Location) criteria. The editor can see the personalized content in edit mode but not after logged out/when clicking on view on website. Resolution Make sure GeocityLite database is available in App_Data. Check in the IIS logs to see where's the real client IP come from e.g firewall, load balancer, proxy server etc...?http://blogs.iis.net/deanc/iis7-8-logging-the-real-client-ip-in-the-iis-hit-logsIf...

  • The settings property 'SubscriptionInfo' was not found

    Description This article describes an error in the Episerver workspace and how to disable it. The complete error message is regarding the EPiServer Subscription Job. Job: EPiServer Subscription Job (Hourly)Message: Exception has been thrown by the target of an invocation. [The settings property 'SubscriptionInfo' was not found.] Resolution Subscriptions were configurable and were available in Episerver CMS 6.0/R2  as seen here.  If you are not using the built-in subscription f...

  • Blob Application logging shows empty log

    Description In CMS 11, the integration environment is configured with Blob storage, log level information and is using Episervers Logging classes. When trying to log with the lines of code below, nothing shows up in the application logs.  @using EPiServer.LoggingILogger logger = LogManager.GetLogger(); logger.Debug("Some debug message"); logger.Error("Some error message"); logger.Information("Some info message"); Resolution In EPiserver CMS 11 ther...

  • Custom Cultures in Episerver DXC

    Description This article describes an issue with registering custom cultures in Episerver DXC. Resolution While it is possible to register a custom culture language locally using the CultureAndRegionInfoBuilder, it doesn't work in Azure WebApp. The CultureAndRegionInfoBuilder.Register method throws UnauthorizedAccessException. Since running Episerver DXC as a PaaS WebApp in a multi-tenant environment, this puts certain limitations on what can be changed on the OS level. These ...

  • Issue with visitor group Geographic Coordinate

    Description This article describes an issue when trying to set up a visitor group with a geographic location and have setup the Google Api but seeing the 'Google Maps API Terms of Service' pop up when trying to use it. The app key is setup as following: <add key="googleMapsApiV3Url" value="https://maps.googleapis.com/maps/api/js?key=AIzaSyCkPtIlRi3rEqG1MDY"/> Resolution Setting the key up this way is incorrect. Instead it should have it in application...

  • DataTime over different timezones.

    Description A customer runs a website which is hosted on Azure. For example West Europe (The Netherlands), this is also where the company is located. Now their question: When they enter a date in the Cms the date on the website is shown with a 2 hour difference. How do you fix the 2 hour difference issue? Resolution There are two solutions: Try to set the timezone of the webapp to the same timezone the company is in. They can set it under application settings in azure: WEBSIT...

  • How to troubleshoot EPiServer.Framework.Initialization.InitializationException

    Description An exception of type 'EPiServer.Framework.Initialization.InitializationException' occurred in EPiServer.Framework.dll but was not handled in user codeAdditional information: Initialize action failed for Initialize on class EPiServer.Data.DataInitialization, EPiServer.Data, Version=10.10.3.0, Culture=neutral, PublicKeyToken=8fe83dea738b45b7 Resolution This error indicates that there is a problem during initialization. It may be the code cannot accept data from the d...

  • Missing modules or packages when loading Episerver site

    Description If you see the following error see the resolution below Did not find a module by assembly 'EPiServer.GoogleAnalytics, Version=1.10.3.0, Culture=neutral, PublicKeyToken=null'Parameter name: moduleAssembly Resolution Usually when you first build a project it will build the necessary package updates. In some cases you may not have a package on first load or due to your own changes.  Right click on the solution and click "restore nuget packages."  If this fai...

  • Seeing other environment URLs under the Cloud Licenses screen

    Description When you navigate to the Cloud License tab of Manage Websites in the administration portal of Episerver you may see URLs that belong to environments you are not currently in (for example QA URLs in Production or Production in QA). Resolution This behavior is expected so don't be alarmed. If you use the same license.config file in multiple environments you will see a list of every URL you have authorized to use that license key. Since URLs are tied to a license key ...

  • Find UI is missing

    Description On a website with active directory membership and role provider active, the tab for Find is missing.  The Find tab relies on SearchAdmins group as well as WebEditors. Those groups cannot be created in Active directory and adding virtual roles for WebEditors and SearchAdmins does not work. Resolution In the <episerver.framwork> section of Web.config file try changing from: <virtualRoles addClaims="true"> to: <virtualRoles addClaims="fal...

  • Further information on DXC and caching mechanisms

    Description How does caching work under the hood for DXC sites? (on default setups) Resolution Default DXC sites do not use a distributed cache (such as Azure Managed Cache Service or Redis -  agreement must be made with episerver for this to be added). Each running application has its own instance of an in-process cache. When an item is evicted from cache in one running application instance (e.g. due to an content update) a message is sent to the other running instances (in DXC ...

  • Episerver Scheduled Mirroring Job Error: The connection was closed unexpectantly

    Description If the following error occurs during mirroring see below for a potential solution. Failure during export: The underlying connection was closed: The connection was closed unexpectantly Resolution This is likely due to a timeout. First to verify it is a timeout issue try reducing the amount of data moved by mirroring. To do that deleting the existing mirroring configurations(after noting their settings) in the mirroring configuration  found at admin > config >...

  • httpCacheVaryByParams values in web.config not honored

    Description When you set parameter names in the web.config's <applicationSettings> node's httpCacheVaryByParams value they appear to not be honored for caching when using the MVC version of Episerver. Resolution This setting in the web.config applies only to the Web Forms version of EpiServer, if you are using the MVC version this setting will not function. Instead you will need to use the built in ASP.Net MVC ContentOutputCache attribute at the action level in your cont...

  • Error when deploying to a DxC environment

    Description When viewing a newly published (local or in Azure) you may run into the following errors EPiServer.Framework.Initialization.InitializationEngine : Initialize action failed for 'Initialize on class EPiServer.Events.EventsInitialization, EPiServer.Events, Version=10.10.0.0, Culture=neutral, PublicKeyToken=8fe83dea738b45b7' EPiServer.ServiceLocation.ActivationException: Activation error occurred while trying to get instance of type EventProviderService, key "" ---> ...

  • Browsing to expired page defaults to 302 redirect instead of 404

    Description This article covers the issue on browsing expired pages and how these exceptions are handled. It will also cover the code resolution and workaround for earlier versions. The expected behavior is that when browsing to an expired page we should get a 404 but what we see is a 302 to login.  This is also relevant with commerce. Resolution This was an issue resolved in EPiServer.CMS.Core 10.0.1 as part of the escalation here. The recommended and supported resolution is ...

  • Mirroring Error: Failure during page package transfer

    Description Below are steps to troubleshoot the following mirroring error: Mirroring state: Failure during page package transferThe following errors occured:The type initializer for 'EPiServer.MirroringService.Common.RemoteEventsHandler' threw an exception. Resolution Verify that the assembly bindings in the mirroring site's web.config match the bindings versions of site it belongs to.  Verify the .dll files in the mirroring site match those of the site it belongs to.  Recycl...

  • Application Log Table Cleanup

    Description The Application Log table, dbo.ApplicationLog, is growing larger than you want and needs to be cleaned up. Resolution The Application Log table tracks ever time there is a change to content, either it being added, updated, or deleted, there is a log entry added to the table. If there are a lot of changes happening to content this can cause the table to swell fast. You can safely remove any or all data from the table, but we do recommend keeping the last 30 days of ...

  • License error after upgrade to CMS 11.x/Commerce 11.x

    Description If you upgrade your site and get a license error like: Current version 11.x.x is newer than the required version 10.65535 Resolution Then you need to get a new license file. You can contact licenseadmin@episerver.com

  • Linkvalidator does not complete the scheduled job

    Description 1. Can't load property type 'EPiServer.Fields.LongString, EPiServer.Fields'. 2. FAILED The scheme for the url "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASoAAADRCAIAAAD0emgWAAAgAElEQVR4nOydZ0AT2drHs9Xd9W6/u3vv3X636zbb2hV17b0gFlBAKQLSq9I7UqVKFQUEpPfee2+hJKSQEBKSkF4nmZnzfsC+6IKCd+978/ugw8w5M0+S+c+c8jzPwYCnBH1wG73z5/QGercE+nAxFSpUPARmAc6pkpwKFbNiIeSnQoWKWaGSnwoV/" in not http or https. Resolution Take a look at the following post and see if the suggestio...

  • Episerver and Bot Management

    Description Websites can have a sizable number of bots which can contribute to a large number of page views in analytics. This article provides information on mitigation of bots on the site. Resolution Episerver does not have a documented 3rd party Bot detection tool that unequivocally can be recommended and supported.  Bot Detection can be done programmatically as seen in example below: How do I detect bots programaticallyThe discussion moves towards a smart Robots.txt and we...

  • Selecting block rendering on a content area

    Description Problem: How to make the CMS display different "display options" for different Block / ContentArea fields. e.g: A news block that has multiple views: Detail, Call to Action, Summary with three display options for this block as well. In the Content Area that sits in side bar, one displays the summary display option. In the Content Area that sits in the center of a page the detail and summary display options should show. Resolution Based on this post https...

  • License errors and solutions for Episerver

    Description Known Episerver license errors and solutions. Resolution License ’xxxx’ is already active for a different instance on the current machine. Symptom: This errors shows up for Episerver Relate+ 2R2 sites when there are multiple communities installed. Solution: A hotfix is available i.e. #124397. Another solution is to load a specific Relate license for each Community. In your web.config, configure <episerver.community>'s <site>-element for the Relate site t...

  • Page loads slower after updating to .NET 4.7

    Description The following issue occurred in Microsoft's 4.7 .NET framework update.  "The internal implementation of System.Web.Caching.Cache uses Coordinated Universal Time (UTC) time-stamp for absolute expiration. But this particular Cache.Insert (string, object, CacheDependecy, DateTime, TimeSpan) Insert overload method does not make sure whether the expiration time is converted to UTC. Therefore, expiration for items that are inserted into the Cache object by using this overload...

  • The link you specified does not work. This may either be the result of temporary maintenance or an incorrect link

    Description After deploying to an Azure environment the following error message is thrown when attempting to access or log into the site. Page could not be loaded The link you specified does not work. This may either be the result of temporary maintenance or an incorrect link. Resolution This error is often thrown when multiplexing is set as the default providers are set to multiplexing, which is not supported within an Azure environment. Often changing the default providers r...

  • Cloud Flare not caching images when cache-control is public

    Description When images have a there Cache-Control header set to "PUBLIC" CloudFlare's CF-Cache-Status header is set to "MISS" causing images not to be served from the CDN cache even when the web.config file is properly configured to allow caching of images. Resolution This can sometimes be caused by JavaScript doing image handling or manipulation. This can be tested by disabling JavaScript in your browser and doing a hard refresh of the page using crtl+F5....

  • Uploading Blobs to Azure Storage with PowerShell

    This article describes the PowerShell command to upload local Blob storage to Azure Blobs  Resolution When uploading media in Episerver, the binary data are stored in a system called blob providers. By default, media are stored on disk in a folder located at <path_to-site>\App_Data\blobs. Moving all those Blobs to Azure is just one line of code in the Azure PowerShell console (just make sure the current directory is the blobs folder): ls -File -Recurse | Set-AzureStora...

  • Set <staticFile> Configuration in web.config to Ensure Latest Media Files Retrieved Client Side

    Media asset caching is controlled by configuration. The associated class that handles this is EPiServer.Web.StaticFileHandler. This class inherits from MediaHandlerBase which is in the same namespace as StaticFileHandler. Within MediaHandlerBase there is a method called SetCachePolicy which takes into account the configuration in web.config. Here is the comment in the decompiled source: /// <summary> /// Configures cache policy of a static file based on configuration ...

  • Reusing the same License.config file across multiple Episerver sites in your local environment

    If you have a local environment where you have added multiple episerver sites in IIS, it can save you time to use the same License.config file across all sites. For example, let us say you went to license.episerver.com. You created and downloaded a partner developer license that was bound to your machine's MAC address. Instead of creating a new license for each site you add after the fact, you can just use the same one by referencing it with a bit of configuration. In addition, if t...

  • Preview unavailable in edit mode

    No preview in edit mode. Instead the users see this text: Preview Unavailable Failed to load the preview within the given time constraints. Cause The server took to long to return the preview. The default preview timeout is 15 seconds. Resolution Update the preview timeout by adding this configuration in web.config: <appSettings> <!-- Set iframe timeout to 20 seconds --> <add key="episerver:ui:PreviewTimeout" value="20000" /...

  • Episerver recycle bin(trash) appears to be blank

    The recycle bin appears empty when attempting to view the permissions as an admin user, despite the entries in the database. Cause Improper permissions for the recycle bin can cause this issue. The following image shows default permissions that may not allow web admins to view files there.  Resolution Add the WebAdmins role to the recycle bin with the Read/Create/Change permissions. If the user needs to be able to empty recycle bin (Empty Trash), add the Delete permi...