Fork me on GitHub

Administration

Administration

Keeping Up to Date

See Updating.

Viewing Logs

See Monitoring Logs.

Managing Users

User management is currently handled via the oputil CLI.

Backing Up Your System

It is highly recommended to perform regular backups of your system. Nothing is worse than spending a lot of time setting up a system only to have to go away unexpectedly!

In general, simply creating a copy/archive of your system is enough for the default configuration. If you have changed default paths to point outside of your main ENiGMA½ installation take special care to ensure these are preserved as well. Database files may be in a state of flux when simply copying files. See Database Backups below for details on consistent backups.

Database Backups

SQLite’s CLI backup command can be used for creating database backup files. This can be performed as an additional step to a full backup to ensure the database is backed up in a consistent state (whereas simply copying the files does not make any guarantees).

As an example, consider the following Bash script that creates foo.sqlite3.backup files:

for dbfile in /path/to/enigma-bbs/db/*.sqlite3; do
    sqlite3 $dbfile ".backup '/path/to/db_backup/$(basename $dbfile).backup'"
done

Backup Tools

There are many backup solutions available across all platforms. Configuration of such tools is outside the scope of this documentation. With that said, the author has had great success with Borg.

General Maintenance Tasks

Vacuuming Database Files

SQLite database files become less performant over time and waste space. It is recommended to periodically vacuum your databases. Before proceeding, you should make a backup!

Example:

sqlite3 ./db/message.sqlite3 "vacuum;"