Servertec   iServer
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
Add-ons
How To
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Users
iServer
Administration
Deployment

Reference
Samples
Sales
Legal
Feedback

 

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
 top of page
 Built with iScript Copyright © 1997-2000 Servertec. All rights reserved.
Last Modified: Thu Aug 10 13:06:59 EDT 2000