ProgramFix / shelf 4

Utilities the desk keeps · 241 tools

Tool: portset 1.5 · 128 KB · 09 Feb 2012 · md5 842d814b3754 · signed RZ · 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.

portset 1.5

128 KB · 09 Feb 2012 · md5 842d814b3754 · signed RZ · shelf 4

windowslinuxmacosfreewarewrites nothing

Placeholder install sheet: brackets mark values nobody has recorded.

Test-prints one page of rulers so the margin error can be measured.

portset print --rulers --copies 1
sent to LOCAL, 1 page, 0.5 mm skew

Note from the shelf row: 0.5 mm skew is normal; 3 mm is the driver

Before you install

  • Runs on: Windows, Linux, macOS. the application must be 4.0.7 to 4.1.6.
  • Space: about 128 KB for the download, plus [WORKING SPACE] while it runs.
  • Rights: an ordinary user account; no elevation needed
  • Know first: [PREREQUISITE] — what has to be true before this 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.

certutil -hashfile portset-1.5-win64.zip
md5sum portset-1.5-linux-x64.tar.gz
md5 portset-1.5-macos.tar.gz

Expected: 842d814b3754. 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.

Windows

Unpack the zip, then: 

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

Linux

Unpack it and link it onto the path: 

sudo tar -xzf portset-1.5-linux-x64.tar.gz -C /opt
sudo ln -sf /opt/portset/portset /usr/local/bin/portset
portset --version

macOS

Unpack it and link it onto the path: 

sudo tar -xzf portset-1.5-macos.tar.gz -C /opt
sudo ln -sf /opt/portset/portset /usr/local/bin/portset
portset --version

Check it worked

Check the version first, then run the one command the tool exists for:

portset --version
portset print --rulers --copies 1
sent to LOCAL, 1 page, 0.5 mm skew

Expected output is the line shown 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.

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

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).
  • Before any repair that writes to a store, take the export — backoff is the tool for it.