|
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
|
Related links
Experian QAS Pro Web support zone |
UK home
Send this