MachPanel Knowledgebase

ADSync Utility Update to v6.1 (Updated 15 July 2025)

mudesira.munir — Tue, 21 Nov 2023 06:12:06 GMT

Summary

This article provides information on how to update ADSync tool to latest v6.1

Applies To

This article applies to ADSync v4.3 or v5.0 or v5.1

Procedure To Update:

You can directly update from v4.3/v5.0/v5.1.0.0 to v6.1 using this update.

You will need to download the ZIP file from link given at bottom of this article, Ensure the Zip file is "Unblocked"/"Unlocked" by checking from file Properties. Then Extract and use the appropriate x64 or x86 files based on your server OS.

There are two options:

a. Auto update: If you want to let the update process run automatically, please run ADSync.UpdateInstaller.exe from the extracted files. Please use "Run as Administrator" option. It will perform couple of reboots on its own to complete the update. Also, you need to run registry file (ADSync.PolicyLogger.reg) from update directory once update process is completed.

b. Manual update: To Update manually please follow below steps:

Remove entry “ADSyncPolicy” from “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Reboot Domain controller.
Replace “ADSyncPolicy.dll, ADSync.PolicyLogger.dll and ADSync.ClientHelper.dll” files in "$windir\System32".
Stop ADSyncSvc using Services.
Replace "ADSync.ClientHelper.dll, ADSync.ConfigStudio.exe and ADSyncSvc.exe" in installation folder of ADSync
Example "C:\Program Files\MachSol\ADSync".
Add entry “ADSyncPolicy” to “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Double click or run “ADSync.PolicyLogger.reg” file to update the linked assembly version in windows registry.
Reboot the machine.
Repeat Step 1-8 for all additional/secondary/backup domain controllers.

Improvements / New Features

Updated ADSync Configuration Studio UI
Purge Logs Feature after selected number of days
Resync Option to sync all users/groups regardless of their previous sync state.
Captured password hashing improvement.
Other performance related improvements.
Auto Create new option is dependent on ‘Auto Mapping’. In fact it is extension of Auto Mapping where system automatically creates new user on hosted side.
UPN in hosted user's display in mapping screen
Auto Mapping on Exact Display Name when there's only one hosted user matches Display Name.

Home Page:

Settings:

Profiles:

Sync:

Sync button will only sync recently updated groups/user data.

Resync:

Resync will sync all users/groups data (Just like from beginning). Doesn't matter that the user/groups is recently updated or not.

Download link for ADSync Update Files: ADSync v6.1 (15 July 2025)

ADSync Utility Update to v5.1.0.0 HF2 (Updated 14th September 2023)

rehan_waseem — Thu, 27 Jan 2022 18:18:31 GMT

Summary

This article provides information on how to update ADSync tool to latest v5.1.0.0 HF2

Applies To

This article applies to ADSync v4.3 or v5.0

Procedure To Update:

You can directly update from v4.3/v5.0 to v5.1.0.0 HF2 using this update.

There are two options:

b. Manual update: To Update manually please follow below steps:

Remove entry “ADSyncPolicy” from “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Reboot Domain controller.
Replace “ADSyncPolicy.dll, ADSync.PolicyLogger.dll and ADSync.ClientHelper.dll” files in "$windir\System32".
Stop ADSyncSvc using Services.
Replace "ADSync.ClientHelper.dll, ADSync.ConfigStudio.exe and ADSyncSvc.exe" in installation folder of ADSync
Example "C:\Program Files\MachSol\ADSync".
Add entry “ADSyncPolicy” to “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Double click or run “ADSync.PolicyLogger.reg” file to update the linked assembly version in windows registry.
Reboot the machine.
Repeat Step 1-8 for all additional/secondary/backup domain controllers.

Improvements / New Features

Custom sync attribute for user sync
Security update to clear renewed password from cache on data upload.
User mapping screen/UI load time optimizations.
Configurable active directory user’s attribute for storage of sync information (previously it was fixed to ‘division’ attribute).
Clearance of stored password hash from cache (storage attribute) once data is uploaded to the hosted CP.
User mapping restricted on the basis of UPN only. (Previously it was considering display name too for mapping. It was causing mismatched mappings, hence removed).
Changed error message with more user friendly one when wrong admin credentials are specified.

Resolved / Fixed Issues

Handled error when there is no object in the OU selected for Sync in Client AD.

Download link for ADSync Update Files: ADSync v.5.1.0.0 HF2

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

ADSync Utility Update to v5.0

rehan_waseem — Fri, 11 Jun 2021 13:39:16 GMT

Summary

This article provides information on how to update ADSync tool to latest v5.0

Applies To

This article applies to ADSync v4.3

Procedure To Update:

a. Auto update: If you want to auto-update, please run ADSync.UpdateInstaller.exe, please use "Run as Administrator" option.

Also, you need to manually run registry file (ADSync.PolicyLogger.reg) from update directory once update process is completed.

b. Manual update: To update manually please follow below steps.

Remove entry “ADSyncPolicy” from “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Reboot Domain controller.
Replace “ADSyncPolicy.dll, ADSync.PolicyLogger.dll and ADSync.ClientHelper.dll” files in "$windir\System32".
Stop ADSyncSvc using Services.
Replace "ADSync.ClientHelper.dll, ADSync.ConfigStudio.exe and ADSyncSvc.exe" in installation folder of ADSync
Example "C:\Program Files\MachSol\ADSync".
Add entry “ADSyncPolicy” to “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Double click or run “ADSync.PolicyLogger.reg” file to update the linked assembly version in windows registry.
Reboot the machine.
Repeat Step1-8 for all additional/secondary/backup domain controllers.

Improvements / New Features

User mapping screen/UI load time optimizations.
Modern SSL certificates support for ADSync web service.
Windows service logon account change on configuration credentials change.
Exchange mailbox specific attributes sync (if MS Exchange is present at client side).

Resolved / Fixed Issues

Issue fixed for error in case of no users in selected OU for when adding new sync profile.

Download link for ADSync Update Files: (ADSync v5.0.0.0) Size: ~218KB

ADSync Utility Update to v4.3

mudesira.munir — Mon, 09 Dec 2019 15:32:00 GMT

Summary

This article provides information on how to update ADSync tool to latest v4.3.

Applies To

This article applies to ADSync v4.2

ADSync v4.3

ADSync v4.3 works with MachPanel 6.3.12 or later. To upgrade you need to perform following steps on each Domain Controller in Local AD.

For details about changes in build 6.3.12, please visit release notes https://kb.machsol.com/Knowledgebase/55615/MachPanel-Build-v6312-Release-Notes-Dec-10-2019

You will be able to perform update of your control panel server to 6.3.12 and schedule your ADSync customers to perform update to 4.3 at a later time. During this version mismatch between ADSync and MachPanel where ADSync is on version 4.1 or 4.2 and MachPanel is on version 6.3.12 the Sync Process will continue to work. Though this will work, but it is recommended to update ADSync clients to version 4.3 as soon as possible.

IMPORTANT: This version of Adsync supports latest TLS encryption protocols i.e. TLS1.1 and TLS1.2 are supported.

Procedure To Update:

a. Auto update: If you want to auto-update, please run ADSync.UpdateInstaller.exe, please use "Run as Administrator" option.

Also, you need to manually run registry file (ADSync.PolicyLogger.reg) from update directory once update process is completed.

b. Manual update: To update manually please follow below steps.

Remove entry “ADSyncPolicy” from “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Reboot Domain controller.
Replace “ADSyncPolicy.dll, ADSync.PolicyLogger.dll and ADSync.ClientHelper.dll” files in "$windir\System32".
Stop ADSyncSvc using Services.
Replace "ADSync.ClientHelper.dll, ADSync.ConfigStudio.exe and ADSyncSvc.exe" in installation folder of ADSync
Example "C:\Program Files\MachSol\ADSync".
Add entry “ADSyncPolicy” to “HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\Notification Packages“.
Double click or run “ADSync.PolicyLogger.reg” file to update the linked assembly version in windows registry.
Reboot the machine.
Repeat Step1-8 for all additional/secondary/backup domain controllers.

Download link for ADSync Update Files: (ADSyncUpdate4.3) Size: ~664KB

Known Issue:

If your panel is on build 6.2.10 and you updated your ADSync Tool to v4.3, you need to execute following script on Control Panel Database:

Insert Into [Hb_tblADSyncVersionMapping] (ADSyncVersion, CPVersion)
Values ('4000','6210'),
('4100','6210''),
('4200','6210''),
('4300','6210'')
GO

Commercial Saas Products and Price (NCE)

mudesira.munir — Fri, 13 Jul 2018 05:31:20 GMT

Summary

This article explains details about Commercial Saas Products and Commercial Saas Prod Price (NCE) on Microsoft CSP Profile Page.

Applies To

MachPanel Build 6.0.32

CSP Offers price tab on Microsoft CSP Profile Page

Navigate to the following Path: Home > Service Director > Microsoft CSP > Microsoft CSP Profiles
Select CSP Offers Price tab and click Add Offers Price Listing. You can perform search based on CSP Profile, Payment Group, Offer Name, Date from, date to etc. See More details:

https://kb.machsol.com/Knowledgebase/55713/CSP-Offers-price-tab-on-Microsoft-CSP-Profile-Page

Commercial SaaS Products

A new functionality added under Microsoft CSP Profiles Section.

Click Commercial SaaS Products tab to see the Products lists

Click on Import Products you can import CSP products using Excel file.

Clicking on Export Products you can export CSP product in Excel file

Also you can perform Sync from Backend and Get Products.

Commercial SaaS Prod Price

A new option of Commercial SaaS Prod Price is added in Microsoft CSP Profile section. You can perform search based on CSP Profile, Payment Group, Product Name, Date from, date to etc.

You can Add Product Price Listing.

On Add Product Price Listing interface you have to select CSP Profile, Microsoft Price Sheet, Payment Group, Country, Language/Locale and Profit to add in %, also you can check/uncheck Update price of existing packages and Send Email

You can click on Details to see the details of existing Product Price List.

Update MachPanel Remote Server to Latest Version

rehan_waseem — Fri, 15 Apr 2011 13:23:56 GMT

Summary

This articles provides information about how to update your MachPanel Remote Server to latest version.

Applies To:

MachPanel Remote Server all Versions

Note: Customers using old module like Exchange 2010, Exchange 2010 Hosted, should not update to MachPanel v8.

Pre-Requisite:

Need to install Microsoft .Net Framework 4.8 on control and remote servers. (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.
The servers on which MachPanel Control Panel and MachPanel Remote Server are installed, need to be exposed to internet (but can be limited only to our license and update servers). You can enable access only to the update and license servers so that configuration studio can download updates from our live servers.
Please ensure access to following addresses (HTTP and HTTPS) are allowed from control and remote servers:
- https://ls.machsol.com/webservice/lic.asmx
- https://ls2.machsol.com/webservice/lic.asmx
- https://updates.machsol.com
- https://www.machsol.com
- https://machsol.com

Important Note:

Copy all the files from this path: C:\Program Files\MachSol\MachPanel Remote Server\ and place them at another safe location as backup.
Backed up files for Remote Server must be saved under the folder (MP_Remote_Files_Backup)
Make sure that MachPanel Control Server is updated first. If not then first update MachPanel Control Server: https://kb.machsol.com/Knowledgebase/50181/Update-MachPanel-Control-Server-to-Latest-Version
For Manual Update or replacing files/\folders (hotfixes etc.), please make sure that all the services are STOPPED from MachPanel Remote Configuration Studio. Verify from Task Manager that the following services are not running.

MachSol.MachPanel Provisioning Service
MachSol.MachPanel.ConfigurationStudio.exe

Auto Update Procedure:

To update MachPanel to latest version, please follow the steps mentioned below:

Open MachPanel Control Server Configuration Studio.
Click Update
Click Check Available Updates button under Update Software tab on right pane of configuration studio.

Click "Check Available Updates" button under Update Software tab on right pane of configuration studio. If you get error 'No update available' at this point, then open 'Run' and type 'regedit'. Then navigate to Computer > HKEY_LOCAL_MACHINE > SOFTWARE > MachSol > Remote Configuration Studio. Double click on CoreVersion to open it. Type in here the build version to which you want to update to or the latest build version. For example to update to build 8.0.32 type 8032 and click 'OK'. Now go back to configuration studio and check update again.

Then click on Download button.
Finally click Install to Install the updates.
After the updates have been performed, make sure that the control and all the remote servers are on same build, otherwise they wont be able to communicate with each other.

Important Note: Please ensure that settings below are set ONCE on all Remote Servers as well as on Control Server for automatic updates to work:

Change Registry of Control Panel Server to Set IP of Control Panel machine which is accessible from all remote servers. This IP will be replicated to all remote servers and the remote server will get updates as well as look to be on the same version as control panel with this IP:

Change Registry on Remote Server as below:

CoreIPAddress: Will be auto fetched from control but for first time, you have to set it same as IP of your control panel server.
CoreVersion: Provide core version. Will be auto updated from control panel machine via the CoreIPAddress in future.
CoreVersionFull:Provide full core version. Will be auto updated from control panel machine via the CoreIPAddress in future

Perform update on Control Panel and then on all Remote Servers.

How To Manually Apply Updates To MachPanel Control And Remote Servers

zohaib.shaikh — Mon, 05 Jul 2010 12:10:09 GMT

Summary

This article provides information about how to manually update your MachPanel Control and Remote Servers.

Applies To

MachPanel all versions

Note: Customers using old module like Exchange 2010, Exchange 2010 Hosted, should not update to MachPanel v8.

Pre-Requisite:

Dot Net Framework 3.5 HTTP and HTTPS required.
Need to install .Net Framework 4.8 on control and remote servers. (applies to 8.0.32 or later)
The servers on which MachPanel Control Panel and MachPanel Remote Server are installed, need to be exposed to internet (but can be limited only to our license and update servers). You can enable access only to the update and license servers so that configuration studio can download updates from our live servers.
Please ensure access to following addresses (HTTP and HTTPS) are allowed from control and remote servers:
1. https://ls.machsol.com/webservice/lic.asmx
2. https://ls2.machsol.com/webservice/lic.asmx
3. https://updates.machsol.com
4. https://www.machsol.com
5. https://machsol.com

Kindly ensure to take backup of database as well as MachPanel files.
It is recommended to name the database backup file according to the current version of MachPanel (e.g. MP_DB_Backup_7.3.60)
Also take backup of MachPanel files with version name usually at this path C:\Program Files\MachSol, Inc\MachPanel
(e.g. Saving the MachPanel files and naming the folder as MP_Files_Backup 7360if the current version is 7.3.60.1.23)
Similarly take backup of the MachPanel Remote Files.

The backup details are explained below.

Manual Steps to Update:

A-To manually update MachPanel Control Server:

In order to apply the updates, first you need to get the Update.zip file. For that you need to download the Update.zip from the configuration studio and then navigate to the following path to pick the Update.zip file: C:\Program Files\MachSol,Inc\MachPanel\Cache\Temp\Update\Update.zip. Once you have the Update.zip, you can extract it.

Note: Before extracting the .zip file, please Unblock it (if blocked). Go to File Properties by Right Clicking it, then you will see its status. If "Unblock" button is not there, it means the .zip file is already unblocked.

Upon extraction you will see that there are multiple folders such as:

DLL, Files, Script, Services. The folders names "Files" and "Script" are of your interest.

Note: Do not execute any file other than the steps mentioned. No files are to be double clicked. If there is already an Update.zip existing on this path before you download and you are not sure what version it is than you can simply delete the Update.zip, close the configuration studio, re-start it and download again from the configuration studio.

You must first take a backup of your current MachPanel installation i.e. replicate the folder C:\Program Files\MachSol,Inc\MachPanel to some place in computer where you place backups. Also take a backup (a must) of your database i.e. MachPanel_Db and place it in a safe location on your PC.

Steps to follow:

1. 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.

2. Copy all the files/folders from the Files folder from the extracted Update.zip and paste it at this path: C:\Program Files\MachSol,Inc\MachPanel\. Note that the folders at this path and in the Files folder in the extracted Update.zip are almost the same. At this point you have replaced the MachPanel updated files and now you need to run a script on the database.

3. Open your SQL Server Management Studio and log in using the user: MachPanel_Db and its password. If you don’t know the password of this user then you can check it from the connection string from the registry. (Please see attachment)

4. After logging in, create new query on the MachPanel_Db. Copy all the script from the Script.txt in the Script folder in the extracted Update.zip. Paste this script in that new query and first parse the query to know if there are any syntax errors or not. If not than execute the query.
After the files have been replaced and the script has been successfully run on the database, you need to start all the MachPanel services and the configuration studio again. Start "MachPanel Provisioning service" and other services from Task Manager under Services tabs shown below. When you open the configuration studio now, you can see that the version has been upgraded.

B-To manually update MachPanel Remote Server:
Scenario 1:
First, try the following steps:

Then click on Download button in MachPanel Remote Server Configuration Studio.

*After the updates have been performed, make sure that the control and all the remote servers are on same build, otherwise they wont be able to communicate with each other

Scenario 2:
If scenario 1 does not work, you can try the following:

In order to apply the updates for the MachPanel Remote Server, first you need to get the Update.zip file for remote server. You can get it from your MachPanel Control Server by navigating to the following path to pick the Update.zip file:

C:\Program Files\MachSol\MachPanel Control Server\RemoteUpdate\Update.zip.

Once you have the Update.zip, you can unblock it (if blocked) and then extract it. After extraction, you will see a folder named as: Files

Note: Do not run any file other than the mentioned folders. No files are to be double clicked. If there is already an Update.zip existing on this path before you download and you are not sure what version it is than you can simply delete the Update.zip, close the configuration studio and download again from the configuration studio.

Steps to follow:
1. Stop the MachPanel Provisioning Service and also exit the MachPanel Remote Configuration Studio from task bar (or end both tasks from task manager). Make sure no instance to MachPanel Remote Configuration Studio is running under any user. Verify from "Task Manager" that the following services are not running.

MachSol.MachPanel Provisioning Service

MachSol.MachPanel.ConfigurationStudio.exe

2. Copy all the files from within the Files folder, extracted from Update.zip and paste them at the installation path of remote server, typically: C:\Program Files\MachSol\MachPanel Remote Server\. There are only a few files that you will be replacing here.

3. Once the files have been replaced, you can start the MachPanel Provisioning Service from Task Manager or Services Manager and start the configuration Studio from desktop icon.

The remote server is now updated.

Auto update via Configuration Studio and Remote Configuration Studio when the update is not live but you have to do it from direct link provided by MachSol Support.

Added a new tab in Software Updates form in Configuration Studio and Remote Configuration Studio, named “Manual Update”.

Textbox will accept .zip file URL to download update. On update click, download file, save as Update.zip in Cache/Update folder, unzip it.

System will check xml keys from MachPanel.xml file:

UpdateVersion

Build

If in old MachPanel.xml file Build is same but new UpdateVersion is greater than old values then update routine will be called as a normal update. But system will use above downloaded files to update.

UpdateVersion will be included in new MachPanel.xml file

Operation Failed: A Parameter Cannot Be Found That Matches Parameter Name "IssueWarningQuota"

fawad.khan — Mon, 10 May 2010 09:08:15 GMT

Summary

This article describes how to resolve an Error Message Operation Failed: A Parameter Cannot Be Found That Matches Parameter Name "IssueWarningQuota" which normally appears while managing the Public Folders of Exchange Accounts found in Exchange Hosting under Service Director tab.

Applies To

MachPanel all versions.

Symptoms

Exchange 2007 Service Pack 2 update, not installed.

Solution

The Error Message which can be seen in the attached snapshot normally appears because MachPanel requires Exchange Server 2007 to be updated to Service Pack 2 (SP2) and thus, this issue can be successfully resolved by performing the following:

Update Exchange Server 2007 to Service Pack 2 (SP2).
Login to the MachPanel again and perform operations successfully.

Backup Failed When Updating MachPanel Remote Server

zohaib.shaikh — Fri, 07 May 2010 09:41:36 GMT

This article provides information about how to successfully update MachPanel Remote Server if ''Backup Failed" error occurs during the update from configuration studio.

Applies To

MachPanel all versions.
Remote Configuration Studio.

Solution

To successfully update the remote server, please follow the steps mentioned below:

Step 1: Rename the Backup folder.

Go to My Computer.
Navigate to the folder where MachPanel Remote Server is installed. For example: C:\ProgramFiles\MachSol, Inc\
Then rename the Backup folder at the location C:\ProgramFiles\MachSol, Inc\Backup.
Run the update again.

ERROR While Updating MachPanel Control Server

zohaib.shaikh — Fri, 07 May 2010 07:28:38 GMT

Summary

This article provides information about how to successfully update MachPanel Control Server if the stated error occurs.

"ERROR: Error in sql script processing: Details: A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: SQL Network Interfaces, error: 26 - Error Locating Server/Instance Specified)"

Applies To

MachPanel all versions.
Control Server Configuration Studio.

Solution

To successfully update the control server, please follow the steps mentioned below:

Step 1: Replace (local) with a dot '.' in the MachPanel connection string.

Go to run.

Write regedit and press enter.

Then follow the path: HKEY_LOCAL_MACHINE >> SOFTWARE >> MachSol >> MachPanel.

Then open Connection String file on the right pane.

Change (local) to dot '.' without commas in the Value data.

Close Configuration Studio and restart it.

Then again try to update.

Update MachPanel Control Server to Latest Version

mudesira.munir — Fri, 11 Dec 2009 08:29:31 GMT

Summary

This articles provides information about how to update your MachPanel Control Server to latest version.

Applies To:

MachPanel Control Server all Versions

Pre-Requisites:

Note: Customers using old module like Exchange 2010, Exchange 2010 Hosted, must not update to MachPanel v8.

Need to install Microsoft .Net Framework 4.8 on control and remote servers. (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.
The servers on which MachPanel Control Panel and MachPanel Remote Server are installed, need to be exposed to internet (but can be limited only to our license and update servers). You can enable access only to the update and license servers so that configuration studio can download updates from our live servers.
Please ensure access to following addresses (HTTP and HTTPS) are allowed from control and remote servers:

https://ls.machsol.com/webservice/lic.asmx
https://ls2.machsol.com/webservice/lic.asmx
https://updates.machsol.com
https://www.machsol.com
https://machsol.com

*Important Note:

Auto update testing is necessary as there is business logic embedded to update MachPanel IIS pool/site to v4 .Net Framework and to update web.config file. The update installer handles MachPanel web.config and App pool update too. But if for some reason it fails then following steps should be followed:

After update is deployed and panel is not working, locate NewWeb.config in MachPanel Control Server installation folder
a). If found:
              i.      Replace Web.Config with NewWeb.Config.
              ii.     Find following section:

    <sessionState mode="InProc" cookieless="false" timeout="20" />
    
    <globalization culture="en-US" uiCulture="en-US" requestEncoding="utf-8" responseEncoding="utf-8" />

And Replace it with same section from Backup > Web.Config to NewWeb.Config.

b). If not found, repeat step ii, that is update MachPanel Control Server/web.config section from backup.

Locate MachPanel app pool in IIS, open Advanced Settings, make sure .NET CLR version v4.0 is selected, restart app pool and web app if needed.

Prior to performing any update take backup of your MachPanel Database, Control and Remote servers. See below KB article for more details on how to take backup. http://kb.machsol.com/Knowledgebase/Article/50248
In case of Manual Update, before replacing files\folders (hotfixes etc.), 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.

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.

Auto Update Procedure:

To update MachPanel to latest version, please follow the steps mentioned below:

Open MachPanel Control Server Configuration Studio.
Click Software Updates
Click Check Available Updates button under Update Software tab on right pane of configuration studio.

Then click on Download button.
At the end click Install button.

After the updates have been performed, make sure that the control and all the remote servers are on same build, otherwise they wont be able to communicate with each other.

MachPanel 4.0 BUILD 31 Update Release Notes (September 24, 2009)

fawad.khan — Sat, 19 Sep 2009 12:41:29 GMT

Release Date: September 24, 2009

Contents

1. Important Prerequisites
2. Upgrade Instructions
3. New Features/Improvements
4. Resolved Issues
5. Known Issues

Important Pre-requisites

1. MachPanel Control Server v.4.0.30
2. MachPanel Remote Server v.4.0.30

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

1. Update to Latest MachPanel
2. Update to Latest MachPanel Remote Server

IMPORTANT - Update to MachPanel 4.0 Build 31: The update process followed in above knowledge base articles will automatically upgrade to latest build.

New Features/Improvements

New feature: Moneris Payment Gateway.

Resolved Issues

Bug fixed: Subscribe service gives fatal error on selecting customer owner.
Bug fixed: SQL connection pool problem in Exchange distribution list add mailbox function.
Bug fixed: Distribution list name does not accept '.' in name field.
Bug fixed: Exchange migration toolkit not working in Exchange Standalone mode.
Bug fixed: Exchange HMC 4.0/4.5 not working, details: settings cannot be found.
Bug fixed: Taxation not working in subscribe service interface.
Bug fixed: Cannot add Hostmatic Server group.
Bug fixed: State issue: When 'US' is selected as country, it is not being pre-populated automatically.
Bug fixed: Bulk Add mailboxes should not be used.

Known Issues
There are no known issues for this build.

Update Problem - The Process Cannot Access The File 'C:\Program Files\MachSol, Inc\MachPanel\bin\MachSol.MachPanel.ConfigurationStudio.exe' Because It Is Being Used By Another Process.

fawad.khan — Sun, 26 Apr 2009 05:56:31 GMT

Summary

When updating MachPanel, you get following error in Configuration Studio log

ERROR: The process cannot access the file 'C:\Program Files\MachSol, Inc\MachPanel\bin\MachSol.MachPanel.ConfigurationStudio.exe' because it is being used by another process.

Applies To

MachPanel all versions

Solution

This error occurs because of insufficient permission on the target directory. To fix this error, please perform the following steps.

Go to C:\Program Files\
Right Click on folder where MachPanel files are installed, typically MachSol, Inc and select Properties.
Un-Check the check box that says Read-only and click Apply.
Select Apply changes to this folder, subfolders and files.
Click OK.

Retry the update process.

Internet Connectivity For MachPanel Remote Server Updates

fawad.khan — Mon, 19 Jan 2009 23:36:29 GMT

Summary
For carrying out successful update, MachPanel Remote Server must have internet connectivity enabled.

Applies To
MachPanel all versions
MachPanel Remote Server

Solution
It is necessary that internet is active on a remote server because the updates need to be downloaded on remote server using internet. The port required to open is 80.

How To Update MachPanel v.3 To MachPanel v.4.0.30

fawad.khan — Wed, 14 Jan 2009 06:51:31 GMT

Summary

This articles provides information about how to update your MachPanel v.3 to MachPanel v.4.0.30.

Applies To

MachPanel all versions

Solution

To update MachPanel v.3 to MachPanel v.4.0.30, please follow the steps mentioned below:

Open MachPanel Configuration Studio.
Then go to the following navigation path in MachPanel Configuration Studio: Configure >> Software Updates.
Click Check Available Updates button under Update Software tab on right pane of configuration studio.
Then click on Download button.
In Configuration Studio Navigate to: Configure >> Services and press button Stop All Services.
At the end click Install button.