• Information on updating Ektron site URL

    Description From time a site may need to have the site's URL updated. Often this is seen with sites moving from an HTTP connection to an HTTPS connection, but we have seen customers need to change URLs for a number of different reasons. Resolution Links within the site: Links that are hard coded into the templates Will need to be manually updated to reflect the new URL. Relative links When inserting links into content using the library button and browsing files the CMS wi...

  • Is parent pathing necessary for 9.1?

    DescriptionWhen installing or upgrading to 9.1 you may be requested to turn on Parent Pathing. Parent pathing is required for Ektron 9.1.  CauseParent pathing allows code running on a website to understand its file structure. Specifically, it allows code to reference locations relative to the running location via ..\ or ../. Ektron's "relative includes" use code that relies on parent pathing. ResolutionTo enable Parent Pathing:Prerequisite : If ASP does not exist under IIS, you n...

  • Is there a way to change the timeout value for re-login when ek_ecom_ComplianceMode is enabled?

    Is there a way to change the timeout value for re-login when ek_ecom_ComplianceMode is enabled? The key looks like this in the siteroot\web.config:       Resolution The timeout cannot be changed.  The reason is below. Payment Card Industry Data Security Standard (PCI DSS) outlines requirements that payment applications must meet to be compliant. As per PCI DSS, a session is locked if it is idle for 15 minutes. The user must re-enter the password or lo...

  • Issue creating a content Description metadata field as text box

    Description There are times when you need a description field added as a Metadata for content, but it keeps displaying the field  as a tag list instead of a text field as shown below: This is how you want it to appear: This is how it is added instead: Resolution The issue is that the system specifically checks for the spelling and capitalization of the field name. as shown here on the configuration screen when adding new Metadata:   You need to specifically use "description...

  • Library items in production are pointing to a staging URL

    DescriptionWhen in production and accessing a library link (such as an image or quicklink), the link points to a staging URL. If not on a staging server, this URL throws 404 errors for end users. CauseThe cause is probably one of two things.In the Workarea > Settings > Configuration section, Staging server enabled is checked off.The value is being hard-coded by the template.  ResolutionDisable the enable staging server field per the following KB article:  What the Server Type (Stage Ser...

  • Manually Removing Ektron from your system.

    Description If the CMS Complete Uninstaller is not working for some reason you can manually remove the components of EKtron from your system. Resolution Warning: This procedure includes modifying the registry. Using Registry Editor incorrectly can cause serious problems that may require you to reinstall Windows. Ektron cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Uninstall CMS400vXX from...

  • Network Error: 404 Not Found on ScriptResource.axd and WebResource.axd

    DescriptionThe sites seem to work without any visible issues.  The Event Viewer on the server reports 404s on the ScriptResource.axd and WebResource.axd files. CauseThis is an issue with machine keys in a load balanced environment. ResolutionThe recommendation is to standardize the machine keys on all the servers in the load balanced configuration. The instructions for modifying the keys can be found here .   The key is to apply the same IDs to all the servers in the con...

  • Output Caching Broken

    Starting around version 8.6, output caching stopped working in some cases. Microsoft released a patch KB2836939 that prevented the output cache from working in Ektron. Removing this patch is not a valid workaround. You can add the code below to the global.asax file to fix the output cache function. Info about the Microsoft Patch:  http://support.microsoft.com/kb/2836939 Resolution Add the following code into your existing Global.asax file, or create a new file a...

  • Page Level Caching for reduced page load times

    If you experience consistently long page load times on pages that are making large calls to the database using the Ektron API, see the solution in this KB article.  Resolution To improve performance on pages that make large calls to the database you should implement a caching strategy. One part of a caching strategy is page level caching. The example supplied is for caching that is being utilized in tandem with the Ektron Framework API call TaxonomyManager.GetTree() ...

  • Problem running RegEktron.Services.EktronAsyncProcessor.bat in 9.1

    This article explains how to work around an error that occurs while setting up Web Alerts and following the procedure for "Manually Setting Up the Message Queue and Asynchronous Processor" (The 9.0 version of that procedure is here:  http://documentation.ektron.com/cms400/v9.00/Reference/Web/EktronReferenceWeb.html#Web_Alerts/Administering_Web_Alerts.htm#webalert_setup_message_queue_1819149648_25551 .) After completing Step 11 of that procedure (which involves executing the .bat fil...

  • Replacing Workarea and Bin Folders

    To correct certain workarea issues, support may ask you to replace your workarea and/or bin folder with the Ektron base versions. This is a normal and typical step taken to help correct odd workarea behaviors. This article will help you walk through the steps to successfully replace both folders.  Resolution Replacing the workarea and bin folder: Navigate to your site root folder. This is the place where the site files were initially installed to. While everyone te...

  • Running Ektron on operating systems leveraging server 2008 R2 and older

    Description Microsoft has reached the end of extended support for server 2008 R2.  Microsoft will no longer be releasing security patches for these operating systems as noted in the following documentation: https://support.microsoft.com/en-us/help/4456235/end-of-support-for-windows-server-2008-and-windows-server-2008-r2 Steps As noted in previously published post Windows 2008 Support is Ending; What's Next for Ektron Customers?  we have historically suggested to customers to upgrade to ...

  • Server controls grayed out in Visual Studio Toolbox

    DescriptionWhy are my server controls grayed out in the Visual Studio Toolbox? CauseYou are using the incorrect version of .NET for your website build. ResolutionThis example uses Ektron version 9.1 sp1, which uses .NET 4.5. To fix the graying out of the Toolbox > Server controls, use .NET 4.5 for the website. To do this:Open Visual Studio.Right-click your website. Click Start Options > Build . Set Target Framework to .NET Framework 4.5 .   

  • SP CU and Hotfix Info

    Ektron’s policy concerning requests for Hotfixes or Cumulative Updates (CUs) is as follows. Customers are required to update to the most recent release within their version to receive a CU or Hotfix for the version requested. For example if you are on version 8.7 SP1, an update to SP2 would be required and the CU would be delivered for 8.7 SP2. CU's and Hotfixes are approved on a per issue basis. Hotfix requests and CU's require an internal escalation process, where Ektron Support reviews t...

  • The client and server cannot communicate, because they do not possess a common algorithm.

    Description The article describes an error message that can occur accessing an Ektron site after an upgrade and updating servers to TLS 1.2. Resolution This issue is when TLS 1.2 was not available on the CMS/SQL servers. This is a communication issue between the CMS server and SQL server and is most likely unrelated to Ektron in this case. Make sure that TLS 1.2 is enabled in the registry of both the CMS and SQL servers. For additional information see the references below.http...

  • Time zone field is required

    DescriptionAfter you install Ektron, or after you upgrade your existing environment to a new version, the following error may occur when you create a new user in the Workarea or with the API:  Time Zone Field is Required CauseBy default, the timezone custom user property is enabled and required on new installations and upgrades. ResolutionYou have 2 options:Specify a valid default timezone setting whenever you create a new user. See Create membership user using API for inform...

  • Troubleshooting issues with Web Service connectivity

    DescriptionThis article provides useful resources on how to troubleshoot web services connectivity issues. These issues sometimes can occur after: Initial installation Upgrade Applying a Service pack Resolution Connectivity issue with search, notification service or DxH? Restrict access to a file or folder Unable to access or use service or webservice files after an install, upgrade, or applying a service pack    

  • Unable to search for Membership Users in the Workarea with Active Directory

    DescriptionAdministrators report the option to search for membership users with the configured Active Directory Integration is not available in the user interface. CauseThe ek_LDAPMembershipUser key in the web.config is not configured properly for this option. ResolutionIn the documentation for Managing the web.config File there is a key called ek_LDAPMembershipUser.ek_LDAPMembershipUser Integrate membership users with LDAP or Active Directory. Set the value to True for Membership ...

  • What is a Web garden, and why should you not set it up?

    DescriptionA Web garden is a configuration in which an IIS application pool is set up to run within multiple worker processes on a single server.If you implement a Web garden, it divides your site's processing among several worker processes. This can cause a variety of issues within the Ektron Workarea, the most common of which is users getting logged out.The behavior is similar to issues with a load balanced site if sticky sessions are not enabled: requests are split among multiple processe...

  • What ports does Ektron use?

      This article lists all ports that Ektron uses for various product functions. The list is divided by function, and shows each function's corresponding ports. For security reasons, please make sure you are only opening ports on your firewall that you need to use. Resolution Here is a brief rundown of ports that Ektron uses based on product function. (This assumes a default installation.) eSync :  Ektron Windows Service: 8732 Search : MS Search: Query Service: 7500 Ektr...