Smart Storage telepítési útmutató ********************************* 1. telepítés: a letöltött fájl futtatása ---------------------------------------- Futtassuk a SmartStorageYYY_XXX_Setup.exe programot. Válasszunk helyet a programnak és az a minta adatbázisoknak is, ha nincs külön célunk a helyekkel hagyjunk mident alapértelmezésben! A telepítő elhelyez a telepítési könyvtár "Database" alkönyvtárában (alpértelmezés szeint c:\program files\pergersoft\smartstorage\database) előre elkészített adatbázis mentéseket: - FireBird adatbázist (SMARTSTORAGEXX.GDB) - smartstorage*.backup DUMP-okat a PostreSQL adatbázisokhoz és - SmartStorage*Backup.sql mentést A telepítés után szükség lehet, hogy az "Adatbázis kezelő" (DatabaseHandle.exe) programon kívül adatbázis szerver specifikus programokkal is dolgozzunk: - Firebird esetén isql.exe, IBCOnsole - PostgreSQL esetén a PostgreSQL csomag pgAdmin III nevü programjával - MSSQL esetén az Enterprise Manager - MySQL esetén MySQL Administrator, esetleg phpMyAdmin Első indításkor a felhasználó könyvtárában nem létezik a "smartstorage" alkönyvtárban a "storage.ini" fájl. Ezeket a programok létrehozzák. Mivel még a rendszer nem tudja hogy Firebird, PostgreSQL, MySQL vagy MSSQL adatbázist fogunk használni a legenerált configurációs fájl nem lenne teljesen korrekt, így az adatbázisra és azonosításra a program első indításkor rákérdez! A telepítés után a hibával történő leállást elkerülhetjük ha először az Adatbázis kezelő (DatabaseHandler) programot indítjuk. Ha még semmi sem létezik (sem konfigurációs fájl, sem adatbázis), akkor is adjunk meg kapcsolódási információkat (vagy létezőt vagy a tervezetett infomációkat). Többféle módon hozhatjuk lérte a program számára szükséges adatbázis kapcsolatot és szerkezetet: 1. 1. ) FireBird - gyors kapcsolat az előre telepített adatbázis fájlhoz ******* FireBird esetén csak egy adatbázis fájlt (c:\program files\pergersoft\smartstorage\database\SMARTSTORAGE13.GDB) kell kiválasztani az adatbázis kapcsolatok megadásánál, és már használhatjuk is a programot. Bár ezt érdemesebb egy másik saját jól elkülőnített könyvtárba másolni és ahhoz kapcsolódni, így az esetleges frissítés, újratelepítés esetén nem veszítjük el adatbázisunkat. 1. 2. ) Új üres adatbázis létrehozása az Adatbázis kezelővel (FireBird / PostgreSQL ) ******* FireBird, PosgreSQL esetén is létrehozhatunk új üres adatbázist az Adatbázis kezelővel az "Adatbázis struktúra létrehozása" menüvel. Itt fontos hogy a FireBird kliens program "isql" vagy a PATH-ban legyen vagy egészítsük ki a parancsot, amikor a program rákérdez. Hasonlót kell tennünk PostgreSQL esetén is, ahol a kliens program, ami az üres adatbázist létrehozza a "createdb". Ha más eszközzel (pl.parancssorból) létrehozunk üres adatbázist akkor a kérdésre "Létrehuzzunk új adatbázist?" válaszolhatunk NEM-mel. Ilyenkor ennek az adatbázisnak a kapcsolódási információit kell megadnunk az Adatbázis kapcsoltatok párbeszédablakban. A struktúra sikeres létrehozása után a program rákérdez, hogy mentse-e az új kapcsolódási információkat a "storage.ini" fájlba. 1.3. ) DUMP importálása PostgrSQL esetén ****** PostgreSQL esetén a 3. pontnak megfelelően létrehozhatunk új üres adatbázist (ha DUMP-ot akarunk használni a kódolás legyen iso-8859-2 vagy latin2) és a Helyreállítás / Restore parancsal inportáljuk a DUMP fájlt! 1.4. ) SQL backup fájl importálása MySQL 5 esetén ****** Alapértelmezésben a "c:\program files\pergersoft\smartstorage\database" könyvtárban található SQL backup fájlt állítsuk vissza az "SQL Adaministrator", vagy a WEB-es felületű phpMyAdmin segítségével a kívánt adatbázisba. Annek kódolása UTF8 legyen. 2. Ha nincs a rendszeren telepített FireBird/Interbase (Server/Client) ---------------------------------------------------------------------- Az 1.0.x vagy 1.5.x verziót telepíteni kell. A http://suzukiperger.axelero.net oldalon találhatunk linket a Firebird adatbáziskezelő letöltéséhez: "FirebirdCS-.exe". Telepítsük ezt szerver funkciókkal. 2.1. FireBird/InterBase SYSDBA jelszó ----------------------------------- Ha elállítottuk az alpértelmezéseket, akor ezt a két sort kell módosítani a storage.ini fájlban PROTOCOL_ZeOS=firebird-1.0 / 1.5 / 2.0 USERNAME=SYSDBA PASSWORD=masterkey ha az már létezett. 3. PostgreSQL ------------- Telepítsük a rendszeren a PostgreSQL 8.0.x/ 8.1.x verziójú adatbáziskezelo programcsomagot. "PgAdmin III" programmal hozhatjuk létre a használni kívánt adatbázist!!! De ezt megtehetjük a Adatbázis Kezelő programmal is! A használni kívánt adatbázis létrehozásakor adjuk meg a kódolást is, legyen Latin2 vagy iso8859-2 (1.3-as sorozattól kezdve lehet UNICODE is, de iylenkor a DUMP fájlok nem használhatóak)! Módosítsuk a storage.ini fájlt: PROTOCOL_ZeOS=postgresql USERNAME= PASSWORD= Ha a programmal hozzuk létre a adatbázist és nem akarjuk a felugró parancs-ablakban megismételni a használt felhasználó jelszavát egészítsük ki a "pg_hba.conf" fájlt a következő sorral: host all postgres 127.0.0.1/32 trust Csak a művelet idejére később nincs rá szükség! SAJNOS nincs mód megadni a parancssorba bemenő paraméterként a jelszót! 4. 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" vagy "postgresql-7" vagy "postgresql-8") USERNAME=SYSDBA PASSWORD=masterkey ADMIN=1 # 0 ha az adott felhasználó nem szekesztheti a Beállításokban a felhasználók listáját . . . . ********************************************************************** A program ezt a felhasználó könyvtárában keresi a "smartstorage" alkönyvtárban. Ezt automatikusan létrehozza a program elso indításakor! 5. A program indítása --------------------- A Start menüben a "Programok/Smart Storage" allat találhatjuk a "Smart Storage" indító-ikont...