• Search Server Port Requirements

    DescriptionThe components in the Search Server infrastructure use various ports for communication. These ports must be opened to permit normal search operation. ResolutionSearch Server Ports8732: The Search Configuration Utility and the Ektron Search Server Service use port 8732 to communicate with the Ektron Windows Service.6080 and 6081: These ports are used by the CMS File Helper Service to communicate among Ektron services and copy files from the CMS server to the Search server.7500...

  • Search Server registration error: failed to connect to the CMS server.

    Description The following error can occur when registering a site with Ektron's implementation of Microsoft Search Server.    Failed to connect to the CMS server. Please verify the following and try again.    Steps There are some steps along with the error message.  The CMS site's database server is accessible. You can browse to the CMS site and it loads as expected. The license key associated with the site is valid. The Ektron Windows Service is running on the CMS server.  In addition...

  • Search Upgrades and .txt Files

    DescriptionPrior to Ektron 8.50, CMS releases used the Microsoft Indexing Service search provider. Text (.txt) files were created by CMS under the siteroot\assets folder. The Indexing Service would crawl these text files to index information about HTML content, Smart Form content, image metadata, and user information. The format for content was generally ID+locale+extension+.txt , while the user format was User ID.txt (under the assets\users folder).The first of a new generation of s...

  • Searching by XmlConfigId using IndexSearch API does not work after upgrade to v8.5

    DescriptionIf prior to version 8.5, you were using Ektron's Index Search API to search by the XmlConfigId metadata, this code will not work after upgrading your site to CMS400.Net Version 8.5. With CMS400.Net Version 8.5, Ektron uses Microsoft Search Server asthe search platform. The existing search code will have to be converted to its corresponding Search Server equivalent using the new Framework Search APIs for search to work correctly. For backward compatibility, the old Search API code ...

  • Searching for metadata within the workarea

    DescriptionWhen using Solr Search, there is a specific query needed to query metadata keywords. CauseWhen querying Solr, there is a prefixed term placed in front of the metadata name. Therefore, this prefix needs to be placed in front of the metadata name when querying in the workarea. ResolutionIn the workarea, navigate to the "Search Published" tab. Log in to the workareaClick on the "Content" tabGo to "Action" > "Search".To search for metadata keywords, the query you will want t...

  • SharePoint Search Server File Types

    DescriptionIf a certain file type, such as .png, does not appear in search results, you can add the file type to the Search Service Application using the SharePoint Central Administrator.  ResolutionTo add the file type extension to Search Service Application:Under  Application Management > Search Service Application > File Type  on the left side under  Crawling , choose SharePoint Central Admin page > Manage Service Application . Add the file type.Perform a full search ...

  • Site search control pager clears results, does not page through results.

    DescriptionThe Ektron UI Pager control (as shown in this sample ) clears the search results. CauseThe template has ViewStateMode="Disabled". ResolutionSet ViewStateMode="Enabled" . Related LinksFor information about ASP.Net ViewStateMode , see the following links.http://blogs.msdn.com/b/asgoyal/archive/2012/08/29/asp-net-view-state-enableviewstate-vs-viewstatemode.aspxhttp://msdn.microsoft.com/en-us/library/system.web.ui.control.viewstatemode.aspx

  • Solr 6.2.0(Ektron 9.2) issue: Site registration failing on Server 2008r2

    Description Installing the newest version of Solr(6.2.0 for Ektron 9.2) on a Server 2008r2 VM does not allow registration of Ektron sites and gives the following error.  Oops! Something went wrong... A preliminary status check for the search environment has failed. The most common reasons for this are that the target Ektron site is currently being crawled, Solr or ManifoldCF are not running, or the search server does not meet the minimum requirements for hosting Solr. (Code: REQUEST_VALI...

  • Solr and the Ingesting of MP4 files

    Description By default, Solr does not ingest MP4 files; additionally, when an MP4 asset is encountered during a crawl, Solr will throw an exception and the crawl will stop. The work around for this is to mark the MP4 assets as not searchable.  Resolution Note: The below only applies to the 9.0 version of Ektron's Solr implementation.  A  library can be added to Solr that includes the MP4 injester which will assist with the processing of some multimedia files. Use the steps below...

  • Solr Asset Cache – What does it do?

    DescriptionThis article is going over what the Solr Asset Cache is and what it is used for.  ResolutionThe Asset Cache folder is used for when the Solr server and CMS server are on separate boxes. When Solr crawls a site's assets, it looks to the CMS server and will pull over the asset information to the Solr server, using the Asset Cache folder as a storage location. This allows for quicker access when an end user queries a title for a PDF, for example.  Where the Asset Cache folder li...

  • Solr cannot connect to cms database

    DescriptionWhen attempting to register a site to use Solr you may run into the following error:A connection could not be made to your database. Please review your input and try again CauseA bad SQL username, password, or rights to the database have been providedThe SQL Server Browser service was not started. ResolutionLog into SQL Manager on the SQL server Using SQL Manager, log into the database with the SQL credentials from the connection stringIf this fails please correct the ...

  • Solr crawls abort with parsing error (JDK Version 7 Build 45)

    DescriptionIf you notice that Solr crawls abort (when looking at the Manifold screen http://servername:7602/mcf-crawler-ui/showjobstatus.jsp ), review the Manifold CF core log, located here: C:\Program Files (x86)\Ektron\Search1.0\ManifoldCF\core\logs\manifoldcf.txt .Search for "abort" to find an entry like this:DEBUG 2014-01-23 09:24:51,570 (Worker thread '17') - Aborting job 1387207413469 due to error 'org.apache.manifoldcf.agents.interfaces.ServiceInterruption: Solr exception during i...

  • Solr crawls for only 10 seconds after registration

    DescriptionSometimes, after registering your site with a new installation of Solr search, you may find that Solr only crawls your site for 10 seconds and then says "Done" in the status window through the Workarea. CauseUsing Java 8 and higher exposes this issue. Ektron plans to test and incorporate Solr interactivity with Java 8 in a future release. ResolutionUninstall and then re-install Java and Solr because Solr needs to re-orient itself to the new Java version installed on th...

  • Solr Install Location Issue

    Description With Ektron 9.3 SP2, Solr was updated to 7.4. As part of the Solr update the install directory folder was moved to <rootdrive>\Solr.  For instance, if you pick the install directory as "D:\Program Files (x86)\", a Solr directory will be placed at D:\Solr. Steps This is due to an issue in Solr 7 where Solr cannot start when the execute path contains parentheses like "C:\Program Files (x86)\":https://issues.apache.org/jira/browse/SOLR-11611 There is currently no workaround and...

  • Solr is not indexing assets

    Description A query is run to pull up PDFs, but the assets do not appear in search results. This can also be an issue found in the Asset Transfer logs, that show an 'Host: Unknown' response. Asset Transfer Logs : \Program Files (x86)\Ektron\Search2.0\Asset Transfer Client Or, the host name is found, but there is an "Error during content extraction" for a PDF file: Manifold encounters errors when crawling assets (PDFs) such as the following: ERROR - 2015-12-07 16:17:33.715; extractors.As...

  • Solr Log Locations

    Description If you see an issue with Solr you can often identify the root cause through the log files. Below are the logs for the various Solr and Ektron services on the Solr server.  Resolution Installation: C:\Program Files (x86)\Ektron\SearchX.0\Logs\InstallLogFile_M-D-YYYY_HH_MM_SS.txtAdmin Console Registration: C:\Program Files (x86)\Ektron\SearchX.0\Web\SolrAdminConsole\Ektron.Cms.Search.Solr.Registration.txtAdministrative Service: C:\Program Files (x86)\Ektron\SearchX.0\A...

  • Solr ManifoldCF Database Maintenance

    Description Over a period of time, the crawl history reports contained in the Search 1.0 Solr ManifoldCF crawl database can grow quite large. If not periodically cleaned out, it is possible that the crawl database could consume a significant portion of the disk. Ektron recommends that the reports be cleaned out and the database itself compacted on a weekly basis. The solution below provides the steps to accomplish the task.  NOTE: Search 2.0 Solr ManifoldCF includes features to automati...

  • Solr node status error on 9.3 SP1: "No status information could be retrieved"

    Description When upgrading to 9.3SP1 or installing a new 9.3SP1 site the Solr configuration menu item can disappear making it look like Microsoft Search Server is used. The status button will also return an error stating "No status information could be retrieved." You may also see failed connections like this. http://SearchServerMachineName:8732/EktronSearchServerHelperService/SearchRequestService.svc Resolution Run the SetSearchProvider utility on the CMS server and set the s...

  • Solr Not Indexing Smart Form Content with Large Fields

    Description The following error is thrown if a smart form field larger than 32766 bytes is crawled.  "Document contains at least one immense term in field="exact_estjournalarticlecontent" (whose UTF8 encoding is longer than the max length 32766), all of which were skipped. Please correct the analyzer to not produce such terms. The prefix of the first immense term is: '[65, 108, 116, 104, 111, 117, 103, 104, 32, 97, 112, 112, 114, 111, 120, 105, 109, 97, 116, 101, 108, 121, 32, 53, -30, -1...

  • Solr Prerequisites

    Description The prerequisites for Solr are often missed. Here are the steps to add the necessary roles and features.  Resolution Prerequisite documentation Additional Requirements In addition to these items, make sure to install the correct version of Java.  Server 2016 Roles and Features Open Server Manager Move through the dialogues to get to Server Roles. Navigate to Web Server(IIS) > Web Server > Application Development. Check the following, .net extensibility 4.6 and ASP...

  • Solr search: Files are making the crawl hang

    DescriptionIf someone uploads a corrupt .mp3, .mp4, or .mov (various other formats as well) file into Ektron as a DMS asset, and you then run a Solr crawl, the file causes the Solr crawl to hang.This problem is caused by a Tika bug, described in http://jira.xwiki.org/browse/XWIKI-9528. ResolutionThere are 2 solutions:When importing the .mp3 file, uncheck the Content Searchable checkbox. This tells Solr to ignore the file when beginning a crawl.To access the Content Searchable checkbox, ...

  • Solr Search: Which JDK version should I use?

    Description There are several versions of the JDK for the Solr server. Which version should be downloaded? Resolution The recommended version is Java Development Kit 1.7, Windows x64 version, update 51 if using the 9.0 or 9.1 Ektron versions of Solr. JDK 8 should be used for 9.2 - 9.3 Ektron versions of Solr. Starting in 9.3SP2 OpenJDK 8 - 10 can be used. Ektron Solr Version Java JDK 9.0 - 9.1 JDK 7 9.2 - 9.3SP1 JDK 8 and OpenJDK 8 9.3 SP2+ JDK 8 and OpenJDK 8 - OpenJDK...

  • Solr Server Configuration Best Practices

    DescriptionIn addition to the basic requirements that a Solr server have 2 CPU cores and 8 GB RAM, there are some other practices that enhance the performance of crawls and querying.  ResolutionThe number of drive spindles is a key contributor to better search performance. The best practice is to provision three spindles as follows:C: - operating systemD: - Solr installE: - Solr indexThe Solr install is where the installer placed the core components, including the crawl database. During...

  • Solr use with Always On Availability Groups

    Description  See below for info regarding always on use with Solr. Resolution ManifoldCF and Solr use Java SQL drivers which are incompatible with always on. The consequence of this is that your SQL mirroring or clustering may not work with the Solr configuration database.  The cms itself uses the sql server native client, which supports this. However, the cms will never signal read intent, so all connections will be routed to the primary.

  • SOLR: Search Operators and Special Characters

    DescriptionBelow are some common search operators that you may run into using SOLR search and how they factor into searching. ResolutionIn the case of the example search terms --> Ektron - 14th Annual Synergy Conference - Tentative The query implies that all of the search terms (Ektron, 14th, Annual, Synergy, Conference, Tentative) will be searched for and have to exist in the document for it be found/returned. Note that in the query sample given it has a space between the '-' and th...

  • Starting Solr crawls manually through Manifold CF

    Description In some cases you may not be able to start a crawl through the CMS UI or you may want to view a crawls status. For those cases you can visit the Status and Job Management page of Manifold CF. Resolution Remote onto your Solr machine. Browse to your ManifoldCF page(you may be able to browse this URL on your own machine without logging onto the Solr machine). Change SolrMachineName to your search servers computer name.http://SolrMachineName:7602/mcf-crawler-ui/ In t...

  • String refinements with special characters result in a malformed query error

    DescriptionWhen the search provider for a CMS site is Microsoft's FAST Search for SharePoint 2010, some string refinements containing special characters can result in a malformed query error when applied to search criteria. ResolutionAn error (malformed query) occurs when submitting a query with a refinement known to include a special character, such as an exclamation mark (!). Zero results are returned.Refinements that include a special character, such as an exclamation mark (!), can r...

  • Templated Server Control verses WebSearch Server Control

    DescriptionPrior to 8.5 the WebSearch was the only search control available. For versions 8.5 and up,the new templated SiteSearch controls should be used. See below for more information about those controls.  ResolutionThe SiteSearch controls allow control over how search inputs are accepted, what results are returned, and how the results are displayed. These functions are done using the SiteSearchInputView, SiteSearchController, and SiteSearchResultsView controls. When using 8.5 and ab...

  • Text between brackets is not searchable

    DescriptionIn Release 8.5, when using Templated Server Controls, text between brackets (< >) (for example, ) is not searchable in HTML content.ResolutionInstead of brackets, use parentheses or other forms of punctuation.

  • Troubleshooting No Search Results

    DescriptionIf search results do not appear in the Workarea or the site, use the following approaches troubleshoot the issue:Check the query being sent to the search server.Use a bare-bones ASPX search page.Create a SharePoint Search site directly on the Search Server to test if search is crawling and indexing your site.Query the Solr index directly.  ResolutionChecking the actual queryYou can view the query being sent to the search provider by changing the LogLevel key in the site's ...