Important! Currently, to use IncrediBuild Cloud you need to contact IncrediBuild Support and receive confirmation for using this solution. If you will not contact Support before you start activating the solution, you will be re-directed to IncrediBuild Contact Us page, where you can send your request:
https://www.incredibuild.com/contact-us.html
Before you start activating IncrediBuild Cloud, you should verify that you have the following:
- IncrediBuild Package – IncrediBuild Cloud is included in all IncrediBuild packages, including the FreeDev package, starting from version 9.4 and up.
- Installed Coordinator – the activation and management of IncrediBuild Cloud is done via the Coordinator Monitor. To verify that you have the Coordinator version that includes IncrediBuild Cloud, perform one of the following:
Note
For using IncrediBuild Cloud, you can install the Coordinator either on an on-premises machine or on a VM on the cloud. If your Initiating machines are located on the cloud, for performance reasons it is recommended to install the Coordinator on the cloud as well. However, this is not a mandatory requirement.
- New users – install IncrediBuild Coordinator, as described in
https://incredibuild.atlassian.net/wiki/spaces/IUM/pages/11796481/Typical+Installation
♦ The current installation file of IncrediBuild Coordinator already includes IncrediBuild Cloud.
- Existing users – if you are not using the latest version, upgrade the Coordinator to the most up-to-date version.
- Existing users – if you are not using the latest version, upgrade the Coordinator to the most up-to-date version.
Note
If you are not using the latest version, a green message appears on your Coordinator Monitor:
To upgrade your Coordinator Monitor, click the message and follow the instructions. For more information on the upgrade process, see Upgrading IncrediBuild.
- Installed Initiator Agent(s) – install one or more Initiator Agents on the machines that will execute tasks. These machine can be either on-premises or on the cloud. You can install additional Initiator Agents after IncrediBuild Cloud is activated and running. To install an Initiator Agent, follow the steps described in:
https://incredibuild.atlassian.net/wiki/spaces/IUM/pages/11796481/Typical+Installation - [Best Practice] Agent Settings – Concurrent PDB file instances – it is recommended to increase the limit of the PDB files belonging to the same project that can be built concurrently, or to cancel this limit entirely. For detailed information, see the following section.
Managing the Limit of Concurrent PDB File Instances
IncrediBuild enables you to limit the number of PDB files belonging to the same project that can be built concurrently. This results in a smaller number of PDB files and an acceleration of link times, but it also limits the potential for parallelization in builds. This means that the number of compilations that can run in parallel for a specific project cannot be more than the number that is specified as a limit. When using IncrediBuild Cloud, it is recommended to increase the specified limit or to remove this limit entirely, in order to fully utilize the cloud resources.
Note: For more information on this Agent setting option, see:
https://incredibuild.atlassian.net/wiki/spaces/IUM/pages/11272227/Visual+Studio+Builds
To increase or cancel the limit of concurrent PDB file instances:
- Open the Agent Settings dialog box.
- Select Visual Studio Builds -> Advanced.
- On the PDB File Allocation section -> Limit concurrent PDB instances to check box, perform one of the following:
- Increase the number of instances that can run concurrently,
- or -
- Clear the check box to remove any limit.
