Exaion
Using the Agent

Prepare a session in advance

Fill in the session file once, so the agent knows who carries out the erasure and how many passes to write, without typing it at each session.

The session file, exawipe.conf, holds the values a technician would otherwise type at each session: who carries out the erasure, your organization's free fields, and the number of overwrite passes. It sits on the USB stick, or on the reports key when you start from a CD.

The values are declarations. The agent writes them into the proof as they are, without checking what they say. The file can never choose the mode, the erasure method or the disks: those are decided at the boot menu and during the session.

Fill in the file

Let the agent write the file

Start one session from the stick. When the file is missing, the agent writes it, with a comment above each value that explains it. In interactive mode, it then asks you for the values on the screen. In non-interactive mode, it stops before listing any disk with No operator name or email: set one under [performer] in exawipe.conf. Nothing is erased.

Open the stick on a computer

Plug the stick into a Windows, macOS or Linux computer. It shows a drive named WipeReports. Open exawipe.conf at its root with a plain text editor, such as Notepad, TextEdit or gedit.

Type the values

Type each value after the = of its line. Give at least a name or an email under [performer]: a non-interactive session refuses to start without one. Leave a line empty after the = for a value you do not want to give.

Save and eject

Save the file, then eject the drive before you unplug the stick. Every later session reads it. The agent never writes over the file once it exists.

A filled file looks like this:

[performer]
name = Jane Martin
title = Asset recovery technician
organization = Acme Services
location = Lyon warehouse
phone =
email = jane.martin@example.com

[fields]
Batch = B-2026-114

[overwrite]
passes = 1

The file holds names and email addresses in plain text. Keep the stick as you would keep a list of your technicians.

What the file holds

SectionValues
[performer]The person carrying out the erasure: name, title (job title), organization, location (where the erasure takes place), phone, email.
[fields]Your organization's free fields, one label = value per line.
[overwrite]passes: 1 for one pass of zeroes, 3 for DoD 5220.22-M. Any other number, 0 included, gives three passes. It applies to magnetic disks only; flash media always get one pass.

Free fields are labels your organization adds to its proofs, such as a batch or a contract number. When your organization's ISO defines them, the file lists them already and only those labels are taken. When it defines none, you may write up to four of your own. A label can only come from the ISO or the file: none can be added during the session.

During the session

Interactive mode. After you choose the recording profile, the agent shows Person carrying out the erasure: with the six values from the file, then, when there are any, the free fields under Free fields, declarative, not checked by the agent:. You can change any value before confirming (Confirm the details on the screen, y on a console). What you type is used for this session only: it is not saved in the file. The proof records the values you confirmed. See An interactive session, step by step.

Non-interactive mode. The agent asks nothing and uses the file's values as they are. Without a name or an email, the session stops before listing any disk: see When no name or email is found.

The number of passes from the file holds unless you change it at the last confirmation before erasing, see How disks are erased.

When no name or email is found

In non-interactive mode, the session stops before listing any disk when it finds neither a name nor an email for the person carrying out the erasure. Nothing is erased. The message says where the agent looked, which is where to add one:

MessageWhere to add a name or an email
No operator name or email: set one under [performer] in exawipe.confIn the session file on the stick, see Fill in the file
No operator name or email on the kernel command line: add exawipe.performer.name or .emailOn the kernel command line, see Technical details
No operator name or email in the file at the URL of exawipe.config: add one under [performer]In the file the agent downloads
No operator name or email: the session file at the URL of exawipe.config could not be fetchedIn the file the agent downloads, once the download works: check the address and the network, see Technical details

A non-interactive session stopped because the session file gives no name and no email

When a line is wrong

A mistake in the file never blocks an erasure. The agent skips the line it cannot use, keeps the rest, and shows one notice per problem on the first screen of the session, with the line number. For example:

exawipe.conf, line 12: unknown key, not taken.

Check the line, correct the file on a computer, and start a new session. The agent reads the file once, at the start of the session.

Technical details

Contents