WHMCS modul telepítési utasítások

Főoldal
Tudásbázis
WHMCS modul telepítési utasítások

26.09.2024, 12:51

A WHMCS (Web Host Manager Complete Solution) egy automatizálási rendszer tárhelyszolgáltatók és internetszolgáltatók számára. Funkciókat kínál az ügyfélkezeléshez, számlázáshoz, támogatáshoz és a folyamatok automatizálásához. Itt találja az utasításokat a modul telepítéséhez.

1. LÉPÉS: A modul betöltése

Töltse fel a modult a szerverre parancssoron keresztül scp segítségével:

scp /path/to/local/module-whmcs-billmanager.zip
username@remote_server:/path/to/remote/directory

Példa, ha már a fájlt tartalmazó mappában van:

scp module-whmcs-billmanager.ziproot@77.92.122.212:/var/www/www-root/data/www/data-hub.online/

Ezután a rendszer kéri a szerver jelszavának megadására.

Miután feltöltötte a fájlt a szerverre, csatlakozzon a szerverhez SSH-n keresztül, és csomagolja ki a fájlt.

ssh user@remote_server

Meg kell adnia a szerver jelszavát.

Ezután lépjen a projekt mappájába, és oda, ahová a fájlt feltöltötte.

cd /var/www/path/to/destination/

Az archívumot a projekt gyökerébe kell kicsomagolni.

unzip module-whmcs-billmanager.zip

Ebben az archívumban a modul 3 verziója található, amely megfelel a php azon verziójának, amelyen a whmcs működik, a php verziójának kiderítéséhez menj a Segédprogramok/Rendszer/PHP info menüpontba.

Ezután újra ki kell csomagolnod az archívumot a whmcs által támogatott verzióhoz.

A php 7.1, php 7.2, php 7.4 esetén írja be a következő kódokat

unzip version7.1|7.2|7.4.zip

A php 8.1 esetében írja be

unzip version8.1

A php 8.2 esetében írja be

unzip version8.2

Ezután (feltétlenül) engedélyeket kell adnod a fájloknak. Ezt a projekt mappából a következő paranccsal teheted meg
chmod -R 755 modules/servers/PQH

A modul betöltődik.

Vagy a modul feltöltése a szerverre FileZilla segítségével

A számítógépen csomagolja ki a module-whmcs-billmanager.zip fájlt

Ezután újra ki kell csomagolnod a whmcs általad támogatott verziójának archívumát:

Для версии php 7.1, php 7.2, php 7.4 архив version7.1|7.2|7.4.zip
Для версии php 8.1 архив version8.1
Для версии php 8.2 архив version8.2

Ezután csatlakozzon a szerverhez a filezilla segítségével.

A php verziójának megfelelő archívumból helyezze át a fájlokat a webhely gyökérmappájába (mint az alábbi képernyőképen).

Ezután meg kell adni (kötelező) a mappához és a fájlokhoz a jogokat, hogy ezt megtehessük úgy, hogy a modules/servers mappába megyünk, és jobb gombbal kattintunk a PQH mappára, és a felugró ablakban kiválasztjuk a file attributes-t, a mezőbe írjuk a 755-ös numerikus értéket, és bejelöljük a recurse into subdirectories (mint az alábbi képernyőképen) jelölőnégyzetet.

A modul betöltődik.

2. LÉPÉS: IonCube ellenőrzése

Megosztott tárhelyünkön az IonCube támogatása és verziója a felhasználó számára kiválasztott PHP verziójától függ. Ez igaz a tárhelycsomagok bármelyik sorára, valamint a virtuális/dedikált szerverekre, amelyeken az ISPManager panel van telepítve.

Figyelem: ha ISPManager4 panel van telepítve a szerverén - már telepítve van az IonCube minden támogatott verzióhoz. Ezt az utasítást semmiképpen ne kövesse, mivel ez a szerver teljes működésképtelenségéhez vezethet. Amennyiben az IonCube verziójának frissítésére van szükség - forduljon az ügyfélszolgálathoz.

Az IonCube telepítésének előzetes követelményei

Ha a szerver nem rendelkezik vezérlőpanel nélkül, akkor előfordulhat, hogy az IonCube kézi telepítése szükséges.

A telepítési folyamat az Ön operációs rendszerétől függően eltérő lehet. Az operációs rendszertől függetlenül az első lépés mindig az SSH-n keresztül történő csatlakozás és a root hozzáférés megszerzése.

Az IonCube telepítéséhez egy aktív és működő webszerverrel, Apache vagy Nginx, valamint az IonCube Loader által támogatott PHP-verzióval rendelkező gépre van szükség.

Figyelem: Az IonCube Loader-nek van egy bizonyos sajátossága - gyakran nem támogatja a PHP "nullás" verzióit, például a PHP 8.0-t. A PHP 8.1 vagy a PHP 8.2 változatot azonban támogatja.

Az IonCube lépésről lépésre történő telepítése

Fontos: az IonCube Loader telepítéséhez használt parancsok értéke néhány változótól függően változik: a PHP verziója a szerveren, a PHP könyvtár helye és a szerver architektúra verziója. Itt és a jövőben kiemeljük ezeknek a változóknak az értékeit. Helyettük a telepítés során a szerverének megfelelő értékeket kell majd behelyettesítenie.

1 .Csatlakozzon a szerverhez SSH-n keresztül.

2. Ellenőrizze az aktuális szerver architektúráját:

uname -m
Exit
x86_64

Amint az x86_64-ből láthatjuk, a jelenlegi szerverünk 64 bites architektúrán fut. Az i686 formájú értékek ennek ellenkezőjét - 32 bites architektúrát - jeleznének.

Ezután menjünk a tmp könyvtárba, és töltsük le a szükséges archívumot:

64 bites rendszerek esetén:

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

32 bites rendszerek esetén:

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz

Az archívum letöltése után ki kell csomagolni:

Mivel a példánkban 64 bites architektúrával rendelkezünk, éppen egy ilyen archívumot töltöttünk le és csomagoltunk ki.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Menjünk az ioncube könyvtárba, és nézzük át a fájlok listáját.

cd ioncube/
ls -l

Következtetés

total 39260
-rw-rw-r-- 1 507 507  472192 Sep  9  2023 ioncube_loader_lin_4.1.so
-rw-rw-r-- 1 507 507  471968 Sep  9  2023 ioncube_loader_lin_4.2.so
-rw-rw-r-- 1 507 507  472768 Sep  9  2023 ioncube_loader_lin_4.3.so
-rw-rw-r-- 1 507 507  490752 Sep  9  2023 ioncube_loader_lin_4.3_ts.so
-rw-rw-r-- 1 507 507  475840 Sep  9  2023 ioncube_loader_lin_4.4.so
-rw-rw-r-- 1 507 507  494880 Sep  9  2023 ioncube_loader_lin_4.4_ts.so
-rw-rw-r-- 1 507 507  483360 Sep  9  2023 ioncube_loader_lin_5.0.so
-rw-rw-r-- 1 507 507  497632 Sep  9  2023 ioncube_loader_lin_5.0_ts.so
-rw-rw-r-- 1 507 507 1116768 Sep  9  2023 ioncube_loader_lin_5.1.so
-rw-rw-r-- 1 507 507 1155744 Sep  9  2023 ioncube_loader_lin_5.1_ts.so
-rw-rw-r-- 1 507 507 1139936 Sep  9  2023 ioncube_loader_lin_5.2.so
-rw-rw-r-- 1 507 507 1176704 Sep  9  2023 ioncube_loader_lin_5.2_ts.so
-rw-rw-r-- 1 507 507 1222328 Sep  9  2023 ioncube_loader_lin_5.3.so
-rw-rw-r-- 1 507 507 1275512 Sep  9  2023 ioncube_loader_lin_5.3_ts.so
-rw-rw-r-- 1 507 507 1512960 Sep  9  2023 ioncube_loader_lin_5.4.so
-rw-rw-r-- 1 507 507 1599584 Sep  9  2023 ioncube_loader_lin_5.4_ts.so
-rw-rw-r-- 1 507 507 1520056 Sep  9  2023 ioncube_loader_lin_5.5.so
-rw-rw-r-- 1 507 507 1602040 Sep  9  2023 ioncube_loader_lin_5.5_ts.so
-rw-rw-r-- 1 507 507 1485192 Sep  9  2023 ioncube_loader_lin_5.6.so
-rw-rw-r-- 1 507 507 1549640 Sep  9  2023 ioncube_loader_lin_5.6_ts.so
-rw-rw-r-- 1 507 507 1254608 Sep  9  2023 ioncube_loader_lin_7.0.so
-rw-rw-r-- 1 507 507 1316080 Sep  9  2023 ioncube_loader_lin_7.0_ts.so
-rw-rw-r-- 1 507 507 1355080 Sep  9  2023 ioncube_loader_lin_7.1.so
-rw-rw-r-- 1 507 507 1438760 Sep  9  2023 ioncube_loader_lin_7.1_ts.so
-rw-rw-r-- 1 507 507 1407568 Sep  9  2023 ioncube_loader_lin_7.2.so
-rw-rw-r-- 1 507 507 1489008 Sep  9  2023 ioncube_loader_lin_7.2_ts.so
-rw-rw-r-- 1 507 507 1316800 Sep  9  2023 ioncube_loader_lin_7.3.so
-rw-rw-r-- 1 507 507 1386880 Sep  9  2023 ioncube_loader_lin_7.3_ts.so
-rw-rw-r-- 1 507 507 1363392 Sep  9  2023 ioncube_loader_lin_7.4.so
-rw-rw-r-- 1 507 507 1430848 Sep  9  2023 ioncube_loader_lin_7.4_ts.so
-rw-rw-r-- 1 507 507 1401736 Sep  9  2023 ioncube_loader_lin_8.1.so
-rw-rw-r-- 1 507 507 1506216 Sep  9  2023 ioncube_loader_lin_8.1_ts.so
-rw-rw-r-- 1 507 507 1439016 Sep  9  2023 ioncube_loader_lin_8.2.so
-rw-rw-r-- 1 507 507 1546568 Sep  9  2023 ioncube_loader_lin_8.2_ts.so
-rw-r--r-- 1 507 507   10768 Aug  5  2022 LICENSE.txt
-rw-r--r-- 1 507 507  181104 Aug 15  2022 loader-wizard.php
-rw-r--r-- 1 507 507    4070 Sep  9  2023 README.txt
-rw-r--r-- 1 507 507   39548 Sep  9  2023 USER-GUIDE.pdf
-rw-r--r-- 1 507 507   11269 Sep  9  2023 USER-GUIDE.txt

Amint láthatod, az archívum a modul számos különböző verzióját tartalmazza a különböző PHP-verziókhoz. Meg kell találnunk, hogy ezek közül a fájlok közül melyikre van szükségünk a további telepítéshez.

6. A PHP verziójának ismeretében (az első lépésből) a következő lépés annak a könyvtárnak a helyének meghatározása, ahová az IonCube Loader-t telepíteni kell.

php -i | grep extension_dir

Kimenet

extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902

A /usr/lib/php/20210902 helyre a telepítés további folyamatában lesz szükség. A Centos operációs rendszerben ez a mappa úgy nézhet ki, mint /usr/lib64/php/modules.

7. Másolja az IonCube fájlokat a szükséges könyvtárba.

sudo cp /tmp/ioncube/ioncube_loader_lin_8.1.so /usr/lib/php/20210902

8. Most a php.ini konfigurációs fájlokat kell módosítani. Ezek különböző szerverkonfigurációkban eltérő helyen lehetnek:

sudo nano /etc/php/8.1/cli/php.ini          #для PHP CLI 
sudo nano /etc/php/8.1/fpm/php.ini          #для PHP-FPM & Nginx
sudo nano /etc/php/8.1/apache2/php.ini      #для Apache2

A php.ini állomány legelejére illesszünk be egy sort a következő módon:

zend_extension = /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

9. Végezze el a webszerver újraindítását:

Apache Ubuntu/Debian
sudo systemctl restart apache2
Apache Centos/Rocky/Alma
sudo systemctl restart httpd
Nginx/PHP-FPM
sudo systemctl restart nginx
sudo systemctl restart php-fpm

10. Ellenőrizze a telepítés helyességét a következő paranccsal:

php -v

Ha a telepítés sikeres volt, akkor az IonCube aktuális verziójára vonatkozó információkat tartalmazó sor a következőképpen jelenik meg:

Kimenet

PHP 8.1.2-1ubuntu2.17 (cli) (built: May  1 2024 10:10:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2023, by ionCube Ltd.
    with Zend OPcache v8.1.2-1ubuntu2.17, Copyright (c), by Zend Technologies

3. LÉPÉS: Kiszolgáló hozzáadása

Lépjen az adminisztrációs panelre.

System Settings/Servers

Kattintson az Új szerver hozzáadása gombra.

Töltse ki az űrlapot az alábbi képernyőképen látható módon.

A Modul mezőben keresse meg: PQH

A Hostnév vagy IP cím mezőbe írja be: client.the.hosting

Ezután adja meg a fiók adatait (bejelentkezés, jelszó) a client.the.hosting oldalról.

És kattintson a folytatás gombra.

Ezután a következő oldalon meg kell adnia a szerver nevét (az Ön választása szerint), majd kattintson a Változások mentése gombra.

LÉPÉS 4. Modul adminisztrátor

Egy új adminisztrátort kell létrehoznunk.

Ezt a beállítások/adminisztrátorok kezelése menüpontban teheti meg.

Ezután kattintson az Új adminisztrátor hozzáadása gombra

Szerepkör: Teljes körű rendszergazda

Felhasználónév (kötelező!): apisystem

A többi adat már csak rajtad múlik

Példa (alábbi képernyőkép)

5. LÉPÉS. További mezők

Az olyan mezők, mint például az operációs rendszer kiválasztása vásárláskor, a beállítások/rendszerbeállítások/konfigurálható lehetőségek menüpontban konfigurálhatók.

Kattintson az Új csoport létrehozása gombra, majd állítsa be a csoport nevét tetszése szerint.

és kattintson a Változások mentése gombra, majd kattintson az Új konfigurálható opció hozzáadása gombra.

Ezután a felugró ablakban írja be az Opció neve mezőbe: "VM sablon".

Ezután adja meg az értéket az Add Options mezőben.

Itt található az összes támogatott érték listája:

VM6_ISPsystem_Alma-Linux-8
VM6_ISPsystem_Alma-Linux-9
VM6_ISPsystem_Astra-Linux-CE
VM6_ISPsystem_CentOS-8-Stream
VM6_ISPsystem_CentOS-9-Stream
VM6_ISPsystem_Debian-10
VM6_ISPsystem_Debian-11
VM6_ISPsystem_Debian-12
VM6_ISPsystem_FreeBSD-12
VM6_ISPsystem_FreeBSD-13
VM6_ISPsystem_Oracle-Linux-8
VM6_ISPsystem_Rocky-Linux-8
VM6_ISPsystem_Ubuntu-18.04
VM6_ISPsystem_Ubuntu-20.04
VM6_ISPsystem_Ubuntu-22.04
VM6_ISPsystem_VzLinux-8

Kattintson a Módosítások mentése gombra mind ezen a lapon, mind a Konfigurálható opciós csoportok lapon.

6. LÉPÉS. Termékek hozzáadása

Válassza a Beállítások/Rendszerbeállítások/ Termékek,szolgáltatások menüpontot.

Hozzon létre egy új csoportot az Új csoport létrehozása gombra kattintva.

Ezután töltse ki a mezőket a kívánt módon

Mentse, és menjen ismét a Beállítások/Rendszerbeállítások/ Termékek,Szolgáltatások menüpontba.

Kattintson az Új termék létrehozása gombra
Ezután (mindenképpen) válassza ki
Termék típusa: Szerver/VPS
Modul: PQH

Töltse ki a többit a saját belátása szerint

A mentés után testreszabhatja a terméket

A Részletek lapon (alábbi képernyőkép) testre szabhatja a terméket, ahogyan szeretné (Termék neve,Termék szlogenje, Termék rövid leírása, Termék leírása).

A Require Domain értéknél lévő jelölőnégyzetet nem kell bejelölni.

Ne felejtse el elmenteni a termékbeállításokat

Az Árképzés fülön (lenti képernyőkép) beállíthatja a termék fizetését. Ne felejtse el elmenteni a termékbeállításokat

A Modulbeállítások lapon (alábbi képernyőkép)

Válassza ki (kötelező) Modul neve: PQH

Ezután válassza ki a termékhez tartozó adatközpontot és tarifát.

Ne felejtse el elmenteni a termékbeállításokat

Az Egyéni mezők lapon (lenti képernyőkép) a Mező neve mezőbe be kell illesztenie a "VMid" értéket.

A többi lapot a saját belátása szerint szabja testre.

Továbbá, a termékek hozzáadásának egyszerűsítése érdekében duplikálhatjuk a termékeket (alábbi képernyőkép).

7. LÉPÉS. A tesztelése

Hozzon létre egy felhasználót, töltse fel a számláját, és próbáljon meg szolgáltatást rendelni a tesztfiókból. A felhasználó általi megrendeléskor a modul minden paramétert átad a BILLmanager-nek, automatikusan megrendeli a szervert, és amikor a szerver aktiválódik a BILLmanager oldalán, a szolgáltatás is aktiválódik a WHMCS oldalán.