HUNT Workbench installation
This guide will help you to connect to your HUNT Workbench over a web browser.
Check your onboarding email for Lab access link
We recommend that you follow the tailored guide in Lab access link for setting up Workbench access instead of this generic guide.
1. Before you start
You will need the following to complete this guide:
Requirements
- A working VPN and SSH configuration as described in our Getting started guide.
- A HUNT Workbench TLS certificate as described in the HUNT Workbench certificate request.
Without these it's impossible to complete this guide.
Time
Allow for 30 minutes to complete this installation and some playtime in your new environment.
2. Edit your hosts file
First, let's set up your hosts file on your local computer. This allows you to connect to HUNT Workbench in your lab using a URL name, for example demolab.lab.hdc.ntnu.no
, in your web-browser.
Select steps for your operating system:
3. Install your certificates
Let's install the certificates that is required to allow traffic with your HUNT Workbench that is located in your lab.
4. Open your HUNT Workbench
TIP
Make sure you are connected to the VPN before you access your HUNT Workbench.
Open your web browser (we recommend Google Chrome browser).
Type in the URL address to your lab in your browser.
bash
# -- Principal example
https://<labname>.lab.hdc.ntnu.no
# -- Demo example
https://demolab.lab.hdc.ntnu.no
You may get a User Identification Request
for your new certificate. Verify that the certificates are issued by: (Click Certificate information > Details and look for names given under)
bash
Organization: "HUNT Cloud"
Issued Under: "HUNT Cloud Trust Services"
If given the option, ensure that the Remember this decision
box is checked, and click OK
.
Sign in with your HUNT Cloud lab username and lab passphrase. This is the passphrase that you made on your first login.
With a little bit of luck you should now see your new HUNT Workbench. Click around and explore your new world!
Further reading
See our HUNT Workbench principles section to learn more about your new environment. For more practical advises on how to install your Python/R packages head over to Workbench FAQ.
Immediate troubleshooting
This section includes issues that you might encounter during your first setup. See our HUNT Workbench FAQ and HUNT Workbench Troubleshooting if you do not find your answers below.
This site can't be reached
Read more
If you are getting DNS_PROBE_FINISHED_NXDOMAIN
error you need to repeat the Step 2 of this guide.
On MacOS or Linux you can also assure hosts return IP address using the command below:
text
# -- Principal example
getent hosts <labname>.lab.hdc.ntnu.no
# -- Demo example
getent hosts demolab.lab.hdc.ntnu.no
I don't remember my passphrase
Read more
Don't worry. Request a SSH passphrase rest in our do-science service desk.
Firefox - Did Not Connect
Read more
(We recommend to use Google Chrome as your HUNT Workbench browser.)
Firefox may require that you manually import the HUNT Cloud Certificate Authority
to consider it trusted.
If you see Error code: SEC_ERROR_UNKNOWN_ISSUER
when accessing Workbench follow these steps:
Download our public CA certificate from https://pki.hdc.ntnu.no/hctsca1.crt
Open the following Firefox URL:
about:preferences#privacy
Scroll down to section
Certificates
and click onView Certificates
.Switch to tab
Authorities
and click onImport
.Select
hctsca1.crt
and check optionTrust this CA to identify websites
.
Chrome on Ubuntu
Read more
If you are getting ERR_CERT_AUTHORITY_INVALID
error:
In Google Chrome, open the URL
chrome://settings/certificates
and navigate to sectionAuthorities
Search for HUNT Cloud certificates (
org-HUNT Cloud Trust Services
)Edit the HCTS CA 1 certificate and select first option
Trust this certificate for identifying websites
.
502 Bad gateway
Read more
A 502 Bad gateway
error is an indication that something is wrong with the configuration on the server side. Contact us in your lab channel on Slack or email for further investigations.