> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incredibuild.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Licenses

Last updated on Nov 05, 2024

Your license is validated by communicating with our license server every 8 hours. If your Coordinator machine fails to connect to the license server for 7 days, your license will be locked until the connection is re-established. If your license is locked, you can only perform local builds with limited features.

## Viewing your License Details

You can view your license package details in the **Coordinator > License** area.

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/license_details2.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=2218ad80922501b255fae13fe9e35136" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/license_details2.png" />

You can view a summary of your current resources in the **Coordinator > Agent List > Resource Overview** status bar.

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/license_usage2.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=34031e1910d3bb7b8fdc9c08ce5887bf" alt="" width="2188" height="360" data-path="images/windows/10.31.1/windows/license_usage2.png" />

You can see the number of licenses that are currently assigned to agents, the number of available licenses, and whether any licenses are in the 24 hour cooldown period during which they cannot be moved to another Agent.

You can also see information about your Cloud Hours and Cache Cores.

## Assigning Roles to Agents

By default, each newly added agent receives the role of helper. This behavior can be adjusted in the [Coordinator Settings](/windows/10.31.1/coordinator-settings) > Agents area.

You can manually change the role of an individual agent, or a group of agents by going to the menu and selecting **Set Initiator Role** or **Set Helper Role**:

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/set_initiator_role.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=286946ccd545dbf04ebfc2fef8bc4d65" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/set_initiator_role.png" />

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/set_helper_role.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=ff4c52c4c43c9a943c2cc799fed3ac28" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/set_helper_role.png" />

When setting the Helper role, you can define the **max cores** that each Helper can use. This settings can conflict with the similar settings in the [Agent Settings > Agent > CPU Utilization](/windows/10.31.1/agent-options) area on each Agent machine. The setting in Coordinator Manager is primarily used by the grid manager to manage licenses. The Agent setting allows owners of Helper machines to limit their use. The lower value of the two settings will determine the maximum number of cores a particular Agent can use.

To assign more than one Agent at once, select the Agents and use the Actions menu:

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/gifs/bulk_agent_select2.gif?s=742d6d12619bd3e4496af595c284e80c" alt="" width="1446" height="826" data-path="images/windows/10.31.1/windows/gifs/bulk_agent_select2.gif" />

## Agent Assignment Settings

In the **Coordinator** > **Settings**> **Agent** area, you can manage the default roles that are assigned to new agents as well as other settings relating to Agent assignments. For details, see [Coordinator Settings](/windows/10.31.1/coordinator-settings).

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/coordinator_settings_license2.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=74d87b046690bff7ad68e16f5c8852dc" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/coordinator_settings_license2.png" />

## Refreshing Your License

If there was a change in your license, it can take a few hours for this to be automatically reflected in the Coordinator. You can instantly update it on your own at any time if you want to speed this process up.

In the **Coordinator** > **License** tab, click **Update License Now**.

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/license_details_update.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=71af016cc68cc6bd5208e93e591ca246" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/license_details_update.png" />
