Smart Storage for Linux telepítési útmutató ****************************************************************** 1. A tömörített fájl kibontása ------------------------------ Nyissunk terminálablakot és váltsunk "root" felhasználóra a "su" paranccsal, ami bekéri a root-jelszót. Lépjünk olyan könyvtárba ahol dolgozhatunk. Másoljuk ide a letöltött fájlt. Utána adjuk ki a következő parancsot: "tar xvzf SmartStorage-xxx.tar.gz" Ezzel létrejön egy "SmartStorage" könyvtár. Ezt az egész könyvtárat másoljuk a "/usr/share" alkönyvtárba. Így az alapértelmezett telepítési helyre kerül a program: "/usr/share/SmartStorage". Ha ezt tesszük, nem kell módosítani az indító-szkriptekben lévő SS_PATH értékét, és a storage.ini-ben a számla importálásához szükséges (*.rep) jelentés-fájlok helyét sem. Egy szimbólikus linket kell lértehoznunk erről az "/usr/bin" könyvtárba "smartstorage" névvel, hogy ezzel a paranccsal indíthassuk a programot, e-nélkül is működik a program, de akkor mindig meg kell adni az indítási parancsban a telepítési helyet is ("/usr/share/SmartStorage/smartstorage.sh"). Ezt legegyszerűbben a "Midnight Commader" programmal végezhetjük el, ami az "mc" paranccsal indul. De kiadhatjuk a következő parancsot is "ln -s /usr/share/SmartStorage/smartstorage.sh /usr/bin/smartstorage" 1/a. ADATBÁZISOK 1.2.x verzióktól --------------------------------- PosgtreSQL: Elérhető egy script "/usr/share/SmartStorage/create_pg_database.sh". Ha ezt lefuttatjuk egy SmartStorage nevű adatbázist hozunk létre a lokális PostgreSQL szerverünkön, amit a "/usr/share/SmartStorage/data" könyvtárban lévő "smartstorage-XX.backup" fájlból hoz lérte . FireBird: Elérhető egy "/usr/share/SmartStorage/data/smartstorage.gdb" előre elkészített adatbázis is. Ezt válasszuk ki amikor a program rákérdez az adatbázis kapcsolatokra. Fontos, hogy ezt a fájlt legyen joga írni a Firebird SQL szervizt futtató usernek. Ez alapértelmezés szerint "firebird" nevü felhasználó. 1/b. Kapcsolódás adatbázisokhoz ------------------------------- Első indításkor a felhasználó könyvtárában nem létezik a "storage.ini" fájl a "/home//.smartstorage" könyvtárban. Ezeket a programok létrehozzák. Mivel még a rendszer nem tudja hogy Firebird vagy PostgreSQL adatbázist fogunk használni a legenerált configurációs fájl nem teljesn korrekt!!!! Az adatbázisra és azonosításra a program rákérdez! 1/c. Új ÜRES adatbázis létrehozása ---------------------------------- Az adatbázist és azon belül a tábla-struktúrát a következő programmal hozhatjuk létre: (ha máshová telepítettünk akkor onnét indul!!!!) /usr/share/SmartStorage/ssdatabases.sh A scriptet indítva létrehozhatjuk a programmal az adatbázist és benne a struktúrát, amit a program használ adatai tárolására. Válasszuk az "Adatstruktúra létrehozása" menüt, ezen belül pedig a kívánt típusú adatbázist! A program rákérdez akajuk-e, hogy létrehozzon új adatbázist vagy meglévőt használunk! Egy dialog-ablak jelenik meg, ahová meg kell adjuk a szokásos adatbázis-kapcsolódási információkat. A port-ot csak akkor modosítsuk, ha az adatbázis szerver nem az alapértelmezett porton fut! Ha minden rendben lefut a "Kapcsolódás" parancs kiadása után, akkor létrejön a kívánt struktúra. A program nem módosítja az inifájlok beállításait ha az már létezett (indításkor létrejön). PostgreSQL létrehozása esetén a háttérben meghívott "psql" parancs paraméterei nem tartalmazzák a "-W" opciót (prompt a jelszóhoz). Így az nem kér be jelszót, ha a USER TRUSTED!!! Ha nem, akkor a terminálba (amiből indítuttuk a programot) kell ezt beírni. (Sajnos :-( !) Így jobb ha konzolból indítjuk a programot !!!!!!!!!!!!!!!!!!!!!!!!!!!!!! A használt USER-t TRUSTED-nek be lehet állítani a "/var/lib/psotgres/data/pg_hba.conf" fájlban. A létrehozás után erre nincs szükség!!! 2. Ha nincs a rendszeren telepített FireBird -------------------------------------------- Az 1.0.2.x, 1.0.3.x (ez a javasolt) vagy 1.5.x verziót telepíteni kell. Ezt letölthetjük a http://firebird.sourceforge.net címről. 2.1. Csak "root"-ként tehetjük ezt meg, ha kiléptünk váltsunk szuperuser módra a következő paranccsal "su". (Itt a root jelszavát kell majd megadni!!!) 2.1. RPM alapú rendszereken (RedHat, Fedora, SuSE, Mandrake) --- "rpm -ivh FirebirdCS-1.0..rpm" 2.2. DEB alapú rendszereken (Debian, UHU) --- "rpm -ivh FirebirdCS-1.0..rpm --nodeps" Használhatjuk az "alien" nevű programot is. 2.3. Ha volt telepített Firebird --- Lehet, hogy a "SYSDBA" jelszava nem egyezik a "storage.ini" fájlba lévő beállításokkal. Ezt akkor ott módosítani kell! 2.4 A Firebird elindítása (1.0.2 és 1.0.3 esetén) --- Az "/etc/init.d/xinetd stop" és "/etc/init.d/xinetd start"-ról ne feletkezzünk meg, ugyanis ez indítja el az adatbázis-szervert. Ezt a futási szinteknél automatizálhatjuk is. Sok egyéb alkalmazás is ezzel indul. SuSE alatt ha jól tudom ez alapbeállítás, de nekem UHU 1.1 RC5 alatt be kellett állítani. 2.4 A Firebird elindítása (1.5.x esetén) --- Az "/etc/init.d/firebird start"-ról ne feletkezzünk meg, ugyanis ez indítja el az adatbázis-szervert, mint szolgáltatást. Ezt a futási szinteknél automatizálhatjuk is. 3. PostgreSQL ------------- Telepítsük a rendszer csomgakezelőjével a PostgreSQL adatbáziskezelő programcsomagot. Ha a szerver is erre a gépre kerül, akkor azt is. Ha csak kliens akkor elég annak telepítése! Létrehozhatjuk az adatbázist a szerveren a SmartStorage program számára a következő paranccsal: createdb -E=iso8859-2 SmartStorage A használni kívánt adatbázis létrehozásakor adjuk meg a kódolást is (-E, --encoding=ENCODING encoding for the database)! Ez lehet latin2 vagy UNICODE is 1.3-as sorozattól. Módosítsuk a storage.ini fájlt: PROTOCOL_ZeOS=postgresql USERNAME= PASSWORD= Unicode (utf8) esetén a program indító scriptjében legyenek: LANG=hu_HU.utf8 LC_ALL=hu_HU.utf8 Latin2/iso-8859-2 esetén a program indító scriptjében legyenek: LANG=hu_HU.iso-8859-2 LC_ALL=hu_HU.iso-8859-2 A pont utáni rész fontos (utf8/iso-8859-2), és ezzel megegyező kódolású nyelvi fájl használata ajánlott különben '?'-ek és érdekes karakterek lesznek az ékezetes betűk helyén! 4. A "smartstorage.sh" beállítása --------------------------------- A fájl tartalma: ********************************************************************** #!/bin/sh SS_PATH=/usr/share/SmartStorage export LD_LIBRARY_PATH=$SS_PATH/kylix3_libs:$LD_LIBRARY_PATH # Ez a karakterek kódolásának beállításához, használatához kell. Az érték egyes disztribúcióknál # lehet "hu_HU.iso-8859-2" vagy "hu_HU.Latin2" vagy "hu_HU.utf8" LANG=hu_HU.iso-8859-2 ..... $SS_PATH/SmartStorage storage.ini ********************************************************************** A fájl tartalmát, csak akor kell módosítani, ha nem az alapértelmezett "/usr/share" helyre másoltuk a kitömörített könyvtárat. Értelemszerűen módosítsuk az elérési utat és a program ennek a scriptnek a hívásával indul. Ha szimbólokus link létezik az "/usr/bin" könyvtárba erre a script-re, elég ennek nevével indítani a programot. 5. A "storage.ini" beállítása (# ->> megjegyzés) ------------------------------------------------ A fájl eredeti állapota ********************************************************************** [Database] HOST=localhost # ->> vagy a szerver neve/címe ahol az adatbázis fut PORT=0 # ->> itt állítsuk be portot ha az adatbázis szerver nem az eredeti portján fut DATABASE=/SmartStorage/data/storage.gdb #->> FireBird esetén vagy Adatbázis neve ha PostgreSQL-t használunk DRIVERNAME_DBX=Interbase PROTOCOL_ZeOS=firebird-1.0 # ->>> (vagy "firebird-1.5" vagy "postgresql-8.x") USERNAME=SYSDBA PASSWORD=masterkey ADMIN=1 [Defaults] TEMPPATH=/.smartstorage/temp" aposztrófok nélkül> SKIN=7 BARKODSTARTPOS=1 BARKODENDPOS=13 FONTNAME= FONTSIZE= SKIN=5 ********************************************************************** A program ezt a felhasználó könyvtárában keresi a ".smartstorage" alkönyvtárban. Ezt automatikusan létrehozza a program első indításakor! 6. A program indítása --------------------- Futtasuk a következő parancsot, vagy készítsük ikont az asztalon, vagy szimbólikus linket: "/SmartStorage/smartstorage.sh" amit létrehozhatunk így például: "ln -s /usr/share/SmartStorage/smartstorage.sh /usr/bin/smartstorage"