Differences

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

--- user:sathish [2018/05/25 10:21]
sathish
+++ user:sathish [2018/05/28 08:37] (current)
sathish
@@ Line 1: / Line 1: @@
+{{:user:servarica.png?direct|}}
+{{ :user:xenica.png?direct|}}
 <html>
 <head>
@@ Line 14: / Line 16: @@
 </style>
 </head>
-<h1><bold>Xenica Install Instructions</bold> </h1>
+<h1><bold>Xenica Install Instructions</bold></h1>
 </html>
-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>
 ----
 <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
 ----
-===== On The 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
-.  Find your **php.ini** file location (You can use this command : '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>
-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
 ----
-.	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.
-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
@@ Line 45: / Line 73: @@
      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 |}}
 ----
-.	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
      pip install mysqlclient
      yum install MySQL-python
@@ Line 61: / Line 98: @@
      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
-.	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>
+{{ :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
 ./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
 Enter current WHMCS Path:/var/www/html/whmcs/
@@ Line 83: / Line 129: @@
 Xenica Source Found..Extracting it. Wait....</code>
+{{ :user:path.png?direct |}}
 ----
-.  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
 yourWHMCS/modules/addons/xenica</code>
 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
 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 |}}
 ----
-.  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.
 ----
-{{:wiki:xenica_addons.jpg?direct&1100 |}}
+{{ :user:configure.png?direct |}}
-''Fig 3 : Add-On Activation''
+''Fig 10 : Add-On Activation''
 ----
 ----
-.	 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 |}}
-''Fig 4 : WebInstall ''
+''Fig 12 : WebInstall ''
 ----
 ----
-. 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>
+* * * * /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>