📔 Update graphical unix server instructions for remote access from Windows to Linux graphical apps.

Author: safizn

.vscode/settings.json

@@ -73,5 +73,77 @@
     "peacock.color": "#000000",
     "editor.codeActionsOnSave": {
         "source.fixAll.eslint": true
+    },
+    "editor.tokenColorCustomizations": {
+        "[Tomorrow Night Bright Operator Mono]": {
+            "textMateRules": [
+                {
+                    "scope": "keyword.control.trycatch.js, keyword.control.import.js, keyword.control.flow.js, meta.import.js, keyword.control.export.js, keyword.control.conditional.js, meta.var.expr.js, meta.block.js, storage.type.js, source.js, storage.modifier.async.js, meta.arrow.js",
+                    "settings": {}
+                },
+                {
+                    "scope": "support.type.js, support.typedef, meta.indexer.declaration.js, support.type.builtin.js",
+                    "settings": {
+                        "fontStyle": "italic",
+                        "foreground": "#ffc0cb"
+                    }
+                },
+                {
+                    "scope": "meta.interface.js, entity.name.type.interface.js, entity.name.type.js, entity.other.inherited-class.js, variable.language.this.js",
+                    "settings": {
+                        "fontStyle": "italic",
+                        "foreground": "#e7c547ff"
+                    }
+                },
+                {
+                    "scope": "support.type.primitive.js, meta.type.annotation.js, keyword.operator.type.annotation.js, meta.object.type.js, meta.type.annotation.js, meta.interface.js",
+                    "settings": {
+                        "fontStyle": "italic",
+                        "foreground": "#ffc0cb"
+                    }
+                },
+                {
+                    "scope": "keyword.operator.type.js",
+                    "settings": {
+                        "fontStyle": "",
+                        "foreground": "#ff76b8"
+                    }
+                },
+                {
+                    "scope": "punctuation.definition.block.js meta.object.type.js meta.type.annotation.js, variable.object.property.js",
+                    "settings": {
+                        "fontStyle": "",
+                        "foreground": "#AD1457"
+                    }
+                },
+                {
+                    "scope": "entity.name, variable.language.this.js",
+                    "settings": {
+                        "fontStyle": "",
+                        "foreground": "#e7c547ff"
+                    }
+                }
+            ]
+        },
+        "textMateRules": [
+            {
+                "scope": "googletest.failed",
+                "settings": {
+                    "foreground": "#f00"
+                }
+            },
+            {
+                "scope": "googletest.passed",
+                "settings": {
+                    "foreground": "#0f0"
+                }
+            },
+            {
+                "scope": "googletest.run",
+                "settings": {
+                    "foreground": "#0f0"
+                }
+            }
+        ]
     }
 }

documentation/systemProvisionGuide/Guide to setting up Windows environment for development.md

@@ -197,6 +197,7 @@ localhost:8083      test.localhost
 - Run docker containers: 
     - run portainer with autostart. (run portainer from @deployment/deploymentScript package.)
 - Turn on WSL2 integration of Docker Desktop.
+    - Solve issue, every now and then the WSL2-Docker integration breaks: Make sure DOCKER_HOST environment is not set, Or reinstall docker or https://github.com/docker/for-win/issues/5096#issuecomment-572730439
 
 ### Winrar:
 - Settings > Integration > Cascaded context menu.
@@ -261,10 +262,18 @@ ___
 - Setup development environment using appDeploymentLifecycle repository powershell script.
     - `yarn run provisionOS` run it through Windows Node's installation, rather than under the newly installed WSL.
         once reached `change default shell` exit the new zsh shell that will be opened to continue installation. Repeat execution if errors occur, and make sure all commands in installations where executed (e.g. powerlevel10K theme in ZSH command group). this command will also update linux `sudo apt update -y && sudo apt upgrade -y`
+    - Make sure the apppDeploymentLifecycle scripts don't mess up some changes made by Docker on WSL2 and VSCode remote server for WSL2. If Issues found try disabling and reenabling docker engine on WSL2 and to trigger reinstallation.
 - Symlink .ssh folder to WSL: `sudo ln -s /<.ssh location>/.ssh /root/.ssh`
 - Setup VSCode in WSL2: ctrl+shift+p and search for "Remote: WSL new window", in which VSCode will download WSL server automatically and set it up.
-- Setup Linux graphical server and Windows client to access WSL2 graphical programs: https://medium.com/@chuckdries/installing-gitkraken-in-wsl-2-15bf6459f823
-    TODO: Install smartGit graphical program in WSL2 and access it through Windows to take advantage of `inotify` support for autorefresh (as not yet supported), and use wsl own git installation.
+    - make sure `code .` or `code-insiders .` works in WSL2 after vscode installed VSCode server in WSL2.
+    - Open extensions tab, and migrate all required extensions to debian side in order to enable them.
+        Note: VSCode will have 2 types of extensions UI, & Workspace (requires direct access to source code of projects) extensions. These are installed automatically by VSCode on the correct side - WSL2 server or Windows VScode client.
+        VS Code's APIs are designed to automatically run in the right location regardless of where your extension happens to be located. 
+- Setup Linux graphical server and Windows client to access WSL2 graphical programs: https://medium.com/@chuckdries/installing-gitkraken-in-wsl-2-15bf6459f823 https://wiki.ubuntu.com/WSL#Running_Graphical_Applications
+    - TODO: [FIX this not working...] Install smartGit graphical program in WSL2 and access it through Windows to take advantage of `inotify` support for autorefresh (as not yet supported), and use wsl own git installation.
+        - (follow steps of above link) Install X server e.g. VcXsrv, symlink configs (from this repo's resource folder), set firewall protocol to allow WSL2 own ip access.
+        - smartgit for linux https://www.syntevo.com/smartgit/download/#installation-instructions
+- Move all repositories to WSL2 filesystem for greater performance.
 
 Notes & Resources: 
 - An attempt to install WSL2 in insiders program (slow ring): 

documentation/systemProvisionGuide/installWindowsSoftware.md

@@ -4,6 +4,7 @@ ___
 
 # Installed Windows software without a pacakge manager:
 Windows Terminal (new) from windows store.
+WSL-DistroManager https://github.com/rkttu/WSL-DistroManager
 
 Memgraph Lab (https://memgraph.com/download/)
 Neo4j Desktop (https://neo4j.com/download-neo4j-now/)
@@ -12,7 +13,6 @@ Simple drag drop graph creation tools:
   - Install https://graphileon.com/
 https://insomnia.rest/ - debug api (similar to postman)
 
-
 webroot internet security (with license)
 VSCode insiders
 whatsapp desktop

resource/localDevelopmentEnvironment/WindowsOS/GUISever/config.xlaunch

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<XLaunch WindowMode="MultiWindow" ClientMode="NoClient" LocalClient="False" Display="-1" LocalProgram="xcalc" RemoteProgram="xterm" RemotePassword="" PrivateKey="" RemoteHost="" RemoteUser="" XDMCPHost="" XDMCPBroadcast="False" XDMCPIndirect="False" Clipboard="True" ClipboardPrimary="True" ExtraParams="" Wgl="True" DisableAC="True" XDMCPTerminate="False"/>

resource/localDevelopmentEnvironment/WindowsOS/contextMenuRegistryScript/Add_Open_PowerShell_window_here_as_administrator_context_menu.regZone.Identifier

@@ -0,0 +1,3 @@
+[ZoneTransfer]
+ZoneId=3
+HostUrl=about:internet

resource/localDevelopmentEnvironment/WindowsOS/contextMenuRegistryScript/Remove_Open_PowerShell_window_here_as_administrator_context_menu.regZone.Identifier

@@ -0,0 +1,3 @@
+[ZoneTransfer]
+ZoneId=3
+HostUrl=about:internet

resource/localDevelopmentEnvironment/WindowsOS/terminal/ConEmu.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <key name="Software">
 	<key name="ConEmu">
-		<key name=".Vanilla" modified="2020-02-02 01:31:05" build="191012">
+		<key name=".Vanilla" modified="2020-02-05 14:18:28" build="191012">
 			<value name="Language" type="string" data="en"/>
 			<value name="StartType" type="hex" data="02"/>
 			<value name="CmdLine" type="string" data=""/>
@@ -147,11 +147,11 @@
 			<value name="Cascaded" type="hex" data="01"/>
 			<value name="IntegralSize" type="hex" data="00"/>
 			<value name="WindowMode" type="dword" data="0000051f"/>
-			<value name="ConWnd X" type="long" data="0"/>
-			<value name="ConWnd Y" type="long" data="60"/>
+			<value name="ConWnd X" type="long" data="659"/>
+			<value name="ConWnd Y" type="long" data="394"/>
 			<value name="LastMonitor" type="string" data="0,60,3840,2160"/>
 			<value name="ConWnd Width" type="dword" data="0000006a"/>
-			<value name="ConWnd Height" type="dword" data="00000035"/>
+			<value name="ConWnd Height" type="dword" data="0000002c"/>
 			<value name="16bit Height" type="ulong" data="0"/>
 			<value name="QuakeStyle" type="hex" data="00"/>
 			<value name="Restore2ActiveMon" type="hex" data="00"/>

script/windows/setupConfiguration.js

@@ -101,6 +101,8 @@ export const symlinkFileConfig = () => {
     //     return path.join(userFolder, 'Desktop', 'DockerWindowsVolumeWatcher')
     //   },
     // },
+
+    // TODO: X-Server configuration symlink GUIServer > 'config.xlaunch'
   ])
 
   copyFile([

script/windowsSubsystemForLinux/installPackageAndSymlinkConfiguration.js

@@ -41,6 +41,7 @@ export const nonElevatedCallback = async () => {
   // install other packages:
   childProcess.execSync(
     [
+      `sudo apt-get install -y wget`,
       // `sudo apt install bridge-utils`,  // DOESN'T WORK on WSL2. `brctl show` allows to view bridge network switches which docker on WSL2 creates.
     ].join(' && \\\n'),
     { cwd: __dirname, shell: true, stdio: [0, 1, 2] },