Permissions / setup



CGI LOCATION



The following scripts are executable and require read/execute permissions

On UNIX based systems check that the hash bang at th top of each  script

provides a correct path to perl on your system - E.g. #!/usr/bin/perl



pages.pl

try.pl

admin.pl

imup.pl

check.pl

imlib.pl

imlibup.pl



The following files require read / write permissions

pages.cfg



The following directories and any files they contain

require read / write permissions

trycfg

trydata

sitescfg

sitesdata

data



All other files/directories in the cgi location require only

read permissions



DOCUMENT (HTML) LOCATION

The following directories require read/write permissions



The directories defined in basedir and ipath (See configuration below)

The directory or directories below which you intend to create 'real' sites



All other files/directories in the document location require only

read permissions



##############################################################################



CONFIGURATION



Run check.pl

This should give you a result similar to

Base cgi location d:\inetpub\fp04-202\cgi-bin\autosite\

My Full Path d:\inetpub\fp04-202\cgi-bin\autosite\check.pl



Use this to specify the correct paths as explained below



The only further configuration required is in pages.cfg

FORMAT

definition_name|definition

(Change values after | )



Note that \ is used in paths in Win32 systems, but / on UNIX

On either platform / is used for URLs



basedir|\inetpub\fp04-202\      - full path below cgi-bin

Note that this derives from the Base cgi location string

returned by check.pl.

NB: ON WIN32 SYSTEMS DRIVE LETTER IS RETURNED

THIS SHOULD ALWAYS BE OMITTED WHEN DEFINING PATHS

UNIX example: basedir|/home/linefeed/



ipath|\inetpub\fp04-202\autosite\images\

- full path to location of autosites images directory

UNIX example: ipath|/home/linefeed/html/autosite/images/



cgisub and subloc are the bits which need to be added to your basic site URL

to find the cgi and html docs locations of autosites.

So if the urls are http://www.hibyte.co.uk/cgi-bin/autosites/try.pl and

http://www.hibyte.co.uk/autosites/index.html we would supply the following

values:



cgisub|/cgi-bin/autosite/

subloc|/autosite/

(Note that these are use to build URLs, so an html or ht-docs directory which is

present in the path but not in URLs will not be included here)





defpath|\inetpub\fp04-202\autosite\

defurl|http://www.hibyte.co.uk/autosite/

These define the default path and default URL where new sites will be created.

These values appear as the default in the fields used to configure sites in admin.pl,

and you can alter or override them there - they are really just 'memory joggers'



tim_loc|http://www.hibyte.co.uk/autosite/images/demo

tim_loc is the URL of the /images/demo directory



mailport|25

Usually 25 - ignored on UNIX



mailprog|mailhost.dircon.co.uk

The mailserver on Win32, path to sendmail on UNIX

UNIX example mailprog|/usr/lib/sendmail



The remaining values in pages.cfg (covered in the main documentation) should not need to be

changed to get Autosites running



##############################################################################



Running Autosites:

try.pl - tryout module

admin.pl - admin area

Detailed annotation or online help is available within these progams as they run.

If you need further advice or assistance contact us at info@hibyte.co.uk



imlib.pl - image library - this can be run independently to demonstrate contents of

library but is normally sed within site editors



Detailed annotation or online help is available within these progams as they run.



The other .pl files are used within functions and will not produce useful results when run independently



##############################################################################



This demo version contains all the main functions of Autosites but various utilities

have been removed for the sake of simplicity