Skip to content

Commit 1acb722

Browse files
Cortex-DMSDonna-Marie Smith
andauthored
Feature/24000 add load balancer to encryption details (#179)
* Added Load Balancer to encryption details --------- Co-authored-by: Donna-Marie Smith <[email protected]>
1 parent a654e8b commit 1acb722

File tree

4 files changed

+68
-3
lines changed

4 files changed

+68
-3
lines changed
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: "Prerequisites"
3+
linkTitle: "Prerequisites"
4+
description: "Information about the prerequisites required before starting the upgrade."
5+
weight: 10
6+
---
7+
8+
# {{< param title >}}
9+
10+
The prerequisites required to be considered before starting the upgrade.
11+
12+
## Encryption Requirements
13+
14+
{{% alert title="Note" %}}This step is only required if the load balancer installed is the load balancer that is included with the {{% ctx %}} software.{{% /alert %}}
15+
16+
### Retrieve Existing Encryption Key
17+
18+
On one of the Application Servers:
19+
20+
1. On the Start menu, choose `Run`.
21+
1. In the open box, enter `regedit.exe`. You must have administrative credentials to run regedit.exe.
22+
1. In the Registry Editor, locate the registry value `Key` which can be found at the following location `HKEY_LOCAL_MACHINE\SOFTWARE\Innovise\Cerberus`.
23+
1. Copy the value of `Key` and save it to a known location.
24+
25+
### Add Encryption Key to Load Balancer Server
26+
27+
On the Load Balancer Server:
28+
29+
1. On the Start menu, choose `Run`.
30+
1. In the open box, enter `regedit.exe`. You must have administrative credentials to run regedit.exe.
31+
1. In the Registry Editor, navigate through the subkeys to `HKEY_LOCAL_MACHINE\SOFTWARE\Innovise\Cerberus`.
32+
33+
If any of the subkeys do not exist create them, repeating for each subsequent subkey:
34+
35+
1. Right click on the parent subkey.
36+
1. Select `New`.
37+
1. Select `Key`.
38+
1. Set the name to be the subkey that you are creating e.g. `Innovise`.
39+
40+
1. Under the `Cerberus` subkey locate the registry value `Key`.
41+
42+
If the registry value does not exist create it:
43+
44+
* Right click in the right window.
45+
* Select `New`.
46+
* Select `String`.
47+
* Set the name to be `Key`.
48+
49+
1. Set the value of `Key` to be the value copied from the Application Server in Step 4 of [Retrieve Existing Encryption Key][]:
50+
51+
1. Double click on the registry value `Key` to open the Edit dialog.
52+
1. Set the value.
53+
1. Click `OK`.
54+
55+
## Next Steps?
56+
57+
1. [Upgrade Application Servers and Load Balancer][]
58+
59+
[Retrieve Existing Encryption Key]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.RetrieveAppServerEncryptionKey" >}}
60+
[Upgrade Application Servers and Load Balancer]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.UpgradeApplicationAndLoadBalancerServers" >}}

content/en/docs/2024.11/Guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/upgrade-application-and-loadbalancer-servers.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ weight: 30
77

88
# {{< param title >}}
99

10-
This guide describes how to upgrade the Application Servers and Load Balancer Server from 2024.9 to 2024.11.
10+
This guide describes how to upgrade the Application Servers and Load Balancer Server from 2024.9 to 2024.11. Please ensure that the [Prerequisites][] have been completed before starting this upgrade.
1111

1212
## Make Installation Artefacts Available
1313

@@ -76,4 +76,5 @@ To check the previous configuration values open the `Cortex.Upgrade.ApplicationC
7676

7777
1. [Upgrade Web Application Server][]
7878

79+
[Prerequisites]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.Prerequisites" >}}
7980
[Upgrade Web Application Server]: {{< url path="Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA.UpgradeWebApplicationServer" >}}

content/en/docs/2024.11/_shared/prerequisites/install-innovation-only/multi-server/encryption-requirements.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@ Choose one of the Application Servers or the Web Application Server, and copy th
1212
cd "C:\Install\Cortex Innovation {{< version >}} - Encryption Key Generator"
1313
```
1414
15-
1. Run the `Cortex.Encryption.KeyGeneration.exe` application using the following command, modifying the argument value to contain the NETBIOS names or fully qualified domain names of the Application Servers and Web Application Server:
15+
1. Run the `Cortex.Encryption.KeyGeneration.exe` application using the following command, modifying the argument value to contain the NETBIOS names or fully qualified domain names of the Application Servers, Load Balancer Server (if using the included load balancer) and Web Application Server:
1616
1717
```powershell
18-
.\Cortex.Encryption.KeyGeneration.exe "app-server1, app-server2, app-server3, webapp-server"
18+
.\Cortex.Encryption.KeyGeneration.exe "app-server1, app-server2, app-server3, lb-server, webapp-server"
1919
```
2020
2121
1. A message similar to the following will indicate that the application has completed successfully:
@@ -27,6 +27,8 @@ Choose one of the Application Servers or the Web Application Server, and copy th
2727
Encryption key set on app-server2
2828
app-server3: Overwritten Encryption key: EE19EB67F6C2D9E9A5AF6F0CE7822A44
2929
Encryption key set on app-server3
30+
lb-server: Overwritten Encryption key: EE19EB67F6C2D9E9A5AF6F0CE7822A44
31+
Encryption key set on lb-server
3032
webapp-server: Overwritten Encryption key: EE19EB67F6C2D9E9A5AF6F0CE7822A44
3133
Encryption key set on webapp-server
3234
Encryption Key: 284BADF55BDDC93A47D7DE8FC2C4DC9B

data/urls.toml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -569,7 +569,9 @@
569569
UpgradeFlows = "/docs/guides/upgrade-cortex/advanced/upgrade-flows"
570570
[Cortex.Guides.UpgradeCortex.2024.9to2024.11.MultipleServerWithHA]
571571
MainDoc = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/"
572+
Prerequisites = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/prerequisites"
572573
TryItOut = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/try-it-out"
574+
RetrieveAppServerEncryptionKey = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/prerequisites/#retrieve-existing-encryption-key"
573575
UpgradeApplicationAndLoadBalancerServers = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/upgrade-application-and-loadbalancer-servers"
574576
UpgradeDebugger = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/upgrade-web-application-server/upgrade-debugger"
575577
UpgradeGateway = "/docs/guides/upgrade-cortex/2024.9-to-2024.11/multiple-server-with-ha/upgrade-web-application-server/upgrade-gateway"

0 commit comments

Comments
 (0)