Overview

The standard starting page for SAS^® Visual Analytics is SAS Home. One of the tasks that you can perform from SAS Home is searching for content such as explorations, reports, and queries. This SAS knowledge base article includes some troubleshooting tips that an administrator should review if the search feature is not working as expected from SAS Home in release 7.5, 7.51, and 7.52.

Note: Several logs are mentioned. For the locations of those logs, see Log Locations.

Does a wildcard search return results?

If your search term returns no results, then attempt a search on the wildcard * as shown in the following display:

If results are returned, then try rebuilding the index. For the instructions, see the topic "Rebuild the Search Index" in the Integrating Search Interface to SAS Content documentation. For a link, see Related Documentation in this SAS knowledge base article.

If no results are returned, then review the other troubleshooting topics in this SAS knowledge base article.

Are All of the Required SAS^® Information Retrieval Studio Servers Running?

In order for the search to work, the following SAS Information Retrieval Studio servers must be running:

• Proxy Server
• Pipeline Server
• Indexing Server
• Query Server

Note:  Even if you have confirmed that the SAS Information Retrieval Studio server is UP, you should still check the status of these servers. One or more of these servers can be stopped even if the SAS Information Retrieval Studio is running.

If you are using SAS^® 9.4M6 (TS1M6) or later, then you cannot use the administration console. For instructions about how to verify server status and restart servers in SAS 9.4M6, see the Integrating Search Interface to SAS Content 3.7 documentation. For a link, see Related Documentation in this SAS knowledge base article.

If you using SAS^® 9.4M5 (TS1M5) or earlier, you can use the SAS Information Retrieval Studio administration console to determine whether the servers are running. Typically, the URL is http://your-server:10651. If the administration console is not enabled, then perform these steps to enable it.

1. Navigate to SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/work/.
2. Make a copy of the information-retrieval-studio.conf file.
3. Open the active copy in a plain text editor.
4. Add the following parameter to the end of the file.

5. Save the file.
6. Restart SAS Information Retrieval Studio.

The server status appears next to each server in the left pane. If one or more of these servers is not running, click Start. If it does not remain started, then review the other troubleshooting topics in this SAS knowledge base article.

Were the Steps to Enable SAS Information Retrieval Studio to Work with TLS Encryption Completed?

In a distributed SAS^® LASR™ Analytic Server environment, SAS Information Retrieval Studio requires manual configuration to work when Transport Layer Security (TLS) encryption (also known as Secure Sockets Layer (SSL)) has been implemented. If you have not completed these steps, SAS Home might display an error that is similar to this one:

You might also encounter the following issues:

• The Query Server starts but then stops.

• The query-server-errors.log contains errors such as these:

• The SASSearchService.log contains errors such as these:

The manual configuration instructions can be found in the topic "Post-Deployment Tasks for SAS Information Retrieval Studio" in the SAS Visual Analytics: Installation and Configuration Guide (Distributed SAS LASR). For a link, see Related Documentation in this SAS knowledge base article.

Are the Settings Correct for a Search^® Interface to SAS Content Deployment that Uses Both Internal and External Connection Information?

When internal and external connection information is specified for Search Interface to SAS Content, there are multiple places where the correct URL value needs to be specified. If the settings are incorrect, you might not see any search results. In addition, the query-server-errors.log might contain one or both of these errors:

If you believe you might be encountering this issue, contact SAS Technical Support for assistance.

Does Your Index Need to Be Rebuilt or Created?

If searching has never worked at your site, then it is possible that an index has never been built. The index build can take two to three hours, so ensure that you give the process time to complete. To verify whether an index exists, navigate to SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/work/index. This folder should contain files similar to these:

• index.alph
• index.ccd
• index.idx
• index.salph
• index.sidx
• index.tkzo
• index.toc

These files should not be 0 bytes.

If the index is not built after you believe that your issue is resolved, or the index exists but search still does not work, then follow the steps in the topic "Rebuild the Search Index" in the Integrating Search Interface to SAS Content documentation. For a link, see Related Documentation in this SAS knowledge base article.

If searching still does not work after the index is rebuilt, contact SAS Technical Support for assistance.

Have You Begun Receiving Emails about an Error while Feeding Content to the Indexing Server?

If you start receiving emails that contain the following message, then see SAS KB0036467.

Does the SAS Information Retrieval Studio Log Contain an Error about the "QS Server"?

As noted earlier in this note, in order for search to work, the following SAS Information Retrieval Studio servers must be running:

• Proxy Server
• Pipeline Server
• Indexing Server
• Query Server

If the Query Web Server and Query Statistics Server are also running, then you might see the following error in the information-retrieval-studio-server.log:

You can safely ignore this error. For more information, see SAS Note 57611.

Log Locations

Here are the locations of the logs mentioned in this SAS knowledge base article:

• query-server-error.log is in SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/logs
• SASSearchService.log is in SAS-configuration-directory/Lev1/Web/Logs/SASServerX_Y. If you have only one web application server, then the location is typically SASServer1_1. If you have more than one web application server, then the location is typically SASServer12_1.

Related Documentation

• The Integrating Search Interface to SAS^® Content documentation also contains additional troubleshooting tips. If you are using SAS 9.4M6 or later, then see Integrating Search Interface to SAS^® Content 3.7.
• The manual configuration instructions to enable SAS Information Retrieval Studio to work with TLS Encryption can be found in the topic "Post-Deployment Tasks for SAS Information Retrieval Studio" in the SAS Visual Analytics: Installation and Configuration Guide (Distributed SAS LASR). See the Documentation section of the SAS Visual Analytics learning center. A link to the guide is under Related Documentation for your release of SAS Visual Analytics.

Next Steps

If you have checked the troubleshooting tips in this KB article, but you still need assistance, then contact SAS Technical Support. Include all of the following information:

• Copies of your query-server-error.log and SASSearchService.log. See Log Locations.
• A copy of your information-retrieval-studio.conf file from  SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/work/.
• A copy of your query-server.db file from SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/work/.
• A screen shot that shows the current status of the Proxy Server, Pipeline Server, Indexing Server, and Query Server.
• (Linux) Copies of the setenv.sh files from each web application server. The files are in SAS-configuration-directory/Lev1/Web/WebAppServer/SASServerX_Y/bin.
• (Windows) Copies of the wrapper.conf files from each web application server. The files are in SAS-configuration-directory\Lev1\Web\WebAppServer\SASServerX_Y\conf.
• A copy of your information-retrieval-studio-server.log from SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/logs.
• A zipped up copy of your index folder: SAS-configuration-directory/Lev1/Applications/SASInformationRetrievalStudioforSAS/work/index.
• Screen shots of the Internal Connection, External Connection, and Advanced tabs for SAS Search Interface to SAS Content. A system administrator can get this information from SAS^® Management Console by navigating to Application Management  ► Configuration Manager  ► SAS Search Interface to SAS Content.