WHMCS moduļa uzstādīšanas instrukcija

Mājas
Zināšanu bāze
WHMCS moduļa uzstādīšanas instrukcija

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) ir automatizācijas sistēma hostinga uzņēmumiem un interneta pakalpojumu sniedzējiem. Tā piedāvā funkcionalitāti klientu pārvaldībai, rēķinu izrakstīšanai, atbalstam un procesu automatizācijai. Šeit ir sniegti norādījumi, kā instalēt šo moduli.

1. KĀRTĪBA: moduļa ielādēšana

Augšupielādējiet moduli uz serveri, izmantojot komandrindas funkciju scp:

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

Piemērs, ja jūs jau atrodaties mapē ar failu:

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

Pēc tam jums tiks piedāvāts ievadīt servera paroli.

Pēc faila augšupielādes uz serveri izveidojiet savienojumu ar serveri, izmantojot SSH, un izplēšojiet failu.

ssh user@remote_server

Jums būs jāievada servera parole.

Pēc tam dodieties uz sava projekta mapi, kurā augšupielādējāt failu.

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

Arhīvam jābūt izpakētam projekta saknē.

unzip module-whmcs-billmanager.zip

Šajā arhīvā ir 3 moduļa versijas, kas atbilst php versijai, kurā darbojas whmcs, lai uzzinātu savu php versiju, dodieties uz Utilities/System/PHP info.

Pēc tam arhīvs vēlreiz jāizpako, lai iegūtu versiju, kuru atbalsta jūsu whmcs.

php 7.1, php 7.2, php 7.4 gadījumā ievadiet

unzip version7.1|7.2|7.4.zip

Attiecībā uz php 8.1 ievadiet

unzip version8.1

Attiecībā uz php 8.2 ievadiet

unzip version8.2

Pēc tam (obligāti) jāpiešķir tiesības failiem. To var izdarīt no projekta mapes, ievadot komandu
chmod -R 755 modules/servers/PQH

Modulis tiek ielādēts.

Vai arī augšupielādēt moduli uz serveri, izmantojot FileZilla

Datorā izaizzipējiet failu module-whmcs-billmanager.zip.

Pēc tam vēlreiz jāizaiņo whmcs atbalstītās versijas arhīvs:

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

Pēc tam izveidojiet savienojumu ar serveri, izmantojot filezilla.

Pārsūtiet failus uz vietnes saknes mapi no arhīva, kas atbilst jūsu php versijai (kā attēlā zemāk).

Pēc tam ir nepieciešams (obligāti) piešķirt tiesības mapei un failiem, lai to izdarītu, dodieties uz mapi modules/servers un ar peles labo pogu noklikšķiniet uz mapes PQH un uznirstošajā logā izvēlieties failu atribūti, ierakstiet laukā skaitlisko vērtību 755 un atzīmējiet izvēles rūtiņu recurse into subdirectories (kā ekrānšāviņš zemāk).

Modulis ir ielādēts.

KĀRTA. Pārbaudiet IonCube

Mūsu koplietojamajā hostingā IonCube atbalsts un tā versija ir atkarīga no lietotājam izvēlētās PHP versijas. Tas attiecas uz jebkuru hostinga plānu rindu, kā arī uz virtuālajiem/dedicētajiem serveriem ar instalētu ISPManager paneli.

Uzmanību: ja jūsu serverī ir instalēts ISPManager4 panelis - jums jau ir instalēta IonCube visās atbalstāmajās versijās. Nekādā gadījumā neievērojiet šo norādījumu, jo tas var novest pie pilnīgas servera darbības pārtraukšanas. Ja nepieciešams atjaunināt IonCube versiju, sazinieties ar atbalsta dienestu.

IonCube instalēšanas sākotnējās prasības

Ja jums ir serveris bez vadības paneļa, var rasties nepieciešamība manuāli instalēt IonCube.

Instalēšanas process var atšķirties atkarībā no jūsu operētājsistēmas. Neatkarīgi no operētājsistēmas pirmais solis vienmēr ir izveidot savienojumu, izmantojot SSH, un iegūt root piekļuvi.

Lai instalētu IonCube, jums ir nepieciešams dators ar aktīvu un darbojošos tīmekļa serveri Apache vai Nginx, kā arī instalēta PHP versija no IonCube ielādētāja atbalstīto versiju saraksta.

Uzmanību: IonCube Loader ir zināma īpatnība - tas bieži vien neatbalsta "nulles" PHP versijas, piemēram, PHP 8.0. Tomēr tas atbalsta PHP 8.1 vai PHP 8.2.

IonCube instalēšana soli pa solim

Svarīgi: IonCube Loader instalēšanai izmantoto komandu vērtība atšķiras atkarībā no dažiem mainīgajiem lielumiem: PHP versijas serverī, PHP direktorijas atrašanās vietas un servera arhitektūras versijas. Šeit un turpmāk mēs norādīsim šo mainīgo lielumu vērtības. To vietā instalēšanas laikā jums būs jāaizstāj atbilstošās vērtības jūsu serverim.

1. Savienojieties ar serveri, izmantojot SSH.

2. Pārbaudiet pašreizējā servera arhitektūru:

uname -m
Exit
x86_64

Kā redzams no x86_64, mūsu pašreizējais serveris darbojas ar 64 bitu arhitektūru. Vērtības formā i686 norādītu uz pretējo - 32 bitu arhitektūru.

Tālāk dodieties uz tmp direktoriju un lejupielādējiet vajadzīgo arhīvu:

64 bitu sistēmām:

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

32 bitu sistēmām:

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

Pēc arhīva lejuplādēšanas tas ir jāizsaiņo:

Tā kā mūsu piemērā ir 64 bitu arhitektūra, mēs esam lejupielādējuši un atšifrējuši tieši šādu arhīvu.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Dodieties uz ioncube direktoriju un apskatiet failu sarakstu.

cd ioncube/
ls -l

Secinājumi

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

Kā redzat, arhīvā ir daudz dažādu moduļa versiju dažādām PHP versijām. Mums ir jānoskaidro, kuri no šiem failiem mums ir nepieciešami tālākai instalācijai.

6. Zinot savu PHP versiju (no pirmā soļa), nākamais solis ir noteikt tās direktorijas atrašanās vietu, kurā nepieciešams instalēt IonCube Loader.

php -i | grep extension_dir

Izvades adrese

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

Atrašanās vieta /usr/lib/php/20210902 būs nepieciešama turpmākajā instalēšanas procesā. Centos OS šāda mape var izskatīties kā /usr/lib64/php/modules.

7. IonCube failus kopējiet vajadzīgajā direktorijā.

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

8. Tagad ir nepieciešams veikt konfigurācijas faila php.ini rediģēšanu. Dažādās servera konfigurācijās tiem var būt atšķirīga atrašanās vieta:

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šā php.ini sākumā jāievieto šāda veida rinda:

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

9. Veiciet tīmekļa servera restartēšanu:

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. Pārbaudiet, vai instalācija ir pareiza, izmantojot komandu:

php -v

Ja instalēšana ir veiksmīga, tiks parādīta šāda rinda ar informāciju par pašreizējo IonCube versiju:

Izvades lapa:

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

KĀRTĪBA 3. Pievienojiet serveri

Dodieties uz administratora paneli.

System Settings/Servers

Noklikšķiniet uz Pievienot jaunu serveri.

Aizpildiet veidlapu, kā parādīts zemāk redzamajā ekrāna attēlā.

Moduļa laukā atrodiet: PQH

Laukā Hostname or IP Address ievadiet: client.the.hosting

Pēc tam ievadiet konta informāciju (lietotājvārdu, paroli) no client.the.hosting.

Un noklikšķiniet uz turpināt.

Tad nākamajā lapā jāievada servera nosaukums (pēc jūsu izvēles) un noklikšķiniet uz Saglabāt izmaiņas.

4. KĀRTA. Moduļa administrators

Mums ir jāizveido jauns administrators.

To var izdarīt, dodoties uz iestatījumi/pārvaldīt administratorus

Pēc tam noklikšķiniet uz Pievienot jaunu administratoru

Loma: Pilns administrators

Lietotājvārds (obligāts!): apisystem

Pārējie dati ir jūsu ziņā

Piemērs (ekrāna attēls zemāk)

5. Papildu lauki

Tādus laukus kā operētājsistēmas izvēle pirkuma brīdī var konfigurēt, atverot sadaļu Iestatījumi/Sistēmas iestatījumi/Konfigurējamās opcijas.

Noklikšķiniet uz pogas Izveidot jaunu grupu un pēc tam iestatiet grupas nosaukumu pēc saviem ieskatiem.

un noklikšķiniet uz Saglabāt izmaiņas, pēc tam noklikšķiniet uz pogas Pievienot jaunu konfigurējamu opciju.

Pēc tam uznirstošajā logā ievadiet Option Name (opcijas nosaukums) laukā: "VM Template" (VM veidne).

Pēc tam pievienojiet vērtību laukā Add Options (Pievienot opcijas).

Šeit ir visu atbalstīto vērtību saraksts:

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

Gan šajā cilnē, gan cilnē Configurable Option Groups (Konfigurējamo opciju grupas) noklikšķiniet uz Save Changes (Saglabāt izmaiņas).

6. KĀRTĪBA. Produktu pievienošana

Ejiet uz Iestatījumi/Sistēmas iestatījumi/ Produkti,Pakalpojumi

Izveidojiet jaunu grupu, noklikšķinot uz Izveidot jaunu grupu.

Pēc tam aizpildiet laukus pēc saviem ieskatiem

Saglabājiet un vēlreiz dodieties uz Iestatījumi/Sistēmas iestatījumi/ Produkti,Pakalpojumi.

Noklikšķiniet uz Izveidot jaunu produktu
Pēc tam (pārliecinieties), ka esat izvēlējies
Produkta tips: Serveris/VPS
Modulis: PQH

Aizpildiet pārējo, kā uzskatāt par piemērotu

Pēc saglabāšanas varat pielāgot šo produktu

Cilnē Detalizēta informācija (ekrānšāvis zemāk) varat pielāgot produktu pēc saviem ieskatiem (produkta nosaukums, produkta saīsne, produkta īss apraksts, produkta apraksts).

izvēles rūtiņai Pieprasīt domēna vērtību jābūt noņemtai.

Neaizmirstiet saglabāt produkta iestatījumus

Cilnē Cenu noteikšana (zemāk redzamais ekrānšāviņš) varat konfigurēt produkta apmaksu. Neaizmirstiet saglabāt produkta iestatījumus

Cilnē Moduļa iestatījumi (zemāk redzamais ekrānšāviņš).

Izvēlieties (obligāti) Moduļa nosaukums: PQH.

Pēc tam izvēlieties datu centru un tarifu, kas atbilst šim produktam.

Neaizmirstiet saglabāt produkta iestatījumus

Cilnē Custom Fields (Pielāgotie lauki) (ekrānšāviņš zemāk) lauciņā Field Name (Lauka nosaukums) obligāti ievietojiet vērtību "VMid".

Pārējās cilnes pielāgojiet pēc saviem ieskatiem.

Turklāt, lai vienkāršotu produktu pievienošanas procesu, mēs varam tos dublēt (ekrānšā attēlā zemāk).

7. KĀRTĪBA. Testēšana

Izveidojiet lietotāju, papildiniet viņa kontu un mēģiniet pasūtīt pakalpojumu no testa konta. Lietotājam veicot pasūtījumu, modulis nodos visus parametrus BILLmanager, automātiski pasūtīs serveri un, kad serveris būs aktivizēts BILLmanager pusē, pakalpojums tiks aktivizēts arī WHMCS pusē.