Configuring the Delivery Server
QAD CRM ships with a Web archive file named qadcrmwebclient.war, which resides in the folder QADCRMInstall\Webclient\backend. The file must be copied in the delivery server’s Tomcat webapps folder; note that CRM only supports Apache Tomcat. After copied, the .war file is extracted automatically by Tomcat within a few seconds. However, in case you find the file is not extracted automatically, you must restart Tomcat for QAD CRM Webapp named qadcrmwebclient to be installed. If you cannot restart Tomcat—as it might be used by another applicaiton, you can run the following command to manually extract the .war file:
jar-xvf yourWARfileName.war.
Note: If you have already setup a Tomcat server as part of your QAD Enterprise Applications system, then you can consider using the same Tomcat server as your CRM Delivery Server.
Once the CRM Webapp gets created on Tomcat, you will get a directory structure similar to the one shown below:
• qadcrmwebclient/qadcrm: QAD CRM 6.7.2 Webapp folder
This holds the CRM Webclient application image (including subfolders and components).
Note: This is user-defined and can be named as you choose. However, note that all the references to this folder in the links specified in this document must be changed accordingly once you change the name of this folder.
• qadcrm.prowcapc/qadcrm_all.prowcapc and other component cab files including the main.cab files
• qadcrmwebclient/images: contains supporting image files
• qadcrmwebclient/WEB-INF: contains supporting files for Webapp
• qadcrmwebclient/META-INF
• qadcrmwebclient/web_image: Initially empty but created to hold the Progress software WebClient image, which must be copied in this folder so that client machines can download it automatically, if required.
Contents in qadcrmwebclient/web_image must be copied from the following CRM installation directory:
QADCRMInstalldir\webclient\backend\progresswebclient\<Progress Webclient Version>\web_image
Where <Progress Webclient Version> is the Progress version with which you plan to use CRM.
Once you have copied the software on the Tomcat webapp folder, two files must be modified in web_image folder to reflect the correct path of CRM software and Progress WebClient software as per your configuration. These two files are:
• bootstrap.htm
• webclient.htm
Modifying the bootstrap.htm File
To modify bootstrap.htm file, do the following:
1 Open the bootstrap.htm file and search for the string qaddemo.
2 Find the following line:
document.location.href ="http://qaddemo.qad.com:8080/qadcrmwebclient/qadcrm/qadcrm.prowcapc"
3 Replace the string "qaddemo.qad.com:8080" in the above line with "<Tomcat Hostname>:<Tomcat Port number>" based on your own server and Tomcat setup.
Now the line is:
document.location.href =
"http://<Tomcat Hostname>:<Tomcat Port number>/qadcrmwebclient/qadcrm/qadcrm.prowcapc"
Note: The name of the .prowcapc file is case-sensitive and depends on the name of the .wcp file you selected to build the cab files. It would be qadcrm_all.prowcapc if you use qadcrm_all.wcp to build the CRM .cab files.
• The qadcrmwebclient folder refers to the Tomcat webapps folder where the QAD CRM WebClient will be deployed.
• The URL "http://<Tomcat hostname>:<Tomcat Port Number>/qadcrmwebclient/qadcrm" is an example of a configuration file URL, that is, the Tomcat location where the Webclient configuration files for this particular CRM system are stored. This configuration URL information will be required later when you generate the QAD CRM Webclient cab files using the QAD CRM Deployment Utility.
• The file qadcrm.prowcapc/qadcrm_all.prowcapc is a Progress WebClient file that you must copy from the CRM deployment server to the delivery server (where Tomcat is installed) in later steps.
4 Find the following line:
window.location = "http://qaddemo.qad.com:8080/qadcrmwebclient/web_image/webclient.htm"
5 Modify the URL in the above line to reflect the path of the webclient.htm file as per your configuration.
Modifying the webclient.htm File
In the webclient.htm file, search for the string qaddemo. You will find the following reference that must be changed:
ether.SetProperty("ProwcappURL", "http://qaddemo.qad.com:8080/qadcrmwebclient/qadcrm/qadcrm.prowcapc");
Modify the URL in the above line to reflect the correct path of the qadcrm.prowcapc or qadcrm_all.prowcapc file in your configuration.
In some specific versions of webclient.htm file for OE V11.x, you might instead find a string ProwcappURL = “http://qaddemo.qad.com:8080/qadcrmwebclient/qadcrm/qadcrm.prowcapc”.
Modifying the web.xml file
This step is required to associate the Progress WebClient application with the .prowcapc file extension, so that the CRM WebClient installation will launch correctly on the client PC:
1 Locate the <Tomcat_install_dir>/conf/web.xml file.
2 Locate <mime-mapping> in the <web-app> section.
3 As the last mime mapping, add the following:
<mime-mapping>
<extension>prowcapc</extension>
<mime-type>application/progress-wcappcab</mime-type>
</mime-mapping>
4 Save web.xml.