# Workbench troubleshooting

Unfortunately, sometimes things don't work as intended. Here is a collect of issues you might encounter in your Workbench. Contact us if you are still stuck after reading up.

TIP

See our Workbench FAQ for general questions about Workbench.

# Access

# I am unable to access my Workbench applications?

If you were previously able to access your applications in Workbench (e.g. RStudio), and then the application suddenly stopped working, one quick approach is to try restarting your Workbench environment. Follow the guide to restart Workbench environment. Contact us or reach out in your lab channel on Slack if you do not find answer in FAQ or troubleshooting sections below.

# 504: Gateway Timeout Error

If you get 504 error code while trying to login to Workbench please reach out in your lab channel on Slack or contact us on email. In such cases you will not be able to access Workbench. This does not apply when you are able to open Workbench, but get 504 when trying to access specific applications, in such cases try to go through sections below.

# 403: Forbidden - Expired client certificate

Your Workbench certificate is time limited. You will meet the 403 Forbidden message below when your certificate expire. Head over to the service desk to order a new certificate.

expired_certificate.png

# Has my lab certificate expired?

If you were previously able to access Workbench and now your browser reports expired/unsafe certificates (e.g.: Your connection is not private / ERR_CERT_DATE_INVALID) please reach out in your lab channel on Slack or contact us on email. If the certificate is expired we can usually sign new lab certificates and update the service quickly.

expired_server_cert.png

# RStudio

# 500: Internal Server Error

If you are a fast clicker and get to an app before it's initialized in the background you might get error message:

500: Internal Server Error

Could not start rstudio in time

Try reloading the page (Ctrl + R / CMD + R) to reconnect with RStudio session. Contact us if the error message persists.

# 504: Gateway Timeout Error

The 504 error may be shown when you access /user/<username>/rstudio/, but RStudio fails to start. If you were previously able to access your RStudio in Workbench it is possible that RStudio saved more data in environment files than it is able to load into memory. One potential approach is using Workbench terminal and manually resetting your RStudio settings:

mv "/mnt/work/workbench/${USER}/.local/share/rstudio" "/mnt/work/workbench/${USER}/.local/share/rstudio-$(date +%Y-%m-%d)"

Then restart your Workbench environment. If the error still persists, don't hesitate to reach out in your lab channel on Slack or contact us for further assistance.

# MATLAB

# Error - 'matlab' executable not found in PATH

Access to MATLAB requires the application to be installed and activated in your lab.

If you click on the MATLAB icon and the application is missing you will meet a red error box stating that "matlab executable not found in PATH". Contact your lab coordinator to investigate your licensing options and contact us us with your installation order.

# Icons in user interface disappeared

If MATLAB icons disappeared and application is stuck loading you will need to reset user settings.

Removing user settings can be done in Workbench terminal:

ls /mnt/work/workbench/$USER/.matlab
rm -r /mnt/work/workbench/$USER/.matlab

# Experience

# Unresponsive Workbench

An unresponsive or slow Workbench may be caused by several things. Here's a small checklist to narrow down potential causes:

  • Use Google Chrome as your browser. Other browsers don't support all features and might cause potential silent failures.

  • Restart your Workbench environment to start fresh in the case something got hung up. Click here to see how.

  • Check the resource consumption of your home-machine to ensure that you have available free cpu and memory resources, for example by logging into your lab home-machine and run htop. Consider to upgrade your machine size in Service desk if you are low on free resources.

Contact us for further investigation if none of these works.