-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
88 lines (62 loc) · 3.07 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
RTFM (The RT FAQ Manager) is a tool for maintaining an organizational
knowledgebase. Out of the box, it integrates with RT 3.4.2 or later
(Also available from bestpractical.com)
If you are running RT 4, you should not install RTFM. RT 4.0.0 shipped
with Articles, which includes all of the functionality of RTFM along with
some new features. If you were using RTFM with an older version of RTFM,
RT now contains upgrade instructions for migrating your data.
Best Practical sells support and customization for RT and RTFM. Feel
free to contact us at sales@bestpractical.com if you have any
questions about our service offerings.
RTFM requires a few modules in addition to RT's standard dependencies.
The 'perl Makefile.PL' command will check that you have all of the
required modules installed; if not, they will either be auto-installed
during the 'make' step, or you can opt to install them by hand using
the CPAN shell or with any system-specific package management software
you may have.
Installation instructions:
--------------------------
NOTE that upgrade steps are described in UPGRADING
1) Install RT 3.4.2 or newer.
Do not use this with 3.8.0 as there are incompatibilities.
Any other release of RT 3.8 is fine.
2) Once RT appears to be happily installed, cd into the directory
where you unpacked RTFM.
3) perl Makefile.PL
4) make install
5) make initdb
6) If you are running 3.8, you need to enable RTFM in your
RT_SiteConfig.pm file. You can do this by adding the following
line:
Set(@Plugins,qw(RT::FM));
If you already have a @Plugins line, you must add RT::FM to your
existing plugin list.
7) Clear your mason cache. This is most often accomplished with
rm -rf /opt/rt3/var/mason_data/*
8) Stop and start your web server
9) Before you can add content to RTFM articles, you will need to configure
classes and custom fields. For details, see lib/RT/FM/Introduction.pod
Further reading:
-----------------------------------------------------
lib/RT/FM/Introduction.pod - quick overview and configuration
You can read this using the perldoc utility, viewing the
source or using the RT-OnlineDocs extension
Development
------------------------------------------------------
If you would like to run RTFM's tests, you need to
set a few environment variables
RT_DBA_USER - a user who can create a database on your
RDBMS (such as root on mysql)
RT_DBA_PASSWORD - the password for RT_DBA_USER
PERL5LIB - the path to your RT libraries (/opt/rt3/lib)
RT_DBA_USER=user RT_DBA_PASSWORD=password PERL5LIB=/opt/rt3/lib make test
These are intended to be run before installing RTFM.
Like RT, RTFM expects to be able to create a new database called rt3test
on your system.
Bug reporting and discussion lists:
-----------------------------------------------------
You probably want to discuss RTFM on rt-users@lists.bestpractical.com.
(Send mail to rt-users-request@lists.fsck.com to subscribe)
Bug reports can be sent to rtfm-bugs@bestpractical.com. You can look
at open bug reports at http://rt3.fsck.com/. Log in as guest/guest
to see the content of bug reports.