SMLP tutorial

README.md

@@ -96,7 +96,11 @@ Starting VNC server within container:
 ```
 ./start_vnc
 ```
-Recommended VNC client: `remmina`
+Recommended VNC client: 
+
+- Ubuntu: `remmina`
+- Windows: RealVNC
+  VNC installation instructions - see [VNC.md](VNC.md)
 
 - Entering Docker container with X11 support on native Linux
 ```

VNC.md

@@ -0,0 +1,52 @@
+## Step 1:
+
+Download [RealVNC®](https://www.realvnc.com/en/connect/download/viewer)
+
+## Step 2:
+
+Install RealVNC
+
+## Step 3: Forward Port 5900 from Windows to WSL2
+
+### Step 3.1 - in WSL2 window
+
+Get your WSL2 IP address from running below command:
+```bash
+hostname -I
+```
+
+### Step 3.2
+
+Open Command Prompt and choose **Run as administrator** option
+
+### Step 3.3 - in Windows Command Prompt Window
+
+Use the **first IP** in the output (e.g., `172.31.26.155`). All the rest should be ignored
+Run the following in **powershell**, replacing `<WSL2_IP>` with your IP:
+
+```powershell
+netsh interface portproxy add v4tov4 listenport=5900 listenaddress=0.0.0.0 connectport=5900 connectaddress=<WSL2_IP>
+```
+
+Allow the port through Windows Firewall:
+```powershell
+New-NetFirewallRule -DisplayName "WSL2 VNC" -Direction Inbound -Protocol TCP -LocalPort 5900 -Action Allow
+```
+
+Verify the proxy is set:
+```powershell
+netsh interface portproxy show all
+```
+
+## Step 4: Connect with VNC 
+
+**Connection should be performed after running** `./start_vnc` **command within Docker container**
+
+1. Launch VNC
+   Signing in VNC is optional
+2. In VNC connect to: `locahost:5900` 
+- Ignore non-secure connection warning
+
+## Updating the Port Proxy After WSL2 Restart
+
+WSL2's IP address may change after restart. In this case, **Step 3** should be repeated after the reboot

docker/python3.11/enter_released_container

@@ -1,10 +1,46 @@
 #!/usr/bin/tcsh -f
+set script_path=`realpath $0 | xargs dirname`
+set script_name=`realpath $0 | xargs basename`
 mkdir -p $HOME/shared
+if($#argv > 0 ) then
+    if("-h" == "$argv[1]" || "--help" == "$argv[1]") then
+        echo "\nUsage: $script_name [-geom <screen_width>x<screen_length>] [<command>]"
+        echo "Example: $script_name -geom 1280x1024\n"
+        exit(0)
+    endif
+endif 
+if($#argv > 1 ) then
+    if("-geom" == "$argv[1]") then
+        set screen_resolution=$argv[2]
+        echo "User defined screen resolution: $screen_resolution"
+        shift; shift 
+    endif
+endif
 if( ! $?TZ ) setenv TZ `readlink /etc/localtime | sed 's@/usr/share/zoneinfo/@@'`
 @ p = 5900
 @ d = 99
 while( `ss -tln | grep -c :${p}` > 0 )
     @ p = $p + 1
     @ d = $d + 1
 end
-docker run -e TZ=$TZ -e DISPLAY=:${d} -p ${p}:${p} -v $HOME/shared:/shared -it mdmitry1/python311-dev:latest $*
+if(! $?screen_resolution ) then
+    if(`uname -r` =~ *WSL2*) then
+        set powershell_exe=`where powershell.exe | awk '{print $1}'`
+        if($powershell_exe =~ *powershell.exe*) then
+            set screen_resolution=`$powershell_exe -ExecutionPolicy Bypass -File ${script_path}/getres.ps1 | tail -1 | sed 's/.$//'`
+        endif
+    else 
+        xset q >& /dev/null
+        if(0 == "$status") then
+            set screen_resolution=`xdpyinfo | grep dimensions | cut -d':' -f2 | awk '{print $1}'`
+        endif
+    endif
+    if($?screen_resolution) then
+        echo "Automatically defined screen resolution: $screen_resolution"
+    endif
+endif
+if(! $?screen_resolution ) then
+    set screen_resolution="1280x1024"
+    echo "Using default screen resolution: $screen_resolution"
+endif
+docker run -e TZ=$TZ -e DISPLAY=:${d} -e VNC_SCREEN_RESOLUTION=$screen_resolution -p ${p}:${p} -v $HOME/shared:/shared -it mdmitry1/python311-dev:latest $*

docker/python3.11/getres.ps1

@@ -0,0 +1,17 @@
+Add-Type -AssemblyName System.Windows.Forms
+$screen = [System.Windows.Forms.Screen]::PrimaryScreen
+$source = @"
+using System;
+using System.Runtime.InteropServices;
+public class DPI {
+    [DllImport("gdi32.dll")]
+    public static extern int GetDeviceCaps(IntPtr hdc, int nIndex);
+    [DllImport("user32.dll")]
+    public static extern IntPtr GetDC(IntPtr hwnd);
+}
+"@
+Add-Type -TypeDefinition $source
+$hdc = [DPI]::GetDC([IntPtr]::Zero)
+$width = [DPI]::GetDeviceCaps($hdc, 118)   # DESKTOPHORZRES
+$height = [DPI]::GetDeviceCaps($hdc, 117)  # DESKTOPVERTRES
+Write-Output "${width}x${height}"

docker/python3.11/start_vnc

@@ -1,9 +1,18 @@
 #!/usr/bin/tcsh -f
-Xvfb $DISPLAY -screen 0 1024x768x16 >& Xvfb.log &
+if($?VNC_SCREEN_RESOLUTION) then
+    set screen_resolution=$VNC_SCREEN_RESOLUTION
+else
+    set screen_resolution=1280x1024
+endif
+Xvfb $DISPLAY -screen 0 ${screen_resolution}x16 >& Xvfb.log &
 sleep 2
 set d=`echo $DISPLAY | tr -d :`
 @ p = $d + 5801
 x11vnc -display $DISPLAY -forever -nopw -shared -rfbport $p >& x11nc.log &
 autocutsel -selection CLIPBOARD -fork
 autocutsel -selection PRIMARY -fork
-xterm -fn 12x24 &
+if(`xset q >& /dev/null ; echo $status` == 0) then
+    echo "VNC server has started successfully with screen resolution $screen_resolution"
+else
+   echo "VNC server failed - GUI won't work"
+endif