Audience: ClassLink Administrator
OneSync updates are released periodically in order to add to new features, fix bugs, and patch security holes. There are multiple ways to update OneSync, each with its own benefits.
You can automatically update OneSync from the frontend by navigating to OS Settings > General Settings. Here, in the upper right-hand corner, you will see your Current Version of OneSync. If an update is available, you will see the update's version number in red. Alongside this will be a blue "Update OneSync" button.
In General Settings, there is an additional setting labeled "OneSync Preview Features". If Enabled, this setting will update OneSync with the latest preview features. Note that these updates may not be stable because they have not been extensively tested. If Disabled, this setting will update OneSync with the latest stable build. This includes features that have been thoroughly tested and approved.
Command Line Updater
You can manually update OneSync by running the updater's executable file from the command line. To do so, open a command prompt and navigate to the directory that contains the executable file. If possible, run the command prompt as administrator. Once in the directory, you can type "OSUpdater.exe" to initiate the update. You can also type "OSUpdater.exe --help" to see a list of commands that you can perform from the command line:
- backup: Backup the database and application files.
- deleteallthedata: Delete all user data, leaving the config.
- restore: Restore the database interactively.
- securewindows: Disable known-insecure protocols and hases liek TLS 1.0 and SSL 2.0 and 3.0.
- update: Update OneSync (Default Command)
These commands can be run by typing "OSUpdater.exe [command]". Additionally, you can type "OSUpdater.exe [command] --help" to read more instructions and details about each command. E.g. "OSUpdater.exe restore --help".
Graphical User Interface (GUI) Updater
You can manually update OneSync by running the OSUpdaterGUI.exe file. This will open a user-friendly program which you can use to run the same commands that you would with the Command Line Updater, but without typing the commands. There are also additional commands in the GUI updater that are not as easily run in the Command Line Updater:
- Update: Update OneSync with the option to backup your database and application files.
- Backup: Backup your database and application files without updating.
- Restore: Restore your database and/or application files. You can browse for the specific backup files.
- Advanced: Delete user data, secure windows, or update OneSync from a specific file or version.
- Settings: Choose light or dark mode for the GUI Updater.
- About: Displays the Updater's version number.
Updated: Feb 2019