www/151643: RT38 upgrade directory location

[Steve Scally]

>Number:         151643
>Category:       www
>Synopsis:       RT38 upgrade directory location
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-www
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Oct 22 20:50:01 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Steve Scally
>Release:        7.2-RELEASE-p3
>Organization:
MailerMailer, LLC
>Environment:
FreeBSD sandbox FreeBSD 7.2-RELEASE-p3 #0: Thu Aug  6 11:55:21 EDT 2009     root at staging/n/yertle1/sources/usr7/obj.amd64/n/yertle1/sources/usr7/src/sys/KCI64SMP  amd64
>Description:
This setup is to test the upgrade from RT 3.6.7 to RT 3.8.8.  After installing /usr/ports/www/rt38 with the following options enabled

MYSQL=off "Enable MySQL backend"
APACHE=on "Enable www/apache22 server"
MODPERL=off "Enable mod_perl support"
POSTGRESQL=on "Enable Postgresql backend"
ORACLE=off "Enable Oracle backend"
SQLITE=off "Enable SQLite backend"
DEV=off "Configure for Developers"
STANDALONE=off "Enable standalone server"
FASTCGI=on "Enable FastCGI support"
GRAPHVIZ=on "Enable GraphViz charts"

I found that running the rt-setup-database --action upgrade command was failing with the following message

Couldn't finish 'upgrade' step.

ERROR: Couldn't read dir './etc/upgrade' with upgrade data

I looked in /usr/local/share/rt38/etc and there was no upgrade directory as well as in /usr/local/etc/rt38.  Where I did find the upgrade directory was in the port working directory of /var/tmp/usr/ports/www/rt38/work/rt-3.8.8 Once I navigated to that directory and ran  "rt-setup-database --action upgrade" the upgrade proceeded with out the message above.

I wasn't sure if this was by design or not but maybe copying the upgrade directory to /usr/local/share/rt38/etc directory as part of the install would resolve this issue.
>How-To-Repeat:
1. Remove all ports on system : pkg_delete -va
2. Install rt38 : cd /usr/ports/www/rt38 ; make install
3. Check /usr/local/share/rt38/etc and /usr/local/etc/rt38 for upgrade directory.
>Fix:
Suggestion :

Copy the upgrade directory to /usr/local/share/rt38/etc as part of the installation.

Other files such as README and UPGRADING should be placed in /usr/local/etc/rt38.  The docs directory could be put in /usr/local/share/rt38.  Most people will look for these directories since the RT site lists them as the place to go first for information.

URL: http://bestpractical.com/rt/docs.html

"RT's source also includes useful documentation, such as the README and the "docs" directory."

>Release-Note:
>Audit-Trail:
>Unformatted: