NAME

XTaTIK::Docs::01_Installation - Installation instructions for XTaTIK

NOTE ON OPERATING SYSTEM

All instructions below are for Debian 8.1 (Jessie) Linux. If you'd like to provide installation instructions for other operating systems, please submit a pull request.

NOTE ON PERL VERSION

XTaTIK supports the current and previous major releases of Perl. You can use Perlbrew to obtain the latest versions of Perl, if you're currently lacking one.

SOFTWARE NOT FOUND ON CPAN

Some of the software required to run XTaTIK or to compile one of the modules it uses is not available on CPAN.

PostgreSQL and Development C Libraries

You need to install PostgreSQL database, development files for it (needed by Mojo::Pg), and development files for libdb (needed by Search::Indexer).

Note: choose the appropriate version for the postgresql-server-dev-9.4 package (run aptitude search postgresql-server).

    sudo apt-get install libdb-dev postgresql postgresql-server-dev-9.4;

GEOIP DATABASE

Currently, XTaTIK only supports the Free version of IP2Location.com's database. Paid-for version will likely work just fine, but it has never been tested yet.

You will need to create a free account to download the free database files. Download IPv4 DB3.LITE .bin file (or just DB3, if you're using a paid-for version) of the Lite database.

Create a folder somewhere nice and safe. It will be your Company Silo. A place to put global config and product pics for all your sites. Save the IP2Locations in that folder.

XTaTIK CORE

Simply install package XTaTIK from CPAN. Using cpanm, it's as simple as:

    cpanm XTaTIK

WHAT'S NEXT?

Next, you should set up your Company Silo. You already saved your IP2Location file into it.

You don't really need a Company Silo, if you're going to run just a single eCommerce site. If that is the case, simply assume all Company Silo instructions refer to your Site Silo—that is, a directory with all of our site's files.

See XTaTIK::Docs::02_PreparingCompanySilo next.