Pool
Pool Overview#
This page lists all sandbox pools that are accessible in the KYPO portal. In the following table, each row represents one pool:
Instructors can click on the title of each pool to see a more detailed view of the given pool. The last column of this table contains actions that can be executed on the given pool:
Delete
Click the button, and the following confirmation window will be opened:
After confirming, the given pool will be deleted from the KYPO portal.
Warning
Pools that are locked or not empty cannot be deleted.
Allocate all
Click the button to start allocating all missing sandboxes.
Info
More about allocation in the pool detail section.
Allocate one
Click the button to start allocating one new sandbox.
Info
More about allocation in the pool detail.
Clear
Click the button to delete all allocation requests and sandboxes from the given pool.
Warning
All sandboxes must be unlocked, and all allocation requests must be finished/stopped.
Get SSH Config
Click the button to display a pop-up window to download the ZIP archive. The archive contains configuration with the Management SSH access to successfully built sandboxes. More about SSH access can be found here.
Lock
Click the button to change the state of the given pool from unlocked to locked. The lock symbolizes that pool is in use with some training instance.
Unlock
Click the button to change the state of the given pool from locked to unlocked. Unlock symbolizes that pool is not in use with any training instance.
Note
Actions 3. - 6. can be accessed in the menu shown after clicking on the more options button.
To create a new pool, click on the 
button. The instructor will be redirected to the page Create Pool.
Create Pool#
This page contains a short form that needs to be filled out before creating a new pool. The field Sandbox Pool Size specifies the maximal number of sandboxes that can be created inside the pool. The instructor must also select one of the available sandbox definitions created by the instructor. Sandbox definitions define the topology of sandboxes and user configuration of virtual machines created in a sandbox. After filling out all the fields, confirm the creation of a new pool by clicking on the button.
The sandboxes built in the pool are always created from the same definition and the same revision. When the pool is created, it is tied to the current revision of the definition. If the definition revision has changed, e.g., new commit has been added to the specific branch, and you want to build sandboxes from a new revision, you need to make a new pool.
Pool Detail#
When the instructor clicks the title of a given pool in Pool Overview they will be redirected to the Pool Detail page, which contains panel addressing sandbox instances.
In the top right corner, there are control buttons:
allocate all of the missing sandboxes in the pool,
delete sandbox instances with failed stage,
force delete all sandbox instances.
Sandbox Instances#
The instructor can see all the allocated sandboxes in the Sandbox Instances table. The last column of this table contains actions that can be executed on the given sandbox:
Delete
Click the button, and the following confirmation window will be opened:
After the confirmation, a new cleanup request for a given sandbox instance will be created.
Info
Only unlocked sandboxes can be deleted.
Display topology
Click the button to redirect to the page with the virtual network topology of the given sandbox.
Get SSH Config
Click the button to display a pop-up window to download the ZIP archive. The archive contains configuration with the User SSH access to a respective sandbox. More about SSH access can be found here.
Lock
Click the button to change the state of the sandbox instance from unlocked to locked. Lock symbolizes that the sandbox instance is connected to a training run.
Unlock
Click the button to change the state of the sandbox instance from locked to unlocked. Unlock symbolizes that the sandbox instance can be connected to a training run.
Note
Actions lock and unlock can be accessed in the menu shown after clicking on the more options button, and only one of these actions is always available, depending on the current state of the sandbox.
Allocation itself consists of three stages (allocation of a sandbox in the cloud, sandbox networking, sandbox provisioning). Each stage can be in one of the following states:
- In Queue
: Stage is waiting to start. - Running
: Stage in progress. - Finished
: Stage was successfully executed. - Failed
: An error occurred during the stage execution.
Note
Sandbox instances with failed stage are unusable. Thus no action can be executed on them apart from delete.
Stage details of the sandbox are available by clicking on sandbox name. To see details of stage execution, click the Stage detail button of the given stage. In case that stage fails, the error message should be available there.
