This article describes an error that can show up in an Ektron site but is not limited to Ektron site. The error message would appear in the application event viewer.
Message: EkContent.MakePageBuilderRequest Exception : The remote server returned an error: (407) Proxy Authentication Required.
This issue can be resolved by adding useDefaultCredentials=”true” to the <defaultProxy> tag. For example:
<system.net> <defaultProxy enabled="true" useDefaultCr...
In 9.10, the button to add adaptive image breakpoint sets does not function. Use the workaround in the solution until a fix is released.
Enter http://<yourHostName>/workarea/mobilesettings/addeditbreakpoint.aspx in your browser.
Add breakpoints and click Save .
Return to the adaptive image settings section of the workarea (making sure that you refresh).
Check off the new breakpoints to enable them.
Modify the height and width of the breakpoint and click ...
For security reasons, external XSLT files with customized XSLT might not work with the Content Block server control's DisplayXSLT. This document describes how to add your acceptable XSLT to Ektron.
To add acceptable xslt files to the whitelist for Ektron to process, follow these steps.
1. In your site root folder, create a whitelist XML file. In it, place all customized, acceptable xslts within elements. In this example, you create a xml file named "myxsltwhitelist...
DescriptionThis article covers how to add a new template to the CMSResolution
Open the workarea folder.
Navigate to settings > configuration > template configuration
Click add new template to system
Specify the template location or click the elipsis to browse the site root to find it.
Fill out the name
If the template is a pagebuilder wireframe template, check off the checkbox and select available widgets.
Fill in other fields as needed and click Add new template to system.
In rare instances there has been an issue on 9.0 - 9.1 sites with device detection set to true where CPU usage quickly escalates to near 100%. Due to the high consumption of resources a thread abort error is given and the application pool may crash.
To identify if this is your issue, please check the following:
1. Check your device detection value. Identify if it is set to true.
2. Check your event viewer logs. Check under "Windows Log...
When you click on the "+ or" button to add a new condition for use in the Targeted Content Widget nothing happens.
There is a known bug in the Ektron Targeted Content Widget that, under certain conditions, will prevent users from being able to add new conditions using the "+ or" button from the widget. This bug was fixed in the Ektron 9.2 SP2 release and if you are experiencing it you will need to upgrade to resolve this issue.
You can download the lates...
Canonical URLs are a method for improving the SEO of pages that contain multiple URLs pointing to the same pice of content.
The Ektron product line does not currently have an out of the box method for setting Canonical URLs for content items with multiple URLS pointing to the same destination.
There are options to configure rewrite rules for 301 redirects, but if canonical URLs would be needed they would need to be done via IIS or within a web.config...
After debugging a website or moving over settings from a configuration file, the compilation debug key is set to true or left as true by mistake in a production environment. The key is not recommended to be set to true in a production environment as it can cause some severe performance issues.
To check to see if the key is set and to disable it, please follow these steps.
Open the web.config file in the site rootSearch for If the value is set to true, chang...
This article describes the different variations of the editors and how to change the default editor available when editing content in the cms.
Allow users to choose which editor they want to use by editing the web.config file in the site root, search for the add tag named : ek_EditControlWinBy default the value will either be ContentDesigner, EWebEditPro, or Aloha depending on your version. Change the value key to reflect what editor you'd like to use. (not...
When using the Membership server control in Reset Password mode, a membership user who clicks the reset button to reset his or her password sees this message:"Your password has been reset. If E-Mail notification is enabled in your CMS400.Net General Settings screen, an email will be sent to you. If E-Mail notification is not enabled in your system, please contact your system administrator."This article explains how to change this message.
1) Copy Microsoft'...
DescriptionThis article will go over how to clear out aliasing cacheResolutionAliasing cache can be cleared in two different ways.
In the workarea navigate to settings > configuration > url aliasing > settings and click on the clear cache button.
In the workarea navigate to settings > configuration > setup > system. Click on the restart button.Note: This will cause the entire application pool to recycle clearing all cache on your site as well as causing the site to recompile.
This article describes an error message that happens when trying to configure AD in Ektron. The full error is seen below.
com: user prop not provided EmailAddr1 -HC[UserApi->UpdateAdMapping]
This issue occurs if the account used to configure AD is a non-Admin level account (like builtin). To resolve this issue please use the admin account or an admin level account.
The Builtin account is not by default an admin account. The intent for it is minimum ac...
The following information shows you how to convert from a website solution to a Web application project.
Ektron and Web Application Projects (Part 1)Ektron and Web Application Projects (Part 2)Ektron and Web Application Projects (Part 3)
DescriptionAfter you upgrade to 9.00 SP2 CU20, 9.10, or 9.10 SP1, pages that previously generated a custom 404 error now generate a
file not found
Locate your site's web.config file in your site root folder.
Find the <system.web> tag.
Add the following code before the closing tag and replace pathtocustomerrorpage.aspx with the path to your actual custom error page):
<customerrors mode="On" redirectmode="ResponseRedirect" defaultredirect="~/pathtocustomerrorpa...
DescriptionIn the Ektron product there are 3 notification engines. Each has its own roles and responsibilities. Below we will discuss the difference between the notification service, system notifications, and web alerts. ResolutionSystem Notifications
System notifications are emails sent to users with updates to specific workarea or site functions. Most of the functionality is compiled in this list:
Information on setting up system notification emails can be found here.
You installed Site Cumulative Update (CU) 43 for version 8.6.1, or CU 28 for 9.00 SP2, and the DMS Auto-summary fix is not working as expected.
You must also modify web.config of a site to activate the changes.
Add the following keys to the <appSettings> section:<add key="ek_enableContentAutoSummary" value="" /> <add key="ek_enableDmsAutoSummary" value="false" />
Important! This article applies to the ewebedit400 editor only
Ektron provides a special screen that lets you create, update, and delete the standard dictionaries. To access this screen, use this URL: /siteroot/workarea/contentdesigner/dictionaryconfigurator/dictionaryconfigurator.aspx.
Important! Files stored in the siteroot\Workarea folder are overwritten (or deleted) when you upgrade. To avoid problems, back up the images to a folder outside the siteroot\workarea folder.
The Ektron CMS is not 508 compliant, however there are a number of features that can be leveraged to help bring an Ektron site closer to compliance.
Aloha's validate option - When editing content using the Aloha editor, the Review tab contains a validate button. This button allows users to validate whether the content being edited meets 508 or another type of compliance.
Adding alt text - By default, when inserting an image into a piece of HTML content, the CMS i...
This article describes steps to take to help clear and put protections in place for an Ektron site that may have been breached in a security attack.
When safeguarding your site you want to make sure that the following is reviewed and performed.
Run Security Configurator. For more information on Security please click here. For more version specific on the Security module please review here.
Update to the latest CMS version and fix as issues for secur...
Below are the steps needed to enable Ektron Windows Service restarts.
Important: You must be on 9.2SP2 Service Update 1 or higher to enable this feature.
Settings are located in the Ektron Windows Service config file.
"<Drive>:\Program Files (x86)\Ektron\EktronWindowsService40\Ektron.ASM.EktronServices40.exe.config"
<add key="RestartEnabled" value="1" /> <!-- Valid values are TimeBound|FrequencyBound --> <add key="RestartMechanism" value="TimeBound" />...
When troubleshooting some issues it may be useful to disable Ektron's aggregation and minification of js and css files. The aggregation piece combines multiple js/css files into 1 larger file and the minification removes extra spacing.
When troubleshooting issues in the site it is more useful to disable these pieces to capture errors that may be occurring or find specific line numbers and files that may be causing an issue.
Please note that these changes s...
When configuring SSL for the site, you may also need to use the service endpoints to perform certain actions. These steps show how you can configure the site to allow these endpoints to function when using SSL.
To setup SSL, the following configuration has worked. Please note that this configuration may not be suitable for all senarios and should be tested.
<behavior name="Ektron.WcfServices.serviceBehavior"> <serviceMetadata httpGetEnabl...
When trying to use the Ektron Redirect Module in a Three Tier environment, this error is thrown as an exception.The current type, Ektron.Cms.Settings.UrlAliasing.IRedirectManager, is an interface and cannot be constructed. Are you missing a type mapping?
Redirects are not currently available in Three-Tier. The service client for the manager is not built at this time. This is being added as a feature request for a future release.
The following error may occur in the Ektron workarea.
The WSPath setting in web.config is invalid. Please correct it in order for the site to function properly.
If IP restrictions have not already been whitelisted on the workarea\services and workarea\webservices, see the following KB. https://support.episerver.com/hc/en-us/articles/115004122926-IP-Restrictions-Unable-to-access-or-use-service-or-webservice-files
Verify that the Ektron services load properly using this...
DescriptionIf you are getting warning messages or experiencing issues when you compile your Ektron site in Visual Studio, this may be caused by the need to exclude the Ektron workarea folder from the build. ResolutionRight click on the workarea folder in Visual Studio and select the "Open Folder in File Explorer" option.Next right click on the workarea folder and go to the folder's properties.Check the hidden check box at the bottom.Finally check the "Apply changes to this folder" butto...
You want to secure a CMS login page using Secure Sockets Layer (SSL). After following the documentation to set up SSL, the site still uses HTTP. How can you force the login page to use HTTPS?
After you configure IIS and web.config to enable SSL, you must write custom code to force the login page to move from HTTP to HTTPS because the CMS will not automatically switch the page over to use SSL.
See the documentation listed in the References and Links section of this ...
How many login failures can occur until an account is locked? Where can this value be modified?
By default, Ektron allows 5 login attempts before locking the specific user account. An administrator can unlock the account by unchecking the accounts Locked check box.
To change the number of login attempts:
.Modify the value of the
If you set the value to -1, all accounts are unlocked.
DescriptionThis is a quick tutorial on how to add the Ektron server controls to the toolbox of Visual Studio. ResolutionOpen your Ektron project in Microsoft Visual Studio (by clicking
open website > choose the site root folder)
Open the VS Toolbox.Add a tab and give it a name like
Standard Ektron ControlsRight click and select
Choose Items... .Click
OK .The controls appear on the Toolbox...
DescriptionWhen attempting to add more than 255 characters to the library file extensions field, the system throws the following error: The file type has not been added. Please see administrator.
ResolutionIf you need to add more file extensions to the library, please use the following steps.
Make a backup copy of workarea\library.aspxEdit the workarea\library.aspx fileLook for the following line
maxlength="255" value="" runat="server"/>Change the maxlength property from 255 ...
A large DMS document fails to upload into the Ektron CMS.
Event viewer showed the following error:
Event code: 3005
Event message: An unhandled exception has occurred.
Event time: 5/21/2015 1:14:17 PM
Event time (UTC): 5/21/2015 6:14:17 PM
Event ID: e67251b437b2435f8fa757042b13cc9c
Event sequence: 551
Event occurrence: 1
Event detail code: 0
Application domain: /LM/W3SVC/3/ROOT-1-130767044666530000