MachPanel Knowledgebase

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.

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

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.

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.

MachPanel HelpDesk Configuration using OAuth based POP Account

zohaib.shaikh — Wed, 15 May 2024 10:19:40 GMT

Summary

This article provides information about configuring the OAuth based POP Account in Office365 to be used in MachPanel HelpDesk.

Applies To

MachPanel v7.2.30 & above.

Pre-Requisites

New service is configured as per article below:

https://kb.machsol.com/Knowledgebase/55775/Remove-MachPanel-HelpDesk-Service-and-Add-it-with-updated-source-path

Procedure

In order to use an Office 365 / Microsoft 365 mailbox for email parsing by the Help Desk, you need to configure it in MachPanel:

Once done, the control panel will be able to parse emails and covert them to new tickets or add them to existing tickets (based on sender and email title / subject).

First you must configure the backend account in Office 365 / Microsoft 365. After that you will need to configure the MachPanel Control Panel HelpDesk using the configured account.

Step 1: Account configuration in Office 365 / Microsoft 365:

Please follow steps below to configure email account on Office 365 / Microsoft 365:

Step:1	Register your application in Azure Portal
Step:2	Add permissions to your application. Select APIs my organization uses and search for “Office 365 Exchange Online click Application permissions: Grant admin consent:
Step:3	Create an application secret in Certificates & secrets
Step:4	Use Windows PowerShell on your machine to Register service principals in Exchange. Set-ExecutionPolicy RemoteSigned Install-Module -Name ExchangeOnlineManagement Import-Module ExchangeOnlineManagement Connect-ExchangeOnline -UserPrincipalName your-admin-account@your-domain.onmicrosoft.com New-ServicePrincipal -AppId <APPLICATION_ID> -ServiceId <OBJECT_ID> [-Organization <ORGANIZATION_ID>] You can find ApplicationId and ObjectId in Enterprise applications in your application’s Overview panel
Step:5	Add permissions to a specific mailbox: Add-MailboxPermission -Identity USER@your-domain.onmicrosoft.com -User <OBJECT_ID> -AccessRights FullAccess Where -User is Object ID of the App your created.

Step 2: MachPanel HelpDesk configuration:

Once the backend configuration is done, please add the details in MachPanel, scroll down and hit save:

Remove MachPanel HelpDesk Service and Add it with updated source path

rehan_waseem — Wed, 15 May 2024 08:53:47 GMT

Summary

This article provides information about removing and adding the "MachPanel HelpDesk Service" to run from updated path.

Old Path: "C:\Program Files\MachSol\MachPanel Control Server\Apps\HelpDeskService\MachSol.MachPanel.HelpDesk-Svc.exe"

New Path: "C:\Program Files\MachSol\MachPanel Control Server\Bin\MachSol.MachPanel.HelpDesk-Svc.exe"

Applies To

MachPanel v8 & above.

Pre-Requisites

Need to install Microsoft .Net Framework 4.8 on ControlServer(applies to MachPanel version 8.0.32 or later)
- 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.

Procedure

Open the Command Prompt with "Run as administrator" option:

Remove Existing "MachPanel HelpDesk Service" using commands below:

Stop the service:

SC STOP MachPanel_HelpDesk_Svc

Wait for few seconds for the service to stop, then delete service using command below:

SC DELETE MachPanel_HelpDesk_Svc

Add "MachPanel HelpDesk Service" again using commands below:

Add the service again using commands below:

SC CREATE MachPanel_HelpDesk_Svc binPath= "C:\Program Files\MachSol\MachPanel Control Server\Bin\MachSol.MachPanel.HelpDesk-Svc.exe" DisplayName= "MachPanel HelpDesk Service" start= auto

SC  Description MachPanel_HelpDesk_Svc "MachPanel service for generating Tickets."

SC START MachPanel_HelpDesk_Svc

Verify that the service is added and running under Services.

Hotfix for MachPanel Build v7.3.20 HF Updated (Sept 6, 2024)

zohaib.shaikh — Wed, 27 Mar 2024 07:02:06 GMT

Summary

This article provides 7.3.20 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.20 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.20 HF Updated: Sept 6, 2024

1: Fixed error in displaying Control Server logs in Logs Explorer.
2: About MachPanel is removed from Customer and Reseller interface.
3: Added update CN on UPN change in Add Active Directory.
4: Fixed SSL setting display issue in Health > Compliance.
5: Fixed On UPN change additional email address is added but not being set as primary in exchange mailbox.
6: Enhancement: On UPN change from AD User interface, new UPN is set as mailbox primary email.
7: Fixed error in VPS provisioning due to wrong table in stored procedure.
8: Fixed VHD archive on deletion not working as needed.
9: Fixed VM preview image not working.
10:Added VPS location settings in Add/Edit Server in VPS Standalone Server Group.
11:Fixed "Unable to cast object of type 'System' to type 'DataModels'" in ADUser certificate management.
12:Implemented auto cancellation O365 jobs related to a tenant if tenant management is disabled.
13:Added Sync All users action in O365 User Group Operations.
14:Enhanced DB Backup email handling, email is not sent to anyone if email is not configured.
15:Fixed issue in Recycle Bin/Recovery showing unrelated Customer data.
16:Added CentOS7 under OS types in Hyper-V.
17:Auto add .onmicrosoft alias in o365 handled.
18:Fixed quota value displayed for disk space on Add VPS screen.
19:Enhanced O365 Subscription interface import feature to show Subscription Id.
20:Fixed Object Reference error when updating a subscription quantity in O365.
21:UPN and Email are set in lower case in Bulk Mailbox creation.
22:Allowed multiple server groups assigned to Reseller plan in VPS module to reseller for customer subscription assignment.
23:Issue in Mailbox Recycle Bin and Recovery handling fixed where Mailbox does not appear in Recovery.
24:Fixed issue in Disclaimer add/edit due to Left an Right double quotation mark used in disclaimer body.
25:Fixed GUID related error in O365 subscription import.
26:Bandwidth Quota display issue fixed in VPS module.
27:Authentication as ADUser for Customer/Contact added for ADSync client.
28:User selection in AD/Mailbox Group Actions is changed to match full UPN.
29:Added optional field for Registration Id in O365 order form.
30:Handled Primary server Health report not getting populated due to DB error.
31:Fixed no record found error in VPS Setup.
32:Handled email aliases in ADUser, Mailbox, Groups group actions search filter.
33:Added handling to avoid DeadLock Victim error.
34:AD User password settings job added if the setting is not getting applied in Create Mailbox for tracking and re-try.
35:Verified if AD User password setting job sets value as needed, if settings from backend does not match, job fails and re-try is done.
36:Improved handling to avoid DeadLock Victim error.
37:Wrong OSName in VM listing fixed.
38:Audit Log listing performance improved by using paging at SQL Server.
39:Handled error in Export to Excel when XLSX format is used and string field lenght exceed 255 chars: The field is too small to accept the amount of data you attempted to add. Try inserting or pasting less data. 250 chars wil be exported.
40:Fixed Storage type issue in VM import.
41:Fixed error in getting virtual switch in Cluster environment.
42:Updated handling for Message Copy setting in MB Permission for User Mailboxes.
43:Fixed issue in MFA handling when Duo is configured.
44:Enable-VMIntegrationService "Guest Interface" fails on hosts when using other then 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.
45:Fixed changing password not working in Hyper-V Linux VM handling.
46:Fixed Mailbox Template not getting updated on Customer Move from 1 Reseller to another.
47:Login Disable users (Shared, Resource mailboxes) are skipped when adding Group Jobs for setting AD User Password Settings.
48:AlmaLinux 9.x version integration added under Hyper-V Linux OS.
49:Fixed old VM archive files not getting deleted.
50:Fixed VM remove in Single VM subscription cancellation.
51:Handled DeadLock error in AD module.
52:Set ABP as blank for mailbox optional handling added.
53:Set Password policy job cannot be added or processed for disabled users.
54:Fixed arithematic operation error in VM import.
55:Hyper-V CentOS Password update issue fixed.
56:Mailbox quota not getting set to 0 on Disable ADUser from listing fixed.
57:Allowed to edit Throttling template in Custom template under Org management.
58:Fixed issue in unselecting bandwidth tier associated to a customer's plan.
59:VPS Service Queue Suspend/Resume Entry Issue Fixed.60:Fixed Templates change not retained in Edit Exchange Resources.

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 7320-6SeptHF.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/7320/7320-6SeptHF.zip

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

MachPanel Build v7.3.20 Release Notes (March 20, 2024)

rehan_waseem — Tue, 12 Mar 2024 21:03:03 GMT

Content

Important Prerequisites/Upgrade Instructions
Improvements/New Features
Resolved/Fix Issues
Known 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. Improvements/Enhancements/New Features

General (Configuration Studio, AD, ADSync, REST API, Help Desk):

Panel Health Report added.
MachPanel password restrictions removed on integrating AD, Server password and service like DNS configuration, confirm password removed.
Added "Update User CN on UPN Change" in AD Domain Settings to auto update CN when UPN is updated. (It is handled in thread AutoAddUsersInSecurityGroupWork, which runs normally in 1 minute, so if the option is enabled, updating CN on UPN change should get processed in few minutes.)
Assign/Unassigned Certificates to AD User in Active Directory Organization Management.
AD user attributes validation each input according to AD limits.
Added drop-down of over used resource in Quota Overused Report
Added kill session option in Config Studio if Access Control Limit Sessions is in use.
Addon and Misc product Quantity is displayed in Service Queue.
Added "Read Only" permission for staff user.
Added Ability to hide (Password Setting) from Staff users’ interface for AD user / mailbox
Improved Remove and Recover Mailbox flow. Added option to show "Recovery" section to end customer so they can fully remove mailbox themselves and recreate if required. Normally Provider has to remove deleted mailbox from recovery.
Added link for backup removal in Configuration Studio
Added "Date From" and "Date To" filter in Mailbox Recovery.
Added Email Notice for Domain Verification Success
Invoice Reminder email template has been added.
IP based filtering for redirecting users to MachPanel Login Page when KeyCloak SSO is enabled.
Added permission to hide Service Director > General section from Reseller/Customer via Access Template\Permissions.
Set Send/Receive Message to 0 when Mailbox/AD user is disable.
Updated Russian translation.
Added Language Header for REST API Reporting end points.
Recycle bin days setting increased to 120 days.

Exchange:

OWA policy management handled on Server Group and Organization level.
Set as primary domain feature enhanced in Exchange module, Automatic domain alias replacement/addition handled.
Export Members option added for Distribution List and Dynamic Distribution List members listing.
Added Hyperlink to “Send Connector for Relay Accepted Domains” on error (associate Smart Host).
Added Recovery DB creation, mount, unmount feature.
Added more details in Audit Logs > Event Logs for Exchange.
Group Action - Add CSV option.
Added configuration to enable/disable Mailbox FirstName, LastName is required or not in Exchange Organization Global Settings
AccountOnly option added in Clear-MobileDevice command to remove Exchange Mailbox Data only.
Transport rules management is allowed to provider admin only.
Shared Mailbox Quota handling improved.

VPS (Hyper-V):

Delay for OS initialization handled in VPS provisioning.
Added Hyper-V usage report in REST API

CSP

GDAP Support added in CSP module: https://learn.microsoft.com/en-us/partner-center/gdap-introduction
Added Exchange Hybrid and ADSync enabled resources in CSP package.
Auto extend default admin relationship for CSP partner is handled.

3. Resolved / Fixed Issues

General (Configuration Studio, AD, ADSync, REST API, Help Desk):

Title getting blank when not being changed in bulk edit user.
Customer Id missing in API
Unverified domain hidden from alias creation.
Load Balancer files update and service restart issue on secondary server.
Error in creating ADUser when no customer is selected.
Error in Sync AD user when manager does not exist on Hosted AD. Manager will get skipped if related user not found in Hosted AD.
Error in Add/Edit Workflow.
Mail.dll license issue in Helpdesk parser.
Error in inserting Access template.

Exchange:

Fixed error with retaining values for Exchange Org Management -> Rules -> Transport Rules -> add/edit rules.
Exchange Error "Some required parameter(s) missing when creating mailbox using AD interface".
Mailbox quota display issue in edit mailbox.
Mailbox column missing in Mailbox Report fixed.
CustomerId is not returned in Mailbox Usage report for resellers.
Mailbox Template Clone issue.
Template selection not visible when enabling Mailbox or existing AD Users.
SQL timeout error in Apply Mailbox Template.
UPN edit not allowed if Customer Permission does not allow Email Address Management for Mailbox.
Org password policy defaults not getting set on Bulk Mailbox creation.
Distribution List member not added in backend for some jobs occasionally.
Exchange other reports not working from client side.
Password settings not getting applied if Password settings management is not allowed to customer or mailbox is enabled for existing AD User.
Cannot cancel pending job of Add Mailbox Permission

VPS (Hyper-V):

VM delete Job stuck in group jobs when it is the action perform after Move operation.
The stats are missing when click on “Virtual Machine hosting” link.
VM hosting product >> mark “Dynamic RAM settings additional label" as required
Error on virtual processor more than 256.
Storage type not retained in edit package.
Single VM IPs selection issue when NIC is removed and being added again.
Additional disk creation not working in Hyper-V.
'Object Reference' error When logged in as Reseller and then Edit the Virtual Machine service plan of the Reseller’s End Customer.
Import VM for Reseller

Hotfix for MachPanel Build v7.2.35 HF2 Updated (March 07, 2024)

zohaib.shaikh — Wed, 06 Dec 2023 11:07:34 GMT

Summary

This article provides 7.2.35 HF2 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.2.35 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.2.35 HF2 Updated: March 07, 2024

1: Added Language Header for REST API Reporting end points.
2: Fixed CustomerId is not returned in Mailbox Usage report for resellers.
3: -AccountOnly option added in Clear-MobileDevice command to remove Exchange Mailbox Data only.
4: Fixed Mailbox Template Clone issue.
5: Fixed Exchange Error: Some required parameter(s) missing when creating mailbox using AD interface.
6: Fixed error in creating ADUser when no customer is selected.
7: Addon and Misc product Quantity displayed in Service Queue.
8: Fixed error in Sync AD user when manager does not exists on Hosted AD. Manager will get skipped if related user not found in Hosted AD.
9: Updated Russian translation.
10: Fixed error in Add/Edit WorkFlow.
11: Fixed Mailbox quota display issue in edit mailbox.
12: Mailbox column missing in Mailbox Report fixed.
13: Fixed Mail.dll license issue in HelpDesk parser.
14: Fixed SQL timeout error in Apply Mailbox Template.
15: Fixed template selection not visible when enabling Mailbox or existing AD Users.
16: Fixed error in inserting Access template.
17: Fixed O365 Tenant provisioning fails due to new GDAP implementation.
18: Fixed Load Balancer files update and service restart issue on secondary server.
19: Auto extend default admin relationship for CSP partner handled.
20: Fixed Org password policy defaults not getting set on Bulk Mailbox creation.
21: UPN edit not allowed if Customer Permission does not allow Email Address Management for Mailbox.
22: Recycle bin days setting increased to 120 days.
23: Delay for OS initialization handled in VPS provisioning.
24: Fixed Title getting blank when not being changed in bulk edit user.
25: Transport rules management is allowed to provider admin only.
26: Fixed error on virtual processor more than 256.
27: Fixed Storage type not retained in edit package.
28: Fixed Single VM IPs selection issue when NIC is removed and being added again.29: Fixed Password settings not getting applied if Password settings management is not allowed to customer or mailbox is enabled for existing ADUser.30: Unverified domain hidden from alias creation.31: Fixed Exchange other reports not working from client side.32: Fixed additional disk creation not working in Hyper-V.33. Fixed DL member not added in backend for some jobs occasionally.34. Fixed 'Object Reference' error When logged in as Reseller and then Edit the Virtual Machine service plan of the Reseller’s End Customer.

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 7235-7MarchHF2.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/7235/7235-7MarchHF2.zip

MachPanel Configuration Studio

zohaib.shaikh — Tue, 21 Nov 2023 07:09:23 GMT

Summary:

This article is an illustration showing how to use MachPanel Configuration Studio utility. It will help you carry out initial setup and essential configuration settings as required. Please carefully follow this article to understand the benefits and usage of Configuration Studio.

Applies To:

Applies to v7 and above.

MachPanel Control Server Configuration Studio

Home:

Home Page will give you information about Application and the version installed.

System Database:

This interface will show the SQL database server instance name connected with MachPanel. Database settings can be Updated from this interface and 'Test Connection' with the database can be performed

Control Panel Website:

From this interface you can configure your MachPanel Website. For website configuration please review below KB article:

https://kb.machsol.com/Knowledgebase/52396/Binding-SSLCertificate-on-the-IIS-Website

Provider Login/Password:

The credentials for the provider can be updated/reset from this interface.

Provider Login: Contains the login (email) you use to authenticate with the MachPanel Control Server as SUPER USER.
Provider Password: Contains the password you use to authenticate with the MachPanel Control Server.
New Password: Enter the new password if you want to change the existing password that is used for authentication.
Confirm Password: Re-enter the new password for confirmation.
Change Password: Press this button for change password effect to take place.
Session Management: Option to Kill Provider Sessions, Kill All Sessions. Appears if respective section for Session Management is enabled in control panel.

Software Updates:

Latest Update of MachPanel can be downloaded by clicking 'Check Available Updates'

Update can be configured using the below settings

Manual updates can also be performed by specifying the update URL

IP Binding:

You can bind the IP of your server with MachPanel using the below interface

Services:

This interface shows the MachPanel services running on this server. You can Stop and Restart the service(s) from this interface

Software Backup:

Configuration related to software backup (Control Panel Files and Database backup) can be set from this interface. Also, you can take instant backup by clicking 'Take Backup Now'
You can also Configure DB files removal on SQL server.

About MachPanel:

This interface show the license term related information about the MachPanel software

MachPanel Remote Server Configuration Studio

Home:

Home Page will give you information about Application and the version installed.

Remote Server Binding:

Using this interface you can bind the IP of your server with MachPanel Remote Server using the below interface. There can be multiple IPs on a server. The IP that is set in binding will be used by the remote server and MachPanel control server will communicate with remote server using port 7860 on this IP.

Remote Service Credentials:

This interface will show the user under which MachPanel Provisioning Service is running on this Server. The service can be started/stopped and restart from this interface

Update:

Latest Update of MachPanel can be downloaded by clicking 'Check Available Updates'

Update can be configured using the below settings

Manual updates can also be performed by specifying the update URL

About:

This interface show the license term related information about the MachPanel software

MachPanel Build v7.2.35 Release Notes (November 29, 2023)

mudesira.munir — Mon, 20 Nov 2023 22:12:59 GMT

Content

Important Prerequisites/Upgrade Instructions
Important Note
Improvements/New Features
Resolved/Fix Issues
Known 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 recommended 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, Store, API, Help Desk):

Updated command parameter from -LocalizeDefaultFolderName to -LocalizeDefaultFolderName:$True. This way the problem with newly created mailboxes that do not have localized folder names has been resolved.
Removed Server Details from error on Customer interface.
REST API will be installed along with the Installation of MachPanel Control Server
Updated Config Studio UX/UI
Updated Remote Config Studio UX/UI
Information will not be cleared in Test Service [ test service via MP].
Option to Hide HelpDesk Module from Customer Control Center via Access Templates.
Customizable setting for EU VATId country verification added.
OAuth 2 authentication enabled for REST API
Security Group as a member of Security Group does not sync to Hosted AD
Add new Security Group via Active Directory service plan while selecting existing OU for e.g. Exchange.
SOAP API calls are updated to return data labels in English
Improved Auto Login feature for PHP/WHMCS using OpenSSL Encrypt
Select User using CSV in AD Users Group Actions
Updated ADSync Config Studio UI

Microsoft Exchange:

Updated mailbox features UI and handling under Group Actions, now allows selected permissions to be changed.
PasswordLastSet is added in AD User Report and Mailbox usage report
First and Last name fields are added as mandatory in new mailbox form.
Company Field is added in Active Directory User's Group Actions
Display name, Email, Department, Job Title, Mobile number, Manager,..field are added in Mailbox Usage Report.
Option added to Deny Access to Mobile Devices under Mailbox Settings.
Personal Archive quota and usage details are added in Exchange usage reports.
Added EWS Access feature in mailbox template
Option added to Sync Mailbox from Backend without doing Full organization Sync.
Limit for text input added for Disclaimer and Signature.
Added Transport Rules in Exchange Management
Option added to change Mailbox type under Group Actions.
Updated DAG handling in Exchange Databases.
Template field added in Bulk Mailbox CSV input.
Updated Additional Setting as required while adding Exchange Server Group

Microsoft CSP/Office365:

MachPanel installer now installs O365 service by default.
O365 subscription status reported by API is updated to match display status
Enhancement added to re-verify direct routing.
Add DL using CSV added in CSP Module under "Groups".
Added Room Mailbox External Meeting settings management

Microsoft VPS (Hyper-V):

Customizable Delay for OS initialization after 1st boot added in sealed image settings.
Shielded VM management is added under Setup.

4. Resolved / Fixed Issues

General (MachPanel, AD, ADSync, Billing, Store, API, Help Desk):

Fixed - Provisioning service restarts every few minutes in load balanced setup environment due to manage_session.dat file.
Fixed - CustomerId invalid when getting Subscriptions from Ingram Micro API against Customer.
Fixed - DigiCert package page break when API settings are invalid.
Fixed - AD Org sync from backend does not handle Sub OU structure as needed.
Fixed - Wrong message on update reseller password REST API call.
Fixed - Template clone feature in REST API.
Fixed - Mailbox create issue when using template in REST API.
Fixed - Reset Authenticator not working.
Fixed - Conflicting users created during mailbox provisioning.
Fixed - White label does not accept '-'
Fixed - Issue with API Response
Fixed - Issue in display of User Usage report in AD module

Microsoft Exchange:

Fixed - Mailbox interface loader image does not work when user comes from Mailbox Manager screen.
Fixed - Object Reference error in Sync Exchange from backend.
Fixed - RPC over HTTP handling display issue.
Fixed - Variables are not getting replaced in Exchange Signatures.
Fixed - Error in Add/Edit Ex server group member: Remoting exception: 'UpdateInDb': Update failure in query: SPR_UpdateExSGMemberActiveConnections N'0', N'1'.
Fixed - Error creating mailbox when Standard template is selected.
Fixed - CSV for BULK Contact Creation(Russian)
Fixed - Issue in RPC over HTTP allowed and MAPI over HTTP allowed handling in creating and editing mailbox.
Fixed - Wrong aliases added against mailbox during sync organization from backend, need to run sync Organization data from backend for affected Organization after update.
Fixed - Soft Delete settings not applied on Mailbox deletion with AD User.
Fixed - MB template assignment using Mailbox group actions transaction issue.
Fixed - Wrong UPN Suffix assigned when organization have more than 1 suffix in add bulk AD users.

Hostmatic/Shared/Web Hosting:

Fixed - DNS Test Service Anomaly

5. Known Issues

On updating Remote Configuration studio to 7.2.35 following error appears:

"Unable to start Update Installer. Details: StartIndex cannot be less than zero. Parameter name: startIndex"

You can either download following "Remote configuration studio.exe" and place in MachPanel remote server (C:\Program Files\MachSol\MachPanel Remote Server) and perform Auto update on remote server.
Or you can perform Manual Update.
- Download: http://www.machsol.com/updates/remote/7235/update.zip
- Right Click the downloaded file, got o "Properties", "Unblock" then hit "Ok" if the file is blocked.
- Stop MachPanel Provisioning Service, exit Remote config studio from task bar (or end task from task manager).
- Copy all files from folder "Files" into folder C:\Program Files\MachSol\MachPanel Remote Server.
- Restart MachPanel Provisioning Service.

Update MachPanel REST API (Updated 8 September 2025) for MachPanel Build 8.0.50

zohaib.shaikh — Thu, 15 Jul 2021 10:46:07 GMT

Summary

This article guides how to update MachPanel REST API

Prerequisites

MachPanel REST API is configured already (How to configure?)

Important Note:

Update MachPanel REST API (Updated 08 September 2025) for build version 8.0.50

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.

Update process

Please download Latest RESTAPI.zip from below link, unzip, and replace the existing files with these updated files

Note: If you downloaded and configured MachPanel REST API After September 9th, 2025, then this update is already included.

Link: https://www.machsol.com/updates/8050/MachPanel/RESTAPI.zip

Provisioning Service Crash - Verify using Builtin Logging and ProcDump

zohaib.shaikh — Mon, 09 Oct 2017 08:01:24 GMT

Summary

This article explains what to do for identifying cause of Provisioning Service Crash. Explains how to check details using built in logging and using Microsoft ProcDump tool to track down service crash.

Applies To

This article applies to all build versions of MachPanel

Provisioning Service Crash identification using built in logs:

Enable Advanced Logging from control panel by navigating to "Home > System Configuration > Logging":

Enable logging for all threads from link below:

Stop All MachPanel Services (especially MachPanel Provisioning Service).

Set MachPanel Provisioning Service to NOT auto restart (disable recovery options if enabled).

Archive All existing logs from "Logs" folder under the installation directory to some other folder so that you have only fresh logs to review.

Start All MachPanel Services (especially MachPanel Provisioning Service).

Start ProcDump for MachPanel Provisioning Service (as per details below)

Monitor log files and ProcDump until next crash. Check what was the last process/thread being executed just before crash.

Most Importantly: There shall be "prov-svc-unhandledexception" log file in "logs" folder after crash. If this file is created, check and share with support team along with details of "ProcDump" screen (where details about process are shown just before crash).

Provisioning Service Crash identification using ProcDump

For tracking down the reason for a service crash ProcDump tool is helpful. This can be accomplished through use of the Microsoft ProcDump tool to show problematic event automatically when the service crashes.

Instructions:

Download ProcDump from http://technet.microsoft.com/en-ca/sysinternals/dd996900.aspx
Unzip the package to C:\ProcDump
Open a command prompt
Browse to c:\ProcDump (CD C:\ProcDump)
After this, run the following command: ProcDump -e 1 -f "" MachSol.MachPanel.Provisioning-Svc.exe
When service crashes, do copy and share full output from command window.

The command prompt must remain open, and you must not log out of windows. When the service crashes, it will stop at the crash event and the last few commands before crash will help us identify the issue.

MachSol Software Downloads (MachPanel Control Server, Remote Server, ADSync and MachSync)

zohaib.shaikh — Wed, 20 Nov 2013 22:10:31 GMT

Summary

This article provides details on how to download different MachSol Software installers like MachPanel Control and Remote Servers, ADSync Installer and MachSync Installer etc..

Applies To

This article applies to MachPanel Control, Remote, ADSync and MachSync.

Download Installers for MachPanel Control and Remote Agents, ADSync and MachSync:

Visit https://www.machsol.com and click on "Sign In" from top right of home page.
Sign-Up to create an account or Sign-In with your existing account to purchase or test/trial MachPanel Products.

*Do note that you will need to setup and use 2FA method for login. Otherwise you will not able to login into the Customer Portal.

You need to provide registered "Email ID" with MachSol Inc. which is also known as Primary Contact. (Emailid@Yourdomain.com). Enter your details and click on Login. You can also reset password by clicking on Forgot Password.

To Download MachPanel installers, please navigate to Billing $ Subscriptions >> Downloads and click on link to download installer you need.

To Download MachSync installer, please navigate to Billing $ Subscriptions >> MachSync. You will be able to Download MachSync Installer or Manage your existing MachSync Licenses.

Important Note: Please contact MachSol Sales team to purchase your desired modules as the links to download are only visible to Primary Contact (which is a registered contact at MachSol) if license is purchased or trial is activated (in case of MachSync). After purchase the sales team will enable download.

More Information

After download, please use the information on KB links given below for installation and configuration.

Installation of MachPanel Software

Installation of ADSync

ADSync Installation Guide

Installation of MachSync

MachSync Installation Guide