|  | panFora Installation on the Server For Unix
|  | ( Looking for how to install panFora on Windows NT/2000 systems? Click here) Please read the instructions carefully, and follow the installation steps sequentially.
|  | Table of Contents
|  | Installation Requirements Before You Begin FYI Gathering Information and Privileges panFora Installation Downloading panFora Distribution Installinging panFora Files Web Server Configuration panFora Setup Create New Forum
| 1. | Installation Requirements | | ToC |
|  | Please review the following assumptions, requirements, and expectations for installing the panFora software with Unix operating systems and Apache web server software. System Requirements: You will need the following (in addition to Operating System and Apache software requirements): Linux 2.0+ or Solaris 7+ or FreeBSD 3.5+ or OpenBSD 2.8+ PERL (version 5.004 or greater) 30 MB disk space (minimum) + storage for forum content 32 MB RAM (or greater) Assumptions It is assumed that you have: operating system and PERL correctly installed on your server. Apache web server installed, configured and working correctly. system administrator [root] account access to modify Apache server configuration (as needed) and create/write to web document directories. Expectations: 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. 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.
Important Notes For customers with minimal system administrator experience, wiTHinc recommends and offers consulting and installation services to install the software for you. Contact consulting@withinc.com to inquire about pricing and to schedule your installation |
| 2. | Before you begin | | ToC |
|  | 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.
| 2.a. | FYI | | ToC |
Important Notes You need to install panFora only once in your server, regardless of the number of Forums you plan on deploying. Once panFora is installed, you will be able to create and set up as many Forums as your license allows. Click here for more information on panFora licenses. If you are installing panFora for evaluation (panFora EVAL), you are granted use of panFora for 45 days. After the free evaluation period, all forums will be disabled until you purchase a license. There is no need to reinstall panFora when upgrading a license, or restoring use of an expired Evaluation forum. Just enter the new license key. |
| 2.b. | Gathering Information and Privileges | | ToC |
|  | 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 ]
| 3. | panFora Installation | | ToC |
|  | 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.
| 3.a. | Downloading panFora Distribution | | ToC |
|  | 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.html
| 3.b. | Installing panFora Files | | ToC |
|  | 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.
Important Notes Text that appears between < > represent the commands being typed in the installation procedure. |
Go to the web server's Document Root directory < cd /usr/local/apache/htdocs > Make the subdirectory "withinc" < mkdir withinc > Change to the withinc directory < cd withinc > 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 - > 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 > < chown -R nogroup ../withinc >
| 3.c. | Web Server Configuration | | ToC |
|  | 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
Important Notes on Access Restriction Remember to restart the web server after making these configuration changes in Apache's configuration files. This can usually be done with the following commands. < /usr/local/apache/bin/apachectl stop > < /usr/local/apache/bin/apachectl start > Note that using "apachectl restart" may not cause Apache to reread its configuration files, so use the stop and start instead. The location of apachectl may vary. |
| 4. | panFora Setup | | ToC |
|  | Now, using a web browser, go to the appropriate URL to complete the wizard's 5 step setup: Locating PERL Locating sendmail Setting the panFora system administrator password Entering the panFora license key Registering your copy of panFora If you followed the installation instructions exactly, the setup web URL is: http://your.server/withinc/panFora/Init.cgi
Important Notes If you installed panFora in a subdirectory, change the URL accordingly. |
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.
| 5. | Create New Forums | | ToC |
|  | Please click here for instructions on how to Create Forums
| Top of Page
| © 2001 wiTHinc Corporation. All rights reserved.