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/26 10:39] sathish |
user:sathish [2018/05/28 08:37] (current) sathish |
||
|---|---|---|---|
| Line 20: | 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 26: | 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 54: | 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 81: | 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 96: | 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 120: | 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 142: | 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 153: | 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 167: | 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 177: | 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> |