Support and Documentation


Important!
This documentation has been deprecated. We are migrating Oempro help articles to our new help portal. Take a look at more detailed help articles on our new help portal.

Sections:

  1. Check Server Settings
  2. Download The Oempro Package From The Client Area
  3. Unzip The Oempro Package
  4. Upload Oempro Files To Your Server
  5. Setup Directory And File Permissions
  6. Prepare The MySQL Database
  7. Run The Web Based Installation Utility

Installation Plan

These steps should be followed to install Oempro on your server:

  1. Check server settings
  2. Download the Oempro package from the client area
  3. Download the license key from the client area (license.dat)
  4. Unzip the Oempro package
  5. Upload Oempro files to your server
  6. Setup directory and file permissions
  7. Prepare the MySQL database
  8. Run the web based installation utility

Check Server Settings

Be sure that your server meets the listed server requirements.

If you are not sure about your server settings, feel free to get in touch with our support team. Please visit the client area and click "Open Support Ticket" link on the left menu.

If some components are missing or there's an incompatibility with your server settings, you may contact your server administrator and request assistance.

Download The Oempro Package From The Client Area

After your purchase gets completed, you will receive an order confirmation email from us. This email contains link to your client area and username/password information to login.

Once you are logged into the client area, you can download your purchased products with a single click.

If you have forgotten (or don't know) your client area login information, simply click "Forgot Password" link on the client area login screen and enter the email address you have submitted while purchasing.

Here's a screen shot of the client area welcome page which allows you to download purchased products with a single-click:

Downloading Oempro In The Client Area

Unzip The Oempro Package

All packages are available for download in ZIP format in the client area. You will need unzip application to unzip the downloaded package.

Most recent operating systems (Mac OS X, Windows, Linux, etc.) comes with a built-in unzip tool.

  • Create a directory on your computer and move the downloaded ZIP file inside this directory
  • Unzip the ZIP package inside the directory

Upload Oempro Files To Your Server

Now, you need to decide where to install Oempro on your web site. It can be one of the following:

  • sub-directory (http://yoursite.com/oempro/)
  • root directory (http://yoursite.com/)
  • sub-domain (http://oempro.yoursite.com/)

Once you decide the location, open your FTP client and upload all Oempro files and directories to the location on your server. This process may take a while depending on your internet connection speed.

Upload the license.key to your [install_path]/data directory.

Setup Directory And File Permissions

Once upload process is completed, you will need to change file and directory permissions for the following:

  • [install_path]/data (including all directories and files inside this directory)

This can be done via your FTP client by setting up directory and file permissions to 0777. If you prefer SSH, just execute the following command on your SSH Terminal:

chmod -R 0777 /path/to/oempro/data

Prepare The MySQL Database

Oempro needs a MySQL database to store its data such as users, campaigns and subscribers. You can either use your existing MySQL database or create a dedicated MySQL database for Oempro on your server.

Oempro database tables are prefixed with "oempro_". Therefore, there will be no chance to conflict with any other existing table in your database.

Oempro is not compatible with STRICT_MODE MySQL configuration. This option is disabled by default on MySQL servers but it might have been enabled for your server. If it is enabled, simply contact your server administrator or edit MySQL configuration file to remove STRICT_MODE from sql_mode parameter in MySQL configuration file

Run The Web Based Installation Utility

It's assumed that Oempro is being installed on http://yourdomain.com/oempro/ address. Please change it according to your own uploaded directory and URL.

Point your web browser to http://yoursite.com/oempro/install/

Following screen shots show the installation progress. It will take only a minute if you have configured your server properly before installation:

Oempro Installation Utility

In the above screen you will see License details such as type, users, expiry date etc and some other fields to fill in.

Application Path
Type the path where Oempro is uploaded – the full path must be entered. Be sure that there's no ending slash. Example: /home/octeth/www/oempro
Application URL
Type the URL of your Oempro. Be sure that there's no ending slash. Example: http://www.domain.com/oempro
MySQL Host
Type in the host name (or IP address) of your MySQL server if it is different than "localhost"
MySQL Username
Type in the username which is used to access MySQL Database
MySQL Password
Type in the password for the MySQL username you entered
MySQL Database
Type in the name of the MySQL Database you are going to use for Oempro
Name
Type in the name of the person who will be administrating the whole system
Email Address
Type in the valid Email address
Username
Type in the preferred administrative username
Password
Type in the preferred password for the administrative username

After filling in the requested information and submitting the form, Oempro will setup the database tables, configuration files and complete the installation.

If any error occurs during the installation, you will be redirected to the same page with an error message.

If installation gets completed without any error, you will be redirected to the success screen which includes your login information.

WARNING: Once installation of Oempro is completed, please delete or rename the "install" directory.

Congratulations! Installation is now completed. Oempro is ready to run. You will now need to login to administration area and setup the system based on your needs.

Click here to read more about setting up your Oempro.