Differences

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

Link to this comparison view

Both sides previous revision Previous revision
xenica_install_instructions_updated [2018/05/25 10:34]
sathish old revision restored (2015/11/05 10:32)
xenica_install_instructions_updated [2018/05/25 11:42] (current)
sathish old revision restored (2018/05/25 09:16)
Line 1: Line 1:
 =====                                      XENICA INSTALL INSTRUCTIONS ​                                       ===== =====                                      XENICA INSTALL INSTRUCTIONS ​                                       =====
  
----- +
-----+
  
 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. 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.
  
----- 
 ---- ----
  
 <fc #​9400d3>​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 #​9400d3>​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 #​9400d3>​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 #​9400d3>​NOTE</​fc>:​ The php functions should be enabled in php.ini for the module to work. 
-  * proc_open 
-  * curl_exec ​ 
- 
----- 
 ---- ----
  
  
 ===== On The WHMCS Server ===== ===== On The WHMCS Server =====
----- 
----- 
  
  
-3.  Find the **php.ini** file location (You can verify the php.ini ​location from below command)+1.  Find your **php.ini** file location (You can use this 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 
 +---- 
 +2. Install **RRDTooL**
  
-      php -i | grep php.ini +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
  
-On here php.ini location is **/​etc/​php.ini**,​ Open with any Text editor+     ​apt-get install rrdtool
  
-      vi /etc/php.ini +     rpm -ivh http://wiki.servarica.com/​rpmforge-release-0.5.2-2.el6.rf.i686.rpm
  
----- 
-4.  Search with keyword **disable_functions** 
----- 
-5.  Make sure you don’t have the below functions disabled ​ 
----- 
-proc_open 
  
-curl_exec+once sucessfully installed, you’ll find rrdtool in **/​usr/​bin/​**
 ---- ----
-6. Installing **RRDTooL** 
  
-     rpm -ivh http://wiki.servarica.com/​rpmforge-release-0.5.2-2.el6.rf.i686.rpm+3. Install **python mysqldb**
  
-     yum install rrdtool –y+use one of the following commands ​ (depends on your distro): 
 +     yum -install python-pip 
 +     pip install mysqlclient
  
----- +     yum install MySQL-python
-7. once sucessfully installed, you’ll find rrdtool in **/​usr/​bin/​** +
-----+
  
-8. Download the Auto Installation Script, Download it on the same directory where you have Xenica files [[http://​wiki.servarica.com/​xenica_install.sh|xenica_install.sh]]+     ​apt-get install python-pip python-dev libmysqlclient-dev 
 +     pip install mysqlclient
  
----- 
  
-Download **locally** and upload by Winscp to WHMCS Server 
-OR  
-**Directly** Download to your WHMCS Server 
 ---- ----
  
-Execute this command on shell terminal+4. 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 ​:
  
-    wget http://wiki.servarica.com/​xenica_install.sh +  * Download the Auto Installation Script [[http://servarica.com/​xenica3_install.sh|xenica3_install.sh]] 
 +<​code>​wget http://servarica.com/​xenica3_install.sh</​code>​
  
 ----  ----
-9.  Once Downloaded , Execute the below to **change permission** and run+  *  Once Downloaded , **change permission** and **run** 
 +<​code>​chmod +x xenica3_install.sh 
 +./​xenica3_install.sh</​code>​
  
-   chmod +x xenica_install.sh+---- 
 +  * Once you run, it will ask for WHMCS installation path, enter the path Then press “y” for conformation.  
 +<​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>​ 
 + 
  
 ---- ----
-10.  Once you run, it will as for WHMCS installation path, Then press “y” for conformation. ​+5.  ​Set User/​permissions ​for the newly copied files :
  
 +make sure that files in 
 +<​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, ​
  
- [root@localhost ~]# ./​xenica_install.sh +lets assume that your normal whmcs files owner is '​apache'​ and your WHMCS path is /​var/​www/​html/​whmcs/:​ 
- Enter current ​WHMCS Path:/​var/​www/​html/​whmcs/​ +<​code>​cd ​/​var/​www/​html/​whmcs 
- You have entered WHMCS Installation current directory: /​var/​www/​html/​whmcs/​ +chown -R apache:​apache modules/servers/​Xenica 
- Are you sure?[Y/N]y +chown -R apache:​apache modules/addons/​xenica 
- Xenica Source Found..Extracting it. Wait....+</​code>​
    
 +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>​
 +
  
 ---- ----
-11.  Activate ​**addon ​modules** from WHMCS:+6.  ​go to WHMCS and Activate ​xenica ​**addon ​module** :
  
 +Navigate to WHMCS , Setup => Addon Modules |=> Xenica => Click on "​Activate"​
  
-    ​Navigate to WHMCS , Setup ==> Addon Modules |==> Servarica IP Manager ==> Click on "​Activate"​ +Once You click activate, Click the configure button and Assigning roles like "Full Administrator"​ For this add-ons. ​
-                                                 ​|==>​ Servarica Configurations ==> Click on "​Activate"​ +
-    Once You click activate, Click the configure button and Assigning roles like "Full Administrator"​ For those two add-ons. ​+
  
 ---- ----
-{{:wiki:addon.png?​direct&​1100 |}}+{{:wiki:xenica_addons.jpg?​direct&​1100 |}}
 ''​Fig 3 : Add-On Activation''​ ''​Fig 3 : Add-On Activation''​
 ---- ----
 ---- ----
-12.  Copy the below URL in your browser, Use your **public IP** or **domain name** instead of xxx (if you are working from remote+7.  Visit **Xenica addon** (WHMCS > Addons ==> xenica ​
  
-    ​http://​xxx.xxx.xxx.xxx/​whmcs/​modules/​servers/​CitrixXen/​install/​install.php+then complete the installation wizard from there.
  
 ---- ----
Line 108: Line 113:
 ---- ----
  
-13. Once you started ​the web-installation, ​On bottom ​you need to enter your License Key (By clearing the current example value). You can take you code from your client area. +8. 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
 ---- ----
  
  • xenica_install_instructions_updated.txt
  • Last modified: 2018/05/25 11:42
  • by sathish