Servertec Deployment
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
Add-ons
How To
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Command Line
Administrator
Localization
Programming
Security
Performance
Deployment
Java API
Servlet API
CGI
SSI
Servlets
Config Files
Log Files
Classes
Directory Tree
Samples
Legal
Contact Us

 

Select deployment method:
Directory
JAR/ZIP file
Filesystem Hierarchy Standard (FHS)


Use the following instructions to deploy Servertec Internet Server to a directory.
  1. Update deploy_iws as needed.

  2. Run deploy_iws.

    deploy_iws path

    path directory where to deploy Servertec Internet Server.

  3. Place your files:

    binary files in path/bin
    servlet files in path/classes
    CGI executable files in path/cgi-bin
    html files in path/wwwroot
    image files in path/wwwroot/images

    path directory where Servertec Internet Server was deployed.

  4. Update configuration files in path/config as needed, where path is the directory where Servertec Internet Server was deployed.

  5. Update PATH.

    Windows 9x/Me/NT/2000/2003/XP
    set PATH=path/bin;%PATH%

    Linux/Solaris/Unix
    export PATH=path/bin:$PATH

    path directory where Servertec Internet Server was deployed.

  6. Update CLASSPATH.

    Windows 9x/Me/NT/2000/2003/XP
    set CLASSPATH=path/classes;%CLASSPATH%

    Linux/Solaris/Unix
    export CLASSPATH=path/classes:$CLASSPATH

    path directory where Servertec Internet Server was deployed.

  7. Run Servertec Internet Server using:

    iws path

    path directory where Servertec Internet Server was deployed.

top of page


Use the following instructions to deploy Servertec Internet Server to a JAR/ZIP file.
  1. Use the instructions above to deploy Servertec Internet Server to a Directory.

  2. Extract classes in iws.jar, optional.jar, admin.jar and in servlet.jar.

    cd path
    jar -xvf iws_dir/classes/iws.jar
    jar -xvf iws_dir/classes/optional.jar
    jar -xvf iws_dir/classes/admin.jar
    jar -xvf iws_dir/classes/servlet.jar

    iws_dir is the directory where Servertec Internet Server is installed.
    path is where Servertec Internet Server was deployed.

  3. Using Servertec Internet Server Classes as a guideline, remove any unnecessary optional classes from the distribution.

    cd path
    del class_path

    class_path is the path specified in Servertec Internet Server Classes.
    path is where Servertec Internet Server was deployed.

  4. Using the notes below, update configuration files in path/config, where path is the directory where Servertec Internet Server was deployed.

    • Remove /docs and /admin.html definitions from path/config/aliases.ini and remove AdminServlet from path/config/servlets.ini.
    • if administrator and clustering was removed then remove /status definition from path/config/aliases.ini and StatusServlet from path/config/servlets.ini.
    • if FileLogger and DatabaseLogger is not being used then change service definition in path/config/logger.ini to stec.iws.ConsoleLogger.
    • if logger is not being used then set log_access = n, log_errors = n, log_events = n in path/config/logger.ini.
    • if connection pools are not being used then set connection_pools = n in path/config/iws.ini.
    • if security is not being used then set security = n in path/config/iws.ini and clear path/config/acl.ini, path/config/groups.ini, /config/users.ini, path/config/realms.ini and path/config/resources.ini.
    • if <servlet> tag was removed then remove .ssi from path/config/aliases.ini and ServletTagServlet from path/config/servlets.ini.
    • if ssi was removed then remove .shtml from path/config/aliases.ini and SSIncludeServlet from path/config/servlets.ini.
    • if ssi and cgi was removed then remove /cgi-bin from path/config/aliases.ini and CgiServlet from path/config/servlets.ini.
    • if InvokerServlet was removed then remove /servlet from path/config/aliases.ini and InvokerServlet from path/config/servlets.ini.
    • if FileServlet was removed then remove / from path/config/aliases.ini and FileServlet from path/config/servlets.ini.

    service = stec.iws.FileLogger?basedir= logs_dir &access_log_template=default&log_rollover_interval=weekly

    logs_dir is an absolute path to a directory where the logger will write to.
    path directory where Servertec Internet Server was deployed.

  5. Create the JAR file.

    cd path
    jar -cvf jar_path/name *

    jar_path is the path to where to place the JAR file.
    name is the name of the JAR file to create.
    path is where Servertec Internet Server was deployed.

  6. Set the CLASSPATH as needed.

    Windows 9x/Me/NT/2000/2003/XP
    set CLASSPATH=jar_path/name;%CLASSPATH%

    Linux/Solaris/Unix
    export CLASSPATH=jar_path/name:$CLASSPATH%

    jar_path is the path to the JAR file.
    name is the name of the JAR file.

  7. Run Servertec Internet Server.

    Windows 9x/Me/NT/2000/2003/XP
    %JAVA_EXE% -classpath %CLASSPATH% stec.iws.iws jar_path/name

    Linux/Solaris/Unix
    $JAVA_EXE -classpath $CLASSPATH stec.iws.iws jar_path/name

    jar_path is the path to the JAR file.
    name is the name of the JAR file.

Notes

The Administrator can not be used to modify configuration files when running the server from a JAR/ZIP archive. top of page


Use the following instructions to deploy Servertec Internet Server to a system conforming to Filesystem Hierarchy Standard.
  1. Update deploy_iws_fhs as needed.

  2. Run deploy_iws_fhs.

    deploy_iws_fhs path

    path the relative base directory where to deploy Servertec Internet Server. Normally stec/iws.

  3. Place your files:

    binary files in /opt/path/bin
    servlet files in /opt/path/classes
    CGI executable files in /var/opt/path/cgi-bin
    html files in /var/opt/path/wwwroot
    image files in /var/opt/path/wwwroot/images
    protected files in /var/opt/path/wwwroot/protected

    path the relative base directory where Servertec Internet Server was deployed. Normally stec/iws.

  4. Update configuration files in /etc/opt/path/config as needed, where path is the directory where Servertec Internet Server was deployed, normally stec/iws.

  5. Update PATH.

    Linux/Solaris/Unix
    export PATH=/opt/path/bin:$PATH

    path the relative base directory where Servertec Internet Server was deployed. Normally stec/iws.

  6. Update CLASSPATH.

    Linux/Solaris/Unix
    export CLASSPATH=/opt/path/classes:$CLASSPATH

    path the relative base directory where Servertec Internet Server was deployed. Normally stec/iws.

  7. Run Servertec Internet Server using:

    iws /etc/opt/path

    path the relative base directory where Servertec Internet Server was deployed. Normally stec/iws.

 top of page
Copyright © 1998-2005 Servertec. All rights reserved.
Privacy Statement.
Last Modified: Sun Sep 04 14:56:49 EDT 2005