trueos / sysadm-ui-qt

Official repo forTrueOS's sysadm Qt based UI front-ends

FreeBSD Source:

This is the top level of the FreeBSD source directory. This file was last revised on: $FreeBSD$

FreeBSD is an operating system used to power modern servers, desktops, and embedded platforms. A large community has continually developed it for more than thirty years. Its advanced networking, security, and storage features have made FreeBSD the platform of choice for many of the busiest web sites and most pervasive embedded networking and storage devices.

For copyright information, please see the file COPYRIGHT in this directory. Additional copyright information also exists for some sources in this tree - please see the specific source directories for more information.

The Makefile in this directory supports a number of targets for building components (or all) of the FreeBSD source tree. See build(7), config(8), https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html, and https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html for more information, including setting make(1) variables.

Source Roadmap:

bin		System/user commands.

cddl		Various commands and libraries under the Common Development
		and Distribution License.

contrib		Packages contributed by 3rd parties.

crypto		Cryptography stuff (see crypto/README).

etc		Template files for /etc.

gnu		Various commands and libraries under the GNU Public License.
		Please see gnu/COPYING* for more information.

include		System include files.

kerberos5	Kerberos5 (Heimdal) package.

lib		System libraries.

libexec		System daemons.

release		Release building Makefile & associated tools.

rescue		Build system for statically linked /rescue utilities.

sbin		System commands.

secure		Cryptographic libraries and commands.

share		Shared resources.

stand		Boot loader sources.

sys		Kernel sources.

sys/<arch>/conf Kernel configuration files. GENERIC is the configuration
		used in release builds. NOTES contains documentation of
		all possible entries.

tests		Regression tests which can be run by Kyua.  See tests/README
		for additional information.

tools		Utilities for regression testing and miscellaneous tasks.

usr.bin		User commands.

usr.sbin	System administration commands.

For information on synchronizing your source tree with one or more of the FreeBSD Project's development branches, please see:

https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/current-stable.html

sysadm-ui-qt's Issues

Update Manager: Branches: no branch is listed

Enhancement request.

The GUI should list at least one branch.

User Manager field for 'User Name' allows characters that must be disallowed

For example: Joe Bloggs

If a user is added with that username then User Manager shows:

Joe (User &)
User Name Joe
Full Name User &
Home Dir Path /home/Joe

User Manager: full name entered, second name disappears

Example: for an entry 'Graham Perrin', the result following a save appears to be 'Graham'.

'System is up to date' is a calm observation, not a double alert !!

'System is up to date' requires no exclamation mark. The user need not be surprised.

User Manager: new user set to be an administrator and an operator, but not added to either group

Maybe a consequence of #25.

SysAdm: optimal column widths

Enhancement request.

Is it possible for the widths to be dynamically optimised, as the user narrows or broadens the SysAdmin window?

Update Manager belongs under both application management and system management

Enhancement request. Is it possible for the manager to appear in both categories?

At the moment: Application management tells us that the System is up-to-date.

AppCafe: clicking a listed item should select that item

Click Installed, then click one of the names.

Expected

Selection of the line (e.g. a change from black text on the white background, to white text on a blue background (should I say 'highlight' or 'focus' instead of selection?))

– and simple selection should neither check, nor clear a check from, the box in the Status column.

Actual result

Disappearance of the list, presentation of a row of tabs with a tag/label icon in the first tab.

AppCafe: search should probably be case-insensitive

Finding the ImageMagick package requires camel case.

Date is ambiguous in Update Manager

From @dlavigne on August 11, 2016 17:53

See attached screenshot for an example. Depending upon where you live in the world, the last check either occurred on Aug 11 or Nov 8. Specifically stating the month name would make this clear.

Copied from original issue: trueos/trueos-utils-qt5#4

SysAdm should alert the user when Life Preserver fails

Not a nagging alert, but there should be at least an unmistakable exclamation mark in lieu of (or overlaying) the SysAdm icon.

Yellow alert for anything that requires non-urgent attention.

Red alert when urgent attention is appropriate.

AppCafe item information: clicking 'Back' takes the user too far back

After viewing information for a listed/highlighted item, click Back.

Expected

The list, with the line (or multiple lines) still highlighted.

Actual result

Too far back: the Browse tab. After which the user must again click Installed to review what was truly one step back.

Before attending to this issue, I suggest priority to #17.

User Manager: 'Enable PersonaCrypt' does not work for import of a key

I tried a few times. There was no feedback from the GUI.

User Manager Details should include whether or not user has admin/operator access

When you create a new user, you have the option to grant administrator and/or operator access. However, once the user is created, the Details view doesn't indicate which users have what access.

User Manager: /home/ not consistent with /usr/home/

Consistency of appearance.

During a (first run) setup of TrueOS Desktop it's necessary to add a non-root user, and for that first user the base path for the home is:

/usr/home/

I understand that with the symlink at the root / of the file system, home -> /usr/home

Still, the visual inconsistency is not ideal. On more than one occasion I wondered whether the terse path was amongst the causes of PersonaCrypt not working as expected in a clean installation of the OS.

Life Preserver: Replication: work in progress disappears

Whilst working towards a first replication, with an address in the host IP field, I turned away and worked for a short while at a different computer.

When I looked back, SysAdm had lost sight of the Replication tab; instead there was the Schedules tab.

Reproducible.

pc-mixer should grey out PulseAudio settings if not installed

Since Pulseaudio is no longer installed by default, it is confusing to the user to have these options do nothing upon click. Either having them greyed out or providing a helpful message on click that pulseaudio needs to be installed using AppCafe would alleviate this confusion.

Life Preserver: Snapshots: pool selected, selection is lost

Consequent to #1 I clicked the Snapshots tab and found that the previously selected pool was no longer selected.

Icon size too large for default padding

https://github.com/trueos/sysadm-ui-qt/blob/master/src-qt5/gui_client/pages/page_devices.cpp#L14

Should we increase the padding space or decrease the icon size?

SysAdm should allow the user to prefer a maximum number of boot environments

From @grahamperrin on September 4, 2016 15:30

Enhancement request.

If I recall correctly, with PC-BSD the preference could be no greater than 10.

For TrueOS, which is likely to gain boot environments more often, there should be a greater allowance.

Copied from original issue: trueos/sysadm#25

SysAdm: previously disclosed categories should not be closed in response to 'Back'

SysAdm is much improved 👍 but still, there's the repeated, frequent annoyance of premature closure of things that were disclosed.

For example: if a user discloses all categories before using Life Preserver, then a click on the back arrow should not close all those things.

Repeated reopening/disclosing is tedious, and having the phrase Control Panel alongside the back arrow does not reduce the annoyance of the unexpected, undesirable result of a click on that arrow.

Boot-up configuration: use plain English/language (not 'NR')

Enhancement request.

NR is intuitive only if the user is familiar with command-line use of beadm.

Consider a design that will allow newcomers to understand boot environments.

User Manager: when adding a user, the red alert (halo) should disappear from the password field as soon as an adequate word/phrase has been typed

In other words, do not require the person typing to go beyond the password field.

It should be possible to click 'Save' whilst the cursor is still in that field.

User Manager: apparent blank line or white space above the topmost line when adding a user to a group

AppCafe: case-insensitive sorting of lists when browsing and searching

Enhancement request.

AFAIR something like this enhancement was made a few months ago for a legacy AppCafe.

AppCafe: for information, an 'i' icon might be better than the tag/label icon

Related: the actual (unexpected) result in #17

An 'i' within a circle. Maybe italicised, reminiscent of the widely recognised symbol for tourist information.

Update Manager should describe the standard repository (or repositories)

If no custom repository is entered by the user:

• the GUI should describe, in plain English/translation, the (iXsystems-provided) repository that is the default (if iXsystems will not maintain more than one), or selected.

Expect some users who were familiar with PC-BSD to wonder whether the TrueOS default will be closer, in principle, to edge than to production. The GUI can offer the simplest possible explanation (and then the user may seek additional information from the handbook, a blog post, release notes or whatever).

Consistent use of the word 'pool' (never zpool to describe a pool)

Under the Schedules tab of Life Preserver, one of the headings is Zpool. That should be Pool.

Under the Snapshots tab, there's the phrase ZFS Pool. That might be simplified to Pool.

And so on … if I find more examples, I'll add to this issue.

Update Manager should offer (maybe link to) details of an update before the user chooses to apply that update

Enhancement request.

With SysAdm as is, selecting an update reveals no additional information; there's just the name/identifier.

This area of the GUI might be a good place to link to (or represent relevant content from) https://raw.githubusercontent.com/trueos/trueos-changelog/master/CHANGELOG

Life Preserver: Replication: ambiguity between 'Start' and 'Initialise'

… or 'Initialize', for you crazy Americans :)

Either way, there's ambiguity and a visit to the handbook should be unnecessary.

What might be a better word for one of the two? Maybe 'Reinitialise'?

There's a small, indistinct circular icon on one of the two clouds, if I look closely I see that the circle comprises two arrows. To a Mac user, that's reminiscent of Time Machine (or sync; Apple often misused the sync icon (clockwise) in a Time Machine context (where arrows should have been counterclockwise)).

SysAdm should respond to Control-W and Control-Q

Close; Quit

Upate Manager: do not show 'System is up to date' during a check

Whilst a check progresses, it's sometimes noticeable that the 'System is up to date' banner remains (falls below) the checking banner.

Enhancement request: never show both at the same time.

Allow the user to tell whether a Life Preserver replication is running

Enhancement request.

As a workaround, I have open a terminal window with an ssh connection to FreeNAS, running –

zpool iostat tallhalf 5

– where tallhalf is the name of the pool that includes the dataset.

User Manager: password entered but 'Save' does not save the password to /etc/master.passwd

Maybe a consequence of #25.

I realised this bug whilst troubleshooting apparent rejection of credentials for a PersonaCrypt login.

Multiple GUI-based attempts to set/save the password did not work around the rejections. Eventually,

sudo cat /etc/master.passwd

– I realised that there was no hash in the line for the affected user.

AFAIR I worked around the problem by overtyping in the full name field (to work around the disappearance of my surname, Perrin) with 'GrahamPerrin' and then retyping my password and then tabbing beyond the password field and finally clicking 'Save'.