Compare commits
5 Commits
2a9aaf605f
...
2ebe9ed4aa
| Author | SHA1 | Date | |
|---|---|---|---|
| 2ebe9ed4aa | |||
| 0a59759bda | |||
| ce9e43f245 | |||
| 35d0340997 | |||
| ad574547b9 |
45
README.md
45
README.md
@@ -17,11 +17,14 @@
|
||||
```
|
||||
5. Read the `ssh` login message for server status updates. See [Troubleshooting](#troubleshooting) and [GitHub Resources](#github-resources) for help.
|
||||
|
||||
## `x2goclient` remote desktop
|
||||
## X2Go remote desktop
|
||||
|
||||
Connect to a persistent remote desktop using [`x2goclient`](https://wiki.x2go.org/doku.php/download:start) (Linux/Windows/OSX).
|
||||
|
||||
Sessions can be paused or suspended from the client window. Create multiple sessions with different quality settings for different network conditions.
|
||||
**MacOS/Windows**: UAB security policy requires the latest nightly version of X2Go Client (>=4.1.2.4).
|
||||
* [Windows x2goclient nightly](https://code.x2go.org/releases/binary-win32/x2goclient/heuler/mingw32-4.8/qt-4.8/x2goclient-4.1.2.4-2025.04.09-dec3538-setup.exe)
|
||||
* [MacOS x2goclient nightly](https://code.x2go.org/releases/binary-macosx/x2goclient/nightly/4.1.2.4/x2goclient-4.1.2.4.git20250409.2161.heuler.OSX_10_13.dmg)
|
||||
|
||||
|
||||
### `x2goclient` configuration
|
||||
|
||||
@@ -31,28 +34,33 @@ Sessions can be paused or suspended from the client window. Create multiple sess
|
||||
* Login: *`username`*
|
||||
* SSH port: `22`
|
||||
* Session type: **[MATE](https://mate-desktop.org/)** (provides the best experience with X2Go)
|
||||

|
||||
|
||||

|
||||
|
||||
* **Connection tab**
|
||||
* Set connection speed to **LAN** (on-campus) or **WAN** (off-campus); leave compression as *adaptive*.
|
||||
* It's possible to create multiple sessions with different quality settings for different network conditions.
|
||||
* **Input/output tab**
|
||||
* If automatic resizing fails (common on HiDPI), set a manual startup resolution. For scaling issues, try DPI 96.
|
||||
* For window resizing issues (common on HiDPI displays), set a manual startup resolution. For scaling issues, try DPI 96.
|
||||
* For keyboard mapping issues (e.g., broken arrow keys), select *Configure Keyboard* and keep the defaults.
|
||||
* **Media tab**
|
||||
* Disable sound support to prevent pulseaudio log spam.
|
||||
* Disable sound support to prevent log spam.
|
||||
* **Shared folders tab**
|
||||
* Browse to a folder, add it to the share, and select *automount*. Shared folders appear at `/media/disk/<share_name>`.
|
||||

|
||||
|
||||

|
||||
|
||||
## `ssh` remote login
|
||||
|
||||
Access the server using a text shell.
|
||||
|
||||
* Linux/OSX: **`ssh username@hartmanlab.genetics.uab.edu`**
|
||||
* Windows: [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html)
|
||||
* Android: [JuiceSSH](https://juicessh.com/) or [Termux](https://termux.dev/)
|
||||
|
||||
### `ssh` X forwarding
|
||||
## `ssh` X forwarding
|
||||
|
||||
Run graphical programs on the server with local display output.
|
||||
Run graphical programs on the server locally on a client.
|
||||
|
||||
* Linux/OSX: `ssh -X username@hartmanlab.genetics.uab.edu`
|
||||
* Windows: Install [Xming](http://www.straightrunning.com/XmingNotes/) and enable X11 forwarding in [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) options.
|
||||
@@ -61,18 +69,21 @@ Run graphical programs on the server with local display output.
|
||||
|
||||
## `sftp` remote filesharing
|
||||
|
||||
* File manager (*Caja*): enter `sftp://username@hartmanlab.genetics.uab.edu/home/username` in the URL bar
|
||||
Access files on the server via secure FTP.
|
||||
|
||||
* `caja` (or other graphical file manager)
|
||||
* Enter `sftp://username@hartmanlab.genetics.uab.edu/home/username` in the URL bar.
|
||||

|
||||
* [Filezilla](https://filezilla-project.org/download.php?type=client) (Linux/OSX/Windows)
|
||||
|
||||

|
||||
* [sshfs](https://www.digitalocean.com/community/tutorials/how-to-use-sshfs-to-mount-remote-file-systems-over-ssh) (Linux/OSX/Windows)
|
||||
* [WinSCP](https://winscp.net/eng/index.php) (Windows)
|
||||
|
||||
## `samba` remote filesharing
|
||||
|
||||
The server provides two `samba` shares (credentials: server username/password):
|
||||
Access files on the server via Samba.
|
||||
|
||||
The server provides two `samba` shares (default credentials: server username/password):
|
||||
|
||||
1. Shared data array (`/mnt/data`): `\\username\\data`
|
||||
2. User home directory (`/home/username`): `\\username\\username`
|
||||
@@ -81,28 +92,28 @@ The server provides two `samba` shares (credentials: server username/password):
|
||||
|
||||

|
||||
|
||||
## Robot computer remote desktop
|
||||
## Robot computer remote VNC desktop
|
||||
|
||||
* In X2Go, open *Applications > Internet > Remote Viewer*, enter [`vnc://robot:5900`](vnc://robot:5900) in *Connection Address*, and click Connect.
|
||||
* In an X2Go session, open *Applications>Internet>Remote Viewer*, enter [`vnc://robot:5900`](vnc://robot:5900) in *Connection Address*, and click Connect.
|
||||
|
||||

|
||||
|
||||
## Robot computer remote filesharing
|
||||
## Robot computer remote FTP filesharing
|
||||
|
||||
* In X2Go, open *Applications > System Tools > Caja*, enter [`ftp://robot`](ftp://robot) in the Location bar. Open a second Caja window to drag and drop projects to `/mnt/data`.
|
||||
* In an X2Go session, open *Applications>System Tools>Caja*, enter [`ftp://robot`](ftp://robot) in the Location bar, and hit *Enter*. Open a second Caja window to drag-and-drop or copy-paste projects to the shared data array.
|
||||
|
||||

|
||||
|
||||
## Robot webcam
|
||||
|
||||
* In an X2Go session, via a web browser at [`http://localhost:9999`](http://localhost:9999)
|
||||
* In an X2Go session, open *Applications>Internet>Firefox*, enter [`http://localhost:9999`](http://localhost:9999) in the url bar.
|
||||
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 9999:localhost:9999 -N`
|
||||
|
||||

|
||||
|
||||
## RStudio Server
|
||||
|
||||
* In an X2Go session, via a web browser at [`http://localhost:8787`](http://localhost:8787)
|
||||
* In an X2Go session, open *Applications>Internet>Firefox*, enter [`http://localhost:8787`](http://localhost:8787)
|
||||
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 8787:localhost:8787 -N`
|
||||
|
||||

|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 97 KiB After Width: | Height: | Size: 92 KiB |
Reference in New Issue
Block a user