Change Settings using CLI (Command Line)
Some settings can be modified using the command line or scripts.
These commands require root user permissions.
Enable/Disable Agents as Helpers
Get Status
Run this on any agent to view if an agent is enabled or disabled to participate as a helper in builds (returns true if enabled, false if disabled).
/opt/incredibuild/management/get_agent_params.py enable-as-helper
Set Status
Run these on any agent to modify enable or disable it's ability to participate as a helper in builds.
sudo /opt/incredibuild/management/set_agent_params.py enable-as-helper
sudo /opt/incredibuild/management/set_agent_params.py disable-as-helper
Change Coordinator
Get Coordinator
To view the Coordinator that a helper is associated with, run this on any agent machine:
/opt/incredibuild/management/get_agent_params.py coordinator
Set Coordinator
To change the Coordinator that a helper is associated with, run this on any agent machine:
sudo /opt/incredibuild/management/set_agent_params.py coordinator <hostname/IP of new Coordinator>
After this is done, you also need unsubscribe the licenses on the original Coordinator and resubscribe them on the new Coordinator.
For example:
sudo /opt/incredibuild/management/set_agent_params.py coordinator 192.168.10.50
Maximum Number of Helper Cores
Get Maximum Number of Local Helpers
To view the maximum number of available local cores required to start a new build, run this command on any agent machine:
/opt/incredibuild/management/get_agent_params.py max-helper-cores
Set Maximum Number of Local Helpers
To change the maximum number of cores that an Agent can use when participating in builds, run this command on any agent machine:
sudo /opt/incredibuild/management/set_agent_params.py max-helper-cores <number>
For example:
sudo /opt/incredibuild/management/set_agent_params.py max-helper-cores 64
Minimum Number of Local Helper Cores
Get Minimum Number of Local Helpers
To view the minimum number of available local cores required to start a new build, run this command on any agent machine:
/opt/incredibuild/management/get_agent_params.py min-local-cores
Set Minimum Number of Local Helpers
To change the minimum number of available local cores required to start a new build, run this command on any agent machine:
sudo /opt/incredibuild/management/set_agent_params.py min-local-cores <number>
For example:
sudo /opt/incredibuild/management/set_agent_params.py min-local-cores 8
Maximum Initiator Cores
Get Maximum Initiator Cores
To view the maximum number of cores that can be used by the agent when acting as the Initiator of a build, run this on any agent:
/opt/incredibuild/management/get_agent_params.py max-initiator-cores
Set Maximum Initiator Cores
To set the maximum number of cores that can be used by the agent when acting as the Initiator of a build, run this on any agent:
sudo /opt/incredibuild/management/set_agent_params.py max-initiator-cores <number of max initiator cores>
For example:
sudo /opt/incredibuild/management/set_agent_params.py max-initiator-cores 16
Build Groups
Get Build Group
To view what Build Group an agent is in, run this on the agent:
/opt/incredibuild/management/get_agent_params.py build-group
Set Build Group
Run this on your Primary Coordinator to assign an agent to a build group. You can use add the --include-offline flag (optional) at the end to implement the assignment even if the agent is offline.
sudo /opt/incredibuild/management/set_build_group.py <agent ip or host name> <group name> --include-offline (optional param)
For example:
sudo /opt/incredibuild/management/set_build_group.py 192.168.10.50 group1 --include-offline (optional param)