Summary

When installing and configuring a mirror farm, a Bitbucket administrator (admin) may want to configure each node in the mirror farm with a custom name. When first configuring your mirror node, an admin can define the URL and display name. A unique ID will then be automatically generated for each node in the farm. The instructions below will allow the admin to define a custom name for each node.

Environment

Bitbucket Smart Mirror Farm

Solution

To set the name for the node, the process is the same for adding and removing Data Center nodes; you will set a JVM argument:

1. On the mirror node, navigate to the installation path: BITBUCKET_INSTALLATION/bin
2. Open file: _start-webapp.sh
3. Uncomment JVM_SUPPORT_RECOMMENDED_ARGS and add the following argument: -Dcluster.node.name=production-farm1
4. Save and exit file.
5. Restart the application for the change to take effect.

Example:

# Occasionally Atlassian Support may recommend that you set some specific JVM arguments. You can use this
# variable to do that. Simply uncomment the below line and add any required arguments. Note however, if this
# environment variable has been set in the environment of the user running this script, uncommenting the below
# will override that.
JVM_SUPPORT_RECOMMENDED_ARGS="-Dcluster.node.name=production-farm1"