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

----


<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 #22b14c>**note :**</color> you will need php-xmlrpc for your whmcs , so you must install it if not installed (package name will differ depending on the version of PHP , maybe php7.0-xmlrpc or php5-xmlrpc or .., you can install it easily via yum or apt)

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

__CentOS :__
     yum install gcc python-devel mysql-devel python-pip
     pip install mysqlclient

or
     yum install MySQL-python




__Debian/Ubuntu :__
     apt-get install python-dev libmysqlclient-dev python-pip
     pip install mysqlclient


more information about mysqlclient-python [[https://github.com/PyMySQL/mysqlclient-python|here]] .


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

<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> [[https://clients.servarica.com/dl.php?type=d&id=62|xenica3_install.sh]]
<code>wget https://clients.servarica.com/xenica3.2_install.sh</code>	
{{ :user:download.png?direct |}}
----				
  * 	 <fs medium>Once Downloaded , **change permission** and **run**</fs>
<code>chmod +x xenica3.2_install.sh
./xenica3.2_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 |}} 


----
<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>rrds,kickstarts and graphs  folders need to be writable by apache , you may check the parent folder owner to make sure that its apache user (and is not root , that apache can't write to root folders) , after changing the owner user try again with the installer, it must complete now.
 

in special cases if you still get errors, and need to fix this later, you can manually create the directories as described below, but its better to find the problem cause first, because even if you create directories manually you may face related issues later :</fs>

   cd /your whmcs directory/modules/servers/Xenica 
   mkdir rrds;chmod 755 rrds 
   mkdir kickstarts;chmod 755 kickstarts
   mkdir graphs;chmod 755 graphs

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

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