user:sathish [Xenmodule Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{:user:servarica.png?direct|}}
{{ :user:xenica.png?direct|}}
<html>
<head>
<style>
h1 {
    color: #3498DB;
    text-align: center;
     font-weight:bold;
}

h1 {
    font-family: Arial;
    font-size: 40px;
}
</style>
</head>
<h1><bold>Xenica Install Instructions</bold></h1>
</html>


<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> 

----

<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 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.

  * proc_open
  * curl_exec

----


<html>
<head>
<style>
h2 {
    color: #3498DB;
    text-align: left;
     font-weight:bold;
}

h2 {
    font-family: Arial;
    font-size: 30px;
}
</style>
</head>
<h2><bold>On the WHMCS Server</bold></h2>
</html>

<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 


<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
curl_exec
----
<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.

for installing RRDTool in clean machine use one of the following commands  (depends on your distro):</fs>
     yum install rrdtool –y

     apt-get install rrdtool

     rpm -ivh http://wiki.servarica.com/rpmforge-release-0.5.2-2.el6.rf.i686.rpm

----
 
{{ :user:rrdtool.png?direct |}}


----

<fs medium>once sucessfully installed, you’ll find rrdtool in **/usr/bin/**</fs>

{{ :user:usrbin.png?direct |}}
----

<color #333CFF>**<fs medium>3</fs>.**</color>	<fs medium>Install **python mysqldb**

use one of the following commands  (depends on your distro):</fs>
     yum install python-devel mariadb-devel gcc
     yum -y install python-pip
     pip install mysqlclient


     yum install MySQL-python

     apt-get install python-pip python-dev libmysqlclient-dev
     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

----

<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>	
{{ :user:download.png?direct |}}
----				
  * 	 <fs medium>Once Downloaded , **change permission** and **run**</fs>
<code>chmod +x xenica3_install.sh
./xenica3_install.sh</code>
{{ :user:execute.png?direct |}}
----
  * 	 <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
Enter current WHMCS Path:/var/www/html/whmcs/
You have entered WHMCS Installation current directory: /var/www/html/whmcs/
Are you sure?[Y/N]y
Xenica Source Found..Extracting it. Wait....</code>
 
{{ :user:path.png?direct |}}
----
<color #333CFF>**<fs medium>5</fs>.**</color>  <fs medium>Set User/permissions for the newly copied files :</fs>

<fs medium>make sure that files in</fs> 
<code>yourWHMCS/modules/servers/Xenica
yourWHMCS/modules/addons/xenica</code>
has the same user/permissions like any other whmcs file,
 
<fs medium>the owner must not be root , because apache needs to handle those files,</fs> 

<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
chown -R apache:apache modules/servers/Xenica
chown -R apache:apache modules/addons/xenica
</code>
{{ :user:permission.png?direct |}} 
rrds,kickstarts and graphs  folders need to be writable by apache , 
<code>chmod -R 755 modules/servers/Xenica/rrds 
chmod -R 755 modules/servers/Xenica/kickstarts 
chmod -R 755 modules/servers/Xenica/graphs </code>
{{ :user:chmod.png?direct |}}

----
<color #333CFF>**<fs medium>6</fs>.**</color>  <fs medium>Go to WHMCS and Activate xenica **addon module** :</fs>

<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. 

----
{{ :user:configure.png?direct |}}
''Fig 10 : Add-On Activation''
----
----
<color #333CFF>**<fs medium>7</fs>.**</color> <fs medium>Visit **Xenica addon** (WHMCS > Addons ==> xenica )</fs> 

<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 |}}
''Fig 12 : WebInstall ''
----
----

<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''
----
{{ :user:license.png?direct |}}

----
<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 |}}

<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>