Skip to content

Latest commit

 

History

History
79 lines (57 loc) · 3.51 KB

set_user_process_limit.md

File metadata and controls

79 lines (57 loc) · 3.51 KB

Global Enablement & Learning

Set User Process Limit

When: After platform changes

By default, SAS Viya is configured to allow each user to run 10 launched SAS Programming Run-Time (i.e. the sum of SAS Compute, SAS Connect and SAS Batch) sessions/pods at the same time - 10 total across all launched pods. This is intended to prevent users from starting an excessive number of SAS compute servers at the same time, denying access to compute resources to other users.

See Limit a user’s simultaneous compute server processes in SAS Viya 2021.1 and later [Blog] for a detailed explanation.

See your current user process limit:

kubectl describe deploy sas-launcher | grep SAS_LAUNCHER_USER_PROCESS_LIMIT

Example results, showing default values:

SAS_LAUNCHER_USER_PROCESS_LIMIT:                10
SAS_LAUNCHER_USER_PROCESS_LIMIT_ENABLED:        true

As that blog post describes, there are two ways to change the limit. A quick, non-persistant method sets a new value for SAS_LAUNCHER_USER_PROCESS_LIMIT which will not persist if SAS Viya is redeployed, and a slightly more involved method which involves redeploying SAS Viya, but would persist if SAS Viya is redeployed.

Example kubectl command (the first, non-persistant method) to change the user process limit on the fly:

kubectl set env deploy sas-launcher SAS_LAUNCHER_USER_PROCESS_LIMIT=5

You can find instructions for changing your user process limit the second, more persistant way in your deployment directory ($deploy), in the README file at $deploy/sas-bases/examples/sas-launcher/configure/README.md (for Markdown format) or at $deploy/sas-bases/docs/configuration_settings_for_sas_launcher_service.htm (for HTML format).

When possible, the second method is preferable in a production Kubernetes cluster.

Both methods require Kubernetes administrator access (to modify the sas-launcher Kubernetes deployment or to modify the kustomization.yaml file and site-config overlays), and therefore as a SAS Administrator, you may need to work with your Kubernetes administrator to implement and changes you require, if you are not a Kubernetes administrator for the cluster in which SAS Viya is deployed yourself.

There is also a SAS_LAUNCHER_SUPER_USER_PROCESS_LIMIT for members of a SAS Viya custom group named LauncherSuperUsers, which (a little like CASHostAccountRequired) does not exist 'out of the box'. If you create a group of that name, and add users to it, a separate limit applies to those users:

kubectl describe deploy sas-launcher | grep SAS_LAUNCHER_SUPER_USER_PROCESS_LIMIT

Example results, showing default values:

SAS_LAUNCHER_SUPER_USER_PROCESS_LIMIT:          15
SAS_LAUNCHER_SUPER_USER_PROCESS_LIMIT_ENABLED:  true

See the documentation for this feature at:

Back to checklist