If you are running Linux or a macOS operating system you can access the cluster using the native Secure Shell (SSH) client, you will need to set up SSH tunneling as described below.
Option 1: Automated Configuration
The easiest method to set up SSH connection to is by downloading and running an automated installer. The installer will add SSH configuration entries to ~/.ssh/config and create a private SSH key file inside ~/.ssh. This method works best if you have only one account.
- Download and save the automatic installer script customized for your account:
- Execute this script in a terminal (you may need to adjust the command according to your download location and the downloaded file name):
bash ~/Downloads/setup-devcloud-access-<user>.txt
- Clean up for security:
rm ~/Downloads/setup-devcloud-access-<user>.txt
Connect
After the preparation steps above, you should be able to log in to your login node in the Intel® DevCloud without a password.
ssh devcloud
Upon the first login, you will be asked to add the hostdevcloud to the list of known hosts. Answer "yes":
The authenticity of host 'devcloud' (<no hostip for proxy command>)'can't be established.
ECDSA key fingerprint is SHA256:...
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'devcloud' (ECDSA) to the list of known hosts.
# We are in!
logout
Connection to login-2 closed.
Next time you log in, you will only need to type ssh devcloud to log in:
ssh devcloud
Last login: Tue Jan 3 11:54:11 2017 from 10.5.0.7
Option 2: Manual Configuration
Alternatively, if you do not want a script to modify your SSH configuration, you can proceed with manual installation instructions below.
Direct SSH Connection
- Download and save the SSH access key for Linux/macOS to the folder ~/Downloads/ on your computer
* Sign In to see the download link. - Create the directory ~/.ssh, unless it already exists and move the private SSH key into permanent storage in ~/.ssh:
If you saved your key in a location other than ~/Downloads/, insert the correct path.mkdir -p ~/.ssh mv ~/Downloads/devcloud-access-key-<user>.txt ~/.ssh/
* Sign In to see the value of <user> for your account. - Add the following lines to file ~/.ssh/config (if you do not have this file, simply create one):
Note: if you have multiple accounts on the Intel DevCloud, you can change the hostname devcloud to any other identifier to differentiate between your accounts. This is the hostname that you will use in the ssh and scp commands.Host devcloud User <user> IdentityFile ~/.ssh/devcloud-access-key-<user>.txt ProxyCommand ssh -T -i ~/.ssh/devcloud-access-key-<user>.txt guest@ssh.devcloud.intel.com
* Sign In to see the value of <user> for your account. - Set the correct restrictive permissions on it and on the SSH client config file. To do this, run the following commands in a terminal:
* Sign In to see the value of <user> for your account.chmod 600 ~/.ssh/devcloud-access-key-<user>.txt chmod 600 ~/.ssh/config
Access with VSCode
The following SSH settings are required for Visual Studio Code* remote access.
# DevCloud VSCode config
Host devcloud-vscode
UserKnownHostsFile /dev/null
StrictHostKeyChecking no
Hostname localhost
User <user>
Port 5022
IdentityFile ~/.ssh/devcloud-access-key-<user>.txt
# SSH Tunnel config
Host *.aidevcloud
User <user>
IdentityFile ~/.ssh/devcloud-access-key-<user>.txt
ProxyCommand ssh -T devcloud nc %h %p
LocalForward 5022 localhost:22
LocalForward 5901 localhost:5901
*
Sign In
to see the value of <user> for your account.
If You Are Behind an SSH Proxy
In the interest of security, some business networks require that all outgoing connections are established via a corporate proxy. If you followed the instructions above but are getting the error "Connection timed out", you are likely on such a business network. To comply with the security rules of your company, modify ~/.ssh/config as below:
Host devcloud
User <user>
Port 4022
IdentityFile ~/.ssh/devcloud-access-key-<user>.txt
ProxyCommand ssh -T devcloud-via-proxy
Host devcloud-via-proxy
User guest
Hostname ssh.devcloud.intel.com
IdentityFile ~/.ssh/devcloud-access-key-<user>.txt
LocalForward 4022 c009:22
ProxyCommand nc -x <proxy_name>:<port> %h %p
Here, <proxy_name> and <port> are, respectively, the hostname and port of the corporate proxy. It is usually provided to you by your IT department.
Connect
After the preparation steps above, you should be able to log in to your login node in the Intel® DevCloud without a password.
ssh devcloud
Upon the first login, you will be asked to add the hostdevcloud to the list of known hosts. Answer "yes":
The authenticity of host 'devcloud' (<no hostip for proxy command>)'can't be established.
ECDSA key fingerprint is SHA256:...
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'devcloud' (ECDSA) to the list of known hosts.
# We are in!
logout
Connection to login-2 closed.
Next time you log in, you will only need to type ssh devcloud to log in:
ssh devcloud
Last login: Tue Jan 3 11:54:11 2017 from 10.5.0.7