Skip to content

Commit c32cadb

Browse files
committed
Make updating installation id a required step for cloned instances
1 parent 3c2bb7d commit c32cadb

File tree

3 files changed

+7
-1
lines changed

3 files changed

+7
-1
lines changed

src/pages/docs/administration/upgrading/guide/creating-test-instance.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,7 @@ Creating a clone of an existing instance involves:
8181
1. Downloading the same version of Octopus Deploy as your main instance.
8282
1. Installing that version on a new server and configuring it to point to the cloned database.
8383
1. Copying all the files from the backed up folders from the source instance.
84+
1. [**Updating the Installation ID**](#update-the-instance-id) on the cloned instance (required).
8485
1. *Optionally*, disabling targets on the cloned instance.
8586
1. Download the latest version of Octopus Deploy.
8687
1. Upgrade the test instance to the latest version of Octopus Deploy.

src/shared-content/upgrade/upgrade-migrating-instances.include.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,11 @@
22

33
It will be possible to run both the old and cloned instances side by side. Both of them can deploy to the same targets (assuming you are not using polling Tentacles). But there are a few items to keep in mind.
44

5-
- The Octopus Server is tightly coupled with Calamari. Deploying to the same target from both servers will result in Calamari getting upgraded/downgraded a lot.
5+
- The Octopus Server is tightly coupled with Calamari. Deploying to the same target from both servers will result in Calamari getting upgraded/downgraded a lot.
66
- The newer Octopus Server will prompt you to upgrade the Tentacles. While running both instances side by side, you will want to avoid this.
77
- Unless the cloned instance has the same domain name, polling Tentacles will not connect to the cloned instance. A clone of the polling Tentacles might need to be created.
88
- The thumbprints for certificates and other sensitive items are stored in the Octopus Deploy database. Cloning the database cloned those values.
9+
- **You must update the Installation ID on the cloned instance.** Cloning copies the Installation ID from the original, which means both instances will report [telemetry](/docs/security/outbound-requests/telemetry) under the same identifier. This corrupts usage data. See [Creating a test instance](/docs/administration/upgrading/guide/creating-test-instance) for the SQL script to generate a new Installation ID.
910

1011
### Considerations
1112

src/shared-content/upgrade/upgrade-update-installation-id.include.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
### Update the Instance ID
22

3+
:::div{.warning}
4+
**You must update the Installation ID after cloning.** Failing to do so means your cloned instance will report telemetry under the same ID as your original instance. This corrupts our usage data and prevents us from accurately understanding how many installations exist. Please do not skip this step.
5+
:::
6+
37
Cloning an instance includes the unique Installation ID of your original instance. This ID is used to identify the instance by a few integrations and sending telemetry reports.
48

59
You can run this SQL Script on your cloned instance database to generate a new unique installation ID.

0 commit comments

Comments
 (0)