New features in SAS Viya 3.5 enable you to force user names into lowercase when you launch host processes for users' CAS and compute sessions. This feature is useful when the CAS and compute Linux hosts resolve user names only with lowercase. But the SAS Viya Identities microservice retrieves uppercase or mixed-case user names from the Lightweight Directory Access Protocol (LDAP) server or System for Cross-domain Identity Management (SCIM) client, resulting in a discrepancy between the user names and failures to start compute and CAS sessions.

Click the Hot Fix tab in this note for a link to instructions about accessing and applying the software update.

After you apply the hot fix, you must have the following settings in place to activate the new lowercase feature.

To enable the lowercase feature in the Launcher and Object Spawner compute services:

1. Use the sas-bootstrap-config tool with the commands below to write a new key/value entry:
   $ source /opt/sas/viya/config/consul.conf
   
   $ export CONSUL_HTTP_TOKEN=$(sudo cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token)
   
   $ /opt/sas/viya/home/bin/sas-bootstrap-config kv write --key config/launcher-server/global/environment/SASUSERFORCELOWER --value 1
2. Restart sas-viya-runlauncher-default and sas-viya-spawner-default (or sas-tenant-runlauncher-default and sas-tenant-spawner-default) to make the setting effective.

To enable the lowercase feature in CAS:

1. On the CAS controller, set the following CAS environment variable in the cas_usermods.settings file that resides in /opt/sas/viya/config/etc/cas/default/ (or in /opt/sas/tenant/config/etc/cas/default/ for a tenant CAS server):
   export CASUSERFORCELOWER=1
2. Restart sas-viya-cascontroller-default (or sas-tenant-cascontroller-default) to make the setting effective.

Operating System and Release Information

Viya on Linux: An update for this issue is available for SAS Viya 3.5. For instructions on how to access and apply software updates, see the Updating Your SAS Viya software section in the SAS Viya 3.5 for Linux Deployment Guide at