Configuration Properties: How to Configure SAS Studio 5.2 (Basic)

Update SAS Studio Configuration Properties

Note: SAS supplies two versions of SAS Studio, 5.2 (Basic) and 5.2 (Enterprise). SAS Viya programming-only deployments use SAS Studio 5.2 (Basic). For more information, see SAS Studio 5.2 in What’s New in SAS 9.4 and SAS Viya.
Note: You specify SAS Studio 5.2 (Enterprise) properties in the same way as the other SAS Viya applications and services. For more information, see Configuration Properties: How to Configure Services.

To customize web application configuration properties for SAS Studio 5.2 (Basic), edit sasstudio.conf or init_usermods.properties, in the path appropriate for your operating system:

  • Linux:

    /opt/sas/viya/config/etc/sysconfig/sasstudio.conf

    See the example of using sasstudio.conf to make a configuration change:

    export java_global_option_sas_studio_allowdownload="-Dsas.studio.allowDownload=false"

  • Windows:

    \ProgramData\SAS\Viya\etc\sasstudio\default\init_usermods.properties

Note: For sites that use Ansible: Ansible updates init_deployment.properties when it is run. Therefore, SAS Studio configuration changes that you make to init_usermods.properties are not overwritten by Ansible and are carried forward.

For a listing of configuration properties that you can update, see SAS Studio 5.2 (Basic).

Changes take effect after you restart the web application. For more information, see instructions appropriate for your operating system.

TipValues that you specify in the init_usermods.properties file have precedence over corresponding values in other files. Unlike values in other files, values in the init_usermods.properties survive software upgrades.

Set File Navigation Options

For SAS Studio 5.2 (Basic), the root directories that are available in the Explorer section depend on the value for the sas.studio.fileNavigationRoot property.

You can specify a value of USER, SYSTEM, or CUSTOM for the sas.studio.fileNavigationRoot property. The default value is USER.

Note: This property does not control security settings. Users are able to access any files on the SAS Server based on their permission settings.
  • If sas.studio.fileNavigationRoot is set to USER, the Explorer section displays an empty Folder Shortcuts folder and a Files folder.
    • On Windows, the Files folder is mapped to your My Documents folder.
    • On Linux, the Files folder is mapped to your $HOME directory.
  • If sas.studio.fileNavigationRoot is set to SYSTEM, the Explorer section displays the following information:
    • On Windows, the Folder Shortcuts folder includes a predefined shortcut to your My Documents folder.
    • On Linux, the Folder Shortcuts folder includes a predefined shortcut to your home directory. The Files folder is mapped to the system root directory for the server.
  • If sas.studio.fileNavigationRoot is set to CUSTOM, the path displayed in the Explorer section is specified by the value of the sas.studio.fileNavigationCustomRootPath property.
Last updated: May 14, 2025