Servertec iScript Version 1.2.1 09/04/2005

-----------------------------------------------------------------------------
CONTENT

    Introduction

    Release Notes
    Requirements
    Installation

    Contact Us

-----------------------------------------------------------------------------
INTRODUCTION

iScript a platform independent scripting language written entirely in JavaTM 
for creating scalable server side object oriented n-Tier enterprise
solutions.

iScript is the easiest way to create and maintain dynamic, data driven and
static Web sites.

iScript can be used on any platform that supports the Java Runtime
Environment (JRE) version 1.1.x or later.

iScript features include:

Feature         Description
==============  =============================================================
Platform        iScript is built using Java and will run on any platform
Independence    that supports the Java Runtime Environment (JRE) version
                1.1.x or later.

Web Server      iScript can be used with any Web Server that supports Java
Integration     Servlets or Common Gateway Interface (CGI).

                Servertec is presently working on integrating iScript
                directly into major Web Servers.

iScript         A fast, efficient and fault tolerant way of accessing iScript
Servlet         from any Web Server that supports Java Servlets.

iScript         A robust way to access iScript from any Web Server using CGI.
Server Pages

iScript         Runs scriptlets that encapsulate business rules or
Executable      functionality.

Dynamic         iScript Server Pages and the iScript Servlet can be used to
Content         produce dynamic, data-driven, personalized content from
                templates.

Static Content  iScript Preprocessor can be used to generate static content
                or source files from templates.

pcode           iScript dynamically generates and caches pcode for better
Generator       performance. 

Object          Using iScript developers create reusable modules (templates
Oriented        and scriptlets) that encapsulate business logic used to
                produce Web pages and automate tasks.

n-Tier          iScript separates Web page generation from Web Server, 
Solution        Application Server and Database Server.

Scalable        Using iScript developers can easily create robust, scalable 
Solution        solutions where a group of Web Servers seamlessly work
                together to meet the needs of a large number of Web Servers.

Fault Tolerant  iScript is inherently fault tolerant, since it is built using
                Java.

Data Access     Using iScript developers can use JDBC to create data-driven
                Web applications that access a variety of data sources. 

Java Wrappers   Java Wrappers provide an extendible mechanism for developers
                to effortlessly access Java API object constructors, methods
                and properties.

Tiny Foot       iScript runtime occupies about 80KB of disk space.
Print

Open API        iScript can be easily accessed from Java or any other
                programming or scripting language that supports Java method
                calls or system calls.

Online          All iScript documentation is available as Web pages.
Documentation

Developer Kit   iScript includes numerous examples to demonstrate the
                capabilities of iScript.

-----------------------------------------------------------------------------
RELEASE NOTES

Servertec is happy to announce the open source release of Servertec iScript 
Version 1.2.1 09/04/2005.

You can help shape the development of Servertec iScript, send your comments, 
suggestions and problems to support@servertec.com.

-----------------------------------------------------------------------------
REQUIREMENTS

Storage 
    500 KB for classes and executables 
    12 MB for classes, executables, examples and documentation

Java
    Java version 1.1.x or later

    Download Java from JavaSoft at:
    http://java.sun.com

-----------------------------------------------------------------------------
INSTALLATION

Use the following instructions to install iScript on Windows 9x/Me.

 1. Install Java version 1.1.x or later.

 2. Extract setup_iscript.jar file.

    c:
    cd \
    jar -xvf <path>\setup_iscript.jar

    <path>       the directory containing setup_iscript.jar.

 3. Define environment variables in c:\autoexec.bat file. 
    Using c:\iscript\install\win32\vars.bat as a template: 

      I. Modify JAVA_EXE, as needed

         set JAVA_EXE=path\bin\java.exe

         Normally path is the base directory where Java was installed.
   
     II. Define CLASSPATH

         set CLASSPATH=c:\iscript\classes\iscript.jar;%CLASSPATH% 
    
    III. Define PATH

         set PATH=c:\iscript\bin\win32;%PATH% 

 4. Setup Web Server to use iScript ctf files. 

    Follow the instructions below to install the iScript Servlet for use with
    Servertec Internet Server (IWS).
    
      I. From the Servertec Internet Server Administrator - Control Panel
         click on the Manage button.
    
     II. Then click on Aliases and then click on the ADD button. Enter /iscript
         for Alias, select File for Type and c:\iscript for Resource. Finally
         click on the OK button.
    
    III. Then click on the ADD button and enter .ctf for Alias, select Filter
         for Type and iScriptServer for Resource, Finally click on
         the OK button.

     IV. Now click on Filters and then click on the ADD button. Enter 
         iScriptServer for Alias, stec.ss.iScriptiServerServlet for Class
         File and basedir=path for Parameters. Normally path is c:. Finally
         click on the OK button, then click on the SAVE button and then on
         the RESTART button.

    Follow the instructions below to install the iScript Servlet for use with
    JavaSoft's JavaServer.

      I. From the JavaServer administration tool and under Services select
         Web Service and then click on the Manage button.
    
     II. Under Setup click on File Aliases and then click on the Add button.
         Afterwards enter /iscript for Alias Pathname and enter c:\iscript 
		 for Full Pathname.
    
    III. Under Setup click on Servlet Aliases and then click on the Add
         button. Afterwards enter *.ctf for Aliases and enter iScriptServlet
         for Servlet Invoked. Then click on the Save button.
    
     IV. Once an alias for iScript has been entered and saved click on the
         Servlets toolbar button. Then under Servlets click on Add, enter
         iScriptServlet for Servlet Name and enter stec.ss.iScriptServlet for
         Servlet Class. Afterwards under the Configuration tab enter iScript
         Servlet for Description. Afterwards click on the Properties tab and
         then click on the Add button. Under Property enter basedir and enter
         path for Value. Normally path is c:. Now click on the Save button,
         close the Web Service window and click on the Log Out toolbar
         button.
    
      V. Finally copy the iscript.jar archive from under path/servlets.
         Where path is the base path where Java Web Server was installed.

    Follow the instructions below to install the iScript Servlet for use with
    Microsoft's Personal Web Server (PWS).

      I. Change Web Server Properties 

           i. append index.ctf to Default Document(s). 
              Normally under Advanced Options 
    
          ii. add virtual directory 
              /iscript as c:\iscript 
              with Read, Execute and Scripts access 
              Normally under Advanced Options, Virtual Directories 

     II. Update Registry 

           i. Modify c:\iscript\install\win32\ss.reg as needed.

              ".ctf"="\"c:\\iscript\\bin\\ss.exe\" \"%s\" \"%s\""

              Note: Each \\ represents a single \ 

          ii. Register iScript.

              regedit c:\iscript\install\win32\ss.reg 

 5. Restart the computer.

Use the following instructions to install iScript on 
Windows NT/2000/2003/XP. 

 1. Install Java version 1.1.x or later.

 2. Extract setup_iscript.jar file.

    c:
    cd \
    jar -xvf <path>\setup_iscript.jar

    <path>       the directory containing setup_iscript.jar.

 3. Define environment variables in c:\autoexec.bat file. 
    Using c:\iscript\install\win32\vars.bat as a template: 

      I. Modify JAVA_EXE, as needed

         set JAVA_EXE=path\bin\java.exe

         Normally path is the base directory where Java was installed.

     II. Define CLASSPATH

         set CLASSPATH=c:\iscript\classes\iscript.jar;%CLASSPATH% 

    III. Define PATH

         set PATH=c:\iscript\bin\win32;%PATH% 

 4. Setup Web Server to use iScript ctf files. 

    Follow the instructions below to install the iScript Servlet for use with
    Servertec Internet Server (IWS).
    
      I. From the Servertec Internet Server Administrator - Control Panel
         click on the Manage button.
    
     II. Then click on Aliases and then click on the ADD button. Enter /iscript
         for Alias, select File for Type and c:\iscript for Resource. Finally
         click on the OK button.
    
    III. Then click on the ADD button and enter .ctf for Alias, select Filter
         for Type and iScriptServlet for Resource, Finally click on the OK
         button.

     IV. Now click on Filters and then click on the ADD button. Enter 
         iScriptServer for Alias, stec.ss.iScriptiServerServlet for Class
         File and basedir=path for Parameters. Normally path is c:. Finally
         click on the OK button, then click on the SAVE button and then on
         the RESTART button.

    Follow the instructions below to install the iScript Servlet for use with
    JavaSoft's JavaServer.

      I. From the JavaServer administration tool and under Services select
         Web Service and then click on the Manage button.
    
     II. Under Setup click on File Aliases and then click on the Add button.
         Afterwards enter /iscript for Alias Pathname and enter c:\iscript for
		 Full Pathname.
    
    III. Under Setup click on Servlet Aliases and then click on the Add
         button. Afterwards enter *.ctf for Aliases and enter iScriptServlet
         for Servlet Invoked. Then click on the Save button.
    
     IV. Once an alias for iScript has been entered and saved click on the
         Servlets toolbar button. Then under Servlets click on Add, enter
         iScriptServlet for Servlet Name and enter stec.ss.iScriptServlet for
         Servlet Class. Afterwards under the Configuration tab enter iScript
         Servlet for Description. Afterwards click on the Properties tab and
         then click on the Add button. Under Property enter basedir and enter
         path for Value. Normally path is c:. Then click on the Save button,
         close the Web Service window and click on the Log Out toolbar button.
    
      V. Finally copy the iscript.jar archive from under path/servlets.
         Where path is the base path where Java Web Server was installed.

    Follow the instructions below to install the iScript Servlet for use with
    Microsoft's Internet Information Server (IIS).

      I. Change Web Server Properties 

           i. append index.ctf to Default Document(s). 
              Normally under Advanced Options 

          ii. add virtual directory 
              /iscript as c:\iscript 
              with Read, Execute and Scripts access 
              Normally under Advanced Options, Virtual Directories 

     II. Update Registry 

           i. Modify c:\iscript\install\win32\ss.reg as needed.

              ".ctf"="\"c:\\iscript\\bin\\ss.exe\" \"%s\" \"%s\""

              Note: Each \\ represents a single \ 

          ii. Register iScript.

              regedit c:\iscript\install\win32\ss.reg 

    III. Define environment variables in System Control Panel. 
         Using c:\iscript\install\win32\vars.bat as a template: 

          i. Define JAVA_EXE as path\bin\java.exe 
             Normally path is the base directory where Java was installed.
    
         ii. Append/Define c:\iscript\classes\iscript.jar to CLASSPATH 
    
        iii. Append c:\iscript\bin\win32 to PATH

 5. Restart the computer.

Use the following instructions to install iScript on
Linux/Solaris/AIX/HP-UX/Unix.

 1. Install Java version 1.1.x or later.

 2. Login on account where iScript will be installed.

 3. Extract setup_iscript.jar file.

    cd /
    jar -xvf <path>/setup_iscript.jar

    <path>       the directory containing setup_iscript.jar.

 4. If not in root directory, move iscript to root directory.

    mv iscript / 

 5. Make executables, as needed

    cd /iscript/bin/linux
    chmod u+x,g+x makess
    ./makess

 6. Define environment variables in user's login script.
    Using /iscript/install/linux/home/vars.sh as a template: 

      I. Define JAVA_EXE, as needed

         export JAVA_EXE="path/bin/java"

         Normally path is the base directory where Java was installed.

     II. Define CLASSPATH

         export CLASSPATH="/iscript/classes/iscript.jar:${CLASSPATH}" 

    III. Update PATH

         export PATH="/iscript/bin/linux:${PATH}" 

 7. Update /iscript/bin/linux/ss.exe, /iscript/bin/linux/sp.exe and
    /iscript/bin/linux/se.exe, as needed

      I. Define JAVA_EXE, as needed

         export JAVA_EXE="path/bin/java"

         Normally path is the base directory where Java was installed.

     II. Define CLASSPATH

         export CLASSPATH="/iscript/classes/iscript.jar:/java/lib/classes.zip:${CLASSPATH}" 

    III. Update PATH

         export PATH="/iscript/bin/linux:${PATH}" 

 8. Setup Web Server to use iScript ctf files. 

    Follow the instructions below to install the iScript Servlet for use with
    Servertec Internet Server (IWS).
    
      I. From the Servertec Internet Server Administrator - Control Panel
         click on the Manage button.
    
     II. Then click on Aliases and then click on the ADD button. Enter /iscript
         for Alias, select File for Type and c:\iscript for Resource. Finally
         click on the OK button.
    
    III. Then click on the ADD button and enter .ctf for Alias, select Filter
         for Type and iScriptServlet for Resource, Finally click on the OK
         button.

     IV. Now click on Filters and then click on the ADD button. Enter 
         iScriptServer for Alias, stec.ss.iScriptiServerServlet for Class
         File and basedir=path for Parameters. Normally path is /. Finally
         click on the OK button, then click on the SAVE button and then on
         the RESTART button.

    Follow the instructions below to install the iScript Servlet for use with
    JavaSoft's JavaServer.

      I. From the JavaServer administration tool and under Services select
         Web Service and then click on the Manage button.
    
     II. Under Setup click on File Aliases and then click on the Add button.
         Afterwards enter /iscript for Alias Pathname and enter /iscript for Full
         Pathname.
    
    III. Under Setup click on Servlet Aliases and then click on the Add
         button. Afterwards enter *.ctf for Aliases and enter iScriptServlet
         for Servlet Invoked. Then click on the Save button.
    
     IV. Once an alias for iScript has been entered and saved click on the
         Servlets toolbar button. Then under Servlets click on Add, enter
         iScriptServlet for Servlet Name and enter stec.ss.iScriptServlet
         for Servlet Class. Afterwards under the Configuration tab enter
         iScript Servlet for Description. Afterwards click on the Properties
         tab and then click on the Add button. Under Property enter basedir
         and enter path for Value. Normally path is /. Then click on the Save
         button, close the Web Service window and click on the Log Out
         toolbar button.
    
      V. Finally copy the iscript.jar archive from under path/servlets.
         Where path is the base path where Java Web Server was installed.

    Follow the instructions below to install the iScript Servlet for use with
    Apache Web Server.

      I. Modify srm.conf 
         Using /iscript/install/linux/httpd/conf/srm.conf as a template: 

           i. append index.ctf to DirectoryIndex 

          ii. add ScriptAlias /iscript/samples/templates /iscript/samples/templates

         iii. add ScriptAlias /iscript/templates /iscript/templates

          iv. add Alias /iscript /iscript


     II. Modify access.conf 
         Using /iscript/install/linux/httpd/conf/access.conf as a template: 

           i. add Directory entry for /iscript/samples/templates

              <Directory /iscript/samples/templates> 
              Options ExecCGI 
              AllowOverride None 
              </Directory>

          ii. add Directory entry for /iscript/templates

              <Directory /iscript/templates> 
              Options ExecCGI 
              AllowOverride None 
              </Directory> 

         iii. add Directory entry for /iscript

              <Directory /iscript> 
              Options None
              AllowOverride None 
              </Directory> 

 9. Logout and log back in.

-----------------------------------------------------------------------------
CONTACT US

At Servertec, we value what you have to say. We are committed to defining
our products based on your needs. Please send us your questions, comments,
suggestions and problems.

General Information     info@servertec.com

Licensing Information   legal@servertec.com

Technical Support       support@servertec.com

Web Site                webmaster@servertec.com

Address                 Servertec
                        18 Oakwood Avenue
                        Kearny, NJ 07032

-----------------------------------------------------------------------------
Copyright (C) 1998-2005 Servertec. All rights reserved.
