ProgramFix / shelf 4

Utilities the desk keeps · 241 tools

Tool: ntpoffset 1.2 · 120 KB · 26 Sep 2014 · md5 3b0f9ce2174d · signed ML · back to its row on the shelf

← Shelf

Placeholder page. These are the standard install steps, kept in the shape this shelf uses so nobody has to invent them twice. Anything in [brackets] is a value nobody has written down yet, and the tool-specific warnings have not been collected. Replace the brackets before this page is handed to anyone outside the desk.

ntpoffset 1.2

120 KB · 26 Sep 2014 · md5 3b0f9ce2174d · signed ML · shelf 4

windowslinuxmacosfreewarewrites nothing

Measures how far the workstation clock has drifted from the licence server. Past ten minutes, activation fails and Error 4021 is what the user gets to see. Fix the clock, not the licence.

ntpoffset compare --host licence.example
drift +14m 20s — past the 10m window. fix the clock.

Note from the shelf row: The eight minutes of daylight saving nobody plans for.

Before you install

  • Runs on: Windows, Linux, macOS. the application must be 4.0.7 to 4.1.6.
  • Space: about 120 KB for the download, plus [WORKING SPACE] while it runs. Needs outbound TCP 8443.
  • Rights: an ordinary user account; no elevation and no sudo for the tool itself
  • Know first: [PREREQUISITE] — whoever writes this page up properly should say here what has to be true before the tool will run at all.

Download and verify

Take the build for your platform from the [SHARE] and check it against the digest on the shelf row before you unpack anything. The digest is also printed below.

certutil -hashfile ntpoffset-1.2-win64.zip MD5
md5sum ntpoffset-1.2-linux-x64.tar.gz
md5 ntpoffset-1.2-macos.tar.gz

Expected: 3b0f9ce2174d. The shelf row carries the same digest.

Install

Copy it into place and put it on the path. Nothing here installs a service or a scheduled task, so there is no installer to run and nothing to reboot.

Windows

Unpack the zip, then:

xcopy ntpoffset-1.2-win64 C:\Tools\ntpoffset /E /I
setx PATH "%PATH%;C:\Tools\ntpoffset"
ntpoffset --version

Linux

Unpack it and link it onto the path:

# unpack into place
sudo tar -xzf ntpoffset-1.2-linux-x64.tar.gz -C /opt
sudo ln -sf /opt/ntpoffset/ntpoffset /usr/local/bin/ntpoffset
ntpoffset --version

macOS

Unpack it and link it onto the path:

# unpack into place
sudo tar -xzf ntpoffset-1.2-macos.tar.gz -C /opt
sudo ln -sf /opt/ntpoffset/ntpoffset /usr/local/bin/ntpoffset
ntpoffset --version

Check it worked

Check the version first, then run the one command the tool exists for. If the output matches, it is working:

ntpoffset --version
ntpoffset compare --host licence.example
drift +14m 20s — past the 10m window. fix the clock.

Expected output is the line shown in the block above; anything else means [TO DO: write the failure list].

Removing it

Delete the folder and drop the path entry. The tool keeps no state of its own, so there is nothing to unregister.

rmdir /s /q C:\Tools\ntpoffset
sudo rm -rf /opt/ntpoffset /usr/local/bin/ntpoffset
sudo rm -rf /opt/ntpoffset /usr/local/bin/ntpoffset

If it goes wrong

  • [KNOWN FAILURE 1] — the usual fixes for this tool have not been written down yet. Add them the second time somebody hits one.
  • Wrong error number or a fault you cannot name: run the tool's own diagnostic first (shelf row), then the removal steps.
  • Before any repair that writes to a store, take the export — backoff is the tool for it.
  • If a tool on this shelf is being asked to fix something it was never written for, stop and ask the desk rather than reaching for a force flag.