Differences

This shows you the differences between two versions of the page.

--- other:x_conf [2022/08/05 10:32] – Moved te Troubleshooting section to the end jypeter
+++ other:x_conf [2022/08/05 15:45] – [Installing VcXsrv] jypeter
@@ Line 40: / Line 40: @@
   * Start the server by double-clicking on the new ''X_Server'' icon
     * It will seem that nothing happens, but an ''X'' icon appears in the right side of the taskbar (you may have to look for it in the //Display hidden icons// pull-up menu). Your computer is now ready to display remote graphics!\\ {{ :other:vcxsrv_x.png?direct |}}
-    * The X server will stop when you close your Windows session or restart the computer. Do not forget to click on the X_Server icon if you know that you will need an X server later
+    * The X server will stop when you close your Windows session or restart the computer. Do not forget to click on the ''X_Server'' icon on your desktop if you know that you will need an X server later
+      * FIXME Document how to automatically start the X server...
     * Note: you can right-click on the ''X'' icon and select ''Exit...'' if you need to quit the X server
-  * You are now **ready**, if you only need VcXsrv to display graphical windows from remote servers
-  * The following steps allow you to test the X server in a **local** WSL+Ubuntu terminal. **Do not set the DISPLAY variable yourself when you are connected to a remote server with ''ssh''!**
-    * Open a **local** terminal (in WSL+Ubuntu)
-    * Type ''export DISPLAY=localhost:0.0''
-    * Type ''xterm'' and check that a new //xterm// terminal appears
@@ Line 67: / Line 62: @@
 ===== Using an X server on an Apple computer =====
+===== Configuration on the remote machine =====
+==== If you are connecting with ssh ====
+Nothing special to do!
+==== If you are using WSL ====
+If you have installed [[other:win10wsl|WSL+Ubuntu]] on your local machine, and you need your X server to display graphics generated in WSL, you need to define the DISPLAY variable: ''export DISPLAY=localhost:0.0''
+===== Testing =====
+The idea is to:
+  * Open a terminal and check that the ''DISPLAY'' environment variable is correctly defined on the local machine
+  * Connect to the remote machine
+  * Check that a (new) ''DISPLAY'' variable is defined on the remote machine
+  * Check that you can start an application using graphics (e.g. ''xterm'') on the remote machine
+==== On a Linux computer ====
+Some basic commands in a terminal
+<code>[Local] $ hostname
+name_of_your_local_machine
+[Local] $ echo $DISPLAY
+:0
+[Local] $ ssh -X some_login@some_remote_server
+[some connection information skipped here]
+[Remote] $ hostname
+name_of_the_remote_server
+[Remote] $ echo $DISPLAY
+localhost:20.0
+[Remote] $ xterm</code>
+==== On a Windows computer with only an X server installed ====
+We just open a ''Powershell'' window (''Start'' => ''Windows Powershell'' => ''Windows Powershell'') and type some basic commands
+<code>PS C:\> $env:computername
+name_of_your_local_machine
+PS C:\> $env:DISPLAY
+PS C:\> $env:DISPLAY="localhost:0"
+PS C:\> $env:DISPLAY
+localhost:0
+PS C:\> ssh -Y some_login@some_remote_server
+Warning: No xauth data; using fake authentication data for X11 forwarding.
+[some connection information skipped here]
+[Remote] $ hostname
+name_of_the_remote_server
+[Remote] $ echo $DISPLAY
+localhost:19.0
+[Remote] $ xterm</code>
+==== On a Windows computer with PuTTY and an X server installed ====
+We assume here that [[other:putty_conf|PuTTY is already installed and configured]]
+We just have to open a pre-configured //Session// on a remote server
+<code>[Remote] $ hostname
+name_of_the_remote_server
+[Remote] $ echo $DISPLAY
+localhost:19.0
+[Remote] $ xterm</code>
+==== On a Windows computer with WSL+Linux and an X server installed ====
+  * FIXME ''export DISPLAY=localhost:0.0''
 ===== Troubleshooting =====
+==== Nothing works! ====
+That's unfortunate, but:
+  * Have you turned on your computer?
+  * Do you have network access, and an account on a remote server?
+  * Have you run the [[other:x_conf#testing|Tests]]?
+  * Have you installed and configured the //X server// correctly? Is it really running?
+  * Have you configured [[other:putty_conf|PuTTY]] and/or other required applications correctly ?
+  * Is the ''DISPLAY'' variable defined correctly on the local and remote computer?
 ==== OpenGL related settings ====