1 # BEGIN BPS TAGGED BLOCK {{{
5 # This software is Copyright (c) 1996-2011 Best Practical Solutions, LLC
6 # <sales@bestpractical.com>
8 # (Except where explicitly superseded by other copyright notices)
13 # This work is made available to you under the terms of Version 2 of
14 # the GNU General Public License. A copy of that license should have
15 # been provided with this software, but in any event can be snarfed
18 # This work is distributed in the hope that it will be useful, but
19 # WITHOUT ANY WARRANTY; without even the implied warranty of
20 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21 # General Public License for more details.
23 # You should have received a copy of the GNU General Public License
24 # along with this program; if not, write to the Free Software
25 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
26 # 02110-1301 or visit their web page on the internet at
27 # http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
30 # CONTRIBUTION SUBMISSION POLICY:
32 # (The following paragraph is not intended to limit the rights granted
33 # to you to modify and distribute this software under the terms of
34 # the GNU General Public License and is only of importance to you if
35 # you choose to contribute your changes and enhancements to the
36 # community by submitting them to Best Practical Solutions, LLC.)
38 # By intentionally submitting any modifications, corrections or
39 # derivatives to this work, or any other work intended for use with
40 # Request Tracker, to Best Practical Solutions, LLC, you confirm that
41 # you are the copyright holder for those contributions and you grant
42 # Best Practical Solutions, LLC a nonexclusive, worldwide, irrevocable,
43 # royalty-free, perpetual, license to use, copy, create derivative
44 # works based on those contributions, and sublicense and distribute
45 # those contributions and any derivatives thereof.
47 # END BPS TAGGED BLOCK }}}
49 # DO NOT HAND-EDIT the file named 'Makefile'. This file is autogenerated.
50 # Have a look at "configure" and "Makefile.in" instead
55 INSTALL = /usr/bin/install -c
59 CONFIG_FILE_PATH = /opt/rt3/etc
60 CONFIG_FILE = $(CONFIG_FILE_PATH)/RT_Config.pm
61 SITE_CONFIG_FILE = $(CONFIG_FILE_PATH)/RT_SiteConfig.pm
68 RT_VERSION = $(RT_VERSION_MAJOR).$(RT_VERSION_MINOR).$(RT_VERSION_PATCH)
69 TAG = rt-$(RT_VERSION_MAJOR)-$(RT_VERSION_MINOR)-$(RT_VERSION_PATCH)
72 # This is the group that all of the installed files will be chgrp'ed to.
76 # User which should own rt binaries.
79 # User that should own all of RT's libraries, generally root.
82 # Group that should own all of RT's libraries, generally root.
91 # {{{ Files and directories
93 # DESTDIR allows you to specify that RT be installed somewhere other than
94 # where it will eventually reside. DESTDIR _must_ have a trailing slash
102 RT_ETC_PATH = /opt/rt3/etc
103 RT_BIN_PATH = /opt/rt3/bin
104 RT_SBIN_PATH = /opt/rt3/sbin
105 RT_LIB_PATH = /opt/rt3/lib
106 RT_MAN_PATH = /opt/rt3/man
107 RT_VAR_PATH = /opt/rt3/var
108 RT_DOC_PATH = /opt/rt3/share/doc
109 RT_FONT_PATH = /opt/rt3/share/fonts
110 RT_LOCAL_PATH = /opt/rt3/local
111 LOCAL_PLUGIN_PATH = /opt/rt3/local/plugins
112 LOCAL_ETC_PATH = /opt/rt3/local/etc
113 LOCAL_LIB_PATH = /opt/rt3/local/lib
114 LOCAL_LEXICON_PATH = /opt/rt3/local/po
115 MASON_HTML_PATH = /var/www/freeside/rt
116 MASON_LOCAL_HTML_PATH = /opt/rt3/local/html
117 MASON_DATA_PATH = /usr/local/etc/freeside/masondata
118 MASON_SESSION_PATH = /opt/rt3/var/session_data
119 RT_LOG_PATH = /opt/rt3/var/log
121 # RT_READABLE_DIR_MODE is the mode of directories that are generally meant
123 RT_READABLE_DIR_MODE = 0755
128 # {{{ all these define the places that RT's binaries should get installed
130 # RT_MODPERL_HANDLER is the mason handler script for mod_perl
131 RT_MODPERL_HANDLER = webmux.pl
132 # RT_STANDALONE_SERVER is a stand-alone HTTP server
133 RT_STANDALONE_SERVER = standalone_httpd
134 # RT_SPEEDYCGI_HANDLER is the mason handler script for SpeedyCGI
135 RT_SPEEDYCGI_HANDLER = mason_handler.scgi
136 # RT_FASTCGI_HANDLER is the mason handler script for FastCGI
137 RT_FASTCGI_HANDLER = mason_handler.fcgi
138 # RT_FASTCGI_SERVER is the FastCGI server
139 RT_FASTCGI_SERVER = fastcgi_server
140 # RT_WIN32_FASTCGI_HANDLER is the mason handler script for FastCGI
141 RT_WIN32_FASTCGI_HANDLER = mason_handler.svc
145 RT_MAILGATE_BIN = rt-mailgate
147 RT_CRON_BIN = rt-crontool
152 BINARIES = $(RT_MODPERL_HANDLER) \
156 $(RT_STANDALONE_SERVER) \
157 $(RT_SPEEDYCGI_HANDLER) \
158 $(RT_FASTCGI_HANDLER) \
159 $(RT_FASTCGI_SERVER) \
160 $(RT_WIN32_FASTCGI_HANDLER)
166 SYSTEM_BINARIES = rt-attributes-viewer \
170 rt-email-dashboards \
171 rt-email-group-admin \
174 rt-test-dependencies \
180 ETC_FILES = acl.Informix \
198 WEB_HANDLER = modperl2
205 # DB_TYPE defines what sort of database RT trys to talk to
206 # "mysql" is known to work.
207 # "Pg" is known to work
208 # "Informix" is known to work
212 # Set DBA to the name of a unix account with the proper permissions and
213 # environment to run your commandline SQL sbin
215 # Set DB_DBA to the name of a DB user with permission to create new databases
217 # For mysql, you probably want 'root'
218 # For Pg, you probably want 'postgres'
219 # For Oracle, you want 'system'
220 # For Informix, you want 'informix'
226 # If you're not running your database server on its default port,
227 # specifiy the port the database server is running on below.
228 # It's generally safe to leave this blank
236 # Set this to the canonical name of the interface RT will be talking to the
237 # database on. If you said that the RT_DB_HOST above was "localhost," this
238 # should be too. This value will be used to grant rt access to the database.
239 # If you want to access the RT database from multiple hosts, you'll need
240 # to grant those database rights by hand.
243 DB_RT_HOST = localhost
245 # set this to the name you want to give to the RT database in
246 # your database server. For Oracle, this should be the name of your sid
248 DB_DATABASE = freeside
249 DB_RT_USER = freeside
255 TEST_FILES = t/*.t t/*/*.t
259 ####################################################################
264 @echo "Please read RT's README before beginning your installation."
269 @echo "Congratulations. RT is now installed."
272 @echo "You must now configure RT by editing $(SITE_CONFIG_FILE)."
274 @echo "(You will definitely need to set RT's database password in "
275 @echo "$(SITE_CONFIG_FILE) before continuing. Not doing so could be "
276 @echo "very dangerous. Note that you do not have to manually add a "
277 @echo "database user or set up a database for RT. These actions will be "
278 @echo "taken care of in the next step.)"
280 @echo "After that, you need to initialize RT's database by running"
281 @echo " 'make initialize-database'"
285 @echo "Congratulations. RT has been upgraded. You should now check over"
286 @echo "$(CONFIG_FILE) for any necessary site customization. Additionally,"
287 @echo "you should update RT's system database objects by running "
288 @echo " $(RT_SBIN_PATH)/rt-setup-database --dba $(DB_DBA) --prompt-for-dba-password --action upgrade"
291 upgrade: testdeps config-install dirs files-install fixperms upgrade-instruct
293 upgrade-noclobber: config-install dirs libs-install html-install bin-install local-install doc-install font-install fixperms
298 my_with_web_handlers= $(shell $(PERL) -e 'print join " ", map "--with-$$_", grep defined && length, split /,/, "$(WEB_HANDLER)"')
300 $(PERL) ./sbin/rt-test-dependencies --verbose --with-$(DB_TYPE) $(my_with_web_handlers)
305 $(PERL) ./sbin/rt-test-dependencies --verbose --install --with-$(DB_TYPE) $(my_with_web_handlers)
311 # Make the libraries readable
312 chmod $(RT_READABLE_DIR_MODE) $(DESTDIR)$(RT_PATH)
313 chown -R $(LIBS_OWNER) $(DESTDIR)$(RT_LIB_PATH)
314 chgrp -R $(LIBS_GROUP) $(DESTDIR)$(RT_LIB_PATH)
315 chmod -R u+rwX,go-w,go+rX $(DESTDIR)$(RT_LIB_PATH)
318 chmod $(RT_READABLE_DIR_MODE) $(DESTDIR)$(RT_BIN_PATH)
320 chmod 0755 $(DESTDIR)$(RT_ETC_PATH)
321 cd $(DESTDIR)$(RT_ETC_PATH) && chmod 0400 $(ETC_FILES) || true
323 #TODO: the config file should probably be able to have its
324 # owner set separately from the binaries.
325 chown -R $(BIN_OWNER) $(DESTDIR)$(RT_ETC_PATH)
326 chgrp -R $(RTGROUP) $(DESTDIR)$(RT_ETC_PATH)
328 chmod 0440 $(DESTDIR)$(CONFIG_FILE)
329 chmod 0640 $(DESTDIR)$(SITE_CONFIG_FILE)
331 # Make the system binaries
332 cd $(DESTDIR)$(RT_BIN_PATH) && ( chmod 0755 $(BINARIES) ; chown $(BIN_OWNER) $(BINARIES); chgrp $(RTGROUP) $(BINARIES))
334 # Make the system binaries executable also
335 cd $(DESTDIR)$(RT_SBIN_PATH) && ( chmod 0755 $(SYSTEM_BINARIES) ; chown $(BIN_OWNER) $(SYSTEM_BINARIES); chgrp $(RTGROUP) $(SYSTEM_BINARIES))
337 # Make the web ui readable by all.
338 chmod -R u+rwX,go-w,go+rX $(DESTDIR)$(MASON_HTML_PATH) \
339 $(DESTDIR)$(MASON_LOCAL_HTML_PATH) \
340 $(DESTDIR)$(LOCAL_LEXICON_PATH)
341 chown -R $(LIBS_OWNER) $(DESTDIR)$(MASON_HTML_PATH) \
342 $(DESTDIR)$(MASON_LOCAL_HTML_PATH)
343 chgrp -R $(LIBS_GROUP) $(DESTDIR)$(MASON_HTML_PATH) \
344 $(DESTDIR)$(MASON_LOCAL_HTML_PATH)
346 # Make the web ui's data dir writable
347 chmod 0770 $(DESTDIR)$(MASON_DATA_PATH) \
348 $(DESTDIR)$(MASON_SESSION_PATH)
349 chown -R $(WEB_USER) $(DESTDIR)$(MASON_DATA_PATH) \
350 $(DESTDIR)$(MASON_SESSION_PATH)
351 chgrp -R $(WEB_GROUP) $(DESTDIR)$(MASON_DATA_PATH) \
352 $(DESTDIR)$(MASON_SESSION_PATH)
357 $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_LOG_PATH)
358 $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_FONT_PATH)
359 $(INSTALL) -m 0770 -d $(DESTDIR)$(MASON_DATA_PATH)
360 $(INSTALL) -m 0770 -d $(DESTDIR)$(MASON_DATA_PATH)/cache
361 $(INSTALL) -m 0770 -d $(DESTDIR)$(MASON_DATA_PATH)/etc
362 $(INSTALL) -m 0770 -d $(DESTDIR)$(MASON_DATA_PATH)/obj
363 $(INSTALL) -m 0770 -d $(DESTDIR)$(MASON_SESSION_PATH)
364 $(INSTALL) -m 0755 -d $(DESTDIR)$(MASON_HTML_PATH)
365 $(INSTALL) -m 0755 -d $(DESTDIR)$(MASON_LOCAL_HTML_PATH)
366 $(INSTALL) -m 0755 -d $(DESTDIR)$(LOCAL_ETC_PATH)
367 $(INSTALL) -m 0755 -d $(DESTDIR)$(LOCAL_LIB_PATH)
368 $(INSTALL) -m 0755 -d $(DESTDIR)$(LOCAL_PLUGIN_PATH)
369 $(INSTALL) -m 0755 -d $(DESTDIR)$(LOCAL_LEXICON_PATH)
372 install: testdeps config-install dirs files-install fixperms instruct
374 files-install: libs-install etc-install config-install bin-install sbin-install html-install local-install doc-install font-install
377 $(INSTALL) -m 0755 -o $(BIN_OWNER) -g $(RTGROUP) -d $(DESTDIR)$(CONFIG_FILE_PATH)
378 -$(INSTALL) -m 0440 -o $(BIN_OWNER) -g $(RTGROUP) etc/RT_Config.pm $(DESTDIR)$(CONFIG_FILE)
379 [ -f $(DESTDIR)$(SITE_CONFIG_FILE) ] || $(INSTALL) -m 0640 -o $(BIN_OWNER) -g $(RTGROUP) etc/RT_SiteConfig.pm $(DESTDIR)$(SITE_CONFIG_FILE)
380 @echo "Installed configuration. About to install RT in $(RT_PATH)"
383 $(PERL) "-MExtUtils::Command::MM" -e "test_harness($(TEST_VERBOSE), 'lib')" $(TEST_FILES)
385 parallel-test: test-parallel
388 RT_TEST_PARALLEL=1 HARNESS_OPTIONS="j4" $(PERL) "-MExtUtils::Command::MM" -e "test_harness($(TEST_VERBOSE), 'lib')" $(TEST_FILES)
390 regression-install: config-install
391 $(PERL) -pi -e 's/Set\(\$$DatabaseName.*\);/Set\(\$$DatabaseName, "rt3regression"\);/' $(DESTDIR)$(CONFIG_FILE)
393 # {{{ database-installation
395 regression-reset-db: force-dropdb
396 $(PERL) -I$(LOCAL_LIB_PATH) -I$(RT_LIB_PATH) sbin/rt-setup-database --action init --dba $(DB_DBA) --dba-password ''
398 initdb :: initialize-database
401 $(PERL) -I$(LOCAL_LIB_PATH) -I$(RT_LIB_PATH) sbin/rt-setup-database --action init --dba $(DB_DBA) --prompt-for-dba-password
404 $(PERL) -I$(LOCAL_LIB_PATH) -I$(RT_LIB_PATH) sbin/rt-setup-database --action drop --dba $(DB_DBA) --prompt-for-dba-password
407 $(PERL) -I$(LOCAL_LIB_PATH) -I$(RT_LIB_PATH) sbin/rt-setup-database --action drop --dba $(DB_DBA) --dba-password '' --force
413 [ -d $(DESTDIR)$(RT_LIB_PATH) ] || $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_LIB_PATH)
414 -( cd lib && find . -type d -print ) | while read dir ; do \
415 $(INSTALL) -m 0755 -d "$(DESTDIR)$(RT_LIB_PATH)/$$dir" ; \
417 -( cd lib && find . -type f -print ) | while read file ; do \
418 $(INSTALL) -m 0644 "lib/$$file" "$(DESTDIR)$(RT_LIB_PATH)/$$file" ; \
424 [ -d $(DESTDIR)$(MASON_HTML_PATH) ] || $(INSTALL) -m 0755 -d $(DESTDIR)$(MASON_HTML_PATH)
425 -( cd share/html && find . -type d -print ) | while read dir ; do \
426 $(INSTALL) -m 0755 -d "$(DESTDIR)$(MASON_HTML_PATH)/$$dir" ; \
428 -( cd share/html && find . -type f -print ) | while read file ; do \
429 $(INSTALL) -m 0644 "share/html/$$file" "$(DESTDIR)$(MASON_HTML_PATH)/$$file" ; \
435 [ -d $(DESTDIR)$(RT_FONT_PATH) ] || $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_FONT_PATH)
436 -( cd share/fonts && find . -type f -print ) | while read file ; do \
437 $(INSTALL) -m 0644 "share/fonts/$$file" "$(DESTDIR)$(RT_FONT_PATH)/$$file" ; \
443 # RT 3.0.0 - RT 3.0.2 would accidentally create a file instead of a dir
444 -[ -f $(DESTDIR)$(RT_DOC_PATH) ] && rm $(DESTDIR)$(RT_DOC_PATH)
445 [ -d $(DESTDIR)$(RT_DOC_PATH) ] || $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_DOC_PATH)
446 -$(INSTALL) -m 0644 ./README $(DESTDIR)$(RT_DOC_PATH)/
452 [ -d $(DESTDIR)$(RT_ETC_PATH) ] || $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_ETC_PATH)
453 for file in $(ETC_FILES) ; do \
454 $(INSTALL) -m 0644 "etc/$$file" "$(DESTDIR)$(RT_ETC_PATH)/" ; \
461 $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_SBIN_PATH)
462 for file in $(SYSTEM_BINARIES) ; do \
463 $(INSTALL) -o $(BIN_OWNER) -g $(RTGROUP) -m 0755 "sbin/$$file" "$(DESTDIR)$(RT_SBIN_PATH)/" ; \
471 $(INSTALL) -m 0755 -d $(DESTDIR)$(RT_BIN_PATH)
472 for file in $(BINARIES) ; do \
473 $(INSTALL) -o $(BIN_OWNER) -g $(RTGROUP) -m 0755 "bin/$$file" "$(DESTDIR)$(RT_BIN_PATH)/" ; \
478 -( cd local/html && find . -type d -print ) | while read dir ; do \
479 $(INSTALL) -m 0755 -d "$(DESTDIR)$(MASON_LOCAL_HTML_PATH)/$$dir" ; \
481 -( cd local/html && find . -type f -print ) | while read file ; do \
482 $(INSTALL) -m 0644 "local/html/$$file" "$(DESTDIR)$(MASON_LOCAL_HTML_PATH)/$$file" ; \
484 -( cd local/po && find . -type d -print ) | while read dir ; do \
485 $(INSTALL) -m 0755 -d "$(DESTDIR)$(LOCAL_LEXICON_PATH)/$$dir" ; \
487 -( cd local/po && find . -type f -print ) | while read file ; do \
488 $(INSTALL) -m 0644 "local/po/$$file" "$(DESTDIR)$(LOCAL_LEXICON_PATH)/$$file" ; \
490 -( cd local/etc && find . -type d -print ) | while read dir ; do \
491 $(INSTALL) -m 0755 -d "$(DESTDIR)$(LOCAL_ETC_PATH)/$$dir" ; \
493 -( cd local/etc && find . -type f -print ) | while read file ; do \
494 $(INSTALL) -m 0644 "etc/$$file" "$(DESTDIR)$(LOCAL_ETC_PATH)/$$file" ; \
498 # {{{ Best Practical Build targets -- no user servicable parts inside
501 $(PERL) sbin/extract-message-catalog
504 $(PERL) sbin/license_tag
506 factory: initialize-database
507 cd lib; $(PERL) ../sbin/factory $(DB_DATABASE) RT
512 chmod 755 ./configure
516 $(PERL) bin/standalone_httpd &
519 $(PERL) sbin/rt-server &
527 SNAPSHOT=$(shell git describe --tags)
529 git archive --prefix "$(SNAPSHOT)/" HEAD | tar -xf -
530 ( cd $(SNAPSHOT) && autoconf && PERL=/usr/bin/perl ./configure )
531 tar -czf "$(SNAPSHOT).tar.gz" "$(SNAPSHOT)/"
532 rm -fr "$(SNAPSHOT)/"