Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
user:sathish [2018/05/25 14:23] sathish |
user:sathish [2018/05/28 08:37] (current) sathish |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{:user:servarica.png?direct|}} | ||
+ | {{ :user:xenica.png?direct|}} | ||
<html> | <html> | ||
<head> | <head> | ||
Line 18: | Line 20: | ||
- | Please follow the below Instructions to install the Xenica Module for WHMCS. This step by step guide will walk you through the Installation of the Xenica module in your WHMCS | + | <fs medium>Please follow the below Instructions to install the Xenica Module for WHMCS. This step by step guide will walk you through the Installation of the Xenica module in your WHMCS</fs> |
---- | ---- | ||
Line 24: | Line 26: | ||
<fc #ff0000>**Note**:</fc> You should have **administrative(root)** access to your WHMCS server. As you will need to add new packages to your WHMCS server. | <fc #ff0000>**Note**:</fc> You should have **administrative(root)** access to your WHMCS server. As you will need to add new packages to your WHMCS server. | ||
- | <fc #ff0000>**Note**:</fc> The below steps exactly match with centOS 7 64 bit, For other's some minor changes will be required, But the overall process will remain same. | + | <fc #ff0000>**Note**:</fc> The below steps exactly match with centOS 6 64 bit, For other's some minor changes will be required, But the overall process will remain same. |
<fc #ff0000>**Note**:</fc> The php functions should be enabled in php.ini for the module to work. | <fc #ff0000>**Note**:</fc> The php functions should be enabled in php.ini for the module to work. | ||
Line 52: | Line 54: | ||
</html> | </html> | ||
- | 1. Find the php.ini file location (You can verify the php.ini location from below command) | + | <color #333CFF>**<fs medium>1</fs>.**</color> <fs medium>Find the php.ini file location (You can verify the php.ini location from below command)</fs> |
php -i | grep php.ini | php -i | grep php.ini | ||
- | and Open with any Text editor , Search with keyword **disable_functions** , and Make sure you don’t have the below functions disabled : | + | <fs medium>and Open with any Text editor , Search with keyword **disable_functions** , and Make sure you don’t have the below functions disabled :</fs> |
proc_open | proc_open | ||
curl_exec | curl_exec | ||
---- | ---- | ||
- | 2. Install **RRDTooL** | + | <color #333CFF>**<fs medium>2</fs>.**</color> <fs medium>Install **RRDTooL** |
if you have Cpanel then RRDTOOL is installed by default into the /usr/local/cpanel/3rdparty/bin/ folder. remember this path that you will need to Add it to Xenica configs later. | if you have Cpanel then RRDTOOL is installed by default into the /usr/local/cpanel/3rdparty/bin/ folder. remember this path that you will need to Add it to Xenica configs later. | ||
- | for installing RRDTool in clean machine use one of the following commands (depends on your distro): | + | for installing RRDTool in clean machine use one of the following commands (depends on your distro):</fs> |
yum install rrdtool –y | yum install rrdtool –y | ||
Line 79: | Line 81: | ||
---- | ---- | ||
- | once sucessfully installed, you’ll find rrdtool in **/usr/bin/** | + | <fs medium>once sucessfully installed, you’ll find rrdtool in **/usr/bin/**</fs> |
{{ :user:usrbin.png?direct |}} | {{ :user:usrbin.png?direct |}} | ||
---- | ---- | ||
- | 3. Install **python mysqldb** | + | <color #333CFF>**<fs medium>3</fs>.**</color> <fs medium>Install **python mysqldb** |
- | use one of the following commands (depends on your distro): | + | use one of the following commands (depends on your distro):</fs> |
+ | yum install python-devel mariadb-devel gcc | ||
yum -y install python-pip | yum -y install python-pip | ||
pip install mysqlclient | pip install mysqlclient | ||
+ | |||
yum install MySQL-python | yum install MySQL-python | ||
Line 94: | Line 98: | ||
apt-get install python-pip python-dev libmysqlclient-dev | apt-get install python-pip python-dev libmysqlclient-dev | ||
pip install mysqlclient | pip install mysqlclient | ||
+ | |||
+ | If you are using Mysql also use the below command | ||
+ | yum install mysql-dlevel | ||
{{ :user:python.png?direct |}} | {{ :user:python.png?direct |}} | ||
---- | ---- | ||
+ | Also please install the below php addons and restart the webserver | ||
- | 4. you can download Xenica files from servarica WHMCS download section () and upload your files manually to your whmcs machine , or you can follow these auto installation script instructions : | + | yum install php-imap php-mbstring php-soap php-xmlrpc |
+ | |||
+ | /etc/init.d/httpd graceful | ||
+ | |||
+ | ---- | ||
- | * Download the Auto Installation Script [[http://servarica.com/xenica3_install.sh|xenica3_install.sh]] | + | <color #333CFF>**<fs medium>4</fs>.**</color> <fs medium>you can download Xenica files from servarica WHMCS download section () and upload your files manually to your whmcs machine , or you can follow these auto installation script instructions : |
+ | </fs> | ||
+ | * <fs medium> Download the Auto Installation Script</fs> [[http://servarica.com/xenica3_install.sh|xenica3_install.sh]] | ||
<code>wget http://servarica.com/xenica3_install.sh</code> | <code>wget http://servarica.com/xenica3_install.sh</code> | ||
{{ :user:download.png?direct |}} | {{ :user:download.png?direct |}} | ||
---- | ---- | ||
- | * Once Downloaded , **change permission** and **run** | + | * <fs medium>Once Downloaded , **change permission** and **run**</fs> |
<code>chmod +x xenica3_install.sh | <code>chmod +x xenica3_install.sh | ||
./xenica3_install.sh</code> | ./xenica3_install.sh</code> | ||
{{ :user:execute.png?direct |}} | {{ :user:execute.png?direct |}} | ||
---- | ---- | ||
- | * Once you run, it will ask for WHMCS installation path, enter the path Then press “y” for conformation. | + | * <fs medium>Once you run, it will ask for WHMCS installation path, enter the path Then press “y” for conformation.</fs> |
<code>[root@localhost ~]# ./xenica3_install.sh | <code>[root@localhost ~]# ./xenica3_install.sh | ||
Enter current WHMCS Path:/var/www/html/whmcs/ | Enter current WHMCS Path:/var/www/html/whmcs/ | ||
Line 118: | Line 131: | ||
{{ :user:path.png?direct |}} | {{ :user:path.png?direct |}} | ||
---- | ---- | ||
- | 5. Set User/permissions for the newly copied files : | + | <color #333CFF>**<fs medium>5</fs>.**</color> <fs medium>Set User/permissions for the newly copied files :</fs> |
- | make sure that files in | + | <fs medium>make sure that files in</fs> |
<code>yourWHMCS/modules/servers/Xenica | <code>yourWHMCS/modules/servers/Xenica | ||
yourWHMCS/modules/addons/xenica</code> | yourWHMCS/modules/addons/xenica</code> | ||
has the same user/permissions like any other whmcs file, | has the same user/permissions like any other whmcs file, | ||
- | the owner must not be root , because apache needs to handle those files, | + | <fs medium>the owner must not be root , because apache needs to handle those files,</fs> |
- | lets assume that your normal whmcs files owner is 'apache' and your WHMCS path is /var/www/html/whmcs/: | + | <fs medium>lets assume that your normal whmcs files owner is 'apache' and your WHMCS path is /var/www/html/whmcs/:</fs> |
<code>cd /var/www/html/whmcs | <code>cd /var/www/html/whmcs | ||
chown -R apache:apache modules/servers/Xenica | chown -R apache:apache modules/servers/Xenica | ||
Line 140: | Line 153: | ||
---- | ---- | ||
- | 6. Go to WHMCS and Activate xenica **addon module** : | + | <color #333CFF>**<fs medium>6</fs>.**</color> <fs medium>Go to WHMCS and Activate xenica **addon module** :</fs> |
- | Navigate to WHMCS , Setup => Addon Modules |=> Xenica => Click on "Activate" | + | <fs medium>Navigate to WHMCS , Setup => Addon Modules |=> Xenica => Click on "Activate"</fs> |
{{ :user:addonmodule.png?direct |}} | {{ :user:addonmodule.png?direct |}} | ||
Once You click activate, Click the configure button and Assigning roles like "Full Administrator" For this add-ons. | Once You click activate, Click the configure button and Assigning roles like "Full Administrator" For this add-ons. | ||
Line 151: | Line 164: | ||
---- | ---- | ||
---- | ---- | ||
- | 7. Visit **Xenica addon** (WHMCS > Addons ==> xenica ) | + | <color #333CFF>**<fs medium>7</fs>.**</color> <fs medium>Visit **Xenica addon** (WHMCS > Addons ==> xenica )</fs> |
- | You will be redirected to the Installation Wizard | + | <fs medium>You will be redirected to the Installation Wizard |
- | then complete the installation wizard from there. | + | then complete the installation wizard from there.</fs> |
{{ :user:redirected.png?direct&600 |}} | {{ :user:redirected.png?direct&600 |}} | ||
---- | ---- | ||
---- | ---- | ||
- | 8. There are 6 steps to complete the Installation | + | <color #333CFF>**<fs medium>8</fs>.**</color> <fs medium>There are 6 steps to complete the Installation</fs> |
{{:wiki:webinstall.png?direct&1100 |}} | {{:wiki:webinstall.png?direct&1100 |}} | ||
Line 165: | Line 178: | ||
---- | ---- | ||
- | <color #ff7f27>**Step 1**</color>. In Step 1 you need to enter your License Key (By clearing the current example value). You can take your code from your client area in servarica.com. | + | <color #ff7f27>**Step 1**</color>. <fs medium>In Step 1 you need to enter your License Key (By clearing the current example value). You can take your code from your client area in servarica.com.</fs> |
---- | ---- | ||
{{ :user:clientarea.png?direct&600 |}} | {{ :user:clientarea.png?direct&600 |}} | ||
Line 175: | Line 188: | ||
---- | ---- | ||
- | <color #ff7f27>**Step 2**:</color> Installed **PHP Versions and extensions** will be verified. | + | <color #ff7f27>**Step 2**:</color> <fs medium>Installed **PHP Versions and extensions** will be verified.</fs> |
{{ :user:php2.png?direct |}} | {{ :user:php2.png?direct |}} | ||
---- | ---- | ||
- | <color #ff7f27>**Step 3**:</color> **Directories and Permissions** will be verified. | + | <color #ff7f27>**Step 3**:</color> <fs medium>**Directories and Permissions** will be verified.</fs> |
{{ :user:directories.png?direct |}} | {{ :user:directories.png?direct |}} | ||
---- | ---- | ||
- | If the directories and permissions are not created correctly , you'll be seeing the below errors. | + | <fs medium>If the directories and permissions are not created correctly , you'll be seeing the below errors.</fs> |
{{ :user:errors.png?direct |}} | {{ :user:errors.png?direct |}} | ||
- | use the following commands to manually create the directories and set the permissions | + | <fs medium>use the following commands to manually create the directories and set the permissions</fs> |
- | cd /your whmcs directory/modules/servers/Xenica; mkdir rrds;chmod 755 rrds;chown root:0 rrds | + | cd /your whmcs directory/modules/servers/Xenica; mkdir rrds;chmod 755 rrds |
- | cd /your whmcs directory/modules/servers/Xenica; mkdir kickstarts;chmod 755 kickstarts;chown root:0 kickstarts | + | cd /your whmcs directory/modules/servers/Xenica; mkdir kickstarts;chmod 755 kickstarts |
- | cd / your whmcs directory/modules/servers/Xenica; mkdir graphs;chmod 755 graphs;chown root:0 graphs | + | cd / your whmcs directory/modules/servers/Xenica; mkdir graphs;chmod 755 graphs |
---- | ---- | ||
- | <color #ff7f27>**Step 4**:</color> Configure the Xenica module | + | <color #ff7f27>**Step 4**:</color> <fs medium>Configure the Xenica module</fs> |
{{ :user:templates.png?direct |}} | {{ :user:templates.png?direct |}} | ||
---- | ---- | ||
- | <color #ff7f27>**Step 5**:</color> **MySQL database and tables** will be configured | + | <color #ff7f27>**Step 5**:</color> <fs medium>**MySQL database and tables** will be configured</fs> |
{{ :user:database.png?direct |}} | {{ :user:database.png?direct |}} | ||
---- | ---- | ||
- | <color #ff7f27>**Step 6**:</color> In this Step you can, **add your Xenservers** to the list of servers in WHMCS | + | <color #ff7f27>**Step 6**:</color> <fs medium>In this Step you can, **add your Xenservers** to the list of servers in WHMCS</fs> |
- | You can ignore this, and add the Servers from **WHMCS Menu** later (Setup ->Products/Services -> Servers | + | <fs medium>You can ignore this, and add the Servers from **WHMCS Menu** later (Setup ->Products/Services -> Servers</fs> |
{{ :user:servers.png?direct |}} | {{ :user:servers.png?direct |}} | ||
===== Almost done ===== | ===== Almost done ===== | ||
- | Add a cronjob by following the below command | + | <fs medium>Add a cronjob by following the below command</fs> |
- | You can use crontab –e and add an **every hour** cronjob to your WHMCS server | + | <fs medium>You can use crontab –e and add an **every hour** cronjob to your WHMCS server</fs> |
10 * * * * /usr/bin/php -q /var/www/html/whmcs/modules/servers/Xenica/cron/cron.php | 10 * * * * /usr/bin/php -q /var/www/html/whmcs/modules/servers/Xenica/cron/cron.php | ||
---- | ---- | ||
{{ :user:final.png?direct |}} | {{ :user:final.png?direct |}} | ||
- | Finally delete temporary install directory by clicking on the ''Delete Install Directory'' | + | <fs medium>Finally delete temporary install directory by clicking on the ''Delete Install Directory''</fs> |