Instrucțiuni de instalare a modulului WHMCS

Acasă
Baza de cunoștințe
Instrucțiuni de instalare a modulului WHMCS

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) este un sistem de automatizare pentru companiile de hosting și ISP-uri. Acesta oferă funcționalități pentru gestionarea clienților, facturare, asistență și automatizarea proceselor. Iată instrucțiunile despre cum să instalați acest modul.

PASUL 1: Încărcarea modulului

Încărcați modulul pe server prin intermediul liniei de comandă folosind scp:

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

Exemplu dacă vă aflați deja în folderul cu fișierul:

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

Vi se va cere apoi să introduceți parola serverului.

După încărcarea fișierului pe server, conectați-vă la server prin SSH și despachetați fișierul

ssh user@remote_server

Va trebui să introduceți parola serverului.

Apoi mergeți la folderul proiectului dvs. și unde ați încărcat fișierul.

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

Arhiva ar trebui să fie despachetată în rădăcina proiectului

unzip module-whmcs-billmanager.zip

În această arhivă există 3 versiuni ale modulului care corespund versiunii de php pe care funcționează whmcs, pentru a afla versiunea dvs. de php mergeți la Utilities/System/PHP info.

Apoi trebuie să dezarhivați din nou arhiva pentru versiunea pe care o suportă whmcs.

Pentru php 7.1, php 7.2, php 7.4 introduceți

unzip version7.1|7.2|7.4.zip

Pentru php 8.1 introduceți

unzip version8.1

Pentru php 8.2 introduceți

unzip version8.2

Apoi trebuie (neapărat) să acordați permisiuni fișierelor. Puteți face acest lucru din folderul proiectului prin introducerea comenzii
chmod -R 755 modules/servers/PQH

Modulul este încărcat.

Sau încărcați modulul pe server prin intermediul FileZilla

Pe computerul dvs. dezarhivați fișierul module-whmcs-billmanager.zip

Apoi trebuie să dezarhivați din nou arhiva versiunii suportate de whmcs:

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

Apoi conectați-vă la serverul dvs. utilizând filezilla.

Transferați fișierele în folderul rădăcină al site-ului din arhiva corespunzătoare versiunii dvs. de php (ca în imaginea de mai jos).

Apoi este necesar (obligatoriu) să acordați drepturi folderului și fișierelor pentru a face acest lucru, accesați folderul modules/servers și faceți clic dreapta pe folderul PQH și selectați atributele fișierelor în fereastra pop-up, scrieți în câmpul valoarea numerică 755 și bifați caseta de selectare pe recurse into subdirectories (ca în captura de ecran de mai jos).

Modulul este încărcat.

PASUL 2. Verificați IonCube

Pe găzduirea noastră partajată, suportul IonCube și versiunea acestuia depind de versiunea PHP selectată pentru utilizator. Acest lucru este valabil pentru orice linie de planuri de găzduire, precum și pentru serverele virtuale/dedicate cu panoul ISPManager instalat.

Atenție: dacă aveți instalat panoul ISPManager4 pe serverul dvs. - aveți deja IonCube instalat pentru toate versiunile acceptate. Nu urmați această instrucțiune în niciun caz, deoarece aceasta poate duce la inoperabilitatea completă a serverului. În cazul în care este necesar să actualizați versiunea IonCube - contactați serviciul de asistență.

Cerințe preliminare pentru instalarea IonCube

Dacă aveți un server fără panou de control, vă puteți confrunta cu necesitatea instalării manuale a IonCube.

Procesul de instalare poate diferi în funcție de sistemul dvs. de operare. Indiferent de sistemul de operare, primul pas este întotdeauna conectarea prin SSH și obținerea accesului root.

Pentru a instala IonCube aveți nevoie de o mașină cu un server web activ și funcțional, Apache sau Nginx, precum și de o versiune instalată de PHP din lista celor acceptate de IonCube Loader.

Atenție: IonCube Loader are o anumită particularitate - adesea nu acceptă versiunile "zero" ale PHP, de exemplu PHP 8.0. Cu toate acestea, acceptă PHP 8.1 sau PHP 8.2.

Instalarea pas cu pas a IonCube

Important: valoarea comenzilor utilizate pentru instalarea IonCube Loader variază în funcție de anumite variabile: versiunea PHP de pe server, locația directorului PHP și versiunea arhitecturii serverului. Aici și în viitor, vom evidenția valorile acestor variabile. În locul lor, va trebui să înlocuiți valorile corespunzătoare pentru serverul dvs. în timpul instalării.

1 .Conectați-vă la server prin SSH.

2. Verificați arhitectura serverului curent:

uname -m
Exit
x86_64

După cum putem vedea din x86_64, serverul nostru actual rulează pe o arhitectură pe 64 de biți. Valorile de forma i686 ar indica contrariul - o arhitectură pe 32 de biți.

Apoi, mergeți la directorul tmp și descărcați arhiva necesară:

Pentru sistemele pe 64 de biți:

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

Pentru sisteme pe 32 de biți:

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

După descărcarea arhivei trebuie să o dezarhivați:

Deoarece în exemplu avem o arhitectură pe 64 de biți, am descărcat și dezarhivat exact o astfel de arhivă.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Mergeți în directorul ioncube și uitați-vă prin lista de fișiere.

cd ioncube/
ls -l

Concluzie

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

După cum puteți vedea, arhiva conține multe versiuni diferite ale modulului pentru diferite versiuni PHP. Trebuie să aflăm de care dintre aceste fișiere avem nevoie pentru continuarea instalării.

6. Cunoscându-vă versiunea PHP (de la primul pas), următorul pas este să determinați locația directorului în care trebuie să instalați IonCube Loader.

php -i | grep extension_dir

Ieșire

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

Locația /usr/lib/php/20210902 va fi necesară în procesul ulterior de instalare. În Centos OS un astfel de folder poate arăta ca /usr/lib64/php/modules.

7. Copiați fișierele IonCube în directorul necesar.

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

8. Acum este necesar să faceți editări la fișierele de configurare php.ini. Acestea pot avea locații diferite în diferite configurații de server:

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

Introduceți o linie de tipul următor chiar la începutul fișierului php.ini:

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

9. Efectuați o repornire a serverului web:

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. Verificați dacă instalarea este corectă cu ajutorul comenzii:

php -v

Dacă instalarea este reușită, linia cu informații despre versiunea curentă a IonCube va fi afișată după cum urmează:

Ieșire

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

PASUL 3. Adăugați serverul

Mergeți la panoul de administrare.

System Settings/Servers

Faceți clic pe Add New Server (Adăugare server nou).

Completați formularul ca în captura de ecran de mai jos.

În câmpul Modul găsiți: PQH

În câmpul Nume gazdă sau adresă IP introduceți: client.the.hosting

Apoi introduceți detaliile contului dvs. (login, parolă) de la client.the.hosting.

Și faceți clic pe continuare.

Apoi, pe pagina următoare trebuie să introduceți numele serverului (la alegerea dvs.) și să faceți clic pe Salvare modificări

PASUL 4. Modul Administrator

Trebuie să creăm un nou administrator.

Acest lucru se poate face accesând settings/manage admins

Apoi faceți clic pe Add New Administrator (Adăugare administrator nou)

Rol: Administrator complet

Nume de utilizator (obligatoriu!): apisystem

Restul datelor depind de dvs.

Exemplu (captură de ecran de mai jos)

PASUL 5. Câmpuri suplimentare

Câmpuri precum alegerea sistemului de operare la cumpărare pot fi configurate accesând Setări/Setări sistem/Opțiuni configurabile

faceți clic pe butonul Create a New Group, apoi setați numele grupului după cum doriți

și faceți clic pe Save Changes, apoi faceți clic pe butonul care apare Add New Configurable Option.

Apoi, în fereastra pop-up introduceți în câmpul Option Name: "VM Template".

Apoi adăugați valoarea în câmpul Add Options.

Aici este o listă cu toate valorile acceptate:

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

Faceți clic pe Save Changes atât în această filă, cât și în fila Configurable Option Groups.

PASUL 6. Adăugarea produselor

Mergeți la Settings/System settings/ Products,Services

Creați un grup nou făcând clic pe Create a New Group.

Apoi completați câmpurile după cum credeți de cuviință

Salvați și mergeți din nou la Settings/System settings/ Products,Services.

Faceți clic pe Create a New Product (Creare produs nou)
Apoi (asigurați-vă că) selectați
Tipul produsului: Server/VPS
Modul: PQH

Completați restul după cum credeți de cuviință

După salvare, puteți personaliza acest produs

În fila Detalii (captura de ecran de mai jos) puteți personaliza produsul după cum doriți (Nume produs,Tagline produs, Descriere scurtă produs, Descriere produs).

Caseta de selectare din valoarea Require Domain trebuie să fie debifată.

Nu uitați să salvați setările produsului

În fila Pricing (captura de ecran de mai jos), puteți configura plata pentru produs. Nu uitați să salvați setările produsului

În fila Module Settings (Setări modul) (captura de ecran de mai jos)

Selectați (obligatoriu) Numele modulului: PQH

Apoi selectați centrul de date și tariful care se vor potrivi acestui produs.

Nu uitați să salvați setările produsului

În fila Custom Fields (Câmpuri personalizate) (imaginea de mai jos), TREBUIE să introduceți valoarea "VMid" în câmpul Field Name

Personalizați restul filelor după cum credeți de cuviință.

În continuare, pentru a simplifica procesul de adăugare a produselor, le putem duplica (captura de ecran de mai jos).

PASUL 7. Testare

Creați un utilizator, completați contul acestuia și încercați să comandați un serviciu din contul de testare. La comandarea de către utilizator, modulul va transmite toți parametrii către BILLmanager, va comanda serverul în mod automat, iar atunci când serverul este activat pe partea BILLmanager, serviciul va fi activat și pe partea WHMCS.