arpReach

Installation Guide

Version 1.6
September 2017
 arpReach
Contents
Basic Overview ........................................................2
Professional installation services .............................. 2
System Requirements ...............................................2
Note about case sensitivity .......................................2
Create your MySQL database ..................................2
Getting ready to install arpReach ............................. 2
Upload the files.........................................................3
Run the installation wizard .......................................3
Run the software .......................................................3
Activate your software .............................................3
Create the scheduled task .........................................5
Handing incoming email ..........................................5
Installation is complete .............................................5
Test mode .................................................................5
Help, training and support ........................................5
Useful Links ............................................................. 6

Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved Page 1

Basic Overview
arpReach can be installed by anyone. It does require
a basic understanding of how to modify and upload
files as well as an understanding of how to make
changes and adjustments to your website hosting
using either a hosting control panel or command line
interface.
This guide outlines the basic installation principles.
Professional installation services
Professional installation, upgrade and domain or
web host migration services are available from our
partners
http://arpreach.com/install
System Requirements
arpReach requires the following server modules and
settings
- register_globals OFF
- safe_mode OFF
- max_execution_time = 0
- cgi.fix_pathinfo = 1 (for CGI/FastCGI)
- php-cli module - (PHP 5.5 or greater is needed at
the command line)
- imap extension
- mysql extension
- cURL extension
- GD extension
- JSON extension
- Open SSL extension
- Ports 25, 587 and 465 (SSL/TLS) need to be open
for inbound and outbound traffic when using third-
party ESP's
- We recommend at least 256M of memory is
allocated to PHP, but you may need to set it higher
depending on how large your list is. The memory
MUST be applied to both http PHP AND php-cli
which is used for cron tasks.
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved
arpReach
Note: we recommend that your web hosting
environment uses the Apache web server and not
Nginx. While we love Nginx it requires specialist
configuration depending on the server modules used.
Note about case sensitivity
Directory and file names on a Linux server are case
sensitive. So, for example, the directory mail is
different from MAIL. On a Windows server, they are
the same directory.
Create your MySQL database
The software requires one MySQL database which
you need to create manually using the method
supplied by your web hosting provider.
Make a note of the following settings of the new
database:
host
database name
user name
password
Getting ready to install arpReach
Unzip the issue ZIP file to a temporary directory on
your local computer preserving the directory
structure.
Open the file config.inc.php,
Enter the config settings shown and save the file. The
database settings are those you used when creating
the MySQL database.
Now rename the file to config.php.
Page 2

Open the file: /application/config/config.php
Around line 385, search for:
$config['sess_save_path'] = NULL;
Change 'NULL' to either '/tmp' or the temporary
PHP folder for your server.
The line should now read:
$config['sess_save_path'] = /tmp;
Save this file
Upload the files
On your web site, create a directory where you want
to install the software. Alternatively create a sub-
domain. Using FTP software, upload the contents of
your temporary directory to the directory you
created on your web site.
Note: Files must be uploaded in Binary mode
The following directories need to be writable (Linux
chmod 777) by the web process. Use your FTP
software to set this.
schedule_logs
schedule_errors
temp
Run the installation wizard
In your browser, run the installation wizard using
example.com/<dir>/install/index.php
...where <dir> is the directory you created for the
software. If you opted to create a sub-domain, the
format will be
<sd>.example.com/install/index.php
...where <sd> is the sub-domain you created.
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved
arpReach
The installation wizard will step you through the
process. Any errors will be explained and solutions
suggested.
Run the software
When installation is complete, you can run the
software for the first time by visiting
example.com/<dir>/a.php
or
<sd>.example.com/a.php
Running the software for the first time creates a new
administrator whose sign in details are
Sign in name: admin
Password: 12345
You should change these settings as soon as you can
by visiting the Setup / Personal Settings menu option.
Here you can also set other options to personalize
your session.
Activate your software
If you need to activate your software, you will be
taken to the activation screen when you sign in or you
can visit Setup / Activate License.
Enter the license number, license password and
activation code you have been given.
Note: you must use the exact domain name you see in
your installation within the hub to get your key. This
may or may not include www.
Then check the box to agree to the terms of use and
click Activate Now.
Your software is now activated.
Page 3
 arpReach
At any time, you can obtain an activation code for
your software from the arpReach hub

http://hub.arpreach.net

Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved Page 4

Create the scheduled task
The software requires one scheduled (cron on
Linux) task to be created in your domain’s control
panel. We recommend running it every 3 or 5
minutes.
The scheduled task takes care of many operations of
the software including sending due email, and
managing incoming subscriptions and bounces.
Your host can advise on how scheduled tasks should
be set up on your hosting.
The scheduled task should NOT be set up using
wget or any other HTTP or web based process as
timeouts will be a problem.
It must be set up by running the script directly using
“command line” PHP like this
php /path/to/public_html/<dir>/a.php cli/auto>/
dev/null 2>&1
Note that this is a single command but is split here by the page
formatting. On a CPanel server, php would usually be php-cli.
It is important to note that the above is an example and may not
be correct for your server. As such we encourage you to seek
the assistance of your hosting company if you are in any doubt
about setting cron jobs
Handing incoming email
The software needs to be able to handle incoming
email to manage emailed subscriptions,
unsubscriptions and bounces.
The best way to handle this is to create an email
account on your domain for the exclusive use of the
software.
You can usually do this in your hosting control
panel.
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved
arpReach
At the same time set the “default” or “catch-all”
address of your domain to forward unrouted email to
this account.
The software will monitor this account for emailed
subscriptions and bounces. To set this up...
In the software, visit the Setup / System Settings
screen. Go into the System tab and open the Incoming
email section.
Enter the details for the email account you created to
handle incoming email.
Now, each time the scheduled task runs, all of the
email in the email account will be read, processed and
deleted.
Installation is complete
arpReach is now installed and ready for use.
Test mode
Test mode allows you to use all aspects of the
software without any email actually being sent
although the software will act as if it has sent it.
To enable test mode, visit Setup / System Settings, go
to the Sending tab and open the Email section
There you can enable or disable test mode.
Help, training and support
Check out the Help menu in the software for
extensive documentation and support resources.
Thank you for choosing arpReach
Page 5
 arpReach
Useful Links

Main web site

arpReach web site

http://arpreach.com

Installation and upgrade

Professional installation services

http://arpreach.com/install

Professional ARP3 upgrade services

http://arpreach.com/upgrade

Downloads and resources

arpReach Hub for downloads and resources

http://hub.arpreach.net

Support
arpReach support

http://support.arpreach.com

Blog & Additional Training

arpReach Blog

http://blog.arpreach.com

Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved Page 6