Servertec How To
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
How To
Change Log
Future Plans
Knowledge Base
Documentation
Examples
Legal
Contact Us

 

Select what you would like to do:
Start Servertec Internet Server
Test Servertec Internet Server
Administer Servertec Internet Server
Stop Servertec Internet Server
Test Servertec Internet Server Gateway
Setup Servertec Internet Server as a Windows NT/2000/2003/XP Service
Automatically run Servertec Internet Server when Windows 9x/Me starts
Create Custom Servlets


To start Servertec Internet Server:

Open a command shell and enter:

    iws { path | archive }
archive the JAR/ZIP archive containing the Web-site to use.
path is the directory where Servertec Internet Server was installed or deployed, normally c:\iws.net.

top of page


To test Servertec Internet Server:

Run Servertec Internet Server and from a Web Browser enter:

    protocol://hostname:port
hostname the name of the computer running Servertec Internet Server, normally localhost
port the port number Servertec Internet Server is listening on, normally 8080
protocol the Web protocol, normally http

Then click on Samples, click on the sample to run and click on run.

top of page


To administer Servertec Internet Server:

Assuming Servertec Internet Server is already running from a Web Browser enter:

    protocol://hostname:port/admin.html
hostname the name of the computer running Servertec Internet Server, normally localhost
port the port number Servertec Internet Server is listening on, normally 8080
protocol the Web protocol, normally http

Then login by entering admin for Username and admin for Password. Once login click on the name of the Server to administer and then in the Control Panel click on Manage.

top of page


To stop Servertec Internet Server:

Assuming Servertec Internet Server is already running from a command shell enter:

    stop_iws {protocol://}hostname:port username password
hostname the name of the computer running Servertec Internet Server, normally localhost
password the password used by the administrator, normally admin
port the port number Servertec Internet Server is listening on, normally 8080
protocol the Web protocol, normally http
username the user id of the administrator, normally admin

or from a Web Browser enter:

    protocol://hostname:port/admin.html
hostname the name of the computer running Servertec Internet Server, normally localhost
port the port number Servertec Internet Server is listening on, normally 8080
protocol the Web protocol, normally http

Then login by entering admin for Username and admin for Password. Once login click on the name of the Server to shut down, normally localhost:8080 and then in the Control Panel click on the STOP button.

top of page


To test an Servertec Internet Server Gateway:

Install and configure Servertec Internet Server and the appropriate Gateway, start Servertec Internet Server and then the Web/Application Server and finally from a Web Browser enter:

    protocol://hostname:port/servlet/HelloServlet
hostname the name of the computer running the Application/Web Server, normally localhost
port the port number the Application/Web Server is listening on, normally 80
protocol the Web protocol, normally http

top of page


To setup Servertec Internet Server as a Windows NT/2000/2003/XP Service:
  1. Install and configure Servertec Internet Server.

  2. Using iws_dir\install\win32\iserver.ini as a template, create iserver.ini in Windows directory, normally c:\WINNT in Windows NT/2000/2003 and c:\Windows in Windows XP.

      [jservice]
      Debug=debug
      IWS_PATH=iws_dir
      hostname=hostname
      port=port
      username=username
      password=password

    debug whether to dump information useful in debugging jservice, normally false
    hostname the name of the computer running Servertec Internet Server, normally localhost
    iws_dir the base directory where Servertec Internet Server was installed or deployed, normally c:\iws.net
    password the password used by the administrator, normally admin
    port the port number Servertec Internet Server is listening on, normally 80
    username the user id of the administrator, normally admin

  3. Open an MS-DOS Prompt and enter:

    jservice -i

  4. Restart the computer.

Notes:
When running Windows NT environment variables must be defined in
Start->Settings->Control Panel->System->Environment->System Variables.

When running Windows 2000 environment variables must be defined in
Start->Settings->Control Panel->System->Advanced->Environment Variables-> System Variables.

When running Windows XP environment variables must be defined in Control Panel->System->Advanced->Environment Variables->System Variables.

When Debug is set to true, jservice.log is created in c:\temp directory.

To remove Servertec Internet Server NT/2000/2003/XP Service, open an MS-DOS Prompt and enter:

    jservice -r

top of page


To automatically run Servertec Internet Server when Windows 9x/Me starts:
  1. Install and configure Servertec Internet Server.

  2. Open an MS-DOS Prompt and enter:

    cd iws_dir\install\win32.

    iws_dir is the directory where Servertec Internet Server was installed, normally c:\iws.net

  3. Change iServer.reg as needed.

  4. From the MS-DOS Prompt enter:

    regedit iServer.reg.

  5. Restart the computer.

Notes:
When Servertec Internet Server is started this way it will only start when a user is logged on and will need to be manually stopped using stop_iws or from the Administrator before the user logs off or the system is shut down or restarted. Ctrl+C or Ctrl+Break should not be used to stop Servertec Internet Server.

top of page


To create a custom servlets:
  1. Start Microsoft Visual Studio .NET.

  2. Create new C++, C#, J# or Visual Basic .NET Class Library project.

  3. Add required vjslib component reference.

  4. Add iws_dir\bin\win32\iws.net.dll component reference.

  5. Add any existing classes.

  6. Create new classes as needed.

  7. Build solution.

  8. Copy class library to iws_dir\bin\win32.

  9. Add alias definitions for Servlets to iws_dir\config\aliases.ini.

  10. Add servlet definitions for Servlets to iws_dir\config\servlets.ini.

Notes:
Microsoft J# supports Java 1.1.4 API.

Existing Java classes that use features found in later releases of Java will need to be ported.

 top of page
Copyright © 1998-2005 Servertec. All rights reserved.
Privacy Statement.
Last Modified: Sun Sep 04 14:57:18 EDT 2005