[NetScript CVS] CVS: netscript2/docs/netscript INSTALLATION.html,NONE,1.1

[Jan T. <de...@us...>]

Update of /cvsroot/net-script/netscript2/docs/netscript
In directory sc8-pr-cvs1:/tmp/cvs-serv32131

Added Files:
	INSTALLATION.html 
Log Message:
* added installation instructions

--- NEW FILE: INSTALLATION.html ---
<pre>
/---------------------------------------------------------------------\
| $Id: INSTALLATION.html,v 1.1 2003/06/06 19:24:13 derkork Exp $
| NetScript and all related materials, such as documentation,
| are protected under the terms and conditions of the Artistic License.
|
| (C) 2000-2002 by Jan Thomae, insOMnia (ko...@in...)
\---------------------------------------------------------------------/

Installation of NetScript 2
-------------------------------------

The installation of NetScript 2 is quite easy. You need a webserver capable of
executing perl scripts (most webservers are able to do so). There are some
modules which need to be present on the webserver. Check REQUIREMENTS.html for
a complete list. Note that some of the modules mentioned there are optional -
NetScript will run without them, however some of the functionality might not
be available.

To install the package, copy the following files from this package to your
webserver.

  * NetScript ( the complete folder with all subfolders )
  * XML ( the complete folder with all subfolders )
  * configuration
  * netscript.pl

If perl scripts have to be in a special directory on your server (e.g cgi-bin),
you have to copy these files below your cgi-bin directory. Change the mode of

  * netscript.pl to 755 (rwxr-xr-x) 
  * configuration to 666 (rw-rw-rw-)
  
After that you need to copy the 
   * pages ( complete folder )
   
to somewhere to your webserver (not to the cgi-bin folder!).

Now you are nearly done. Edit the configuration file to set up netscript. The
options are explained within the file. When you are done with it, upload the
changed configuration file.

NetScript 2 is now installed and ready for use. You can now test it by
accessing netscript.pl from your browser 
(e.g. http://www.yourdomain.com/cgi-bin/netscript.pl). 
An error message should show up, stating that you didnt specify a script. 
If this message shows up, you have installed NetScript correctly. If not,
check the  instructions again and make sure you didn't forget something.
If you  still don't get it to work, please email me at ko...@in....

After you have installed NetScript, you can try some of the scripts provided
in the scripts folder. Just upload the script to your site and then type
http://www.yourdomain.com/cgi-bin/netscript.pl?script=/path/to/script.xml.
E.g. if you copied the scripts to cgi-bin/scripts then type:
http://www.yourdomain.com/cgi-bin/netscript.pl?script=scripts/core.xml

Now go and create your own scripts. Use the provided scripts as examples.
There is a bigger example in docs/examples/eventcalendar. For full reference
of all currently supported commands check the library documentation at
docs/api/index.html. Click on NetScript::Libraries to get a list of all
libraries. Click on the library to get a description of all commands processed
by this library.  A future release of NetScript will contain more 
extensive documentation.

If you have any problems or questions, feel free to contact me at 
ko...@in....

Have fun playing with NetScript 2!
</pre>