Differences

This shows you the differences between two versions of the page.

--- xenica_install_instructions [2018/05/19 12:42]
5.155.173.110 [ON THE WHMCS SERVER :]
+++ xenica_install_instructions [2023/06/17 12:04] (current)
orwah
@@ Line 1: / Line 1: @@
-====== Xenica install instructions ======
+{{:user:servarica.png?direct|}}
+{{ :user:xenica.png?direct|}}
+<html>
+<head>
+<style>
+h1 {
+    color: #3498DB;
+    text-align: center;
+     font-weight:bold;
+}
-The following is a technical how-to to install the Xenica Module for WHMCS. This step by step guide will walk you through modifying your WHMCS install.
+h1 {
+    font-family: Arial;
+    font-size: 40px;
+}
+</style>
+</head>
+<h1><bold>Xenica Install Instructions</bold></h1>
+</html>
-NOTE : You should have administrative(root) access to your WHMCS server. As you will need to add new packages to your WHMCS server.
-NOTE: The php functions should be enabled in php.ini for the module to work.
+<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 |}}
-==== ON THE WHMCS SERVER :====
+----
+<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>
-=> Install rrdtool package (cpanel servers have it already installed)
+{{ :user:path.png?direct |}}
+----
+<color #333CFF>**<fs medium>5</fs>.**</color>  <fs medium>Set User/permissions for the newly copied files :</fs>
-=> Download the Script : [[http://servarica.com/xenica3_install.sh|xenica_install.sh]]
+<fs medium>make sure that files in</fs>
-Download **locally** and upload by Winscp to WHMCS Server
+<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>
-OR **Directly** Download to your WHMCS Server:
+<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 |}}
-    wget http://servarica.com/xenica3_install.sh
+----
+<color #333CFF>**<fs medium>6</fs>.**</color>  <fs medium>Go to WHMCS and Activate xenica **addon module** :</fs>
-=> Once Downloaded , Execute it.
+<fs medium>Navigate to WHMCS , Setup => Addon Modules |=> Xenica => Click on "Activate"</fs>
-  chmod +x xenica_install.sh
+{{ :user:addonmodule.png?direct |}}
-  ./xenica_install.sh
+Once You click activate, Click the configure button and Assigning roles like "Full Administrator" For this add-ons.
-=> then proceed and Enter current WHMCS Path, example: /var/www/html/whmcs
+----
+{{ :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>
-=> **NOTE**
+{{:wiki:webinstall.png?direct&1100 |}}
-after finish you must Activate xenica modules in WHMCS menu:
+''Fig 12 : WebInstall ''
-(Setup > Addon Modules > Xenica. press 'Activate' button, then 'configure' button to allow access).:
+----
+----
-=> then Visit Xinica module from WHMCS menu: (Addons > Xenica) , and complette the installation wizard from there .
+<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>
+* * * * /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>
-  * its very helpful to follow <fs large>[[Xenica_install_instructions_updated|Xenica Install Instructions - Step by Step]]</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>