Installing on-premises HealthMon

Pre-requirements

To install HealthMon, you will need to have:

  • HealthMon.zip: provided to you by Cameyo's support.
  • auth.dat: authentication file, provided to you by Cameyo's support.
  • [Cameyo internal]: Cameyo support team will need to set up your account with PrivateHealthMon and UserFlags.HealthMon.

Extraction

To extract HealthMon, proceed as following:

  • Extract HealthMon.zip into a directory accessible by Admins only (no read or write permissions for users). If you are installing on a Cameyo server, C:\RapPrereqs\HealthMon is a good place as C:\RapPrereqs' permissions are already configured properly.
  • Copy auth.dat into the same directory (hence CameyoCef.exe and auth.dat should be in the same directory). This file contains your organization's HealthMon authentication, so keep this file safe.

Testing

Launch HealthMonCmd.bat from the extracted directory. You should see something similar to this:

After a minute or so, you should see HealthMon's diagnosis results in green or red. You may send a screenshot to your Cameyo support's contact person for confirmation.

Setting up a scheduled task

When you are ready to setup HealthMon into a scheduled mode, create a scheduled task using Windows' Task Scheduler. The task should be set to run CameyoCef.exe -HealthMon every X minutes, starting at 00:00 repeating every day, and should run whether user is logged on or not. No special privileges are required.

The recommended time interval is 10 - 15 minutes, but not lower than 5 to avoid multiple HealthMon checks interfering with each other.

Multiple on-premises HealthMon bots (advanced)

If you need to setup several HealthMon bots on separate servers, the same procedure as above should be applied, but the starting time should be changed to be staggered between the servers. For example if you would like checks to be made every 10 minutes, then you should have one server starting at 00:00 repeating every 20 minutes, and the other server starting at 00:10 repeating every 20 minutes. This will avoid HealthMon checks interfering with each other around the same time.

Logs and cleanup

HealthMon creates logs under the Logs\ sub-directory in a space-efficient way. You can set up a cleanup task that empties this folder every few months if needed.

Diagnostics

HealthMon can be diagnosed using a debug output tool (such as C:\RemoteAppPilot\DbgView.exe on Cameyo servers). The easiest way to diagnose HealthMon is to run the debug viewer and then launch HealthMonCmd.bat