„Korio“ diegimo vadovas

Anotacija

Šitas dokumentas orientuotas į vartotojus, mokančius dirbti Linux komandine eilute. Čia aprašoma, kaip suinstaliuoti sistemą iš pirminių tekstų ir nusako komponentus, kurie būtinai turi būti įdiegti ir turi veikti tokioje sistemoje.

Sistemos reikalavimai

  1. Įdiegtas python kalbos interpretatorius (versija 2.3.5).

  2. Įdiegtas C kompiliatorius (geriausia GCC [testuota su versija 3.4.4]).

  3. Įdiegta make paslaugų programa (utility) [testuota su versija 3.80].

  4. Zope tinklo programinės įrangos serveris (web application server) (versija 2.8.6).

  5. Korys sistemos pirminis kodas.

  6. Įdiegtas Subversion versijavimo sistema (versija 1.3.0).

  7. Įdiegta pySVN Python'o kalbos biblioteka (versija 1.4.1).

Zope serverio diegimas

Visų pirma, ištraukit Zope failus iš archyvo. Toliau reikia patikrinti ar visi diegimo reikalavimai yra išpildyti.

tar zxvf Zope-2.8.6-final.tgz

cd Zope-2.8.6-final

./configure –prefix=~/zope-test

Bus ne tik įvykdytas patikrinimas, bet ir sukurtas specialus makefile failas, kuris įdiegs Zope serverį į pageidaujamą vietą.

make && make install

Bus sukompiliuoti visi reikiami failai ir įrašyti į nurodytą aplanką, jei neįvyks klaidų. Dabar kai viskas paruošta, galima pradėti derinti Zope serverį.

~/zope-test/bin/mkzopeinstance.py

Please choose a directory in which you'd like to install

Zope "instance home" files such as database files, configuration

files, etc.


Directory: ~/Zope-Inst/

Please choose a username and password for the initial user.

These will be the credentials you use to initially manage

your new Zope instance.


Username: <username>

Password:

Verify password:

Šitas derinimo failas sukurs Zope serverio instansas. Bus paprašyta nurodyti kelią, kur gulės visi susiję failai, ten bus diegiami produktai ir derinamas serveris. Be to reikės nurodyti vartotoją, kuris turės administratoriaus privilegijas ir jo slaptažodį.

SVARBU! Negalima tai daryti iš root vartotojo. Tas yra padaryta iš saugumo sumetymų.

Serverio diegimas kaip ir baigtas. Norintys „pasikapštyti“ papildomai , gali pažiūrėti zope.conf failą, kuri galima rasti /etc direktorijoje.

~/Zope-Inst/bin/runzope – šita komanda paleidžia Zope serverį. Patikrinti ar viskas veikia galima paleidus naršyklę ir surinkus adresą: localhost:8080/manage. Tai yra adresas, kurį Zope naudoja pagal nutylėjimą.

Jei viskas praėjo gerai, tai atsiras toks puslapis:


Didžioji dalis valdymo vyksta per ZMI (Zope Management Interface).


Korys sistemos diegimas

Pats sistemos įdiegimas yra labai paprastas. Tereikia nukopijuoti failus į sukurto Zope instanso Products aplanką.

tar zxvf Korys.tar.gz

cd Korys

cp -pR * ~/Zope-Inst/Products/

Dabar galime paleisti Zope ir pereiti prie „Korys“ sistemos diegimo.

Dešiniajame išskleidžiamajame meniu prie mygtuko „ADD“ pasirenkam „Plone Site“.

Paskui pasirenkam unikalų vardą ir įrašom jį į ID lauką. „Customisation policy setup“ išskleidžiamajame meniu būtina pasirinkti „Korys Site“. Lauke „Description“ galima pateikti trumpą aprašymą, tačiau tai nėra privaloma.


Baigus pildyti laukus paspauskite mygtuką „Add Plone Site“. Po to luktelėkite, kol atsiras toks vaizdas:


Jei atsirado kokių nors problemų diegimo metų ir Jus negavote tokio vaizdo, tai praneškite apie tai kūrėjams adresu http://evitaminai.lt/korys/newticket ir užpildykite klaidos ataskaitą.

SVN repozitorijų sukūrimas

Pagal nutylėjimą visos projektų failų saugyklos kuriamos /var/svn aplanke. Šituos nustatymus galima pakeisti, modifikavus ~/Zope-Inst/Products/Korys/Projects/config.py failą.

Jame reikia pakeisti vienos eilutės reikšmę: SVN_DIR = '/var/svn' ir nurodyti reikiamą kelią.

Saugyklos kelias privalo duoti rašymo teises Zope serverio administratoriui.

Atsarginių kopijų darymas

Automatizuoti atsarginių kopijų darymą yra gana paprasta. Visų pirma reikia nukopijuoti kelis failus iš scripts aplanko į vykdomų failų aplanką.

cp -p KorysProjects/scripts/*.py ~/Zope-Inst/bin/

Toliau reikia paredaguoti config.py failą, nustatyti visus kelius ir pridėti įrašą į /etc/crontab'ą:

30 3 * * sun python2.3 ~/Zope-Inst/bin/backup-zope.py

Tokie nustatymai darys atsargines kiekvieną sekmadienį 3:30 valandą.

Norint atkurti duomenų bazę iš atsarginės kopijos tereikia paleisti komandą:


python2.3 ~/Zope-Inst/bin/restore-zope.py [- -date=2006-04-01]

Nebūtinas argumentas nurodo kokios dienos atsarginę kopiją pasinaudoti.

Pastaba: prieš atkuriant duomenys būtina sustabdyti Zope serverį.

Zope serverio derinimas su Apache web serveriu

Reikalavimai:

  1. Įjungtas mod_rewrite modulis

  2. Įjungtas mod_proxy modulis

Norint padaryti readresaciją pasinaudojant Apache reikia sukurti naują virtualų hostą. Aplanke, kuris yra nurodytas httpd.conf derinimo faile reikia sukurti naują failą ir jame aprašyti naujo virtualaus hosto atributus ir adreso perrašymo taisykles.

Pavyzdis:

include /etc/apache2/vhosts.d/ - aplankas, kuriame saugomi virtualių hostų aprašymai.

korys.conf failo sudėtis:

<VirtualHost *>

ServerName www.korys.lt

ServerAlias www.korys.lt

RewriteEngine On

RewriteRule ^/(.*) http://localhost:8028/VirtualHostBase/http/projektai.evitaminai.lt:80/VirtualHostRoot/$1 [P]

ErrorLog /var/log/weblogs/www.korys.lt-error_log

TransferLog /var/log/weblogs/www.korys.lt-access_log

</VirtualHost>

Terminų žodynėlis

  1. Zope serverio administratorius – vartotojas, nurodytas kuriant Zope instansą.

  2. Paslaugų programa (utility) – maža programa atliekanti pagalbinę funkciją

  3. Zope serverio instansas.(server instance) - individuali aplinka, turinti savo produktus ir nustatymus

  4. Derinimo failas (configuration file) – konfigūracinis failas, kuriame saugomi sistemos nustatymai