We're a team responsible for managing and improving the FreeBSD wiki.

• Email: wiki-admin@FreeBSD.org
• IRC: #freebsd-wiki at Libera.Chat IRC (ircs://irc.libera.chat:6697/freebsd-wiki)

• SSH: Hostname wbe-wiki.nyi.freebsd.org
• Note: Server is IPv6 only.
  • If you don't have IPv6, ProxyJump <ipv6-enabled-freebsd.org host first
• su to root with your Kerberos password. If you don't have one, ask ClusterAdmin

• Login to wiki host and su -l to root.
• Create user account: su -m www -c "/usr/local/bin/moin --config-dir=/home/www/wiki account create --name <UserName> --email <email>"
• Set the account_verification variable to empty in /home/www/wiki/data/user/<filename_id_returned_from_the_above_command>
• Ask user to reset password using the <UserName> above.
• Add <UserName> to ContributorsGroup, or DevelopersGroup (for @FreeBSD.org accounts)
  • If <UserName> is not a WikiName (i.e. it is all lowercase), edit the xyzGroup entry to make it a link to a prospective homepage.

This way, you make sure that whoever is claiming the account actually has that email. Otherwise, if you merely add a entry in the ACL list, any random person can immediately log in as that account and start making changes.

We do not delete user accounts, as history and referential integrity are affected. We disable/deactivate instead.

• Login to wiki host and su -l to root.
• Move the user account data file (<filename_id>) from data/users to data/users/obsolete

Note: This currently doesn't work, configuration is managed by clusteradm and auto deployed, so local changes are reverted – KubilayKocak 2020-06-21 13:40:33+1100

# cd /home/www/wiki
# cp -p wikiconfig.py wikiconfig.py.<datestamp>
# ee wikiconfig.py
make changes
# service apache24 restart

Moves deleted/trash pages to ~wiki/{trash,deleted}

# cd /home/www/wiki
# moin --config-dir=/home/www/wiki maint cleanpage > clean-<datestamp>.sh
review and verify clean-<datestamp>.sh contents
# sh clean-<datestamp>.sh

Cleans up expired sessions from ~wiki/data/cache/sessions

# cd /home/www/wiki
# moin --config-dir=/home/www/wiki maint cleansessions

Rebuilds the xapian search index (deleting the current index) in ~wiki/data/cache/xapian

Note: This must be run as User: www

# cd /home/www/wiki
# moin --config-dir=/home/www/wiki index build --mode=rebuild
# chown -R www:www data/cache/xapian