Starting iServer
Restarting iServer
Stopping iServer
iServer is normally started from the command line using one of the following commands.
Syntax
iws { path | archive }
javavm { -Denv=envfile } { javavm_params } stec.iws.iws { path | archive }
Parameters
archive
|
the JAR/ZIP archive containing the Web-site.
|
envfile
|
is an optional file name, including path, to a file that contains
carriage-return delimited key=value pairs for any
environmental variables that maybe needed by CGI and SSI.
|
javavm
|
is the Java VM, normally java.
|
javavm_params
|
are any optional parameters used by the Java VM.
|
path
|
optional directory where iServer was installed or deployed, normally
c:\iws for WIN32 and /iws for Linux/Unix.
iServer searches for its configuration files relative to this path. If not
specified the current directory is used.
|
Notes
iServer must be stopped using the iServer Administrator or from the command
line using stop_iws and not by killing or breaking out of the program. Doing
so will prevent normal process cleanup from occurring and may result in data
corruption and loss.
iws is a C wrapper that runs iServer. It uses JAVA_EXE, an
environmental variable, to determine which Java VM to use. Internally it
copies all environmental variables to a temporary file then it invokes
iServer and on exit, depending on the return code, it stops or restarts
iServer and removes the temporary file it created when iServer was started.
When running iServer without using the C wrapper iws, Restart from the
iServer Administrator and restart_iws will stop iServer.
iws will not run unless one or more valid non test certificates exist
in the keystore and the corresponding root CA certificates exist in Java's
cacerts keystore
Example
iws /home/iws
top of page
iServer can be restarted from the command line using one the following commands.
Syntax
restart_iws {protocol://}hostname:port id password
javavm { javavm_params } iwsCommand restart hostname:port id password
javavm { javavm_params } iwsSSLCommand restart hostname:port id password
Parameters
hostname
|
the name of the server where iServer is currently running, normally localhost
|
id
|
the user id of the administrator, normally admin.
|
javavm
|
is the Java VM, normally java.
|
javavm_params
|
are any optional parameters used by the Java VM.
|
password
|
the password used by the administrator, normally admin.
|
port
|
the port number that iServer 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 is used when Secure Socket Layer (SSL) is disabled and
iwsSSLCommand is used when Secure Socket Layer (SSL) is enabled.
restart_iws and iwsSSLCommand will not run unless one or
more valid non test certificates exist in the keystore and the corresponding
root CA certificates exist in Java's cacerts keystore
iServer can also be restarted using the iServer Administrator.
Example
restart_iws localhost:8080 admin admin
top of page
iServer can be stopped from the command line using one the following commands.
Syntax
stop_iws {protocol://}hostname:port id password
javavm { javavm_params } iwsCommand stop hostname:port id password
javavm { javavm_params } iwsSSLCommand stop hostname:port id password
Parameters
hostname
|
the name of the server where iServer is currently running, normally localhost
|
id
|
the user id of the administrator, normally admin.
|
javavm
|
is the Java VM, normally java.
|
javavm_params
|
are any optional parameters used by the Java VM.
|
password
|
the password used by the administrator, normally admin.
|
port
|
the port number that iServer 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 is used when Secure Socket Layer (SSL) is disabled and
iwsSSLCommand is used when Secure Socket Layer (SSL) is enabled.
stop_iws and iwsSSLCommand will not run unless one or
more valid non test certificates exist in the keystore and the corresponding
root CA certificates exist in Java's cacerts keystore
iServer can also be stopped using the iServer Administrator.
Example
stop_iws localhost:8080 admin admin
|