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 10:53] 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 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 |
- | ---- | ||
- | 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 72: | Line 73: | ||
rpm -ivh http://wiki.servarica.com/rpmforge-release-0.5.2-2.el6.rf.i686.rpm | rpm -ivh http://wiki.servarica.com/rpmforge-release-0.5.2-2.el6.rf.i686.rpm | ||
- | {{:user:rrd.png?direct&600 |}} | ||
+ | ---- | ||
+ | |||
+ | {{ :user:rrdtool.png?direct |}} | ||
+ | |||
+ | |||
+ | ---- | ||
+ | |||
+ | <fs medium>once sucessfully installed, you’ll find rrdtool in **/usr/bin/**</fs> | ||
- | once sucessfully installed, you’ll find rrdtool in **/usr/bin/** | + | {{ :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 88: | 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 |}} | ||
+ | ---- | ||
+ | Also please install the below php addons and restart the webserver | ||
+ | yum install php-imap php-mbstring php-soap php-xmlrpc | ||
- | ---- | + | /etc/init.d/httpd graceful |
- | 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 : | + | ---- |
- | * 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 |}} | ||
---- | ---- | ||
- | * 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 |}} | ||
---- | ---- | ||
- | * 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 110: | Line 129: | ||
Xenica Source Found..Extracting it. Wait....</code> | Xenica Source Found..Extracting it. Wait....</code> | ||
+ | {{ :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 | ||
chown -R apache:apache modules/addons/xenica | chown -R apache:apache modules/addons/xenica | ||
</code> | </code> | ||
- | + | {{ :user:permission.png?direct |}} | |
rrds,kickstarts and graphs folders need to be writable by apache , | rrds,kickstarts and graphs folders need to be writable by apache , | ||
<code>chmod -R 755 modules/servers/Xenica/rrds | <code>chmod -R 755 modules/servers/Xenica/rrds | ||
chmod -R 755 modules/servers/Xenica/kickstarts | chmod -R 755 modules/servers/Xenica/kickstarts | ||
chmod -R 755 modules/servers/Xenica/graphs </code> | chmod -R 755 modules/servers/Xenica/graphs </code> | ||
+ | {{ :user:chmod.png?direct |}} | ||
---- | ---- | ||
- | 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 |}} | ||
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. | ||
---- | ---- | ||
- | {{:wiki:xenica_addons.jpg?direct&1100 |}} | + | {{ :user:configure.png?direct |}} |
- | ''Fig 3 : Add-On Activation'' | + | ''Fig 10 : Add-On Activation'' |
---- | ---- | ||
---- | ---- | ||
- | 7. Visit **Xenica addon** (WHMCS > Addons ==> xenica ) | + | <color #333CFF>**<fs medium>7</fs>.**</color> <fs medium>Visit **Xenica addon** (WHMCS > Addons ==> xenica )</fs> |
- | + | ||
- | then complete the installation wizard from there. | + | |
+ | <fs medium>You will be redirected to the Installation Wizard | ||
+ | then complete the installation wizard from there.</fs> | ||
+ | {{ :user:redirected.png?direct&600 |}} | ||
---- | ---- | ||
---- | ---- | ||
+ | <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 |}} | ||
- | ''Fig 4 : WebInstall '' | + | ''Fig 12 : WebInstall '' |
---- | ---- | ||
---- | ---- | ||
- | 8. Once you redirected to the web-installation wizard, 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 |}} | ||
---- | ---- | ||
+ | ''Fig 13 : License'' | ||
---- | ---- | ||
- | {{:wiki:code.png?direct&1100 |}} | + | {{ :user:license.png?direct |}} |
- | ''Fig 5 : License'' | + | |
---- | ---- | ||
+ | <color #ff7f27>**Step 2**:</color> <fs medium>Installed **PHP Versions and extensions** will be verified.</fs> | ||
+ | {{ :user:php2.png?direct |}} | ||
+ | ---- | ||
+ | <color #ff7f27>**Step 3**:</color> <fs medium>**Directories and Permissions** will be verified.</fs> | ||
+ | {{ :user:directories.png?direct |}} | ||
+ | ---- | ||
+ | <fs medium>If the directories and permissions are not created correctly , you'll be seeing the below errors.</fs> | ||
+ | {{ :user:errors.png?direct |}} | ||
- | ===== Almost Done, Just follow the on screen instructions to complete it :) ===== | + | <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 | ||
+ | cd /your whmcs directory/modules/servers/Xenica; mkdir kickstarts;chmod 755 kickstarts | ||
+ | cd / your whmcs directory/modules/servers/Xenica; mkdir graphs;chmod 755 graphs | ||
+ | |||
+ | |||
+ | ---- | ||
+ | <color #ff7f27>**Step 4**:</color> <fs medium>Configure the Xenica module</fs> | ||
+ | {{ :user:templates.png?direct |}} | ||
+ | |||
+ | ---- | ||
+ | <color #ff7f27>**Step 5**:</color> <fs medium>**MySQL database and tables** will be configured</fs> | ||
+ | {{ :user:database.png?direct |}} | ||
+ | ---- | ||
+ | <color #ff7f27>**Step 6**:</color> <fs medium>In this Step you can, **add your Xenservers** to the list of servers in WHMCS</fs> | ||
+ | |||
+ | <fs medium>You can ignore this, and add the Servers from **WHMCS Menu** later (Setup ->Products/Services -> Servers</fs> | ||
+ | {{ :user:servers.png?direct |}} | ||
+ | ===== Almost done ===== | ||
+ | |||
+ | <fs medium>Add a cronjob by following the below command</fs> | ||
+ | |||
+ | <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 | ||
+ | |||
+ | ---- | ||
+ | {{ :user:final.png?direct |}} | ||
+ | <fs medium>Finally delete temporary install directory by clicking on the ''Delete Install Directory''</fs> | ||
+ | |||
+ | |||
+ | <html> | ||
+ | <head> | ||
+ | <style> | ||
+ | h1 { | ||
+ | color: #3498DB; | ||
+ | text-align: center; | ||
+ | font-weight:bold; | ||
+ | } | ||
+ | |||
+ | h1 { | ||
+ | font-family: Arial; | ||
+ | font-size: 40px; | ||
+ | } | ||
+ | </style> | ||
+ | </head> | ||
+ | <h1><bold>Installation Completed :-)</bold></h1> | ||
+ | </html> |