Installation

Oempro is a leading PHP based Enterprise Grade Email Marketing solution – which can be used by small and medium sized companies as well the ESP (Email Service Provider) edition can be used for large providers wanting to start their own Email Marketing Services business.

Oempro also provides a robust api which can be used to perform many backend functions to create users, campaigns, mailing lists etc. The next topic is the installation plan and we will create a check list and take a look at the pre-requisites required for the Oempro installation.

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:

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.dat 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
Point your web browser to http://yoursite.com/oempro/install/

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.

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

Installation Wizard

 

Installation Options
Fields Explained
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

Once the installation is over you will see the installation completed screen as shown in the below screenshot. Please make sure that you remove the install directory once the installation is completed.

installation_done