Downloading WHASOLS

To download WHASOLS:

Installing Ioncube

WHASOLS is encrypted using ionCube Loader® to protect the source code. Most hosting providers compile ionCube support into the PHP build by default.

If you need to install ionCube on your server, see our Ioncube Installation Tutorial.


Creating a Database

WHASOLS uses a MySQL database to store settings and data. You must create one during the installation process, or create one before you begin. For more information, see our System Environment Guide.


Database Privileges

WHASOLS requires the following database privileges:

  • DELETE
  • INSERT
  • SELECT
  • UPDATE
  • LOCK TABLES
  • ALTER
  • CREATE
  • DROP
  • INDEX

Installing WHASOLS

To install WHASOLS, you can use the following process:


  • Unzip the contents of the .zip file to a folder on your computer.
  • Upload the entire WHASOLS folder to your website. If you experience problems, try uploading the folder in binary mode.
  • The administration area uses an backend/admin folder. You cannot use admin as the installation folder name.
  • Navigate to the installation script at http://example.com/installer to run the installation. If you see an ionCube-related error message, perform the ionCube steps above.
  • Follow the instructions to install WHASOLS, including setting file permissions (see below), entering your license key, and setting up your primary administrator account.


Required file and folder permissions
.env CHMOD 400 Readable
/storage CHMOD 755 Writable


The directory example permissions above may be overly permissive. I.E. world read/write permission might not be necessary or appropriate for your hosting environment:


For suPHP or PHP suEXEC, you will need to restrict directories further. If you use DSO as your PHP handler, you must use 644 permissions.
Limit access to only the account that owns the web server process. Make sure that no other system or user accounts can read your configuration file or modify any WHASOLS-related files.


Installing WHASOLS In cPanel & WHM

cPanel, L.L.C. deprecated the Site Software feature in cPanel & WHM version 104. We recommend using the installation method above.

If you use cPanel & WHM, you can also install WHASOLS directly from within the interface. To do this:

Next, install WHASOLS on your server/Hosting Account, making sure that your server/Hosting Plan meets the System Requirements. You may need to consult your system administrator or hosting provider to confirm this.

The installation process is easy, and typically follows this process:

  • Upload the WHASOLS ZIP file to your server.
  • Extract the ZIP file.
  • Move the extracted WHASOLS files your desired directory location.
  • Create a new MySQL® database and assigned database user.
  • Go to the Browser and type your domain name as "https://domainname.com/installer" and run the installer process.
  • Follow the onscreen instructions.
  • When the process is complete:
  • Use the chmod command to set the ws-config.php file's permissions to 644.
Detailed installation instructions: Installation of WHASOLS

Restricting Database Privileges

If you wish, once WHASOLS is installed, you can remove certain privileges:

  • ALTER
  • CREATE
  • DROP
  • INDEX
Important
These privileges would need to be granted again when upgrading WHASOLS, and when activating and deactivating modules.


Post Installation Suggested Steps

Configuration Service: Have our team configure WHASOLS for you.

After installation, we recommend that you configure WHASOLS in the following order:

  • Log in to the Admin Area.
  • Configure the settings at Configuration > System Settings > General Settings.
  • Set up your Payment Gateways in Apps Integration > Browse Apps > Payment Gateways.
  • Add your servers to WHASOLS in Configuration > Hosting Servers.
  • Set up your products and services in Configuration > Products/Services.
  • Enter your domain registrar account details in Apps Integration > Browse Apps > Domain Registrars.
  • Configure your Domain Pricing in Configuration > Domain Pricing.
  • Set up your Support Ticket Departments in Configuration > Support Departments.
  • Set up support ticket replies via email. For steps, see Email Piping.
  • Ensure that the WHASOLS Cron Job is set up and configure the related automated tasks in Configuration > Automation Settings.
  • Place some test orders on your website to ensure WHASOLS is working as expected.
Detailed Configuration Instructions: Setup/Configuration