Deploying the SAS Embedded Process Stack on Hortonworks, IBM BigInsights, or Pivotal HD

Deploying the SAS Embedded Process Stack for the First Time

After you run the SAS Deployment Manager to create the SAS Embedded Process stack, you must deploy the stack on the cluster. Follow these steps:
CAUTION:
The SAS Embedded Process must be installed on all nodes that are capable of running a MapReduce task (MapReduce 1) or on all nodes that are capable of running a YARN container (MapReduce 2). The SAS Embedded Process must also be installed on the host node from which you run the script (the Hadoop master NameNode). Hive and HCatalog must be available on all nodes where the SAS Embedded Process is installed.
Otherwise, the SAS Embedded Process does not function properly.
Note: If the SAS Embedded Process stack already exists on your cluster, follow the instructions in Deploying a New Version of the SAS Embedded Process Stack.
Note: If you have licensed and downloaded SAS Data Loader for Hadoop or SAS Contextual Analysis In-Database Scoring for Hadoop, other SAS components are silently deployed at the same time as the SAS Embedded Process for Hadoop. Other configuration is required as noted in step 14. For more information about what components are also deployed, see Overview of the In-Database Deployment Package for Hadoop.
  1. Log on to the machine that is hosting Ambari.
  2. Start the Ambari server and log on.
  3. If the requiretty option was enabled when you deployed the SAS Embedded Process, you must restart the Ambari server at this time. Otherwise, skip to step 3.
    1. Log on to the cluster.
      sudo - su
    2. Restart the Ambari server.
      ambari-server restart
    3. Start the Ambari server and log on.
  4. Click Actions and choose + Add Service.
    The Add Service Wizard page appears.
  5. Select Choose Services.
    The Choose Services panel appears.
  6. In the Choose Services panel, select SASEP. Click Next.
    The Assign Slaves and Clients panel appears.
  7. In the Assign Slaves and Clients panel, select items under Client where you want the stack to be deployed.
    Note: You should always select NAMENODE as one of the clients and NAMENODE should have these two client components installed: HDFS_CLIENT and HCAT_CLIENT.
    The Customize Services panel appears.
    The SASEP stack is listed under activated_version. An example name is s0.1.
  8. Do not change any settings on the Customize Services panel.
    Note: If your cluster is secured with Kerberos, the Configure Identities panel appears. Enter your Kerberos credentials in the admin_principal and admin_password text boxes.
    Click Next. The Review panel appears.
  9. Review the information about the panel. If everything is correct, click Deploy.
    The Install, Start, and Test panel appears. After the SAS Embedded Process stack is installed on all nodes, click Next.
    The Summary panel appears.
  10. Click Complete. The SAS Embedded Process stack is now installed on all nodes of the cluster.
    The SASEP service is displayed on the Ambari dashboard.
  11. Verify that the SAS Embedded Process configuration file, ep-config.xml, exists in the /sas/ep/config directory.
  12. Review any additional configuration that might be needed depending on your Hadoop distribution.
  13. Validate the deployment of the SAS Embedded Process by running a program that uses the SAS Embedded Process and the MapReduce service. An example is a scoring program.
  14. If you have licensed and downloaded the following SAS software, additional configuration is required:
    • SAS Contextual Analysis In-Database Scoring for Hadoop
      For more information, see SAS Contextual Analysis In-Database Scoring for Hadoop: Administrator’s Guide.
    • SAS Data Loader for Hadoop
      For more information, see SAS Data Loader for Hadoop: Installation and Configuration Guide.
    • SAS High-Performance Analytics
      For more information, see SAS High-Performance Analytics Infrastructure: Installation and Configuration Guide.

Deploying a New Version of the SAS Embedded Process Stack

More than one SAS Embedded Process stack can be deployed on your cluster, but only one stack can be activated at one time. After you run the SAS Deployment Manager to create the SAS Embedded Process stack, follow these steps to deploy an additional SAS Embedded Process stack when one already exists on your cluster.
  1. Log on to the machine that is hosting Ambari.
  2. Restart the Ambari server and log on to the Ambari manager.
  3. Select SASEP.
    In the Services panel, a restart symbol appears next to SASEP. The Configs tab indicates that a restart is required.
  4. Click Restart.
  5. Click Restart All.
    After the service is restarted, the previous version of the SAS Embedded Process still appears in the activated_version text box on the Configs tab. All deployed versions of the SAS Embedded Process stack should appear in the sasep_allversions text box.
  6. Refresh the browser.
    The new version of the SAS Embedded Process should now appear as the activated_version text box on the Configs tab.
If, at any time, you want to activate another version of the SAS Embedded Process stack, follow these steps:
  1. Enter the version number in the activated_version text box on the Configs tab.
  2. Click Save.
  3. Add a note describing your action (for example, “Changed from version s01.1 to s01.2”), and click Next.
  4. Click Restart.
  5. Click Restart All.
  6. Refresh Ambari.
    The new service is activated.
  7. Review any additional configuration that might be needed depending on your Hadoop distribution.
  8. Validate the deployment of the SAS Embedded Process by running a program that uses the SAS Embedded Process and the MapReduce service. An example is a scoring program.
  9. If you have licensed and downloaded the following SAS software, additional configuration is required:
    • SAS Contextual Analysis In-Database Scoring for Hadoop
      For more information, see SAS Contextual Analysis In-Database Scoring for Hadoop: Administrator’s Guide.
    • SAS Data Loader for Hadoop
      For more information, see SAS Data Loader for Hadoop: Installation and Configuration Guide.
    • SAS High-Performance Analytics
      For more information, see SAS High-Performance Analytics Infrastructure: Installation and Configuration Guide.
Last updated: February 9, 2017