SyncriTab

Updating & Restarting

Keep SyncriTab up to date with new features and security fixes, and restart it when a change requires it.

The About page

Updates and restarts are done from the About page. Sign in as an administrator and click About in the side menu. Besides the license details, it shows the installed Version, how long SyncriTab has been Running since, a Check for Updates link, and a Restart button.

The About SyncriTab page with installation details, the Check for Updates link, and the Restart button.
The About page.

Updating SyncriTab

Never reinstall SyncriTab to update it. Running the installer again over an existing installation wipes out your configuration, including users, data sources, and settings. Always update with Check for Updates as described below.

SyncriTab checks for a newer version once a day. When it finds one, it emails the Administrator's address once for that build, with the installed and available versions and a link to the About page. This needs a working email server; see Email Configuration. You can also check at any time. To see whether an update is available and install it:

  1. On the About page, click Check for Updates next to the version number. SyncriTab asks Synametrics for the latest version.
  2. If you already have the latest version, the dialog says You are running the latest public version. There's nothing more to do.
  3. If an update is available, click Download and Stage. SyncriTab downloads the update, shows the progress, and checks its digital signature so that only genuine Synametrics updates are installed.
  4. When the download finishes, click Restart and Apply Update and confirm. SyncriTab restarts and installs the update as it starts.
The Check for Updates dialog showing that a newer build is available, with the Download and Stage button.
Checking for updates.

Installing an update restarts SyncriTab, which signs everyone out and interrupts running queries, exports, and scheduled tasks. Choose a quiet time, and check the Dashboard for active sessions first.

Before you update

After you update

Wait for SyncriTab to start, sign in, and check that the About page shows the new version. Users' query pages and results are restored when they sign in again, if auto-save is on. See Saved Sessions.

Updating SyncriTab in Docker

Use Check for Updates as described above. The update is installed on the container's data volume, so it's kept when the container is replaced. Rebuilding the Docker image doesn't update an existing installation, because the container copies the program files to its volume only the first time it starts with an empty volume.

Installing a custom build from Synametrics Support

Synametrics Support may send you an update package, for example to fix a problem before it's in a public release. The file is named SyncriTabManualUpdate.zip.

An update package contains program code that runs on your server. Install a package only if you received it directly from Synametrics Support.

  1. On the About page, click Check for Updates.
  2. When the dialog says you're running the latest version, click Upload a custom build instead.
  3. Choose SyncriTabManualUpdate.zip and click Upload and Validate. Don't rename the file; SyncriTab accepts only this name.
  4. When the upload finishes, click Restart and Apply Update and confirm.

Restarting SyncriTab

Some changes take effect only after a restart, including:

Restarting from the About page

  1. On the About page, click Restart and confirm.
  2. A page counts down for 30 seconds and then returns to the home page. If SyncriTab isn't back yet, wait a little longer and reload the page.

A restart signs everyone out and closes all database connections, so warn your users first.

Restarting from the server

If you can't reach SyncriTab in a browser, restart it on the server:

PlatformHow to restart
WindowsRestart the SyncriTab service in the Services console, or run net stop SyncriTab and then net start SyncriTab in a Command Prompt opened as administrator.
Linuxsudo systemctl restart syncritab
Dockerdocker restart syncritab-server

See Installing SyncriTab for more about managing the service on each platform.

If something goes wrong

ProblemWhat to do
Checking for updates fails. The server can't reach Synametrics. Check its internet access, proxy, and firewall.
The download fails or can't be verified. Try again later. If it keeps failing, contact Synametrics Support.
SyncriTab doesn't come back after a restart. Wait a minute, then check that the service is running and look in the logs folder for errors. See Troubleshooting.