====== Introduction ======

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

====== Team ======

{{page>/WikiAdminGroup&nofooter&noeditbtn}}

====== Contact ======

  * Email: <wiki-admin@FreeBSD.org>
  * 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

===== 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>**
  * 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.

===== 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-21 13:40:33+1100

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

===== Clean Pages =====

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

<code>
# 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
</code>

===== Clean Sessions =====

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

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

===== 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

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

----

{{tag>Team Wiki}}