Installation
The native Perl installation of Fautore is currently the only version available. This means there are prerequisite Perl modules that need to be installed. We are working on a compiled version that will ease installation and is expected to be available with the .05 release.
Table of contents
Preamble
1.1. Registration
1.2. Download
1.3. Unzip
1.4. Install Prerequisites
sudo cpan install JSON DBI Crypt::Rijndael Crypt::DH DBD::SQLite Tk
In cases where modules need closer attention the below command can be run for each module:
sudo perl -MCPAN -e "install {library name}"
Where {library name} is replaced by each of the below module names. For example, the first installation command would be:
sudo perl -MCPAN -e "install JSON"
Run the command once for each module:
- JSON
- DBI
- Crypt::Rijndael
- Crypt::DH
- DBD::SQLite
- Tk (optional fauChat support - not recommended for 0.5 or below)
Until a more formal and complete installation program is implemented the Perl interpreter must be informed where to find the custom modules supplied with Fautore itself. This is achieved by setting the "PERL5LIB" environment variable to the location of the libraries. Assuming the Fautore program is installed to the directory called "fautore" in the home directory of the login "fred" which is located in the standard location "/home/fred" the full path to use would be: "/home/fred/fautore"
This then is the path that should be used for the "PERL5LIB using the following command prior to running Fautore:
The command must of course reflect the path to your specific Fautore location. The environment setting can be made permanent by adding the entire export command to the /home/fred/.bashrc file.
1.5. Start
"cd {directory path}"
- Enter this command to start Fautore./fautore.pl start
1.6. Proxy Setup
Optional. (see Fautore Access Options for details)
Fautore configuration management is setup through the web browser. Depending on your needs, there are actually a couple ways to access Fautore by browser. Should you decide you use the proxy method (see Fautore Access Options for details) there is a little setup to be done first.
Any browser offering proxy support will work — which is about any browser. For this example we are using Firefox:
- Start the browser
- Access preferences
- Select "Advanced" in the top tab bar, "Network from the lower tab bar and then click "Settings"
- Fill out the "Settings form as illustrated below
- Close out of the Firefox preferences gracefully and entirely.
Troubleshooting
Some problems have cropped up with the underlying environment often enough to warrant a few troubleshooting thoughts.
Problem:
More of an inconvenience that complicates the text of troubleshooting problems when they arise. This issue manifests as a warning something like:
Explanation
The perl YAML file used to process configuration files and other data is not installed. This isn't a fatal error, but can be a distracting nuisance when troubleshooting other problems.
Action
Either use the package manage of your Linux distribution to search on and install "build-essential" or use a command line like below:
sudo perl -MCPAN -e "install YAML"
Problem:
DBI module installation fails with an error reference to:
Explanation
The DBI module needs to be compiled for system specific use. Some Linux systems are installed without the kernel headers necessary to do compilations. (files with ".h" on the end)
Action
Either use the package manager of your Linux distribution to search on and install "build-essential" or use a command line like below:
sudo apt-get install build-essential
sudo yum install build-essential