Engee documentation

Starting an Engee session

General information

Before you start working in Engee, you can configure the required amount of resources to improve the performance of your work session and select a version of the Engee workspace.

By default, starting a work session via the Start Engee button with no settings is done with the minimum resource parameters and the latest version.

In case you need to increase memory size, idle time and number of virtual cores, close the current session and start it again with higher settings, which will allow you to run longer or more computationally intensive calculations of already prepared scripts or models.

High performance-intensive settings are not saved the next time the session is run. This prevents situations where unnecessary resources are accidentally selected.

Session startup settings

To open the settings window, click the gear icon start settings 0 1 on the control panel of your personal cabinet:

start settings 0 2

Once clicked, the resource settings and version selection panel will open:

start settings 1 -> start settings x 1

You can select the version of the Engee workspace: current (used by default) or from a previous release.

The bottom left corner of the drop-down sidebar indicates the version of the personal workspace, not Engee.

start settings x 2

The minimum resource parameters can be changed by the administrator based on the internal rules of the respective organisations.

start settings 3

The session start menu consists of the following settings:

  • vCPU - number of virtual processor cores. Virtual processor cores are designed to improve Engee performance by distributing the computation and data processing load between different logical cores. Such a system runs multiple threads or tasks simultaneously, resulting in improved responsiveness and faster performance. The vCPU frequency depends on where Engee is running - in the isolated enterprise loop or in the public cloud. Administrators control the isolated loop by expanding the available vCPU values, for example, by making them fractional.

  • RAM is the amount of memory that is allocated to run the Engee compute module. When working with large amounts of data, such as when reading and writing data to RAM by interactive scripts or models, there is a risk of running out of this memory. If calculations use up all of the allocated memory, the compute module may start to slow down and then stop and reboot. When the system reboots, it will lose the data that was stored in RAM. Set a high RAM value when working with large data.

  • Idle Limit - the time interval of user inactivity in Engee when no mouse movements or keystrokes are performed. Within a licence or isolated loop, administrators can allow users to choose the length of the idle time value (hours and days depending on the licence). This is useful for cases where an interactive script is run for a long calculation that does not require user supervision.

  • Start Engee - similar to the big button on the control panel, starts Engee with the selected session parameters.

  • Reset Settings - resets the settings to their minimum values. The minimum values depend on the specific licence or isolated circuit of the respective enterprise.

Administration of startup resources

The isolated licence administrator can also save the elevated settings by default for a particular user. The new settings configuration will change the limits within which the user can independently increase the use of shared enterprise computing resources prior to launching an Engee session. Resource limits are managed by Engee licence administrators based on the internal policies of their respective organisations.

If an administrator allows multiple users to use all available resources, this may lead to a situation where the first user takes up all available resources. The other users will receive messages that there are not enough licences or resources to start a session in Engee.