Servertec Command Line
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

 

Starting Servertec Internet Server
Restarting Servertec Internet Server
Stopping Servertec Internet Server


Servertec Internet Server is normally started from the command line using one of the following commands.

Syntax

iws { path | archive }
java { directives } { java_params } stec.iws.iws { path | archive }

Parameters

archive the JAR/ZIP archive containing the Web-site.
directives -Denv=path
This directive is used to specify the path to a file containing carriage-return delimited key=value pairs for any environment variables used by CGI and SSI.

-Dfile.encoding=encoding
This directive is used to specify the default character encoding used when reading and writing configuration files and messages and by servlets such as stec.iws.FileServlet. If not set the platform's default character encoding is used.

-Dconfigdir=configdir
Used to specify the directory where Servertec Internet Server's configuration files are located. ./config is the default value. If a relative directory is specified then the directory is relative to the server's base directory.

-DFORCE_EXIT
Used to force the server to shutdown. This directive disables the shutdown hook and forces the server to call System.exit() after the server has shutdown. This directive should be used if the server hangs when it is being shutdown and -DFORCE_SHUTDOWN does not work.

-DFORCE_SHUTDOWN
This directive causes the server to issue a dummy request on shutdown. This directive should be used if the server hangs when it is being shutdown.

-DDISABLE_SHUTDOWN_HOOK
This directive disabled the shutdown hook. This directive should only be used if the Java VM being used does not support Java's ShutdownHook.

-DSERVICE
This directive specifies that the server is running as a service and should not call System.exit() after the server has shutdown. This directive should be used if running as a Windows 9x/Me/NT/2000/2003/XP service or from withing a Java program that should not exit when the server is shutdown.

java is the Java VM, normally java.
java_params are any optional parameters used by the Java VM.
path optional directory where Servertec Internet Server was installed or deployed, normally c:\iws for Windows 9x/Me/NT/2000/2003/XP, /iws for Linux/Solaris/Unix and SYS:\iws for Novell Netware.

Servertec Internet Server searches for its configuration files relative to this path. If not specified the current directory is used.

Notes

Servertec Internet Server must be stopped using the Administrator or from the command line using stop_iws and not by killing or breaking out of the program. Doing so may prevent normal process cleanup from occurring and may result in data corruption and loss.

iws is a C wrapper that starts Servertec Internet Server. It uses JAVA_EXE, an environment variable, to determine which Java VM to use. Internally it copies all environment variables to a temporary file then it invokes the server and on exit, depending on the return code, it stops or restarts the server and removes the temporary file it created when the server was started.

When running Servertec Internet Server without using the C wrapper iws, Restart from the Administrator and restart_iws will stop the server.

iws will not run when SSL is enabled unless one or more valid certificates exist in the keystore.

Example

iws /home/iws

top of page


Servertec Internet Server can be restarted from the command line using one the following commands.

Syntax

restart_iws {protocol://}hostname:port id password
java { java_params } iwsCommand restart hostname:port id password
java { java_params } iwsSSLCommand restart hostname:port id password

Parameters

hostname the name of the server where Servertec Internet Server is currently running, normally localhost
id the user id of the administrator, normally admin.
java is the Java VM, normally java.
java_params are any optional parameters used by the Java VM.
password the password used by the administrator, normally admin.
port the port number that Servertec Internet Server is listening on, normally 8080.
protocol the Web protocol, [http|https], normally http.

Notes

restart_iws calls iwsCommand when the protocol specified is http and calls iwsSSLCommand when the protocol specified is https.

iwsCommand should be used when Secure Socket Layer (SSL) is disabled and iwsSSLCommand should be used when Secure Socket Layer (SSL) is enabled.

When SSL is enabled restart_iws and iwsSSLCommand will display untrusted server cert chain if Java's cacerts keystore does not contain a valid root CA certificate for the server's certificate.

Servertec Internet Server can also be restarted using the Administrator.

Example

restart_iws localhost:8080 admin admin top of page


Servertec Internet Server can be stopped from the command line using one the following commands.

Syntax

stop_iws {protocol://}hostname:port id password
java { java_params } iwsCommand stop hostname:port id password
java { java_params } iwsSSLCommand stop hostname:port id password

Parameters

hostname the name of the server where Servertec Internet Server is currently running, normally localhost
id the user id of the administrator, normally admin.
java is the Java VM, normally java.
java_params are any optional parameters used by the Java VM.
password the password used by the administrator, normally admin.
port the port number that Servertec Internet Server is listening on, normally 8080.
protocol the Web protocol, [http|https], normally http.

Notes

stop_iws calls iwsCommand when the protocol specified is http and calls iwsSSLCommand when the protocol specified is https.

iwsCommand should be used when Secure Socket Layer (SSL) is disabled and iwsSSLCommand should be used when Secure Socket Layer (SSL) is enabled.

When SSL is enabled restart_iws and iwsSSLCommand will display untrusted server cert chain if Java's cacerts keystore does not contain a valid root CA certificate for the server's certificate.

Servertec Internet Server can also be stopped using the Administrator.

Example

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