Pokyny na inštaláciu modulu WHMCS

Hlavná
Znalostná báza
Pokyny na inštaláciu modulu WHMCS

26.09.2024, 12:51

WHMCS (Web Host Manager Complete Solution) je automatizačný systém pre hostingové spoločnosti a poskytovateľov internetových služieb. Ponúka funkcie na správu zákazníkov, fakturáciu, podporu a automatizáciu procesov. Tu sú pokyny na inštaláciu tohto modulu.

KROK 1: Načítanie modulu

Nahrajte modul na server prostredníctvom príkazového riadka pomocou funkcie scp:

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

Príklad: Ak sa už nachádzate v priečinku so súborom:

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

Potom budete vyzvaní na zadanie hesla servera.

Po nahratí súboru na server sa pripojte k serveru prostredníctvom SSH a rozbaľte súbor

ssh user@remote_server

Budete musieť zadať heslo servera.

Potom prejdite do priečinka svojho projektu a do priečinka, do ktorého ste nahrali súbor.

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

Archív by sa mal rozbaliť do koreňového adresára projektu

unzip module-whmcs-billmanager.zip

V tomto archíve sa nachádzajú 3 verzie modulu zodpovedajúce verzii php, na ktorej whmcs funguje, ak chcete zistiť svoju verziu php, prejdite do Utilities/System/PHP info.

Potom musíte archív opäť rozbaliť pre verziu, ktorú podporuje váš whmcs.

Pre php 7.1, php 7.2, php 7.4 zadajte

unzip version7.1|7.2|7.4.zip

Pre php 8.1 zadajte

unzip version8.1

Pre php 8.2 zadajte

unzip version8.2

Potom musíte (nevyhnutne) udeliť práva k súborom. Môžete to urobiť z priečinka projektu zadaním príkazu
chmod -R 755 modules/servers/PQH

Modul sa načíta.

Alebo nahrajte modul na server prostredníctvom programu FileZilla

V počítači rozbaľte súbor module-whmcs-billmanager.zip

Potom musíte opäť rozbaliť archív verzie, ktorú váš whmcs podporuje:

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

Potom sa pripojte k serveru pomocou programu filezilla.

Preneste súbory do koreňového priečinka stránky z archívu zodpovedajúceho vašej verzii php (ako na obrázku nižšie).

Následne je potrebné (povinné) udeliť práva na priečinok a súbory k tomu tak, že prejdete do priečinka modules/servers a kliknete pravým tlačidlom myši na priečinok PQH a v zobrazenom okne vyberiete atribúty súborov, do poľa napíšete číselnú hodnotu 755 a zaškrtnete políčko recurse into subdirectories (ako na obrázku nižšie).

Modul sa načíta.

KROK 2. Skontrolujte IonCube

Na našom zdieľanom hostingu je podpora modulu IonCube a jeho verzia závislá od verzie PHP zvolenej pre používateľa. Platí to pre všetky rady hostingových plánov, ako aj pre virtuálne/dedikované servery s nainštalovaným panelom ISPManager.

Pozor: Ak máte na serveri nainštalovaný panel ISPManager4 - IonCube už máte nainštalovaný pre všetky podporované verzie. V žiadnom prípade sa týmto pokynom neriaďte, pretože to môže viesť k úplnej nefunkčnosti servera. V prípade potreby aktualizácie verzie IonCube - kontaktujte servisnú podporu.

Predbežné požiadavky na inštaláciu IonCube

Ak máte server bez akéhokoľvek ovládacieho panela, môžete sa stretnúť s nutnosťou ručnej inštalácie IonCube.

Proces inštalácie sa môže líšiť v závislosti od operačného systému. Bez ohľadu na operačný systém je vždy prvým krokom pripojenie cez SSH a získanie prístupu root.

Na inštaláciu IonCube potrebujete počítač s aktívnym a funkčným webovým serverom Apache alebo Nginx, ako aj nainštalovanú verziu PHP zo zoznamu podporovaných aplikáciou IonCube Loader.

Pozor: IonCube Loader má určitú zvláštnosť - často nepodporuje "nulté" verzie PHP, napríklad PHP 8.0. Podporuje však PHP 8.1 alebo PHP 8.2.

Inštalácia IonCube krok za krokom

Dôležité: hodnota príkazov použitých na inštaláciu IonCube Loader sa líši v závislosti od niektorých premenných: verzie PHP na serveri, umiestnenia adresára PHP a verzie architektúry servera. Na tomto mieste a v budúcnosti budeme na hodnoty týchto premenných upozorňovať. Namiesto nich budete musieť počas inštalácie nahradiť príslušné hodnoty pre váš server.

1 .Pripojte sa k serveru prostredníctvom SSH.

2. Skontrolujte architektúru aktuálneho servera:

uname -m
Exit
x86_64

Ako vidíme z x86_64, náš aktuálny server beží na 64-bitovej architektúre. Hodnoty v tvare i686 by naznačovali opak - 32-bitovú architektúru.

Ďalej prejdite do adresára tmp a stiahnite potrebný archív:

Pre 64-bitové systémy:

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

Pre 32-bitové systémy:

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

Po stiahnutí archívu by ste ho mali rozbaliť:

Keďže v príklade máme 64-bitovú architektúru, stiahli sme a rozbalili práve takýto archív.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Prejdite do adresára ioncube a prezrite si zoznam súborov.

cd ioncube/
ls -l

Záver

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

Ako vidíte, archív obsahuje mnoho rôznych verzií modulu pre rôzne verzie PHP. Musíme zistiť, ktoré z týchto súborov potrebujeme na ďalšiu inštaláciu.

6. Ak poznáte svoju verziu PHP (z prvého kroku), ďalším krokom je určiť umiestnenie adresára, do ktorého potrebujete nainštalovať IonCube Loader.

php -i | grep extension_dir

Výstup

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

Umiestnenie /usr/lib/php/20210902 bude potrebné v ďalšom procese inštalácie. V operačnom systéme Centos môže takýto adresár vyzerať ako /usr/lib64/php/modules.

7. Skopírujte súbory IonCube do potrebného adresára.

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

8. Teraz je potrebné vykonať úpravy konfiguračných súborov php.ini. V rôznych konfiguráciách servera môžu mať rôzne umiestnenie:

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

Na úplný začiatok súboru php.ini vložte riadok nasledujúceho typu:

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

9. Vykonajte reštart webového servera:

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. Overte správnosť inštalácie pomocou príkazu:

php -v

Ak je inštalácia úspešná, zobrazí sa nasledujúci riadok s informáciami o aktuálnej verzii IonCube:

Výstup

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

KROK 3. Pridajte server

Prejdite na panel správcu.

System Settings/Servers

Kliknite na položku Pridať nový server.

Vyplňte formulár tak, ako je na nasledujúcom obrázku.

V poli Modul nájdite: PQH

Do poľa Hostname or IP Address (Názov hostiteľa alebo IP adresa) zadajte: client.the.hosting

Potom zadajte údaje o svojom účte (prihlasovacie meno, heslo) z client.the.hosting.

A kliknite na tlačidlo pokračovať.

Potom na ďalšej stránke musíte zadať názov servera (podľa vlastného výberu) a kliknúť na tlačidlo Uložiť zmeny.

KROK 4. Správca modulu

Musíme vytvoriť nového správcu.

To je možné urobiť tak, že prejdete do časti nastavenia/správca administrátorov

Potom kliknite na Pridať nového správcu

Rola: Úplný správca

Používateľské meno (povinné!): apisystem

Zvyšné údaje sú na vás

Príklad (snímka obrazovky nižšie)

KROK 5. Ďalšie polia

Polia, ako napríklad výber operačného systému pri nákupe, môžete nakonfigurovať tak, že prejdete do časti Nastavenia/Systémové nastavenia/Nastaviteľné možnosti

Kliknite na tlačidlo Create a New Group (Vytvoriť novú skupinu) a potom nastavte názov skupiny podľa svojich predstáv.

a kliknite na tlačidlo Uložiť zmeny, potom kliknite na tlačidlo, ktoré sa zobrazí Pridať novú konfigurovateľnú možnosť.

Potom vo vyskakovacom okne zadajte do poľa Option Name (Názov možnosti): "VM Template" (Šablóna VM).

Potom pridajte hodnotu do poľa Add Options (Pridať možnosť).

Tu je zoznam všetkých podporovaných hodnôt:

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

Kliknite na Save Changes (Uložiť zmeny) na tejto karte aj na karte Configurable Option Groups (Skupiny konfigurovateľných možností).

KROK 6. Pridávanie produktov

Prejdite do časti Nastavenia/Systémové nastavenia/ Produkty,Služby

Vytvorte novú skupinu kliknutím na tlačidlo Create a New Group (Vytvoriť novú skupinu).

Potom vyplňte polia podľa vlastného uváženia

Uložte a prejdite opäť do Nastavenia/Systémové nastavenia/ Produkty,Služby.

Kliknite na Vytvoriť nový produkt
Potom (nezabudnite) vybrať
Typ produktu: Server/VPS
Modul: PQH

Zvyšok vyplňte podľa vlastného uváženia

Po uložení môžete tento produkt prispôsobiť

Na karte Podrobnosti (snímka obrazovky nižšie) môžete produkt prispôsobiť podľa svojich potrieb (Názov produktu,Slogan produktu, Krátky popis produktu, Popis produktu).

Zaškrtávacie políčko v poli Vyžadovať hodnotu domény by malo byť odškrtnuté.

Nezabudnite nastavenia produktu uložiť

Na karte Ceny (obrázok obrazovky nižšie) môžete nakonfigurovať platbu za produkt. Nezabudnite uložiť nastavenia produktu

Na karte Nastavenia modulu (snímka obrazovky nižšie)

Vyberte (povinné) Názov modulu: PQH

Potom vyberte dátové centrum a tarifu, ktoré budú zodpovedať tomuto produktu.

Nezabudnite uložiť nastavenia produktu

Na karte Custom Fields (Vlastné polia) (snímka obrazovky nižšie) MUSÍTE do poľa Field Name (Názov poľa) vložiť hodnotu "VMid".

Zvyšné karty prispôsobte podľa vlastného uváženia.

Ďalej, aby sme si zjednodušili proces pridávania produktov, môžeme ich duplikovať (snímka obrazovky nižšie).

KROK 7. Testovanie

Vytvorte používateľa, doplňte mu účet a skúste si objednať službu z testovacieho účtu. Pri objednávaní používateľom modul odovzdá všetky parametre do BILLmanageru, automaticky objedná server a po aktivácii servera na strane BILLmanageru sa služba aktivuje aj na strane WHMCS.