Escolar Documentos
Profissional Documentos
Cultura Documentos
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
arpReach
Basic Overview
arpReach can be installed by anyone. It does require Note: we recommend that your web hosting
a basic understanding of how to modify and upload environment uses the Apache web server and not
files as well as an understanding of how to make Nginx. While we love Nginx it requires specialist
changes and adjustments to your website hosting configuration depending on the server modules used.
using either a hosting control panel or command line
interface.
Note about case sensitivity
This guide outlines the basic installation principles.
arpReach requires the following server modules and Make a note of the following settings of the new
settings database:
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved Page 2
arpReach
Open the file: /application/config/config.php
The installation wizard will step you through the
Around line 385, search for: process. Any errors will be explained and solutions
$config['sess_save_path'] = NULL; suggested.
or
On your web site, create a directory where you want
to install the software. Alternatively create a sub- <sd>.example.com/a.php
domain. Using FTP software, upload the contents of
your temporary directory to the directory you Running the software for the first time creates a new
created on your web site. administrator whose sign in details are
...where <sd> is the sub-domain you created. Your software is now activated.
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved 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
arpReach
Create the scheduled task At the same time set the “default” or “catch-all”
address of your domain to forward unrouted email to
this account.
The software requires one scheduled (cron on
Linux) task to be created in your domain’s control The software will monitor this account for emailed
panel. We recommend running it every 3 or 5 subscriptions and bounces. To set this up...
minutes.
In the software, visit the Setup / System Settings
The scheduled task takes care of many operations of screen. Go into the System tab and open the Incoming
the software including sending due email, and email section.
managing incoming subscriptions and bounces.
Enter the details for the email account you created to
Your host can advise on how scheduled tasks should handle incoming email.
be set up on your hosting.
Now, each time the scheduled task runs, all of the
The scheduled task should NOT be set up using email in the email account will be read, processed and
wget or any other HTTP or web based process as deleted.
timeouts will be a problem.
php /path/to/public_html/<dir>/a.php cli/auto>/ arpReach is now installed and ready for use.
dev/null 2>&1
Note that this is a single command but is split here by the page Test mode
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
Test mode allows you to use all aspects of the
about setting cron jobs software without any email actually being sent
although the software will act as if it has sent it.
Handing incoming email To enable test mode, visit Setup / System Settings, go
to the Sending tab and open the Email section
The software needs to be able to handle incoming There you can enable or disable test mode.
email to manage emailed subscriptions,
unsubscriptions and bounces.
Help, training and support
The best way to handle this is to create an email
account on your domain for the exclusive use of the
software. Check out the Help menu in the software for
extensive documentation and support resources.
You can usually do this in your hosting control
panel. Thank you for choosing arpReach
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved Page 5
arpReach
Useful Links
http://arpreach.com
http://arpreach.com/install
http://arpreach.com/upgrade
http://hub.arpreach.net
Support
arpReach support
http://support.arpreach.com
arpReach Blog
http://blog.arpreach.com
Version 1.6.2 Copyright 2016 – Mutual Advantage Ltd – All rights Reserved Page 6