How to rename Bamboo Agent home directory
If you are wondering how to safely rename a Remote Agent's home directory after it has successfully been in service, this is the right place. This is to ensure that the Remote Agent will look for your configuration files in the correct place. If you simply rename the Remote Agent's home directory and start the Agent, it will create a brand new directory and will install the Remote Agent from scratch. It will not use your existing data.
1. Stop Remote Agent
It is very important to stop the Remote Agent before making any changes. If you intend to rename the Remote Agent's home directory, please make sure it is not running before proceeding.
2. Update Remote Agent configuration files
The following files should be manually updated after renaming the Remote Agent's home directory:
There's a parameter named <buildWorkingDirectory> inside this file that will look like this:
Update the path to reflect the directory name change.
There's a java parameter named -Dbamboo.home inside this file:
Update it to reflect the directory name change.