SAS on Domino

​

SAS Analytics Pro

1. When you receive your license from SAS, you’ll receive a credential token to access the SAS container repository. Use the token to pull the base image for SAS Analytics Pro onto your local machine.
2. Use a Dockerfile, provided by your Domino representative, to build a Domino-compatible image.
3. Include your SAS license file, license.jwt, in the same location as the Dockerfile when building the Docker image. The license file will be copied into the container and the SAS license utility will run to license the software.
4. Push your newly created Docker image to a repository that your Domino deployment can access. This may be a repository hosted by your organization or a private repository within the Domino cluster.
5. Once you have created the Docker image, create a new Domino Environment using the custom image path.
6. Add the pluggable properties provided by your Domino representative, and make sure the “start:” parameter points to the start script created in the Dockerfile /opt/domino/workspaces/sas/start.
7. After building the Environment in Domino, you will be able to select it in the Workspace launch menu when starting a new Workspace in your Project.

​

SAS Analytics for containers on Domino

1. Get your SAS license.
2. Create a TAR file of SAS Studio.
3. Create a Docker image that includes:
   1. SAS Studio TAR file.
   2. Dockerfile with instructions to build the Docker image.
   3. Start script provided by Domino.
4. Use the Docker image to create pluggable Workspaces in Domino.
5. Optional: Persist SAS preferences and add-ons.

​

Get your SAS license

1. Go to my.sas.com to download the license file.
2. Save the license file securely, you will use the license file to build the SAS Docker image later.

​

Create the SAS Studio TAR file

1. Run the SAS Deployment Wizard to install SAS Studio on a Linux machine with the same version and distribution as the Domino Compute Environment that you want to run the SAS container on.
2. During the installation, change the default location for the SAS Studio installation to /usr/local/SASHome.
3. Manually create a TAR file of SAS Studio that includes the SASHome directory.
   tar — cvf SASHomeTar.tar /usr/local/SASHome
   

​

Create the Dockerfile instructions

RUN apply-license <url_to_license_file>

ENV SAS_LICENSE=”UgbWFnbmEgYWx...pcXVhLgo=”

RUN apply-license $SAS_LICENSE

apply-license /mnt/my-sas-license.jwt

​

Create a start script

#!/usr/bin/env bash
set -o errexit -o pipefail

# Update SAS Settings to start in Domino Project directory
sed -i "s#webdms.customPathRoot=#webdms.customPathRoot=$DOMINO_WORKING_DIR#g"
    /usr/local/SASHome/SASStudioBasic/3.8/war/config/config.properties

# Set the prefix path to the SAS web service
PREFIX_PATH="${DOMINO_PROJECT_OWNER}/${DOMINO_PROJECT_NAME}/notebookSession/${DOMINO_RUN_ID}"
PREFIX_FILE="${DOMINO_PROJECT_OWNER}#${DOMINO_PROJECT_NAME}#notebookSession#${DOMINO_RUN_ID}"
sed -i "s#path="/SASStudio"#path="/${PREFIX_PATH}"#g" /usr/local/SASHome/sas/appserver/studio/conf/Catalina/localhost/SASStudio.xml
mv /usr/local/SASHome/sas/appserver/studio/conf/Catalina/localhost/SASStudio.xml
   "/usr/local/SASHome/sas/appserver/studio/conf/Catalina/localhost/${PREFIX_FILE}#SASStudio.xml"

# Start SAS Studio and keep the container alive while it runs
sudo -E bash -c "/usr/local/SASHome/sas/sasstudio.sh start && while true ; do :; sleep 60 ; done"

​

Create the Docker image

• SAS Studio TAR file
• Domino-provided start script
• Dockerfile with instructions

​

Enable SAS Workspace with pluggable Workspace properties

sas:
    title: "SAS"
    iconUrl: "https://upload.wikimedia.org/wikipedia/commons/1/10/SAS_logo_horiz.svg"
    start: [ "/opt/domino/workspaces/sas/start" ]
    httpProxy:
        internalPath: "/{{ownerUsername}}/{{projectName}}/{{sessionPathComponent}}/{{runId}}/SASStudio/"
        port: 8888
        rewrite: false
        requireSubdomain: false

​

Optional: Persist SAS preferences and add-ons

1. Add the following lines in the Pre Run Script.
   # Copy preferences to Workspace
   PREFS_DIR="$DOMINO_WORKING_DIR/.sasstudio5"
   mkdir -p $PREFS_DIR
   rsync -rpq $PREFS_DIR $HOME
   
2. Add the following lines in the Post Run Script.
   # Copy preferences from Workspace
   PREFS_DIR="$HOME/.sasstudio5"
   mkdir -p $PREFS_DIR
   rsync -rpq $PREFS_DIR $DOMINO_WORKING_DIR
   
   These scripts save add-ons per Project, so collaborators launching a Workspace in the same Project will have the same add-ons. However, the scripts save preferences per user in the Project so that each user can have a different set of preferences.

​

SAS Data Science Programming 3.5

1. Build the SAS Data Science Programming 3.5 container using the SAS container recipes repository. The Dockerfile expects a centos7 base image with the SAS 3.5 components installed (CAS, SAS Studio, Base SAS, etc.).
2. The SAS license file, license.jwt, will need to be in the same location as the Dockerfile when building the Docker image. The license file will be copied into the container and the SAS license utility will run to license the software.
3. Push your newly created Docker image to a repository that your Domino deployment can access. This may be a repository hosted by your organization or a private repository within the Domino cluster.
4. Once you have created the Docker image, create a new Domino Environment using the custom image path.
5. Add the pluggable properties provided by your Domino representative, and make sure the “start:” parameter points to the start script created in the Dockerfile /opt/domino/workspaces/sas/start.
6. After building the Environment in Domino, you will be able to select it in the Workspace launch menu when starting a new Workspace in your Project.

​

Next steps