Freenas Notes
Notes on non-standard things I've done and hack band-aids that I've patched to keep the ship from sinking
Band-aids and Misc.
To restart the TN web ui when it freezes or becomes unresponsive:
- ssh into nas
-
sudo service middlewared restart
- command might have to get repeated a few times if the restart hangs on "waiting for PID ###"
Getting SMB shares to work right:
The permissions seen in a mounted SMB share (on a remote device) are NOT what the literal permissions are on the TN dataset! those permissions can't be trusted, they can only be changed (for real) from the TN system itself! SMB share settings in TN are basically left at the default, with one addition in auxillary parameters:
inherit permissions = yes
This makes newly created files & folders inherit the permissions structure of the parent directory. Now newly scraped contet from *arr trackers will inherit the (correct) permissions from the parent folder, no need to worry about umask settings in the trackers themselves.
APC UPS Setup
How to set up UPS monitoring via USB, for APC UPS models.
-
Plug in the USB cable (dur)
-
Edit the UPS service in TrueNas:
2.1: Choose USB driver with closest match to APC UPS model, and choose correct USB device (usually something like
/dev/ugenX.X
) and set UPS name to simplyups
2.2: DO NOT check
Remote Monitor
2.3: Add Monitor user and password, copy same info into the
extra users
section in this format (note brackets!):[{username}] password = {password} actions = set actions = fsd instcmds = all
2.4: Set shutdown to "UPS Reaches Low Battery", set command to:
shutdown -p +1 "System is shutting down due to low UPS battery!"
2.5: DO NOT set up email alerts! (otherwise you get two sets for each event due to system alerting!)
2.6: Add
MAXAGE 25
to the "Auxilary Parameters (upsd.conf)" box (prevents occasional 'connection to UPS lost' errors) -
Enable the service!
-
Check box to auto-start service.
Checking UPS status and changing parameters remotely:
- Check status of UPS (get all stats):
upsc ups@localhost
- List commands that can be run from the terminal for a particular UPS:
upscmd -u [username] -p [password] -l ups@localhost
- Run a command on a UPS:
upscmd -u [username] -p [password] ups@localhost command.name.here
Typical commands:
-
test.start.battery.quick
-
test.start.battery.deep
-
test.start.battery.stop
-
beeper.disable
-
beeper.enable