Page Comparison

...

• --cpus [Optional] – the maximum number of CPU cores to be used by the containerized Agent. The default maximum number of cores is 2. If no number is specified, the default number will take effect.
  For example, if you want the Agent to use 8 cores or less, enter: --cpus 8.
  When setting this CPU number, take into consideration the number of CPU cores that the host machine has, how many of these available cores you want to allocate to the container, and whether additional IncrediBuild containers will run on this host machine.

• -e Coordinator= [Mandatory] – the IP address or hostname of the Coordinator that will communicate with the containerized Agent.
  For example, to connect the Agent to a Coordinator whose IP address is 172.0.0.0, enter:
  -e Coordinator=172.0.0.0.  

• -e CoordinatorPort= [Optional] – the Coordinator port number for the communication with the Agent. By default, the Coordinator port no. is 31104. If no other port no. is specified, the default will take effect.
  For example, to use port 20001 on the Coordinator machine for the communication with the Agent, enter:
  -e CoordinatorPort=20001.

• -e BuildServicePort= [Optional] – the Agent port number for the communication with the Coordinator. By default, the BuildService port no. of an Agent is 31105. If no other port no. is specified, the default will take effect.
  For example, to allocate port 40001 on the container for the communication between the Agent and the Coordinator, enter: -e BuildServicePort=40001.

• -e BuildHelperPort= [Optional] – the first Agent port number in a port range, for the communication between an Initiator and the containerized Agent cores. For each available core in the containerized Agent, a port no. in a consecutive order should be open and available. For example, if the first port no. in the range is 32000, and the Agent has 4 cores, 3 additional ports should be open: 32001, 32002, 32003.
  By default, the BuildHelper port of an Agent is 31106. If no other port no. is specified, the default will take effect. The number of available Agent cores that will be included in the range depends on the value of the
  --cpus parameter.
  For example, to allocate ports 32000-32003 on the container for the communication with the 4 cores of the containerized Agent, enter: -e BuildHelperPort=32000.

• -it [Mandatory] – a general docker run option enabling you to log into a container using TTY, i.e. a terminal, and preventing the container from exiting immediately after the launch.

• -p <Host_Machine_Port_No._mapped to>:<BuildServicePort No.>/tcp [Mandatory] – the mapping of a physical open port in the host machine to the port no. of the BuildServicePort in the container. For the communication with the Coordinator, the Agent in the container needs an open port. This port should be mapped to an open port in the host machine, to enable the communication with the Coordinator machine. These port numbers on the host machine and container do not have to be the same.
  For example, for the communication with the Coordinator, to map port 30044 on the host machine to port 40001 on the container, enter: -p 30044:40001/tcp.
  Note: If you did not specify a port no. for the BuildService, and you used the default port number, you need to enter here the default no. 31105. For example, -p 30044:31105/tcp.

• -p <Start-End_Port_Range_in the Host_Machine_mapped_to>:<Start-End_Port_Range_for_the_Agent_Cores_in_the Container>/tcp – the mapping of a physical port range in the host machine to the port range of the BuildServicePort in the container. For the communication between an Initiator and the containerized Agent cores, a range of ports needs to be open in the container, and this port range should be mapped to port range in the host machine to enable the communication. These port ranges on the host machine and container MUST be the same.
  For example, for the communication with the 4 cores of a containerized Agent, to map port range 32000-32003 on the host machine to port range 32000-32003 on the container, enter: -p 32000-32003:32000-32003/tcp.
  Note: If you did not specify a port no. for the BuildHelper, and you used the default port number, you need to enter here the default number 31106 as the first port no. in the range of the container. For example, -p 31106-31109:31106-31109/tcp.

• <IncrediBuild_Image> [Mandatory] - the name of IncrediBuild image that was downloaded to the machine. For example, incredibuild:9.45.60.

For example:
The following command was entered in a terminal, to launch an IncrediBuild container with an active Agent:

docker run --cpus 4 
-e Coordinator=IncrediBuild1 
-e CoordinatorPort=31104 
-e BuildServicePort=31105 
-e BuildHelperPort=31106 
-it 
-p 31105:31105/tcp 
-p 31106-31109:31106-31109/tcp 
incredibuild:/9.45.60

In this example:

• --cpus – the maximum number of cores that can be used by the containerized Agent is 4.

• -e Coordinator= – the Agent will communicate with a Coordinator whose hostname is IncrediBuild1.

• -e CoordinatorPort= – the Coordinator port number for the communication with the Agent is 31104.

• -e BuildServicePort= – the Agent port number for the communication with the Coordinator is 31105.

• -e BuildHelperPort= – the first Agent port number in the port range for the communication with the Agent cores is 31106. Since the Agent can use up to 4 cores, 3 additional ports in a consecutive order should to be open in the container: 31107, 31108, 31109.

• -it - general docker run option for logging into the container using TTY.

• -p 31105:31105/tcp – port number 31105 on the host machine is mapped to port number 31105 on the container, for the communication between the containerized Agent and the Coordinator.

• -p 31106-31109:31106-31109/tcp – port range 31106-31109 on the host machine is mapped to port range 31106-31109 on the container, for the for the communication between the containerized Agent cores and an Initiator.

• <IncrediBuild_Image> – IncrediBuild image that is used for launching the container is incredibuild:/9.45.60.

 Output:

Setting Coordinator to IncrediBuild1
Setting Coordinator Port to 31104
Setting BuildService Port to 31105
Setting BuildHelper Port to 31106
Starting IncrediBuild Agent Service

...

• On the Coordinator Monitor, select the containerized Agent, and right-click it. From the pop-up menu, select the Unsubscribe option:
  Note: You can also open the Agent menu in the Coordinator Monitor, and select the Unsubscribe option.

  Image RemovedImage Added

  The license that was allocated to the Agent will return to your license pool, and the containerized Agent will be removed from the Coordinator Monitor.