iScript 1.0.0 01/24/99 Preview Release

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

    Introduction

    Release Notes
    Requirements
    Installation

    Feedback

-----------------------------------------------------------------------------
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) 1.1.x.

iScript features include:

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

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.

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

iScript         Runs scriptlets that encapsulate business rules or
Executable      functionality.

Dynamic         Server Side iScript 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

iScript 1.0.0 01/24/99 Preview Release features updated installation
instructions.

You can help shape the development of 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

JRE
    Java Runtime Environment (JRE) 1.1.x or later Download from JavaSoft

or JDK
    Java Development Kit (JDK) 1.1.x or later Download from JavaSoft

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

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

 1. Install Java JDK 1.1.x 
    Follow JavaSoft's instructions for installing Java JDK 1.1.x.

 2. Unzip downloaded file(s) 
    Follow 3rd Party instructions for extracting files from a zip file using
    folder names.
    Normally extract to c:\

 3. Define environmental variables in c:\autoexec.bat file. 
    Using c:\ss\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:\ss\classes\iscript.jar;%CLASSPATH% 
    
    III. Define PATH
         set PATH=c:\ss\bin;%PATH% 

 4. Setup Web Server to use iScript ctf files. 

    Follow the instructions below to install iScript Servlet with Servertec's
    iServer (IWS).
    
      I. From the iServer Administrator - Control Panel click on the Manage
         button.
    
     II. Then click on Aliases and then click on the ADD button. Enter /ss
         for Alias and c:\ss for Directory. Finally click on the OK button.

    III. Now click on Filters and then click on the ADD button. Enter .ctf
         for Extension, stec.ss.iScriptServlet 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 iScript Servlet 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 /ss for Alias Pathname and enter c:\ss 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 iScript Servlet 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 
              /ss as c:\ss 
              with Read, Execute and Scripts access 
              Normally under Advanced Options, Virtual Directories 

     II. Update Registry 

           i. Modify c:\ss\install\win32\ss.reg as needed. 
              ".ctf"="\"c:\\ss\\bin\\ss.exe\" \"%s\" \"%s\"" 
              Note: Each \\ represents a single \ 

          ii. Register iScript. 
              regedit c:\ss\install\win32\ss.reg 

 5. Restart the computer.

Use the following instructions to install iScript on Windows NT. 

 1. Install Java JDK 1.1.x 
    Follow JavaSoft's instructions for installing Java JDK 1.1.x. 

 2. Unzip downloaded file(s) 
    Follow 3rd Party instructions for extracting files from a zip file using
    folder names.
    Normally extract to c:\ 

 3. Define environmental variables in c:\autoexec.bat file. 
    Using c:\ss\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:\ss\classes\iscript.jar;%CLASSPATH% 

    III. Define PATH
         set PATH=c:\ss\bin;%PATH% 

 4. Setup Web Server to use iScript ctf files. 

    Follow the instructions below to install iScript Servlet with Servertec's
    iServer (IWS).
    
      I. From the iServer Administrator - Control Panel click on the Manage
         button.
    
     II. Then click on Aliases and then click on the ADD button. Enter /ss
         for Alias and c:\ss for Directory. Finally click on the OK button.

    III. Now click on Filters and then click on the ADD button. Enter .ctf
         for Extension, stec.ss.iScriptServlet 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 iScript Servlet 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 /ss for Alias Pathname and enter c:\ss 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 iScript Servlet 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 
              /ss as c:\ss 
              with Read, Execute and Scripts access 
              Normally under Advanced Options, Virtual Directories 

     II. Update Registry 

           i. Modify c:\ss\install\win32\ss.reg as needed. 
              ".ctf"="\"c:\\ss\\bin\\ss.exe\" \"%s\" \"%s\"" 
              Note: Each \\ represents a single \ 

          ii. Register iScript. 
              regedit c:\ss\install\win32\ss.reg 

    III. Define environmental variables in System Control Panel. 
         Using c:\ss\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:\ss\classes\iscript.jar to CLASSPATH 
    
        iii. Append c:\ss\bin to PATH

 5. Restart the computer.

Use the following instructions to install iScript on Linux/Unix. 

 1. Install Java JDK 1.1.x 
    Follow JavaSoft's instructions for installing Java JDK 1.1.x.

 2. Login on account where iScript will be installed.

 3. Unzip downloaded file(s). 
    gzip -d filename 

 4. Untar resultant file(s). 
    tar -xvpf filename 

 5. If not in root directory, move ss to root directory. 
    mv ss / 

 6. Make executables, as needed
    cd /ss/bin 
    makess

 7. Define environmental variables in user's login script.
    Using /ss/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="/ss/classes/iscript.jar:${CLASSPATH}" 

    III. Update PATH 
         export PATH="/ss/bin:${PATH}" 

 8. Update /ss/bin/ss.exe, /ss/bin/sp.exe and
    /ss/bin/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="/ss/classes/iscript.jar:/java/lib/classes.zip:${CLASSPATH}" 

    III. Update PATH 
         export PATH="/ss/bin:${PATH}" 

 9. Setup Web Server to use iScript ctf files. 

    Follow the instructions below to install iScript Servlet with Servertec's
    iServer (IWS).
    
      I. From the iServer Administrator - Control Panel click on the Manage
         button.
    
     II. Then click on Aliases and then click on the ADD button. Enter /ss
         for Alias and /ss for Directory. Finally click on the OK button.

    III. Now click on Filters and then click on the ADD button. Enter .ctf
         for Extension, stec.ss.iScriptServlet 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 iScript Servlet 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 /ss for Alias Pathname and enter /ss 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 iScript Servlet with Apache
    Web Server.

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

           i. append index.ctf to DirectoryIndex 

          ii. add Alias /ss/ /ss/

         iii. add ScriptAlias /ss/templates/ /ss/templates/ 

          iv. add ScriptAlias /ss/samples/templates/ /ss/samples/templates/


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

           i. add Directory entry for /ss 
              <Directory /ss> 
              Options Indexes FollowSymLinks 
              allow from all 
              order allow,deny 
              AllowOverride None 
              </Directory> 

          ii. add Directory entry for /ss/templates 
              <Directory /ss/templates> 
              Options ExecCGI 
              AllowOverride None 
              </Directory> 

         iii. add Directory entry for /ss/samples/templates 
              <Directory /ss/samples/templates> 
              Options ExecCGI 
              AllowOverride None 
              </Directory>

10. Logout and log back in.

-----------------------------------------------------------------------------
FEEDBACK

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.

Product Information     sales@servertec.com
Sales information about new product availability, costs and licensing.

Technical Support       support@servertec.com
Answers to Servertec product questions.

Web Site                webmaster@servertec.com
Questions, comments or problems concerning the Servetec Web site.

General Information

    Servertec
    18 Oakwood Avenue
    Kearny, NJ 07032

    Phone: 201-998-1048 
      Fax: 201-998-0665 
