Session Management Settings
What are sessions in Cayosoft Administrator?
Cayosoft Administrator uses PowerShell for connection to external systems like Active Directory, Exchange On-premises, Microsoft 365 (including Exchange Online, Teams and Sharepoint). It connects to the systems under the connection accounts specified in each extension settings.
Each of these systems has its own limitations to concurrent connections per user. And our product has default number of opening sessions optimized for these limitations.
On-premises systems can be changed to allow more connections per user, but Microsoft 365 has strict limitations that cannot be modified. Microsoft has a Global Throttling Policy which limits simultaneous connections from one client and only three simultaneous connections are allowed.
Cayosoft Administrator by default creates 5 child processes within 1 main process, and each process contains PowerShell sessions opened to the external systems and can execute one automation rule or a web action at a time. If number of executing rules or web actions are more than the product can handle at the moment, they’ll accumulate in the queue and start their execution as soon as one of the suitable sessions becomes free. You can see the queue and execution time of current operations in Console > Home > QUEUE.
How to increase the productivity of Cayosoft Administrator?
You can use the following approaches to increase productivity of your Cayosoft Administrator:
- Schedule your automated rules or dynamic groups at the time when you don’t use Web Portal. So, scheduled rules will not occupy the sessions that users need to perform actions in Web Portal.
- Configure replication and use one server for automation rules and dynamic groups, and another server for Web Portal. Each replication partner must use its own connection accounts, so total number of opened connections increases, and Cayosoft Administrator can execute more rules and web actions in parallel. More details you can find here: High availability & replication.
- Change Advanced Sessions Management parameters for managing Active Directory (not recommended). Be aware, that you need to adjust your Domain controllers ADWS settings before changing these parameters in Cayosoft Administrator, or can get unpredictable behaviour.
Advanced Sessions Management for Active Directory
Important: Parameters described below are critical for the performance of Cayosoft Administrator and AD Domain Controllers. Please do not change these parameters until consulted with Cayosoft Support.
Maximum number of limited session hosts
Specify the number of limited session hosts.
|Maximum number of rules to run in parallel||Specify the number of rules to run in parallel.|
For details how to configure Cayosoft Administrator and AD Domain Controllers please read this KB article: https://support.cayosoft.com/hc/en-us/articles/360040097431
You can configure automatic session termination so Cayosoft Administrator service will automatically terminate the session that executes a single rule more than specified time period.
Terminate rule execution if it takes longer than (hours)
Specify the number of hours. By default it is 48 hours. This setting is always applied whether manual termination is enabled or disabled.
|Disable/Enable manual termination||
Click the button to enable or disable session termination.
For details please see this article: How to configure manual session termination – Cayosoft Help Center.
|10.1||Session termination has been added.|
|7.1.0||Session Management node has been added.|