For software upgrade of an existing running Events2HVAC site, the following steps need to be performed:
1. Download the latest software
Login to your client account and go to your license page to access the download: https://account.streamsidesolutions.com/MyAccount/MyLicenses
2. Find a time where there is a suitable gap in scheduled commands that are queued up.
During an upgrade, the command queue service will be stopped and any scheduled commands will not be sent out. Start your upgrade when you have ample time between commands. Typically, minor upgrades can take up to 15 minutes. Allow more time for major upgrades. It is best to allow more time just in case something unexpected occurs during the upgrade.
In the example below, a good time would be between 7:00pm -
8:30pm. That gives you an hour and a half to take care of
business.
3. Make a backup of your Events2HVAC SQL database.
This is a very critical step, especially in upgrades that update the database schema or migrate data. Failure to have a backup could lead to facility downtime and/or loss of data.
Contact your IT department if they are responsible for that process. Here's how to do it:
4. Export your equipment items to a file.
This is an extra step that allows you to recover equipment lists without doing a full database restore.
Open the client, go to the File menu --> Export Equipment. Give the file a name and hit save.
5. Delete ALL active entries in the command queue.
This is an optional step that usually isn't a problem on minor upgrades. However, if items in the queue are referring to code assemblies that don't exist after the upgrade, you may get errors for those items in the queue when they are removed from the queue.
5. Install any prerequisite software
Check the new version to see if any new prequisite software is needed and install as necessary.
6. Install the software.
Run the installation executable on your E2H server platform. Follow the steps similar to a first-time installation in the user guide. If you add any new devices, make sure you select those during the upgrade.
7. Run the setup wizard after the install.
This occurs automatically. Make sure all steps pass.
Note: If you have purchased new device interfaces and have a new license, you can load in the new license during the license verification step.
6. Verify Operation
Open the client and verify that your active command queue is filled with current active commands. Also, do a quick check to see if you are getting events from your event provider by opening up the event calendar.
7. Upgrade any client computers (if applicable).
You'll need to perform steps 5-7 on each client that you installed the Events2HVAC client-only setup on. Make sure when you run the setup, that you select the client-only installation when asked.