Upgrading from a Previous Version

Upgrading from a Version That Was Installed before the Third Maintenance Release of SAS 9.4 (July 2015)

To upgrade from a previous version of the SAS Formats Library, the SAS Embedded Process, or both, follow these steps:
  1. Check the current installed version of the SAS formats library.
    How you do this depends on the version of the SAS formats library.
    • If a SAS 9.2 version of the formats library is currently installed, run this command:
      psh "rpm -q -a" | grep jazxfbrs
      If a previous version is installed, a result similar to this is displayed. The version number might be different.
      jazxfbrs-9.2-1.9
    • If a SAS 9.3 or SAS 9.4 version of the formats library is currently installed, run this command:
      psh "rpm -q -a" | grep acc
      If a previous version is installed, a result similar to this is displayed. The version number might be different.
      accelterafmt-3.1-1.x86_64
    If the library is not installed on the Teradata nodes, no output is displayed. You can continue with the installation steps in Installing the SAS Formats Library and the SAS Embedded Process.
  2. Run this command to check the current installed version of the SAS Embedded Process.
    psh "rpm -qa | grep tkindbsrv"
    If a previous version is installed, a result similar to this is displayed. The version number might be different.
    tkindbsrv-9.42_M1-2.x86_64
    If the SAS Embedded Process is not installed on the Teradata nodes, no output is displayed. You can continue with the installation steps in Installing the SAS Formats Library and the SAS Embedded Process.
  3. If a version of the SAS formats library, the SAS Embedded Process, or both is being installed that has a name that is different from the library that was previously installed, then follow these steps. An example would be one of these:
    • accelterafmt-3.1-1 replacing jazxfbrs-9.2-1.6
    • sepcoretera-9.43000-1 replacing tkindbsrv-9.42_M1-2
    1. If you are upgrading the SAS Formats Library, shut down the Teradata database.
      tpareset -y -x shutdown_comment
      This step is required because an older version of the SAS formats library might be loaded in a currently running SAS query.
      Note: If you are upgrading only the SAS Embedded Process (tkindbsrv.rpm file), you do not need to shut down the database. You do need to shut down the SAS Embedded Process. For more information about how to shut down the SAS Embedded Process, see Controlling the SAS Embedded Process.
    2. Confirm that the database is shut down.
      pdestate -a
      DOWN/HARDSTOP is displayed if the database is shut down.
    3. If the SAS Data Quality Accelerator for Teradata is installed, you must uninstall it before you uninstall the SAS Embedded Process. For more information, see Removing SAS Data Quality Accelerator from the Teradata Database.
    4. Remove the old version of the in-database deployment package before you install the updated version.
      • To remove the packages from all nodes concurrently, run this command:
        psh "rpm -e package-name"
        package-name is either jazxfbrs.9.version, accelterafmt-version, or tkindbsrv-version.
        For example, to remove jazxfbrs, run the command psh "rpm -e jazxfbrs-9.2–1.6".
      • To remove the package from each node, run this command on each node:
        rpm -e package-name
        package-name is either jazxfbrs.9.version, accelterafmt-version, or tkindbsrv-version.
  4. (Optional) To confirm removal of the package before installing the new package, run this command:
    psh "rpm -q package-name"
    package-name is either jazxfbrs.9.version, accelterafmt-version, or tkindbsrv-version.
    The SAS Formats Library or the SAS Embedded Process should not appear on any node.

Upgrading Versions That Were Installed after the Third Maintenance Release of SAS 9.4 (July 2015)

To upgrade from a previous version of the SAS Formats Library, the SAS Embedded Process, or both, follow these steps:
  1. Run this command to check the current installed version of the SAS formats library.
    psh "rpm -q -a" | grep acc
    If a previous version is installed, a result similar to this is displayed. The version number might be different.
    accelterafmt-3.1-1.x86_64
    If the library is not installed on the Teradata nodes, no output is displayed. You can continue with the installation steps in Installing the SAS Formats Library and the SAS Embedded Process.
  2. Run this command to check the current installed version of the SAS Embedded Process.
    psh "rpm -e sepcoretera*"
    If a previous version is installed, a result similar to this is displayed. The version number might be different.
    sepcoretera-9.43000-1.x86_64
    If the SAS Embedded Process is not installed on the Teradata nodes, no output is displayed. You can continue with the installation steps in Installing the SAS Formats Library and the SAS Embedded Process.
  3. If the SAS Data Quality Accelerator for Teradata is installed, you must uninstall it before you uninstall the SAS Embedded Process. For more information, see Removing SAS Data Quality Accelerator from the Teradata Database.
  4. If a version of the SAS formats library, the SAS Embedded Process, or both is being installed, and has a name that is different from the library that was previously installed, then follow these steps. An example is one of these:
    • accelterafmt-3.1-1 replacing jazxfbrs-9.2-1.6
    • sepcoretera-12.0000-1 replacing sepcoretera-9.43000-1.x86_64
    1. If you are upgrading the SAS Formats Library, shut down the Teradata database.
      tpareset -y -x shutdown_comment
      This step is required because an older version of the SAS formats library might be loaded in a currently running SAS query.
      Note: If you are upgrading only the SAS Embedded Process (sepcoretera*.rpm file), you do not need to shut down the database. You do need to shut down the SAS Embedded Process. For more information about how to shut down the SAS Embedded Process, see Controlling the SAS Embedded Process.
    2. Confirm that the database is shut down.
      pdestate -a
      DOWN/HARDSTOP is displayed if the database is shut down.
    3. Remove the old version before you install the updated version of the in-database deployment package.
      • To remove the packages from all nodes concurrently, run this command:
        psh "rpm -e package-name"
        package-name is either accelterafmt-version or sepcoretera-version.
        For example, to remove sepcoretera, run the command psh "rpm -e sepcoretera–9.43000–1".
      • To remove the package from each node, run this command on each node:
        rpm -e package-name
        package-name is either accelterafmt-version or sepcoretera-version.
  5. (Optional) To confirm removal of the package before installing the new package, run this command:
    psh "rpm -q package-name"
    package-name is either accelterafmt-version or sepcoretera-version.
    The SAS Formats Library or the SAS Embedded Process should not appear on any node.
Last updated: February 9, 2017