Advanced: Stata & SAS setup
Last updated
Last updated
Redivis supports both Stata and SAS runtimes within notebook environments. However, since Stata and SAS are proprietary software, you will need to provide an appropriate license to enable their use.
Once provided, all members of your organization will be able to leverage the corresponding license when working with your organization's data on Redivis.
In order to enable Stata, you'll need to provide the license "code", "authorization", and "serial number", which should all have been provided as part of purchasing Stata.
You must also provide a licensee "Name" and "School" (which is shown during Stata startup), as well as the appropriate version for the Stata license. The minimum supported Stata version is v17.
Because of how SAS handles cloud deployments, the steps to enable SAS are a bit more complicated than for Stata. In brief, you'll need to complete the following steps:
Run SAS Deployment Wizard to install SAS Studio on a supported Linux 64-bit operating system. During the installation, change the default location for the SAS Studio installation to /usr/local/SASHome.
For details about how to install SAS Studio, refer to the installation and configuration instructions provided by the product.
Create a TAR file that includes the SASHome directory:
Once this tar file has been created, please share it with your Redivis contact to enable SAS for your organization.
Detailed SAS install instructions are provided below:
For the easiest install experience, we recommend using a clean linux VM on a cloud provider in order to perform installation. Make sure the VM has at least 50GB of disk space to properly install SAS and create the final .tar file.
We have encountered some issues when performing the installation within a docker container on M-series (ARM) Macs. If you only have access to an M-series Mac, use docker buildx instead. E.g.:
IMPORTANT: Make sure all system requirements for SAS 9.4 are installed on your system (e.g., numactl). If these dependencies aren't all installed, you will encounter errors later on that will require you to restart install process (and these errors can be a bit cryptic). Consult page 3 of the SAS 9.4 requirements document for full details.
JRE must also be installed: apt install default-jre
Run SAS Deployment Wizard to install SAS Studio on a supported Linux 64-bit operating system. During the installation, change the default location for the SAS Studio installation to /usr/local/SASHome.
If you are provided SAS as a zip file called SAS_94_TS1M7.zip, you would first unzip the file in your home directory:
unzip SAS_94_TS1M7.zip
Change permissions on the new folder so you can complete the setup:
chmod -R 0775 ./SAS_94_TS1M7/
Create the directory where SAS will be installed:
mkdir /usr/local/SASHome
You will also want to change ownership of the location where you will install SAS (i.e. /usr/local ):
sudo chown -R $(whoami) /usr/local/
Change directory to the unzipped folder:
cd SAS_94_TS1M7
If you are provided with the SAS Download Manager as a source file instead (e.g., esdclient__94604__lax__xx__web__1 - 78MB), you would:
Make the file executable, extract it to a folder, and run esdclient.sh to set things like language, order options, software depot options, etc. in order to create the depot and download the software:
While still in the top level directory of the SAS installation package, you can now run the SAS Deployment wizard in the terminal using the -console flag: ./setup.sh -console. You should now see the Deployment wizard start up.
For most configuration steps, you should be able to use the default selection. EXCEPT for the following:
Home location: set to /usr/local/SASHome (if not the default )
Add SAS Studio to the list of products to Install SAS Foundation and related software
Make sure you set the SAS Studio configuration home as: /usr/local/SASHome/sas/studioconfig (if not, it will install by default in the root directory (i.e. /sas/studioconfig), outside of the location where you are installing SAS. This will render the installation unusable when it is time to tar it and load into a Docker image according to the steps below ).
Before the actual installation process starts, you will see a list of all installation steps that will be completed during the set up. After these finish, you will want to make sure that all of these steps were completed Successfully in the installation report - the tail of which is copied below.
If you had any steps marked with E (Completed with errors), you may need to check the log files at /usr/local/SASHome/InstallMisc/InstallLogs/ - you can refer to this SAS Resource for troubleshooting installation issues: https://sas.service-now.com/csm?id=kb_article_view&sysparm_article=KB0036257
There will likely be a lot of log files. Likely of interest are the IT_<date-time>.log and the IT_<date-time>_fileslist.log . For example, if the numactl dependency is missing, you'll see a log similar to
At this point, you'll need to uninstall SAS and start over again.
If there are errors on installation, you can correct the problem noted in the logs and re-run the SAS Deployment Wizard with ~/SAS_94_TS1M7/setup.sh
Run /usr/local/SASHome/SASFoundation/9.4/utilities/bin/setuid.sh as root
Once all steps complete successfully, you can make sure SASStudio works before packaging it up by running the following: /usr/local/SASHome/sas/studioconfig/sasstudio.sh start. If you see that the Spawner and the SAS Web Application Server have both started and have their own process ids, you should be ready to move forward. For good measure, make sure to stop these processes before creating the TAR file: /usr/local/SASHome/sas/studioconfig/sasstudio.sh stop
Note: if you are getting errors at this stage or the Spawner and Application Server are not starting as expected, you should make sure that you have installed all the Linux packages listed in the SAS documentation here in the section titled Docker Checklist: https://documentation.sas.com/doc/en/containers/9.4/n08crk346hlahon17mj16pmdj8t5.htm
For more information on starting and stopping the Spawner and Web Application Server for SAS Studio, please refer to: https://documentation.sas.com/doc/en/webeditorcdc/3.71/webeditorag/p05s6i3m7d256nn1xhochuk7fzgw.htm
For details and troubleshooting about how to install SAS Studio, refer to the installation and configuration instructions provided by the product.
The SAS Studio Basic install and usage guide can be found here: https://documentation.sas.com/doc/en/webeditorcdc/3.71/webeditorag/p0mdm41airrz9on0zn715ett8fxb.htm
In general, it might help to refer to this SAS Resource to troubleshoot installation problems: https://sas.service-now.com/csm?id=kb_article_view&sysparm_article=KB0036257
Create a TAR file that includes the SASHome directory:
tar -cvf SASHome.tar /usr/local/SASHome
Once this tar file has been created, please reach out to your Redivis contact, or contact@redivis.com, to share the file so that we can enable SAS for your account.
To uninstall SAS, run:
