-
Description
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.
Resolution
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.
Resolution
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.
Resolution
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.
-
Description
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.
ek_enabledevicedetection value="true"
2. Check your event viewer logs. Check under "Windows Log...
-
Description
When you click on the "+ or" button to add a new condition for use in the Targeted Content Widget nothing happens.
Resolution
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.
Cause
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.
Resolution
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.
Resolution
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.
Resolution
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.
Resolution
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.
-
Description
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]
Resolution
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.
Resolution
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
message. Resolution
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.
Approval Workfl...
-
Description
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.
Resolution
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.
Resolution
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...
-
Description
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.
Resolution
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...
-
Description
Below are the steps needed to enable Ektron Windows Service restarts.
Resolution
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" />...
-
Description
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.
Resolution
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.
Resolution
To setup SSL, the following configuration has worked. Please note that this configuration may not be suitable for all senarios and should be tested.
1) Change
<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?
Cause
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.
Resolution
Custom r...
-
Description
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.
Steps
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?
Resolution
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?
Resolution
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:
Edit
web.config
.Modify the value of the
ek_loginAttempts
property.
NOTES:
If you set the value to -1, all accounts are unlocked.
If commer...
-
Description
This is a quick tutorial on how to add the Ektron server controls to the toolbox of Visual Studio.
Resolution
Open your Ektron project in Microsoft Visual Studio (by clicking file open website choose the site root folder)
Open the VS Toolbox.
Add a tab and give it a name like Standard Ektron Controls
Right click and select Choose Items... .
Click Browse .
Choose site root/bin/
Ektron.Cms.Controls.dll
Click OK .
The controls appear on the Toolbox tab.
Repea...
-
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.
Cause
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 information:
Application domain: /LM/W3SVC/3/ROOT-1-130767044666530000
...