Manuál QPos – Servisní manuál V1.2
Manuál QPos – Servisní manuál
www.qpokladna.cz
OBSAH Obsah 1.
Úvod .......................................................................................................................................................................... 3
2.
Instalátor ................................................................................................................................................................... 4
3.
4.
5.
6.
2.1.
Stažení instalátoru ............................................................................................................................................ 4
2.2.
Instalační program ............................................................................................................................................ 4
2.3.
Aktualizace QPos ............................................................................................................................................... 4
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
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 5.1.
Obecně ............................................................................................................................................................ 15
5.2.
Kompletní reinstalace pokud je MySQL server funkční a lze zálohovat ......................................................... 15
Řešení problémů ..................................................................................................................................................... 16 6.1.
6.1.1.
Nedostatek volného místa na disku ........................................................................................................ 16
6.1.2.
mysqld: unknown option '--skip-bdb' ..................................................................................................... 16
6.1.3.
Počítač byl nekorektně vypnut výpadkem proudu a MySQL neběží....................................................... 16
6.2. 7.
Problémy s MySQL serverem .......................................................................................................................... 16
Nefunguje tiskárna .......................................................................................................................................... 17
Kontakty .................................................................................................................................................................. 18 Stránka 2 z 18
Manuál QPos – Servisní manuál
1.
www.qpokladna.cz
Úvod TENTO MANUÁL MÁ POUZE INFORMATIVNÍ CHARAKTER SPOLEČNOST QPOS, SIBER S.R.O. NENESE PRÁVNÍ ANI JINOU ODPOVĚDNOST ZA ŠPATNOU MANIPULACI S PROGRAMY QPOS.
Stránka 3 z 18
Manuál QPos – Servisní manuál
2.
Instalátor
2.1.
Stažení instalátoru
www.qpokladna.cz
Instalátor QPos pokladny lze nalézt na adrese: http://install.qpokladna.cz/pokladna_instalace/ Stahujte vždy instalátor s nejvyšší verzí.
2.2.
Instalační program
Instalátor provede v systému následující úpravy: • • • • • •
2.3.
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
Aktualizace QPos
Aktualizační programy naleznete na adrese: http://install.qpokladna.cz/beta/ Stahujte vždy instalátor s nejvyšší verzí.
Stránka 4 z 18
Manuál QPos – Servisní manuál
3.
Pokladna QPos
3.1.
Základní popis
www.qpokladna.cz
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.
[IP adresa] qpos <username>[db_username] <password>[db_password] <ssl>[0/1] 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, který se síťuje přes Hamachi.
3.3.
Seznam nejdůležitějších souborů QPos Název
admin.log client.log config.xml licence.key qpos.exe qpos_admin.exe qpos_qshop.exe qpos_ws.exe
ws_install.bat, ws_start.bat, ws_stop.bat, ws_uninstall.bat QtCore4.dll, QtGui4.dll, QtNetwork4.dll, QtScript4.dll, QtSql4.dll, QtWebKit4.dll, QtXml4.dll
Popis
Log pro administraci QPos Log pro pokladnu QPos Konfigurační soubor pokladny Soubor obsahující licenci po pokladnu Exe soubor pokladny Exe soubor administrace pokladny Exe soubor pro synchronizaci s Eshopem Exe soubor web service pokladny (ws pro PDA) Dávkové soubory pro ovládání webové služby qpos Dll soubory prostředí QT
Stránka 5 z 18
Manuál QPos – Servisní manuál
3.4.
www.qpokladna.cz
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: qpos2020 Pozor na NumLock, na dodávaných klávesnicích je standardně zapnut.
Stránka 6 z 18
Manuál QPos – Servisní manuál
4.
Základní servisní úkony
4.1.
Konfigurace tiskárny
www.qpokladna.cz
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>
\\[IP adresa]\[název tiskárny] \\[IP adresa]\[název tiskárny]
- tisk účtenek - tisk bonů
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: • • • •
4.3.
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)
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
Manuál QPos – Servisní manuál • • • • • • • • •
4.5.
www.qpokladna.cz
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
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
Manuál QPos – Servisní manuál
www.qpokladna.cz
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
Manuál QPos – Servisní manuál
www.qpokladna.cz
Stránka 10 z 18
Manuál QPos – Servisní manuál
www.qpokladna.cz
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
Manuál QPos – Servisní manuál
www.qpokladna.cz
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
Manuál QPos – Servisní manuál
www.qpokladna.cz
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
Manuál QPos – Servisní manuál
www.qpokladna.cz
•
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.
Stránka 14 z 18
Manuál QPos – Servisní manuál
www.qpokladna.cz
5.
Kompletní reinstalace pokladny
5.1.
Obecně
Klíčové pro instalaci jsou následující body: • • •
5.2.
Správně zálohovat databázi zákazníka. Zachovat soubor licence.key Zachovat soubor config.xml
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
Manuál QPos – Servisní manuál
6.
Řešení problémů
6.1.
Problémy s MySQL serverem
www.qpokladna.cz
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: 6.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
6.1.2. mysqld: unknown option '--skip-bdb' Okomentujte option skip-bdb v c:\Windows\my.ini 6.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 Stránka 16 z 18
Manuál QPos – Servisní manuál •
6.2. • •
www.qpokladna.cz
Hotovo
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
Manuál QPos – Servisní manuál
7.
www.qpokladna.cz
Kontakty
Obchodní oddělení Tel.: +(420) 774 693 217 Email. :
[email protected] Technická podpora Tel.: +(420) 607 673 887 Email.:
[email protected] Veškeré podměty a připomínky k manuálu pište na email :
[email protected] www.qpokladna.cz
Stránka 18 z 18
