Usage: erwb [OPTIONS] Create a hardware report of your computer with components, serial numbers, testing, benchmarking, erasing, and installing an OS. By default Workbench only generates a report of the hardware characteristics of the computer, so it is safe to use. Parametrize it to make workbench perform tests, benchmarks... generating a bigger report including the results of those actions. You must run this software as root / sudo. Options: -b, --benchmark / --no-benchmark Benchmark the components using sysbench and other tools. -st, --smart [Short|Extended] Perform a SMART test to all the data storage units. -e, --erase [EraseBasic|EraseSectors] Erase all data storage units. -es, --erase-steps INTEGER RANGE Number of erasure STEPS. --erase-leading-zeros / --no-erase-leading-zeros Shall we perform an extra erasure step writing zeros? -ss, --stress INTEGER RANGE Run stress test for the given MINUTES (0 to disable) -i, --install TEXT The name of the FSA OS to install, without the ".fsa" extension. The file has to be in /media/workbench-images -sr, --server URL Connect to a WorkbenchServer at the specified URI. This will activate USBSneaky module, load the settings from the server, and keep indefinitely waiting for an USB tobe plugged-in. --sync-time / --no-sync-time Sync the time with the Internet before executing the Workbench. Print a warning if it cannot sync (ex. no Internet). -j, --json FILE Write the resulting report to a JSON file. --submit URL If set, submits the resulting Snapshot to a passed-in Devicehub.Provide a valid URL with scheme, username, password and host. --debug / --no-debug Add extra debug information to the resulting snapshot? -h, --help Show this message and exit. Ex. sudo erwb --benchmark --smart Short --erase EraseSectors --json out.json will generate a hardware report plus benchmarks, a short SMART test of all data storage units, and a certified erasure of all data storage units, saving the resulting report as 'out.json'.
Workbench uses several well-known Linux packages to perform each action, avoiding re-inventing the wheel. It is used professionally by refurbishers and regular companies to register, prepare, and track their devices, and has great emphasis in data correctness. Workbench is free software from eReuse.org.
You can get Workbench directly in an ISO ready to use (go to workbench-live folder) or install it as a python package (see next section).
Workbench should work in any Linux as long as it has the packages below. It is guaranteed to work in Debian 9.
- Install the debian packages, like
the following way
cat requirements.debian.txt | sudo xargs apt install -y.
sudo pip3 install ereuse-workbench --pre -U
Note that you need to install this as sudo, as the software can only be run with root due to the tools it uses.
Execute Workbench through the CLI or directly in Python.
From a python file you can:
from ereuse_workbench.workbench import Workbench erwb = Workbench() # Check the docs of this class for more info erwb.run()
- Clone this repository and go to the repository main folder.
- Install Workbench as pip3 install -e .[test] -r requirements.txt.
- Run the tests with python3 setup.py test.
Note that you do not need to be root to execute tests, and that they can be executed in Mac and Windows, as they do not use any of the system tools, but stubs.
- Unsupported USB network adaptors.
- It cannot not install Windows OS.