Telepítési és üzemeltetési útmutató - Laptörténet

MaXX: /* OpenERP */

2011-08-12T19:48:58Z

OpenERP

← Régebbi változat		A lap 2011. augusztus 12., 19:48-kori változata
99. sor:		99. sor:
	Ezért a mi rendszerünk a következőképpen működik:		Ezért a mi rendszerünk a következőképpen működik:
	* a böngészőktől kapott kéréseket, parancsokat az apache kapja meg a szokásos, 80-as porton.		* a böngészőktől kapott kéréseket, parancsokat az apache kapja meg a szokásos, 80-as porton.
	* Az apache a webkliensnek szóló kéréseket, parancsokat a webkliensnek továbbítja, míg a többi letöltést a neki megfelelő szoftvernek (mediawiki) vagy könyvtárnak (<tt>/res</tt>). Ehhez az apache <tt>mod_rewrite</tt> moduljának ~~összett~~ beállítása szükséges. A szükséges konfigurációs állományok címét fentebb találhatjuk.		* Az apache a webkliensnek szóló kéréseket, parancsokat a webkliensnek továbbítja, míg a többi letöltést a neki megfelelő szoftvernek (mediawiki) vagy könyvtárnak (<tt>/res</tt>). Ehhez az apache <tt>mod_rewrite</tt> moduljának összetett beállítása szükséges. A szükséges konfigurációs állományok címét fentebb találhatjuk.

	Mindkét démon elindításához és leállításához bonyolult parancsok kiadása szükséges. Ennek egyszerűsítésére jött létre az rr (restarter) shellscript, amit a <tt>/opt/ikszt/rr</tt> címem találunk. A script csak létező terminálról indul el. Az rr script más műveletek végrehajtására (pl. adatbázis felülírása) is képes, de ezek a funkciók csak a fejlesztést szolgálják, üzemeltetésre őket ne használjuk.		Mindkét démon elindításához és leállításához bonyolult parancsok kiadása szükséges. Ennek egyszerűsítésére jött létre az rr (restarter) shellscript, amit a <tt>/opt/ikszt/rr</tt> címem találunk. A script csak létező terminálról indul el. Az rr script más műveletek végrehajtására (pl. adatbázis felülírása) is képes, de ezek a funkciók csak a fejlesztést szolgálják, üzemeltetésre őket ne használjuk.

MaXX: /* OpenERP */

2011-04-08T07:46:11Z

OpenERP

← Régebbi változat		A lap 2011. április 8., 07:46-kori változata
89. sor:		89. sor:

	=== OpenERP ===		=== OpenERP ===
	* a <tt>/opt/ikszt/rr</tt> ~~script segítségével indítsuk~~ el az ~~openerp server~~ és ~~webclient démonokat~~		A rendszer magja a nyílt forráskódú OpenERP rendszer. Ezen számos továbbfejlesztést végeztünk (magyar nyelvi támogatás, továbbfejlesztések), valamint létrehoztuk a fő funkcionalitást biztosító IKSZT modult.
	* ~~megfelelő böngészőurl~~-~~ek megtekintésével~~, ~~oda belépéssel ellenőrizzük~~ a megfelelő ~~futást~~.
			Az openerp két, python nyelven írt démonból áll, ezek:
			* objektumszerver: a <tt>/opt/ikszt/server</tt> könyvtárban található, és a különböző entitások kezelését, menedzselését végzi. Az üzleti logika is itt van. Közvetlen kapcsolatot csak a postgresql felé kezdeményez, ahol is az objektumok tényleges adatai vannak tárolva.
			* webkliens: a <tt>/opt/ikszt/web</tt> könyvtárban található, és az objektumszerver által kezelt objektumot megjelenítését, szerkesztését végzi úgy, hogy egyúttal a böngészők részére webszerver funkciót is biztosít. Nevének utótagját - kliens - az objektumszerver nézőpontjából kell érteni: ő egy olyan szoftver, akire a webböngészők kapcsolódnak, és az általuk óhajtott változásokat az objektumszerverben hajtja végre. Külső szemlélő számára ez is egy szerverprogram, egy démon, aki a böngészőktől kapott utasításokat fogadja, és az objemtukszervernek továbbítja.

			Az openerp rendszer ezen annyit bővít, hogy közvetlenül a webkliens sem érhető el. Ennek oka az, hogy a web irányából a webkliens kezelésén kívül más funkciókat is ellát a rendszer (wiki, file fel- és letöltés stb.)

			Ezért a mi rendszerünk a következőképpen működik:
			* a böngészőktől kapott kéréseket, parancsokat az apache kapja meg a szokásos, 80-as porton.
			* Az apache a webkliensnek szóló kéréseket, parancsokat a webkliensnek továbbítja, míg a többi letöltést a neki megfelelő szoftvernek (mediawiki) vagy könyvtárnak (<tt>/res</tt>). Ehhez az apache <tt>mod_rewrite</tt> moduljának összett beállítása szükséges. A szükséges konfigurációs állományok címét fentebb találhatjuk.

			Mindkét démon elindításához és leállításához bonyolult parancsok kiadása szükséges. Ennek egyszerűsítésére jött létre az rr (restarter) shellscript, amit a <tt>/opt/ikszt/rr</tt> címem találunk. A script csak létező terminálról indul el. Az rr script más műveletek végrehajtására (pl. adatbázis felülírása) is képes, de ezek a funkciók csak a fejlesztést szolgálják, üzemeltetésre őket ne használjuk.

			Az rr script létező virtuális terminált igényel, ezért célszerű parancssorból, például <tt>screen</tt>-ből indítani.

	== Üzemeltetés ==		== Üzemeltetés ==

MaXX: /* Kimenő levélszerver */

2011-04-08T07:21:59Z

Kimenő levélszerver

← Régebbi változat		A lap 2011. április 8., 07:21-kori változata
26. sor:		26. sor:

	=== Kimenő levélszerver ===		=== Kimenő levélszerver ===
	Egy - tipikusan 25-ös TCP porton át - elérhető kimenő levélszerver a kimenő email-üzenetek kezelésére. Autentikáció, ssl/tls nélkül, közvetlenül legyen alkalmas kimenő levelek továbbítására. Feltehetőleg az Üzemeltetésnek erre van alkalmas rendszere, de általában a CentOS-ba integrált levélszerverek is alkalmasak erre a megfelelő beállításokkal. ''Elérhetőség: Üzemeltető rendszerén belül vagy a CentOS része.''		Egy - tipikusan 25-ös TCP porton át - elérhető kimenő levélszerver a kimenő email-üzenetek kezelésére. Autentikáció, ssl/tls nélkül, közvetlenül legyen alkalmas az OpenERP-ből küldött kimenő levelek továbbítására. Feltehetőleg az Üzemeltetésnek erre van alkalmas rendszere, de általában a CentOS-ba integrált levélszerverek is alkalmasak erre a megfelelő beállításokkal. ''Elérhetőség: Üzemeltető rendszerén belül vagy a CentOS része.''

	=== Mediawiki dokumentumkezelő rendszer ===		=== Mediawiki dokumentumkezelő rendszer ===

MaXX: /* Hibajelzések, javítások */

2011-04-08T07:19:41Z

Hibajelzések, javítások

← Régebbi változat		A lap 2011. április 8., 07:19-kori változata
102. sor:		102. sor:
	Az ambient tesztkörnyezetet üzemeltet a http://ikszt.hrod.hu címen, ahol a telepített rendszer egy belső elérésű példánya fut. Amennyiben nem férünk hozzá az éles rendszerhez, úgy a hiba javításához előbb reprodukálnunk kell tudni a tesztkörnyezetben.		Az ambient tesztkörnyezetet üzemeltet a http://ikszt.hrod.hu címen, ahol a telepített rendszer egy belső elérésű példánya fut. Amennyiben nem férünk hozzá az éles rendszerhez, úgy a hiba javításához előbb reprodukálnunk kell tudni a tesztkörnyezetben.

	A fejlesztés forrásfáját egy svn -ben tároljuk, ami a http://svn.ambientintelligence.hu/ikszt címen érhető el. A javítások, továbbfejlesztések, módosítások is ide kerülnek, ahonnan Üzemeltető töltheti le őket a <tt>/opt/ikszt</tt> könyvtárban kiadott <tt>svn update</tt> paranccsal.		A fejlesztés forrásfáját egy svn -ben tároljuk, ami a http://svn.ambientintelligence.hu/ikszt címen érhető el. A javítások, továbbfejlesztések, módosítások is ide kerülnek, ahonnan Üzemeltető töltheti le őket a <tt>/opt/ikszt</tt> könyvtárban kiadott <tt>svn update</tt> paranccsal. Frissítés vagy javítás telepítése után az openerp démonokat újra kell indítani (ld. fentebb).

	Az svn-hez és a mantishoz való hozzáférések biztosításával kapcsolatban további egyeztetést kérünk.		Az svn-hez és a mantishoz való hozzáférések biztosításával kapcsolatban további egyeztetést kérünk.

MaXX: /* Hardwarekörnyezet */

2011-04-08T07:17:57Z

Hardwarekörnyezet

← Régebbi változat		A lap 2011. április 8., 07:17-kori változata
12. sor:		12. sor:
	Használattól függően a hardware-igény sokáig lineárisan nő (jól skálázható a rendszer).		Használattól függően a hardware-igény sokáig lineárisan nő (jól skálázható a rendszer).

	Mivel várható, hogy - különösen különböző határidők előtt -, hogy esetenként a rendszer igénybevétele hirtelen lényegesen megugrik, javasoljuk a hardwarekörnyezet túlméretezését.		Mivel várható, hogy - különösen különböző határidők előtt -, hogy esetenként a rendszer igénybevétele hirtelen lényegesen megugrik, javasoljuk a hardwarekörnyezet jelentős túlméretezését.

	''Elérhetőség: Üzemeltető biztosítja.''		''Elérhetőség: Üzemeltető biztosítja.''

MaXX: /* Mediawiki */

2011-04-08T07:17:20Z

Mediawiki

← Régebbi változat		A lap 2011. április 8., 07:17-kori változata
86. sor:		86. sor:
	A mediawiki az openerp -pel azonos adatbázist használ, de annak egy másik, a "wiki" nevű sémáját. A wiki séma adatbázisdumpjának 2011.3.28-i változata a leadott CD-n van, ám javasoljuk a fejlesztés által, egyeztetést követően megadott dump használatát, hogy az azóta elvégzett változtatások is felkerüljenek.		A mediawiki az openerp -pel azonos adatbázist használ, de annak egy másik, a "wiki" nevű sémáját. A wiki séma adatbázisdumpjának 2011.3.28-i változata a leadott CD-n van, ám javasoljuk a fejlesztés által, egyeztetést követően megadott dump használatát, hogy az azóta elvégzett változtatások is felkerüljenek.

	A mediawiki ~~konfigurációjának~~ annak forrásában van, amit a CD-n átadtunk. Pontos helye a <tt>/opt/wiki/wiki/LocalSettings.php</tt> fájl.		A mediawiki konfigurációs állománya annak forrásában van, amit a CD-n átadtunk. Pontos helye a <tt>/opt/wiki/wiki/LocalSettings.php</tt> fájl.

	=== OpenERP ===		=== OpenERP ===

MaXX: /* Python2.6 */

2011-04-08T07:06:30Z

Python2.6

← Régebbi változat		A lap 2011. április 8., 07:06-kori változata
80. sor:		80. sor:
	Az adatbázisban az alapértelmezett <tt>public</tt> sémát az OpenERP, míg a <tt>wiki</tt> sémát a wiki motor használja.		Az adatbázisban az alapértelmezett <tt>public</tt> sémát az OpenERP, míg a <tt>wiki</tt> sémát a wiki motor használja.

	=== ~~Python2~~.6 ===		=== Python 2.6 ===
	A fentebb megadott címről töltsük le, és csomagoljuk ki a pythont a <tt>/opt/python26</tt> könyvtárba.		A fentebb megadott címről töltsük le, és csomagoljuk ki a pythont a <tt>/opt/python26</tt> könyvtárba.

MaXX, 2011. április 8., 07:05-n

2011-04-08T07:05:59Z

← Régebbi változat		A lap 2011. április 8., 07:05-kori változata
50. sor:		50. sor:
	* apache		* apache
	* postgresql szerver		* postgresql szerver
	* openerp server 5.0.15 (saját ~~anyag~~, a CentOS-nak nem része. Nálunk a /opt könyvtárban van, neki szolgáló scripttel indítjuk)		* openerp server 5.0.15 (saját fejle, a CentOS-nak nem része. Nálunk a /opt könyvtárban van, neki szolgáló scripttel indítjuk)
	* openerp webclient 5.0.15 (saját anyag, a CentOS-nak nem része. Nálunk a /opt könyvtárban van, neki szolgáló scripttel indítjuk)		* openerp webclient 5.0.15 (saját anyag, a CentOS-nak nem része. Nálunk a /opt könyvtárban van, neki szolgáló scripttel indítjuk)

78. sor:		78. sor:
	Hozzunk létre az adatbázisban egy <tt>wiki</tt> nevű sémát is.		Hozzunk létre az adatbázisban egy <tt>wiki</tt> nevű sémát is.

	~~A rendszer működése olyan, hogy~~ az alapértelmezett <tt>~~default~~</tt> sémát az OpenERP, míg a wiki sémát a wiki motor használja.		Az adatbázisban az alapértelmezett <tt>public</tt> sémát az OpenERP, míg a <tt>wiki</tt> sémát a wiki motor használja.

	=== ~~Telepítsük fel a rendszer által használt 2~~.6~~-os pythont~~ ===		=== Python2.6 ===
	A fentebb megadott címről töltsük le, és csomagoljuk ki a pythont a <tt>/opt/python26</tt> könyvtárba.		A fentebb megadott címről töltsük le, és csomagoljuk ki a pythont a <tt>/opt/python26</tt> könyvtárba.

	=== Mediawiki ===		=== Mediawiki ===
			A mediawiki az openerp -pel azonos adatbázist használ, de annak egy másik, a "wiki" nevű sémáját. A wiki séma adatbázisdumpjának 2011.3.28-i változata a leadott CD-n van, ám javasoljuk a fejlesztés által, egyeztetést követően megadott dump használatát, hogy az azóta elvégzett változtatások is felkerüljenek.

			A mediawiki konfigurációjának annak forrásában van, amit a CD-n átadtunk. Pontos helye a <tt>/opt/wiki/wiki/LocalSettings.php</tt> fájl.

	=== OpenERP ===		=== OpenERP ===
			* a <tt>/opt/ikszt/rr</tt> script segítségével indítsuk el az openerp server és webclient démonokat
			* megfelelő böngészőurl-ek megtekintésével, oda belépéssel ellenőrizzük a megfelelő futást.

			== Üzemeltetés ==
			A rendszert a VKSZI üzemelteti. A projektet a [[http://hrod.hu HROD]] manageli, a fejlesztést pedig a HROD alvállalkozójaként az [[http://ambientintelligence.hu Ambient Intelligence]] végzi. Közvetlen kapcsolat csak a VKSZI és a HROD, valamint a HROD és az Ambient között van.

			=== Hibajelzések, javítások ===
			Az ambient hibakezelő rendszere (mantis) a http://mantis.ambientintelligence.hu címen található. Hibák, kérdések, felmerült problémák esetén a jelzést a mantisban rögzíteni kell. A hibajelzésekhez screenshot mellékelését, valamint a hiba ''részletes'' leírását is kérjük.

			Amennyiben egy hibajelzéssel kapcsolatban további információt kérünk, vagy nem látjuk valós hibának, azt a mantisban jelezzük. Esetleges felmerülő hibák javítását szintén a mantisban jelezzük.

			Az ambient tesztkörnyezetet üzemeltet a http://ikszt.hrod.hu címen, ahol a telepített rendszer egy belső elérésű példánya fut. Amennyiben nem férünk hozzá az éles rendszerhez, úgy a hiba javításához előbb reprodukálnunk kell tudni a tesztkörnyezetben.

	* a /opt/ikszt/~~rr script segítségével indítsuk el~~ az ~~openerp server és webclient démonokat~~		A fejlesztés forrásfáját egy svn -ben tároljuk, ami a http://svn.ambientintelligence.hu/ikszt címen érhető el. A javítások, továbbfejlesztések, módosítások is ide kerülnek, ahonnan Üzemeltető töltheti le őket a <tt>/opt/ikszt</tt> könyvtárban kiadott <tt>svn update</tt> paranccsal.
	* megfelelő böngészőurl-ek megtekintésével, ~~oda belépéssel ellenőrizzük~~ a ~~megfelelő futást~~.
			Az svn-hez és a mantishoz való hozzáférések biztosításával kapcsolatban további egyeztetést kérünk.

			=== Sürgős esetek ===
			Javasoljuk, hogy sürgős problémák esetére alakítsunk ki az ilyenkor szükséges gyorsított ügymenetet.

			=== Bővítések, támogatás ===
			A rendszer továbbfejlesztésére vonatkozó igényeket szintén a mantisban tároljuk. Bővítés vagy továbbfejlesztés esetén itt jelezzük annak becsült erőforrásigényeit illetve szükség esetén itt tisztázzuk a pontos ügyféligényt.

MaXX: /* Szükséges rendszerelemek */

2011-04-08T06:11:41Z

Szükséges rendszerelemek

← Régebbi változat		A lap 2011. április 8., 06:11-kori változata
1. sor:		1. sor:
	{{Védett}}		{{Védett}}
	== Szükséges rendszerelemek ==		== Szükséges rendszerelemek ==
	Ezek a rendszerelemek a szoftver optimális beállításához szükségesek. Igény esetén ettől való kisebb-nagyobb mértékű eltérés megvalósítható, de ilyen esetben a ~~részlettekkel~~ és várható nehézségekkel kapcsolatban egyeztetést kérünk.		Ezek a rendszerelemek a szoftver optimális beállításához szükségesek. Igény esetén ettől való kisebb-nagyobb mértékű eltérés megvalósítható, de ilyen esetben a részletekkel és várható nehézségekkel kapcsolatban egyeztetést kérünk.

	=== Hardwarekörnyezet ===		=== Hardwarekörnyezet ===

MaXX: /* Mediawiki dokumentumkezelő rendszer */

2011-04-08T06:10:14Z

Mediawiki dokumentumkezelő rendszer

← Régebbi változat		A lap 2011. április 8., 06:10-kori változata
32. sor:		32. sor:
	* ''a mediawiki szabad szoftver''		* ''a mediawiki szabad szoftver''
	* ''a forráskódot és az adatbázisát a leadott CD tartalmazza (2011.3.28-i változat)''		* ''a forráskódot és az adatbázisát a leadott CD tartalmazza (2011.3.28-i változat)''
	* ''kívánság esetén a frissített adatbázissal a legújabb változatot elérhetővé tesszük, egyúttal a saját rendszerünkön található változatot megszüntetjük.'' '''Nyomatékosan javasoljuk, hogy a wikiből a teljes infrastruktúrában csak egyetlen példány létezzen. Többszörös wiki példány (például, ha Fejlesztő tesztkörnyezetében és ~~az éles rendszerben~~ is van egy-egy) esetén zavart okozhat, ha a lapokon elvégzett változtatások nem a megfelelő példányban történnek.'''		* ''kívánság esetén a frissített adatbázissal a legújabb változatot elérhetővé tesszük, egyúttal a saját rendszerünkön található változatot megszüntetjük.'' '''Nyomatékosan javasoljuk, hogy a wikiből a teljes infrastruktúrában csak egyetlen példány létezzen. Többszörös wiki példány (például, ha Fejlesztő tesztkörnyezetében és Üzemeltetőnél is van egy-egy példány) esetén zavart okozhat, ha a lapokon elvégzett változtatások nem a megfelelő példányban történnek.'''

	=== OpenERP forrásfa ===		=== OpenERP forrásfa ===