Upgrading from or Reinstalling a Previous Version

Upgrading from or Reinstalling from SAS 9.3

To upgrade or reinstall from SAS 9.3, follow these steps:
  1. Stop the Hadoop SAS Embedded Process using the 9.3 sasep-stop.all. sh script.
    EPInstallDir/SAS/SASTKInDatabaseServerForHadoop/9.35/bin/sasep-stop.all.sh
    EPInstallDir is the master node where you installed the SAS Embedded Process.
  2. Delete the Hadoop SAS Embedded Process from all nodes.
    EPInstallDir/SAS/SASTKInDatabaseServerForHadoop/9.35/bin/sasep-delete.all.sh
  3. Verify that the sas.hadoop.ep.distribution-name.jar files have been deleted.
    The JAR files are located at HadoopHome/lib.
    For Cloudera, the JAR files are typically located here:
    /opt/cloudera/parcels/CDH/lib/hadoop/lib
    For Hortonworks, the JAR files are typically located here:
    /usr/lib/hadoop/lib
  4. Restart the MapReduce service to clear the SAS Hadoop MapReduce JAR files from the cache.
  5. Continue the installation process.

Upgrading from or Reinstalling from SAS 9.4 before the July 2015 Release of SAS 9.4

CAUTION:
If you are using SAS Data Loader, you should remove the QKB and the SAS Data Management Accelerator for Spark from the Hadoop nodes before removing the SAS Embedded Process.
For more information, see Removing the QKB or SASDMP_ADMIN.SH Syntax.
To upgrade or reinstall from a version of SAS 9.4 before the July 2015 release of SAS 9.4, follow these steps:
  1. Stop the Hadoop SAS Embedded Process using the 9.4 sasep-servers.sh -stop script.
    EPInstallDir/SAS/SASTKInDatabaseServerForHadoop/9.*/bin/sasep-servers.sh
       -stop -hostfile host-list-filename | -host <">host-list<">
    EPInstallDir is the master node where you installed the SAS Embedded Process.
    For more information, see the SASEP-SERVERS.SH syntax section of the SAS In-Database Products: Administrator’s Guide that came with your release.
  2. Remove the SAS Embedded Process from all nodes.
    EPInstallDir/SAS/SASTKInDatabaseForServerHadoop/9.*/bin/sasep-servers.sh
       -remove -hostfile host-list-filename | -host <">host-list<">
       -mrhome dir
    Note: This step ensures that all old SAS Hadoop MapReduce JAR files are removed.
    For more information, see the SASEP-SERVERS.SH syntax section of the SAS In-Database Products: Administrator’s Guide that came with your release.
  3. Restart the MapReduce service to clear the SAS Hadoop MapReduce JAR files from the cache.
  4. Verify that all files associated with the SAS Embedded Process have been removed.
    Note: If all the files have not been deleted, then you must manually delete them. Open-source utilities are available that can delete these files across multiple nodes.
    1. Verify that the sas.hadoop.ep.apache*.jar files have been deleted.
      The JAR files are located at HadoopHome/lib.
      For Cloudera, the JAR files are typically located here:
      /opt/cloudera/parcels/CDH/lib/hadoop/lib
      For Hortonworks, the JAR files are typically located here:
      /usr/lib/hadoop/lib
    2. Verify that all the SAS Embedded Process directories and files have been deleted on all nodes except the node from which you ran the sasep-servers.sh -remove script. The sasep-servers.sh -remove script removes the file everywhere except on the node from which you ran the script.
    3. Manually remove the SAS Embedded Process directories and files on the master node (EPInstallDir) from which you ran the script.
      The sasep-servers.sh -remove script removes the file everywhere except on the node from which you ran the script. The sasep-servers.sh -remove script displays instructions that are similar to the following example.
      localhost WARN: Apparently, you are trying to uninstall SAS Embedded Process 
      for Hadoop from the local node.
      The binary files located at 
         local_node/SAS/SASTKInDatabaseServerForHadoop/local_node/
      SAS/SASACCESStoHadoopMapReduceJARFiles will not be removed.
      localhost WARN: The init script will be removed from /etc/init.d and the 
         SAS Map Reduce JAR files will be removed from /usr/lib/hadoop-mapreduce/lib.
      localhost WARN: The binary files located at local_node/SAS 
         should be removed manually.
      
      Tip
      You can use this command to find the location of any instance of the SAS Embedded Process:
      ps -ef | grep depserver
  5. Continue the installation process.

Upgrading from or Reinstalling from the July 2015 Release of SAS 9.4 or Later

CAUTION:
If you are using SAS Data Loader, you should remove the QKB from the Hadoop nodes before removing the SAS Embedded Process.
The QKB is removed by running the QKBPUSH script. For more information, see Removing the QKB.
To upgrade or reinstall from the July 2015 release of SAS 9.4 or later, follow these steps:
  1. Locate the sasep-admin.sh file.
    This file is in the EPInstallDir/sasexe/SASEPHome/bin directory. EPInstallDir is where you installed the SAS Embedded Process.
    One way to find the EPInstallDir directory is to look at the sas.ep.classpath property in the ep-config.xml file. The ep-config.xml file is located on HDFS in the /sas/ep/config/ directory.
    1. Enter this Hadoop command to read the ep-config.xml file on HDFS.
      hadoop fs -cat /sas/ep/config/ep-config.xml
    2. Search for the sas.ep.classpath property.
    3. Copy the directory path.
      The path should be EPInstallDir/sasexe/SASEPHome/ where EPInstallDir is where you installed the SAS Embedded Process.
    4. Navigate to the EPInstallDir/sasexe/SASEPHome/bin directory.
  2. Run sasep-admin.sh -remove script.
    This script removes the SAS Embedded Process from the data nodes.
  3. Run this command to remove the SASEPHome directories from the master node.
    rm -rf SASEPHome
  4. Continue the installation process.