How do I install QAS Pro Web?

Summary

This document discusses how to install QAS Pro Web on both Windows and UNIX platforms.

Solution

When you first begin the installation, you are given the option of installing either the Pro Web program files only, or the program files together with sample integration code and pages. These elements can be installed on the same machine or on different machines.

Windows

1. Insert the QAS Pro Web CD into your CD-ROM drive.

2. The setup program should start up automatically.

Otherwise, click the Start menu and select Run. In the dialog box that appears, type d:\setup, where ‘d’ is the drive letter for your CD-ROM drive, and press Enter.

3. Once the installation program starts, follow the on-screen instructions to install QAS Pro Web.

4. If you are using the JSP integration pages, you should uncompress the proweb.war file, extract the web.xml file from it and edit the server address contained in it (explained later). Server addresses for all other integration pages are set automatically by the installer.

When you install the QAS Pro Web program files, the following components will be installed to the C:\Program Files\QAS\QuickAddress Pro Web directory:

Pro Server Pro Web SOAP Service executable and associated files.

Configuration Editor

Administrator Console

Command Line Management Utility

Test Harness

Data Checker See readme.txt

In addition, the Microsoft .NET framework will be installed to support the test harness (WebConsole).

You can also choose to install one or more of the following sets of sample integration code and pages:

• ActiveX/ASP
• Java/JSP
• C#.NET
• VB.NET
• PHP

Both ASP.NET samples (C# and VB.NET) need to be set as an application in IIS (see Directory Properties page in IIS), and require the .NET framework, which is installed automatically. If you select the ActiveX/ASP integration code and pages, the Microsoft SOAP Toolkit 3 will be installed automatically.

Changing the Server Address

When you run the server, it will attempt to listen for incoming connections from clients on the address and port which were configured during the installation. To change the server address, follow these steps:

1. Edit the ServerAddress INI setting. See “ServerAddress=QATCPIP:{Server Address}:{Port}”.

2. Edit the ServerWSDLUrn INI setting. See “ServerWSDLUrn=http:// {Server Address}:{Port}”. The server address must be an absolute address.

3. In addition, you will need to configure the server path in the relevant integration pages as follows:

Integration Code	File	Form
ASP	constants.asp in the root directory	const CONTROL_WSDL_URN = http://localhost:2021/proweb.wsdl
JSP	web.xml. Uncompress the war file and extract the web.xml file from the WEB-INF subdirectory.	<param-name>QasEndpoint</param-name> <param-value>http://localhost:2021</ param-value>
C#.NET	web.config in the root directory	<add key="com.qas.proweb.ServerURL" value="http://localhost:2022/" />
VB.NET	As for C#.NET	As for C#.NET
PHP	constants.inc in the root directory	define( CONTROL_WSDL_URN, "http://localhost:2021/proweb.wsdl" );

USA-Specific Information

If the system locale of the machine that the Pro Web program files are installed on is set to English (United States), a dialog is displayed which allows the user to install the AMS API and data.

If you are installing Pro Web with USA data, ensure that the US Components checkbox on this dialog remains checked. If this is checked, the USPS installer will be launched at the end of the Pro Web install, and a shortcut to the USPS installer will be included in the program group.

You will need to follow specific instructions to update AMS data.

NOTE:

If you want to use the Verification engine with USPS-supplied data, you must shut down the server when you update the data. The dynamic update functionality cannot be used.

Files Installed

The files supplied with QAS Pro Web are listed below, including a brief explanation of each.

Program Files

These are installed in C:\Program Files\QAS\QuickAddress Pro Web by default.

These files need to be installed on all machines that will host applications calling any of these integration pages (for example, your web servers).

File	Description
qaswvdn.exe	QAS Server
qaswvdn.0nn	QAS Server language files
qaswvdn.rev	QAS Server library versions file
Qawserve.ini	Server configuration file
qaworld.ini	Configuration file
qalcl.dat	Locale information file
qalicn.ini	Licence information file

Utilities

These files are installed in C:\Program Files\QAS\QuickAddress Pro Web by default.

 

File	Description
qacfgwn.exe	Configuration Editor
qacfgwn.0nn	Configuration Editor language files
qacfg0nn.dll	Configuration Editor language dynamic-link libraries
qacfgwn.rev	Configuration Editor library versions file
qaopcd.exe	Administrator Console
qaopcd.0nn	Administrator Console language files
qaopcd0nn.dll	Administrator Console language dynamic-link libraries
qaopcd.rev	Administrator Console library versions file
webconsole.exe	Test harness
quchkn.exe	Data checker utility
quchk.ini	Data checker configuration settings file
quchkn.rev	Data checker library versions file
wvmgmtd	Command-line management utility
wvmgmtd.0nn	Command-line management utility language files
wvmgmtd.rev	Command-line management version file
readme.txt	Information about the utilities supplied with Pro Web, a revision history of Pro Web, and any information that did not make it into the printed or online documentation.

Help files are supplied for the Configuration Editor and Administrator Console programs.

UNIX

This section describes installation on Solaris, but also encompasses other UNIX (and UNIX-like) environments. Where installation on other environments varies from Solaris, the differences are highlighted throughout.

The program files are located in the /apps directory. This directory is in the location to which you copied the files from the CD; for example, /usr/qas/ proweb/apps.

You can optionally install one or more of the following sets of sample integration code and pages: JSP using Java and PHP.

The sample integration code can be installed on the same machine as the server, or on a different machine. You can also choose either to run both the server and integration code/pages on UNIX or to run a mixed Windows/UNIX environment.

Configuring or Changing the Server Address

When you run the server, it will attempt to listen for incoming connections from clients. To configure or change the server address, follow these steps:

1. Edit the ServerAddress INI setting. See “ServerAddress=QATCPIP:{Server Address}:{Port}”.

2. Edit the ServerWSDLUrn INI setting. See “ServerWSDLUrn=http:// {Server Address}:{Port}”. The server address must be an absolute address.

3. If you are using the JSP integration pages, you should uncompress the proweb.war file, extract the web.xml file from it and edit the server address contained in it.

4. If you are using the PHP integration pages, you must locate the constants.inc file (which will be in the same location as the web server) and edit the server address contained in it.

Files Installed

Program Files

The following files are all located in the apps/ directory:

File	Description
Qaswvd	QAS Server
Qaswvd.0nn	QAS Server language files
qawserve.ini	Server configuration file
Qaworld.ini	Configuration file
qalcl.dat	Locale information file
qalicn.ini	Licence information file
wvmgmtd	Command-line management utility
wvmgmtd.0nn	Command-line management utility language files

Integration Code

You should copy the relevant files (either Java or PHP) from the samples/ directory on the CD to a location that is accessible to your Web Server.

Location Of Files	Description
sample/jsp/	Pro Web JSP sample code
sample/php	Pro Web PHP sample code and all relevant images for the PHP pages
sample/php/img