Support Knowledgebase
NAV

Transitioning to SimpleHelp 6.0

SimpleHelp 6.0 includes important changes to how data is stored on the server, and how the server is licensed. This guide contains information on how to move from an earlier version of SimpleHelp to v6.0.

License Changes

In SimpleHelp 6.0 your SimpleHelp server will automatically fetch and apply your SimpleHelp license. In order to do this your server will need to be able to reach https://simple-help.com . If your on-premise server is not able to reach our site please contact us for offline license download instructions before updating.

Prior to updating, check that you have access to your simple-help.com account, and that your license is correctly assigned:

  1. Navigate to https://simple-help.com/account

  2. Log in using your account credentials

  3. In the Licenses tab, verify that there is an active SimpleHelp license listed.

When you install v6.0 and launch the Technician Console you will be prompted to allow your SimpleHelp server to access your license. To do this, follow the prompts to authenticate with simple-help.com. The Technician Console will display your active licenses and you will be able to pick a license to assign to the server.

Strict Server Address Policy

As part of v6's improvements to security and abuse prevention, the Server Address value and Aliases must be configured correctly (they are no longer suggested default fallbacks as they were in v5). App downloads such as Remote Support check whether the URL they were downloaded from matches the Server Address or its Aliases. If so, it will connect to that address. If not, it will attempt to connect to the Server Address value. This means that if the Server Address or Aliases are incorrect, new app downloads may fail to connect to the server until the values are corrected.

Relatedly the ability to set the server connection address as an argument of a download URL is no longer supported. You can still set this using installation arguments as per the Remote Access preconfiguration guide and the Configuring App Downloads guide.

Rollback Unsupported (see workaround)

SimpleHelp 6.0 uses updated encryption and hashing methods. This means a version 6.0 server configuration is incompatible with earlier server versions, so rolling back by installing an earlier version and migrating your configuration will not work. Instead, stop your server process and back up the entire SimpleHelp installation folder before updating to 6.0. If for any reason you need to revert to the earlier version, stop the updated server process and reinstate your backed up installation. If you do not do this, but have backed up your configuration before updating or can locate an automatic backup in .../SimpleHelp/configuration/backups, you can migrate that to a 5.5 installation as per the Server Migration Guide.