V 2.0
OBSAH Obsah 1. Úvod... 3 2. Instalátor... 4 2.1. Stažení instalátoru... 4 2.2. Instalační program... 4 2.3. Aktualizace QPOS... 4 3. Pokladna QPOS... 5 3.1. Základní popis... 5 3.2. Připojení QPOS k databázi... 5 3.3. Seznam nejdůležitějších souborů QPOS... 5 3.4. Windows účet... 6 4. Základní servisní úkony... 7 4.1. Konfigurace tiskárny... 7 4.2. Výměna loga... 7 4.3. Záloha databáze... 7 4.4. Reinstalace OpenVPN... 7 4.5. Reinstalace Hamachi... 8 4.5.1. Odinstalace se zachováním profilu... 8 4.5.2. Instalace Hamachi... 9 4.5.3. Nastavení Hamachi... 11 4.5.4. Kompletní odinstalace Hamachi s vymazáním profilu... 13 Kompletní reinstalace pokladny... 15 4.6. Obecně... 15 4.7. Kompletní reinstalace pokud je MySQL server funkční a lze zálohovat... 15 5. Řešení problémů... 16 5.1. Problémy s MySQL serverem... 16 5.1.1. Nedostatek volného místa na disku... 16 5.1.2. mysqld: unknown option '--skip-bdb'... 16 5.1.3. Počítač byl nekorektně vypnut výpadkem proudu a MySQL neběží... 16 5.2. Nefunguje tiskárna... 17 6. Kontakty... 18 Stránka 2 z 18
1. Úvod TENTO MANUÁL MÁ POUZE INFORMATIVNÍ CHARAKTER SPOLEČNOST QPOS system s.r.o. NENESE PRÁVNÍ ANI JINOU ODPOVĚDNOST ZA ŠPATNOU MANIPULACI S PROGRAMY QPOS. Stránka 3 z 18
2. Instalátor 2.1. Stažení instalátoru Instalátor QPOS pokladny lze nalézt na adrese: v sekci ke stažení Stahujte vždy instalátor s nejvyšší verzí. 2.2. Instalační program Instalátor provede v systému následující úpravy: Zkopírování souborů QPOS Zkopírování souborů MySQL serveru Instalace služby MySQL Start služby MySQL Nastavení práv MySQL serveru Nahrání standardní databáze 2.3. Aktualizace QPOS Aktualizační programy naleznete na adrese: v sekci ke stažení Stahujte vždy instalátor s nejvyšší verzí. Stránka 4 z 18
3. Pokladna QPOS 3.1. Základní popis QPOS pokladna je Windows aplikace. Data jsou uložena na MySQL serveru, ke kterému se pokladna připojuje přes localhost (127.0.0.1) - typicky provozy s jednou pokladnou, nebo se k němu může připojit přes síť. 3.2. Připojení QPOS k databázi Kam se pokladna připojuje k MySQL serveru se nastavuje v souboru config.xml v adresáři QPOS. c:\qpos\config.xml <db> <hostname>[ip adresa]</hostname> <database>qpos</database> <username>[db_username]</username> <password>[db_password]</password> <ssl>[0/1]</ssl> </db> Pokud jde o provoz na více pokladnách, je určen PC, kde je nainstalován MySQL server a ostatní pokladny se k tomuto počítači připojují. Typicky po lokální síti nebo pomocí VPN či Hamachi. Poměrně častou konfigurací je jedna pokladna na provozovně a notebook v kanceláři pro administraci, do konfiguračního souboru se nastavuje IP adresa pokladny (kde běží MYSQL server). 3.3. Seznam nejdůležitějších souborů QPOS Název Popis admin.log Log pro administraci QPOS client.log Log pro pokladnu QPOS config.xml Konfigurační soubor pokladny licence.key Soubor obsahující licenci po pokladnu QPOS.exe Exe soubor pokladny QPOS_admin.exe Exe soubor administrace pokladny QPOS_qshop.exe Exe soubor pro synchronizaci s Eshopem QPOS_ws.exe Exe soubor web service pokladny (ws pro PDA) ws_install.bat, ws_start.bat, ws_stop.bat, Dávkové soubory pro ovládání webové služby QPOS ws_uninstall.bat QtCore4.dll, QtGui4.dll, QtNetwork4.dll, QtScript4.dll, QtSql4.dll, QtWebKit4.dll, QtXml4.dll Dll soubory prostředí. Stránka 5 z 18
3.4. Windows účet Na pokladnách QPOS jsou přeinstalovány 2 účty admin a pokladna. Účet admin je nezbytný pro jakékoliv servisní úkony. Heslo pro tento účet je: Administrátorské heslo, Vám bylo sděleno při nákupu pokladny, nebo lze zaslat dotaz na email: info@qpos.cz (je nutno doložit oprávnění majitele, nákupní doklad, IČO firmy), poté Vám bude heslo znovu zasláno. Pozor na NumLock, na dodávaných klávesnicích je standardně zapnut. Stránka 6 z 18
4. Základní servisní úkony 4.1. Konfigurace tiskárny Pro připojení tiskárny k pokladně QPOS je potřeba jí nejdříve nainstalovat, následně nasdílet a nakonec změnit cestu k tiskárně v souboru config.xml v adresáři QPOS. <print> <order>\\[ip adresa]\[název tiskárny]</order> <bon>\\[ip adresa]\[název tiskárny]</bon> - tisk účtenek - tisk bonů </print> Pokud máte s instalací problémy, lze tisk zkoušet pomocí příkazu echo, např.: echo mujtesttext > \\127.0.0.1\kasa Občas pomůže restartovat službu tisku. Pod příkazovým řádkem spusťte: net stop spooler net start spooler 4.2. Výměna loga Logo zobrazované v záhlaví účtenky je nahráno v souboru QPOS\logo\logo.png Pokud chcete změnit logo, stačí tento soubor přehrát novým. Požadavky na soubor: Formát png Rozlišení 400 x 56 px 32 / 16 / 8 bit barevná hloubka ideálně 1bit (tisk na termální tiskárně probíhá v 1bit barevné hloubce) Nesmí obsahovat alfa mapu (průhlednost) 4.3. Záloha databáze Pokud nejsou problémy s MySQL serverem je možné zálohu DB provézt následujícími možnostmi: Z administrace QPOS Karta nastavení Karta záloha Tlačítko Zálohovat Příkazem mysqldump QPOS > QPOS.sql Vždy se ujistěte, že byl opravdu vytvořen soubor zálohy! To, že byl příkaz proveden bez chybového hlášení, nemusí u nestabilního systému vždy znamenat úspěšné vytvoření souboru zálohy. Rovně soubor z provozu fungujícího leta nebude mít dva kilobajty. 4.4. Reinstalace OpenVPN Každá pokladna QPOS má nainstalovaný OpenVPN klient připojený k VPN síti QSoft. Tato síť se používá pro vzdálené servisní zásahy na pokladně QPOS. Stránka 7 z 18
Pro reinstalaci OpenVPN proveďte následující kroky: Přihlásit jako admin ve Windows. odinstalovat OpenVPN (přidat odebrat programy) Smazat c:/program files/openvpn/ Restartovat PC Nainstalovat: http://install.qpokladna.cz/driver/openvpn/openvpn-2.1.1-install.exe Zkopírovat obsah archivu: http://install.qpokladna.cz/driver/openvpn/config_qpos.zip do c:/program files/openvpn/ Ve správci počítače (Pravé tlačítko na Tento Počítač -> Spravovat), najít službu OpenVPN a nastavit spouštění služby: Automaticky Restart 4.5. Reinstalace Hamachi Hamachi je program, který slouží k propojení počítačů do jedné privátní sítě. V případě, že Hamachi instalace byla poškozena, proveďte odinstalaci a po restartu počítače instalaci Hamachi. Pokud instalujete Hamachi na čistou instalaci Windows, pokračujte kapitolou instalace. 4.5.1. Odinstalace se zachováním profilu Přihlaste se do Windows jako administrátor Odinstalujte Hamachi (V ovládacíh panelech Přidat nebo ubrat programy (Windows XP) nebo Odinstalovat program (Windows Vista, 7) ). Restartujte PC. Stránka 8 z 18
4.5.2. Instalace Hamachi Spusťte námi dodaný instalátor Hamachi a postupujte podle následujících obrázků: Stránka 9 z 18
Stránka 10 z 18
Až bude reinstalace dokončena, restartujte počítač. 4.5.3. Nastavení Hamachi Pokud jste vymazali Hamachi profil, či jste instalovali Hamachi poprvé tak při prvním spuštění Hamachi budete otázáni na jméno konta. Je to název počítače na kterém jste práve nainstalovali Hamachi. Název zvolte libovolný, ale tak aby přibližně popisoval o jaký počítač se jedná, např.: QPOS bar, QPOS kancelář, QPOS recepce. Spustí se vám okno s Hamachi. Tlačítko vlevo dole musí svítit zeleně. Pokud nesvítí, nejste připojeni - připojte se stisknutím tlačítka vlevo dole. Stránka 11 z 18
Klikněte na tlačítko zvýrazněné na obrázku. Dále v nabídce na Připojit k existující síti. Otevře se vám následující okno, do kterého zadáte název sítě a heslo. Klikněte na tlačítko připojit. Stránka 12 z 18
4.5.4. Kompletní odinstalace Hamachi s vymazáním profilu V některých případech, kdy nepomáhá jednoduchá reinstalace Hamachi je nutné po reinstalaci vymazat Hamachi profil. V tomto případě ztratíte veškerá nastavení Hamachi! V tomto případě proveďte odinstalaci následujícími kroky: Přihlaste se do Windows jako administrátor Odinstalujte Hamachi (V ovládacíh panelech Přidat nebo ubrat programy (Windows XP) nebo Odinstalovat program (Windows Vista, 7) ). Restartujte PC. Přihlaste se opět do Windows jako administrátor. Jděte do nabídky Start -> Spustit Stránka 13 z 18
Do otevřeného okna napište%appdata% a zmáčkněte Ok. V otevřeném okně vymažte složku Hamachi: Restartujte PC. Program Hamachi, lze zakoupit a stáhnout z adresy: https://secure.logmein.com/ https://secure.logmein.com/products/hamachi/ Program Hamachi, lze stáhnout zdarma, ale pro skutečný provoz doporučujeme zakoupit licenci, verze zdarma je pouze pro domací uživatele a na vyzkoušení, pro ostrý provoz je nutné mít zakoupenou licenci. Stránka 14 z 18
Kompletní reinstalace pokladny 4.6. Obecně Klíčové pro instalaci jsou následující body: Správně zálohovat databázi zákazníka. Zachovat soubor licence.key Zachovat soubor config.xml 4.7. Kompletní reinstalace pokud je MySQL server funkční a lze zálohovat Následující kroky popisují jak reinstalovat pokladní systém QPOS, pokud je MySQL server funkční a lze zálohovat. Pokud nelze vytvořit zálohu neprovádějte takto reinstalaci! 1 fáze- zálohování a odinstalace Přihlaste se do Windows jako admin. Zálohujte databázi (kapitola manuálu Základní servisní úkony - Záloha databáze) Zkopírujte si do jiného adresáře obsah adresář QPOS Ukončete všechny aplikace QPOS Odinstalujte QPOS Odinstalujte MySQL servery (mysql, apache2triad) Smažte adresáře c:\mysql a c:\apache2triad pokud existují Smažte c:\windows\my.ini pokud existuje Restartujte PC 2 fáze instalace a obnova dat a nastavení Přihlaste se do Windows jako admin. Nainstalujte instalátor QPOS. Nainstalujte poslední aktualizace. Zkopírujte ze staré instalace soubory: licence.key a config.xml a adresáře scripts, logo a templates Nahrajte databázi ze zálohy - Z administrace QPOS (heslo je 1 nebo 12345) Karta nastavení Karta záloha Tlačítko Obnova ze zálohy. Zkontrolujte funkčnost. Stránka 15 z 18
5. Řešení problémů 5.1. Problémy s MySQL serverem Pokud zjistíme, že nelze nastartovat službu MySQL, zkontrolujte logy MySQL služby, které se nacházejí v c:\mysql\logs Pokud neobjevíte problém, zkuste spustit MySQL server přímo a to příkazem: mysqld --console Pokud dojde k chybě při startu, budete o chybě informování v okně. Typické problémy MySQL: 5.1.1. Nedostatek volného místa na disku Pokud je nedostatek volného místa na disku, je špatně nastavené logování MySQL serveru. Oprava: Zastavte službu MySQL v Správě počítače (Pravé tlačítko na Tento Počítač -> Spravovat -> Služby a aplikace -> Služby) Nalezněte adresář, kde se nachází MySQL Server (c:\mysql, c:\apache2triad) Smažte soubor c:\mysql\logs\myaccess.log Zapněte službu MySQL. Hotovo 5.1.2. mysqld: unknown option '--skip-bdb' Okomentujte option skip-bdb v c:\windows\my.ini 5.1.3. Počítač byl nekorektně vypnut výpadkem proudu a MySQL neběží Na vině bude pravděpodobně špatně uložený log, či poškozený soubor s indexy MySQL. Oprava: Přihlaste se do Windows jako admin Zastavte službu MySQL v Správě počítače o Pravé tlačítko na Tento Počítač -> Spravovat -> Služby a aplikace -> Služby o Nalezněte službu MySQL o Pravým tlačítkem nad touto službou Zastavit Nalezněte adresář, ve kterém se nachází data MySQL Serveru (c:\mysql\data nebo c:\apache2triad\data) Z tohoto adresáře přesuňte na bezpečné místo následující soubory: - ib_logfile0 - ib_logfile1 - index.index - Všechny soubory začínající mysql-bin Zkuste spustit MySQL server nebo restartuje PC Pokud vše funguje, smažte přesunuté soubory - Hotovo Stránka 16 z 18
5.2. Nefunguje tiskárna Zkontrolovat kabeláž (zkusit jiný kabel). U připojení UTP kabelem může být na vině špatný konektor. Zkusit zapojit do jiného USB portu a reinstalovat ovladače a přenastavit sdílení. Stránka 17 z 18
6. Kontakty QPOS system s.r.o. IČO: 02441161 DIČ: CZ02441161 Datová schránka: tyc758p Sídlo: Plzeňská 1270/97, Košíře, 150 00 Praha 5 Spisová značka: C 219440 vedená u Městského soudu v Praze Email: info@qpos.cz Web: VŠEOBECNÉ OBCHODNÍ PODMÍNKY A REKLAMAČNÍ ŘÁD /vseobecne-podminky.html LICENČNÍ PODMÍNKY SOFTWARE QPOS /licencni-podminky.html Stránka 18 z 18