...
In order to execute your builds using IncrediBuild Linux, you do not need to make any changes to your existing source code or build scripts. All you need to do is to add to your tool execution command the following:
...
To instruct your tool to execute multiple processes in parallel, add a number to the multiprocessing command. For example, if you enter -j 200 for Make, you are instructing Make to execute up to 200 processes in parallel. IncrediBuild will then take hold of the process queue, and distribute the relevant processes across available cores on Agent machines in your network.
Note: Some build tools do not have a specific command option for multiprocessing execution. In this case, you need to make changes to certain configuration files in order to enable the execution of multiple processes in parallel.
For example, to execute a build that is running via Make, enter the following:
ib_console make -j <number_of_processes_to_run_in_parallel>
| Info |
|---|
To execute builds from an Initiator using IncrediBuild Linux, the Initiator must have at least a certain minimum number of available cores. This minimum number is set in the Minimum local cores for build parameter, in the Agent Settings dialog box -> General tab. If the Initiator does not have at least this minimum number when a build is executed from it, the build will fail. The default minimum number is 4 cores, and you can change it if needed in the Agent Settings dialog box. |
> To execute a build using IncrediBuild Linux:
...
In the terminal, go to the directory of the build you want to execute.
In your build directory, enter:
| Code Block | ||
|---|---|---|
| ||
ib_console <your_build_tool_command> <multiprocessing_command> <number_of_processes_to_run_in_parallel > |
Note: To maximize the task parallelization and acceleration, it is best practice to configure a high number of processes for the multiprocessing command, even if you will not use all of them. It is recommended to set the value of -j or any other multiprocessing command to at least double the number of available CPU cores in your IncrediBuild Environment.
Your build is executed with IncrediBuild Linux, and its processes are distributed across the available cores in your IncrediBuild Environment.
...
ib_console make -j 200
...