Differences

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

--- user:sathish [2018/05/25 08:48]
sathish created
+++ user:sathish [2018/05/28 08:37] (current)
sathish
@@ Line 1: / Line 1: @@
-XENICA INSTALL INSTRUCTIONS1
+{{: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>
+* * * * /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>