Erinevus lehekülje "OTRS kasutamine Debian Lenniga" redaktsioonide vahel

Allikas: Kuutõrvaja
(→‎Kasulikud lismaterjalid)
(→‎Kasulikud lismaterjalid)
 
(ei näidata sama kasutaja 29 vahepealset redaktsiooni)
1. rida: 1. rida:
 
===Sissejuhatus===
 
===Sissejuhatus===
  
−
OTRS (Open source Ticket Request System) http://otrs.org/ on vaba tarkvaraline probleemihalduse süsteem.
+
OTRS (Open source Ticket Request System) http://otrs.org/ on vaba tarkvaraline probleemihalduse süsteem (ingl. k. ticket request system). Tarkvara on kirjutatud peamiselt Perl keeles.
 +
 
 +
Süsteemi ettevalmistamisel ja juurutamisel on abi aadressil http://doc.otrs.org/2.4/en/html/ asuvast juhendist.
  
 
===Keskkonna ettevalmistamine===
 
===Keskkonna ettevalmistamine===
  
−
Kuna Debiani paketihalduses sisaldub samuti OTRS tarkvara, siis sobib alustuseks paigaldada pakett otrs2
+
OTRS tarkvara kasutamine eeldab muu hulgas sellise tarkvara olemasolu, kõik Debian Lenny paketihaldusest
 +
 
 +
* andmebaas - nt PostgreSQL v. 8.3
 +
* veebiserver -  Apache v. 2.2.9
 +
* hulk perli mooduleid
 +
 
 +
Kuigi Debiani paketihalduses sisaldub samuti OTRS tarkvara, kirjeldab käesolev teksti tarkvara paigaldamist http://otrs.org/ peal jagatud versioonist 2.4.7. OTRS kasutamiseks vajalike sõltuvuste paigaldamiseks paigaldatakse ja eemaldatakse Debiani paketihalduse otrs2 pakett
  
 
  # apt-get install otrs2
 
  # apt-get install otrs2
 +
# dpkg --purge otrs2
 +
 +
Seejuures tuleb jälgida, et veebiserverit ei jääks eksitama paketihalduse seadistusfail, mis vaikimisi paigutatakse /etc/apache2/conf.d kataloogi.
 +
 +
Lisaks tuleb paigaldada sellised paketid
 +
 +
# apt-get install libcgi-pm-perl
 +
 +
====Lokaadi seadistamine====
 +
 +
Selleks, et süsteem saaks korrektselt töötada UTF-8 lokaadiga peab olema paigaldatud locales pakett
 +
 +
# apt-get install locales
 +
 +
ning seadistatud et_EE.UTF-8 lokaat öeldes
 +
 +
# dpkg-reconfigure locales
 +
 +
====PostgreSQL andmebaasi ettevalmistamine====
 +
 +
Kui tingimata pole muid eelistusi võiks OTRS kasutada andmebaasi UTF-8 kodeeringus, sellise PostgreSQLi andmeklustri moodustamiseks sobib nt kustutada olemasolev (mis kustutab kogu parasjagu olemasoleva andmebaasi!)
 +
 +
# pg_dropcluster 8.3 main --stop
 +
 +
ja moodustada UTF-8 kodeeringus andmekluster
 +
 +
# pg_createcluster --locale et_EE.UTF-8 8.3 main --start
 +
 +
Seejärel tekitada OTRS jaoks andmebaasi kasutaja
 +
 +
sql> create user otrs;
 +
 +
ning moodustada andmebaas
 +
 +
sql> create database otrs;
 +
 +
Vajadusel tuleb kohendada pg_hba.conf failis andmebaasile ligipääsu piiranguid.
 +
 +
====OTRS kasutaja moodustamine====
 +
 +
Seoses OTRS tarkvaraga peab süsteemis olema selleks moodustatud kasutaja
 +
 +
# useradd -r -d /opt/otrs/ -c 'OTRS user' otrs
 +
# usermod -G nogroup otrs
  
 
===Tarkvara paigaldamine===
 
===Tarkvara paigaldamine===
  
−
TODO
+
OTRS tarkvara saab kopeerida nt aadressilt http://ftp.otrs.org/pub/otrs/otrs-2.4.7.tar.bz2 ja võiks paigutada kataloogi /opt/otrs
 +
 
 +
# cd /opt
 +
# wget http://ftp.otrs.org/pub/otrs/otrs-2.4.7.tar.bz2
 +
# tar jxf otrs-2.4.7.tar.bz2
 +
# mv otrs-2.4.7 otrs
  
 
===OTRS seadistamine===
 
===OTRS seadistamine===
 +
 +
* Kopeeritakse kaks rakenduse tööd kontrollivat seadistusfaili paika
 +
 +
# cp /opt/otrs/Kernel/Config.pm.dist /opt/otrs/Kernel/Config.pm
 +
# cp /opt/otrs/Kernel/Config/GenericAgent.pm.dist /opt/otrs/Kernel/Config/GenericAgent.pm
 +
 +
* Muudetakse sobivaks failide omanikud:grupid ja loabitid
 +
 +
# cd /opt/otrs/bin
 +
# ./SetPermissions.sh /opt/otrs otrs www-data nogroup www-data
 +
 +
* Veendutakse, et vajalikud süsteemsed komponendid on olemas, tundub, et sellisel juhtumil saab hakata otsast OTRSi kasutama
 +
 +
# cd /opt/otrs/bin
 +
# ./otrs.checkModules | grep "Not installed"
 +
  o DBD::mysql.....................Not installed! (Optional - Required to connect to a MySQL database.)
 +
  o Encode::HanExtra...............Not installed! (Optional - Required to handle mails with several Chinese character sets.)
 +
      o IO::Socket::SSL.............Not installed! (Optional - for POP3 SSL connections)
 +
      o Net::IMAP::Simple::SSL......Not installed! (Optional - Required for SSL connections.)
 +
      o Net::SMTP::SSL..............Not installed! (Optional - Required for SSL/SMTPS connections.)
 +
  o Net::LDAP......................Not installed! (Optional - Required for directory authentication.)
 +
  o PDF::API2......................Not installed! (Optional - Required for PDF output.)
 +
  o SOAP::Lite.....................Not installed! (Optional - Required for the SOAP interface.)
 +
 +
* Täiendavad kontrollid
 +
 +
# cd /opt/otrs
 +
# perl -cw bin/cgi-bin/installer.pl
 +
cgi-bin/installer.pl syntax OK
 +
 +
# perl -cw bin/PostMaster.pl
 +
PostMaster.pl syntax OK
 +
 +
* Valmistatakse ette andmebaas
  
 
  $ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-schema.postgresql.sql
 
  $ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-schema.postgresql.sql
 
  $ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-initial_insert.postgresql.sql  
 
  $ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-initial_insert.postgresql.sql  
 
  $ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-schema-post.postgresql.sql
 
  $ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-schema-post.postgresql.sql
 +
 +
ning näidatakse Kernel/Config.pm failis ligipääs andmebaasile
 +
 +
    $Self->{DatabaseHost} = '127.0.0.1';
 +
    $Self->{Database} = 'otrs';
 +
    $Self->{DatabaseUser} = 'otrs';
 +
    $Self->{DatabasePw} = 'parool';
 +
    $Self->{DatabaseDSN} = "DBI:Pg:dbname=$Self->{Database};host=$Self->{DatabaseHost};";
  
 
* UTF-8 kasutamiseks tuleb seadistusfailis Kernel/Config.pm näidata
 
* UTF-8 kasutamiseks tuleb seadistusfailis Kernel/Config.pm näidata
  
 
  $Self->{DefaultCharset} = 'utf-8';
 
  $Self->{DefaultCharset} = 'utf-8';
 +
 +
====Veebiserveri seadistamine====
 +
 +
Veebiserveris sobib alustuseks seadistada üks minimaalse sisuga VirtualHost ning kasutada seal sisulise osana teksti failist
 +
 +
/opt/otrs/scripts/apache2-httpd-new.include.conf
  
 
===OTRS kasutamine===
 
===OTRS kasutamine===
  
−
Vaikimisi asub OTRS sarnasel aadressil http://loomaaed.tartu.ee/otrs/login.pl
+
Vaikimisi asub OTRS sarnasel aadressil http://loomaaed.tartu.ee/otrs/login.pl, esmaseks sisselogimiseks saab kasutada, parool tuleks kohe muuta
 +
 
 +
* kasutajanimi - root@localhost
 +
* parool - root
  
 
[[Pilt:Otrs-1.gif]]
 
[[Pilt:Otrs-1.gif]]
 +
 +
===CRON tööd===
 +
 +
CRON tööde skriptid asuvad kataloogis /opt/otrs/var/cron.
 +
 +
* Esmalt tuleb skriptid kopeerida ilma .dist lõputa nimede alla, nt nii
 +
 +
# /opt/otrs/var/cron# for foo in *.dist; do cp $foo `basename $foo .dist`; done
 +
 +
* Seejärel paigaldada otrs kasutajale CRON tööd
 +
 +
# su - otrs
 +
$ cd bin
 +
$ ./Cron.sh start
 +
/opt/otrs/bin
 +
Cron.sh - start/stop OTRS cronjobs - <$Revision: 1.19 $>
 +
Copyright (C) 2001-2009 OTRS AG, http://otrs.org/
 +
(using /opt/otrs) done
 +
 +
===OTRS logi===
 +
 +
OTRS on tubli logija, lisaks veebiserveri logile kirjutatakse nt /var/log/syslogi selliseid sissekandeid
 +
 +
Mar 27 13:07:03 loomaaed OTRS-CGI-10[9343]: [Notice][Kernel::System::Auth::DB::Auth]
 +
  User: priit authentication ok (REMOTE_ADDR: 192.168.10.10).
 +
Mar 27 13:07:14 loomaaed OTRS-CGI-10[9343]: [Notice][Kernel::System::AuthSession::DB::RemoveSessionID]
 +
  Removed SessionID 100a5b4290d6ef72a0be7d67b0c5cef208.
 +
 +
Nt CRON tööna POP3 kontolt eposti kopeerimine paistab syslogis
 +
 +
Mar 29 14:40:06 loomaaed OTRS-PMAccount-10[7208]: [Notice][Kernel::System::MailAccount::POP3::_Fetch]
 +
  POP3: Fetched 1 email(s) from info@loomaaed.tartu.ee/smtp.loomaaed.tartu.ee.
 +
 +
===Eposti seadistamine===
 +
 +
TODO
 +
 +
===Märkused===
 +
 +
* Grupilist funktsionaalsust saab lisada failis Kernel/Config.pm parameetriga
 +
 +
$Self->{CustomerGroupSupport} = 1;
  
 
===Kasulikud lismaterjalid===
 
===Kasulikud lismaterjalid===
33. rida: 183. rida:
 
* http://faq.otrs.org/
 
* http://faq.otrs.org/
 
* http://en.wikipedia.org/wiki/Comparison_of_issue_tracking_systems
 
* http://en.wikipedia.org/wiki/Comparison_of_issue_tracking_systems
 +
* [[:Paketihaldusest paigaldatud PostgreSQL kasutamine Debianiga]]
 +
* [[:Apache'i veebiserver]]

Viimane redaktsioon: 29. märts 2010, kell 15:03

Sissejuhatus

OTRS (Open source Ticket Request System) http://otrs.org/ on vaba tarkvaraline probleemihalduse süsteem (ingl. k. ticket request system). Tarkvara on kirjutatud peamiselt Perl keeles.

Süsteemi ettevalmistamisel ja juurutamisel on abi aadressil http://doc.otrs.org/2.4/en/html/ asuvast juhendist.

Keskkonna ettevalmistamine

OTRS tarkvara kasutamine eeldab muu hulgas sellise tarkvara olemasolu, kõik Debian Lenny paketihaldusest

  • andmebaas - nt PostgreSQL v. 8.3
  • veebiserver - Apache v. 2.2.9
  • hulk perli mooduleid

Kuigi Debiani paketihalduses sisaldub samuti OTRS tarkvara, kirjeldab käesolev teksti tarkvara paigaldamist http://otrs.org/ peal jagatud versioonist 2.4.7. OTRS kasutamiseks vajalike sõltuvuste paigaldamiseks paigaldatakse ja eemaldatakse Debiani paketihalduse otrs2 pakett 

# apt-get install otrs2
# dpkg --purge otrs2

Seejuures tuleb jälgida, et veebiserverit ei jääks eksitama paketihalduse seadistusfail, mis vaikimisi paigutatakse /etc/apache2/conf.d kataloogi.

Lisaks tuleb paigaldada sellised paketid 

# apt-get install libcgi-pm-perl

Lokaadi seadistamine

Selleks, et süsteem saaks korrektselt töötada UTF-8 lokaadiga peab olema paigaldatud locales pakett 

# apt-get install locales

ning seadistatud et_EE.UTF-8 lokaat öeldes 

# dpkg-reconfigure locales

PostgreSQL andmebaasi ettevalmistamine

Kui tingimata pole muid eelistusi võiks OTRS kasutada andmebaasi UTF-8 kodeeringus, sellise PostgreSQLi andmeklustri moodustamiseks sobib nt kustutada olemasolev (mis kustutab kogu parasjagu olemasoleva andmebaasi!) 

# pg_dropcluster 8.3 main --stop

ja moodustada UTF-8 kodeeringus andmekluster 

# pg_createcluster --locale et_EE.UTF-8 8.3 main --start

Seejärel tekitada OTRS jaoks andmebaasi kasutaja 

sql> create user otrs;

ning moodustada andmebaas 

sql> create database otrs;

Vajadusel tuleb kohendada pg_hba.conf failis andmebaasile ligipääsu piiranguid.

OTRS kasutaja moodustamine

Seoses OTRS tarkvaraga peab süsteemis olema selleks moodustatud kasutaja 

# useradd -r -d /opt/otrs/ -c 'OTRS user' otrs
# usermod -G nogroup otrs

Tarkvara paigaldamine

OTRS tarkvara saab kopeerida nt aadressilt http://ftp.otrs.org/pub/otrs/otrs-2.4.7.tar.bz2 ja võiks paigutada kataloogi /opt/otrs 

# cd /opt
# wget http://ftp.otrs.org/pub/otrs/otrs-2.4.7.tar.bz2
# tar jxf otrs-2.4.7.tar.bz2
# mv otrs-2.4.7 otrs

OTRS seadistamine

  • Kopeeritakse kaks rakenduse tööd kontrollivat seadistusfaili paika
# cp /opt/otrs/Kernel/Config.pm.dist /opt/otrs/Kernel/Config.pm
# cp /opt/otrs/Kernel/Config/GenericAgent.pm.dist /opt/otrs/Kernel/Config/GenericAgent.pm
  • Muudetakse sobivaks failide omanikud:grupid ja loabitid
# cd /opt/otrs/bin
# ./SetPermissions.sh /opt/otrs otrs www-data nogroup www-data
  • Veendutakse, et vajalikud süsteemsed komponendid on olemas, tundub, et sellisel juhtumil saab hakata otsast OTRSi kasutama
# cd /opt/otrs/bin
# ./otrs.checkModules | grep "Not installed"
  o DBD::mysql.....................Not installed! (Optional - Required to connect to a MySQL database.)
  o Encode::HanExtra...............Not installed! (Optional - Required to handle mails with several Chinese character sets.)
     o IO::Socket::SSL.............Not installed! (Optional - for POP3 SSL connections)
     o Net::IMAP::Simple::SSL......Not installed! (Optional - Required for SSL connections.)
     o Net::SMTP::SSL..............Not installed! (Optional - Required for SSL/SMTPS connections.)
  o Net::LDAP......................Not installed! (Optional - Required for directory authentication.)
  o PDF::API2......................Not installed! (Optional - Required for PDF output.)
  o SOAP::Lite.....................Not installed! (Optional - Required for the SOAP interface.)
  • Täiendavad kontrollid
# cd /opt/otrs
# perl -cw bin/cgi-bin/installer.pl
cgi-bin/installer.pl syntax OK

# perl -cw bin/PostMaster.pl
PostMaster.pl syntax OK
  • Valmistatakse ette andmebaas
$ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-schema.postgresql.sql
$ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-initial_insert.postgresql.sql 
$ psql -h 127.0.0.1 -U otrs otrs < /opt/otrs/scripts/database/otrs-schema-post.postgresql.sql

ning näidatakse Kernel/Config.pm failis ligipääs andmebaasile 

   $Self->{DatabaseHost} = '127.0.0.1';
   $Self->{Database} = 'otrs';
   $Self->{DatabaseUser} = 'otrs';
   $Self->{DatabasePw} = 'parool';
   $Self->{DatabaseDSN} = "DBI:Pg:dbname=$Self->{Database};host=$Self->{DatabaseHost};";
  • UTF-8 kasutamiseks tuleb seadistusfailis Kernel/Config.pm näidata
$Self->{DefaultCharset} = 'utf-8';

Veebiserveri seadistamine

Veebiserveris sobib alustuseks seadistada üks minimaalse sisuga VirtualHost ning kasutada seal sisulise osana teksti failist 

/opt/otrs/scripts/apache2-httpd-new.include.conf

OTRS kasutamine

Vaikimisi asub OTRS sarnasel aadressil http://loomaaed.tartu.ee/otrs/login.pl, esmaseks sisselogimiseks saab kasutada, parool tuleks kohe muuta

  • kasutajanimi - root@localhost
  • parool - root

Otrs-1.gif

CRON tööd

CRON tööde skriptid asuvad kataloogis /opt/otrs/var/cron.

  • Esmalt tuleb skriptid kopeerida ilma .dist lõputa nimede alla, nt nii
# /opt/otrs/var/cron# for foo in *.dist; do cp $foo `basename $foo .dist`; done
  • Seejärel paigaldada otrs kasutajale CRON tööd
# su - otrs
$ cd bin
$ ./Cron.sh start
/opt/otrs/bin
Cron.sh - start/stop OTRS cronjobs - <$Revision: 1.19 $> 
Copyright (C) 2001-2009 OTRS AG, http://otrs.org/
(using /opt/otrs) done

OTRS logi

OTRS on tubli logija, lisaks veebiserveri logile kirjutatakse nt /var/log/syslogi selliseid sissekandeid 

Mar 27 13:07:03 loomaaed OTRS-CGI-10[9343]: [Notice][Kernel::System::Auth::DB::Auth] 
  User: priit authentication ok (REMOTE_ADDR: 192.168.10.10).
Mar 27 13:07:14 loomaaed OTRS-CGI-10[9343]: [Notice][Kernel::System::AuthSession::DB::RemoveSessionID]
  Removed SessionID 100a5b4290d6ef72a0be7d67b0c5cef208.

Nt CRON tööna POP3 kontolt eposti kopeerimine paistab syslogis 

Mar 29 14:40:06 loomaaed OTRS-PMAccount-10[7208]: [Notice][Kernel::System::MailAccount::POP3::_Fetch]
  POP3: Fetched 1 email(s) from info@loomaaed.tartu.ee/smtp.loomaaed.tartu.ee.

Eposti seadistamine

TODO

Märkused

  • Grupilist funktsionaalsust saab lisada failis Kernel/Config.pm parameetriga
$Self->{CustomerGroupSupport} = 1;

Kasulikud lismaterjalid

Pärit leheküljelt "https://kuutorvaja.eenet.ee/w/index.php?title=OTRS_kasutamine_Debian_Lenniga&oldid=18824"