faq-remote-X11-beta.md
... ...
@@ -1,4 +1,4 @@
1
-# Persistent Remote X11 connections
1
+# Creating and connecting to persistent remote X11 sessions
2 2
3 3
[X2GO](x2go.org) and [XPRA](xpra.org) can be used to run (and interact with) GUI applications on remote hosts.
4 4
For all systems off of the sbgrid network it will be easiest if you use the [cmcd-vpn](faq-connecting-to-cmcd-vpn).
... ...
@@ -47,32 +47,33 @@ Launch the XPRA gui. Select mode ssh - enter username, host and password info. I
47 47
48 48
To end the session on the remote system either tmux a and Ctrl-c or 'xpra stop'
49 49
50
-### xpra cli - keep it simple (for more experienced XPRA users)
50
+#### xpra cli - keep it simple (for more experienced XPRA users)
51 51
This subsection includes support staff notes is not needed for basic remote work with GUI applications. You need to modify these commands according to your circumstances, *should* you decide to use these commands.
52 52
53 53
On the local Mac OSX system one can open a terminal window and run something like
54
+
54 55
`xpra start ssh/<username>@<remotehost>/42 --start-child=xterm`
55 56
56 57
With this one command you should have a remote xterm window come up. From there you can launch whatever application you need to run on the other system, including applications that need GLX extensions such as coot.
57 58
58
-To disconnect, just ^c from the original terminal window(not the xterm that you connected to), or if you connect from another system it will automatically detach.
59
+To disconnect, just Ctrl-c from the original terminal window (not the xterm that you connected to), or if you connect from another system it will automatically detach.
59 60
60 61
#### Reattach to existing desktop
61 62
62 63
`xpra attach ssh/oconnor@sch-boltzmann/42`
63 64
64
-Note the number 42. You need to pick a number that someone else on the system is not using. Do not use a low number that could be inuse by the system like 0 - 5, instead pick a higher number up to 999.
65
+Note the number 42. You need to pick a number that someone else on the system is not using. Do not use a low number that could be in use by the system, like 0 - 5. Pick a higher number up to 999 instead.
65 66
66
-Note, if you simply close all the windows, including xterm, the remote server is still running
67
-`ssh oconnor@sch-boltzmann`
68
-`xpra list`
67
+Note, if you simply close all the windows, including xterm, the remote server is still running:
68
+<pre><code>$ ssh oconnor@sch-boltzmann
69
+$ xpra list
69 70
Found the following xpra sessions:
70 71
/run/user/46627/xpra:
71 72
LIVE session at :666
72
-`xpra stop :666`
73
-xpra at :666 has exited.
73
+$ xpra stop :666
74
+xpra at :666 has exited.</code></pre>
74 75
75
-Or if you wantesd the session to end when you opened the window -
76
+Or if you wanted the session to end when you opened the window: \
76 77
`xpra start ssh/oconnor@sch-boltzmann/42 --start-child=xterm --window-close=shutdown`
77 78
78 79
For all systems off of the sbgrid network it will be easiest if you use the [cmcd-vpn](faq-connecting-to-cmcd-vpn).
... ...
@@ -85,21 +86,21 @@ Make sure you can ssh to the host without error. You should not need to type 'ye
85 86
86 87
Press enter one time - is it waiting for password input?
87 88
88
-connect to the remote host and type -
89
+connect to the remote host and type:\
89 90
`xpra list`
90 91
91
-If there is an active session you can connect to it via `xpra attach ssh/user@host/42' from your client.
92
+If there is an active session you can connect to it via\ `xpra attach ssh/user@host/42`\ from your client.
92 93
93
-There could be an active session with no windows open. Stop the session and start again.
94
-'xpra stop :42`
94
+There could be an active session with no windows open. Stop the session and start again.\
95
+`xpra stop :42`
95 96
96 97
Try to launch a session from the host in a tmux or screen session on the remote server -
97
-`ssh user@myhost`
98
-`tmux`
99
-`xpra start :617 --daemon=no --start-child=xterm`
98
+<pre><code>$ ssh user@myhost
99
+$ tmux
100
+$ xpra start :617 --daemon=no --start-child=xterm</code></pre>
100 101
You should see a line that that contains `xpra is ready.`
101
-Detach with CTRL-b - d keys and then you can attach from your own system
102
+Detach with CTRL-b - d keys and then you can attach from your own system \
102 103
`xpra attach ssh/oconnor@sch-boltzmann/617`
103 104
104 105
See Also
105
-`man xpra'
106
+`man xpra`