Installing the ASP.NET native server control |
![]() ![]() ![]() |
Note that this procedure is not necessary for the PHP, Classic ASP or CGI versions. If you are using the ASP.NET native control for your server-side search, there is a different installation procedure required. You will need to install the ASP.NET control directly on the server itself.
First, you will need to download the MSI installation package from our website here: You will need to run and install this package on the server where you will be hosting the ASP.NET search from. When you launch the MSI installer, you will be prompted for a path to install the control to. You should specify the folder which you wish to host the search page from. Once you have done this, you will need to open up the IIS Manager and locate the folder in your "Web Sites" list. You will need to configure IIS to allow this folder to execute as an application. This can vary with different versions of IIS. In IIS 7, you will need to right click and select "Convert to Application". Accept the default properties and click OK. In IIS 5 and IIS 6, right click on the folder and select "Properties". Next, click the "Create" button and select the default options by clicking "OK".
At this point, you should be able to load the "search.aspx" page on your website (for example, if you have installed the control in a folder named "zoomaspx" at the root level of your website, it would be accessible from a URL such as "http://www.mywebsite.com/zoomaspx/search.aspx" in your browser). You should get a response that looks something like this: Content-type: text/html Unable to open settings.zdat or file is invalid. This is normal and indicates that the ASP.NET control is working, and it just needs the index files to continue. If you have not already done so, you will now need to index your website as described in Chapter 2, "Indexing your website". This will create a set of index files and a search template which you can upload or copy over to the same folder where you have the ASP.NET control installed. Once the index files (all ZDAT files and the "search_template.html" page) are hosted in the same folder, you should find that your search page will now be fully operational and you can customize the appearance of your search page as described in, "How do I customize the look of my search page?". Troubleshooting There are currently known issues with displaying non-English characters in the search results using the ASP.NET native control. Some .NET web page generation tools will put a HTML <form> that surrounds the entirety of the document. By default this form submits using POST, whereas this control uses GET variables. It is recommended to move this control outside of the form, but if that is not possible (i.e. the form is on the master page) then try placing the following lines of code within the ASPX code behind load function: C# this.Form.Method = "GET";
Visual Basic Form.Method = "GET" Form.EnableViewState = False Page.ClientScript.RegisterClientScriptBlock(Me.GetType(), "clr", "document.getElementById('__VIEWSTATE').value = ''", True)
|