dtSearch Web Quick Start

Last Reviewed: May 28, 2013

Article: DTS0162

Applies to: dtSearch Web 6, 7

dtSearch Web is a search engine that you can install on a Web server to publish documents on your web site. It can perform fast indexed searches using the same search features that dtSearch Desktop supports -- fuzzy searching, phonic searching, natural language searching, boolean logic, proximity, etc. Indexed documents can be in any format that dtSearch supports, such as HTML, PDF, XML, Word, Excel, PowerPoint, WordPerfect, RTF, and ZIP archives.

After a search, dtSearch Web will convert documents as needed to HTML for display, with hits highlighted. If a retrieved document is already in HTML, dtSearch Web will display it with hits highlighted while preserving the HTML attributes (so links and images will work in your browser).

dtSearch Web requires Microsoft Internet Information Server (IIS) version 4 or later, which is included with most versions of Windows.  (For supported Windows versions, see dtSearch Web system requirements and performance.)

This Quick Start will describe how to get a basic search form running on your web site with minimal effort. You can create any number of search forms, each with its own set of option settings and index selections.

1.   Install the dtSearch and dtSearch Web program files on your web server.
If you have dtSearch Web on CD, run the setup program to install. If you downloaded dtSearch Web from the internet, follow the download instructions to open the dtSearch Web archive and install the files.

2.   Build an index of your documents
dtSearch Web uses the same indexes as dtSearch, so if you already have a dtSearch index of the documents that you want to make searchable, you can use this index with dtSearch Web. If not, follow the dtSearch Quick Start to set up an index.  If you are indexing a dynamically-generated web site (such as a web site generated by a content manager) see "How to use dtSearch web with dynamically-generated content" for information on using the dtSearch Spider to set up your index.

3.   Run dtSearch Web Setup
In dtSearch, click "dtSearch Web Setup..." in the File menu. dtSearch Web Setup will display a drop-down list of the web sites on your server, and below it a list of the virtual directories defined for each site.

 websetup.png

4.   Select the web site to use with dtSearch Web
If you have more than one web site on this server, you can install dtSearch Web on each of them, or just one. (To install dtSearch Web on additional web sites, repeat the procedure described in this Quick Start for each site.)

5.   Select the folder where dtSearch Web should be installed
The "Scripts" folder is recommended but you can choose another folder by selecting it from the drop-down list. dtSearch Web Setup will create a "dtSearch" folder under the folder you select where the dtSearch Web files will be installed. Click the Install or Upgrade button to install the dtSearch Web files in the folder you selected.
If the folder you selected does not already have 'Execute' permission enabled, dtSearch Web Setup will ask if it can enable 'Execute' permission in the folder so that dtSearch Web can run from that folder.  
The folder should also have read and execute Windows permissions set in Explorer so users of your web site will be allowed to execute the dtSearch Web components (otherwise users will see a "401" error page when they try to search).


When dtSearch Web Setup asks if it can register dtSearch Web with Internet Information Services, answer Yes to have dtSearch Web Setup take care of this automatically.  If you prefer to register dtSearch Web yourself, please see "Registering dtSearch Web" in this article: How to install dtSearch Web on Windows Server 2012 or 2008

6.   Build a Search Form for your site
Click the Build Search Form... button to build a search form to use with your site. You can make as many search forms as you want for each site, and after dtSearch Web Setup has generated a search form, you can use an HTML editor such as Microsoft FrontPage to edit it to fit into your web site.
In the Build Search Form dialog box, click the Indexes tab to select the indexes that you want to put on the search form.  Check the box next to each index to include it on your search form.

7.   Click OK to build the search form.
After the search form is built, dtSearch Web will open it in your browser so you can try out a search. Once you have a basic search form working, you can run Form Builder again to customize the search form, the appearance of search results, and other options.

Making Documents Accessible

To provide access to documents on your web server, designate each folder that contains documents to be published as a virtual directory. To do this with Internet Information Server, use the Internet Service Manager to add an "Alias" for each folder.  There is no need to create an alias for subfolders of a virtual directory -- they are automatically included.

After you add virtual directories to a site, run dtSearch Web Setup to update dtSearch Web with the new information. You do not need to reinstall dtSearch Web or run Form Builder again -- just start dtSearch Web Setup and exit it, and dtSearch Web will know about the new directories.

Customizing the search form and search results

Once you have a basic search form working, you can use your HTML editor to modify the search form and the appearance of search results.  For more information, see the dtSearch Web User's Manual