• (Looking for how to install panFora on Windows or Apple OS X systems?
  Click here)
  
  
• Note: Please read the following instructions for installing panFora on Unix systems carefully, and follow the installation steps sequentially.
  
  

1. Installation Requirements
   
   
2. Before You Begin
   
   
   1. FYI
      
      
   2. Gathering Information and Privileges
      
      
3. panFora Installation
   
   
   1. Downloading panFora Distribution
      
      
   2. Installinging panFora Files
      
      
   3. Web Server Configuration
   
   
4. panFora Setup
   
   
5. Create New Forum

Please review the following assumptions, requirements, and expectations for installing the panFora software with Unix operating systems and Apache web server software.

1. System Requirements:
   
   You will need the following (in addition to Operating System and Apache software requirements):
   
   
   1. Linux 2.0+ or Solaris 7+ or FreeBSD 3.5+ or OpenBSD 2.8+
      
      
   2. PERL (version 5.004 or greater)
      
      
   3. 30 MB disk space (minimum) + storage for forum content
      
      
   4. 32 MB RAM (or greater)
      
      
2. Assumptions
   
   It is assumed that you have:
   
   
   1. operating system and PERL correctly installed on your server.
      
      
   2. Apache web server installed, configured and working correctly.
      
      
   3. system administrator [root] account access to modify Apache server configuration (as needed) and create/write to web document directories.
      
      
3. Expectations:
   
   
   1. panFora software installation is simple and easy.
      
      However, the required reconfiguration of Apache to accommodate the installation of any web application (including panFora) is best done by a knowledgeable system administrator.
      
      
   2. While we have taken steps to document instructions for panFora's installation with clarity and detail, we cannot account for all the variations of your particular web server and system configuration.
      As such, we highly recommend and expect that the system administrator doing the panFora software installation has:
      
      
      • familiarity with Apache web server concepts (such as web directories mapping, file directory permissions).
        
        
      • prior experience installing web applications.

These instructions are intended For Unix operating systems and Apache web server software.

In this document you will find all the instructions on how to properly install panFora software on your webserver.

• Click here to view Product Information.
  
  

This document is intended for the System Administrator who is responsible for the web server's operation.

• The System Administrator installs panFora software and responds to requests for new forums from webmasters, clients (or others who act as designated Forum Administrators).

Please take advantage of our Tech Support Forum.

• Our online support team is happy to help with technical matters and questions related to panFora installation, FAQs and troubleshooting.
  Tech Support Forum is free and only a mouse-click away.

In order to install panFora software, you should have the following information and privileges:

• Web server's Document Root directory. [ Click for explanation ]
  
  
• Read, write and execute permission within Document Root directory. [ Click for explanation ]
  
  
• Web server configuration file location (httpd.conf) and modification privileges. [ Click for explanation ]
  
  
• Desired location for installing panFora. [ Click for explanation ]
  
  
• Desired location for placing Forum webpages and data.
  
  
• Location of downloaded panFora distribution file. [ Click for explanation ]
  
  
• Path to installed PERL executable. [ Click for explanation ]
  
  
• Path to sendmail executable. [ Click for explanation ]
  
  
• Web server process Owner ID and Group ID. [ Click for explanation ]

This portion of the documentation provides step by step instructions on how to install panFora.

Once panFora Installation is completed, you may proceed to panFora Setup.

If you have already downloaded the panFora distribution file for Unix operating systems from wiTHinc's website, skip to the next step.

• Download panFora for Unix operating systems and Apache web server software from wiTHinc's website: http://www.withinc.com/downloads/panfora.html

If your web server configuration is set up differently than the default setup described below, please make the appropriate changes to the absolute paths mentioned in the instructions.

The paths given below are just an example. Your paths must be consistent with your system and web server configuration.

In the installation directions below, we will put panFora in a subdirectory of your web server space.

You may also choose to put panFora on the root level of the web server space.

The examples below are applicable to the apache web server.

panFora will work with other web servers, but it is left to the user to configure the web server properly.

1. Go to the web server's Document Root directory
      < cd /usr/local/apache/htdocs >
   
   
2. Make the subdirectory "withinc"
      < mkdir withinc >
   
   
3. Change to the withinc directory
      < cd withinc >
   
   
4. Extract the distribution file, "panFora-xxx.tgz", to deposit all necessary panFora files and subdirectories into the withinc directory
      < gzip -cd /path-of-distribution/panFora-xxx.tgz | tar xf - >
   
   
5. Transfer ownership of all panFora files and directories to the web server.
   
   
   • In the example below, we assume that the owner-id and group-id of the webserver are nobody and nogroup, respectively.
     
     
   • Please check your webserver configuration for the appropriate values.
     
     
      < chown -R nobody ../withinc >
      < chgrp -R nogroup ../withinc >
   

Configure apache web server to run panFora and its cgi-scripts.

In apache's httpd.conf (or, depending on the version of apache web server, access.conf , srm.conf ) please confirm, add, or change configuration lines as follows:

• DirectoryIndex    index.html
  AccessFileName    .htaccess
  
  
• <Directory/usr/local/apache/htdocs/withinc>
  Options    FollowSymLinks   ExecCGI
  AllowOverride    All
  </Directory>
  
  
• <Directory/usr/local/apache/htdocs/withinc/panFora>
  Options    FollowSymLinks   ExecCGI
  AllowOverride    All
  </Directory>
  
  
• AddHandler    cgi-script   .cgi

Now, using a web browser, go to the appropriate URL to complete the wizard's 5 step setup:

1. Locating PERL
   
   
2. Locating sendmail
   
   
3. Setting the panFora system administrator password
   
   
4. Entering the panFora license key
   
   
5. Registering your copy of panFora

• If you followed the installation instructions exactly, the setup web URL is:
  http://your.server/withinc/panFora/Init.cgi

• The wizard will guide you through the easy 5 step set-up process.
  
  
• At the end of the process, you'll be given 2 URLs:
  
  
  • One goes to "Creating and Setting up a Forum" web pages.
    
    
  • The other goes to the panFora System Administrator "Admin Menu" web pages.
    
    
  • Remember to either record these URLs or bookmark for future reference.
    
    
• If you would like designate another administrator who will create, set-up and delete forums, you may give the panFora System Administrator Password you specified in the setup to that person, and provide him with the "Creating and Setting up a Forum" instruction document.
  
  That person is referred as the panFora System Administrator.

• Please click here for instructions on how to Create Forums