DebianLennyInstallGuide - Revision history

Admin: 12 revisions imported

2016-04-06T20:08:46Z

12 revisions imported

← Older revision		Revision as of 16:08, 6 April 2016
(No difference)

66.219.32.14: /* Preparing your system */

2012-10-29T15:43:10Z

Preparing your system

New page

{{OutdatedInstallGuide}}

= Request-Tracker 3.8.1 on Debian Lenny =

=== Repository Installation ===

Taken from http://www.debianadmin.com/howto-setup-request-tracker-36-on-debian-etch.html with a few changes:

=== Preparing your system ===

*Install Postfix, fetchmail using the following command
apt-get install postfix fetchmail

*Select “Internet Site” when prompted

*Install [[MySQL]] Server 5 using the following command. You must also set a root password of your choice for this installation to continue.

aptitude install mysql-server-5.0

*Install Request-Tracker Apache2 package using the following command

aptitude install rt3.8-apache2

*Install Request-Tracker 3.6 using the following command. When you are prompted to choose if dbconfig-common should be used select "NO" and continue with default choices.
aptitude install request-tracker3.6

=== Configuring Request Tracker ===

The Request Tracker Configuration file is located at /etc/request-tracker3.6/[[RT SiteConfig|RT_SiteConfig]].pm. The following is an example configuration to run RT on the localhost with the necessary adjustments for RT operation. The domain "example.org" is used purely for demonstration purposes. You are welcome to edit the additional variables per the comments to suit your organisation.
* vi /etc/request-tracker3.6/[[RT SiteConfig|RT_SiteConfig]].pm
[[RT SiteConfig|RT_SiteConfig]].pm # # These are the bits you absolutely '''must''' edit. # # To find out how, please read # /usr/share/doc/request-tracker3.6/NOTES.Debian

* THE BASICS:

Set($rtname, ’support.example.org’);
Set($Organization, ‘example.org’);
Set($[[CorrespondAddress]] , ’[mailto:support@example.org support@example.org]’);
Set($[[CommentAddress]] , ’[mailto:support-comment@example.org support-comment@example.org]’);
Set($Timezone , ‘Europe/Brussels’); # obviously choose what suits you

* THE DATABASE:

Set($[[DatabaseType]], ‘mysql’); # e.g. Pg or mysql

##These are the settings we used above when creating the RT database,
# you MUST set these to what you chose in the section above.

Set($[[DatabaseUser]] , ‘rtuser’);
Set($[[DatabasePassword]] , ‘<whatever_password_you_wish>’);
Set($[[DatabaseName]] , ‘rtdb’);

* THE WEBSERVER:

# This sets RT to be accessed as http://localhost/rt. If you wanted to make it a virtualhost or subdomain you could configure this either via [[VirtualHosts]] configuration in any of the apache configuration files or the $[[WebPath]] variable.

Set($[[WebPath]] , “/rt”);
Set($[[WebBaseURL]] , “[http://xn--localhost)-1x6e http://localhost”)];

=== Mysql Database Configuration ===

*Create [[MySQL]] user

The tutorial directs the installer to set a root password for mysql but that should have been done during the installation of mysql-server-5.0 so here are the steps following that:

Create the user “rtuser” :

mysql -u root -p

mysql> GRANT ALL PRIVILEGES ON rtdb.* TO ‘rtuser’@'localhost’ IDENTIFIED BY ‘wibble’; FLUSH PRIVILEGES; QUIT

*7. Set up RT database :
/usr/sbin/rt-setup-database-3.6 --action init --dba root --prompt-for-dba-password

You should see something like the following :

Password: Now creating a database for RT.
Creating mysql database rtdb.
Now populating database schema.
Creating database schema.
readline() on closed filehandle SCHEMA_LOCAL at /usr/sbin/rt-setup-database-3.6 line 223.
Done setting up database schema.
Now inserting database [[ACLs]] Done setting up database [[ACLs]].
Now inserting RT core system objects Checking for existing system user…not found.
This appears to be a new installation. Creating system user…done.
Now inserting RT data Creating Superuser ACL…done.
Creating groups…3.4.5.6.7.8.9.done.
Creating users…10.12.done.
Creating queues…1.2.done.
Creating ACL…2.3.done.
Creating [[ScripActions]]…1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.done.
Creating [[ScripConditions]]…1.2.3.4.5.6.7.8.9.10.done.
Creating templates…1.2.3.4.5.6.7.8.9.10.11.12.done.
Creating scrips…1.2.3.4.5.6.7.8.9.10.11.12.13.14.done.
Creating predefined searches…1.2.3.done.
Done setting up database content.

=== Configuring Apache ===

*Set up Apache2

Add the following two lines to /etc/apache2/sites-enabled/000-default at the end of the file just before the closing virtualhost tag:

Include “/etc/request-tracker3.6/apache2-modperl2.conf”
[[RedirectMatch]] ^/$ /rt/

*Enable mod rewrite by using the command:
# a2enmod rewrite
cd /etc/apache2/mods-enabled/

*The following may produce a message: "ln: creating symbolic link `./rewrite.load': File exists" This doesn't seem to cause any problems.
ln -s ../mods-available/rewrite.load .

*Restart Apache2

# /etc/init.d/apache2 restart

*Finally you need to login to rt and grant [[CreateTicket]] and [[ReplyToTicket]] to the group Everyone.

http://localhost/rt/

Login as user “root” Password is “password”

Now you can start configuring the tickets and using RT. It is advised you change the root password to something more cryptic.

=== Manual Installation ===

copied from http://www.debianadmin.com/howto-setup-request-tracker-36-on-debian-etch.html and edited for my company

1. setup base system with very minimalistic install

2. update sources then upgrade

aptitude update
aptitude full-upgrade

3. install the following packages

aptitude install apache2 openssl mysql-server-5.0 postfix fetchmail
libc6-dev libc-dev libmudflap0-dev make gcc gawk libapache2-mod-perl2
libxml-handler-composer-perl libxml-generator-perl unzip mlocate

4. choose "Internet Site with smart host" in postfix configuration and use yourmailserver as smart host.

5. setup your mysql root password (NOTE: This is different from your system root password!)

mysqladmin -u root password <yourpassword>

6. download and unpack download:

wget http://download.bestpractical.com/pub/rt/release/rt.tar.gz
tar -xzvf rt.tar.gz
cd ./rt-3.8.1

7. configure CPAN

perl -MCPAN -e shell

Choose auto config

Would you like me to configure as much as possible automatically? [no]yes

when asked about building prerequisites choose "follow"

Policy on building prerequisites (follow, ask or ignore)? [ask] follow

Once you're done and get the cpan> prompt run o conf init

cpan>o conf init

this time choose choose enter no for auto config

Would you like me to configure as much as possible automatically? [yes]no

once you're done go ahead and install Bundle::CPAN as per http://search.cpan.org/~andk/Bundle-CPAN-1.857/CPAN.pm "Bundle::CPAN - Bundle to optimize the behaviour of CPAN.pm"

cpan> install Bundle::CPAN

.. ... install everything, including optional packages exit cpan once its complete

cpan> exit

8. lets start the rt install

./configure

9. run make testdeps

make testdeps

Expect to see errors a fews time due to the missing dependencies you should get something similar at the end. We will be running make testdeps a few times to make sure all dependencies are satisfied.

make: *** [testdeps] Error 1

10. now run make fixdeps

make fixdeps

keep hitting yes when asked about prepending.

Shall I follow them and prepend them to the queue of modules we are processing right now? [yes]

run make testdeps to see if we are still missing dependencies

make testdeps

you might get the following message

SOME DEPENDENCIES WERE MISSING.
ICAL missing dependencies:
Data::ICal...MISSING
make: *** [fixdeps] Error 1

simply re-run for any missing dependencies

make fixdeps
..
All dependencies have been found.

to make sure everything is satisfied

make testdeps

and you should get the following

All dependencies have been found

11. now run make install

make install

=== Configuration ===

12. once completed you will need to edit [[RT SiteConfig|RT_SiteConfig]].pm backup:

cp /opt/rt3/etc/RT_SiteConfig.pm /opt/rt3/etc/RT_SiteConfig.pm.orig
vim /opt/rt3/etc/RT_SiteConfig.pm

edit your [[RT SiteConfig|RT_SiteConfig]].pm to reflect your specific settings

<nowiki>Set($rtname , "rt.yourdomain.com");
Set($Organization , "yourdomain.com");
Set($CorrespondAddress , 'rt@rt.yourdomain.com');
Set($CommentAddress , 'rt-comment@rt.yourdomain.com');
Set($OwnerEmail , 'root');
Set($MaxAttachmentSize , 10000000);

# THE DATABASE:

Set($DatabaseType, 'mysql'); # e.g. Pg or mysql

# These are the settings that will be used when
# 'make initialize-database' is run, you MUST set
# these to what you want.

Set($DatabaseUser , 'rt_user');
Set($DatabasePassword , '<db password>');
Set($DatabaseName , 'rt3');

# THE WEBSERVER:

Set($WebPath , "");
#Set($WebPath , "/rt");
Set($WebBaseURL , "http://rt.yourdomain.com");
1;

</nowiki>

13. now run make initialize-database

make initialize-database

enter the password you created in step 6 you should get the following

Working with:
Type: mysql
Host: localhost
Name: rtdb
User: rtuser
DBA: root
Now creating a mysql database rtdb for RT.
Done.
Now populating database schema.
Done.
Now inserting database ACLs
Granting access to rtuser@'localhost' on rtdb.
Done.
Now inserting RT core system objects
Done.
Now inserting data
Done inserting data
Done.

14. backup and modify your default apache config backup:

mv /etc/apache2/sites-available/default /etc/apache2/sites-available/default.orig
vim /etc/apache2/sites-available/default

now edit to reflect your sites specification

<VirtualHost *:80>
ServerName rt.yourdomain.com

DocumentRoot /opt/rt3/share/html
PerlRequire "/opt/rt3/bin/webmux.pl"

<Location />
AddDefaultCharset UTF-8
SetHandler perl-script
PerlResponseHandler RT::Mason
</Location>
</VirtualHost>

15. enable apache modules you might be using, this will depend on how you've configured your site

a2enmod perl
a2enmod rewrite

=== Test RT ===

16. stop start apache as needed

/etc/init.d/apache2 stop
/etc/init.d/apache2 start

17. now open up your favorite browser and login

http://your.ip.address.or.hostname

the default login is

user: root
password: password

=== Install RTFM ===

18. Download and extract RTFM

wget http://download.bestpractical.com/pub/rt/release/rtfm.tar.gz
tar -xzvf rtfm.tar.gz

19. Install and patch the database

cd RTFM-2.4.0
perl Makefile.PL
make install
make initdb

20. add follwing line to /opt/rt3/etc/[[RT SiteConfig|RT_SiteConfig]].pm

Set(@Plugins,qw(RT::FM));

21. clear mason cache

rm -rf /opt/rt3/var/mason_data/*

22. Stop and restart Apache

/etc/init.d/apache2 stop
/etc/init.d/apache2 start

23. log in again and retest

=== Configure Postfix ===

24. add follwing line to /etc/aliases

rt: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action correspond --url http://rt.yourdomain.com"
rt-comment: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action comment --url http://rt.yourdomain.com"

25. run newaliases command

newaliases

26. Give everyone rights to [[CreateTicket]], [[ReplyToTicket]], [[CommentOnTicket]] (configuration, global, group rights)

193.193.132.194: /* Preparing your system */

2012-01-03T15:29:24Z

Preparing your system

← Older revision		Revision as of 11:29, 3 January 2012
Line 20:		Line 20:
	*Install Request-Tracker Apache2 package using the following command		*Install Request-Tracker Apache2 package using the following command

	aptitude install rt3.8-apache2		aptitude install rt3.6-apache2

	*Install Request-Tracker 3.8 using the following command. When you are prompted to choose if dbconfig-common should be used select "NO" and continue with default choices.		*Install Request-Tracker 3.8 using the following command. When you are prompted to choose if dbconfig-common should be used select "NO" and continue with default choices.
	aptitude install request-tracker3.8		aptitude install request-tracker3.6

	=== Configuring Request Tracker ===		=== Configuring Request Tracker ===

193.193.132.194: /* Preparing your system */

2012-01-03T12:46:56Z

Preparing your system

New page

{{OutdatedInstallGuide}}

= Request-Tracker 3.8.1 on Debian Lenny =

=== Repository Installation ===

Taken from http://www.debianadmin.com/howto-setup-request-tracker-36-on-debian-etch.html with a few changes:

=== Preparing your system ===

*Install Postfix, fetchmail using the following command
apt-get install postfix fetchmail

*Select “Internet Site” when prompted

*Install [[MySQL]] Server 5 using the following command. You must also set a root password of your choice for this installation to continue.

aptitude install mysql-server-5.0

*Install Request-Tracker Apache2 package using the following command

aptitude install rt3.8-apache2

*Install Request-Tracker 3.8 using the following command. When you are prompted to choose if dbconfig-common should be used select "NO" and continue with default choices.
aptitude install request-tracker3.8

=== Configuring Request Tracker ===

The Request Tracker Configuration file is located at /etc/request-tracker3.6/[[RT SiteConfig|RT_SiteConfig]].pm. The following is an example configuration to run RT on the localhost with the necessary adjustments for RT operation. The domain "example.org" is used purely for demonstration purposes. You are welcome to edit the additional variables per the comments to suit your organisation.
* vi /etc/request-tracker3.6/[[RT SiteConfig|RT_SiteConfig]].pm
[[RT SiteConfig|RT_SiteConfig]].pm # # These are the bits you absolutely '''must''' edit. # # To find out how, please read # /usr/share/doc/request-tracker3.6/NOTES.Debian

* THE BASICS:

Set($rtname, ’support.example.org’);
Set($Organization, ‘example.org’);
Set($[[CorrespondAddress]] , ’[mailto:support@example.org support@example.org]’);
Set($[[CommentAddress]] , ’[mailto:support-comment@example.org support-comment@example.org]’);
Set($Timezone , ‘Europe/Brussels’); # obviously choose what suits you

* THE DATABASE:

Set($[[DatabaseType]], ‘mysql’); # e.g. Pg or mysql

##These are the settings we used above when creating the RT database,
# you MUST set these to what you chose in the section above.

Set($[[DatabaseUser]] , ‘rtuser’);
Set($[[DatabasePassword]] , ‘<whatever_password_you_wish>’);
Set($[[DatabaseName]] , ‘rtdb’);

* THE WEBSERVER:

# This sets RT to be accessed as http://localhost/rt. If you wanted to make it a virtualhost or subdomain you could configure this either via [[VirtualHosts]] configuration in any of the apache configuration files or the $[[WebPath]] variable.

Set($[[WebPath]] , “/rt”);
Set($[[WebBaseURL]] , “[http://xn--localhost)-1x6e http://localhost”)];

=== Mysql Database Configuration ===

*Create [[MySQL]] user

The tutorial directs the installer to set a root password for mysql but that should have been done during the installation of mysql-server-5.0 so here are the steps following that:

Create the user “rtuser” :

mysql -u root -p

mysql> GRANT ALL PRIVILEGES ON rtdb.* TO ‘rtuser’@'localhost’ IDENTIFIED BY ‘wibble’; FLUSH PRIVILEGES; QUIT

*7. Set up RT database :
/usr/sbin/rt-setup-database-3.6 --action init --dba root --prompt-for-dba-password

You should see something like the following :

Password: Now creating a database for RT.
Creating mysql database rtdb.
Now populating database schema.
Creating database schema.
readline() on closed filehandle SCHEMA_LOCAL at /usr/sbin/rt-setup-database-3.6 line 223.
Done setting up database schema.
Now inserting database [[ACLs]] Done setting up database [[ACLs]].
Now inserting RT core system objects Checking for existing system user…not found.
This appears to be a new installation. Creating system user…done.
Now inserting RT data Creating Superuser ACL…done.
Creating groups…3.4.5.6.7.8.9.done.
Creating users…10.12.done.
Creating queues…1.2.done.
Creating ACL…2.3.done.
Creating [[ScripActions]]…1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.done.
Creating [[ScripConditions]]…1.2.3.4.5.6.7.8.9.10.done.
Creating templates…1.2.3.4.5.6.7.8.9.10.11.12.done.
Creating scrips…1.2.3.4.5.6.7.8.9.10.11.12.13.14.done.
Creating predefined searches…1.2.3.done.
Done setting up database content.

=== Configuring Apache ===

*Set up Apache2

Add the following two lines to /etc/apache2/sites-enabled/000-default at the end of the file just before the closing virtualhost tag:

Include “/etc/request-tracker3.6/apache2-modperl2.conf”
[[RedirectMatch]] ^/$ /rt/

*Enable mod rewrite by using the command:
# a2enmod rewrite
cd /etc/apache2/mods-enabled/

*The following may produce a message: "ln: creating symbolic link `./rewrite.load': File exists" This doesn't seem to cause any problems.
ln -s ../mods-available/rewrite.load .

*Restart Apache2

# /etc/init.d/apache2 restart

*Finally you need to login to rt and grant [[CreateTicket]] and [[ReplyToTicket]] to the group Everyone.

http://localhost/rt/

Login as user “root” Password is “password”

Now you can start configuring the tickets and using RT. It is advised you change the root password to something more cryptic.

=== Manual Installation ===

copied from http://www.debianadmin.com/howto-setup-request-tracker-36-on-debian-etch.html and edited for my company

1. setup base system with very minimalistic install

2. update sources then upgrade

aptitude update
aptitude full-upgrade

3. install the following packages

aptitude install apache2 openssl mysql-server-5.0 postfix fetchmail
libc6-dev libc-dev libmudflap0-dev make gcc gawk libapache2-mod-perl2
libxml-handler-composer-perl libxml-generator-perl unzip mlocate

4. choose "Internet Site with smart host" in postfix configuration and use yourmailserver as smart host.

5. setup your mysql root password (NOTE: This is different from your system root password!)

mysqladmin -u root password <yourpassword>

6. download and unpack download:

wget http://download.bestpractical.com/pub/rt/release/rt.tar.gz
tar -xzvf rt.tar.gz
cd ./rt-3.8.1

7. configure CPAN

perl -MCPAN -e shell

Choose auto config

Would you like me to configure as much as possible automatically? [no]yes

when asked about building prerequisites choose "follow"

Policy on building prerequisites (follow, ask or ignore)? [ask] follow

Once you're done and get the cpan> prompt run o conf init

cpan>o conf init

this time choose choose enter no for auto config

Would you like me to configure as much as possible automatically? [yes]no

once you're done go ahead and install Bundle::CPAN as per http://search.cpan.org/~andk/Bundle-CPAN-1.857/CPAN.pm "Bundle::CPAN - Bundle to optimize the behaviour of CPAN.pm"

cpan> install Bundle::CPAN

.. ... install everything, including optional packages exit cpan once its complete

cpan> exit

8. lets start the rt install

./configure

9. run make testdeps

make testdeps

Expect to see errors a fews time due to the missing dependencies you should get something similar at the end. We will be running make testdeps a few times to make sure all dependencies are satisfied.

make: *** [testdeps] Error 1

10. now run make fixdeps

make fixdeps

keep hitting yes when asked about prepending.

Shall I follow them and prepend them to the queue of modules we are processing right now? [yes]

run make testdeps to see if we are still missing dependencies

make testdeps

you might get the following message

SOME DEPENDENCIES WERE MISSING.
ICAL missing dependencies:
Data::ICal...MISSING
make: *** [fixdeps] Error 1

simply re-run for any missing dependencies

make fixdeps
..
All dependencies have been found.

to make sure everything is satisfied

make testdeps

and you should get the following

All dependencies have been found

11. now run make install

make install

=== Configuration ===

12. once completed you will need to edit [[RT SiteConfig|RT_SiteConfig]].pm backup:

cp /opt/rt3/etc/RT_SiteConfig.pm /opt/rt3/etc/RT_SiteConfig.pm.orig
vim /opt/rt3/etc/RT_SiteConfig.pm

edit your [[RT SiteConfig|RT_SiteConfig]].pm to reflect your specific settings

<nowiki>Set($rtname , "rt.yourdomain.com");
Set($Organization , "yourdomain.com");
Set($CorrespondAddress , 'rt@rt.yourdomain.com');
Set($CommentAddress , 'rt-comment@rt.yourdomain.com');
Set($OwnerEmail , 'root');
Set($MaxAttachmentSize , 10000000);

# THE DATABASE:

Set($DatabaseType, 'mysql'); # e.g. Pg or mysql

# These are the settings that will be used when
# 'make initialize-database' is run, you MUST set
# these to what you want.

Set($DatabaseUser , 'rt_user');
Set($DatabasePassword , '<db password>');
Set($DatabaseName , 'rt3');

# THE WEBSERVER:

Set($WebPath , "");
#Set($WebPath , "/rt");
Set($WebBaseURL , "http://rt.yourdomain.com");
1;

</nowiki>

13. now run make initialize-database

make initialize-database

enter the password you created in step 6 you should get the following

Working with:
Type: mysql
Host: localhost
Name: rtdb
User: rtuser
DBA: root
Now creating a mysql database rtdb for RT.
Done.
Now populating database schema.
Done.
Now inserting database ACLs
Granting access to rtuser@'localhost' on rtdb.
Done.
Now inserting RT core system objects
Done.
Now inserting data
Done inserting data
Done.

14. backup and modify your default apache config backup:

mv /etc/apache2/sites-available/default /etc/apache2/sites-available/default.orig
vim /etc/apache2/sites-available/default

now edit to reflect your sites specification

<VirtualHost *:80>
ServerName rt.yourdomain.com

DocumentRoot /opt/rt3/share/html
PerlRequire "/opt/rt3/bin/webmux.pl"

<Location />
AddDefaultCharset UTF-8
SetHandler perl-script
PerlResponseHandler RT::Mason
</Location>
</VirtualHost>

15. enable apache modules you might be using, this will depend on how you've configured your site

a2enmod perl
a2enmod rewrite

=== Test RT ===

16. stop start apache as needed

/etc/init.d/apache2 stop
/etc/init.d/apache2 start

17. now open up your favorite browser and login

http://your.ip.address.or.hostname

the default login is

user: root
password: password

=== Install RTFM ===

18. Download and extract RTFM

wget http://download.bestpractical.com/pub/rt/release/rtfm.tar.gz
tar -xzvf rtfm.tar.gz

19. Install and patch the database

cd RTFM-2.4.0
perl Makefile.PL
make install
make initdb

20. add follwing line to /opt/rt3/etc/[[RT SiteConfig|RT_SiteConfig]].pm

Set(@Plugins,qw(RT::FM));

21. clear mason cache

rm -rf /opt/rt3/var/mason_data/*

22. Stop and restart Apache

/etc/init.d/apache2 stop
/etc/init.d/apache2 start

23. log in again and retest

=== Configure Postfix ===

24. add follwing line to /etc/aliases

rt: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action correspond --url http://rt.yourdomain.com"
rt-comment: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action comment --url http://rt.yourdomain.com"

25. run newaliases command

newaliases

26. Give everyone rights to [[CreateTicket]], [[ReplyToTicket]], [[CommentOnTicket]] (configuration, global, group rights)

164.41.102.31: /* Configuring Apache */

2011-02-14T00:42:08Z

Configuring Apache

New page

= Request-Tracker 3.8.1 on Debian Lenny =

=== Repository Installation ===

Taken from http://www.debianadmin.com/howto-setup-request-tracker-36-on-debian-etch.html with a few changes:

=== Preparing your system ===

1. Install Postfix, fetchmail using the following command

#apt-get install postfix fetchmail

Select “Internet Site” when prompted

2. Install [[MySQL]] Server 5 using the following command. You must also set a root password of your choice for this installation to continue.

#aptitude install mysql-server-5.0

3. Install Request-Tracker Apache2 package using the following command

#aptitude install rt3.6-apache2

4. Install Request-Tracker 3.6 using the following command. When you are prompted to choose if dbconfig-common should be used select "NO" and continue with default choices.

#aptitude install request-tracker3.6

=== Configuring Request Tracker ===

5. The Request Tracker Configuration file is located at /etc/request-tracker3.6/[[RT SiteConfig|RT_SiteConfig]].pm. The following is an example configuration to run RT on the localhost with the necessary adjustments for RT operation. The domain "example.org" is used purely for demonstration purposes. You are welcome to edit the additional variables per the comments to suit your organisation.

# vi /etc/request-tracker3.6/[[RT SiteConfig|RT_SiteConfig]].pm

# [[RT SiteConfig|RT_SiteConfig]].pm # # These are the bits you absolutely '''must''' edit. # # To find out how, please read # /usr/share/doc/request-tracker3.6/NOTES.Debian

# THE BASICS:

Set($rtname, ’support.example.org’); Set($Organization, ‘example.org’);

Set($[[CorrespondAddress]] , ’[mailto:support@example.org support@example.org]’); Set($[[CommentAddress]] , ’[mailto:support-comment@example.org support-comment@example.org]’);

Set($Timezone , ‘Europe/Brussels’); # obviously choose what suits you

# THE DATABASE:

Set($[[DatabaseType]], ‘mysql’); # e.g. Pg or mysql

# These are the settings we used above when creating the RT database, # you MUST set these to what you chose in the section above.

Set($[[DatabaseUser]] , ‘rtuser’); Set($[[DatabasePassword]] , ‘<whatever_password_you_wish>’); Set($[[DatabaseName]] , ‘rtdb’);

# THE WEBSERVER: # This sets RT to be accessed as http://localhost/rt. If you wanted to make it a virtualhost or subdomain you could configure this either via [[VirtualHosts]] configuration in any of the apache configuration files or the $[[WebPath]] variable.

Set($[[WebPath]] , “/rt”); Set($[[WebBaseURL]] , “[http://xn--localhost)-1x6e http://localhost”)];

=== Mysql Database Configuration ===

6. Create [[MySQL]] user

The tutorial directs the installer to set a root password for mysql but that should have been done during the installation of mysql-server-5.0 so here are the steps following that:

Create the user “rtuser” :

mysql -u root -p

mysql> GRANT ALL PRIVILEGES ON rtdb.* TO ‘rtuser’@'localhost’ IDENTIFIED BY ‘wibble’; FLUSH PRIVILEGES; QUIT

7. Set up RT database :

# /usr/sbin/rt-setup-database-3.6 --action init --dba root --prompt-for-dba-password

You should see something like the following :

Password: Now creating a database for RT. Creating mysql database rtdb. Now populating database schema. Creating database schema. readline() on closed filehandle SCHEMA_LOCAL at /usr/sbin/rt-setup-database-3.6 line 223. Done setting up database schema. Now inserting database [[ACLs]] Done setting up database [[ACLs]]. Now inserting RT core system objects Checking for existing system user…not found. This appears to be a new installation. Creating system user…done. Now inserting RT data Creating Superuser ACL…done. Creating groups…3.4.5.6.7.8.9.done. Creating users…10.12.done. Creating queues…1.2.done. Creating ACL…2.3.done. Creating [[ScripActions]]…1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.done. Creating [[ScripConditions]]…1.2.3.4.5.6.7.8.9.10.done. Creating templates…1.2.3.4.5.6.7.8.9.10.11.12.done. Creating scrips…1.2.3.4.5.6.7.8.9.10.11.12.13.14.done. Creating predefined searches…1.2.3.done. Done setting up database content.

=== Configuring Apache ===

8. Set up Apache2

Add the following two lines to /etc/apache2/sites-enabled/000-default at the end of the file just before the closing virtualhost tag:

Include “/etc/request-tracker3.6/apache2-modperl2.conf”

[[RedirectMatch]] ^/$ /rt/

9. Enable mod rewrite by using the command: # a2enmod rewrite

# cd /etc/apache2/mods-enabled/

10. The following may produce a message: "ln: creating symbolic link `./rewrite.load': File exists" This doesn't seem to cause any problems.

# ln -s ../mods-available/rewrite.load .

Restart Apache2

11. # /etc/init.d/apache2 restart

12. Finally you need to login to rt and grant [[CreateTicket]] and [[ReplyToTicket]] to the group Everyone.

http://localhost/rt/

Login as user “root” Password is “password”

Now you can start configuring the tickets and using RT. It is advised you change the root password to something more cryptic.

=== Manual Installation ===

copied from http://rtvm.tehcorner.com/rt38/ and edited for my company

1. setup base system with very minimalistic install

2. update sources then upgrade

aptitude update
aptitude full-upgrade

3. install the following packages

aptitude install apache2 openssl mysql-server-5.0 postfix fetchmail
libc6-dev libc-dev libmudflap0-dev make gcc gawk libapache2-mod-perl2
libxml-handler-composer-perl libxml-generator-perl unzip mlocate

4. choose "Internet Site with smart host" in postfix configuration and use yourmailserver as smart host.

5. setup your mysql root password (NOTE: This is different from your system root password!)

mysqladmin -u root password <yourpassword>

6. download and unpack download:

wget http://download.bestpractical.com/pub/rt/release/rt.tar.gz
tar -xzvf rt.tar.gz
cd ./rt-3.8.1

7. configure CPAN

perl -MCPAN -e shell

Choose auto config

Would you like me to configure as much as possible automatically? [no]yes

when asked about building prerequisites choose "follow"

Policy on building prerequisites (follow, ask or ignore)? [ask] follow

Once you're done and get the cpan> prompt run o conf init

cpan>o conf init

this time choose choose enter no for auto config

Would you like me to configure as much as possible automatically? [yes]no

once you're done go ahead and install Bundle::CPAN as per http://search.cpan.org/~andk/Bundle-CPAN-1.857/CPAN.pm "Bundle::CPAN - Bundle to optimize the behaviour of CPAN.pm"

cpan> install Bundle::CPAN

.. ... install everything, including optional packages exit cpan once its complete

cpan> exit

8. lets start the rt install

./configure

9. run make testdeps

make testdeps

Expect to see errors a fews time due to the missing dependencies you should get something similar at the end. We will be running make testdeps a few times to make sure all dependencies are satisfied.

make: *** [testdeps] Error 1

10. now run make fixdeps

make fixdeps

keep hitting yes when asked about prepending.

Shall I follow them and prepend them to the queue of modules we are processing right now? [yes]

run make testdeps to see if we are still missing dependencies

make testdeps

you might get the following message

SOME DEPENDENCIES WERE MISSING.
ICAL missing dependencies:
Data::ICal...MISSING
make: *** [fixdeps] Error 1

simply re-run for any missing dependencies

make fixdeps
..
All dependencies have been found.

to make sure everything is satisfied

make testdeps

and you should get the following

All dependencies have been found

11. now run make install

make install

=== Configuration ===

12. once completed you will need to edit [[RT SiteConfig|RT_SiteConfig]].pm backup:

cp /opt/rt3/etc/RT_SiteConfig.pm /opt/rt3/etc/RT_SiteConfig.pm.orig
vim /opt/rt3/etc/RT_SiteConfig.pm

edit your [[RT SiteConfig|RT_SiteConfig]].pm to reflect your specific settings

<nowiki>Set($rtname , "rt.yourdomain.com");
Set($Organization , "yourdomain.com");
Set($CorrespondAddress , 'rt@rt.yourdomain.com');
Set($CommentAddress , 'rt-comment@rt.yourdomain.com');
Set($OwnerEmail , 'root');
Set($MaxAttachmentSize , 10000000);

# THE DATABASE:

Set($DatabaseType, 'mysql'); # e.g. Pg or mysql

# These are the settings that will be used when
# 'make initialize-database' is run, you MUST set
# these to what you want.

Set($DatabaseUser , 'rt_user');
Set($DatabasePassword , '<db password>');
Set($DatabaseName , 'rt3');

# THE WEBSERVER:

Set($WebPath , "");
#Set($WebPath , "/rt");
Set($WebBaseURL , "http://rt.yourdomain.com");
1;

</nowiki>

13. now run make initialize-database

make initialize-database

enter the password you created in step 6 you should get the following

Working with:
Type: mysql
Host: localhost
Name: rtdb
User: rtuser
DBA: root
Now creating a mysql database rtdb for RT.
Done.
Now populating database schema.
Done.
Now inserting database ACLs
Granting access to rtuser@'localhost' on rtdb.
Done.
Now inserting RT core system objects
Done.
Now inserting data
Done inserting data
Done.

14. backup and modify your default apache config backup:

mv /etc/apache2/sites-available/default /etc/apache2/sites-available/default.orig
vim /etc/apache2/sites-available/default

now edit to reflect your sites specification

<VirtualHost *:80>
ServerName rt.yourdomain.com

DocumentRoot /opt/rt3/share/html
PerlRequire "/opt/rt3/bin/webmux.pl"

<Location />
AddDefaultCharset UTF-8
SetHandler perl-script
PerlResponseHandler RT::Mason
</Location>
</VirtualHost>

15. enable apache modules you might be using, this will depend on how you've configured your site

a2enmod perl
a2enmod rewrite

=== Test RT ===

16. stop start apache as needed

/etc/init.d/apache2 stop
/etc/init.d/apache2 start

17. now open up your favorite browser and login

http://your.ip.address.or.hostname

the default login is

user: root
password: password

=== Install RTFM ===

18. Download and extract RTFM

wget http://download.bestpractical.com/pub/rt/release/rtfm.tar.gz
tar -xzvf rtfm.tar.gz

19. Install and patch the database

cd RTFM-2.4.0
perl Makefile.PL
make install
make initdb

20. add follwing line to /opt/rt3/etc/[[RT SiteConfig|RT_SiteConfig]].pm

Set(@Plugins,qw(RT::FM));

21. clear mason cache

rm -rf /opt/rt3/var/mason_data/*

22. Stop and restart Apache

/etc/init.d/apache2 stop
/etc/init.d/apache2 start

23. log in again and retest

=== Configure Postfix ===

24. add follwing line to /etc/aliases

rt: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action correspond --url http://rt.yourdomain.com"
rt-comment: "|/opt/rt3/bin/rt-mailgate --queue 'General' --action comment --url http://rt.yourdomain.com"

25. run newaliases command

newaliases

26. Give everyone rights to [[CreateTicket]], [[ReplyToTicket]], [[CommentOnTicket]] (configuration, global, group rights)