Installasjonsinstruksjoner for WHMCS-modulen

Hovedside
Kunnskapsbase
Installasjonsinstruksjoner for WHMCS-modulen

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) er et automatiseringssystem for hostingfirmaer og Internett-leverandører. Det tilbyr funksjonalitet for kundeadministrasjon, fakturering, support og prosessautomatisering. Her er instruksjonene for hvordan du installerer denne modulen.

TRINN 1: Laste inn modulen

Last opp modulen til serveren via kommandolinjen ved hjelp av scp:

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

Eksempel hvis du allerede befinner deg i mappen med filen:

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

Du blir deretter bedt om å oppgi serverpassordet ditt.

Etter at du har lastet opp filen til serveren, kobler du deg til serveren via SSH og pakker ut filen

ssh user@remote_server

Du må oppgi serverpassordet.

Gå deretter til mappen for prosjektet ditt og der du lastet opp filen.

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

Arkivet skal pakkes ut i roten av prosjektet

unzip module-whmcs-billmanager.zip

I dette arkivet er det 3 versjoner av modulen som tilsvarer versjonen av php som whmcs fungerer på, for å finne ut hvilken versjon av php du har, gå til Utilities/System/PHP info.

Deretter må du pakke ut arkivet igjen for den versjonen din whmcs støtter.

For php 7.1, php 7.2, php 7.4 skriver du inn

unzip version7.1|7.2|7.4.zip

For php 8.1 skriver du inn

unzip version8.1

For php 8.2 skriver du inn

unzip version8.2

Deretter må du (nødvendigvis) gi rettigheter til filene. Dette kan du gjøre fra prosjektmappen ved å skrive inn kommandoen
chmod -R 755 modules/servers/PQH

Modulen er lastet inn.

Eller last opp modulen til serveren via FileZilla

På datamaskinen din pakker du ut filen module-whmcs-billmanager.zip

Deretter må du pakke ut arkivet med den versjonen din whmcs støtter:

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

Koble deretter til serveren din ved hjelp av filezilla.

Overfør filene til rotmappen på nettstedet fra arkivet som tilsvarer din versjon av php (som i skjermbildet nedenfor).

Deretter er det nødvendig (obligatorisk) å gi rettigheter til mappen og filene for å gjøre dette ved å gå til mappen moduler/servere og høyreklikke på PQH-mappen og velge filattributter i popup-vinduet, skrive i feltet numerisk verdi 755 og krysse av i avmerkingsboksen på recurse i underkataloger (som på skjermbildet nedenfor).

Modulen er lastet inn.

TRINN 2. Kontroller IonCube

På vår delte hosting, IonCube støtte og dens versjon avhenger av PHP-versjonen som er valgt for brukeren. Dette gjelder for alle typer hostingplaner, samt for virtuelle/dedikerte servere med ISPManager-panelet installert.

OBS: Hvis du har ISPManager4-panelet installert på serveren din - har du allerede IonCube installert for alle støttede versjoner. Ikke følg denne instruksjonen i noe tilfelle, da det kan føre til at serveren blir fullstendig ubrukelig. Hvis det er nødvendig å oppdatere IonCube-versjonen, må du kontakte supporttjenesten.

Foreløpige krav for installasjon av IonCube

Hvis du har en server uten kontrollpanel, kan det være nødvendig med manuell installasjon av IonCube.

Installasjonsprosessen kan variere avhengig av operativsystemet ditt. Uansett operativsystem er det første trinnet alltid å koble til via SSH og få root-tilgang.

For å installere IonCube trenger du en maskin med en aktiv og fungerende webserver, Apache eller Nginx, samt en installert versjon av PHP fra listen over støttet av IonCube Loader.

OBS: IonCube Loader har en viss særegenhet - den støtter ofte ikke "null" versjoner av PHP, for eksempel PHP 8.0. Den støtter imidlertid PHP 8.1 eller PHP 8.2.

Trinnvis installasjon av IonCube

Viktig: verdien av kommandoene som brukes til å installere IonCube Loader varierer avhengig av noen variabler: PHP-versjonen på serveren, plasseringen av PHP-katalogen og versjonen av serverarkitekturen. Her og i fremtiden vil vi fremheve verdiene til disse variablene. I stedet må du erstatte dem med de riktige verdiene for serveren din under installasjonen.

1. koble til serveren via SSH.

2. Kontroller arkitekturen til den aktuelle serveren:

uname -m
Exit
x86_64

Som vi kan se av x86_64, kjører den aktuelle serveren vår på en 64-bits arkitektur. Verdier på formen i686 indikerer det motsatte - en 32-bits arkitektur.

Gå deretter til tmp-katalogen og last ned det nødvendige arkivet:

For 64-bits systemer:

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

For 32-bits systemer:

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

Etter at du har lastet ned arkivet, bør du pakke det ut:

Siden vi har en 64-bits arkitektur i eksempelet, har vi lastet ned og pakket ut nettopp et slikt arkiv.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Gå til ioncube-katalogen og se gjennom listen over filer.

cd ioncube/
ls -l

Konklusjon

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, inneholder arkivet mange forskjellige versjoner av modulen for forskjellige PHP-versjoner. Vi må finne ut hvilke av disse filene vi trenger for videre installasjon.

6. Når du kjenner din versjon av PHP (fra første trinn), er neste trinn å bestemme plasseringen av katalogen der du trenger å installere IonCube Loader.

php -i | grep extension_dir

Utdata

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

Plasseringen /usr/lib/php/20210902 vil være nødvendig i den videre installasjonsprosessen. I Centos OS kan en slik mappe se ut som /usr/lib64/php/modules.

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

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

8. Nå er det nødvendig å gjøre endringer i konfigurasjonsfilene php.ini. De kan ha forskjellige plasseringer i forskjellige serverkonfigurasjoner:

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

Sett inn en linje av følgende type helt i begynnelsen av php.ini:

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

9. Utfør en omstart av 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. Kontroller at installasjonen er korrekt med kommandoen:

php -v

Hvis installasjonen er vellykket, vises linjen med informasjon om den gjeldende versjonen av IonCube på følgende måte:

Utdata

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

TRINN 3. Legg til server

Gå til administrasjonspanelet.

System Settings/Servers

Klikk på Legg til ny server.

Fyll ut skjemaet som på skjermbildet nedenfor.

I Modul-feltet finner du: PQH

I feltet Hostname eller IP-adresse skriver du inn: client.the.hosting

Skriv deretter inn kontoinformasjonen din (innlogging, passord) fra client.the.hosting.

Og klikk på Fortsett.

På neste side må du angi servernavnet (ditt valg) og klikke på Lagre endringer.

TRINN 4. Moduladministrator

Vi må opprette en ny administrator.

Dette kan gjøres ved å gå til innstillinger/administrer administratorer

Klikk deretter på Legg til ny administrator

Rolle: Full administrator

Brukernavn (obligatorisk!): apisystem

Resten av dataene er opp til deg

Eksempel (skjermbilde nedenfor)

TRINN 5. Ytterligere felt

Felt som f.eks. valg av operativsystem ved kjøp kan konfigureres ved å gå til Innstillinger/Systeminnstillinger/Konfigurerbare alternativer

Klikk på knappen Opprett en ny gruppe, og angi navnet på gruppen som du ønsker.

og klikk på Lagre endringer, og klikk deretter på knappen som vises Legg til nytt konfigurerbart alternativ.

I popup-vinduet skriver du inn følgende i feltet Alternativnavn: "VM-mal".

Legg deretter til verdien i feltet Legg til alternativer.

Her er en liste over alle verdiene som støttes:

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

Klikk på Lagre endringer i både denne fanen og fanen Konfigurerbare opsjonsgrupper.

TRINN 6. Legge til produkter

Gå til Innstillinger/Systeminnstillinger/ Produkter,Tjenester

Opprett en ny gruppe ved å klikke på Opprett en ny gruppe.

Fyll deretter ut feltene slik du ønsker.

Lagre og gå til Innstillinger/Systeminnstillinger/ Produkter,Tjenester igjen.

Klikk på Opprett et nytt produkt
Deretter (sørg for å) velge
Produkttype: Server/VPS
Modul: PQH

Fyll ut resten slik du finner det passende

Etter at du har lagret, kan du tilpasse dette produktet

I fanen Detaljer (skjermbilde nedenfor) kan du tilpasse produktet slik du ønsker (produktnavn, produkttittel, kort produktbeskrivelse, produktbeskrivelse).

Avkrysningsboksen i Krev domeneverdi bør ikke være merket av.

Ikke glem å lagre produktinnstillingene

I fanen Priser (skjermbilde nedenfor) kan du konfigurere betalingen for produktet. Ikke glem å lagre produktinnstillingene

I fanen Modulinnstillinger (skjermbilde nedenfor)

Velg (obligatorisk) Modulnavn: PQH

Velg deretter datasenteret og tariffen som skal matche dette produktet.

Ikke glem å lagre produktinnstillingene

I fanen Egendefinerte felt (skjermbilde nedenfor) MÅ du sette inn verdien "VMid" i feltet Feltnavn

Tilpass resten av fanene etter eget ønske.

For å forenkle prosessen med å legge til produkter, kan vi duplisere dem (skjermbilde nedenfor).

TRINN 7. Testing

Opprett en bruker, fyll på kontoen hans og prøv å bestille en tjeneste fra testkontoen. Når brukeren bestiller, vil modulen sende alle parametrene til BILLmanager, bestille serveren automatisk, og når serveren er aktivert på BILLmanager-siden, vil tjenesten også bli aktivert på WHMCS-siden.