WHMCS modulio diegimo instrukcijos

Namai
Žinių bazė
WHMCS modulio diegimo instrukcijos

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) - tai automatizavimo sistema, skirta prieglobos bendrovėms ir interneto paslaugų teikėjams. Ji siūlo klientų valdymo, sąskaitų išrašymo, palaikymo ir procesų automatizavimo funkcijas. Čia pateikiamos instrukcijos, kaip įdiegti šį modulį.

1 ŽINGSNIS: modulio įkėlimas

Įkelkite modulį į serverį per komandinę eilutę naudodami scp:

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

Pavyzdys, jei jau esate aplanke, kuriame yra failas:

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

Tada būsite paprašyti įvesti serverio slaptažodį.

Įkėlę failą į serverį, prisijunkite prie serverio per SSH ir išpakuokite failą

ssh user@remote_server

Jums reikės įvesti serverio slaptažodį.

Tada eikite į projekto aplanką, į kurį įkėlėte failą.

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

Archyvas turėtų būti išpakuotas į projekto šakninę šaknį

unzip module-whmcs-billmanager.zip

Šiame archyve yra 3 modulio versijos, atitinkančios php versiją, su kuria veikia whmcs, norėdami sužinoti savo php versiją, eikite į Įrankiai/Sistema/PHP informacija.

Tada reikia dar kartą išpakuoti archyvą, kad rastumėte versiją, kurią palaiko jūsų whmcs.

Jei tai php 7.1, php 7.2, php 7.4, įveskite

unzip version7.1|7.2|7.4.zip

php 8.1 įveskite

unzip version8.1

php 8.2 įveskite

unzip version8.2

Tada turite (būtinai) suteikti teises į failus. Tai galite padaryti iš projekto aplanko įvesdami komandą
chmod -R 755 modules/servers/PQH

Modulis įkeliamas.

Arba Įkelkite modulį į serverį per FileZilla

Kompiuteryje išpakuokite failą module-whmcs-billmanager.zip

Tada reikia dar kartą išpakuoti jūsų palaikomos whmcs versijos archyvą:

Для версии 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

Tada prisijunkite prie serverio naudodami Filezilla.

Iš archyvo, atitinkančio jūsų php versiją, perkelkite failus į šakninį svetainės aplanką (kaip toliau pateiktame paveikslėlyje).

Tada būtina (privaloma) suteikti teises į aplanką ir failus tai padaryti nuėjus į aplanką modules/servers ir dešiniuoju pelės klavišu spustelėjus aplanką PQH, iššokusiame lange pasirinkti file attributes (failų atributai), į lauką įrašyti skaitinę reikšmę 755 ir pažymėti žymimąjį langelį recurse into subdirectories (kaip toliau pateiktame ekrano paveikslėlyje).

Modulis įkeliamas.

2 ŽINGSNIS. 2. Patikrinkite "IonCube

Mūsų bendro naudojimo prieglobos sistemoje "IonCube" palaikymas ir jo versija priklauso nuo naudotojui pasirinktos PHP versijos. Tai galioja bet kurios eilės prieglobos planams, taip pat virtualiems / dedikuotiems serveriams su įdiegtu "ISPManager" skydeliu.

Dėmesio: jei jūsų serveryje įdiegtas "ISPManager4" skydelis - "IonCube" jau yra įdiegta visose palaikomose versijose. Jokiu būdu nesivadovaukite šia instrukcija, nes tai gali lemti visišką serverio neveikimą. Jei reikia atnaujinti "IonCube" versiją - kreipkitės į palaikymo tarnybą.

Preliminarūs reikalavimai "IonCube" diegimui

Jei turite serverį be jokio valdymo skydelio, gali tekti "IonCube" įdiegti rankiniu būdu.

Diegimo procesas gali skirtis priklausomai nuo jūsų operacinės sistemos. Nepriklausomai nuo operacinės sistemos, pirmas žingsnis visada yra prisijungti per SSH ir gauti root prieigą.

Norint įdiegti "IonCube", reikia kompiuterio su aktyviu ir veikiančiu žiniatinklio serveriu "Apache" arba "Nginx" ir įdiegta PHP versija iš "IonCube Loader" palaikomų versijų sąrašo.

Dėmesio: "IonCube Loader" turi tam tikrą ypatybę - ji dažnai nepalaiko "nulinių" PHP versijų, pavyzdžiui, PHP 8.0. Tačiau ji palaiko PHP 8.1 arba PHP 8.2 versijas.

Žingsnis po žingsnio "IonCube" diegimas

Svarbu: komandų, naudojamų "IonCube Loader" įdiegti, reikšmė priklauso nuo kai kurių kintamųjų: PHP versijos serveryje, PHP katalogo vietos ir serverio architektūros versijos. Čia ir ateityje pabrėšime šių kintamųjų vertes. Vietoje jų diegimo metu turėsite pakeisti atitinkamas jūsų serveriui skirtas vertes.

1 .Prisijunkite prie serverio per SSH.

2. Patikrinkite esamo serverio architektūrą:

uname -m
Exit
x86_64

Kaip matome iš x86_64, mūsų dabartinis serveris veikia 64 bitų architektūroje. Formos i686 reikšmės rodytų priešingai - 32 bitų architektūrą.

Tada eikite į tmp katalogą ir atsisiųskite reikiamą archyvą:

64 bitų sistemoms:

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

32 bitų sistemoms:

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

Atsisiuntę archyvą turėtumėte jį išpakuoti:

Kadangi mūsų pavyzdyje naudojama 64 bitų architektūra, atsisiuntėme ir išpakavome būtent tokį archyvą.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Eikite į katalogą ioncube ir peržiūrėkite failų sąrašą.

cd ioncube/
ls -l

Išvada

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

Kaip matote, archyve yra daug skirtingų modulio versijų, skirtų skirtingoms PHP versijoms. Turime išsiaiškinti, kurių iš šių failų mums reikia tolesniam diegimui.

6. Žinodami savo PHP versiją (iš pirmojo žingsnio), kitu žingsniu nustatome katalogo, į kurį reikia įdiegti "IonCube Loader", vietą.

php -i | grep extension_dir

Išvestis

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

Vieta /usr/lib/php/20210902 bus reikalinga tolesniame diegimo procese. Centos operacinėje sistemoje toks aplankas gali atrodyti taip: /usr/lib64/php/modules.

7. Nukopijuokite "IonCube" failus į reikiamą katalogą.

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

8. Dabar reikia atlikti konfigūracijos failų php.ini pakeitimus. Skirtingose serverio konfigūracijose jie gali būti skirtingose vietose:

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

Pačioje php.ini pradžioje įterpkite tokią eilutę:

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

9. Iš naujo paleiskite žiniatinklio serverį:

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. Patikrinkite, ar diegimas atliktas teisingai, naudodami komandą:

php -v

Jei įdiegimas sėkmingas, bus rodoma tokia eilutė su informacija apie dabartinę "IonCube" versiją:

Išvestis

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 ŽINGSNIS. Pridėti serverį

Eikite į administratoriaus skydelį.

System Settings/Servers

Spustelėkite Pridėti naują serverį.

Užpildykite formą, kaip parodyta toliau pateiktame ekrano paveikslėlyje.

Lauke Modulis raskite: PQH

Laukelyje Hostname or IP Address (šeimininko vardas arba IP adresas) įrašykite: client.the.hosting

Tada įveskite savo paskyros duomenis (prisijungimo vardą, slaptažodį) iš client.the.hosting.

Spustelėkite tęsti.

Tada kitame puslapyje reikia įvesti serverio pavadinimą (jūsų pasirinktą) ir spustelėkite Išsaugoti pakeitimus.

4 ŽINGSNIS. modulio administratorius

Turime sukurti naują administratorių.

Tai galima padaryti nuėjus į nustatymus / tvarkyti administratorius

Tada spustelėkite Pridėti naują administratorių

Vaidmuo: Visiškas administratorius

Vartotojo vardas (privalomas!): apisystem

Likusieji duomenys priklauso nuo jūsų

Pavyzdys (ekrano nuotrauka toliau)

5 ŽINGSNIS. Papildomi laukai

Tokius laukus, kaip operacinės sistemos pasirinkimas pirkimo metu, galima sukonfigūruoti nuėjus į Nustatymai / Sistemos nustatymai / Konfigūruojamos parinktys

Spustelėkite mygtuką Create a New Group (sukurti naują grupę), tada nustatykite pageidaujamą grupės pavadinimą.

ir spustelėkite Išsaugoti pakeitimus, tada spustelėkite atsiradusį mygtuką Pridėti naują konfigūruojamą parinktį.

Tada iššokančiame lange į lauką Option Name (parinkties pavadinimas) įveskite: "VM Template" (virtualios mašinos šablonas).

Tada į lauką Add Options (Pridėti parinktis) įrašykite reikšmę.

Čia pateikiamas visų palaikomų reikšmių sąrašas:

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

Tiek šiame skirtuke, tiek skirtuke Configurable Option Groups (konfigūruojamų parinkčių grupės) spustelėkite Save Changes (įrašyti pakeitimus).

6 ŽINGSNIS. Produktų pridėjimas

Eikite į Nustatymai / Sistemos nustatymai / Produktai, paslaugos

Sukurkite naują grupę spustelėję Create a New Group (sukurti naują grupę).

Tada užpildykite laukus taip, kaip jums atrodo tinkama

Išsaugokite ir vėl eikite į Nustatymai/Sistemos nustatymai/ Produktai,Paslaugos.

Spustelėkite Sukurti naują gaminį
Tada (būtinai) pasirinkite
Produkto tipas: Serveris/VPS
Modulis: PQH

Likusius duomenis užpildykite taip, kaip jums atrodo tinkama

Išsaugoję galite pritaikyti šį produktą

Skirtuke Details (Išsami informacija) (toliau pateikta ekrano nuotrauka) galite pritaikyti produktą, kaip norite (produkto pavadinimas, produkto antraštė, trumpas produkto aprašymas, produkto aprašymas).

Reikalauti domeno reikšmės žymimasis langelis turėtų būti nepažymėtas.

Nepamirškite išsaugoti produkto nustatymų

Skirtuke Kainos (toliau pateikta ekrano kopija) galite konfigūruoti produkto apmokėjimą. Nepamirškite išsaugoti produkto nustatymų

Skirtuke Modulio nustatymai (ekrano kopija toliau)

Pasirinkite (privaloma) Modulio pavadinimas: PQH

Tada pasirinkite duomenų centrą ir tarifą, kuris atitiks šį produktą.

Nepamirškite išsaugoti produkto nustatymų

Kortelėje Custom Fields (pasirinktiniai laukai) (toliau pateikta ekrano kopija) į lauką Field Name (lauko pavadinimas) PRIVALOMA įterpti reikšmę "VMid".

Likusius skirtukus pritaikykite savo nuožiūra.

Be to, norėdami supaprastinti produktų pridėjimo procesą, galime juos dubliuoti (toliau pateikta ekrano kopija).

7 ŽINGSNIS. Testavimas

Sukurkite naudotoją, papildykite jo paskyrą ir pabandykite užsakyti paslaugą iš bandomosios paskyros. Vartotojui užsakant paslaugą, modulis perduos visus parametrus "BILLmanager", automatiškai užsakys serverį, o kai serveris bus aktyvuotas "BILLmanager" pusėje, paslauga bus aktyvuota ir WHMCS pusėje.