Documentation
Conventions
Command Line
Administrator
Localization
Programming
Security
Performance
Deployment
Java API
Servlet API
CGI
SSI
Servlets
Config Files
Log Files
Classes
Directory Tree
Return
|
Select deployment method:
Directory
JAR/ZIP file
Filesystem Hierarchy Standard (FHS)
Use the following instructions to deploy Servertec Internet Server to a
directory.
- Update deploy_iws as needed.
- Run deploy_iws.
deploy_iws path
|
path
|
directory where to deploy Servertec Internet Server.
|
- 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.
|
- Update configuration files in path/config as needed,
where path is the directory where Servertec Internet Server was deployed.
- 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.
|
- 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.
|
- 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.
- Use the instructions above to deploy Servertec Internet Server to a
Directory.
- 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.
|
- 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.
|
- 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.
|
- 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.
|
- 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.
|
- 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.
- Update deploy_iws_fhs as needed.
- Run deploy_iws_fhs.
deploy_iws_fhs path
|
path
|
the relative base directory where to deploy Servertec Internet Server.
Normally stec/iws.
|
- 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.
|
- Update configuration files in /etc/opt/path/config
as needed, where path is the directory where Servertec Internet Server was
deployed, normally stec/iws.
- 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.
|
- 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.
|
- Run Servertec Internet Server using:
iws /etc/opt/path
|
path
|
the relative base directory where Servertec Internet Server was deployed.
Normally stec/iws.
|
|
|