Installationsvejledning til WHMCS-modul

Hjem
Videnbase
Installationsvejledning til WHMCS-modul

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) er et automatiseringssystem til hostingfirmaer og internetudbydere. Det tilbyder funktionalitet til kundestyring, fakturering, support og procesautomatisering. Her er vejledningen til, hvordan du installerer dette modul.

TRIN 1: Indlæsning af modulet

Upload modulet til serveren via kommandolinjen ved hjælp af scp:

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

Eksempel, hvis du allerede er i mappen med filen:

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

Du vil derefter blive bedt om at indtaste din serveradgangskode.

Når du har uploadet filen til serveren, skal du oprette forbindelse til serveren via SSH og pakke filen ud

ssh user@remote_server

Du skal indtaste serveradgangskoden.

Gå derefter til mappen med dit projekt, og hvor du uploadede filen.

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

Arkivet skal pakkes ud i roden af projektet.

unzip module-whmcs-billmanager.zip

I dette arkiv er der 3 versioner af modulet, der svarer til den version af php, som whmcs fungerer på, for at finde ud af din version af php skal du gå til Utilities/System/PHP info.

Derefter skal du pakke arkivet ud igen for den version, som din whmcs understøtter.

For php 7.1, php 7.2, php 7.4 skal du indtaste

unzip version7.1|7.2|7.4.zip

For php 8.1 skal du indtaste

unzip version8.1

For php 8.2 skal du indtaste

unzip version8.2

Derefter skal du (nødvendigvis) give tilladelse til filerne. Det kan du gøre fra projektmappen ved at indtaste kommandoen
chmod -R 755 moduler/servere/PQH

Modulet er indlæst.

Eller upload modulet til serveren via FileZilla

Pak filen module-whmcs-billmanager.zip ud på din computer.

Derefter skal du pakke arkivet med den version, som din whmcs understøtter, ud igen:

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

Opret derefter forbindelse til din server ved hjælp af filezilla.

Overfør filerne til webstedets rodmappe fra det arkiv, der svarer til din version af php (som i skærmbilledet nedenfor).

Derefter er det nødvendigt (obligatorisk) at give rettigheder til mappen og filerne for at gøre dette ved at gå til mappen modules/servers og højreklikke på PQH-mappen og vælge filattributter i pop op-vinduet, skrive i feltet numerisk værdi 755 og markere afkrydsningsfeltet på recurse into subdirectories (som på skærmbilledet nedenfor).

Modulet er indlæst.

TRIN 2. Tjek IonCube

På vores delte hosting afhænger understøttelsen af IonCube og dens version af den PHP-version, der er valgt for brugeren. Dette gælder for alle hostingplaner samt for virtuelle/dedikerede servere med ISPManager-panelet installeret.

OBS: Hvis du har ISPManager4-panelet installeret på din server, har du allerede IonCube installeret i alle understøttede versioner. Følg ikke denne instruktion under nogen omstændigheder, da det kan føre til, at serveren ikke fungerer. Hvis det er nødvendigt at opdatere IonCube-versionen, skal du kontakte supporttjenesten.

Foreløbige krav til installation af IonCube

Hvis du har en server uden kontrolpanel, kan du blive nødt til at installere IonCube manuelt.

Installationsprocessen kan variere afhængigt af dit operativsystem. Uanset OS er det første skridt altid at oprette forbindelse via SSH og få root-adgang.

For at installere IonCube skal du bruge en maskine med en aktiv og fungerende webserver, Apache eller Nginx, samt en installeret version af PHP fra listen over understøttede af IonCube Loader.

OBS: IonCube Loader har en særlig egenskab - den understøtter ofte ikke "nul"-versioner af PHP, f.eks. PHP 8.0. Den understøtter dog PHP 8.1 eller PHP 8.2.

Trin-for-trin installation af IonCube

Vigtigt: Værdien af de kommandoer, der bruges til at installere IonCube Loader, varierer afhængigt af nogle variabler: PHP-versionen på serveren, placeringen af PHP-biblioteket og versionen af serverarkitekturen. Her og i fremtiden vil vi fremhæve værdierne af disse variabler. Du skal erstatte dem med de værdier, der passer til din server under installationen.

1. Opret forbindelse til serveren via SSH.

2. Tjek arkitekturen på den aktuelle server:

uname -m
Exit
x86_64

Som vi kan se af x86_64, kører vores nuværende server på en 64-bit-arkitektur. Værdier af formen i686 ville indikere det modsatte - en 32-bit-arkitektur.

Gå derefter til tmp-biblioteket og download det nødvendige arkiv:

For 64-bit systemer:

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

For 32-bit systemer:

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

Når du har downloadet arkivet, skal du pakke det ud:

Da vi har en 64-bit-arkitektur i eksemplet, har vi downloadet og udpakket netop sådan et arkiv.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Gå til ioncube-biblioteket, og se listen over filer igennem.

cd ioncube/
ls -l

Konklusion

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

Som du kan se, indeholder arkivet mange forskellige versioner af modulet til forskellige PHP-versioner. Vi skal finde ud af, hvilke af disse filer vi skal bruge til den videre installation.

6. Når du kender din version af PHP (fra første trin), er næste trin at bestemme placeringen af den mappe, hvor du skal installere IonCube Loader.

php -i | grep extension_dir

Output

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

Placeringen /usr/lib/php/20210902 vil være nødvendig i den videre installationsproces. I Centos OS kan en sådan mappe se ud som /usr/lib64/php/modules.

7. Kopier IonCube-filer til den nødvendige mappe.

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

8. Nu er det nødvendigt at redigere i konfigurationsfilerne php.ini. De kan have forskellige placeringer i forskellige serverkonfigurationer:

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

Indsæt en linje af følgende type helt i begyndelsen af php.ini:

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

9. Udfør en genstart af webserveren:

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. Bekræft, at installationen er korrekt med kommandoen:

php -v

Hvis installationen er vellykket, vises linjen med oplysninger om den aktuelle version af IonCube som følger:

Output

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

TRIN 3. Tilføj server

Gå til administratorpanelet.

System Settings/Servers

Klik på Tilføj ny server.

Udfyld formularen som på skærmbilledet nedenfor.

I feltet Module skal du finde: PQH

I feltet Hostname eller IP Address indtastes: client.the.hosting

Indtast derefter dine kontooplysninger (login, adgangskode) fra client.the.hosting.

Og klik på fortsæt.

På næste side skal du indtaste servernavnet (efter eget valg) og klikke på Gem ændringer.

TRIN 4. Moduladministrator

Vi skal oprette en ny administrator.

Dette kan gøres ved at gå til indstillinger/administrer administratorer

Klik derefter på Tilføj ny administrator

Rolle: Fuld administrator

Brugernavn (obligatorisk!): apisystem

Resten af dataene er op til dig

Eksempel (skærmbillede nedenfor)

TRIN 5. Yderligere felter

Felter som f.eks. valg af operativsystem ved køb kan konfigureres ved at gå til indstillinger/systemindstillinger/Konfigurerbare indstillinger

Klik på knappen Opret en ny gruppe, og indstil derefter navnet på gruppen, som du ønsker.

og klik på Gem ændringer, og klik derefter på knappen, der vises Tilføj ny konfigurerbar mulighed.

I pop op-vinduet indtaster du i feltet Option Name: "VM Template".

Tilføj derefter værdien i feltet Add Options.

Her er en liste over alle de understøttede værdier:

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

Klik på Gem ændringer på både denne fane og på fanen Grupper af konfigurerbare indstillinger.

TRIN 6. Tilføjelse af produkter

Gå til Indstillinger/Systemindstillinger/ Produkter,Tjenester

Opret en ny gruppe ved at klikke på Opret en ny gruppe.

Udfyld derefter felterne, som du finder passende

Gem, og gå til Indstillinger/Systemindstillinger/Produkter,Tjenester igen.

Klik på Opret et nyt produkt
Vælg derefter (sørg for at)
Produkttype: Server/VPS
Modul: PQH

Udfyld resten, som du finder det passende

Når du har gemt, kan du tilpasse dette produkt

På fanen Detaljer (skærmbillede nedenfor) kan du tilpasse produktet, som du ønsker (produktnavn, produkttagline, kort produktbeskrivelse, produktbeskrivelse).

Afkrydsningsfeltet i værdien Kræv domæne skal være afkrydset.

Glem ikke at gemme produktindstillingerne

På fanen Priser (skærmbillede nedenfor) kan du konfigurere betalingen for produktet. Glem ikke at gemme produktindstillingerne

På fanen Modulindstillinger (skærmbillede nedenfor)

Vælg (obligatorisk) Modulnavn: PQH

Vælg derefter det datacenter og den tarif, der passer til dette produkt.

Glem ikke at gemme produktindstillingerne

På fanen Brugerdefinerede felter (skærmbillede nedenfor) SKAL du indsætte værdien "VMid" i feltet Feltnavn

Tilpas resten af fanerne, som du finder det passende.

For at forenkle processen med at tilføje produkter kan vi desuden duplikere dem (skærmbillede nedenfor).

TRIN 7. Testning

Opret en bruger, fyld hans konto op, og prøv at bestille en tjeneste fra testkontoen. Når brugeren bestiller, sender modulet alle parametre til BILLmanager, bestiller serveren automatisk, og når serveren er aktiveret på BILLmanager-siden, vil tjenesten også blive aktiveret på WHMCS-siden.