Fautore Installation
Fautore is designed to be dead simple without dependencies on third party databases or web servers. The greatest dependency for Fautore is born of its being written in the "PERL" programming language. Serious consideration of for creating a compiled version of fautore that will be entirely without depencies is under consideration.
Dependencies
The are a few easy to resolve dependencies for installing Fautore.
OS
The main dependency for Fautore is a PERL interpreter. An interpreter must be pre-installed as a separate step (when necessary) before installing Fautore. Perl Interpreters are available as follows:
| OS | Interpreter | Description |
|---|---|---|
| Linux | Included | Most any distribution of Linux (or any Unix for that matter) will come with the PERL interpreter pre-installed. |
| OS X | Included | All versions of OS X come pre-installed with a PERL interpreter. |
| Windows | Activestate | The Activestate PERL interpreter is hands-down the most widely used PERL interpreter available. The software is a zero cost download with Activestate making their money through the sale of PERL development tools. The Activestate interpreter uses the standard Windows MSI installation strategy like most other Windows software and is easy for even a novice to install. |
| Windows | CygWin | CygWin is more than a PERL interpreter, it is an entire application and library suite designed to provide a very Unix-like commands and general functionality to Windows. The PERL interpreter is an optional package installation of CygWin. The CygWin installation is a zero-cost, community supported download recommended only for software developers and enthusiasts who understand what they are doing on the command line. |
OS Notes
This section covers installation notes and lessons learned.
| OS | Version | Note |
|---|---|---|
| LinuxMint | 17.1 | The "build-essential" package should be installed before attempting to install the CPAN modules. Some modules are dependent on the "sys/types.h" file included in that package. |
| LinuxMint | 17.1 | The "TK" Perl module is best installed from the OS package manager (use "perl-tk")to ensure dependencies are handled well. |
| OS X | 10.7 | The fauChat tool uses the TK module which depends on X-Windows being additionally installed to the Mac. The X-Windows is only needed for the fauChat application. All the functionality of Fautore itself will run fine without the X-Windows. An X-Windows package can be installed from the Apple X-Code distribution. |
Perl Modules
There are several module PERL depends on. This list reports only those not present on a LinuxMint14+ OS installtion of Perl. Your mileage may vary depending on the perl installation you have installed. We will report additional details for other environments here as they are made available to us:
- JSON
- DBI
- Crypt::Rijndael
- Crypt::DH
- DBD::SQLite
- TK (optional fauChat support)
Installation Steps
- Download Fautore (still open only to pre-alpha developers)
- Install PERL interpreter (when necessary)
- Unpack the downloaded files using favorite archive manager
- Open a command line terminal window
- Change directory to the "install" directory under the base extraction
directory of the downloaded archive (explainIf the downloaded file was "Fautore.zip" and was extracted to "C:/fautore" on windows, then you would want to enter:
cd C:/fautore/install
to change your working directory to the correct location.
) - Type:perl install.pl
Troubleshooting
Steps taken to resolve problems encountered while installing.
| Issue | Platform | Solution |
|---|---|---|
| Error referencing "sys/types.h" when installtion Perl modules | Linux | "sudo apt-get install build-essential" will install the missing build files. "sudo apt-get install libc6-dev" will more precisely install the missing file, but could leave you open to further "missing file" build errors. |