Add more images to manual
This commit is contained in:
44
README.md
44
README.md
@@ -37,21 +37,19 @@ Launch graphical server programs locally on a client that execute on the server.
|
|||||||
|
|
||||||
## `sftp`
|
## `sftp`
|
||||||
|
|
||||||
Browse and manage files stored on the server.
|
Browse and manage files stored on the server. Best for Linux.
|
||||||
|
|
||||||
|
* Access the server sftp via most file managers using a `sftp://` address.
|
||||||
|
|
||||||
* Native access to sftp shares using client file manager (`sftp://username@hartmanlab.genetics.uab.edu:/home/username`):
|
|
||||||

|

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

|
||||||
|
* [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)
|
||||||
* [sshfs](https://www.digitalocean.com/community/tutorials/how-to-use-sshfs-to-mount-remote-file-systems-over-ssh)
|
|
||||||
* Windows
|
|
||||||
* [WinSCP](https://winscp.net/eng/index.php)
|
|
||||||
|
|
||||||
## `samba`
|
## `samba`
|
||||||
|
|
||||||
Mount `samba` file shares on any platform as if the server data was on a local drive.
|
Another method to browse and manage files stored on the server. Best for OSX/Windows.
|
||||||
|
|
||||||
The server provides two `samba` shares:
|
The server provides two `samba` shares:
|
||||||
|
|
||||||
@@ -91,31 +89,43 @@ X2Go sessions can be paused or suspended from the X2Go client window. Multiple s
|
|||||||
|
|
||||||
**Note:** Some programs do not continue to run at full speed when an X2Go session is paused. In these cases, the program should be run via `ssh` in a [`tmux`](https://en.wikipedia.org/wiki/Tmux) or [`screen`](https://www.gnu.org/software/screen/) session.
|
**Note:** Some programs do not continue to run at full speed when an X2Go session is paused. In these cases, the program should be run via `ssh` in a [`tmux`](https://en.wikipedia.org/wiki/Tmux) or [`screen`](https://www.gnu.org/software/screen/) session.
|
||||||
|
|
||||||
## Robot computer remote desktop access
|
## ~~Robot computer remote desktop access~~ (*currently unavailable*)
|
||||||
|
|
||||||
In an X2Go session, go to *Applications>Internet>Remote Viewer>Connection>New* and enter [`vnc://192.168.16.101:5900`](vnc://192.168.16.101:5900)
|
In an X2Go session, go to *Applications>Internet>Remote Viewer>Connection Address and enter [`vnc://192.168.16.101`](vnc://192.168.16.101)
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
## Webcam robot monitoring
|
## Webcam robot monitoring
|
||||||
|
|
||||||
* In an X2Go session, via a web browser at [`http://localhost:9999`](http://localhost:9999)
|
* In an X2Go session, via a web browser at [`http://localhost:9999`](http://localhost:9999)
|
||||||
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 9999:localhost:9999 -N`
|
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 9999:localhost:9999 -N`
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
## RStudio Server
|
## RStudio Server
|
||||||
|
|
||||||
* In an X2Go session, via a web browser at [`http://localhost:8787`](http://localhost:8787)
|
* In an X2Go session, via a web browser at [`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`
|
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 8787:localhost:8787 -N`
|
||||||
|
|
||||||
## JupyterLab (Python) IDE
|

|
||||||
|
|
||||||
* In an X2Go session, via a web browser at [`http://localhost:8888`](http://localhost:8888)
|
## Other available software
|
||||||
* Locally via a web browser via an SSH tunnel: `ssh -f username@hartmanlab.genetics.uab.edu -L 8888:localhost:8888 -N`
|
|
||||||
|
* [VSCode](https://code.visualstudio.com/) (IDE)
|
||||||
|
* [MATLAB](https://www.mathworks.com/help/matlab/index.html)
|
||||||
|
* [`qhtcp-workflow`](https://github.com/UAB-Hartman-Lab/qhtcp)
|
||||||
|
* [`podman`](https://podman.io/) (containers)
|
||||||
|
* [`toolbox`](https://docs.fedoraproject.org/en-US/fedora-silverblue/toolbox/) for custom software
|
||||||
|
* [`distrobox`](https://github.com/89luca89/distrobox) for custom environments
|
||||||
|
|
||||||
## Data backup
|
## Data backup
|
||||||
|
|
||||||
[`rsync`](https://linux.die.net/man/1/rsync) is recommended for periodically backing up user files to a local client.
|
[`rsync`](https://linux.die.net/man/1/rsync) is recommended for periodically backing up user files to a local client.
|
||||||
|
|
||||||
* Copy a user's `$HOME`' directory locally to `/home-backup`: `rsync -azH --delete username@hartmanlab.genetics.uab.edu:/home/username/ home-backup/`
|
* Copy a user's `$HOME`' directory locally to `/home-backup` from a client: `rsync -azH --delete username@hartmanlab.genetics.uab.edu:/home/username/ home-backup/`
|
||||||
* Copy a shared directory locally `rsync -azh username@hartmanlab.genetics.uab.edu:/mnt/data/scans/20250723_roessler_project .`
|
* Copy a shared directory locally to the current directory from a client: `rsync -azh username@hartmanlab.genetics.uab.edu:/mnt/data/scans/20250723_roessler_project .`
|
||||||
|
|
||||||
|
There are other tools available for initiating backups *from* the server, including `rsnapshot` and `borgbackup`.
|
||||||
|
|
||||||
## Troubleshooting
|
## Troubleshooting
|
||||||
|
|
||||||
|
|||||||
BIN
docs/imgs/remote_viewer.png
Normal file
BIN
docs/imgs/remote_viewer.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
BIN
docs/imgs/robot_camera.png
Normal file
BIN
docs/imgs/robot_camera.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 834 KiB |
BIN
docs/imgs/rstudio_server.png
Normal file
BIN
docs/imgs/rstudio_server.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 72 KiB |
Reference in New Issue
Block a user