Freeside:1.7:Documentation:InstallingOnFreeBSD

2007-08-21T20:40:06Z

Keywaydave: "rr" had Text-CSV_X instead of Text-CVS_XS. qq and rr could be replaced with a simple "install Text::CSV_XS".

'''Setting up a FreeBSD server for Freeside'''

:1. Install FreeBSD. - Do the complete install from CD.

::a. Insert Freebsd CD & boot to CD

::b. Select “Custom”

::c. Select “Partition”

::d. Use “D” to Delete any existing partitions

::e. Use “C” to Create slices (this is just the drive, use one slice)

::f. Use “Q” to save & exit

::g. Select “BootMgr”

::h. Select “Label”

::i. Use “C” to create partitions

::j. Setup swap partition first (2 x RAM) – use “m” at end of number to denote mb

::k. Select “swap” as partition type

::l. Setup other partitions – mount point for OS is “/”

::m. Use “Q” to save & finish

::n. Select “Distributions”

::o. Select “All”

::p. Select “Yes”

::q. Select “Exit”

::r. Select “Media”

::s. Select “CD/DVD”

::t. Select “Commit”

::u. Select “Yes”

::v. Select “No”

::w. Select “Exit”

::x. Select “X”

::y. Select “Yes” & remove CD

:2. Configure the server

::a. adduser “adduser” (set up a user for use later so you don’t have to log into root everytime)

::b. set root password “passwd”

::c. Edit the rc.conf in etc

:::i. hostname=”boxname.your.domain”

:::ii. ifconfig_fxp0=”your.ip.here netmask your.subnet.here”

:::iii. defaultrouter=”your.gateway.ip.here”

:::iv. inetd_enable=”YES”

:::v. sshd_enable=”YES”

:::vi. keyrate=”fast”

:::vii. update_motd=”NO”

:::viii. kern_securelevel_enable=”NO”

:::ix. usbd_enable=”YES”

:::x. syslogd_flags=”-s”

:::xi. sendmail_enable=”NONE”

:::xii. apache22_enable=”YES”

:::xiii. postgresql_enable=”YES”

::d. Enable root ssh logon

::i. Edit /etc/ssh/sshd_config to allow root login by changing to yes and unremarking line

::e. “cd /etc”

::f. “vi resolv.conf”

:::i. domain your.domain

:::ii. nameserver your.dns.ip.here

::g. reboot

::h. portsnap fetch

::i. portsnap extract

:3. Perl is already installed with Freebsd, use existing install (Satisfies Freeside install step 1.) However, make sure you're running Perl v5.8.8 'perl -v' otherwise you'll have some syntax errors later on.

:4. Install Apache

::a. “cd /usr/ports/www/apache22”

::b. “make && make install” (use defaults for any gui)

:::c. “vi usr/local/etc/apache22/httpd.conf”

:::i. Listen IP:Port

:::ii. ServerAdmin youremail@yourdomain.com

:::iii. ServerName your.servername:80

:::iv. Reboot

:5. Step two of Freeside install instructions almost completed, set up ssl later.

:6. Install the cpan bundle & Apache bundle

::a. “perl –MCPAN –e shell; “

::b. type “no“

::c. “install Bundle::CPAN“ (watch error messages at end has taken as many as 7 times to get full load)

::d. “reload cpan“

::e. “install Bundle::Apache2”

::f. “quit”

:7. Install mod_perl – first download the latest mod_perl to one of your ftp servers

::a. “mkdir /home/youruserfromstep2a/programs”

::b. “cd /home/ youruserfromstep2a /programs”

::c. “ftp yourftpserver“

::d. “cd filelocation “

::e. “bin“

::f. “get mod_perl-2.0-current.tar.gz”

::g. “quit“

::h. “tar –xvzf mod<tab>“

::i. “cd mod_perl-2.0.3“

::j. “perl Makefile.PL APACHE_SRC=/usr/ports/www/apache22\
EVERYTHING=1“ (apxs source is /usr/local/sbin/apxs)

::k. “make && make install“

::l. “/usr/local/sbin/apxs –q LIBEXECDIR“ (should be /usr/local/libexec/apache22, so line would be libexec/apache22/mod_perl.so)

::m. add to httpd.conf – LoadModule perl_module results of above/mod_perl.so (at bottom of LoadModule section)

::n. “apachectl restart“

:8. Install OpenSSH (use defaults on GUI)

::a. “cd /usr/ports/security/openssh“

::b. “make && make install && reboot“

:9. Install rsync: (use defaults on GUI)

::a. “cd /usr/ports/net/rsync“

::b. “make && make install && reboot“

:10. Install Postgresql (use defaults on GUI)

::a. “cd /usr/ports/databases/postgresql81-server“

::b. “make && make install“

::c. Initialize postgresql -- “/usr/local/etc/rc.d/postgresql initdb” (you should see it build the database files needed here, if it doesn’t, then the postgresql install was bad and you need to restart the build process)

::d. Configure for OID

:::i. “vi /usr/local/pgsql/data/postgresql.conf“

:::ii. enable oid by changing to yes and unremarking line

::e. reboot

:11. Install teTex

::a. “cd /usr/ports/print/teTeX”

::b. “make && make install”

:12. Install the required perl modules (At this point I recommend two interfaces into the box. I usually use the terminal and an SSH session. If a module errors out, go to a different screen and force the install before proceeding to the next item. I’ve found the order these modules load seems to matter. You must cd to /root/.cpan/build and find the package directory and cd into it to run the manual make. First run “perl Makefile.PL”, then “make” and finally “make install”)

::a. “perl –MCPAN –e shell;”

::b. type “no”

::c. install MIME::Base64

::d. install Digest::MD5

::e. install URI

::f. install HTML::Tagset

::g. install HTML::Parser

::h. i /libnet/

::i. install (full name of latest version of libnet)

::j. install Locale::Country

::k. install Net::Whois::Raw

::l. install libwww

::m. install Bundle::LWP

::n. install Business::CreditCard

::o. i /MailTools/

::p. install (full name of latest version of mailtools)

::q. i /TimeDate/

::r. Install (full name of latest version of TimeDate)

::s. install DateManip

::t. install File::CounterFile

::u. install FreezeThaw

::v. install String::Approx

::w. install Text::Template

::x. install DBI

::y. install DBD::Pg

::z. install DBIx::DBSchema

::aa. install Net::SSH

::bb. install String::ShellQuote

::cc. i /IVAN/Net/

::dd. install (full name of latest version of NET-SCP)

::ee. install HTML::Mason (apache src is /usr/ports/www/apache22)

::ff. install Tie::IxHash

::gg. install Time::Duration

::hh. install HTML::Widgets::SelectLayers

::ii. install Storable

::jj. install Cache::Cache

::kk. install NetAddr::IP

::ll. install Chart::Base

::mm. install Crypt::PasswdMD5

::nn. install Locale::SubCountry

::oo. install JavaScript::RPC

::pp. install Frontier::RPC2

::qq. install Text::CSV_XS

::rr. install Spreadsheet::WriteExcel

::ss. install IO::Stringy

::tt. install MIME::Tools

::uu. install Apache::Session

::vv. install HTML::TreeBuilder

::ww. install HTML::FormatText

::xx. install Test::Inline

::yy. install Class::ReturnValue

::zz. install DBIx::SearchBuilder

::aaa. install Log::Dispatch

::bbb. install Locale::Maketext::Lexicon

::ccc. install Locale::Maketext::Fuzzy

::ddd. install Text::Wrapper

::eee. install Time::ParseDate

::fff. install Term::ReadKey

::ggg. install Text::Autoformat

::hhh. install Text::Quoted

::iii. install Regexp::Common

::jjj. install HTML::Scrubber

::kkk. install Tree::Simple

::lll. install JSON

::mmm. install GD

::nnn. install DateTime::Format::Strptime

::ooo. install IPC::Run3

::ppp. install Color::Scheme

::qqq. install Data::Table

::rrr. install Lingua::EN::NameParse

::sss. install Lingua::EN::Inflect

::ttt. install Apache::DBI

::uuu. install HTTP::BrowserDetect

::vvv. “quit”

'''Setting up a FreeSide server.'''

:1. Get Freeside ready to install - Download the latest freeside tarball to your ftp server

::a. “cd /home/ youruserfromstep2a /programs“

::b. “ftp yourftpserver“ (log in)

::c. “cd filelocation “

::d. “bin”

::e. “get free<tab>”

::f. “get Makefile”

::g. “quit”

::h. “tar –xvzf free<tab>“

::i. “cp Makefile ./freeside/Makefile”

::j. “cd free<tab>“

:2. adduser freeside (start with “adduser” and answer questions, pwd yourpasswdhere)

:3. “mkdir /usr/local/www/apache22/data/freeside”

:4. “chown freeside:www /usr/local/www/apache22/data/freeside”

:5. Allow the freeside user full access to the freeside database

::a. su pgsql

::b. createuser –P freeside

::c. set password (yourpasswdhere)

::d. not a superuser

::e. yes to create database

::f. no to create role

:6. Add the freeside database

::a. su freeside

::b. createdb –E sql_ascii freeside

:7. Build and install the Perl modules

::a. Exit all the way to root

::b. make perl-modules

::c. make install-perl-modules
:8. Create config files: “make create-config”

:9. Edit /usr/local/etc/apache22/httpd.conf

::a. Change user & group to freeside

:10. apachectl restart

:11. ps –aux (make sure apache now running as freeside)
:12. “make install-docs”

:13. Edit the httpd.conf for freeside

::a. Edit /usr/local/etc/apache22/httpd.conf

::b. At bottom add “Include etc/apache22/Includes/”

:14. Create the database tables and initial data

::a. su freeside

::b. freeside-setup –d your.domain

:15. Create the Freeside system users

::a. su freeside

::b. freeside-adduser –g 1 fs_queue

::c. freeside-adduser –g 1 fs_daily

::d. freeside-adduser –g 1 fs_selfservice

:16. Correct access_user.pm

::a. edit /usr/local/lib/perl5/site_perl/5.8.8/FS/access_user.pm

::b. change the call to $htpasswd_file to ‘/usr/local/etc/freeside/htpasswd’ instead of just ‘htpasswd’ (about line 18)

::c. change the system('htpasswd', '-b', @_, to system('/usr/local/sbin/htpasswd', '-b', @_, (about line 130)

:17. Create one or more Freeside users

::a. su freeside

::b. freeside-adduser –g 1 yournewuser

::c. htpasswd /usr/local/etc/freeside/htpasswd yournewuser

:18. Reboot

:19. Get the correct httpd.conf with all the RT info

::a. Edit the /usr/local/etc/apache22/httpd.conf file

::b. Add the following near the end

:::<Directory /usr/local/www/apache22/data/freeside>

:::<Files ~ "\.(cgi|html)">

:::AddHandler perl-script .cgi .html

:::PerlHandler HTML::Mason

:::</Files>

:::AuthName freeside

:::AuthType Basic

:::AuthUserFile /usr/local/etc/freeside/htpasswd

:::Require valid-user

:::</Directory>

:::<Perl>

:::require "/usr/local/etc/freeside/handler.pl";

:::</Perl>

:::<Directory /usr/local/www/apache22/data/freeside/rt/NoAuth>

:::<Limit GET POST>

:::allow from all

:::Satisfy Any

:::SetHandler perl-script

:::PerlHandler HTML::Mason

:::</Limit>

:::</Directory>

:::<Directory /usr/local/www/apache22/data/freeside/rt/REST/1.0/NoAuth>

:::<Limit GET POST>

:::allow from all

:::Satisfy any

:::SetHandler perl-script

:::PerlHandler HTML::Mason

:::</Limit>

:::</Directory>

:::<DirectoryMatch "^%/usr/local/www/apache22/data/freeside/rt/.*NoAuth/images">

:::SetHandler None

:::</DirectoryMatch>

:::<Directory /usr/local/www/apache22/data/freeside/rt/Ticket/Attachment>

:::SetHandler perl-script

:::PerlHandler HTML::Mason

:::</Directory>

:::<Directory /usr/local/www/apache22/data/freeside/rt/Search>

:::SetHandler perl-script

:::PerlHandler HTML::Mason

:::</Directory>

::c. Immediately after the LoadModules, add

:::PerlModule HTML::Mason

:20. adduser rt (password yourpasswordforrt)

:21. cd /home/ youruserfromstep2a /programs/freeside

:22. Install & setup RT

::a. Make configure-rt

::b. Make create-rt

::c. Make install-rt

:23. Set freeside to run on startup

::a. su root

::b. make install-init

:24. Reboot

:25. Log into Freeside

:26. Go to Ticketing main

:27. Go back to billing main

:28. Add employee root

:29. reboot

:30. log back into freeside as root

:31. Go to ticketing main, Configuration, Global, User Rights, Give your uid superuser rights

:32. Go back to billing main and disable the root user

Freeside - User contributions [en]

Freeside:1.7:Documentation:InstallingOnFreeBSD