FreeBSDInstallGuide - Revision history

Admin: 8 revisions imported

2016-04-06T20:09:06Z

8 revisions imported

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

5.18.229.122: /* Suddently crash (nginx, fastcgi) */

2015-08-02T19:13:20Z

Suddently crash (nginx, fastcgi)

← Older revision		Revision as of 15:13, 2 August 2015
Line 178:		Line 178:

	* cpan install CGI::Cookie		* cpan install CGI::Cookie
	== ~~Suddently~~ crash (nginx, fastcgi)==		== Suddenly crash (nginx, fastcgi)==
	In some cases RT crashes suddently without giving something in logs.		In some cases RT crashes suddently without giving something in logs.

91.142.83.22 at 15:20, 15 April 2015

2015-04-15T15:20:19Z

New page

{{OutdatedInstallGuide}}

= Available Ports =

www/rt36
www/rt38

Installing any of these involves:

cd /usr/ports/www/rtXXX
make install clean

You'll probably want to check out the Fresh Ports site for details on each of these:

http://www.freshports.org/www/rt36 currently shows www/rt36 is vulnerable
http://www.freshports.org/www/rt38 this shows www/rt38 to be most current

'''''BEWARE: THE RT38 PORT HAS A CUSTOMIZED CONFIG.LAYOUT WHICH BREAKS THE STANDARD RT MECHANISM FOR LOCAL CUSTOMIZATION. DO NOT USE THAT PORT IF YOU WANT THE FLEXIBILITY TO CUSTOMIZE RT CLEANLY. '''''

== Build Options ==

{| border="1"
|- valign="top"
| colspan="2" | RT32
|- valign="top"
| UPGRADE_RT30
| Upgrading from a RT 3.0 installation
|- valign="top"
| INITIAL_INSTALL
| Do initialize DB (for initial install only)
|}

|WITH_FASTCGI|Use [[FastCGI]] instead of mod_perl|

{| border="1"
|- valign="top"
| WITH_APACHE2
| Use Apache2 as the web server
|}

|DB_TYPE=type|mysql, Oracle, Pg or [[SQLite]] (default: mysql)|

{| border="1"
|- valign="top"
| DB_HOST=hostname
| The database host (default: localhost)
|- valign="top"
| DB_PORT=port
| The database port
|- valign="top"
| DB_DATABASE=port
| The database name (default: rt3)
|- valign="top"
| DB_DBA_USER=username
| Name of database administrator (root)
|- valign="top"
| DB_DBA_PASSWORD=password
| Password of database administrator
|- valign="top"
| DB_USER=username
| Name of database user for RT (default: rt_user)
|- valign="top"
| DB_PASSWORD=password
| Name of database password for RT (default: rt_pass)
|- valign="top"
| colspan="2" | RT3
|- valign="top"
| INITIAL_INSTALL
| Do initialize DB (for initial install only)
|}

|WITH_FASTCGI|Use [[FastCGI]] instead of mod_perl|

{| border="1"
|- valign="top"
| WITH_APACHE2
| Use Apache2 as the web server
|}

|DB_TYPE=type|mysql, Oracle, Pg or [[SQLite]] (default: mysql)|

{| border="1"
|- valign="top"
| DB_HOST=hostname
| The database host (default: localhost)
|- valign="top"
| DB_PORT=port
| The database port
|- valign="top"
| DB_DATABASE=database
| The database name (default: rt3)
|- valign="top"
| DB_DBA_USER=username
| Name of database administrator (root)
|- valign="top"
| DB_DBA_PASSWORD=password
| Password of database administrator
|- valign="top"
| DB_USER=username
| Name of database user for RT (default: rt_user)
|- valign="top"
| DB_PASSWORD=password
| Name of database password for RT (default: rt_pass)
|}

----

= Getting Perl Installed =

RT requires Perl-5.8.3 or greater.

For a fresh installation when no other ports of Perl have been installed:

cd /usr/ports/lang/perl5.8
make install clean

Upgrade 5.8.x to the current ports version:

portupgrade perl

Upgrade 5.6.1 to the current ports version:

portupgrade -o lang/perl5.8 perl-5.6.1

Now tell FreeBSD to use Perl-5.8.x instead of the 5.00x version included with the base install.

use.perl port

Which can be reversed with:

use.perl system

Note: if you already had some PERL-modules installed, you'll have to re-install them after you upgraded perl, or you might run into problems. See the UPGRADING-file in /usr/ports/. It should be pointed out that [[FreeBSD]] is probably one of the platforms RT is easiest to install on, if not '''the''' easiest. But this demands that the administrator has some familiarity with the OS and the way "things work" in [[FreeBSD]] land - consult the excellent handbook on the [[FreeBSD]]-website. The reward is an almost painless installation of RT with instant productivity gains.

make clean install

= Configuration =

Section 7 in [[ManualInstallation]] should get you started.

= Upgrading =

These are my notes from when I upgraded from 3.4.2 to 3.8.2 on [[FreeBSD]]: [[FreeBSDupgradeTo3 8 2|FreeBSDupgradeTo3_8_2]]

= Problems and Workarounds =

== Strange Issue ==

After a fresh install on [[FreeBSD]] 5.4, port "rt34 3.4.2", I get the following error upon starting Apache:

Use of uninitialized value in numeric eq (==) at /usr/local/lib/perl5/site_perl/5.8.6/CGI/Cookie.pm line 26.

any ideas? Thanks

== Same here ==

I get the same error overhere on a [[FreeBSD]] 5.3-RELEASE box, port www/rt34 also.

== Workaround For Apache Error ==

I solved my problem with the Cookie.pm error;

Use of uninitialized value in numeric eq (==) at /usr/local/lib/perl5/site_perl/5.8.6/CGI/Cookie.pm line 26.

by modifying the Cookie.pm to look like the below:

# Turn on special checking for Doug [[MacEachern]]'s modperl my $MOD_PERL = 0; if (exists $ENV{MOD_PERL}) {

if (defined($ENV{MOD_PERL_API_VERSION}) &&
$ENV{MOD_PERL_API_VERSION} == 2) {
$MOD_PERL = 2;

== Different Workaround For Apache Error ==

I use Debian, but it will work for you also Got through it by upgrading CGI.pm

* cpan install CGI::Cookie
== Suddently crash (nginx, fastcgi)==
In some cases RT crashes suddently without giving something in logs.

Reason is: RT receives SIGPIPE when trying to write to the socket, but nginx already closed connection. In this case perl immediately exits.

Workaround is: add to RT_SiteConfig.pm SIGPIPE handler:
$SIG{'PIPE'} = sub {
print STDERR "SIGPIPE @_\n";
};

BillCole: Warning on broken RT38 port.

2011-01-24T18:05:30Z

Warning on broken RT38 port.

← Older revision		Revision as of 14:05, 24 January 2011
Line 11:		Line 11:
	You'll probably want to check out the Fresh Ports site for details on each of these:		You'll probably want to check out the Fresh Ports site for details on each of these:

	~~http://www.freshports.org/www/rt36 currently shows www/rt36 is vulnerable~~
	~~http://www.freshports.org/www/rt38 this shows www/rt38 to be most current~~

	== Build Options ==		http://www.freshports.org/www/rt36 currently shows www/rt36 is vulnerable
			http://www.freshports.org/www/rt38 this shows www/rt38 to be most current


			<u>'''''BEWARE: THE RT38 PORT HAS A CUSTOMIZED CONFIG.LAYOUT WHICH BREAKS THE STANDARD RT MECHANISM FOR LOCAL CUSTOMIZATION. DO NOT USE THAT PORT IF YOU WANT THE FLEXIBILITY TO CUSTOMIZE RT CLEANLY. '''''</u>

			== Build Options ==

	{\| border="1"		{\| border="1"

95.27.170.81 at 19:49, 23 January 2011

2011-01-23T19:49:27Z

← Older revision		Revision as of 15:49, 23 January 2011
Line 7:		Line 7:

	cd /usr/ports/www/rtXXX		cd /usr/ports/www/rtXXX
	make clean ~~install~~		make install clean

	You'll probably want to check out the Fresh Ports site for details on each of these:		You'll probably want to check out the Fresh Ports site for details on each of these:

95.27.170.81 at 11:57, 23 January 2011

2011-01-23T11:57:43Z

New page

= Available Ports =

www/rt36
www/rt38

Installing any of these involves:

cd /usr/ports/www/rtXXX
make clean install

You'll probably want to check out the Fresh Ports site for details on each of these:

http://www.freshports.org/www/rt36 currently shows www/rt36 is vulnerable
http://www.freshports.org/www/rt38 this shows www/rt38 to be most current

== Build Options ==

{| border="1"
|- valign="top"
| colspan="2" | RT32
|- valign="top"
| UPGRADE_RT30
| Upgrading from a RT 3.0 installation
|- valign="top"
| INITIAL_INSTALL
| Do initialize DB (for initial install only)
|}

|WITH_FASTCGI|Use [[FastCGI]] instead of mod_perl|

{| border="1"
|- valign="top"
| WITH_APACHE2
| Use Apache2 as the web server
|}

|DB_TYPE=type|mysql, Oracle, Pg or [[SQLite]] (default: mysql)|

{| border="1"
|- valign="top"
| DB_HOST=hostname
| The database host (default: localhost)
|- valign="top"
| DB_PORT=port
| The database port
|- valign="top"
| DB_DATABASE=port
| The database name (default: rt3)
|- valign="top"
| DB_DBA_USER=username
| Name of database administrator (root)
|- valign="top"
| DB_DBA_PASSWORD=password
| Password of database administrator
|- valign="top"
| DB_USER=username
| Name of database user for RT (default: rt_user)
|- valign="top"
| DB_PASSWORD=password
| Name of database password for RT (default: rt_pass)
|- valign="top"
| colspan="2" | RT3
|- valign="top"
| INITIAL_INSTALL
| Do initialize DB (for initial install only)
|}

|WITH_FASTCGI|Use [[FastCGI]] instead of mod_perl|

{| border="1"
|- valign="top"
| WITH_APACHE2
| Use Apache2 as the web server
|}

|DB_TYPE=type|mysql, Oracle, Pg or [[SQLite]] (default: mysql)|

{| border="1"
|- valign="top"
| DB_HOST=hostname
| The database host (default: localhost)
|- valign="top"
| DB_PORT=port
| The database port
|- valign="top"
| DB_DATABASE=database
| The database name (default: rt3)
|- valign="top"
| DB_DBA_USER=username
| Name of database administrator (root)
|- valign="top"
| DB_DBA_PASSWORD=password
| Password of database administrator
|- valign="top"
| DB_USER=username
| Name of database user for RT (default: rt_user)
|- valign="top"
| DB_PASSWORD=password
| Name of database password for RT (default: rt_pass)
|}

----

= Getting Perl Installed =

RT requires Perl-5.8.3 or greater.

For a fresh installation when no other ports of Perl have been installed:

cd /usr/ports/lang/perl5.8
make install clean

Upgrade 5.8.x to the current ports version:

portupgrade perl

Upgrade 5.6.1 to the current ports version:

portupgrade -o lang/perl5.8 perl-5.6.1

Now tell FreeBSD to use Perl-5.8.x instead of the 5.00x version included with the base install.

use.perl port

Which can be reversed with:

use.perl system

Note: if you already had some PERL-modules installed, you'll have to re-install them after you upgraded perl, or you might run into problems. See the UPGRADING-file in /usr/ports/. It should be pointed out that [[FreeBSD]] is probably one of the platforms RT is easiest to install on, if not '''the''' easiest. But this demands that the administrator has some familiarity with the OS and the way "things work" in [[FreeBSD]] land - consult the excellent handbook on the [[FreeBSD]]-website. The reward is an almost painless installation of RT with instant productivity gains.

make clean install

= Configuration =

Section 7 in [[ManualInstallation]] should get you started.

= Upgrading =

These are my notes from when I upgraded from 3.4.2 to 3.8.2 on [[FreeBSD]]: [[FreeBSDupgradeTo3 8 2|FreeBSDupgradeTo3_8_2]]

= Problems and Workarounds =

== Strange Issue ==

After a fresh install on [[FreeBSD]] 5.4, port "rt34 3.4.2", I get the following error upon starting Apache:

Use of uninitialized value in numeric eq (==) at /usr/local/lib/perl5/site_perl/5.8.6/CGI/Cookie.pm line 26.

any ideas? Thanks

== Same here ==

I get the same error overhere on a [[FreeBSD]] 5.3-RELEASE box, port www/rt34 also.

== Workaround For Apache Error ==

I solved my problem with the Cookie.pm error;

Use of uninitialized value in numeric eq (==) at /usr/local/lib/perl5/site_perl/5.8.6/CGI/Cookie.pm line 26.

by modifying the Cookie.pm to look like the below:

# Turn on special checking for Doug [[MacEachern]]'s modperl my $MOD_PERL = 0; if (exists $ENV{MOD_PERL}) {

if (defined($ENV{MOD_PERL_API_VERSION}) &&
$ENV{MOD_PERL_API_VERSION} == 2) {
$MOD_PERL = 2;

== Different Workaround For Apache Error ==

I use Debian, but it will work for you also Got through it by upgrading CGI.pm

* cpan install CGI::Cookie