Installation

From FiFormsWiki

Jump to: navigation, search

This article describes how to install and configure FiForms for your operating system

Contents

Microsoft Windows 2000/XP/Vista Installation - XAMPP Package

  • Download the XAMPP+FiForms self-extracting exe: xampplite-win32-1.6.7-FiForms-1.1.0.exe
  • Run the program. You should be prompted with a dialog that looks like the one below. Type "C:\" without quotes and press "Extract" to extract files to the root of your C: drive. This will create a new folder called C:\xampplite in the root of C:

Xamppunzip.png

  • Click Start Menu -> Run, type C:\xampplite\xampp-control.exe, and press "OK"

Xamppcontrolrun.png

  • You should see a window that looks similar to the one below. Check the "SVC" box next to Apache and MySQL to install Apache and MySQL as services that will start every time Windows starts. Alternatively, you can simply click "Start" next to Apache and MySQL, but with this method you will need to use this method to manually start these services each time before you can use FiForms software.

Xamppcontrol.png

When you start the services, you will probably be alerted by Windows Firewall to unblock the necessary ports:

Xampp6.jpg

Fiformsconfig1.png

Microsoft Windows Installation - Advanced Users

Installing The Servers

First of all, before you begin installing FiForms, you need to have a running MySQL database server and Apache webserver (or equivelant) running PHP. If you don't have these, a great way to get them all installed at once is to install XAMPP. Be sure you have this software installed before you continue.

Getting The FiForms Framework

Also, you'll have to get a copy of the FiForms Framework. You can download the latest stable FiForms Framework distribution from sourceforge.net.

Note to developers: you can Checkout FiForms from CVS using Tortoise CVS.


Setting Up The FiForms Framework

For the sake of simplicity, I'm going to assume you want to install FiForms in c:\xampp\FiForms.

If you downloaded the zip file, extract the FiForms folder to c:\xampp\FiForms. If checking out from CVS, checkout into the c:\xampp folder and it will create the FiForms folder.

Create an alias to the scripts folder in the apache configuration, so that the page http://localhost/fiforms/ will load scripts from c:\xampp\FiForms\scripts:

Navigate to C:\xampp\apache\conf and edit the file httpd.conf with a text editor such as notepad or Scintilla. Add the following lines to the bottom of the file:

Alias /fiforms/ "C:/xampp/FiForms/scripts/"
<Directory "C:/xampp/FiForms/scripts">
   AllowOverride All
   Options Includes ExecCGI Indexes
   Order allow,deny
   Allow from all
</Directory>

After modifying the file, save it and restart the Apache webserver from the Windows Service Control Module. Then continue with the configuration instructions at the bottom.

Linux Installation

Installation

Extract the contents of downloaded tarball into a directory outside the document root of your web server. For example, you could extract FiForms to "/usr/share/fiforms". Symlink the "scripts" folder from the newly extracted fiforms directory into the document root of your web server.

tar -jxvf fiforms-1.1.0.tar.bz2 -C /usr/share
ln -s /usr/share/fiforms/scripts /var/www/fiforms

Setting Permissions

If you want to use the FiForms online configuration/administration/installation functionality, your web server must be able to write to a few directories. Specifically, for configuration, the scripts directory must be writable and localconfig.php, if it exists, must be writable. For application installation, both the scrips/app/ directory and the top-level apps directory (under FiForms) must be writable by the webserver process.

Assuming that FiForms was extracted at /usr/share/fiforms, use the following commands to set the appropriate permissions:

chgrp www-data /usr/share/fiforms/apps
chmod g+w /usr/share/fiforms/apps
chgrp www-data /usr/share/fiforms/scripts
chmod g+w /usr/share/fiforms/scripts
chgrp www-data /usr/share/fiforms/scripts/temp
chmod g+w /usr/share/fiforms/scripts/temp
chgrp www-data /usr/share/fiforms/scripts/app
chmod g+w /usr/share/fiforms/scripts/app

You should also set add your user-login account (and that of any FiForms developers) to the www-data group. That way, newly created forms will be writable by the webserver and by the developer. (Note: You will still need to claim group write permissions on server created files in FiForms versions earlier than version 1.1.1)

OS X Installation

Coming Soon...

Initial Configuration

Using your web browser, navigate to the URL of the directory you created in step 2, i.e. http://localhost/fiforms/.

You should be redirected to the FiForms online configuration script, where you can enter an online administration password for future online configuration of FiForms. You may be prompted to enter the path where you installed FiForms. Enter the local path to FiForms, as

C:\xampp\FiForms

or

/usr/share/fiforms


Most of the options on the configuration screen will have reasonable default values. You will need to enter an Online Administration Password in order to use this screen to make any changes to the FiForms configuration later, or to install FiForms applications or import and export databases. Note that this password is not related to your MySQL login password, which is also required in order to connect to your database.

For a detailed explanation of all the configurable parameters on this screen, see the Configuration article.

Submit the configuration screen. This should create a new localconfig.php file in your scripts directory. Click the link to go to the main menu.

http://localhost/fiforms/

This will prompt you to login. You can login with any valid login to your MySQL Database, that is allowed in the configuration.

Install Applications (Optional)

An example application called Example Bookshelf Application is included with FiForms. In order to test this application, you will need to install the fiforms_sample database.

  • Open the Example Bookshelf Application
  • Select Maintenance Menu
  • Select Import Database File
    • You may be prompted to login again. Login with your FiForms Online Administration password.
  • In the box labeled ***Select a File*** choose fiforms_sample.sql
  • Click Install Database

Create Applications

You should now be ready to start creating FiForms XML Applications. Have fun! You may wish to have a look at the XML Applications references, as well.

You can also use the FiForms Framework PHP classes and develop applications in PHP by including FiForms objects in your PHP scripts. Please see the included examples and API Documentation, as well as the page Creating Applications in PHP

Example Applications

Take a look at the example scripts included with this distribution. This will show you how you can make some simple FiForms. Before you can use the sample scripts, you will need to set up the MySQL database FiForms_sample.

Personal tools
This is a cached copy of the requested page, and may not be up to date.

Sorry! This site is experiencing technical difficulties.
Try waiting a few minutes and reloading.

(Can't contact the database server: The server requested authentication method unknown to the client (localhost))


You can try searching via Google in the meantime.
Note that their indexes of our content may be out of date.