Xenica Install Instructions

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


Note: You should have administrative(root) access to your WHMCS server. As you will need to add new packages to your WHMCS server.


1. Find the php.ini file location (You can verify the php.ini location from below command)

  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 :

  • proc_open
  • curl_exec
  • passthru

note : 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)


2. 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):

   yum install rrdtool –y
   apt-get install rrdtool
   rpm -ivh http://wiki.servarica.com/rpmforge-release-0.5.2-2.el6.rf.i686.rpm


once sucessfully installed, you’ll find rrdtool in /usr/bin/


3. Install python mysqldb (for collecting bandwidth/traffic data)

use one of the following commands (depends on your distro):

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

or

   apt-get install python-mysqldb

more information about mysqlclient-python here .


4. you can download Xenica package from servarica WHMCS download section Here ,
choose suitable version for you PHP , and upload your files manually to your whmcs machine ,
or you can follow these auto installation script instructions :

- Download the Auto Installation Script xenica3_install.sh

wget http://xenmodule.com/xenica3_install.sh


- Once Downloaded , change permission and run

chmod +x xenica3_install.sh
./xenica3_install.sh


- Once you run, it will ask for your PHP Version , (so it can automatically download the suitable ioncube encoded version of Xenica) , please enter the choice number only (1,2,3).

[root@localhost ~]# ./xenica3_install.sh
Enter your PHP version (choose number only):
1- PHP 5.6
2- PHP 5.6 - PHP 7.1
3- PHP 7.2

- then it will ask for WHMCS installation path, enter the path Then press “y” for conformation.

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


5. Set User/permissions for the newly copied files :

make sure that files in

yourWHMCS/modules/servers/Xenica
yourWHMCS/modules/addons/xenica

has the same user/permissions like any other whmcs file,
mostly the owner must be the apache default user, because it needs to write on some files,
lets assume that your normal whmcs files owner is 'apache' and your WHMCS path is /var/www/html/whmcs/:

cd /var/www/html/whmcs
chown -R apache:apache modules/servers/Xenica
chown -R apache:apache modules/addons/xenica


6. Go to WHMCS and Activate xenica addon module :

Navigate to WHMCS , Setup ⇒ Addon Modules |⇒ Xenica ⇒ Click on “Activate”
Once You click activate, Click the configure button and Assigning roles like “Full Administrator” For this add-ons.


Fig 10 : Add-On Activation



7. Visit Xenica addon (WHMCS > Addons =⇒ xenica )

You will be redirected to the Installation Wizard then complete the installation wizard from there.



.


8. There are 6 steps to complete the wizard

Fig 12 : WebInstall



Step 1. 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. —-


Fig 13 : License



Step 2: Installed PHP Versions and extensions will be verified.


Step 3: Directories and Permissions will be verified.


If the directories and permissions are not created correctly , you'll be seeing the below errors.

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

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


Step 4: Configure the Xenica module


Step 5: MySQL database and tables will be configured


Step 6: In this Step you can, add your Xenservers to the list of servers in WHMCS

You can ignore this, and add the Servers from WHMCS Menu later (Setup →Products/Services → Servers

Add a cronjob by following the below command

You can use crontab –e and add an every hour cronjob to your WHMCS server

  10 * * * * /usr/bin/php -q /var/www/html/whmcs/modules/servers/Xenica/cron/cron.php

Finally delete temporary install directory by clicking on the Delete Install Directory

Installation Completed :-)

  • xenica_install_instructions.txt
  • Last modified: 2020/01/05 23:25
  • by orwah