Updating BxEngine

How to update BxEngine

Updating BxEngine usually shouldn't take more than a few minutes. BxEngine can be updated in two different ways.

Both ways give the same result, so you only need to do one of them.

Method 1: Update via BxAdmin - The simplest way as long as you have access to BxAdmin.
Method 2: Updating from the server installation - The simplest way if you have access to the server and not BxAdmin.

If you have a service user on the BxEngine service, with a BxEngine version older than 2019.1.2370, you need to make sure to add the same service user back on the service after update. If you update from version 2019.1.2370 or newer, you no longer have to do this step. 

1. Updating via BxAdmin

1. In BxAdmin, press Server Upgrade in the Home image.
   
   
   
2. Press Yes
   
   
   
3. Wait for the next pop up dialogue. 
   
4. Wait a few minutes before pressing OK. If you accidentally press OK immediately, you will receive a 404 error. This happens because BxEngine hasn't finished updating yet. So wait a few minutes and try refreshing BxAdmin. If you get access as normal, then everything is ok and BxEngine has now finished updating.

2. Updating via BxEngine Monitor

The other method is performed directly on the server. This is mainly done when you don't have immediate access to BxAdmin, or in those cases where you have a version older than 2019.1.2370 with a service user.

Step 3 no longer applies from version 2019.1.2370. Instead a window will pop up for a few seconds containing some command lines, and then everything will be updated with no further need for interaction. The update has finished when the window disappears, and now you wait 30 seconds before launching BxEngine Monitor again, if it doesn't start up automatically. You will now see that it has been updated to a newer version.

1. Start BxEngine Monitor. You can find it either on your desktop or under C:\Program Files (x86)\BxSoftware\BxEngine → BxEngine.Monitor.exe (Or in a customized path)
    
   
   
2. Press Update, you will receive information about the version number and a question whether or not you wish to update. Press Yes.
   
   
   
3. Press Next → Next → Install → Finish (If the path is customized, change it to the correct one)
   
   
   
4. BxEngine has now been updated. Remember to re-add the service user if one existed in the BxEngine service before the update. (This mainly applies only to versions older than 2019.1.2370, but it might be worth checking all the same)
   

If the Update button in BxEngine Monitor has been greyed out, as in it isn't available, you must open the C:\ProgramData\BxSoftware\BxEngine\Config -> BxEngine.ini file and remove the service name and then press Save. Make sure to close the BxEngine Monitor before you save the changes. This mainly applies only to versions from 2019/2020.