This is an old revision of the document!


Introduction

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

Team

This list should be kept in sync with the Project Administration page.


Contact

  • IRC: #freebsd-wiki at Libera.Chat IRC (ircs://irc.libera.chat:6697/freebsd-wiki)

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

While every developer can add new developers directly to (e.g.) DevelopersGroup, MarkLinimon was told to do things differently due to security concerns.

  • Login to wiki host and su -l to root
  • Create the 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>
  • Ask the user to reset the password for the <UserName> created above.
  • Add the <UserName> to ContributorsGroup, or DevelopersGroup for @FreeBSD.org accounts
    • If the <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 immediatelly log in as that account and start making changes.

:!: MarkLinimon could use help generalizing his shell script to perform the first two tasks.

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

  • wikiadmin.1644972798.txt.gz
  • Last modified: 2022/02/16 00:53
  • by KubilayKocak