sERPa súgó

 

A sERPaMobil telepítő egy lépésben telepíti a használatához szükséges sERPaMobil programot és Apache sERPa szolgáltatást.

A sERPa 4.0.152-es verziójától 64 bites Apache 2.4-es és PHP 8.3.9-es verziókat telepítünk a csomagban.

 

Lehetőség van IIS-hez telepíteni a sERPaMobilt, ehhez külön kiadást készítünk belőle: Telepítés IIS-hez.

Fontos tanácsok

•A sERPaMobil ezen változata egy Apache webszervert és a hozzá tartozó Windows szolgáltatást is telepíti a szerver operációs rendszerre. A webszerver (mint internetes szolgáltatás) üzemeltetésének biztonsági beállításai a szerver üzemeltető rendszergazda hatáskörébe és felelősségi körébe tartoznak. A telepítőbe megadható, hogy mely porton keresztül lesz elérhető az Apache webszerver, ezt körültekintően és a hálózati szabályokat, tűzfal beállításokat figyelembe véve határozzuk meg.

•A sERPaMobil olyan szolgáltatásokat tartalmaz, amelyet a vállalat saját felhasználói használnak. Ezért azt belső hálózaton vagy VPN elérésen keresztül javasolt használni, hiszen érzékeny vállalati információk is elérhetőek rajta keresztül.

•A telepítés után mindenképp javasoljuk SSL tanúsítvány telepítését a HTTPS eléréshez. Ez a szervert üzemeltető rendszergazda feladata, a telepítő nem végzi el automatikusan a szükséges lépéseket. Néhány tanácsot adunk hozzá a súgó oldal végén, ha OpenSSL tanúsítványt szeretnének beállítani.

Szükséges előfeltételek

Rendszerkövetelmények

 

Mielőtt elkezdjük a sERPaMobil telepítését, ugyanarra a gépre az alábbiakat külön kell telepíteni, hogy a sERPaMobil minden szolgáltatását használni tudjuk:

•Működő sERPa kliens. Azonos verziójú, mint a többi munkaállomáson. Ez szükséges ahhoz, hogy nyomtatást indíthassunk a sERPaMobilról.

•Java telepítése (a PDF fájlok előállításához).

•FOP telepítése (a PDF fájlok előállításához).

 

A FOP-ot a szerverre telepített sERPa kliensből is telepíthetjük: a Rendszerbeállításokban a Nyomtatás/ ÁNYK export fülön kattinsunk a FOP letöltése, telepítése gombra:

Ezután a FOP teszt gombbal ellenőrizzük, hogy a kliens eléri a FOP kiegészítést.

A sERPa kliens és a FOP elérési útját majd meg kell adjuk a telepítés során, hogy az Apache sERPa szolgáltatás használni tudja azokat.

SQL login létrehozása

Erre azért van szükség, mert a sERPaMobil ezen a felhasználói fiókon keresztül fog hozzáférni az SQL-hez.

Az Object Explorer - Microsoft SQL Server Management Studio programban a megfelelő SQL szerverre kapcsolódva a Security mappában található Logins könyvtáron jobb egérgombot nyomva indítsuk el a New Login... menüpontot. Itt adjuk meg a Login nevét és az alábbiakat állítsuk be:

 

A Server Roles lapon a public van bepipálva:

 

A szükséges adatbázist pipáljuk be és adjuk meg rá a sERPaMobilRole jogot:

Telepítés

A telepítő felteszi a szerver gépre a működéshez szükséges:

•Apache webszervert (ApachesERPa szolgáltatásként fog futni),

•a PHP-t (ami weboldalakat állít össze),

•és a MS SQL szerverhez a kapcsolódást biztosító komponenst (Csak Windows operációs rendszerű gépre van).

Részletes leírás lépésenként: sERPaMobil telepítés

Telepítés után

A sikeres telepítés után a modul működőképes, a telepítéskor megadott portszámon a webszerver elérhető és a sERPaMobil nyitólap megjelenik.

Ha szükségünk van néhány további paraméterezésre, azt az alábbiak szerint tehetjük meg:

- Tűzfal beállítás

- Indítás

- Vonalkódolvasó felprogramozás

- Egyéb beállítási lehetőségek, pl. adatbázis megadása (config.php)

- Egyéb beállítási lehetőségek, pl. feltölthető képméret módosítása (php.ini)

- Frissítés

 

Részletes leírások

sERPaMobil telepítés

A telepítéshez rendszergazdai jogosultságú felhasználói fiók szükséges, hiszen a telepítő egy Windows szolgáltatást is feltelepít a webszerver futtatásához.

A sERPaMobil-setup-4.0.xxx.exe elindításakor megjelenik a telepítő varázsló:

 

 

 

A kapcsolat paraméterezési ablakában:

Adjuk meg a Portot, amely nincs még használatban a szerveren.

Írjuk be az SQL kiszolgálót, amely SQL szerveren van az adatbázisunk.

Adjuk meg azt a sERPa adatbázist, amelyben dolgozni szeretnénk.

Azt a felhasználót és jelszót kell megadni, akit felvettünk az SQL-ben.

A feltelepített FOP könyvtárát kell megadni.

A feltelepített sERPa kliens mappáját kell megadni.

 

A sikeres telepítésről a megjelenő ablakban tájékozódhatunk, majd befejezzük a telepítést:

 

A feltelepülő szolgáltatás:

(Ctrl+Alt+Del, majd Feladatkezelő indítása)

 

 

 

Tűzfal beállítás

Indítás

•http://gepnev:5555

Így indítva kitalálja a sERPaMobil, hogy milyen eszközről lett indítva (ha érintőképernyős, akkor /m-mel a mobil webes funkciók indulnak el)

ahol

- „gepnev" az a számítógép, ahova telepítve lett a szolgáltatás (helyi gépről tesztelve: "localhost")

-„5555” a port, amit a telepítéskor megadtunk

 

•http://gepnev:5555/m

Mobil webes funkciók indítása.

 

 

Vonalkódolvasó felprogramozás

Ha a vonalkód olvasás nem működik, akkor a vonalkód olvasót fel kell programozni:

Kezdete jel (prefix): [

Vége jel (suffix): ]

Azért ezeket a karaktereket kell beállítani, mert a szokásos F8/ENTER páros pl android operációs rendszeren nincs.

 

Felprogramozási példa Zebra TC21  táblagépen:

Bekapcsolás után a funkció indítóikonokat tartalmazó képernyőre kell lépni és el kell indítani a DataWedge programot. A DataWedge Profiles képernyőn ki kell választani a használt profile-t: Profile0 (default). A megjelenő Profile: Profile0 (default) képernyőn be kell pipálni a Profile enabled pipát, azaz engedélyezni kell ezt a profilt, valamint lentebb görgetve a Keystroke output szekcióban ki kell választani a Basic data formatting menüpontot. Itt a Prefix to data mezőbe be kell írni a [ karaktert, majd a Suffix to data mezőbe pedig a ] karaktert. Itt az Enable pipa szintén legyen bepipálva.

 

 

Egyéb beállítási lehetőségek (config.php)

A telepítésekor létrejövő config.php fájlban lehet módosítani a telepítés után esetleg megváltozó tulajdonságokat a mozgó értékesítés vonatkozásában. Illetve itt lehet egyéb beállításokat is megadni.

C:\Program Files (x86)\ProgEn\sERPaMobil\htdocs\m\config.php

 

Egyéb beállítási lehetőség a hálózati nyomtatók definiálása, amelyekre történhet például a címkenyomtatás. (Nyomtatás indításakor történő nyomtatóválasztási lehetősséggel.)

 

A config.php fájl a következő adatokat tartalmazza:

 

<?php 

$conf['debug'] = "0";

 

$conf['db_hostname'] = "db.progen.local";

$conf['db_username'] = "PDATeszt";

$conf['db_password'] = "XXXXXXXX";

$conf['db_name'] = "serpa";

 

$conf['tmp'] = "D:\\sERPa_Szerver\\Temp";

$conf['fop_path'] = "D:\\sERPa_Szerver\\FOP\\fop-2.2\\fop";

$conf['label_printer'] = array("Teszt" => "c:/cimke.zpl", "Raktár" => "//192.168.1.51/lp1", "Iroda" => "//192.168.1.54/lp1");

 

$conf['serpa_path'] = "D:\\sERPa_Szerver\\sERPa";  --> (Az új serpa.exe könyvtárát kell megadni, figyelve a dupla perjelekre.)

?>

 

Egyéb beállítási lehetőségek (php.ini)

Néhány funkció képeket is feltölt. Ha ezek mérete a 40 MB-ot meghaladja, akkor további beállítások szükségesek, amelyeket a php.ini-ben tehetünk meg.

A php.ini-t megtaláljuk a telepítés helye szerinti sERPaMobil mappán belül a php mappában, pl.: C:\Program Files (x86)\ProgEn\sERPaMobil\php

 

; Maximum allowed size for uploaded files.

upload_max_filesize = 40M

 

; Must be greater than or equal to upload_max_filesize

post_max_size = 40M

Ha módosítjuk a php.ini-t, akkor a módosítások érvénybe lépéséhez újra kell indítani az Apache sERPa Windows szolgáltatást.

Dátumválasztás

IE10 és előző verziókban nincs rá támogatás, viszont már EDGE-ben igen.

Firefox 54 verziótól be lehet kapcsolni: Az about:config -ben kell true-ra állítani dom.forms.datetime -t.

 

Hibakezelés

Visual C++ kiegészítés hiánya

Ha a telepítést követően az Apache (ApachesERPa windows szolgáltatás) nem indul el, akkor telepíteni kell ezt a kiegészítést is: Visual C++ Redistributable for Visual Studio 2015-2022

•The Visual C++ Redistributable for Visual Studio 2015-2022 (.a link direkt letöltő link, VC_redist.x64.exe fájlt tölti le)

 

 

sERPaMobil Apache verzió HTTPS-re állítása

Feltelepíteni az OpenSSL-t, majd generálni egy tanúsítványt

 

openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout privateKey.key -out certificate.crt

 

https://helpcenter.gsx.com/hc/en-us/articles/115015960428-How-to-Generate-a-Self-Signed-Certificate-and-Private-Key-using-OpenSSL

 

A sERPaMobil mappájában módosítani kell a httpd.conf fájlt

-Kivenni a kommentet a LoadModule ssl_module modules/mod_ssl.so sor elől, hogy az SSL modul betöltődjön.

-Átállítani a portot 443-ra:

Listen 443

 

-Ezt a blokkot hozzáadni (a pontos tanúsítvány elérésekkel):

 

<VirtualHost *:443>

    ServerName www.example.com

    SSLEngine on

    SSLCertificateFile "/path/to/www.example.com.cert"

    SSLCertificateKeyFile "/path/to/www.example.com.key"

</VirtualHost>

 

https://httpd.apache.org/docs/2.4/ssl/ssl_howto.html

 

Ezután újraindítani az Apache sERPa Windows szolgáltatást:

 

 

Frissítés

A meglévő sERPa webszolgáltatás verzió frissítésekor szintén el kell indítani a telepítőt (sERPaMobil-setup.exe), amely kiolvassa az előző telepítés adatait, ahol azok meg is változtathatóak. A frissítő maga előtt leállítja az ApachesERPa szolgáltatást és elvégzi az új sERPaMobil verzió telepítését. Esetenként előfordulhat, hogy nem tudja leállítani a szolgáltatást és emiatt frissítéskor egyes fájlokat kihagyna a frissítésből. Ilyen esetben a feladatkezelőben manuálisan kell leállítani az ApachesERPa szolgáltatást és utána kell frissíteni. Az ilyenkor tipikusan előforduló hibaüzenet a következő:

 

---------------------------

sERPaMobil Telepítő

---------------------------

Hiba történt a fájl írásra történő megnyitásakor:

 

 "C:\Program Files (x86)\ProgEn\sERPaMobil\bin\httpd.exe"

A Mégse gomb megnyomásával megszakíthatja a telepítést,

az Ismét gombbal megismételheti a fájl írását,

a Kihagyás gombbal kihagyhatja ezt a fájlt.

---------------------------

Leállítás   Ismét   Kihagyás  

---------------------------