- describe how on-premises HA setup looks like
Starting Read-Only Node
A Read-Only node uses the same Data Directory and the same external database as the main TeamCity Server.
So the prerequisite of using the Read-Only node is to ensure that it has access to the main TeamCity Server's aata data directory and to the database.
Also, the Read-Only node requires 'local' data directory in addition to the main data directory. The node stores some caches, unpacked external plugins and some other configuration there.
By default, the 'local' data directory is automatically created under the '<Main Data Directory>/nodes/read_only_node' path during the first start. You can override it's location using '-Dteamcity.node.data.path' property.
To start a Read-Only node alongside with the main TeamCity Server do the following:
- Install TeamCity software as usual: download a distribution package, unpack it or follow the installation wizard.
- Configure the TEAMCITY_DATA_PATH environment variable on the Read-Only node, make sure it points to the shared data directory.
- Add additional arguments to the TEAMCITY_SERVER_OPTS environment variable: