devel/rt3/MESSAGE

   1 ===========================================================================
   2 $NetBSD: MESSAGE,v 1.5 2011/02/27 17:05:57 spz Exp $
   3
   4 You must configure RT by editing ${PKG_SYSCONFDIR}/RT_SiteConfig.pm.
   5
   6 To initialize the RT database, run
   7
   8         ${PREFIX}/sbin/rt-setup-database --action init \
   9             --dba dbadmin --prompt-for-dba-password \
  10             --datadir ${RTSHAREDIR}/etc
  11
  12 as a user in the ${RT_GROUP} group or as superuser.  In the previous
  13 command-line, 'dbadmin' stands for the database administrator's username,
  14 e.g. 'root' for MySQL.
  15
  16 To upgrade the RT database from an older version, look in
  17 ${PREFIX}/share/rt3/etc/upgrade, and for each version newer than the one
  18 previously used, do the following:
  19
  20         ${PREFIX}/sbin/rt-setup-database --action schema \
  21             --dba dbadmin --prompt-for-dba-password \
  22             --datadir ${RTSHAREDIR}/etc/upgrade/<version>
  23         ${PREFIX}/sbin/rt-setup-database --action acl \
  24             --dba dbadmin --prompt-for-dba-password \
  25             --datadir ${RTSHAREDIR}/etc/upgrade/<version>
  26         ${PREFIX}/sbin/rt-setup-database --action insert \
  27             --dba dbadmin --prompt-for-dba-password \
  28             --datadir ${RTSHAREDIR}/etc/upgrade/<version>
  29
  30 You might also want to clear the Mason cache:
  31
  32         rm -Rf ${RTVARDIR}/mason_data/obj
  33
  34 UPGRADING FROM 3.8.8 and earlier:
  35
  36 Previous versions of RT used a password hashing scheme which was too
  37 easy to reverse, which could allow attackers with read access to the
  38 RT database to possibly compromise users' passwords.  Even if RT does
  39 no password authentication itself, it may still store these weak
  40 password hashes -- using ExternalAuth does not guarantee that you are
  41 not vulnerable!  To upgrade stored passwords to a stronger hash, run:
  42
  43     perl ${RTSHAREDIR}/etc/vulnerable-passwords
  44
  45 at this point.
  46
  47 For other upgrading actions, see ${RTSHAREDIR}/etc/UPGRADING
  48
  49 See also the manual on ${HOMEPAGE}docs.html
  50 ===========================================================================