How to create a cloned Confluence instance with a new server ID and application ID
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Test instances will often be cloned from existing production hosts using a snapshot from the host virtual machine. This duplication of the server ID can cause confusion and if there's an existing application link in production with Jira, the duplicated application ID will not allow for trusted application linking in the staging environment. This page shows you how to create a cloned Confluence test instance with a new server ID and application ID for situations where Confluence is configured with an application link to Jira.
Solution
Create virtual machine clones for both Jira and Confluence and restore them to a new host. The cloned instance should use a different application ID. To achieve this, Confluence requires a new server ID and a new keystore entry:
- Shutdown the cloned instance(s)
- Generate a new server ID by installing a fresh, separate Confluence instance of the same version.
- Copy its server ID (shown in setup wizard) and delete the instance.
- Edit the <confluence-cloned-home-directory>/confluence.cfg.xml with the new server ID by updating the confluence.setup.server.id attribute with the copied server ID.
Update the server ID in cloned Confluence instance's database. For example:
UPDATE bandana SET bandanavalue = '<string>ABCD-E1F2-GH3I-JK4L</string>' WHERE bandanakey = 'confluence.server.id'Delete all of the existing rows in the KEYSTORE table:
DELETE FROM keystore WHERE alias LIKE '%confluence%'
For Confluence instances running on versions 8.5.4, 7.19.17, 8.6.2, 8.4.5, 8.7.1 or newer:
- Download the .jar file from CONFSERVER-93646.
- Go over the Workaround section to re-initialize the KEYSTORE table of the cloned instance.
- Proceed with the trusted application configuration in Jira
For older Confluence versions:
- Download and install the script from CONFSERVER-11074.
- Restart the cloned instance
- Run the script from CONFSERVER-11074 to re-initialize the KEYSTORE table. This should result in a new application ID for the cloned instance, found in the KEYSTORE table.
- Proceed with the trusted application configuration in Jira
This will not only create new server IDs, but also new application IDs.