|
Summary
This document discusses how to perform data updates for QAS Pro Web.
Solution
QAS provides periodic updates of country databases when updated data is available. These updates are supplied on CD-ROM. You can find all QAS data release dates within the Data Release Schedule section of the support site
Data files are installed separately from Pro Web. These files should be located on the same machine as the Pro Server. A set of files is installed for each country you need to support. For example, there are four data files installed for the United Kingdom: gbr.dts, gbr.tpx, gbr.zlx and gbr.zlb.
Please note: Before you begin the installation process for the very first time, you should ensure that you have the Despatch note that is supplied with Pro Web. The Despatch note contains all of the licence keys for each data set that you have purchased. When you install data for the first time, you are prompted to insert the licence key for each data set that you want to install.
Select platform:
Windows
You should insert the CD-ROM into your CD drive, 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. Follow the instructions on the screen to replace your existing country databases.
Please note: For detailed instructions on performing QAS data updates using the QAS Data Installer, download QAS Pro Web's data updating guide.
Once your data has been installed go to Activating QAS data.
Updating AMS (USA-USPS) Data
To update the AMS data, click the Start menu, select Run and then select the QAS Pro Web program group. Within this group, double-click the USPS Installer shortcut. If you do not have a USPS Installer shortcut, go to the USPS Installer subdirectory in the C:\Program Files\QAS\QuickAddress Pro Web product directory and double-click setup.exe. Follow the on-screen instructions to update the data. The installer will prompt you to insert the AMS CD.
Once your data has been installed go to Activating QAS data.
Activating QAS Data
Using the Administrator Console, Windows users can update data without shutting down the server.
Your Administrator Console will look similar to this:
The Data Updating pane on the Administrator Console enables you to:
- Switch to new data for client searches without shutting down the server;
- Revert to the old version of data if necessary.
Select Current Data on the left pane of the Administrator Console, and then select the ‘Data Updating’ to display this view.
When a new country database is available, i.e. newly installed, the country name, release date and data expiry period appear in the top field on this pane, along with the location of the new data and code. A green square containing a CD also appears on the status bar, and a notice that new data is available appears on the Current Data pane. The server does not start using this data for searching until you click on the Update Data button.
Once the update has been implemented, the name and location of the old data appears in the lower box. If you need to revert to this data for any reason, click on the Rollback button. The server will revert to the previous version of the data, and the more recent version will once again appear in the top field, indicating that it is available to be updated.
Activating Data
When you install new data, the information is displayed in the information area in the Unused Data Pane, as well as in the Data Updating Pane.
You can activate new data or delete unused data using this dialog.
When a new country database is available, the country name, release date and data expiry period appear in the top box on this pane, along with the location of the new data and code.
To activate data, therefore making it available to the clients, select the data you wish to use, then click the Activate Data button.
UNIX
You should copy the data from the CD-ROM to the data/ folder. Data files must be in lower case and in the following format: aus.zlx, aus.dts, ausgcd.dap.
The first time that you carry out a data update, you will need to add a NewInstalledCountries setting to the qawserve.ini file.
The qawserve.ini file is located in the apps/ folder. Open the file using a plain text editor such as vi or emacs (under UNIX). Under the [QADefault] section, locate the settings InstalledCountries. This setting contains a list of the country data you have installed and its location.
For example:
InstalledCountries=AUS,Australia,/usr/qas/data/aus.001/aus
+GBR,United Kingdom,/usr/qas/data/gbr.001/gbr
The AUS value of InstalledCountries indicates where your Australia data files
are currently installed. The setting is of the format:
InstalledCountries={ISO},{Country Name},{PATH}/{iso-file-prefix}
In this case, /usr/qas/data/aus.001 is the path where the country data is stored.
Add a NewInstalledCountries setting to the qawserve.ini file, and add a line to
the setting for each data set that you are updating, in the same format as above.
For example:
GBR, United Kingdom, /data/gbr.001/gbr
For subsequent data updates, add new lines to the NewInstalledCountries
setting as required.
Finally, activate the data using the Administrator Console (Windows), or the Command-Line Management Utility.
Activating Data Using the Command Line Management Utility
The Command Line Management Utility is available for Windows and UNIX administrators. Arguments are passed in on the command line and the results are output on one or more lines.
Synopsis
wvmgmtd [-ini:<config file>] <command>[<argument1>] ...
Arguments
Use the -ini<config file> option to specify an alternate configuration file from which settings can be read.
For <arguments>, you can specify particular servers, clients or data files for the command to process; the default behaviour is that all are processed. The <Server> can be any of the following:
Server number (index of server in server list, starting from zero)
or
Server name:port
or
Server IP address:port
Output
Each <command> has different output. The command summaries (below) describe the output in more detail.
Common output elements include:
<EOL> is equivalent to LF or CR/LF depending on the platform.
The <Errorcode> value returned has the following format: -errorcode<TAB>Error description
For example: -1010<TAB>File not found
Return Value
If an error occurs, wvmgmtd returns an exit status of 255, otherwise the exit status is 0.
Activate New Data Set Command:
wvmgmtd -ini:qaworld licenceadd “<Licence Number>” <Server>
Output:
<Error No><TAB><Error Description><EOL>
Related links
QAS Pro Web support zone |
UK home
Send this