Obtaining and Deploying a QKB

Obtaining a QKB

You can obtain a QKB in one of the following ways:
  • Run the SAS Deployment Wizard. In the Select Products to Install dialog box, select the check box for the SAS Quality Knowledge Base for your order. For step-by-step guidance on installing a QKB using the SAS Deployment Wizard, see the SAS Quality Knowledge Base for Contact Information: Installation and Configuration Guide or the SAS Quality Knowledge Base for Product Data: Installation and Configuration Guide, as appropriate, on the Quality Knowledge Base for SAS and SAS DataFlux Documentation site.
  • Download a QKB from the SAS Downloads site. Contact your SAS Administrator to determine which QKB has been licensed before downloading.
    Select a QKB, and then follow the installation instructions in the Readme file for your operating environment. To open the Readme file, you must have a SAS profile. When prompted, you can log on or create a new profile.
  • Copy a QKB that you already use with other SAS software in your enterprise. Contact your system administrator for its location.

Packaging the QKB

Before a QKB can be deployed in the Teradata database, you must package it into an .rpm file. An .rpm file is a file that is suitable for installation on Linux systems that use RPM package management software. SAS Data Quality Accelerator for Teradata provides the qkb_pack script to package the QKB into an .rpm file.
Windows and UNIX versions of qkb_pack are available. You must run the version that is appropriate for the host environment in which your QKB is installed.
qkb_pack is created in the following directories by the SAS Deployment Wizard:
Windows
<SASHome>\SASDataQualityAcceleratorforTeradata\9.4\dqacctera\sasmisc
UNIX
<SASHome>/SASDataQualityAcceleratorforTeradata/9.4/install/pgm
You must execute qkb_pack from the <SASHome> location.
Here is the syntax for executing qkb_pack:
Windows:
qkb_pack.cmd qkb-dir out-dir
UNIX:
./qkb_pack.sh qkb-dir out-dir

qkb-dir

specify the path to the QKB. Use the name of the QKB’s root directory. Typically, the root directory is found at the following directories:

Windows: C:\ProgramData\SAS\SASQualityKnowledgeBase\product-identifier\product-version (for example, C:\ProgramData\SAS\SASQualityKnowledgeBase\CI\27 or C:\ProgramData\SAS\SASQualityKnowledgeBase\PD\5).
UNIX: /opt/sas/qkb/share
Note: On Windows systems, QKB information exists in two locations: in C:\ProgramData and in C:\Program Files. For the qkb_pack command, you must specify the C:\ProgramData location.

out-dir

specify the directory where you want the package file to be created.

Here is an example of a command that you might execute to package a SAS QKB for Contact Information that resides on a Windows computer.
cd c:\Program Files\SASHome\SASDataQualityAcceleratorforTeradata\9.4\dqacctera\sasmisc
qkb_pack.cmd c:\ProgramData\SAS\QKB\CI\27  c:\temp\
The default location for the qkb-dir argument is: C:\ProgramData\SAS\SASQualityKnowledgeBase\CI\27.
The package file that is created in C:\temp\ will have a name in the following form:
sasqkb_product-version-timestamp.noarch.rpm

product

is a two-character product code for the QKB, such as CI (for Contact Information) or PD (for Product Data).

version

is the version number of the QKB.

timestamp

is a UNIX datetime value that indicates when qkb_pack was invoked. A UNIX datetime value is stored as the number of seconds since January 1, 1970.

noarch

indicates that the package file is platform-independent.

Here is an example of an output filename representing the QKB for Contact Information 27:
sasqkb_ci-27.0-1474057340608.noarch.rpm
After running qkb_pack, put the sasqkb package file on your Teradata database server in a location where it is available for both reading and writing. The package file must be readable by the Teradata Parallel Upgrade Tool. You need to move this package file to the server machine in accordance with procedures used at your site.
Follow the steps in Installing the QKB Package File with the Teradata Parallel Upgrade Tool to deploy the QKB package file in the Teradata database.

Installing the QKB Package File with the Teradata Parallel Upgrade Tool

This installation should be performed by a Teradata systems administrator in collaboration with Teradata Customer Services. A Teradata Change Control is required when a package is added to the Teradata server. Teradata Customer Services has developed change control procedures for installing the SAS in-database deployment package.
The steps assume full knowledge of the Teradata Parallel Upgrade Tool and your environment. For more information about using the Teradata Parallel Upgrade Tool, see the Parallel Upgrade Tool (PUT) Reference, which is on the Teradata Online Publications site located at http://www.info.teradata.com/GenSrch/eOnLine-Srch.cfm. On this page, search for “Parallel Upgrade Tool” and download the appropriate document for your system.
The following section explains the basic steps to install the sasqkb package file using the Teradata Parallel Upgrade Tool.
Note: It is not necessary to stop and restart the Teradata database when you install a QKB. However, if the SAS Embedded Process is running, you must stop it and then re-start it after the QKB is installed. It is also necessary to stop and restart the SAS Embedded Process for QKB updates. See Controlling the SAS Embedded Process for information about stopping and restarting the SAS Embedded Process.
  1. Start the Teradata Parallel Upgrade Tool.
  2. Be sure to select all Teradata TPA nodes for installation, including Hot Stand-By nodes.
  3. If Teradata Version Migration and Fallback (VM&F) is installed, you might be prompted whether to use VM&F. If you are prompted, choose Non-VM&F installation.
You can verify that the QKB installation was successful by running the following command from the shell prompt on one of the Teradata nodes.
psh "rpm -q -a" | grep sasqkb
If the installation was successful, the command returns the version number of the sasqkb package. Failure to return an output indicates that a library of that name could not be found.
The QKB is installed in the /opt/qkb/default directory of each Teradata node.
You are now ready to validate the data quality stored procedures for use.
Last updated: February 9, 2017