Return idle licenses

In this topic, you'll learn how to configure Tosca to automatically return idle licenses. This frees up the licenses you're not actively using for other members of your team, so they can use them for their own tests.

Understand when Tosca returns which licenses

When you close Tosca, Tosca immediately returns all licenses that aren't specifically tied to this machine. So, it returns all licenses except checked-out or node-locked licenses.

When you run Tosca without actively using it, Tosca doesn't return any licenses. This means these licenses are blocked for other testers.

Configure Tosca to return idle licenses

You can configure Tosca to automatically return idle licenses that aren't specifically tied to a machine. To do so, configure the setting Return Licenses on Idle Timeout (Minutes) at Project > Settings > Commander > General > Advanced.

You need to do this for all workspaces that should have an idle timeout. If you want to apply an idle timeout to all workspaces connected to your repository, create project settings.

Note that if a user has a timeout in their local settings and a different timeout in the project settings, Tosca applies the timeout from the project settings.

Work with timeouts

If you configure a timeout in the options, Tosca shows a message whenever the specified idle time expires. This message includes a countdown.

To stop the countdown and return to active state, select Cancel.

Reclaim licenses after the countdown has ended

If you don't cancel the countdown in time, Tosca locks the user interface, returns the licenses, and shows another message.

To return to active state and get your licenses back, select Reclaim.

Return checked-out or node-locked licenses

The option to automatically return idle licenses isn't available for checked-out licenses or node-locked licenses (opens in new tab). They are bound to specific machines, which means Tosca doesn't return them after closing, and you can't configure an idle timeout for them.

To return them, perform the following actions: