From 2189aeb3063d2f1e310d2e70e72f8de43c1c5822 Mon Sep 17 00:00:00 2001 From: Luke Butters Date: Wed, 11 Nov 2026 13:31:51 +1100 Subject: [PATCH 1/6] Fix Redis connection string link, ports, and admin prompt note in multi-node polling docs --- .../multi-node-polling-tentacles.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md index 7bad2bc449..8f12d62dee 100644 --- a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md +++ b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md @@ -71,12 +71,14 @@ You do not need session affinity. Any node can serve any Tentacle. Configuring a Redis connection string enables multi-node support for Polling Tentacles; removing it disables it. Configure **every node** in the cluster with the same connection string. -The value is a [StackExchange.Redis connection string](https://stackexchange.github.io/StackExchange.Redis/Configuration.html), for example: +The value is a [StackExchange.Redis connection string](https://github.com/StackExchange/StackExchange.Redis/blob/main/docs/Configuration.md), for example: ```text -your-redis-host:6380,password=your-secret-password,ssl=true +your-redis-host:6379,password=your-secret-password ``` +`6379` is the default Redis port, used by the [Redis example above](#running-redis). If your Redis requires TLS, add `ssl=true` and use its TLS port. Many managed Redis services use `6380` for TLS, for example `your-redis-host:6380,password=your-secret-password,ssl=true`. + ### Windows and Linux servers 1. Configure the [cluster shared directory](#cluster-shared-storage) with the [path command](/docs/administration/octopus.server.exe-command-line/path): @@ -108,9 +110,11 @@ your-redis-host:6380,password=your-secret-password,ssl=true For example, to set the Redis connection string using the command line, run the [configure command](/docs/administration/octopus.server.exe-command-line/configure): ```powershell - Octopus.Server.exe configure --instance="OctopusServer" --multiNodePollingTentaclesRedisConnectionString="your-redis-host:6380,password=your-secret-password,ssl=true" + Octopus.Server.exe configure --instance="OctopusServer" --multiNodePollingTentaclesRedisConnectionString="your-redis-host:6379,password=your-secret-password" ``` + On Windows, run this from a command prompt opened with **Run as administrator**. In a normal command prompt, the command fails with `Access to the path '...\OctopusServer.config' is denied`, even if your account is an administrator. + The command checks that the connection string is valid before saving it. The value is treated as sensitive, so it is masked in the command's output. 1. Restart each node. The setting takes effect when Octopus Server starts. 1. [Check the connection to Redis](#check-redis). @@ -162,7 +166,7 @@ octopus: multiNodePollingTentacles: enabled: true redis: - connectionString: "your-redis-host:6380,password=your-secret-password,ssl=true" + connectionString: "your-redis-host:6379,password=your-secret-password" ``` This setting is under `octopus.multiNodePollingTentacles`, not the top-level `redis` key, which only controls the in-cluster Redis. Leave `redis.enabled` set to `false`. If it is `true`, the chart ignores your connection string and uses the in-cluster Redis. @@ -277,7 +281,7 @@ When multi-node support for Polling Tentacles is enabled, Octopus temporarily st ## Troubleshooting **The configure command reports that the Redis connection string is not valid.** -Check the value follows the [StackExchange.Redis connection string format](https://stackexchange.github.io/StackExchange.Redis/Configuration.html). Wrap the whole value in quotes so your shell does not split it on commas. +Check the value follows the [StackExchange.Redis connection string format](https://github.com/StackExchange/StackExchange.Redis/blob/main/docs/Configuration.md). Wrap the whole value in quotes so your shell does not split it on commas. **`IsReachable` is `false`.** Check that the node can reach the Redis host and port through any firewalls, that the password is correct, and that `ssl=true` is set if your Redis requires TLS. From c92e93629b221da2192c498088ca10a89a935feb Mon Sep 17 00:00:00 2001 From: Luke Butters Date: Wed, 11 Nov 2026 13:47:25 +1100 Subject: [PATCH 2/6] Simplify Redis port and TLS guidance --- .../polling-tentacles-with-ha/multi-node-polling-tentacles.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md index 8f12d62dee..b14175772c 100644 --- a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md +++ b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md @@ -77,7 +77,9 @@ The value is a [StackExchange.Redis connection string](https://github.com/StackE your-redis-host:6379,password=your-secret-password ``` -`6379` is the default Redis port, used by the [Redis example above](#running-redis). If your Redis requires TLS, add `ssl=true` and use its TLS port. Many managed Redis services use `6380` for TLS, for example `your-redis-host:6380,password=your-secret-password,ssl=true`. +This example uses the default Redis port, `6379`. If your Redis runs on a different port, change it. + +If your Redis requires TLS, add `ssl=true`. ### Windows and Linux servers From a013e8f69f9882794e9de24434ab9da6369d71f6 Mon Sep 17 00:00:00 2001 From: Luke Butters Date: Wed, 11 Nov 2026 13:48:03 +1100 Subject: [PATCH 3/6] Soften Windows administrator note --- .../polling-tentacles-with-ha/multi-node-polling-tentacles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md index b14175772c..1034370d3a 100644 --- a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md +++ b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md @@ -115,7 +115,7 @@ If your Redis requires TLS, add `ssl=true`. Octopus.Server.exe configure --instance="OctopusServer" --multiNodePollingTentaclesRedisConnectionString="your-redis-host:6379,password=your-secret-password" ``` - On Windows, run this from a command prompt opened with **Run as administrator**. In a normal command prompt, the command fails with `Access to the path '...\OctopusServer.config' is denied`, even if your account is an administrator. + On Windows, this usually needs to be run as an administrator. The command checks that the connection string is valid before saving it. The value is treated as sensitive, so it is masked in the command's output. 1. Restart each node. The setting takes effect when Octopus Server starts. From 3d3e9fbf3673d3c8eb106a1905506293babb8bda Mon Sep 17 00:00:00 2001 From: Luke Butters Date: Wed, 11 Nov 2026 13:49:43 +1100 Subject: [PATCH 4/6] Soften Redis port wording --- .../polling-tentacles-with-ha/multi-node-polling-tentacles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md index 1034370d3a..6050699519 100644 --- a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md +++ b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md @@ -77,7 +77,7 @@ The value is a [StackExchange.Redis connection string](https://github.com/StackE your-redis-host:6379,password=your-secret-password ``` -This example uses the default Redis port, `6379`. If your Redis runs on a different port, change it. +This example uses the default Redis port, `6379`. Change this to the port for your Redis. If your Redis requires TLS, add `ssl=true`. From b9a171eac846f9c7d7f7f23a7075fcc4b3ddc692 Mon Sep 17 00:00:00 2001 From: Luke Butters Date: Wed, 11 Nov 2026 13:51:24 +1100 Subject: [PATCH 5/6] Combine Redis port and TLS guidance --- .../polling-tentacles-with-ha/multi-node-polling-tentacles.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md index 6050699519..efe3398e28 100644 --- a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md +++ b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md @@ -77,9 +77,7 @@ The value is a [StackExchange.Redis connection string](https://github.com/StackE your-redis-host:6379,password=your-secret-password ``` -This example uses the default Redis port, `6379`. Change this to the port for your Redis. - -If your Redis requires TLS, add `ssl=true`. +Replace `6379` with your Redis port if it's different, and add `ssl=true` if your Redis requires TLS. ### Windows and Linux servers From 1d8311d55c74f26c9303ee83316770a21deb5d98 Mon Sep 17 00:00:00 2001 From: Luke Butters Date: Wed, 11 Nov 2026 13:53:12 +1100 Subject: [PATCH 6/6] Split Redis port and TLS guidance --- .../polling-tentacles-with-ha/multi-node-polling-tentacles.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md index efe3398e28..4c71eb8f37 100644 --- a/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md +++ b/src/pages/docs/administration/high-availability/polling-tentacles-with-ha/multi-node-polling-tentacles.md @@ -77,7 +77,9 @@ The value is a [StackExchange.Redis connection string](https://github.com/StackE your-redis-host:6379,password=your-secret-password ``` -Replace `6379` with your Redis port if it's different, and add `ssl=true` if your Redis requires TLS. +This example uses the default Redis port, `6379`. If your Redis uses a different port, use that instead. + +If your Redis requires TLS, add `ssl=true`. ### Windows and Linux servers