Differences

This shows you the differences between two versions of the page.

--- quick:login [2026/07/07 11:58]
kevin
+++ quick:login [2026/10/09 14:04] (current)
ccrosby [Process]
@@ Line 28: / Line 28: @@
 This is the process for logging into Lengau for the first time once services have been restored:
-  - Login to the [[https://users.chpc.ac.za/|CHPC User Portal]] using your username and password.
+  - Login to the [[https://users.chpc.ac.za/|CHPC User Portal]] using your username (registered email address) and password.
   - Complete MFA verification using the 6-digit code sent to your email (valid for 2 hours).
   - [[https://users.chpc.ac.za/vpn/|Configure and download]] your unique VPN profile, then connect to the CHPC VPN.
@@ Line 35: / Line 35: @@
   - SSH to Lengau using your CHPC username.  If you have not loaded the keys at the previous step, you will be prompted to do so now at the login prompt.
-The process is demonstrated in [[https://youtu.be/i70Bq72Cw2g|this video]].
+The process is demonstrated in [[https://youtu.be/Fq6xT-KjlQ0|this video]].
 ===== Frequently Asked Questions =====
@@ Line 70: / Line 70: @@
 Access to the DTN node for large file transfers, including large ''pip'' and ''git'' builds, is by application only.  Send your request to be added to the DTN node access group to our Helpdesk.
-The DTN node ''dtn.chpc.ac.za'' is protected by additional two-factor authentication using the Google Authenticator app.  Once your DTN access request is granted please follow the instructions below to set up the authentication:
+The DTN node ''dtn.chpc.ac.za'' is protected by additional two-factor authentication using the [[https://en.wikipedia.org/wiki/Google_Authenticator|Google Authenticator]] app.  Once your DTN access request is granted please follow the instructions below to set up the authentication.
+====1. Install the Google Authenticator app on your phone====
+Open the appropriate application install app for your phone:
+  * Android devices use the Google Play Store [[https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en-GB|link]]
+  * Apple devices use the Apple App Store [[https://apps.apple.com/us/app/google-authenticator/id388497605|link]]
+====2. Add your cluster key to the Authenticator app====
+ssh into the login node ''lengau.chpc.ac.za'' as usual.
+Configure google authenticator for your account by running the command
+  google-authenticator -s ~/.google_authenticator_ssh
+This will ask you several questions.  The first question is
+  Do you want authentication tokens to be time-based (y/n)
+Answer ''y'' for yes and press ENTER.
+A QR code will then be displayed.  Before going any further, you need to scan this QR code using the Authenticator app on your phone:
+  * Open Authenticator on your phone
+  * Tap on the multi-colour **+** button to add a new key
+  * Tap on **Scan a QR code**
+  * Point your phone's camera at the screen making sure the QR code is in the box
+>  Note that the QR code may scroll off the top of the screen.  Enlarge your ssh terminal window or reduce the font size so that the code is fully visible.
+Once the code is accepted and a new key, named **login2:** folowed by your cluster user name, will appear in the Autheticator app list of codes.
+Now continue to answer the ''google-authenticator'' questions on the cluster.
+Important: Answer **y** (and press Enter) to //all// the questions to set up strong security.
+====Connecting to the DTN node====
+Now you can ''ssh'' to the DTN node at ''dtn.chpc.ac.za''.  This connection will use your ssh key (like for ''lengau'') to connect and then you will be prompted for the Authenticator code.  Ensure that you distinguish between the passphrase for your key and the request for the Authenticator code:
+  Verification code:
+Open the Authenticator app on your phone and look for the 6 digits below the **login2:** label.  Type those in and press ENTER.
-  * TBC

wiki.chpc.ac.za

User Tools

Site Tools

Differences

Page Tools