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
|