MachPanel Knowledgebase

Hotfix for MachPanel Build v8.2.50 HF Updated (April 10, 2026)

rehan_waseem — Mon, 13 Apr 2026 08:41:46 GMT

Summary

This article provides 8.2.50 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.2.50 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.2.50 HF Updated: April 10, 2026

1. Added method in REST API to change Mailbox type.
2. Added methods in REST API to manage Mailbox calendar permissions.
3. Fixed VPS IP only addon not getting provisioned.
4. Fixed VPS disk options in Add VPS.
5. Optimized/Enhanced Exchange Distribution Group Members management.
6. Dynamic IP allocation handled for Linux VMs.
7. Fixed edit VPS addon throwing an exception due to missing Natted IP record.
8. Added Export AD users CSV option in Update Bulk AD User.
9: Added Copy to Clipboard option in Selectable/Select control.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.2.50_Apr_10_2026.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8250/MachPanel_HF_8.2.50_HF_Apr_10_2026.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

Logging on Hyper-V Remote Server

rehan_waseem — Fri, 10 Apr 2026 15:12:36 GMT

Summary

This article provides a summary on MachPanel Hyper -V Logs files for Remote servers.

Applies To

This article applies to MachPanel build v8.2.50 and above.

Enable Extensive Logging via MachPanel:

AttachVHDLog_<date>

Is for all operations related to attaching a VHD to a virtual machine including initialization, configuration validation, disk attachment on the SCSI controller, and final status. Any exceptions encountered during execution are also recorded.

BandWidthMonitering_<date>:

Records network bandwidth utilization metrics for virtual machines within the Microsoft Hyper-V environment. This file is generated when bandwidth monitoring is enabled for a virtual machine and is used to track network activity over time.

It captures both upload and download traffic separately, providing visibility into inbound and outbound data transfer for each monitored VM. The recorded data helps in understanding network consumption patterns, identifying high-traffic workloads, and ensuring fair usage of shared network resources.

JobProcessingLog_<date>

Is for the virtual machine provisioning process on the Microsoft Hyper-V server. It captures a detailed, step-by-step record of all operations performed during VM creation, like creation of the virtual machine directory and storage path, selection and configuration of the VM generation, attachment of the sealed image (VHD/VHDX), allocation of compute resources, and network configuration such as virtual switch assignment and NIC setup.

Any warnings, exceptions, or failures encountered during execution are also recorded.

Overall, this log file provides end-to-end traceability of the VM creation lifecycle.

ProvSvc-RemoteConfigurationStudio_<date>

This indicates that the Provisioning Service (ProvSvc) has initiated a process. Typically, this log appears when the service starts up, or task/job (such as configuration, deployment, or sync) is triggered.

Prov_SVC_<date>

This usually logs when the system attempts to process a job. For e.g. The process is already stopped, or process was never running, or process ID/name could not be found.

Remote_<date>

This log shows that a remote PowerShell command was executed. The command queries the Windows Management Instrumentation (WMI) to collect CPU (processor) details from the target machine. It is typically used by monitoring/provisioning systems (like MachPanel) to gather system resource information.

Remote configuration Studio_<date>

These logs indicate a MachPanel Remote Server update process initialization. It shows the version to which it is updated. The update was successful or failure. In case of update failure it will show the error or cause of failure.

VPS_<date>

Provides an abstracted, high-level view of the processing status for individual virtual machine files (XML) within the provisioning workflow on the Microsoft Hyper-V environment.

VMUsageStateLog

Maintains a structured, time-series record of resource utilization metrics for virtual machines hosted on the Microsoft Hyper-V environment. The data is stored in JSON format, where each entry corresponds to a specific virtual machine identified by its unique VMID and VMName.

For each virtual machine, the log captures a collection of UsageStats entries recorded at periodic intervals. These entries include key performance indicators such as CPU usage, memory (RAM) consumption, and disk (HDD) utilization, along with an associated UTC timestamp (DateStamp) indicating when the metrics were collected.

This log enables historical tracking of VM resource consumption over time, facilitating performance monitoring, capacity planning, and trend analysis. It also supports identifying usage patterns, detecting anomalies (e.g., sudden spikes in CPU or memory), and correlating system behavior with operational events.

This structured JSON format allows easy integration with monitoring tools, reporting systems in MachPanel for both real-time observation and retrospective analysis of virtual machine performance.

VMUsageState

Is for the virtual machine resource monitoring process within the Microsoft Hyper-V environment. It records the execution details of the ReadVMStatsAndSaveInFile() routine, which is responsible for collecting and persisting VM usage statistics.

This log captures timestamped entries that document both successful operations and runtime exceptions encountered during the data collection process. Common logged activities include reading VM resource metrics, calculating virtual disk consumption, and writing aggregated statistics to the VMUsageState data file.

VMDownTime (folder)

Contains the VMDownTime file that maintains a record of virtual machine downtime events within the Microsoft Hyper-V environment. It captures essential details for each instance where a virtual machine is identified as unavailable or not running.

PFSense Deployment & Integration Prerequisites (Hyper-V Environment)

mudesira.munir — Wed, 01 Apr 2026 15:39:06 GMT

Summary

It describes how to integrate and deploy PFsense in Machpanel Hyper-V environment.

Applies To

Applies to MachPanel build v 8.2.50 and above

Overview

This document outlines the prerequisites and key configuration requirements for deploying pfSense in a Hyper-V environment and integrating it with MachPanel. Adhering to these guidelines ensures consistency, scalability, and seamless operation, especially in high-availability (HA) setups.

1. PFSense Deployment on Hyper-V

Deploy pfSense as a virtual machine on Hyper-V hosts by following the official Netgate documentation:  https://docs.netgate.com/pfsense/en/latest/recipes/virtualize-hyper-v.html
Ensure that the VM is provisioned with appropriate resources (CPU, RAM, and storage) based on expected workload and tenant usage.

2. Network Interface Configuration

Configure network interfaces in pfSense as per deployment requirements.
Maintain consistent interface naming and ordering across all pfSense instances (Primary and HA peers).

Important:  Consistent interface naming and ordering are critical for proper synchronization between pfSense nodes in high-availability configurations.
Reference Topology.

3. REST API Configuration (for MachPanel Integration)

Install the pfSense REST API package.
Generate and securely store the API key, which will be required for MachPanel integration. Reference:  https://github.com/pfrest/pfSense-pkg-RESTAPI

4. Virtual Switch & Interface Alignment

Ensure that the Hyper-V virtual switch name matches the corresponding pfSense interface name used for tenant communication.
Recommended naming convention: "TENANTS" (ensure correct spelling and consistency across all systems)

Important:  The naming must be identical across:

Hyper-V Virtual Switch
pfSense Interface This is required for proper mapping and automation via MachPanel.

5. Trunk Configuration

Configure the "TENANTS" virtual switch on Hyper-V as a trunk port.
This allows multiple VLANs to pass through and enables tenant-level network segmentation.

6. High Availability Considerations

For HA deployments:
Apply identical configurations across all pfSense nodes.
Ensure:

Interface naming consistency
Matching virtual switch configurations
Proper synchronization settings

Failure to maintain consistency may result in sync failures or unpredictable behavior.

MachPanel Cloud Networking - Software Defined Network Integration for pfSense

zohaib.shaikh — Thu, 26 Mar 2026 06:13:43 GMT

Summary

This article provides information regarding "Cloud Networking" feature in MachPanel, that is Software Defined Network handling for pfSense and Hyper-V

Applies To

Applies to MachPanel version v8.2.50 and above.

Overview

MachPanel now supports integration with pfSense, enabling automated management of network services such as NAT, firewall rules, and IP routing for virtual machines via newly added "Cloud Networking" section.

This enhancement allows administrators to seamlessly connect MachPanel with pfSense to automate network configuration during VM provisioning and management.

Key Features

Automated NAT rule creation
Firewall rule management
Integration with VM provisioning workflow
Centralized network control via pfSense
Reduced manual configuration effort

Pre-Requisites

pfSense Configuration Pre-requisites:
- One time pfSense deployment and configuration is required on Hyper-V server / servers. This deployment will serve as a multi-tenant pfSense setup for all your customers hosted via MachPanel giving you and your customers total control, automation and cost saving..
  - Setup/Install pfSense on your Hyper-V Server. Review following KB article on pfSense Deployment & Integration Prerequisites (Hyper-V Environment)
MachPanel Configuration Pre-requisites:
- Dynamic IP Allocation for Private Pool IPs is required to be configured in MachPanel before configuring pfSense in MachPanel.
  - To do that, navigate to Virtual Machine Hosting > Server Group.
    - From the Options click Subnet Pools
    - Click Add Subnet Pool
      - Give Name
      - Choose Type to 'Private'
      - Choose the Allocation type to 'Dynamic'
      - Select Virtual Switch 'Tenants'
      - Give VLAN ID
      - Choose the checkbox 'Use for Single VPS Hosting Products', if you want to create this Pool for Single VM Plan.
      - Select 'All'
      - Click Save.

MachPanel Cloud Networking / pfSense Configuration

A new configuration section is introduced to connect MachPanel that allows you to add pfSense servers called the "Cloud Networking".

Add Server

Click Add Server button to add your pfServer server details and associate the Server Group and customers:

Give Server Name.
Select Provider as "PfSense"
Select the Server Group to associate pfSense with.
Tick the checkbox 'High Available Member' (If you have HA Setup)
- Choose Role
  - Master
  - Slave
Give your API URL and API Key. (How to configure pfSense API)
Tick the checkbox to enable this Server.
Click Save.

Manage Interfaces

Next step is to configure or manage the "Interfaces" which are already configured in pfSense.

The interface setup on your backend Hyper-V Server will be shown here.
You can choose the interface and tick the respective 'Used For' for particular interface. You can choose either of the shown interface types for any particular interface:
- OTHERS (interfaces not designated for specific use, such as LAN or other interfaces)
- WAN (interface designated for WAN)
- Tenants (interface designated for TENANTS)
  - If tenants is selected then you have to select it for any particular customer or ALL.

Click Save.

Public IPs

To add Public IPs click Add/Edit Public IPs

You can Select Server.
Select the Interface
Give list of Comma separated IPs
Select the Subnet

Click Save

Now you can Provision a VM for a specific customer.

Virtual Networks

Once VM is provisioned against a customer, you can navigate to "Add VNet" interface to Add Virtual Network against desired customers:

Select the Customer against which you have added VM, then Select your Server and Click Save.

You can also manage/Edit DNS for particular customer virtual network.

Aliases

To add Aliases navigate to below section and click 'Add Alias' against a particular customer.

Select Customer
Give Alias name
Give Discription
Choose Type
- Host(s)
- Network(s)
- Ports(s)
Later you can Edit, View or Remove any alias as well.

Firewall Rules

To add firewall rules to a specific VM of customer, navigate to below interface and click Add Firewall Rule

Select Customer
Select Interface that you have created for this customer
Give Description
Choose Action
- Pass
- Block
- Reject
Choose Protocol
- Any
- TCP
- UDP
- TCP/UDP
- Source and Destination can be choosen upon your requirements 'Any or any specific Interface'
Click Save

You can also set the Priority as well.

Static DHCP Mapping

As in DHCP, the IP of VM might get changed automatically after every reboot. So, here you can assign Static IP for any particular VM of a customer so that it does not get changed after every reboot. To set you can navigate to below interface, it will show details about the VM of your customer.

Click Assign Static IP
Choose the IP you want to assign to the VM of customer as static
Click Assign

NAT Rules

To add NAT Rules, you first have to assign Static IP to the VM. Then navigate to below interface and click Add NAT Setting

Select Customer
Give Description
Enabled NAT
The IP you have given as static will be shown in drop down
Choose the Protocol
- Any
- TCP
- UDP
- TCP/UDP
Choose the Source from drop down
Select the Public IP to which you want to translate/map the private IP of this customer VM
Click Save

Dynamic IP Assignment to VM (Backend Managed)

zohaib.shaikh — Wed, 25 Mar 2026 07:55:00 GMT

Summary

MachPanel now supports Dynamic IP Assignment for Virtual Machines, where IP configuration (IP address, Gateway, DNS) is automatically managed by the backend instead of manual allocation.

Applies To

This article applies to MachPanel version v8.2.50 and above.

Overview

This enhancement simplifies VM provisioning and reduces manual network configuration effort.

Key Concept

There are now two types of IP allocation in Subnet Pools:

Static IP (Default)
- Traditional Method
- Admin manually assign IP, Gateway, DNS
Dynamic IP
- Fully managed by backend
- No manual IP assignment required

*Note: Dynamic IP is supported only for Private IP Pools. Public IP Pools remains Static.

Subnet Pool Configuration

A new option is added in Subnet Pool settings to define IP assignment type.

Important Notes

Once a subnet is created, IP type cannot be changed later
When Dynamic is selected:
- No IP addresses need to be defined
- IP entries cannot be added, edited, or deleted

VM Replication Support Handling in MachPanel

zohaib.shaikh — Wed, 25 Mar 2026 06:25:57 GMT

Summary

MachPanel now includes enhanced support for Virtual Machine (VM) replication, enabling more efficient management of replicated environments within Hyper-V infrastructures.

Applies To

This article applies to MachPanel version v8.2.50 and above.

Overview

This enhancement introduces improved handling of VM replication workflows, allowing administrators to better manage, monitor, and maintain replicated virtual machines directly from the MachPanel interface.

Key Features

Replication Awareness
- MachPanel can now detect and recognize replicated virtual machines, ensuring accurate status visibility.
Improved Management Controls
- Administrators can perform actions on replicated VMs with better consistency, avoiding conflicts between primary and replica instances.
Seamless Integration with Hyper-V
- Enhanced compatibility with Hyper-V replication ensures that changes in replication state (e.g., failover, failback) are properly reflected within MachPanel.
Error Handling and Stability
- Improved handling of replication-related scenarios reduces failures during provisioning, synchronization, and VM operations.

Server Group Configuration

A new checkbox has been added in Server Group configuration to enable replication settings.

Server Configuration

Each server can now be assigned a role in replication.

VM Provisioning Behavior

Virtual Machine Provisioning logic now ensures that VMs are only created on valid Active servers.

Auto Detection of VM Location

MachPanel now intelligently detects if a VM has moved and updates records accordingly.

MachPanel Build v8.2.50 Release Notes (April 02, 2026)

zohaib.shaikh — Mon, 16 Mar 2026 14:42:36 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Major Enhancements
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build, then you must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Do note that if REST API is installed by MachPanel installer under C:/Program Files/Machsol/RESTAPI and it is operational in your environment, then auto update will update RESTAPI files as well. Manual update is needed when RESTAPI is installed on other than default location.

Important Note for MachPanel Load Balanced Setup after the Update.

If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build and you are using MachPanel Load Balanced setup then you must follow below steps after the update:

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Major Enhancements

4. Improvements/New Feature

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Audit logs improved for Active Directory module.
Restricted access to SPLA reports for Owner's company Staff users with Super Admin role only.
Added New AD User Password Policy settings.
Restricted access to Customer account for certain Staff Roles
Added User Type filter in AD Users listing.
Configured AD Authentication for Staff Users.
Added enhancement to return JobId in Add Entity API methods.
Updated DUO WebSDK integration.

Microsoft Exchange:

Audit logs improved for Exchange Module.
Added new mailbox user Password Policy settings.
Increased the Message Size limit during Mailbox Import processing.
Added enhancement in Audit logs search for Mailbox-Specific-Action.
Improved Mail Flow reports with Fault Tolerance.
Improved Add Mailbox retries for handling DB deadlock victim error.
Logging added for MailFlow Logs processing failure tracking.
Added -ShowDetails in Mailbox Audit Logs export command.
Added enhancement for UPN, CN and SAM case is retained as per input in AD and Ex module.

Microsoft Hyper-V:

Improved Memory Weight field in VPS plans for Reseller & Customer.
Added VM Scheduled Management Operation (Turn On/Off).

5. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Fixed extra modules show up in customer side without subscribing.
Fixed AD User add issue when there's no user in organization to set as Manager.
Fixed error in creating/updating Linked Ad User Contact for Customer.
Fixed error on Set As Home Page action in German language.
Fixed REST API edit AD User function.
Fixed user attributes cleared on enabling Mailbox for existing ADUser.
Fixed AD Expired accounts report.
Marked required field with * in Customer Contact Add/Edit.
Fixed Active Directory Groups not listing users correctly.

Microsoft Exchange:

Fixed the issue of mailbox not getting disabled having Audit Enabled.
Fixed Sanitization issue in Exchange Disclaimer text.
Fixed Auto Disable/Enable Mailbox on ADUser Disable/Enable not working.
Fixed error in Ex Settings interface "FirstName" Column not found.
Fixed Mailbox template gets updated from mailbox Edit Interface.
Allowed Simple DL member add in Simple DL members.
Handled error "This task does not support recipients of this type." in create mailbox job processing.
Fixed Mailbox display text.
Fixed Required parameter missing error in enabling Mailbox for existing AD User imported from backend or O365.

Microsoft Hyper-V:

Fixed long delay in Get All VMs Endpoint.
Fixed 'Manage' VM button issue from Customer Login.

Microsoft CSP:

Fixed error in Tenant Management User detail and other tabs.
Updated message on missing GDAP relation for tenants imported in panel.
Fixed CSP Grant Consent Issue.

CSP Grant Consent Error

rehan_waseem — Thu, 15 Jan 2026 11:18:15 GMT

Summary

The article give information about solving the issue of CSP Grant Consent after the Window Update KB5071544

Applies to

MachPanel v8 and above

Issue Details

After the below windows update

https://support.microsoft.com/en-us/topic/december-9-2025-kb5071544-os-build-17763-8146-630aa62e-f399-4e42-9f7a-2a4d38dd1210

Below issue might come while granting consent for CSP tenant in MachPanel.

Resolution

To fix the issue below steps should be followed:

Go to the installation directory of MachPanel Control Server (C:\Program Files\MachSol\MachPanel Control Server).
Open Web.Config in notepad.
Find <httpRuntime>
Replace it with below:
- <httpRuntime targetFramework="4.8" executionTimeout="1800" maxRequestLength="102400" maxQueryStringLength="16384" maxUrlLength="16384" />
Apply changes and restart IIS.

Hotfix for MachPanel Build v8.1.22 HF Updated (March 27, 2026)

mudesira.munir — Wed, 24 Dec 2025 07:44:35 GMT

Summary

This article provides 8.1.22 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.1.22 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.1.22 HF Updated: March 27, 2026

1: Fixed extra modules show up in customer side without subscribing.
2: Fixed MailFlow logs break if one of Ex server is down.
3: Logging added for MailFlow Logs processing failure tracking.
4: Added -ShowDetails in Mailbox Audit Logs export command.
5: Fixed AD User add issue when there's no user in organization to set as Manager
6: Fixed Sanitization issue in Exchange Disclaimer text.
7: Fixed long delay in Get All VMs Endpoint.
8: Fixed error in creating/updating Linked Ad User Contact for Customer.
9: Fixed Auto Disable/Enable Mailbox on ADUser Disable/Enable not working.
10:Disable/Delete operations allowed for mailboxes whose AuditEnabled is On.
11:Fixed error in Ex Settings interface "FirstName" Column not found.
12:Fixed error on Set As Home Page action in German language.
13:Fixed default password policy selected is not getting applied on new AD User creation.
14:Fixed MB template gets updated from mailbox detail, edit section hidden.
15:Allowed Simple DL member add in Simple DL members.
16:UPN, CN and SAM case is retained as per input in AD and Ex module.
17:DUO WebSDK integration updated.
18:Fixed REST API edit AD User function.
19:Fixed user attributes cleared on enabling Mailbox for existing ADUser.
20:Handled error "This task does not support recipients of this type." in create mailbox job processing.
21:Updated handling to avoid/reduce "Deadlock Victim" error in Active Directory and Exchange Module.
22:Fixed AD Expired accounts report.
23:Fixed Mailbox display text.
24:Marked required field with * in Customer Contact Add/Edit.
25:Fixed Required parameter missing error in enabling Mailbox for existing AD User imported from backend or O365.
26:Fixed error in Tenant Management User detail and other tabs.
27:Fixed Active Directory Groups not listing users correctly.
28:Updated message on missing GDAP relation for tenants imported in panel.
29:Fixed error '"{0}" is not a valid email address' in O365 Security Group Management.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.1.22_Mar_27_2026.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8122/MachPanel_HF_8.1.22_Mar_27_2026.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

MachPanel Build v8.1.22 Release Notes (December 08, 2025)

zohaib.shaikh — Thu, 27 Nov 2025 20:40:53 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Major Enhancements
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build, then you must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Important Note for MachPanel Load Balanced Setup after the Update.

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Major Enhancements

Optimized client JS front end and ASP.Net backend to improve performance of control panel both on client and server side. Customers having organizations with 10K+ users will have better user experience with the control panel.
Exchange Subscription Edition integration added.

4. Improvements/New Feature

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Updated REST API mailbox-permissions method to sync data in database/interface.
Standardized behavior for Customer/Reseller buttons.
Customer contact email handling updated, verification is added based on customer AD users.
Profile Picture update support added via MachPanel interface for ADSync enabled users.
Show most recent Provider first in Add Package (all applicable modules).
Updated domain change flow.
Updated backup routine to skip *.PST files when the import folder contains large locked files.
Quantity increase/decrease and deletion for add-ons in REST API.
Improved API validation.
Updated CustomAttributes handling.

Microsoft Exchange:

Restricted Application Impersonation role to Shared Mailboxes.
Added Basic OWA Policy auto assignment for mailboxes using the Basic template.
Added option to import mailboxes from backend under mailboxes management.
Added per-organization option to disable/enable mailbox on ADUser Disable/Enable.

Microsoft Hyper-V:

Added option to connect Web Console with and without Enhanced Mode for Windows VMs.
Enhanced Sealed Image Add/Edit interface to Support Legacy (Copy-VMFile) and NoCloud ISO Options

5. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Fixed issue in Load Balanced REST API file sync routine.
Fixed auto backup not working in Configuration Studio.
Fixed Login With Azure issue when Linked with AD Staff User Account.
Fixed pager not working in Audit Logs listing.

Microsoft CSP:

Fixed product selected in package missing in O365 Subscription detail and renewal settings.
Fixed admin relationship role assignment in O365 management.

Microsoft Hyper-V:

Fixed ISO image checkbox display.

Hotfix for MachPanel Build v8.0.50 HF Updated (November 06, 2025)

rehan_waseem — Mon, 15 Sep 2025 16:50:57 GMT

Summary

This article provides 8.0.50 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.0.50 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.0.50 HF Updated: November 06, 2025

1: Updated REST API set mailbox permissions method to sync data in database/interface.
2: Fixed pager not working in Audit Logs listing.
3: Fixed ISO image checkbox display.
4: Fixed Full Access permissions for mailbox not working.
5: Import Mailboxes from backend added.
6: Fixed issue in Load Balanced RESTAPI file sync routine.
7: Fixed mailboxes with Basic SPLA reported as Standard mailbox due to wrong OWA Mailbox Policy assigned.
8: Added option to connect Web Console with and without Enhanced Mode Setting for Windows VM.9: Fixed product selected in package mssing in O365 Subscription detail and renewal settings.10: Fix admin relationship role assignment added in O365 management.11: Fixed auto backup not working in Configuration Studio.12: Issue of Login With Azure Linked AD Staff User Account Fixed.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.0.50_Nov_06_2025.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8050/MachPanel_HF_8.0.50_Nov_06_2025.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

Update MachSol Signature Agent 09 September 2025

rehan_waseem — Tue, 09 Sep 2025 13:31:01 GMT

Summary

This article provides details on how to update your Machsol Signature Agent to its latest version.

Note

This is a new and additionally paid feature, licenses for which can be acquired from MachSol Customer Portal / Store. Please contact MachSol Sales for more information.

Applies To

MachPanel build version 8 and above

Pre-Requisites

MachPanel Signature Agent must be installed using below KB article:

https://kb.machsol.com/Knowledgebase/55789/MachSol-Signature-Agent-

Improvements/Fixes

Added input to define Signatures for External and Internal messages or for both.
Added Distribution List for applying signatures, making management easier.
Time limit added to schedule Signatures for Disclaimers and banners.
Added preview is Signature Listing.
Added clone option to duplicate and update signatures easily.
Added setting to customize if Sent Email should be updated or not.
"X-MachPanel-MessageSignaturesProcessed" added in email header to mark the email and skip in futher processing.

Procedure

Take backup of existing files
- Go to your installation directory of MachSol Signature Agent.
- Copy the complete folder MachSol Signature Agent
- Create a new Backup directory and place this copied folder inside this backup folder
Stop Service
- Open Services and stop Microsoft Transport Service

Download the latest files from THIS link
- Copy all the inside the update folder and replace them inside the installation directory of MachSol Signature Agent
Start the Microsoft Transport Service.

MachPanel Build v8.0.50 Release Notes (September 09, 2025)

rehan_waseem — Wed, 03 Sep 2025 20:41:46 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
If you are already running MachPanel Build 8.0.32, then this prerequisite is already there. If you are updating from an older build, then you must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Important Note for MachPanel Load Balanced Setup after the Update.

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Improvements/New Feature

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Customers can manage Active-Sync devices per user from control panel
Added option to enable/disable servers in bulk
Added “Resend Code” Option for PIN via SMS and Email in Online Store Two-Factor Authentication
Added ADUser report in REST-API.
Files restriction in file upload implemented on all locations allowing upload, allowed types are: pdf,doc,docx,xls,xlsx,csv,ppt,pptx,txt,rtf,odt,jpg,jpeg,png,gif,bmp,svg,tiff,webp,zip,rar,7z,tar,gz,mp3,wav,mp4,mov,avi,mkv
DotNet page execution from cache folder is restricted.
Connection string in 3rd party import settings is now encrypted.
Updated SimpleDisplayName of mailbox using Set-User command.
Updated file upload, input values sensitization and other security updates.
Updated error handling in AD Bulk update operation, added validation for empty mandatory fields when retain existing data is un-checked
Updated users navigation on AD Organization Listing >> User Count link.
Hidden "Next Renewal" Column on Subscriptions Page When Billing Module is Disabled (Customer & Reseller View)
Handled replication delay error that might cause password policy update failure when creating new AD Users
Added automation for REST API files to be auto updated in Load Balanced Control Server Deployment
Added logging for REST API operations on disk. Handled Get request logging to disk
Added details of "Account Used" for REST API calls in audit log
Load balancer setup handling added for REST API OAuth.

Exchange

Added option to Change Public Folder Mailbox database
Added setting of External Forwarding
Added priority High parameter in Import/Export Mailbox PST commands
PS injection handling updated for multi-line inputs and more use cases, input is sanitized and encoded to avoid PS execution, PS injection attacks.
Updated REST API, permissions (SendAs, SendOnBehalf, FullAccess) for Mailbox and Distribution List can be cleared now by passing empty list
Added option to Load Mailbox Templates based on Templates sold in add-ons
Removed unnecessary Organization Drop-down in “Add PST Export Job” under Exchange Accounts → Manage Service
Exchange Import Utility Improvements added . The nested OUs will not be shown
Handled + and # symbols in LDAP of Mailbox, DL, Contact.
"+" handled in DL email address, can create a DL like all+@domain.com.
Update X-MachPanel-MessageSignaturesProcessed in Signature processing. Please update the agent using THIS link.

VPS/Hyper-V

Added Notes Option in VM Management Checkpoints Section

SharePoint

Added option for adding existing AD users to SharePoint portal in bulk

Signature Agent

Note: MachSol Signature Agent on Exchange Servers need to be updated using link.

Added input to define Signatures for External and Internal messages or for both.
Added Distribution List for applying signatures, making management easier.
Time limit added to schedule Signatures for Disclaimers and banners.
Added preview is Signature Listing.
Added clone option to duplicate and update signatures easily.
Added setting to customize if Sent Email should be updated or not.
"X-MachPanel-MessageSignaturesProcessed" added in email header to mark the email and skip in further processing.

4. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Fixed checkbox Misalignment on MFA Login Screen
Fixed login Redirection (global search) Fails with Data Type Conversion Error
Fixed update Email Subject and Body for Re-authentication Secret Notification
Fixed proxy Settings & License Update Error in Remote Configuration Studio
Fixed PIN code Checkbox alignment at Customer Login to Online Store
Fixed customer Login Fails to Online Store with Duo Authentication – Upgrade to Duo Universal Prompt Required
Fixed error on Customer Login to Online Store – MFAPINRequestEmail not found on SubscriptionEmails
Fixed error on AD User Login via PIN (Email/SMS) and Authentication app – Object reference not set to an instance of an object
Fixed customer can buy add-ons though access permission is not allowed.
Fixed duplicate users display in AD Groups management.
Fixed conversion error when Login button is clicked on Global Search Results.
Fixed error in logging in when DUO authentication is used.
Fixed AD Group jobs not updating data on backend.
Fixed AD Organization list that shows no records if Remove Organization permission is not allowed.

Exchange

Fixed Mailbox Status Link Redirects to Blank Page After Provisioning Completes
Fixed Mailbox Full Access Auto Mapping not showing correctly or Full Access status keeps on syncing.
Fixed Mailbox device tab giving error when a device not found.
Fixed Duplicate records in DL ManagedBy when adding multiple Exchange DLs in one go.
Fixed Mobile Device Listing not working.
Fixed Mobile Device listing all Devices related to Mailboxes interface not listing records.
Fixed error in adding SMTP domain when the language is other then English.
Fixed Mobile Device listing missing some records against Mailbox. Also changed Identity display to show only Device identity part.
Fixed Suspected PS injection error in Mailbox OOO settings.
Fixed error in Get DL members in REST API when there is no member.
Fixed error System.InvalidOperationException: Cannot de-serialize type 'BusinessObjects.Hosting.ServiceMangement.ExchangeManagement+Forwarding.
Fixed error in SimpleDisplayName update in Exchange module.
Fixed error Operation failed.parsing "(href|src)\s*=\s*['"]?\s*javascript:|data:|vbscript:)[^'">]*['"]?" - Too many )'s. in package add/edit.
Fixed wrong variables in disclaimer body.
Fixed DL SendOnBehalf not accepting DL email.
Fixed X500 addresses not valid.
Fixed updating template of mailbox updates CAS settings twice which causes issue randomly if command executes on different servers.

VPS/Hyper-V

Fixed no IPs found error in VPS import.

O365/Microsoft CSP

Fixed search domain and company not working in O365 import.

Configuring Autodiscover SRV Record for Outlook Connectivity

rehan_waseem — Mon, 11 Aug 2025 09:28:42 GMT

Summary

This article provide information about how to configure auto discover SRV record for Outlook Connectivity.

Applies To

All Versions.

Steps Procedure

Kindly make sure DNS (escpeically autodiscover) is properly configured for your customer organization.

Following is required to have successful autodiscovery:

_autodiscover._tcp.example.com. 3600 IN SRV 0 0 443 mail.example.com.

Please create SRV record as per above format for tenant domain.

SRV Record: Create SRV record in each tenant public DNS zone with given format.

Note: Make Sure you do not have any CNAME with name autodiscover in tenant DNS zone.

After making changes (if they were not already there) give DNS propagation some time and check your outlook connectivity again.

Hotfix for MachPanel Build v8.0.32 HF Updated (September 1, 2025)

rehan_waseem — Mon, 26 May 2025 11:30:07 GMT

Summary

This article provides 8.0.32 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v8.0.32 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 8.0.32 HF Updated: September 1, 2025

1: Fixed Mailbox Full Access Auto Mapping not showing correctly or Full Access status keeps on syncing.
2: Fixed Mailbox device tab giving error when a device not found.
3: Fixed Duplicate records in DL ManagedBy when adding multiple Exchange DLs in one go.
4: "+" handled in DL email address, can create a DL like all+@domain.com.
5: Fixed Customer can buy addons though access permission is not allowed.
6: Fixed Mobile Device Listing not working.
7: Fixed Mobile Device listing all Devices related to Mailboxes interface not listing records.
8: Updated error handling in AD Bulk update operation, added validation for empty mandatory fields when retin existing data is un-checked.
9: Added priority High parameter in Import/Export Mailbox PST commands.
10:Fixed error in logging in when DUO authenticator is used.
11:Fixed error in adding SMTP domain when the language is other then English.
12:Fixed Mobile Device listing missing some records against Mailbox. Also changed Identity display to show only Device identity part.
13:Fixed Suspected PS injection error in Mailbox OOO settings.
14:No IPs found during VPS import fixed.
15:Updated PS injection check to allow ";" in input password.
16:Fixed AD Group jobs not updating data on backend.
17:Added logging for REST API operations on disk. Handled Get request logging to disk.
18:Fixed error in Get DL members in REST API when there is no member.
19:Update PS injection checks to handle more scenarios.
20:Added logging to disk for REST API handling all type of Requests.
21:Fixed error System.InvalidOperationException: Cannot deserialize type 'BusinessObjects.Hosting.ServiceMangement.ExchangeManagement+Forwarding.
22:PS injection handling updated for multi-line inputs and more use cases, input is santized and encoded to un-wanted avoid PS execution.
23:Fixed AD Orgs list show no records if Remove Org permission not allowed.
24:Updated users navigation on AD Orgs Listing User count link.
25:Handled replication delay error that might cause password policy update failure when creating new AD Users.
26:Fixed Duplicate users display in AD Groups management.
27:Fixed conversion error when Login button is clicked on Global Search Results.
28:Fixed search domain and company not working in O365 import.
29:Added ADUser report in REST-API.
30:Fixed wrong variables in disclaimer body.
31:Files restriction in file upload implemented, allowed types are: pdf,doc,docx,xls,xlsx,csv,ppt,pptx,txt,rtf,odt,jpg,jpeg,png,gif,bmp,svg,tiff,webp,zip,rar,7z,tar,gz,mp3,wav,mp4,mov,avi,mkv
32:DotNet page execution from cache folder is restricted.
33:Connection string in 3rd party import settings is encrypted.
34:Updated SimpleDisplayName of mailbox using Set-User command.
35:Updated file upload, input values santization and other security updates.
36:Fixed error in SimpleDisplayName update in Exchange module.
37:Fixed error Operation failed.parsing "(href|src)\s*=\s*['"]?\s*javascript:|data:|vbscript:)[^'">]*['"]?" - Too many )'s. in package add/edit nad HeldpDesk emails processing.
38:Updated REST API, permissions (SendAs, SendOnBehalf, FullAccess) for Mailbox and Distribution List can be cleared now by passing empty list.
39:Fixed DL SendOnBehalf not accepting DL email.
40:Fixed X500 addresses not valid.41:Load balancer setup handling added for REST API OAuth.
42:Fixed updating template of mailbox updates CAS settings twice which causes issue randomly if command executes on different servers.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix MachPanel_HF_8.0.32_Sep_1_2025.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/updates/8032/MachPanel_HF_8.0.32_Sep_1_2025.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

Installation Guide for SQL Server 2022

mudesira.munir — Mon, 12 May 2025 20:08:27 GMT

Summary

This article is a step by step guide for installing SQL Server 2022.

Applies To

This article applies to SQL Server 2022.

List of anti virus Exclusion for SQL Server:

For Microsoft SQL Server, review details on link below for exclusions list:

https://support.microsoft.com/en-us/help/309422/choosing-antivirus-software-for-computers-that-run-sql-server

Steps to install SQL Server 2022

Step 1: Download SQL Server 2022 | Microsoft Evaluation Center. https://www.microsoft.com/en-us/evalcenter/download-sql-server-2022

Run SQL2022-SSEI-Eval.exe
Click download media.

Step 2: Select English as Language and choose your package option. Download and Save file to c:\ drive.

Once Download is completed, click Close. Copy downloaded installer “SQLServer2022_x64_ENU.exe” to c: drive. Open command prompt and point to c: drive.

Run the “SQLServer2022-x64-ENU.exe” and extract files to desired folder e.g. C:\Users\Administrator\Downloads\SQLServer2022-x64-ENU>

Navigate to SQL Server Installation Media Directory to run setup:

C:\Users\Administrator\Downloads\SQLServer2022-x64-ENU>

OR Run the command:

Syntax:

C:\Users\Administrator\Downloads\SQLServer2022-x64-ENU>setup.exe /q /IACCEPTSQLSERVERLICENSETERMS /ACTION=Install /FEATURES=SQL /INSTANCENAME=<InstanceName> /SQLSVCACCOUNT="NT AUTHORITY\SYSTEM" /SQLSYSADMINACCOUNTS="NT AUTHORITY\SYSTEM" "YourDomain\YourUsername" /AGTSVCACCOUNT="NT AUTHORITY\NETWORK SERVICE" /SQLSVCINSTANTFILEINIT="True" /SAPWD="<YourStrongSAPassword>" /SECURITYMODE=SQL /TCPENABLED=1 /NPENABLED=1 /SQLCOLLATION=SQL_Latin1_General_CP1_CI_AS

Replace Highlighted Values:

<InstanceName> => Your desired Instanced Name like “MACHSOLDB”
“<YourDomain\YourUsername>” — with the fully qualified Windows username of the current user you want to grant sysadmin access to.
You can get the current user using:

whoami For example, if it returns:

machsol-1o7s7h2\administrator
<YourStrongPassword> => Your desired strong password for “SA” account.

Then update the command like this and execute in Command:

C:\Users\Administrator\Downloads\SQLServer2022-x64-ENU>setup.exe /q /IACCEPTSQLSERVERLICENSETERMS /ACTION=Install /FEATURES=SQL /INSTANCENAME=MACHSOLDB /SQLSVCACCOUNT="NT AUTHORITY\SYSTEM" /SQLSYSADMINACCOUNTS="NT AUTHORITY\SYSTEM" "machsol-1o7s7h2\administrator" /AGTSVCACCOUNT="NT AUTHORITY\NETWORK SERVICE" /SQLSVCINSTANTFILEINIT="True" /SAPWD="SAP@ssw0rd!@#321" /SECURITYMODE=SQL /TCPENABLED=1 /NPENABLED=1 /SQLCOLLATION=SQL_Latin1_General_CP1_CI_AS

Run above command with all parameters.

Alternatively follow the below steps to perform installation via GUI/Wizard.

Please execute the installer as “Run as Administrator” and select the first option from the Installlation “New SQL Server Standalone Installation’.

Step 3: In the second step specify your Edition click Next and agree to the License terms and then click Next. Then check for the updates, if available then download the Updates and Install the setup files.

Step 4: On the next page “Microsoft Update” please check the highlighted option in order to use the recommended option regarding updates and click Next.

Step 5: In the fourth step the installation wizard will automatically install the Install Rules and upon completion please click on Next.

You can choose or skip Azure Extention for SQL Server option:

Step 6: Next up here is the Feature selection. In this step please select the required features as highlighted which are required for MachPanel database. Features to be selected: Database Engine Services, Client tools connectivity & Client tools backward compatibility and then click Next.

From Instance features please select: Database Engine Services

From Shared features please select: Client tools connectivity & Client tools backward compatibility and click Next.

Step 7: In the Instance Configuration please select the Default instance option as shown below and click Next. If you have already created an instance then please use named instance option and provide the Instance Id as well otherwise default instance will work.

Step 8: In this step you will review the account properties as there will be different accounts for different SQL server services. Please proceed with below highlighted setting in service accounts tab as we used Default instance so the properties of the accounts should be like:

Under the Collation tab please make sure to select the SQL_Latin1_General_CP1_CI_AS as shown below and click Next.

Step 9: The next step is the Database Engine Configuration. Under Server Configuration tab please select the Authentication Mode as Mixed mode which includes both SQL server authentication and Window authentication and provide the password for Server Administrator (SA) account. It is recommended to provide a strong password and also save it in some safe place. There should be one SQL server administrators specified, you can add multiple by clicking on Add button.

Step 10: After the database configuration settings are configured the installation wizard will itself install feature configuration rules and then the installation will proceed and complete.

SQL Server Management Studio Installation

After SQL server Installation we will have to install the SQL server management studio by running the exe file as an Administrator and click on Install.

To install SQL Server Management Studio Setup (20), use below link to download installer:

Download SQL Server Management Studio (SSMS) 20.2.1

EPG (Etisalat Payment Gateway) Integration

mudesira.munir — Fri, 09 May 2025 22:50:13 GMT

Summary

This article provides information about EPG (Etisalat Payment Gateway) integration.

Applies To:

MachPanel Control Server build v8 and above

Configure EPG (Etisalat Payment Gateway):

To configure EPG (Etisalat Payment Gateway) as your payment gateway, navigate to the following path: Home » System Configurations » Billing Configuration » Payment Gateways
Click on the Configure and follow the instructions below:

Provider: Shows the name of provider you are configuring. Not editable.
Enabled: Select NO only if you want to disable the payment gateway. This will prevent system from charging bills through this gateway.
Merchant ID: Provide the Merchant ID.
API Username: Provide the Username.
API Password: Provide the password.
Text to show if selected: Type necessary text.
Gateway handling fee: Provide gateway handling fee.

Adding Payment Group

After Configuring EPG (Etisalat Payment Gateway), You have to Integrate it in Payment Groups from the following path: Home » System Configuration » Billing Configuration » Payment Groups
Click Save button.

MachSol Signature Agent

rehan_waseem — Fri, 09 May 2025 16:04:00 GMT

Summary

This article provides details on how to configure Signature Agent.

Note:

This is a new and additionally paid feature, licenses for which can be acquired from MachSol Customer Portal / Store. Please contact MachSol Sales for more information.

Applies To

MachPanel build version 8 and above

Pre-Requisites:

To be installed on all Exchange Servers:
Required Exchange Server Version: Exchange Server 2019 version 15.2.1544.4 - 15.2.1748.24

(If you do not want to update to latest CU for Exchange, Please contact Support after purchasing license to deploy on older version of Exchange)

https://learn.microsoft.com/en-us/exchange/new-features/build-numbers-and-release-dates#exchange-server-2019

Permission Required for Service Account User

MachPanel Service Account user, under which MachPanel Provisioning Service is running required Application Impersonation permission to update sent item with signatures.

Introduction

The MachSol Signature Agent is a newly introduced, premium add-on for MachPanel (version 8 and above) designed to automate and manage email signatures across Microsoft Exchange environments.

Key Features and Configuration Overview
- Centralized Signature Management: Enables administrators to define and enforce consistent email signature policies across all users within specified Exchange Server Groups.
- Transport Agent Integration: Utilizes a transport agent to append signatures to outbound emails, ensuring uniformity and compliance.
- Secure Key Implementation: Employs a 32-character alphanumeric secure key to authenticate and authorize signature operations across servers.
- Customizable Settings: Configuration is managed via a Settings.json file, allowing customization of parameters such as:
  - WebServicePath: URL to the MachPanel web service endpoint.
  - LogMode: Defines the logging level (e.g., Simple).
  - EWSUrl: Exchange Web Services URL.
  - SecureKey: The aforementioned secure key

MachSol Signature Agent Configuration

Below are MachSol Signature Agent configuration steps:

Step - 1: Server Group Signature Settings

Please configure Server Group Signature Settings by navigating to following path: Home > Service Director > Exchange Hosting > Exchange Server Groups
Select options against desired Server Group and Select Signature Settings:

Check the box against: Server Transport Agent Signature enabled.
Input Comma separated IP Addresses of Exchange servers: example 10.2.210.13,10.2.210.14.
Note: The MachSol Signature Agent have to be installed on all Exchange Transport servers and Private IP must be mentioned for all servers.
Input Secure Key (32 Characters Alpha Numeric) and note the value. Example X7P9G2LQF5T1M8WZK4V6D3CYRJ0BNSAH

Step - 2: Download the attached file and copy MachSol Signature Agent Folder to 1st Exchange Transport server, example 10.2.210.13.

Update "MachSol SignatureAgent\Settings.json" as per your environment.

Update YourPanelURL.com with your MachPanel Control Server url, make sure the web service is accessible by opening the url in browser.
LogMode: "Simple" for basic logging, "Verbose" for detailed logging.
EWSUrl: EWSUrl of local Exchange Server, no need to change if default installation is same.
SecureKey: Mention the Secure Key Set in Server Group Settings example: X7P9G2LQF5T1M8WZK4V6D3CYRJ0BNSAH
Allow "Network Service" full permissions on the "MachSol SignatureAgent" folder and sub folder and files. If the Exchange Transport Service is running under another user than "Network Service", allow that user full permissions on the "MachSol SignatureAgent" folder.

Step - 3: Install Signature Agent

To install Signature Agent, please update AssemblyPath "C:\MachSol SignatureAgent\MachSol.SignatureAgent.dll" according to the location of MachSol SignatureAgent folder on your system in below commands:
Copy below commands and run on Exchange Shell:

Step - 4: Copy the MachSol SignatureAgent From 1st Exchange Server to all other Exchange Servers

Copy the MachSol SignatureAgent folder from 1st Exchange Server, example 10.2.210.13 to all other servers and run the commands mentioned in Step - 3.

Management

First you have make sure that Signature allowed for Mailboxes (using Transport Agent) is allowed in Service Plan or in the particular Exchange Subscription, You can review the Exchange Subscription interface for any particular Exchange Organization (Click Subs Id of that organization) and then under Resources tab click Edit Resources and make sure below resources are available.

Then navigate to Service Director > Exchange Hosting > Accounts and then click 'Manage' as Exchange Organization. Under the Management interface click "Rules" tab.

You can give the Name of Signature, Set the priority and then select the mailbox to apply this signature.

You have two option either you can Signature HTML or Signature Text.

Also you can add custom variable for each user/mailbox like (Display Name, Phone and Department etc.).

Then click Save button to add the signature.

MachPanel Build v8.0.32 Release Notes (May 19, 2025)

rehan_waseem — Fri, 09 May 2025 14:53:46 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Notes
Major Enhancements
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Customers using old module like Exchange 2010, Exchange 2010 Hosted, should NOT update to MachPanel v8.
You must need to download Microsoft .Net Framework 4.8 on control and remote servers. Once downloaded you can run the installer to install .Net framework 4.8 following below steps:

After the installation of .Net Framework 4.8 your server will require a restart. You can click on 'Restart Now' button.

Also, it is recommended to use the latest version of browsers (Chrome, Firefox and Edge) and MachPanel HelpDesk Service should be disabled before starting the Auto Update Process.

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

2. Important Notes

HelpDesk Service is moved back to MachPanel/Bin folder, and you need to change the path of HelpDesk Service from MachPanel/Apps/HelpDeskService to MachPanel/bin.
It is advised to disable HelpDeskService before update.
If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

Do note that if REST API is installed by MachPanel installer under C:/Program Files/Machsol/RESTAPI and it is operational in your environment, then auto update will update RESTAPI files as well. Manual update is needed when RESTAPI is installed on other then default location.

Important Note for MachPanel Load Balanced Setup after the Update.

If you are using MachPanel Load Balanced setup then you must have to follow below after the update:

Locate MachPanel app pool in IIS, open Advanced Settings and select .NET CLR version v4.0, restart app pool and web app.

Copy Web.Config file from Primary Control Server (C:\Program Files\MachSol\MachPanel Control Server) to all your Secondary Servers.
Also, make sure all others files are updated on Secondary Servers, if not then you have you update all files from Primary Control Server to all Secondary Server by stopping all MachPanel services including MachPanel Configuration Studio on all Server and stopping MachPanel App Pool and MachPanel Website.

3. Major Enhancements

Below are major changes/enhancement in build v8:

Net Framework upgrade for all projects to .Net Framework 4.8 for long-term support.
Major listings like Customer, Reseller, Accounts, Mailboxes and more are updated to use API and client side JS Framework for faster display and better utilization of server resources.
Arabic domain name handling in domain name inputs.
Database usage report added.
REST API updates, paging on SQL side to speed up Get API methods, new methods added for Mailbox, Audit Logs added.
Hyper-V 2025 integration.
Server side Mailbox Signature handling using Exchange Transport rules.
Integrated new payment gateway: Etisalat Payment Gateway

4. Improvements/New Features

General (MachPanel, AD, Configuration Studio, REST API, HelpDesk):

Arabic Domain (DNS) handling in Enterprise Services for e.g. Exchange
Update REST API and Export of the reports from portal/service method
Improved Group Action Logs Listing
MachPanel Control to Remote sync for version updates
Option to delete Staff Member
Ability to Authenticate contact via AD account
Change in First and Last name should automatically fill only Display Name and NOT the UPN for AD User Creation/Edit.
Update Microsoft Access Database Engine to 2016 Redistributable
Updated MachSol Software License Terms in Configuration Studio
Enable or Disable Users Through Bulk Update Users
Change all sample files from .xls to .xlsx in all Modules
Add audit log for REST API POST, PUT, DELETE calls

Exchange

REST API reports are updated, related entity Ids like MailboxId, OrganizationId, HostingId etc are added in relevant reports.
Distribution List REST API methods updated, status is added and RequireSenderAuthentication handling corrected.
Added Audit Log entry on enabling AD User from mailbox listing.
Optimized Add AD User and Add Mailbox.
Added email search in REST API for Mailbox, Distribution List and Contact.
Permissions setting in Add Mailbox is made optional to improve Mailbox Add screen load time.
Mail Contact optional data in REST API updated to show full details from the database.
Exchange and Distribution Recovery API (GetAll, Search, SearchById) allowed to reseller.
Help message updated and Password check on Shared Mailbox bulk create disabled.
Mailbox External forwarding hide handling added. Run script to hide: Update HB_tblExchangeOrganizationSettings Set HideExternalForwardingEmail = '1'
Added check to limit Ex Mailbox creation based on Templates sold to Hosting. Run script to enable feature: Update HB_tblExchangeOrganizationSettings Set LoadTemplatesBasedOnAddons = '1'
"EmailAddress" filter for Mailbox usage report endpoint added to enable filtering on mailbox.
Shared Mailbox Bulk Creation
Keep Mailbox Feature Change Log
Email Forwarding to External SMTP address
Option to review/update “Time Zone” for mailboxes that have “Mailbox Template” associated
Report last or all connected ActiveSync devices
Mailbox Signature using Transport Agent Custom Action
Monitoring Mailbox Import/Export Progress (Percentage) in Exchange
Update handling for error under "Monitoring >> Mail Flow" due to an unavailable exchange server.
Out of office text (Automatic Replies)
- Added the functionality to keep the reply text in DB too and show from DB on re-enable
Added Bulk Permissions for mailbox
Sample File in .xlsx for Exchange Module
Exchange REST API Updates
Added REST API methods to Get/Put Mailbox Custom Attributes
Updated Exchange REST API methods to fix problem in Full Access and Get Mailbox.
Updated bulk mailbox add to avoid deadlock issue.
Error generated on suspected Power Shell (PS) injection attack in Exchange module.

Hyper-V

Added Rocky Linux 9 and Debian 12 operating system support in VPS module.
Expand disk handling updated for Windows VM, now disk within VM expands too.
Updated Public IP handling in VPS Subnet Pool management.
Updated VPS package update Service Queue processing to update VM disk size.
Added Signed .ps1 files for Hyper-V custom ps1 files.
VLAN ID Update
VPS Disk Resized Automatically

Web Hosting/Shared Hosting

Added new tab for Database Usage report

5. Resolved / Fixed Issues

General (MachPanel, AD, Config Studio, REST API, HelpDesk):

Logged in as End Customer, clicking on “Online Help” does not open new tab,
Fixed Move Customer gives error on CSP Subscription Move.
Error Occurs When Loading Audit Logs from Archive
Customer Account Cancellation Error
Fix HelpDesk Service in Installer
Fixed RAM value display in Health Report. (New records after update should show correct value).
Fixed selected Timezone display issue on Customer Edit interface.
Fixed country error in AD User add API.
Fixed report display for Russian Locale.
Fixed Sync AD Users thread not running as needed.
Updated import routine from Citrix based control panel.
REST API Get All AD Users Records Company Based Segregation issue is fixed.
Removed auto update of display name, UPN and email on Key Up event in edit AD user info interfaces.
Fixed 2 backups are taken instead of 1 in daily backup of control panel routine.
Fixed Impersonate as Reseller not working when OAuth2 sis used for REST API.
Fixed SQL error in ADUser login.
Fixed disabled ADUser gets enabled on Bulk ADUser operation.
Fixed ADSync password not getting updated each time.
Prov Svc crash on Control Server due to a missing method fixed.
Fixed AD bulk user Add/Edit not applying Password settings as specified.
Error on MachPanel licenses page related to int conversion fixed.
Fixed not showing member users listing in AD Security Group Add/Edit.

Exchange

Fixed wrong CustomAttribute1 being set on new mailbox creation.Fixed unable to read user settings in AD user/Mailbox management.
Fixed MAPI > RPC Over HTTP allowed, MAPI over HTTP allowed handling in Exchange Package and Addon Add/Edit. For old records need to update using KB https://kb.machsol.com/Knowledgebase/55746/Added-Setting-of-MAPIhttpEnabled-in-mailbox-features?Keywords=RPC-over-HTTP
Organization Usage report export to Excel updated, templates as separate columns are removed if more then 250 columns in report.
Cannot find table 0 error fixed in bulk Distribution List creation.
Fixed error on Send email of Exchange reports in reports email scheduler tab.
Handled error in contact update using REST API.
Fixed error in update Mailbox general settings REST API.
Fixed Soft delete mailbox re-appear as Active when Permanent Delete job being added/executed.
Fixed wrong Receive and Send message size set when mailbox template is applied on template edit and a disabled mailbox is enabled.
Fixed error in transport rule creation due to problem in actions handling.
Fixed Custom Mailbox template appearing in edit mailbox when it is not allowed.
Fixed error "Operation failed. No active mailboxes to set in managed by setting." when no delectable manager in Distribution Group Advanced Settings save.
Fixed SQL connection leak issue in Exchange Calendar Permission management.
Fixed error in update Distribution List settings when a user is deleted or disabled.

Hyper-V

Error message updated when adding new Hyper-V server group when no Virtual Switch is found.
Fixed "NIC DNS Not Found" Issue in VPS Hosting Module.
Fixed VM Move operation error.
Fixed error in update Server Group policy name length query.
Fixed error in Add Public NIC in VPS Module.
Fixed VPS addon setup changed RAM type.

SharePoint

Addon Storage Issue (SharePoint)
Fixed SharePoint usage report not updating.

Details on Threads running under Threads Manager

rehan_waseem — Mon, 05 May 2025 10:28:45 GMT

Summary

This article provides information about the threads running through MachPanel.

Applies To

Applies to MachPanel v7 and above.

Threads Details

In MachPanel, a thread is a process used to perform tasks concurrently. Threads within the MachPanel Control Server handle operations like:

Provisioning new services
Communicating with remote agents (e.g., Hyper-V, Exchange, etc.)
Processing background jobs (e.g., usage reports, license updates)
Performing scheduled tasks

To see the Threads, Navigate to Service Director > General > Threads Manager:

Under this interface it allows you to:

Enable Logging
- If checked, logs will be generated for the relevant thread on your MachPanel Control Server Logs folder (C:\Program Files\MachSol\MachPanel Control Server\logs)
Update Time Interval.
From the option you can 'Run' or 'Disable'.

You can also update number of threads to run simultaneously by navigating to Service Director > General > Group Actions Logs and then click Group Job Settings. Here you can increase the number of threads to run simultaneously and also you can set the priority of jobs as well (Lowest number is highest priority.(from 0 to 10, 0 has highest priority and 10 has lowest priority).

Below table provides information about the threads and its relevant tasks running under Threads Manager (Service Director > General > Threads Manager).

Threads	Tasks
ADSyncWork	Legacy Thread for ADSync not used at present.
AutoAddUsersInSecurityGroupWork	Adds users to security groups with “Automatic add users” settings enabled. Handles change CN when UPN is changed. Sync all system alerts into database.
AzureRateWork	Gets Azure rate card from Microsoft and saves in database.
BandwidthQuotaWork	Sync Hostmatic websites bandwidth quota usage.
BBSyncWork	Sync BlackBerry stats
BillingWork	Processes commission for commission-based resellers. Billing work process. E.g. Process recurring invoices, issue 30 days credit for defer billing subscriptions, Process Payments, email invoices, add missing tax rates of provider in resellers Generates OCS call record bills Generates SIP billing and adds SIP export tasks. Generates O365 price update notifications.
CallDataProcessWork	Process Lync call records data for voice call report. Sync workflow audio files from remote servers.
DiskQuotaWork	Sync Hostmatic websites disk quota usage.
DomainNameDataSyncThread	Sync Domain contacts and registrar data into database.
DomainVerification	Verify domains in system using TXT records and sends email of successfully verified domains.
ExchangeCPUMemoryStatsWork	Sync exchange CPU and Memory stats
ExchangeDatabaseStatsWork	Sync exchange mailbox database stats
ExchangeMailboxMobileDevicesReportWork	Create and fetch exchange mailbox devices report.
ExchangeServiceStatsWork	Read server services stats Read server inventory details
ExchangeVolumeStatsWork	Read exchange server stats
GroupActionWork	Legacy thread, not used now.
GroupActionWorkAD	Process AD group actions. Update AD Organizations and AD Users extended data into database Sync AD Users Services Detail Disable AD User login on basis of mailbox type Rename and delete Hostmatic database users associated with AD users.
GroupActionWorkCRM	Process CRM group actions Sync users first name and last name.
GroupActionWorkEx	Process Exchange group actions. Creates pending OWA policies. Assigns OWA policies to mailboxes. Sync smart host send connectors. Auto corrects mailbox statuses on basis of group actions. OSS Spam filters handling Delete Mailbox permanent from recycle bin. Sync external remote domains
GroupActionWorkGeneral	Process general and shared hosting group actions
GroupActionWorkLync	Process Lync/OCS group actions. Process call bundles.
GroupActionWorkMailBoxPermissions	Sync mailbox permissions in database Sync mailbox forwarding in database
GroupActionWorkSIP	Process SIP group actions.
GroupActionWorkSP	Process SharePoint group actions.
GroupActionWorkVPS	Process VPS group actions. Update storage type of disks. Delete archived VHD files from server.
HelpDeskCommand	Process Pop Account commands.
HelpDeskWork	Process Pop Account parser. Remove deleted tickets permanently. Manage locked tickets and unlock when schedule meets.
HyperVHomeBackendThread	Sync HyperV bare metal inventory. Sync Hyper visor inventory. Sync server services, Hyper visors, volume, CPU, memory.
IngramCancelNoticesWork	Send Ingram cancel notices.
LicenseWork	License work handling
MailboxMigrationWork	Update mailbox migration batch status.
MailFlowReport	Update Exchange mail flow logs.
MonitoringWork	Process Network director metrics, server monitors (disk, memory, CPU, Mail, IIS, FTP, DNS, Services, TCP, Web Page).
O365SyncAdminLogsWork	Sync O365 admin audit logs.
Office365SyncWork	Sync O365 tenant entities (Tenant, Domains, Licenses & Policies, Users, Mailboxes, Groups, Contacts).
Office365TenantFirstSyncWork	Send O365 tenant first sync notification.
Office365Work	Process O365/CSP group actions. Handle/clear PowerShell runspaces. Sync and renew tenant access token. Renew O365 tenant direct routing and tokens. Handle subscription renewal as per backend.
OverusageResourceNotification	Handle and send notifications of voice bundle quota over usage.
PeerFileSyncWork	Used for Load Balanced server internal sync. 1.1.Sync state service configuration 1.2.Sync files and registry
ProvisioningWork	Process service queue orders. Process DigiCert orders, create SSL order invoices, calculate estimated bills. Generate O365/CSP and VPS threshold alerts. Update Sectigo SSL order status. Process pending O365 subscriptions. Update new VM path from previous VHD locations. Delete 90 days old service queue logs. Delete 100 days old voice bill records. Updates primary email in customer contacts. Update exchange signature usage in database. Update AD users services details. Update AD users disable on basis of mailbox type. Update domain name registrars status Update AD organization suffixes. Update SIP bundle subscriber usage. Delete top 10000 old temp data records older than 120 days. Delete top 100 Azure rates older than 2 years. Delete top 1000 O365 subscription reconciliation records older than 1 year. Update blank subscription names in O365 subscription tables. Update exchange mailbox load on server Work PPU Work Provision Sync mailbox database locations Suspend expired CSP trail offers. Remove and archive audit logs Remove and archive O365 audit logs Verify and create PCI credit profiles for existing cards. Merge Add-Ons Send service queue and jobs failure notifications. Send VPS update notifications. Execute today’s SIP contracts. Execute today’s hosted voice contracts. Insert hosted voice user billing details. Delete unverified customers. Apply bindings for white label URLs. Set NSA registrar for iNET. Update SharePoint server editions. Update employee, customer and contact password with salt. Sync subscription credit limit. Remove orphan AD users. Send recycle bin notification emails. Send recovery notification emails. Auto delete distribution lists from recovery after certain period. Remove 2 months older email logs. Run configuration studio Sync AD users email and Employee ID when empty.
QuotaOverUsedWork	Sync subscriptions resource quota over used. Mark subscriptions bit to verify quota usage again.
RDSSyncWork	Get AD users with RDS service and sync into database.
ReconciliateO365SubsWork	Sync O365 subscriptions reconciliation.
SendEmailCampaignWork	Process email campaign and send emails.
SendEmailNotificationsWork	Process notifications and send due emails.
ServerStatsWork	Sync server stats (CPU, Disk, Memory)
SessionsMgtWork	Update session data (expiry). Delete session history after certain period.
SyncADUsersWork	Sync all AD Users into database.
SyncCSPOffers	Read CSP profiles and sync all offers data.
SyncFromBackendWork	Sync CRM data from backend. Sync SharePoint data from backend. Sync AD contacts from backend.
SynchDNSRecordsWork	Read Hostmatic domains and sync its DNS data from backend. Send domain verification notices.
SyncHealthMetricsWork	Sync software’s control and remote server health metrics.
SyncLockedUsersWork	Sync all AD organization users and lock status.
SyncMissingDataWork	Sync AD users missing data to sync in backup tables Sync Exchange (Mailboxes, DLs, Contacts etc.) missing data to sync in backup tables.
SyncStaffUsersWork	Sync employee’s data linked to AD users.
TransferWork	Process transfer queue orders. Process Hostmatic database backups and transfer them to relevant remote servers. Delete 90 days old backups.
UsageReportScheduleWork	Send enterprise reports due in automatic schedules
UsageReportWork	Read and create Exchange usage report from backend. Generate Add-On usage report. Automatic delete PST files after specific time. Sync average Mailbox size of all Exchange databases. Generate SharePoint portal usage report. Calculate Lync SPLA report. Remove orphan records in AD organizations.
UserPasswordExpiryNotificationWork	Send notification to AD users whose password is about to expire.
VoiceCurrentLimitSyncWork	Update ExternalRef in SIP bundle to subscriber usage. Sync subscriber current SIP usage of all companies. Sync company current SIP usage. Delete all orphan records against SIP subscriptions.
VoiceSyncWork	Sync all voice companies with sync status enabled.
VPSCPUMemoryStatsWork	Legacy, functionality moved under Thread HyperVHomeBackendThread.
VPSEventLogsStatsWork	Legacy, functionality moved under Thread HyperVHomeBackendThread.
VPSHypervisorStatsWork	Legacy, functionality moved under Thread HyperVHomeBackendThread.
VPSInventoryStatsWork	Legacy, functionality moved under Thread HyperVHomeBackendThread.
VPSServicesStatsWork	Legacy, functionality moved under Thread HyperVHomeBackendThread.
VPSStorageStatsWork	Legacy, functionality moved under Thread HyperVHomeBackendThread.
WorkflowsThread	Process workflows created in system.
WorkfolderSyncWork	Sync Workfolder hosting data. E.g. Storage used

MachSync License Activation

zohaib.shaikh — Fri, 21 Feb 2025 12:55:45 GMT

Summary

This article provides step by step guide on how to Activate License for MachSync Utility.

Applies To

This article applies to MachSync v1.0

Pre-Requistes

Before you can activate MachSync License, you need to download and install MachSync v1.0. Please review below KB:

MachSync Installation Guide

MachSync License Activation

Before License Activation

Once MachSync is installed then default dashboard page will appear.

You will not be allowed to navigate to Templates and Profiles sections.

Steps to activate license

You can either purchase license or request a trial.

If you click on "YES" new page will open in browser with MachSol Website and allow you to go for "Try Now" or "Buy Now" options.

If you click on "Try Now", you will be taken to Sign-In page where you have to sing-in using your registered account (Email/Password and PIN):

You will be taken to License Generation Page to get a trial license:

Copy the license information "Installation ID" and "Machine ID" from MachSync License page:

This will generate your Trial License Key:

Press the "Copy to Clipboard" button and the License key will get copied:

On the MachSync utility, under License section, click the "Update" button and paste the License Key:

Click on Apply and your Trial License gets applied:

Now you can continue and access the blocked items:

Configuration

The next step after the installation and license activation is the configuration of MachSync using below KB article:

MachSync Configuration Guide

Hotfix for MachPanel Build v7.3.60 HF Updated (30 April, 2025)

zohaib.shaikh — Wed, 02 Oct 2024 12:47:39 GMT

Summary

This article provides 7.3.60 HF and information about how to apply this fix on your servers.

Applies To

This article applies to MachPanel

Important Note

Prior to performing any update take backup of your MachPanel Database and files from Control and Remote servers. See below Kb article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
MachPanel Control Panel and all MachPanel Remote Servers need to be on Build v7.3.60 and then Hotfix can be applied.
Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:
- Update to Latest MachPanel
- Update to Latest MachPanel Remote Server

Latest Issues Fixed

Build: 7.3.60 HF Updated: 30 April, 2025

1: Fixed RAM value display in Health Report. (New records after update should show correct value).
2: Fixed wrong CustomAttribute1 being set on new mailbox creation.
3: Error handling updated for DB calls when Deadlock occurs.
4: Fixed selected TimeZone display issue on Customer Edit interface.
5: Exchange and Distribution Recovery API (GetAll, Search, SearchById) allowed to reseller.
6: "EmailAddress" filter for Mailbox usage report endpoint added to enable filtering on mailbox.
7: Fixed Sync AD Users thread not running as needed.
8: Fixed error in update Mailbox general settings REST API.
9: Error message updated when adding new Hyper-V server group when no Virutal Switch is found.
10:Fixed country error in AD User add API.
11:Fixed Add NIC DNS Not Found Issue in VPS Hosting Module.
12:Added import Customers and Exchange Subscriptions from Citrix based control panel.
13:REST API Get All AD Users Records Company Based Segregation Issue Fixed.
14:Updated import routine from Citrix based control panel.
15:Fixed report display for Russian Locale.
16:Removed auto update of display name, UPN and email on KeyUp event in edit AD user info interfaces.
17:Fixed error on Send email of Exchange reports in reports email scheduler tab.
18:Fixed 2 backups are taken instead of 1 in daily backup of control panel routine.
19:Fixed VM Move operation error.
20:Fixed unable to read user settings in AD user/Mailbox management.
21:Added Hyper-V 2025 Server support.
22:Fixed MAPI > RPC Over HTTP allowed, MAPI over HTTP allowed handling in Exchange Package and Addon Add/Edit. For old records need to update using KB https://kb.machsol.com/Knowledgebase/55746/Added-Setting-of-MAPIhttpEnabled-in-mailbox-features?Keywords=RPC-over-HTTP
23:REST API reports are updated, related entity Ids like MailboxId, OrganizationId, HostingId etc are added in relavent reports.
24:Organization Usage report export to Excel updated, templates as separate columns are removed if more then 250 columns in report.
25:Distribution List REST API methods updated, status is added and RequireSenderAuthentication handling corrected.
26:Fixed Soft delete mailbox re-appear as Active when Permanent Delete job being added/executed.
27:Added Audit Log entry on enabling ADUser from mailbox listing.
28:Added email search in REST API for Mailbox, Distribution List and Contact.
29:Handled error in contact update using REST API.
30:REST API updated for Service Queue actions.
31:Fixed error in update Server Group policy name length query.
32:Added Rocky Linux 9 and Debian 12 operating system support in VPS module.
33:Cannot find table 0 error fixed in bulk Distribution List creation.
34:Error on MachPanel licenses page related to int conversion fixed.
35:Mail Contact optional data in REST API updated to show full details from database.
36:Fixed Impersonate as Reseller not working when OAuth2 sis used for REST API.
37:Optimized Add AD User and Add Mailbox.
38:Fixed wrong Recieve and Send message size set when mailbox template is applied on template edit and a disabled mailbox is enabled.
39:Fixed error in transport rule creation due to problem in actions handling.
40:Permissions setting in Add Mailbox is made optional to improve Mailbox Add screen load time.
41:Expand disk handling updated for windows VM, now disk within VM expands too.
42:CSP module No Profile case tenant management handling updated.
43:Fixed AD bulk user Add/Edit not applying Password settings as specified.
44:Fixed SQL error in ADUser login.
45:Updated Public IP handling in VPS Subnet Pool management.
46:Help message updated and Password check on Shared Mailbox bulk create disabled.
47:Mailbox External forward hide handling added. Run script to hide: Update HB_tblExchangeOrganizationSettings Set HideExternalForwardingEmail = '1'
48:Added check to limit Ex Mailbox creation based on Templates sold to Hosting. Run script to enable feature: Update HB_tblExchangeOrganizationSettings Set LoadTemplatesBasedOnAddons = '1'
49:Fixed disabled ADUser gets enabled on Bulk ADUser operation.
50:Fixed error in update DL settings when a user is deleted or disabled.
51:Updated VPS package update Service Queue processing to update VM disk size.
52:Prov Svc crash on Control Server due to a missing method fixed.
53:Fixed error in Add Public NIC in VPS Module.
54:Fixed Custom Mailbox template appearing in edit mailbox when it is not allowed.
55:Fixed Sharepoint usage report not updating.
56:Fixed O365 Group members problem.
57:Fixed error "Operation failed. No active mailboxes to set in managed by setting." when no selectable manager in Distribution Group Advanced Settings save.
58:Fixed not showing member users listing in AD Security Group Add/Edit.
59:Fixed SQL connection leak issue in Exchange Calender Permission management.
60:Updated bulk mailbox add to avoid deadlock issue.
61:Fixed VPS addon setup changed RAM type.
62:Updated Exchange REST API methods to fix problem in Full Access and Get Mailbox.
63:Fixed ADSync password not getting updated each time.
64:Added Signed .ps1 files for Hyper-V custom ps1 files.
65:Error generated on suspected PS injection attack in Exchange module.
66:Fixed Move Customer gives error on CSP Subscription Move.

Procedure

Go to MachPanel configuration studio.
Shut down all the MachPanel services and also exit the configuration studio. Make sure no instance to MachPanel Configuration Studio is running under any user.

Download the hotfix 7360-30April2025HF.zip file from the link at bottom of this page.
Stop IIS Admin Service, please make sure that all the services are STOPPED from MachPanel Configuration Studio. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service.

MachSol.MachPanel.ConfigurationStudio.exe.

MachPanel Billing Service.

MachPanel Helpdesk Service.

MachPanel Network Service.

MachPanel License Service.

MachPanel O365 Service.

Replace files from MachPanel folder on MachPanel control server (Path: C:\Program Files\MachSol\MachPanel Control Server) and Replace files from Remote server folder of hotfix folder on MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) keeping the folder hierarchy same as it is in hotfix. (you should get message to overwrite files, if not you are not doing it right).
Execute script.txt (if it exists) from zip file on MachPanel_Db after logging in to SQL management studio as MachPanel_Db user.

Once all files are replaced properly from hotfix folder Restart all services related to MachPanel on Control as well as Remote Servers.

Download Link

https://www.machsol.com/Updates/7360/7360-30April2025HF.zip

Note: Please Unblock the files before replacing in installation directory if the downloaded Zip folder is blocked.

Error on Subscribing Customer to Exchange Subscription

rehan_waseem — Wed, 18 Sep 2024 07:50:47 GMT

Summary

This article provides solution to the issue which is faced in the Service Queue while subscribing customer to Microsoft Exchange subscription

Applies To

All Versions

Error Details

When customer is subscribe to Exchange subscription then it jobs gets failed inside the Service Queue with below error:

Error: c: Create Offline Address Book: Length Cannot be less than Zero

Resolution

Possible Cause of this Error is that the CAS Internal FQDN input in Exchange Server setting is not set properly.

As mentioned in below screenshot Comma separated list of CAS servers, like CAS1.Domain.com,CAS2.Domain.com. 1st server in list will be treated as default.

Make sure full FQDN is specified not just servername.

MachPanel Build v7.3.60 Release Notes (September 09, 2024)

rehan_waseem — Tue, 03 Sep 2024 20:16:07 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Note
Improvements/New Features
Resolved/Fix Issues

1. Important Prerequisites

Please follow the steps given below in sequence and execute instructions in the KB articles to complete the update:

Also, there are some SQL commands/scripts used since build 7.2.11 which are supported in SQL 2012 or later. So, it is required that you install SQL version 2017 or 2019 using below KB article

Installation guide for SQL 2017
- https://kb.machsol.com/Knowledgebase/53483/Installation-Guide-for-SQL-2017-Express-
Installation guide for SQL 2019
- https://kb.machsol.com/Knowledgebase/55737/Installation-Guide-for-SQL-Server-2019-

Once done, you have to move your MachPanel DB from old SQL instance to the newly installed SQL. For that you can follow below KB article

How to Move MachPanel MS SQL Database To Another New MS SQL Server (machsol.com)

2. Important Note

If you are using MachPanel Rest API, please follow link below to update to latest version of Rest API:

Update to Latest MachPanel REST API

3. Improvements/New Features

General (MachPanel, AD, ADSync, Billing, REST API):

KeyCloak Login Redirect - In case a different user is logged in to KeyCloak than the one in Panel.
Added option to configure exported Excel file extension to use .xls or .xlsx under Company Profile > Personalization.
Subscription List (Deleted subscription filters enhanced)
License information Report under Schedule Usage Report section
Log out the current session as well as all other open sessions for the same customer upon password change.
Added Recycle bin and Recovery records management using REST API.
Handle Login page broken issue - When Provider/Reseller impersonates as customer/contact and in another window deletes that customer and tries to reload the page.
Added mailbox size report under Exchange > Monitoring in customer portal.
Added auto deletion of linked AD Staff users which are removed from the Security Group in AD.
Export Invoices data using interface and REST API
Update Bulk AD Users - Added more columns in CSV file.
Added DUO Universal Prompt integration. (Configuration steps remain same)
Removed OWA Policy related resources from REST API calls as these are now managed using OWA Mailbox Policies interface.
Allow authentication via AD User associated with customer contacts.
Added option to Update User CN on UPN change automatically in Active Directory domain Add/Edit interface.
Updated DB Backup email handling, email is not sent to anyone if email is not configured.
Added handling to avoid Deadlock Victim error.
Verify if AD User password setting job sets value as needed, if settings from backend does not match, job fails, and re-try is done.
Audit Log listing performance improved by using paging at SQL Server.
Handled error in Export to Excel when XLSX format is used, and string field length exceed 255 characters.
Added OAuth for O365 support in HelpDeskParser

Microsoft Exchange:

Allowed to add Email Alias when Alias exists as UPN already.
Email Template Improvements
Bulk Import case sensitive - save UPN/Email aliases in lowercase when adding bulk users.
User Select on exact UPN - UPN should be the user's basic identifier, however that the display name may be repeated with multiple users.
Added new Attribute in AD - "Account Expiration"
Added filter (Disabled AD user, Enable AD user) under AD users listing, as it's already existed under Exchange Mailboxes.
Added export list option under AD users and Exchange mailbox.
Added exception to exclude distribution list from Disclaimer/under disclaimer settings.
Auto Disable/Enable Mailbox on ADUser Disable/Enable
Allow to Enable/Disable AD User for Shared/Resource mailbox.
Added an "Exclude" option in the Dynamic Distribution List during add/edit operations.
Add “Recipient Domain is:” in exception for disclaimer.
User selection in AD/Mailbox Group Actions is changed to match full UPN.
Set ABP as blank for mailbox optional handling added.
Allowed to edit Throttling template in Custom template under Organization management.
Updated handling for Message Copy setting in Mailbox Permissions for User Mailboxes.
AD User password settings job added if the setting is not getting applied in Create Mailbox for tracking and re-try.
On UPN change from AD User interface, new UPN is set as mailbox primary email.
Handled email aliases in ADUser, Mailbox, Groups group actions search filter.

Microsoft CSP/Office365:

Automatically cancel jobs related to O365 tenant sync, user sync, and licensing if tenant management is not enabled.
Implemented auto cancellation O365 jobs related to a tenant if tenant management is disabled.
Added Sync All users action in O365 User Group Operations
Enhanced O365 Subscription interface import feature to show Subscription Id.
Auto add .onmicrosoft alias in o365 handled.
Added optional field for Registration Id in O365 order form.

Microsoft VPS (Hyper-V):

IAM Role & Access Control per VM
Implemented VM Management REST API
Enhanced Hyper-V Server Group Setting (VM Storage Location)
Added permissions to manage VM Start, Stop, Suspend, Move actions.
Added NETBIOS Name in Virtual Machine Listing.
Added VPS location settings in Add/Edit Server in VPS Standalone Server Group.
Allowed multiple server groups assigned to Reseller plan in VPS module to reseller for customer subscription assignment.
Added CentOS7 under OS types in Hyper-V.
Bandwidth Quota display issue fixed in VPS module.
AlmaLinux 9.x version integration added under Hyper-V Linux OS.

4. Resolved / Fixed Issues

General (MachPanel, AD, ADSync, Billing, REST API):

Backup Notification emails will not be sent to default provider email if the email is removed from backup notification settings.
Error in displaying Control Server logs in Logs Explorer.
“About MachPanel” is removed from Customer and Reseller interface.
SSL setting display issue in Health > Compliance.
"Unable to cast object of type 'System' to type 'DataModels'" in ADUser certificate management.
Issue in Recycle Bin/Recovery showing unrelated Customer data.
Authentication as ADUser for Customer/Contact added for ADSync client.
Handled Primary server Health report not getting populated due to DB error.
Issue in MFA handling when Duo is configured.

Microsoft Exchange:

Mailbox Template not getting updated on Customer Move from 1 Reseller to another.
Login Disable users (Shared, Resource mailboxes) are skipped when adding Group Jobs for setting AD User Password Settings.
UPN and Email are set in lower case in Bulk Mailbox creation.
Issue in Mailbox Recycle Bin and Recovery handling fixed where Mailbox does not appear in Recovery.
Issue in Disclaimer add/edit due to Left and Right double quotation mark used in disclaimer body.
Set Password policy job cannot be added or processed for disabled users.
Mailbox quota not getting set to 0 on Disable ADUser from listing.
On UPN change additional email address is added but not being set as primary in exchange mailbox.

Microsoft CSP/Office365:

CSP Automation - Fixed error encountered when provisioning tenant for South Africa (where the TRN ID is missing).
GUID related error in O365 subscription import.
Object Reference error when updating a subscription quantity in O365.

Microsoft VPS (Hyper-V):

Wrong error message for VM permanent Delete
VM Disk Usage issue on Subscription limits when VM is imported in panel.
Error in VPS provisioning due to wrong table in stored procedure.
VHD archive on deletion not working as needed.
VM preview image not working.
No record found error in VPS Setup.
Quota value displayed for disk space on Add VPS screen.
Wrong OSName in VM listing.
Storage type issue in VM import.
Error in getting virtual switch in Cluster environment.
Enable-VMIntegrationService "Guest Interface" fails on hosts when using other than English language handled. Have to set correct name on Hyper-V Host machines in registry. The integration service name can be mentioned in registry path: SOFTWARE\MachSol\MachPanel, new string key: VMIntegrationServiceName, value: "Guest Service Interface". Update the value "Guest Service Interface" in desired Host Machine Language.
Changing password not working in Hyper-V Linux VM handling.
Old VM archive files not getting deleted.
VM remove in Single VM subscription cancellation.
Arithmetic operation error in VM import.
Hyper-V CentOS Password update issue fixed.
Issue in unselecting bandwidth tier associated to a customer's plan.
VPS Service Queue Suspend/Resume Entry Issue.

Duplicate records causing problem in AD Org Or User listing display

rehan_waseem — Wed, 28 Aug 2024 08:31:36 GMT

Summary

This article provides information about, how to fix the issue of AD organization or AD User listing due to duplicate records exists in the database.

Applies To

MachPanel v7 and above

Issue Details

We have optimized AD Org and User listings by pre-processing records and keeping them in new table. It should work for clients but at times clients have some garbage/duplicate records that can break things and error can be seen on AD Organization or AD User listing like below:

Resolution

Below queries can be used to find duplicates in ADUser and Mailbox table, have to remove and keep only 1 working record in specific table:

--Duplicate in ADirUsers, if found have to keep one record for 1 LDAP url.

Select * from HB_tblADirUsers
Where UserLDAPURL in
(
Select UserLDAPURL from HB_tblADirUsers
Where ADUserID not in (Select ADUserId from HB_tblADirUserGroupJobs Where StatusId not in (2,3))
and UserLDAPURL!=''
Group By UserLdapURL
Having Count(UserLDAPURL) > 1
)
order by UserLDAPURL asc
GO

--Duplicate in tblExchangeMailboxes against UserLDAP, if found have to keep one record for 1 LDAP url.

Select * from HB_tblExchangeMailboxes
Where UserLDAPUrl in
(
Select UserLDAPURL from HB_tblExchangeMailboxes
Where MailboxID not in (Select AccountId from HB_tblExchangeGroupJobs Where AccountType=0 and StatusId not in (2,3))
and UserLDAPURL!=''
Group By UserLdapURL
Having Count(UserLDAPURL) > 1
)
order by UserLDAPURL asc
GO

--Duplicate in tblExchangeMailboxes against ADUserId, if found have to keep one record for 1 ADUserId

Select * from HB_tblExchangeMailboxes
Where ADUserID in
(
Select ADUserID from HB_tblExchangeMailboxes
Where MailboxID not in (Select AccountId from HB_tblExchangeGroupJobs Where AccountType=0 and StatusId not in (2,3))
Group By ADUserID
Having Count(ADUserID) > 1
)
order by MailboxID asc
GO
Once all duplicates are removed, run below script:

Declare @RowsCount int
Set @RowsCount = 1
while @RowsCount != 0
Begin
                Exec CSP_UpdateHostedOrgExtendedData
                Set @RowsCount = @@ROWCOUNT
End
GO

Declare @RowsCount int
Set @RowsCount = 1
while @RowsCount != 0
Begin
                Exec CSP_UpdateHostedUserExtendedData
                Set @RowsCount = @@ROWCOUNT
End
GO

Important: Rules to follow when deleting from aduser:

If AdUser has 2 different CustomerId, keep the record which has highest value for ADUserId.
If CustomerId is same, check for ADUserid in Mailbox table, keep record which is in mailbox table.
- If no enterprise service enable on ADUser, keep latest record.

MachPanel Knowledgebase

Hotfix for MachPanel Build v8.2.50 HF Updated (April 10, 2026)

Summary

Applies To

Important Note

Latest Issues Fixed

Procedure

Download Link

Logging on Hyper-V Remote Server

AttachVHDLog_<date>

JobProcessingLog_<date>

ProvSvc-RemoteConfigurationStudio_<date>

Prov_SVC_<date>

Remote_<date>

Remote configuration Studio_<date>

VPS_<date>

VMUsageStateLog

VMUsageState

PFSense Deployment & Integration Prerequisites (Hyper-V Environment)

Summary

Applies To

Overview

1. PFSense Deployment on Hyper-V

2. Network Interface Configuration

3. REST API Configuration (for MachPanel Integration)

4. Virtual Switch & Interface Alignment

5. Trunk Configuration

6. High Availability Considerations

MachPanel Cloud Networking - Software Defined Network Integration for pfSense

Summary

Applies To

Overview

Key Features

Pre-Requisites​

MachPanel Cloud Networking / pfSense Configuration

Dynamic IP Assignment to VM (Backend Managed)

Summary

Applies To

Overview

Key Concept

Subnet Pool Configuration

VM Replication Support Handling in MachPanel

Summary

Applies To

Overview

Key Features

Server Group Configuration

Server Configuration

VM Provisioning Behavior

Auto Detection of VM Location

MachPanel Build v8.2.50 Release Notes (April 02, 2026)

Content

1. Important Prerequisites

2. Important Notes

3. Major Enhancements

4. Improvements/New Feature

5. Resolved / Fixed Issues

CSP Grant Consent Error

Summary

Applies to

Issue Details

Resolution

Hotfix for MachPanel Build v8.1.22 HF Updated (March 27, 2026)

Summary

Applies To

Important Note

Latest Issues Fixed

Procedure

Download Link

MachPanel Build v8.1.22 Release Notes (December 08, 2025)

Content

1. Important Prerequisites

2. Important Notes

3. Major Enhancements

4. Improvements/New Feature

5. Resolved / Fixed Issues

Hotfix for MachPanel Build v8.0.50 HF Updated (November 06, 2025)

Summary

Applies To

Important Note

Pre-Requisites