The Pro API installer contains the setup executable for Pro API. There are four steps to installing Pro API on Windows:

  1. Run the Pro API setup executable.
  2. Once the installation program starts, follow the on-screen instructions to install Pro API.
  3. On the license Agreement dialog, the license agreement is displayed. You should read the license agreement, and if you are happy with the terms, select the I accept the terms of the license agreement option.
  4. Choose the destination folder you want to install to.
  5. When you are ready to begin the installation click Install.
  6. Click Finish to complete your installation.

Run the data installer from the CD or DVD. To ensure that all datasets are compatible, all data CDs or DVDs for a country must be the same version, and should be installed at the same time.

A set of files is installed for each dataset you need to support. For example, there are four data files installed for Australia: aus.dts, aus.tpx, aus.zlx and aus.zlb.

To install or update data on Windows, follow these steps:

  1. Insert the first CD-ROM or the DVD into the relevant drive, click the Start menu and select Run.
  2. In the dialog box that appears, type d:/setup, where d is the drive letter for your CD-ROM or DVD drive, and press Enter.
  3. Follow the instruction on the screen to install new or replace existing datasets.

Data Updates
Experian provides periodic updates of datasets as and when updated data is available. These updates are supplied to you on CD-ROM or DVD; follow the instructions in the installation program to replace your existing datasets.

Datasets expire after a certain period of time, at which point you must install an update. The low level API function QA_GetLicensingDetail tells you how many days are left before a dataset expires. By default, a dialog will be displayed when you start Pro, which lists all the datasets that are due to expire soon. You can disable this dialog using the qaattribs_NOLICENSINGDLG flag.

Visit the troubleshooting section to troubleshoot your installation.

There are three steps to installing Pro API on Linux:

You will need to know the IP address of your machine as well as the number of an unused port (first port) for the primary Pro API Server. If you are using Partner Sourced datasets, you will also require the number of an unused second port for the Partner Sourced Data Server.

To install the Pro API software, follow these steps:

  1. Extract the appropriate files for your platform (i.e. web.800.bin.tar) to a suitable location, for example /opt/qasProWeb/.

  2. In order to view the man pages supplied with Pro API, you must first copy them from the man/man7 directory in the pro installer to the man/man7 directory on your computer. This is usually usr/share/man/man7. Once copied, man pages can be invoked using the man command.

  3. Navigate to your chosen location and, using a text editor such as vim, edit the indicated lines in the following files:

    • qawserve.ini
    • ServerAddress=QATCPIP:IP address:first port
    • ServerWSDLUrn=http://IP address:first port
    • ExternalServers=description,QATCPIP:IP address:second port

    Where description is an internal label for the Partner Sourced Data Server. If you are not using the Partner Sourced Data Server it is not necessary to edit the ExternalServers line.

    • acserver.ini
    • ServerAddress=QATCPIP:IP address:second port
    • UnlockCode=license key
    • +license key

    Where each license key is the full text of a Partner Sourced dataset license key as it appears on your despatch note. If you are not using the Partner Sourced Data Server it is not necessary to edit acserver.ini.

    • qaworld.ini
    • ServerAddress=QATCPIP:IP address:first port
    • qalicn.ini

Add your Primary Sourced data license key(s) to separate lines at the end of this file, as they appear on your despatch note.

Data files are installed separately from Pro API but they should be located on the same machine as the Pro API Server. The files installed vary according to the dataset, additional datasets and DataPlus sets you have purchased. For information about a specific dataset see the Data Guide that shipped with your data.

Before you begin the installation process, you should ensure that you have the despatch note that is supplied with Pro API. The despatch note contains all of the license keys for each dataset that you have purchased. When you install data for the first time, you are prompted to insert the license key for each dataset that you want to install.

Installing Primary Sourced Data

To install new Primary Sourced data, follow these steps:

  1. Copy the data files to an appropriate location on your system, for example /opt/qasData/.

  2. The first time that you install a dataset, you will need to add the InstalledData and DataMappings settings to the qawserve.ini file. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server) and open qawserve.ini in a text editor such as vim.

  3. Under the [QADefault] sections, add an InstalledData line. This setting should contain a list of the datasets you have installed, and their locations:

    InstalledData={dataset identifier},{path}
    +{dataset identifier},{path}
    

    This setting should point to the data that you just copied. For example, the line might read:

    InstalledData=GBR,/opt/qasData/gbr001

    If more than one dataset is to be added to this setting, you should use the plus (+) sign at the start of each subseqent line. For example:

    InstalledData=GBR,/opt/qasData/gbr001
    +USA,/opt/qasData/usa001
    
  4. Add a new AllInstalledData line beneath this, with the same content:

    AllInstalledData=GBR,/opt/qasData/gbr001
    +USA,/opt/qasData/usa001
    

    Do not remove any exisiting lines from the AllInstalledData setting.

  5. In the same section, add a DataMappings setting. This setting should contain a list of the datasets and groups of additional datasets you want to use:

    DataMappings={data mapping identifier},{data mapping name},{dataset list}
    +{data mapping identifier},{data mapping name},{dataset list}
    

    In this example, if you had a Names additional dataset, the line might read:

    Datamappings=GBR,United Kingdom,GBR
    +GBN,United Kingdom With Names,GBR+GBRNAM
    

Updating Primary Sourced Data

To update existing Primary Sourced data, follow these steps:

  1. Copy the data files to an appropriate new location on your system.

  2. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server), and open qawserve.ini in a text editor such as vim.

  3. Under the [QADefault] section, add or edit the NewInstalledData setting as required. This setting lists the data you have installed, but have not yet activated to work with any products.
    The setting is in the same format as the InstalledData setting:

    NewInstalledData={dataset identifier},{path}

    This setting has to point to the data that you just copied. For example, the line might read:

    NewInstalledData=GBR,/opt/qasData/gbr001

    If more than one dataset is to be added to this setting, you should use the plus (+) sign at the start of each subsequent line. For example:

    NewInstalledData=GBR,/opt/qasData/gbr001
    +AUS,/opt/qasData/aus001
    

    You should also check that the DataMappings setting is still correct for the data you are updating.

  4. Finally, activate the new data using the Administrator Console or the Command Line Management Utility.

Installing Partner Sourced Data

To install new Partner Sourced data, follow these steps:

  1. Stop the Partner Sourced Data Server (qasproglo) if it is running.

  2. If you already have Partner Sourced datasets installed, you must copy the data files from the data DVD to the same location as the existing data on your system. If this is the first time you are installing Partner Sourced datasets, you can choose an appropriate location, such as /opt/qasData/.

  3. Ensure the data filenames are in upper case and in the correct format, for example: ITA5BI.MD, ITA5FC.MD and ITA5GC.MD. The first three characters of the filename are the ISO code of the country whose data is stored in the file.
    Datasets can occupy between one and three files, ending in BI, FC or GC (as above). You should copy all files for each dataset you are licensed to use.

  4. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server) and open acserver.ini in a text editor such as vim.

  5. Under the [QADefault] section, locate or create the DataDir line. This setting should contain the path to which you copied the data files, for example:

    DataDir=/opt/qasData/

    You can also use the InstalledData setting to specify the location of each dataset separately.

  6. In the same section, locate the DataMappings setting. This setting should contain a complete list of the Partner Sourced datasets you want to use, so you need to add a line for each new dataset you are installing:

    DataMappings={data mapping identifier},{description},{ISO}

    For example, if you had the Austria and Italy datasets the line might read:

    Datamappings=AUT,Austria,AUT
    +ITA,Italy,ITA
    
  7. Start or restart the Partner Sourced Data Server.

Updating Partner Sourced Data

  1. Stop the Partner Sourced Data Server (qasproglo) if it is running.
  2. If you want to be able to rollback to a previous version of the data you should back up your existing data files to a suitable location.
  3. Copy the data files to the location in which your Partner Sourced datasets are stored, overwriting the existing ones.
  4. Ensure the data filenames are in uppercase and in the correct format. For example: ITA5BI.MD, ITA5FC.MD and ITA5GC.MD. The first three characters of the filename are the ISO code of the country whose data is stored in the file. Datasets can occupy between one and three files, ending in BI, FC or GC (as above). You should copy all files for each dataset you are licensed to use.
  5. You should check that the DataDir, InstalledData and DataMappings settings in the acserver.ini file (located in /opt/qasProWeb/ or wherever you installed the Pro API Server) are still correct for the data you have updated.
  6. Start or restart the Partner Sourced Data Server.

If you need to perform a data rollback, follow these steps but copy the data file from your backup location.

You should copy all files. Data files must be in lower case and in the following format: usa.zlx, usa.dts, usagcd.dap.

The first time that you carry out a data update, you will need to add InstalledData and DataMappings settings 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 the [QADefault] section, locate the settings InstalledData and DataMappings. These settings contains a list of the datasets you have installed.

Add a line to each setting for each new dataset that you are installing, or update the path for any dataset you are updating.

Data Updates
Experian provides periodic updates of datasets as and when updated data is available. These updates will be sent to you; follow the instructions in the installation program to replace your existing datasets.

Datasets expire after a certain period of time, at which point you must install an update. The low level API function QA_GetLicensingDetail tells you how many days are left before a dataset expires. By default, a dialog will be displayed when you start Pro, which lists all the datasets that are due to expire soon. You can disable this dialog using the qaattribs_NOLICENSINGDLG flag.

Before you start the server you should check the resource limit values.

Checking the Resource Limit Values

Depending on whether you want to start the server interactively or via the system's startup scripts, resource limitations may apply. Use the ulimit -a command (or your system's equivalent) to verify that the following requirements are met:

Resource Name Limitation
time This needs to be set to unlimited for continuous operation.
stack(kbytes) This should be set to a minimum value of 1024KB.
open files This should be set to a minimum value of 4 for each concurrent client. If you use DataPlus, the factor can increase up to the number of data files installed for the dataset. For example, if you use all the Australia DataPlus sets then the value should be 8 for each concurrent client.

The resource names may vary depending on your API operating system. For example, "open files" is called "nofiles (descriptors)" on AIX.

Starting the Service

To start the service, follow these steps:

  1. Navigate to your chosen installation directory (for example, /opt/qasProWeb).
  2. If you are using Partner Sourced datasets, type ./qasproglo & and press Enter. This will start the Partner Sourced Data Server.
  3. Type ./qaswvd & and press Enter. This will start the Pro API Server and fork it to the background.

There are three steps to installing Pro API on Aix:

You will need to know the IP address of your machine as well as the number of an unused port (first port) for the primary Pro API Server. If you are using Partner Sourced datasets, you will also require the number of an unused second port for the Partner Sourced Data Server.

To install the Pro API software, follow these steps:

  1. Extract the appropriate files for your platform (i.e. web.800.bin.tar) to a suitable location, for example /opt/qasProWeb/.

  2. In order to view the man pages supplied with Pro API, you must first copy them from the man/man7 directory in the pro installer to the man/man7 directory on your computer. This is usually usr/share/man/man7. Once copied, man pages can be invoked using the man command.

  3. Navigate to your chosen location and, using a text editor such as vim, edit the indicated lines in the following files:

    • qawserve.ini
    • ServerAddress=QATCPIP:IP address:first port
    • ServerWSDLUrn=http://IP address:first port
    • ExternalServers=description,QATCPIP:IP address:second port

    Where description is an internal label for the Partner Sourced Data Server. If you are not using the Partner Sourced Data Server it is not necessary to edit the ExternalServers line.

    • acserver.ini
    • ServerAddress=QATCPIP:IP address:second port
    • UnlockCode=license key
    • +license key

    Where each license key is the full text of a Partner Sourced dataset license key as it appears on your despatch note. If you are not using the Partner Sourced Data Server it is not necessary to edit acserver.ini.

    • qaworld.ini
    • ServerAddress=QATCPIP:IP address:first port
    • qalicn.ini

Add your Primary Sourced data license key(s) to separate lines at the end of this file, as they appear on your despatch note.

Data files are installed separately from Pro API but they should be located on the same machine as the Pro API Server. The files installed vary according to the dataset, additional datasets and DataPlus sets you have purchased. For information about a specific dataset see the Data Guide that shipped with your data.

Before you begin the installation process, you should ensure that you have the despatch note that is supplied with Pro API. The despatch note contains all of the license keys for each dataset that you have purchased. When you install data for the first time, you are prompted to insert the license key for each dataset that you want to install.

Installing Primary Sourced Data

To install new Primary Sourced data, follow these steps:

  1. Copy the data files to an appropriate location on your system, for example /opt/qasData/.

  2. The first time that you install a dataset, you will need to add the InstalledData and DataMappings settings to the qawserve.ini file. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server) and open qawserve.ini in a text editor such as vim.

  3. Under the [QADefault] sections, add an InstalledData line. This setting should contain a list of the datasets you have installed, and their locations:

    InstalledData={dataset identifier},{path}
    +{dataset identifier},{path}
    

    This setting should point to the data that you just copied. For example, the line might read:

    InstalledData=GBR,/opt/qasData/gbr001

    If more than one dataset is to be added to this setting, you should use the plus (+) sign at the start of each subseqent line. For example:

    InstalledData=GBR,/opt/qasData/gbr001
    +USA,/opt/qasData/usa001
    
  4. Add a new AllInstalledData line beneath this, with the same content:

    AllInstalledData=GBR,/opt/qasData/gbr001
    +USA,/opt/qasData/usa001
    

    Do not remove any exisiting lines from the AllInstalledData setting.

  5. In the same section, add a DataMappings setting. This setting should contain a list of the datasets and groups of additional datasets you want to use:

    DataMappings={data mapping identifier},{data mapping name},{dataset list}
    +{data mapping identifier},{data mapping name},{dataset list}
    

    In this example, if you had a Names additional dataset, the line might read:

    Datamappings=GBR,United Kingdom,GBR
    +GBN,United Kingdom With Names,GBR+GBRNAM
    

Updating Primary Sourced Data

To update existing Primary Sourced data, follow these steps:

  1. Copy the data files to an appropriate new location on your system.

  2. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server), and open qawserve.ini in a text editor such as vim.

  3. Under the [QADefault] section, add or edit the NewInstalledData setting as required. This setting lists the data you have installed, but have not yet activated to work with any products.
    The setting is in the same format as the InstalledData setting:

    NewInstalledData={dataset identifier},{path}

    This setting has to point to the data that you just copied. For example, the line might read:

    NewInstalledData=GBR,/opt/qasData/gbr001

    If more than one dataset is to be added to this setting, you should use the plus (+) sign at the start of each subsequent line. For example:

    NewInstalledData=GBR,/opt/qasData/gbr001
    +AUS,/opt/qasData/aus001
    

    You should also check that the DataMappings setting is still correct for the data you are updating.

  4. Finally, activate the new data using the Administrator Console or the Command Line Management Utility.

Installing Partner Sourced Data

To install new Partner Sourced data, follow these steps:

  1. Stop the Partner Sourced Data Server (qasproglo) if it is running.

  2. If you already have Partner Sourced datasets installed, you must copy the data files from the data DVD to the same location as the existing data on your system. If this is the first time you are installing Partner Sourced datasets, you can choose an appropriate location, such as /opt/qasData/.

  3. Ensure the data filenames are in upper case and in the correct format, for example: ITA5BI.MD, ITA5FC.MD and ITA5GC.MD. The first three characters of the filename are the ISO code of the country whose data is stored in the file.
    Datasets can occupy between one and three files, ending in BI, FC or GC (as above). You should copy all files for each dataset you are licensed to use.

  4. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server) and open acserver.ini in a text editor such as vim.

  5. Under the [QADefault] section, locate or create the DataDir line. This setting should contain the path to which you copied the data files, for example:

    DataDir=/opt/qasData/

    You can also use the InstalledData setting to specify the location of each dataset separately.

  6. In the same section, locate the DataMappings setting. This setting should contain a complete list of the Partner Sourced datasets you want to use, so you need to add a line for each new dataset you are installing:

    DataMappings={data mapping identifier},{description},{ISO}

    For example, if you had the Austria and Italy datasets the line might read:

    Datamappings=AUT,Austria,AUT
    +ITA,Italy,ITA
    
  7. Start or restart the Partner Sourced Data Server.

Updating Partner Sourced Data

  1. Stop the Partner Sourced Data Server (qasproglo) if it is running.
  2. If you want to be able to rollback to a previous version of the data you should back up your existing data files to a suitable location.
  3. Copy the data files to the location in which your Partner Sourced datasets are stored, overwriting the existing ones.
  4. Ensure the data filenames are in uppercase and in the correct format. For example: ITA5BI.MD, ITA5FC.MD and ITA5GC.MD. The first three characters of the filename are the ISO code of the country whose data is stored in the file. Datasets can occupy between one and three files, ending in BI, FC or GC (as above). You should copy all files for each dataset you are licensed to use.
  5. You should check that the DataDir, InstalledData and DataMappings settings in the acserver.ini file (located in /opt/qasProWeb/ or wherever you installed the Pro API Server) are still correct for the data you have updated.
  6. Start or restart the Partner Sourced Data Server.

If you need to perform a data rollback, follow these steps but copy the data file from your backup location.

You should copy all files. Data files must be in lower case and in the following format: usa.zlx, usa.dts, usagcd.dap.

The first time that you carry out a data update, you will need to add InstalledData and DataMappings settings 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 the [QADefault] section, locate the settings InstalledData and DataMappings. These settings contains a list of the datasets you have installed.

Add a line to each setting for each new dataset that you are installing, or update the path for any dataset you are updating.

Data Updates
Experian provides periodic updates of datasets as and when updated data is available. These updates will be sent to you; follow the instructions in the installation program to replace your existing datasets.

Datasets expire after a certain period of time, at which point you must install an update. The low level API function QA_GetLicensingDetail tells you how many days are left before a dataset expires. By default, a dialog will be displayed when you start Pro, which lists all the datasets that are due to expire soon. You can disable this dialog using the qaattribs_NOLICENSINGDLG flag.

Before you start the server you should check the resource limit values.

Checking the Resource Limit Values

Depending on whether you want to start the server interactively or via the system's startup scripts, resource limitations may apply. Use the ulimit -a command (or your system's equivalent) to verify that the following requirements are met:

Resource Name Limitation
time This needs to be set to unlimited for continuous operation.
stack(kbytes) This should be set to a minimum value of 1024KB.
open files This should be set to a minimum value of 4 for each concurrent client. If you use DataPlus, the factor can increase up to the number of data files installed for the dataset. For example, if you use all the Australia DataPlus sets then the value should be 8 for each concurrent client.

The resource names may vary depending on your API operating system. For example, "open files" is called "nofiles (descriptors)" on AIX.

Starting the Service

To start the service, follow these steps:

  1. Navigate to your chosen installation directory (for example, /opt/qasProWeb).
  2. If you are using Partner Sourced datasets, type ./qasproglo & and press Enter. This will start the Partner Sourced Data Server.
  3. Type ./qaswvd & and press Enter. This will start the Pro API Server and fork it to the background.

There are three steps to installing Pro API on Solaris:

You will need to know the IP address of your machine as well as the number of an unused port (first port) for the primary Pro API Server. If you are using Partner Sourced datasets, you will also require the number of an unused second port for the Partner Sourced Data Server.

To install the Pro API software, follow these steps:

  1. Extract the appropriate files for your platform (i.e. web.800.bin.tar) to a suitable location, for example /opt/qasProWeb/.

  2. In order to view the man pages supplied with Pro API, you must first copy them from the man/man7 directory in the pro installer to the man/man7 directory on your computer. This is usually usr/share/man/man7. Once copied, man pages can be invoked using the man command.

  3. Navigate to your chosen location and, using a text editor such as vim, edit the indicated lines in the following files:

    • qawserve.ini
    • ServerAddress=QATCPIP:IP address:first port
    • ServerWSDLUrn=http://IP address:first port
    • ExternalServers=description,QATCPIP:IP address:second port

    Where description is an internal label for the Partner Sourced Data Server. If you are not using the Partner Sourced Data Server it is not necessary to edit the ExternalServers line.

    • acserver.ini
    • ServerAddress=QATCPIP:IP address:second port
    • UnlockCode=license key
    • +license key

    Where each license key is the full text of a Partner Sourced dataset license key as it appears on your despatch note. If you are not using the Partner Sourced Data Server it is not necessary to edit acserver.ini.

    • qaworld.ini
    • ServerAddress=QATCPIP:IP address:first port
    • qalicn.ini

Add your Primary Sourced data license key(s) to separate lines at the end of this file, as they appear on your despatch note.

Data files are installed separately from Pro API but they should be located on the same machine as the Pro API Server. The files installed vary according to the dataset, additional datasets and DataPlus sets you have purchased. For information about a specific dataset see the Data Guide that shipped with your data.

Before you begin the installation process, you should ensure that you have the despatch note that is supplied with Pro API. The despatch note contains all of the license keys for each dataset that you have purchased. When you install data for the first time, you are prompted to insert the license key for each dataset that you want to install.

Installing Primary Sourced Data

To install new Primary Sourced data, follow these steps:

  1. Copy the data files to an appropriate location on your system, for example /opt/qasData/.

  2. The first time that you install a dataset, you will need to add the InstalledData and DataMappings settings to the qawserve.ini file. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server) and open qawserve.ini in a text editor such as vim.

  3. Under the [QADefault] sections, add an InstalledData line. This setting should contain a list of the datasets you have installed, and their locations:

    InstalledData={dataset identifier},{path}
    +{dataset identifier},{path}
    

    This setting should point to the data that you just copied. For example, the line might read:

    InstalledData=GBR,/opt/qasData/gbr001

    If more than one dataset is to be added to this setting, you should use the plus (+) sign at the start of each subseqent line. For example:

    InstalledData=GBR,/opt/qasData/gbr001
    +USA,/opt/qasData/usa001
    
  4. Add a new AllInstalledData line beneath this, with the same content:

    AllInstalledData=GBR,/opt/qasData/gbr001
    +USA,/opt/qasData/usa001
    

    Do not remove any exisiting lines from the AllInstalledData setting.

  5. In the same section, add a DataMappings setting. This setting should contain a list of the datasets and groups of additional datasets you want to use:

    DataMappings={data mapping identifier},{data mapping name},{dataset list}
    +{data mapping identifier},{data mapping name},{dataset list}
    

    In this example, if you had a Names additional dataset, the line might read:

    Datamappings=GBR,United Kingdom,GBR
    +GBN,United Kingdom With Names,GBR+GBRNAM
    

Updating Primary Sourced Data

To update existing Primary Sourced data, follow these steps:

  1. Copy the data files to an appropriate new location on your system.

  2. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server), and open qawserve.ini in a text editor such as vim.

  3. Under the [QADefault] section, add or edit the NewInstalledData setting as required. This setting lists the data you have installed, but have not yet activated to work with any products.
    The setting is in the same format as the InstalledData setting:

    NewInstalledData={dataset identifier},{path}

    This setting has to point to the data that you just copied. For example, the line might read:

    NewInstalledData=GBR,/opt/qasData/gbr001

    If more than one dataset is to be added to this setting, you should use the plus (+) sign at the start of each subsequent line. For example:

    NewInstalledData=GBR,/opt/qasData/gbr001
    +AUS,/opt/qasData/aus001
    

    You should also check that the DataMappings setting is still correct for the data you are updating.

  4. Finally, activate the new data using the Administrator Console or the Command Line Management Utility.

Installing Partner Sourced Data

To install new Partner Sourced data, follow these steps:

  1. Stop the Partner Sourced Data Server (qasproglo) if it is running.

  2. If you already have Partner Sourced datasets installed, you must copy the data files from the data DVD to the same location as the existing data on your system. If this is the first time you are installing Partner Sourced datasets, you can choose an appropriate location, such as /opt/qasData/.

  3. Ensure the data filenames are in upper case and in the correct format, for example: ITA5BI.MD, ITA5FC.MD and ITA5GC.MD. The first three characters of the filename are the ISO code of the country whose data is stored in the file.
    Datasets can occupy between one and three files, ending in BI, FC or GC (as above). You should copy all files for each dataset you are licensed to use.

  4. Navigate to /opt/qasProWeb/ (or wherever you installed the Pro API Server) and open acserver.ini in a text editor such as vim.

  5. Under the [QADefault] section, locate or create the DataDir line. This setting should contain the path to which you copied the data files, for example:

    DataDir=/opt/qasData/

    You can also use the InstalledData setting to specify the location of each dataset separately.

  6. In the same section, locate the DataMappings setting. This setting should contain a complete list of the Partner Sourced datasets you want to use, so you need to add a line for each new dataset you are installing:

    DataMappings={data mapping identifier},{description},{ISO}

    For example, if you had the Austria and Italy datasets the line might read:

    Datamappings=AUT,Austria,AUT
    +ITA,Italy,ITA
    
  7. Start or restart the Partner Sourced Data Server.

Updating Partner Sourced Data

  1. Stop the Partner Sourced Data Server (qasproglo) if it is running.
  2. If you want to be able to rollback to a previous version of the data you should back up your existing data files to a suitable location.
  3. Copy the data files to the location in which your Partner Sourced datasets are stored, overwriting the existing ones.
  4. Ensure the data filenames are in uppercase and in the correct format. For example: ITA5BI.MD, ITA5FC.MD and ITA5GC.MD. The first three characters of the filename are the ISO code of the country whose data is stored in the file. Datasets can occupy between one and three files, ending in BI, FC or GC (as above). You should copy all files for each dataset you are licensed to use.
  5. You should check that the DataDir, InstalledData and DataMappings settings in the acserver.ini file (located in /opt/qasProWeb/ or wherever you installed the Pro API Server) are still correct for the data you have updated.
  6. Start or restart the Partner Sourced Data Server.

If you need to perform a data rollback, follow these steps but copy the data file from your backup location.

You should copy all files. Data files must be in lower case and in the following format: usa.zlx, usa.dts, usagcd.dap.

The first time that you carry out a data update, you will need to add InstalledData and DataMappings settings 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 the [QADefault] section, locate the settings InstalledData and DataMappings. These settings contains a list of the datasets you have installed.

Add a line to each setting for each new dataset that you are installing, or update the path for any dataset you are updating.

Data Updates
Experian provides periodic updates of datasets as and when updated data is available. These updates will be sent to you; follow the instructions in the installation program to replace your existing datasets.

Datasets expire after a certain period of time, at which point you must install an update. The low level API function QA_GetLicensingDetail tells you how many days are left before a dataset expires. By default, a dialog will be displayed when you start Pro, which lists all the datasets that are due to expire soon. You can disable this dialog using the qaattribs_NOLICENSINGDLG flag.

Before you start the server you should check the resource limit values.

Checking the Resource Limit Values

Depending on whether you want to start the server interactively or via the system's startup scripts, resource limitations may apply. Use the ulimit -a command (or your system's equivalent) to verify that the following requirements are met:

Resource Name Limitation
time This needs to be set to unlimited for continuous operation.
stack(kbytes) This should be set to a minimum value of 1024KB.
open files This should be set to a minimum value of 4 for each concurrent client. If you use DataPlus, the factor can increase up to the number of data files installed for the dataset. For example, if you use all the Australia DataPlus sets then the value should be 8 for each concurrent client.

The resource names may vary depending on your API operating system. For example, "open files" is called "nofiles (descriptors)" on AIX.

Starting the Service

To start the service, follow these steps:

  1. Navigate to your chosen installation directory (for example, /opt/qasProWeb).
  2. If you are using Partner Sourced datasets, type ./qasproglo & and press Enter. This will start the Partner Sourced Data Server.
  3. Type ./qaswvd & and press Enter. This will start the Pro API Server and fork it to the background.