From cb85869e6dd2fb5d3b05e084996936f24e1e12da Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Fri, 17 Feb 2023 19:59:20 +0100
Subject: [PATCH] Remote control BOINC

---
 knowledge base/boinc.md      | 17 +++++++++++++++++
 knowledge base/powershell.md |  3 +++
 knowledge base/windows.md    | 12 ++++++++++++
 3 files changed, 32 insertions(+)

diff --git a/knowledge base/boinc.md b/knowledge base/boinc.md
index c308717..36414be 100644
--- a/knowledge base/boinc.md	
+++ b/knowledge base/boinc.md	
@@ -2,6 +2,7 @@
 
 1. [TL;DR](#tldr)
 2. [Client management](#client-management)
+   1. [Remote management](#remote-management)
 3. [Use the GPU for computation](#use-the-gpu-for-computation)
    1. [On OpenSUSE](#on-opensuse)
 4. [Further readings](#further-readings)
@@ -25,6 +26,22 @@ Name            | Type         | Description
 [boinccmd]      | Command line |
 [boinctui]      | Text         |
 
+### Remote management
+
+Quick, dirty solution: use the `--allow_remote_gui_rpc` option when starting the client.<br/>
+This will make the BOINC client accept connections from **any** host (subject to password authentication) even if the client's configuration files are set otherwise.
+
+Better solution:
+
+1. add the `<allow_remote_gui_rpc>1</allow_remote_gui_rpc>` **option** to the `cc_config.xml` file in the BOINC data directory
+1. restart the service to make the above change effective
+1. check port 31416 (or the one configured for use) is reachable from other hosts
+1. specify a set of allowed hosts creating the `remote_hosts.cfg` file in the BOINC data directory; its entries must be DNS host names or IP addresses, and must be one per line
+
+   > the _Read config file_ action in BOINC Manager's _Advanced_ menu will also read the `remote_hosts.cfg` file, so a restart of the client is not required to enable changes to the remote host list.
+
+1. check the `gui_rpc_auth.cfg` file in the BOINC data directory to get the password for authentication
+
 ## Use the GPU for computation
 
 Also see [AMD Linux drivers] and [Radeon™ Software for Linux® Installation].
diff --git a/knowledge base/powershell.md b/knowledge base/powershell.md
index 20f3a53..c3b3d27 100644
--- a/knowledge base/powershell.md	
+++ b/knowledge base/powershell.md	
@@ -13,6 +13,9 @@ CertUtil -hashfile path/to/file sha256
 # Get super user privileges.
 powershell Start-Process powershell -Verb runAs
 
+# Test a network connection.
+Test-NetConnection -Port 443 -ComputerName 192.168.0.1 -InformationLevel Detailed
+
 # Assign values to variables.
 $variableName = 'value'
 $response = Invoke-WebRequest -Uri 'https://jsonplaceholder.typicode.com/users'
diff --git a/knowledge base/windows.md b/knowledge base/windows.md
index 372c1f5..66a0886 100644
--- a/knowledge base/windows.md	
+++ b/knowledge base/windows.md	
@@ -1,5 +1,17 @@
 # Microsoft windows
 
+## TL;DR
+
+```bat
+Rem Check ports in listening state.
+netstat -an
+```
+
+```ps1
+# Test a network connection.
+Test-NetConnection -Port 443 -ComputerName 192.168.0.1 -InformationLevel Detailed
+```
+
 ## Disable fast startup on Windows 10
 
 1. open the Control Panel