Installation WHMCS

Installing Ioncube

WHMCS is encrypted using the Ioncube system. There are therefore two ways to use WHMCS. You can use the runtime decoders or you can install the Ioncube decoders into php directly. The first way is simplest as all you have to do is upload the ioncube folder from the Ioncube download in our client area to your WHMCS directory but it doesn't always work. So the second is slightly more difficult, but more commonly successful, and here is a tutorial on how to do it.

You WILL require root access to the server in order to do this.

Download the latest loaders to your computer from�http://www.ioncube.com/loaders.php

Extract the contents of the archived file on your local PC to a folder of your choice.

Upload the folder IONCUBE via FTP to your domain webspace

Now establish an SSH connection with server using a suitable client (e.g. Putty for PC's or Terminal on Mac). This is usually done using the command: SSH rootusername@yourserver.com (you will then be asked for your password).

You will need to browse to the public folder where you uploaded the IONCUBE directory (search internet for change and view directory commands in Unix).

Move the ioncube folder to a permanent location by entering: mv ioncube /usr/local

Next, you need to locate the php.ini file, to do this enter: locate php.ini - You should find it is in /usr/local/lib/php.ini. Now that you know the location of php.ini you need to edit it. pico /usr/local/lib/php.ini

Now find where other zend extentions are in the file: ctrl + w: zend_extension

Paste in your new line for ioncube loader: zend_extension = /usr/local/ioncube/ioncube_loader_lin_x.so (Replace x with your version of PHP eg. 4.4)

Save the changes: ctrl + X then Y and enter

Restart the web server to take effect: /etc/init.d/httpd restart

That's it! Ioncube is now installed on your server! You should now see a section in your PHP Info page that says:

Additional Modules
Module Name ionCube Loader

Installing WHMCS

Installing WHMCS is very simple. The following steps will guide you through the process:

Unzip the contents of the zip file to a folder on your computer

Rename the file configuration.php.new to configuration.php

Upload the entire whmcs folder to your website - if you experience problems, try uploading in binary mode

Next you can rename the folder to whatever you like (billing, clients, etc...)

Now visit the installation script at�http://www.yourdomain.com/whmcs/install/install.php to run the installer process - if you get an Ioncube related error message, see the installation Ioncube steps above

Follow the instructions on screen to install which will involve setting file permissions as listed below, entering your license key and setting up your primary admin account

When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644.

Required file & folders permissions (unless your php is suPHP or PHPSuExec):

/configuration.php          CHMOD 777 Writeable
/attachments                CHMOD 777 Writeable
/downloads                  CHMOD 777 Writeable
/templates_c                CHMOD 777 Writeable

Post Installation Suggested Steps

After installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:

Setup your Payment Gateways (Setup >�Payment Gateways)

Setup your Products & Services (Setup >�Products/Services)

Configure your Domain Pricing (Setup >�Domain Pricing)

Setup your Support Ticket Departments (Setup >�Support Departments)

Setup email piping so you can manage tickets using the WHMCS Support Desk - for full instructions on this please see the�Email Piping article

Ensure the WHMCS Cron Job is setup and configure automated tasks (Setup >�Automation Settings)

Place some test orders on your website to check everything works as expected

For furthur guidance, you can watch video tutorials we have prepared for the above tasks @www.whmcs.com/tutorials.php