InSitu

Installation instructions - InSitu (Perl/CGI) 0.3a
Before you take the time to install InSitu on your web server. Please make sure that you understand when to use, and more importantly, when NOT to use InSitu as a part of your editing platform.

1) InSitu is NOT a CMS. If your web site is in need of a CMS you will find several projects on SourceForge (http://sourceforge.net/) that are better suited to meet your needs.

2) InSitu is NOT designed around a database or any other repository of data for that matter. If the data you wish to present on your web site is best stored in a separate data layer you should probably consider a CMS. NOTE! Although the data-driven approach used to design web applications have become the "standard" way to deliver content. It is NOT ALWAYS the best approach.

3) InSitu is NOT designed for web sites that are maintained by several editors. This version of InSitu relies heavily on writing content directly to disk and is therefore less suited to web sites where editing content is shared among several persons.

4) InSitu does NOT include functions for version control, workflow support, access control or web site statistics. You will have to rely on the underlaying OS or on 3rd party software to perform these tasks.

5) The InSitu administration tool does NOT include rich edit capabilites or file uploads. This will probably by included in future versions. For more information see the InSitu web page at http://www.pulp.se.

6) InSitu does NOT include pre-built functionality for any type of dynamic content handling. However, InSitu can co-exist with any ASP, JSP or PHP functionality in the pages you design and include in your web application.

7) InSitu is free software. It is released under the GNU General Public License (see license), please make sure to have read and understood it before installing InSitu.

Required software
Operating System:
InSitu can run on any operating system that is able to run a web server that supports CGI and has a Perl interpreter ported to it. The reference implementation uses Windows NT/2000.

Web Server:
InSitu can be used on any web server that supports CGI. The reference implementation uses IIS 5.0.

Perl:
InSitu requires Perl 5.004 or later. InSitu is designed to run with as few non built-in functions as possible. The only required module is CGI.pm which is included in core Perl distributions as of version 5.004. The reference implementation uses ActivePerl 5.8.0.806. You can download Perl from CPAN and ActivePerl from ActiveState.

Client (web browser):
InSitu requires a web browser that supports JavaScript. The reference implementation has been tested with Netscape 7.1 and Internet Explorer 6 on Windows NT/2000.

Installation steps
The steps below describe the installation of the reference implementation and the included example web site. Some steps may vary depending on your specific setup.

I'm assuming that you have an operating system and a web server (that can run Perl/CGI scripts) installed. If you don't, take care of that
first.

1) Unzip the InSitu distribution somewhere on your harddisk and copy the files and folders under \src to your wwwroot folder. The wwwroot folder of the reference implementation is located at C:\Inetpub\wwwroot so after copying it looks like this:

C:\Inetpub\wwwroot\
C:\Inetpub\wwwroot\index.shtml

C:\Inetpub\wwwroot\admin\
C:\Inetpub\wwwroot\admin\index.shtml

C:\Inetpub\wwwroot\admin\gfx\
C:\Inetpub\wwwroot\admin\gfx\star.gif

C:\Inetpub\wwwroot\admin\inc\
C:\Inetpub\wwwroot\admin\inc\style.css

C:\Inetpub\wwwroot\admin\properties\
C:\Inetpub\wwwroot\admin\properties\image.properties
C:\Inetpub\wwwroot\admin\properties\nav.properties

C:\Inetpub\wwwroot\admin\templates\
C:\Inetpub\wwwroot\admin\templates\with_image.shtml
C:\Inetpub\wwwroot\admin\templates\without_image.shtml

C:\Inetpub\wwwroot\admin\trash\
C:\Inetpub\wwwroot\admin\trash\empty.txt

C:\Inetpub\wwwroot\cgi-bin\
C:\Inetpub\wwwroot\cgi-bin\add.pl
C:\Inetpub\wwwroot\cgi-bin\add2.pl
C:\Inetpub\wwwroot\cgi-bin\ctrl.pl
C:\Inetpub\wwwroot\cgi-bin\delete.pl
C:\Inetpub\wwwroot\cgi-bin\edit.pl
C:\Inetpub\wwwroot\cgi-bin\edit2.pl
C:\Inetpub\wwwroot\cgi-bin\error.pl
C:\Inetpub\wwwroot\cgi-bin\InSitu.pm
C:\Inetpub\wwwroot\cgi-bin\insitu.properties

C:\Inetpub\wwwroot\gfx\
C:\Inetpub\wwwroot\gfx\edge.gif
C:\Inetpub\wwwroot\gfx\star.gif

C:\Inetpub\wwwroot\images\
C:\Inetpub\wwwroot\images\tux.gif

C:\Inetpub\wwwroot\inc\
C:\Inetpub\wwwroot\inc\nav.html
C:\Inetpub\wwwroot\inc\style.css

2) Create a new user account for the web site administrator and set permissions so that the folders admin and cgi-bin cannot be reached by anonymous users. For your new web site admin account, set permission to read for the admin folder, execute for the cgi-bin folder and write for all folders with editable files.

3) Specify index.shtml as the default document to be used. You can have several others as well and they don't have to be in any particular order but index.shtml must be in the list.

Installation is now complete. You should be able to access the example web site by opening a web browser and go to http://localhost/ (reference implementation).

For help with setting up your web site please refer to the InSitu web page at www.pulp.se, the example web site that comes with the distribution and the setup document.