Cayosoft Administrator process recreation

---

Overview

Cayosoft Administrator operates with two types of processes: the main process and client process.

• Main Process: This process hosts the PowerShell execution engine, loads all necessary PowerShell modules, and establishes connections to all managed systems, such as Active Directory and Entra ID (ex/ Azure AD).

• Client Process: These processes handle the execution of reporting and automation rules, web queries, and actions, either on a schedule or upon request. When a client process is busy, web actions and rules submitted by end-users are queued until the process is available.

If the Administrator Service encounters issues with Exchange Online, SharePoint Online, or other managed systems, it marks the affected PowerShell Client Processes for recreation. During this time, the following messages may appear in the Web Portal: 

1) When all processes are occupied, and a current call has waited for a defined period without starting (configurable timeout or can be disabled), a warning will appear: "Administration Service is busy. Please wait for a few minutes and repeat your operation." 

2) When no process can be created due to a critical issue, an error will appear: "The Administration Service cannot create a working host process. Please contact your administrator to verify and adjust the service configuration." This error will not be shown if the timeout mentioned previously is turned off.

The automatic recreation of processes can take up to 5 minutes. If the initial attempt fails, the Administrator Service will retry establishing the process for up to one hour. If unsuccessful, it will take a one-hour break before trying again, continuing this cycle until the process is established.

 

Troubleshooting

Perform the steps below to resolve the possible processes issues.

The warning indicates that your service is under high load. This is a notification to help you manage and optimize your service performance. If you receive a warning that the Administration Service is busy, here are some steps you can take to troubleshoot and resolve the issue:

1. Open the Administrator Console.
2. Navigate to Home > QUEUE to view the current service load.
3. Check the Execution Queue and Host Processes tables to understand the status of running and pending tasks.

Learn more in: Session Management - Optimizing performance with Cayosoft Administrator.

To effectively troubleshoot issues with the Cayosoft Administrator, start by examining the event logs and checking for any errors in the Administrator Console. Follow these steps to identify and resolve potential problems:

1. On the computer that hosts Cayosoft Administrator, open Event Viewer.
2. Navigate to Windows logs > Application on the server with Administrator Service and check if there are some Administrator Service errors. 
3. In the Administrator Console check if there are any errors on the Home page.
4. The resolutions for the errors can be found in the following articles:
   • Troubleshooting Cayosoft Administrator Active Directory DC Connection Issues – Cayosoft Help Center
   • Troubleshooting connection to Microsoft 365 – Cayosoft Help Center
   • Troubleshooting Cayosoft Administrator Exchange On-premises Connections – Cayosoft Help Center
   • Troubleshooting connection to SharePoint Online – Cayosoft Help Center