Introduction
We're a team responsible for managing and improving the FreeBSD wiki.
Contents
Team
- You! Please get in touch
This list should be kept in sync with the Project Administration page.
Contact
Email (much preferred): <wiki-admin AT FreeBSD DOT org>
Wiki Administration
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
Adding Users
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>
Send the user email to ask them to reset the password using the <UserName> above. (see note below if this fails.)
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 force it to be a link to a prospective homepage.
The ordering of sending email before editing the group is to 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.
If The User Cannot Log In
This will happen if e.g. the user's email is @gmail.com.
- You will have to genarate a random password for the user and then set it manually:
/usr/local/bin/moin account resetpw --name=<UserName> <password>
We use a locally modified /usr/local/bin/moin that forces the inclusion of wikiconfig.py. This is a bug in MoinMoin -- it says you don't have to do that.
Removing Users
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
Configuration Changes
Note: This currently doesn't work, configuration is managed by clusteradm and auto deployed, so local changes are reverted -- KubilayKocak 2020-06-21T02:40:33+0000
# cd /home/www/wiki # cp -p wikiconfig.py wikiconfig.py.<datestamp> # ee wikiconfig.py make changes # service apache24 restart
Clean Pages
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
Clean Sessions
Cleans up expired sessions from ~wiki/data/cache/sessions
# cd /home/www/wiki # moin --config-dir=/home/www/wiki maint cleansessions
Rebuild xapian search index
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