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.

1. MachSol.MachPanel Provisioning Service.
2. MachSol.MachPanel.ConfigurationStudio.exe.
3. MachPanel Billing Service.
4. MachPanel Helpdesk Service.
5. MachPanel Network Service.
6. 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.

1. MachSol.MachPanel Provisioning Service
2. 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.

1. Added a new tab in Software Updates form in Configuration Studio and Remote Configuration Studio, named “Manual Update”.
2. Textbox will accept .zip file URL to download update. On update click, download file, save as Update.zip in Cache/Update folder, unzip it.
3. System will check xml keys from MachPanel.xml file:
   1. UpdateVersion
   2. Build
4. 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.
5. UpdateVersion will be included in new MachPanel.xml file