{"id":4648,"date":"2019-03-11T11:37:50","date_gmt":"2019-03-11T11:37:50","guid":{"rendered":"https:\/\/research.reading.ac.uk\/act\/?post_type=kbe_knowledgebase&p=4648"},"modified":"2022-02-17T17:15:14","modified_gmt":"2022-02-17T17:15:14","slug":"access-to-act-servers-via-an-ssh-client","status":"publish","type":"kbe_knowledgebase","link":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/","title":{"rendered":"Access to ACT Servers via an SSH Client"},"content":{"rendered":"

As well as using our linux desktop service<\/a>, you can also access the ACT servers via any ssh (secure shell) client, as long as you’re either connected to the wired campus network or VPN if you’re outside campus. In the examples below, connecting to the Reading Academic Computing Cluster (RACC)<\/a> via MobaXterm from a Windows PC and via Terminal from a Mac are described as these are the recommended ssh clients used across campus. Connecting via other ssh clients should be analogous.<\/p>\n

 <\/p>\n

What is X forwarding?<\/h3>\n
\n
\n

X is a window system which provides the basic framework for a GUI environment on unix operating systems. This enables drawing and moving windows on the display device and also interacting with a mouse and keyboard in addition to simply typing commands.\u00a0X forwarding refers to executing such a program remotely on the unix server through an ssh connection. The program itself is hosted on a different machine than (the unix server) where the graphical interface is being displayed (your machine).\u00a0X11 refers to the 11th (and final) version of the X Window System, which is also the most common. In general, the terms X11, X, X Windows, and X Window System can be used interchangeably.<\/p>\n

 <\/p>\n<\/div>\n<\/div>\n

Connecting via MobaXterm<\/h3>\n

You can download or run MobaXterm from their website<\/a>. Note that you can also access this link via AppsAnywhere. On the download page you can choose blue to run the executable or green to install MobaXterm on your machine (if you have administrator rights).<\/p>\n

\"\"<\/p>\n

 <\/p>\n

Once you have MobaXterm running, you can click on ‘Start local terminal’ in the middle of the window. This will show you a prompt of your username on the local PC. If you are working on a university owned machine, your username will be your IT username and you can connect as shown in the example below.<\/p>\n

\"\"<\/p>\n

 <\/p>\n

If you are connecting from a personal machine, it’s likely that your username there is different from your IT username. In this case, use the command below and substitute your username.<\/p>\n

ssh -X username@cluster.act.rdg.ac.uk<\/pre>\n
 <\/p>\n
If you experience problems with the display, e.g. a program gives you error messages related to not being able to open your display, a quick way to isolate the source of the issue is to type ‘xterm’ into your RACC shell prompt. This should open a separate X window, such as in the example below.<\/p>\n
\"\"<\/p>\n
 <\/p>\n
If this window doesn’t appear, it means that the X11 forwarding is not working successfully. In this case, try starting a fresh ssh session by restarting MobaXterm. Make sure that the ‘X Server’ icon on the top right is green, such as seen in the picture below.<\/p>\n
\"\"<\/p>\n
 <\/p>\n
It can be toggled on and off by clicking the icon. If the ‘X Server’ icon is green and you still can’t get a working X window, try rebooting your PC first before contacting IT, as long running sessions on Windows have been known to cause issues with X11 forwarding in the past. In the vast majority of cases, the problem is solved by trying one (or all) of the above fixes.<\/p>\n
MobaXterm has many more useful features, such as e.g. sftp sessions for file transfer possibilities. Please refer to the MobaXterm’s own documentation to find out more.<\/p>\n
 <\/p>\n
Connecting via Terminal on a Mac<\/h3>\n
Install XQuartz<\/a> to enable X11 forwarding with the Terminal<\/em> app on a Mac. \u00a0Before using XQuartz for the first time, add the following important security related lines to .ssh\/config in your home directory on the Mac, as described in “act-ssh for Linux and Mac users \u2013 step by step guide<\/a>“.<\/p>\n
ForwardX11Timeout 500h\r\nForwardX11trusted no\r\nForwardX11 yes<\/pre>\n
The third line also avoids the need to use the ‘-X’ option on the ssh command line.\u00a0 If X11 forwarding still doesn’t work, or stops working after a period of time, a MacOS update may have moved the xauth<\/em> utility without the ssh_config<\/em> file being updated. Updating or reinstalling XQuartz usually solves the problem, but if that doesn’t work try the following.<\/p>\n
Find the path of the xauth<\/em> utility using the following command.<\/p>\n
which xauth<\/pre>\n
Find the path to xauth<\/em> specified in \/etc\/ssh\/ssh_config<\/em>, using a command like the following.<\/p>\n
grep xauth \/etc\/ssh\/ssh_config<\/pre>\n
If the xauth<\/em> path in \/etc\/ssh\/ssh_config<\/em> is wrong, edit the file and correct it.<\/p>\n
If the xauth<\/em> path isn’t mentioned in ssh_config<\/em> at all, then xauth<\/em> probably isn’t the cause of your X11 forwarding problems.<\/p>\n
Using the NX Linux managed desktop service<\/a> instead of X11 forwarding is the recommended way to avoid these problems, and usually results in a more responsive user experience.<\/p>\n
The Terminal app is in the Utilities<\/em> folder in Applications<\/em>. When you open it, you’ll see a prompt that shows you your Mac’s name and your Mac username, which is most often not your Reading University username. If this is the case, substitute your own username in the example below.<\/p>\n
\"\"<\/p>\n
If you experience problems with the display, e.g. a program gives you error messages related to not being able to open your display, a quick way to isolate the source of the issue is to type ‘xterm’ into your RACC shell prompt. This should open an X window in XQuartz, such as in the example below.<\/p>\n
\"\"<\/p>\n
If this window doesn’t appear it means that the X11 forwarding is not working successfully. In this case try starting a fresh ssh session. If that doesn’t solve the problem, check if your XQuartz is up to date and possibly reboot your machine first before contacting IT. In the vast majority of cases, the problem is solved by trying one (or all) of the above fixes.<\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
As well as using our linux desktop service, you can also access the ACT servers via any ssh (secure shell) client, as long as you’re either connected to the wired campus network or VPN if you’re outside campus. In the examples below, connecting to the Reading Academic Computing Cluster (RACC) via MobaXterm from a Windows<\/p>\n","protected":false},"author":361,"featured_media":5701,"template":"","meta":{"_acf_changed":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"__cvm_playback_settings":[],"__cvm_video_id":"","_links_to":"","_links_to_target":""},"kbe_taxonomy":[61,81],"kbe_tags":[],"class_list":["post-4648","kbe_knowledgebase","type-kbe_knowledgebase","status-publish","has-post-thumbnail","hentry","kbe_taxonomy-academic-cluster-articles","kbe_taxonomy-related-articles"],"acf":[],"yoast_head":"\nAccess to ACT Servers via an SSH Client - Academic Computing Team<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Access to ACT Servers via an SSH Client - Academic Computing Team\" \/>\n<meta property=\"og:description\" content=\"As well as using our linux desktop service, you can also access the ACT servers via any ssh (secure shell) client, as long as you're either connected to the wired campus network or VPN if you're outside campus. In the examples below, connecting to the Reading Academic Computing Cluster (RACC) via MobaXterm from a Windows\" \/>\n<meta property=\"og:url\" content=\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/\" \/>\n<meta property=\"og:site_name\" content=\"Academic Computing Team\" \/>\n<meta property=\"article:modified_time\" content=\"2022-02-17T17:15:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/research.reading.ac.uk\/act\/wp-content\/uploads\/sites\/2\/Unorganized\/ssh.png\" \/>\n\t<meta property=\"og:image:width\" content=\"256\" \/>\n\t<meta property=\"og:image:height\" content=\"256\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/\",\"url\":\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/\",\"name\":\"Access to ACT Servers via an SSH Client - Academic Computing Team\",\"isPartOf\":{\"@id\":\"https:\/\/research.reading.ac.uk\/act\/#website\"},\"datePublished\":\"2019-03-11T11:37:50+00:00\",\"dateModified\":\"2022-02-17T17:15:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/research.reading.ac.uk\/act\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Knowledgebase\",\"item\":\"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Access to ACT Servers via an SSH Client\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/research.reading.ac.uk\/act\/#website\",\"url\":\"https:\/\/research.reading.ac.uk\/act\/\",\"name\":\"Academic Computing Team\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/research.reading.ac.uk\/act\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/research.reading.ac.uk\/act\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/research.reading.ac.uk\/act\/#organization\",\"name\":\"University of Reading\",\"url\":\"https:\/\/research.reading.ac.uk\/act\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/research.reading.ac.uk\/act\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/research.reading.ac.uk\/act\/wp-content\/uploads\/sites\/2\/2017\/08\/cropped-University_of_Reading_shield-1.png\",\"contentUrl\":\"https:\/\/research.reading.ac.uk\/act\/wp-content\/uploads\/sites\/2\/2017\/08\/cropped-University_of_Reading_shield-1.png\",\"width\":512,\"height\":512,\"caption\":\"University of Reading\"},\"image\":{\"@id\":\"https:\/\/research.reading.ac.uk\/act\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Access to ACT Servers via an SSH Client - Academic Computing Team","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/","og_locale":"en_GB","og_type":"article","og_title":"Access to ACT Servers via an SSH Client - Academic Computing Team","og_description":"As well as using our linux desktop service, you can also access the ACT servers via any ssh (secure shell) client, as long as you're either connected to the wired campus network or VPN if you're outside campus. In the examples below, connecting to the Reading Academic Computing Cluster (RACC) via MobaXterm from a Windows","og_url":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/","og_site_name":"Academic Computing Team","article_modified_time":"2022-02-17T17:15:14+00:00","og_image":[{"width":256,"height":256,"url":"https:\/\/research.reading.ac.uk\/act\/wp-content\/uploads\/sites\/2\/Unorganized\/ssh.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Estimated reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/","url":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/","name":"Access to ACT Servers via an SSH Client - Academic Computing Team","isPartOf":{"@id":"https:\/\/research.reading.ac.uk\/act\/#website"},"datePublished":"2019-03-11T11:37:50+00:00","dateModified":"2022-02-17T17:15:14+00:00","breadcrumb":{"@id":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/access-to-act-servers-via-an-ssh-client\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/research.reading.ac.uk\/act\/"},{"@type":"ListItem","position":2,"name":"Knowledgebase","item":"https:\/\/research.reading.ac.uk\/act\/knowledgebase\/"},{"@type":"ListItem","position":3,"name":"Access to ACT Servers via an SSH Client"}]},{"@type":"WebSite","@id":"https:\/\/research.reading.ac.uk\/act\/#website","url":"https:\/\/research.reading.ac.uk\/act\/","name":"Academic Computing Team","description":"","publisher":{"@id":"https:\/\/research.reading.ac.uk\/act\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/research.reading.ac.uk\/act\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/research.reading.ac.uk\/act\/#organization","name":"University of Reading","url":"https:\/\/research.reading.ac.uk\/act\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/research.reading.ac.uk\/act\/#\/schema\/logo\/image\/","url":"https:\/\/research.reading.ac.uk\/act\/wp-content\/uploads\/sites\/2\/2017\/08\/cropped-University_of_Reading_shield-1.png","contentUrl":"https:\/\/research.reading.ac.uk\/act\/wp-content\/uploads\/sites\/2\/2017\/08\/cropped-University_of_Reading_shield-1.png","width":512,"height":512,"caption":"University of Reading"},"image":{"@id":"https:\/\/research.reading.ac.uk\/act\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/kbe_knowledgebase\/4648","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/kbe_knowledgebase"}],"about":[{"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/types\/kbe_knowledgebase"}],"author":[{"embeddable":true,"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/users\/361"}],"version-history":[{"count":6,"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/kbe_knowledgebase\/4648\/revisions"}],"predecessor-version":[{"id":6123,"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/kbe_knowledgebase\/4648\/revisions\/6123"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/media\/5701"}],"wp:attachment":[{"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/media?parent=4648"}],"wp:term":[{"taxonomy":"kbe_taxonomy","embeddable":true,"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/kbe_taxonomy?post=4648"},{"taxonomy":"kbe_tags","embeddable":true,"href":"https:\/\/research.reading.ac.uk\/act\/wp-json\/wp\/v2\/kbe_tags?post=4648"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}