Step 6. Verify Configuration Files

Launcher configuration issues

You’re unable to access the Workbench home page and/or unable to start new remote sessions in Kubernetes.

Workbench

Return to Troubleshooting index

Symptoms

  • Unable to access the Posit Workbench home page
  • Unable to start new remote sessions in Kubernetes

Error messages

When inspecting the log files for Workbench, Launcher, and Kubernetes, you might see errors similar to the following:

Workbench Home Page
Job information unavailable. Sessions are read-only.
Contact your administrator for help.

Error occurred while executing method (100)
Connection refused

void rstudio::core::http::TcpIpAsyncConnector::handleConnect(const rstudio_boost::system::error_code&, rstudio_boost::asio::ip::basic_resolver<rstudio_boost::asio::ip::tcp>::iterator) /var/lib/jenkins/workspace/IDE/pro-pipeline/v1.2-patch/src/cpp/core/include/core/http/TcpIpAsyncConnector.hpp:197
/var/lib/rstudio-server/monitor/log/rstudio-server.log
04 May 2020 03:36:03 [rserver] ERROR system error 111 (Connection refused); OCCURRED AT: void rstudio::core::http::TcpIpAsyncConnector::handleConnect(const rstudio_boost::system::error_code&, rstudio_boost::asio::ip::basic_resolver<rstudio_boost::asio::ip::tcp>::iterator) /var/lib/jenkins/workspace/IDE/pro-pipeline/v1.2-patch/src/cpp/core/include/core/http/TcpIpAsyncConnector.hpp:197; LOGGED FROM: rstudio::server::job_launcher::{anonymous}::ensureServerUserIsLauncherAdmin()::__lambda7::__lambda10 /var/lib/jenkins/workspace/IDE/pro-pipeline/v1.2-patch/src/cpp/server/ServerJobLauncher.cpp:678

Possible cause

For Workbench, Launcher, and Kubernetes to function properly, the configuration files should contain all of the required configuration values for Workbench, Launcher, the Kubernetes plugin, and communication/mounts for Kubernetes.

The following troubleshooting steps will help you verify that you have created all of the necessary configuration files and input the required configuration values.

Troubleshooting steps

Verify that the following configuration files exist:

  • /etc/rstudio/rserver.conf
  • /etc/rstudio/launcher.conf
  • /etc/rstudio/launcher.kubernetes.profiles.conf
  • /etc/rstudio/launcher.kubernetes.conf
  • /etc/rstudio/launcher-mounts

And verify that their contents match the default values in the documentation for Integrating Workbench with Kubernetes.

A full set of example configuration files is included below for reference. You can compare your configuration files to these examples and make any necessary changes to your configuration.

Example configuration: rserver.conf

File: /etc/rstudio/rserver.conf
# Server Configuration File

www-port=80

# Launcher Config
launcher-address=127.0.0.1
launcher-port=5559
launcher-sessions-enabled=1
launcher-default-cluster=Kubernetes
launcher-sessions-callback-address=http://rstudio-server-pro:yourcompany.com:80
launcher-sessions-container-run-as-root=0
launcher-sessions-create-container-user=1
launcher-sessions-auto-update=1

Example configuration: launcher.conf

File: /etc/rstudio/launcher.conf
[server]
address=127.0.0.1
port=5559
server-user=rstudio-server
admin-group=rstudio-server
authorization-enabled=1
thread-pool-size=4
enable-debug-logging=1

[cluster]
name=Local
type=Local

[cluster]
name=Kubernetes
type=Kubernetes

Example configuration: launcher.kubernetes.profiles.conf

Replace <workbench version> with your desired version of Workbench (including the build number, for example rstudio-workbench-2023.12.1-XXX.proX).

File: /etc/rstudio/launcher.kubernetes.profiles.conf
[*]
default-cpus=1
default-mem-mb=512
max-cpus=2
max-mem-mb=1024
container-images=rstudio/workbench-session:ubuntu2204-r4.4.1_4.3.3-py3.12.6_3.11.10
default-container-image=rstudio/workbench-session:ubuntu2204-r4.4.1_4.3.3-py3.12.6_3.11.10
allow-unknown-images=1

Example configuration: launcher.kubernetes.conf

File: /etc/rstudio/launcher.kubernetes.conf
api-url=https://kubernetes.yourcompany.com
auth-token=ZXm1OEoxpcISQsQdjqknAFND2nwp3RTf.LLxQbig2m9kKIxv0Et2kWUNApxjPSgmbQTmNbFB70lI37bRmmKGUwOHdBLSZcCnyBEipc3YMWgHz21MvFPFyKjf2VzSmr7htbucCqiZREtT7yEZG3fx34jVzg0DHUrCYvaTHV36iydMbQXzCl6Azp3WZxMZ55ogNcCcNN6FkI04RbKUL8Y5urA9F4UO53g2uKGjYi6K0O9NPLq1JHD3IQxNtiGaz2wcflt9aT0ivZYbkN45sjSCoYvVW7cXyD9EGC2JRN7wWDa65DYuTTLYO9t0sD7tv4pRWZims39k5Pwqm4LAZ0FQZ4W07kUaC5GDmjh6uWtjPTDMTs0QUDRVjzAx9jwG7yiw8f4EI9DKIpSxQgIEIWb7xM69I4PzK5v6esn0hoK71oyGIEhn751Ac7nWh09GzSOqHcjhODlYSXT5Tjd0GF95UvL11QLgYUexZBwP56344MnUOKWfQ1HKJvFZsD83DmvZPl8Gks4.8jgl-fwzER_6fsqdN-1tRG2Bm3t9C-E9EA8gooOgKe97KFLS0M2wP-tAldRbLP-gj93pV2bSi_0yE7PL6ccciMmN17N2sUARe96sevsNtzB-hJADlK4C4BSu_nBC2LaDGNCEyp-cq6sImlbaseVpvv9_ErNIanE9ypjf_GP9GrCZqx8tbh1vRwLwP_C3yEfJkqnQs9dOoG2iAT_DKpEZyHLB7XtZusBjWMy1igPS2jqMjdKsdVXSHd6NE6qPCKdmK3TYdrFBRqYMZKAI7OQu7UHt9792HMqeA1lmcr_b8FOkmNsxTU16LwjFFB34x8ZVG2eh9l4KWT5TPbpHYKJUV5
certificate-authority=ne3S1M6u0d0g7d5q0xBbwESF4E1Jre2BP7ZIWVDxkmq86ZfldvfwncwQATqwQmrdC8fs1glzQOjQMtcrg8963HU27I1yjimlDAXZT74iefBxzXFAF1VuaKuVH4KsRahPfq82ijliMrnB1PqBfzhJ4wSS4y4NFiEybDOE17H8t1066duwB7a12AtLaa7MklD8P0VIyXatntdHBYuqraSih2R4EbjrCFKgvEPBYN34dR3QzUa4KFnnztSdXoLPtw7Lnhu8zaGqdiYjrAvTKmFhKQHZGwd17FQ6aMpVxq4wwRc3NeW1WEwBwErj91WO89Lmb3ILUmnFPAgOdNd7nO8sNtWJpKvMXRBoeMLMW1SOE8wA83UjgUddsKzSGYMXPtxTpv7FPVUbz61YJTrP7MUmUihY3m2yXOg24cGOshXW1rd2Jf7Z5CI0MGggip3nF6C0YktU6bzc7bsPw0UHsyiVRGIQwhkarJX39JwHQw9dTbQD8GtfaW21uoNgKF9aEkK8rNcc5VXOqBrXHDfkq2KPZs06Yn5abzH5lsSQTxYAS5fw29lwGRZoluqDHOKuzbFn1L90PQJvJWACjFA5pFSvAVtHfPrsRUtCGZX5KxVDDZkIpnJwMRkLBF6oR4wRb5XeMPynw2tPmHZxkEtZ495iaT4btNBTjlsr7RTjdn1t5o9mfTvteGbuUtABAcDTaFqo0OtXWk0RRqFSLd6m3oYLCLEYMMAXjpTz4Ygrbayc9WyVH6G2B1T5XzjSYY1WpMnBMGzp9Tdy1cX7gzwYaxgcRKgcDsisf5PhU4o0XUqEsQNIXvydHFsv3Jcm2sb5hmH7Q249lkakAGeR80iACsPMvNvJoGXTpFZBq2LNstmbHuDW3sWBYD9f7wGahiP41xD6hbsStXjT3HlAxraRjqAlu3DF8W7wzlHpOYQORHHM5NyyqcehVyPj5LjVPWlfpCza1HJeXlukbazxCESSH7rt0tbYLbttUcwAxzEdwRoEBFzEWwTCr4Hd84YaBcd6L6lhzY3R9pQxx9JKOK6tjGWdKjb4ySh4LkkXAjhAwf4LLjRbGP6oOzZe2OCPtZ0KWAmej4D8nn9Ku8U7YPi7iBjocFvIoCdacznPVhPXqtIFrsCFnpXVdgstk7dIAVlfyWMIjLNvd0f8fdjelvJoEZ0AqcCCfUVPQ3AZjhxu1fXfxSWlgPBstDke7Rf9dljEPhcywSzy24rIzrSBVLHtpd2UoMIKWuqH5aE2Iww5TNJrfa9z7wGI9heHO19cZsZCw0LvS1Qty0H2BdS8Jj8f2m5brjhn2vIiueLitjQifsNo1CrIRHlpz4EoMgjr4717l33Qe5UK4csDSHX6r6iZDaG9t2Fk3mrv3vimH5jfesvbFq6S59KDLh724QmhppoR84Gc6nn3WStIJTi3hLFXNUcTl7SHwjSdfYVENoQcJJfLNTsjFgtqneiIVMoFaB5RPl5aNigiYaZ4GuE5wdIpYHMkxSpglVfTfedoHhFx2VyPpbluYk0MBYSvSv3Ug9WdnUsEzOCn74tu0Wd9tMYExWKwF13bBdhSLULLOhJnmfTRt9tAc4SQ2Qjz2tO18qO2tXlmEhEXD2aHAUR4QRvSk73qDwRX70IUH2pZoB58j92XZUx0VJiPEYlcFH7yMJG==

Example configuration: launcher-mounts

File: /etc/rstudio/launcher-mounts
# Required home directory mount for RSP, Launcher, and Kubernetes
Host: 172.31.0.123
Path: /home/{USER}
MountPath: /home/{USER}
ReadOnly: false
Cluster: Kubernetes

Restart services and test

After updating your configuration files, restart the Workbench and Launcher services:

$ sudo rstudio-server restart
$ sudo rstudio-launcher restart

Verify that the services are running and try to start a new session from the Workbench home page.

If the services are still not starting or you are still experiencing errors when starting a new session, then proceed to
Step 7 - Skip Certificate Verification.

Back to top