When creating a SAS® Visual Data Mining and Machine Learning project in SAS® Viya®, Model Studio might display an error:

[CLIENT_CONNECT_ERROR] and [CLIENT_LAUNCH_ERROR] messages might be displayed in the /opt/sas/viya/config/var/log/launcher/default/sas-launcher_*.log file.

One common cause for this behavior is that a defunct SAS Launcher Server context is registered in Consul.  To resolve, follow the steps below on the machine that hosts the Launcher microservice.

1.  Check the list of registered SAS Launcher Server contexts by running this command:

2. For all SAS Launcher Server contexts that are registered in Consul, extract the “serviceID” field.  This field is needed for de-registration.

Example output:

{

"items": [

{

"address": "127.0.0.1",

"node": "sasserver.demo.sas.com",

"serviceAddress": "10.96.14.131",

"serviceEnableTagOverride": false,

"serviceID": "607f3d01-0a4a-4419-a28c-53f5208e0759",

"serviceName": "launcher-server",

"servicePort": 36721,

"serviceTags": [

"tls",

"linux"

],

"taggedAddresses": {

"lan": "127.0.0.1",

"wan": "127.0.0.1"

}

}

 ]

} 

3.  Use the serviceID values from the output to perform the de-registration steps below.  Substitute the correct serviceID for each registered SAS Launcher Server context.

a. Run the following commands to stop the launcher-service.

• sudo /etc/init.d/sas-viya-launcher-default stop
• sudo /etc/init.d/sas-viya-runlauncher-default stop
• export CONSUL_TOKEN=$(sudo cat /opt/sas/viya/config/etc/SASSecurityCertificateFramework/tokens/consul/default/client.token)

b.  Run this command for each registered SAS Launcher Server context.  Substitute the correct serviceID.

• /opt/sas/viya/home/bin/sas-bootstrap-config agent service deregister "607f3d01-0a4a-4419-a28c-53f5208e0759"

c. Run the following commands to start the launcher-service.

• sudo /etc/init.d/sas-viya-launcher-default start
• sudo /etc/init.d/sas-viya-runlauncher-default start

If those steps do not lead you to a resolution, then contact SAS Technical Support.  Send the following items.

• output from executing this command: 
• /opt/sas/viya/home/bin/sas-bootstrap-config --consul https://localhost:8501 catalog service launcher-server
• a screenshot of the error​​​
• /opt/sas/viya/config/var/log/datamining/default/sas-datamining_*.log
• /opt/sas/viya/config/var/log/compute/default/sas-compute_*.log
• /opt/sas/viya/config/var/log/launcher/default/sas-launcher_*.log
• /opt/sas/viya/config/var/log/runlauncher/default/sas-runlauncher_*.log 

Operating System and Release Information