Pooling

What is pooling?

Pooling ensures that there are sandboxes ready to be claimed by a student. With pooling enabled a student no longer has to wait for a sandbox to start and can start learning immediately.

How does it work?

Creating a pool of available instances

  1. Navigate to the pooling settings on your organization home page.

  2. Set the pool size for your track to the desired amount. Building up the pool may take some time depending on the amount you specify. Once the desired amount of pooled sandbox environments are created, the platform will maintain the desired amount of pooled sandbox environments. This means that the platform will create new pooled environments once a learner claims one of the available sandboxes.

Changing pool sizes or draining instances will not impact learners that already have an environment running.

Please keep in mind that pooled instances will stay running until they are used, or drained. Running pooled instances will be billed as if they are in use by a user.

Stopping a pool of available instances

  1. Navigate to the pooling settings on your organization home page.

  2. Set the pool size for the track to 0. Note, this will not automatically stop available instances.

  3. To stop any available instances, press the drain button. This will stop all instances in excess of the configured pool size.

Use Cases

Create and maintain a pool of environments

When?

When you have a constant use of a track, you can use pooling to maintain a few standby instances to reduce start time for your users. Examples are:

  • You have organic traffic to one of your tracks.

  • You distibute track invites via a social media or marketing campaign.

  • You have embedded an Instruqt track on a documentation page.

How?

  1. Adjust the pool size of the desired track.

  2. Wait for the "Actual pool size" to have the same number as the configured pool size.

  3. After this, the platform will try to maintain the pool size. This means that if you configure a track pool size of 5, and 2 environments will be claimed, the Instruqt platform will automatically create 2 new pooled environments to match the desired 5 environments.

Create a one-time pool of environments

When?

When you are organizing a workshop or training, and want to give a group of people access to one or more tracks.

How?

  1. Adjust the pool size of the desired track.

  2. Wait for the "Actual pool size" to have the same number as the configured pool size.

  3. Adjust the configured pool size back to 0. Note, this will not destroy any pooled instances that were already created, but will prevent the platform from creating new instances when one gets claimed by a user.

  4. After the workshop, drain any leftover pooled instances.