Installing QAD Assist
QAD Assist is a QAD .NET UI application that hosts searchable HTML versions of the QAD Enterprise Applications online help for programs and fields.
QAD Assist must be installed manually after the QAD .NET UI has been installed.
File Delivery
The installation files include:
• Files for installing the QAD Assist application
• Files for installing the QAD Assist content
The QAD Assist application and content files are included in the QAD Enterprise Applications - Standard Edition Language Files CD for each supported language.
The application files are:
• epub.war
• search.war
The content files are named as follows:
<product>-<language>-se.zip
where <product> is erp for QAD Enterprise Applications or whs for QAD Warehousing, and <language> is the language identifier.
For example, the English file for QAD Enterprise Applications help is:
erp-en-se.zip
Installation Steps
Use the following steps to install QAD Assist. Note that the following steps are based on using a Linux environment with JDK 1.6.
1 Shut down Tomcat.
2 Copy epub.war and search.war into the /webapps directory.
3 Start Tomcat. With the application files in place, you next copy and unzip the content files.
4 Copy <product>-<language>-se.zip to the /webapps/epub directory.
5 For each .zip you have copied, unzip the content using the unzip command:
unzip <product>-<language>-se.zip
Unzipping creates a directory containing the content under the /epub directory. After you have unzipped the content, set up the search engine index:
6 Using a web browser, access the search administration page URL. Open http://<host>:<port>/search, where <host> and <port> are the host and port for the Tomcat instance under which you installed the epub and search Web applications.
7 Click the New Index button and in the field enter:
default
This creates a new index and directory in the following location:
search/WEB-INF/indexes/default
Next, you need to add index (links) content to the search engine by copying the links_*.xml files (which contain the default link information for the search engine index) under /epub to /search/WEBINF/indexes/default.
You can use the following step to copy all the index files (files that match 'links-*.xml') into the directory:
8 Using a command line, navigate to the /epub directory and enter:
cp `find . -name "links-*.xml"` ../search/WEB-INF/indexes/default
The search engine automatically imports these files and removes them upon completion.
The search administration page (http://<host>:<port>/search) updates the information about the default index, including the number of documents in the Documents column and the total size under the Size column.
Note that you can import the same content multiple times without affecting the number of documents loaded into the search engine, although that action will increase the allocated file size. In the Actions column, you can click Optimize to reclaim the excess disk space.
To load the default index, you must stop and start the search engine for that index:
9 In the Actions column for default, click Stop.
10 In the Actions column for default, click Start.
Finally, you need to update the client-session.xml file.
11 Edit the client-session.xml file (<HomeServer>/configurations/<SysEnvName>/client-session.xml) so that it includes the following settings:
<ContentIndexServer></ContentIndexServer>
<ContentIndex>default</ContentIndex>
<ePublisherServer></ePublisherServer>
QAD Assist is now ready for use. You can access it from the QAD .NET UI by choosing Help|Search or by pressing the F1 key.
If the search engine does not automatically load the index files, bounce (stop and then start) Tomcat. To do so, go to the /bin directory and enter ./shutdown.sh and then ./startup.sh.