Persistent and Non-Persistent Exercise Environments¶
Instructors have the option of adding a “persistent” or “non-persistent” environment feature while provisioning environments.
Note
Depending on the plan, some organizations will only have access to non-persistent environment options. With the TeachCyber Non-persistent Flat Rate, Cyber.org Non-persistent Flat Rate, Basic Non-persistent Flat Rate, and Non-persistent Flex Rate plans, the “non-persistent” option seen while provisioning should default to “non-persistent” and is unchangeable.
Persistent Environments¶
Persistent environments are best suited for tasks that require multiple days to complete or courseware materials that make sequential changes to the system and hinge upon previous steps. Once a user has joined the exercise, they retain the backing resources of the exercise environment(s) for the duration of the course. They can leave the range and later come back to resume their exercises without the loss of data or configurations.
Non-Persistent Environments¶
Non-persistent environments are ideal for single session, isolated tasks. When a user joins a session, they are given a two-hour window to utilize the resources with the opportunity to extend the session once for up to one additional hour. After the session ends, by either the time expiration or user termination, the backing resources are destroyed and are no longer accessible. The next time the user joins their exercise, they will receive a freshly provisioned exercise and a new timed session. Non-persistent environments have a maximum of twenty hours per team per calendar month UTC.
Non-persistent environment can help the Cyber Range optimize exercise environment costs by limiting uptime and removing idle exercise environment resources between sessions.
Tip
When instructors provision environments, the best persistent option is recommended for you by default.
A non-persistent exercise environment can be re-launched and run up to a total of twenty hours per calendar month. If a student's team/environment ever approaches this limit, they will receive a warning on the exercise environment page under their team environment indicating that they are approaching their monthly limit for that specific environment.
The exercise environment controls will be disabled once the runtime limit for the month is reached.
Info
The session time will remain running for the selected time period (two hours + up to one extended hour) even if the user leaves or stops the exercise. Leaving or stopping the exercise is different from terminating the session which is explained below. If a user leaves or stops the exercise, they will be able to re-enter the same exercise if they return before the end of the time period. However, terminating the exercise stops the session early and does not save the user's work within the exercise. The twenty-hour monthly amount will continue to be consumed unless the user clicks "Terminate" the exercise.
Environment Time Remaining¶
The session time is displayed at the top of the web interface and begins to count down once the user joins the environment.
Within the last ten minutes of the two-hour period, users are allowed to extend the session time for up to one hour by clicking the EXTEND SESSION button. If there is less than one hour remaining of the twenty hour limit for the calendar month, the session time will be extended by the remaining time. For example, if a user begins a session with two hours and thirty minutes remaining for the month, if they try to extend the session after the two-hour session, thirty minutes will be added on.
Once the session time is extended, the Environment time remaining will be updated, and you will see a confirmation that your session has been extended by an hour.
Non-persistent environment session duration can only be extended once. After the session is extended, the EXTEND SESSION button will no longer be visible. After the session time runs out, the session will end, and any saved work will be lost as the exercise environment will be terminated.
Warning
If the time difference between the user’s clock and the environment clock is more than one minute, a warning will be displayed. For more information on this issue, please see the article section titled PC/Laptop System Clock (Time & Date) Skew.
Terminate¶
Users will see a “Terminate” button that can shut down and end the session. Once selected, a confirmation dialog will be displayed.
After checking the confirmation box for terminating the session, the dialog will disappear. Users will see a message at the top of the environment stating their session has ended and they will no longer be able to complete any actions within the environment at this stage.
Have a Question? Contact Support¶
We're here to help you. If you still have questions after reviewing the information above, please feel free to submit a ticket with our support team and we'll get back to you as soon as possible.
Thank You for Your Feedback!