Manuál QPos – Servisní manuál - Index of

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.
<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, 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>
<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:
•
•
•
•
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