Servertec   Internet Server Administrator - Realms
Administrator
Login
Monitor
Control Panel
Manage
Server
Socket
Virtual Hosts
Workgroup
Session
Servlets
Contexts
Aliases
Mime Types
Locales
Messages
Pools
Realms
Resources
Users
Groups
Computers
Access Rights
ACLs
Logger
Templates
File System
Archives

About
Used to list, add, edit, remove, load, unload and reload Realms.

List Form

Servertec Internet Server Administrator - Realms

Actions

ADD Used to add a new Realm.
EDIT Used to edit the selected Realm.
If a Realm has not been selected an error will be displayed.
REMOVE Used to remove the selected Realm.
If a Realm has not been selected an error will be displayed.
LOAD Used to load the selected Realm.
If a Realm has not been selected an error will be displayed.
UNLOAD Used to unload the selected Realm.
If a Realm has not been selected an error will be displayed.
RELOAD Used to reload the selected Realm.
If a Realm has not been selected an error will be displayed.
IMPORT Used to import records into the specified Realm.
If a Realm has not been selected an error will be displayed.
EXPORT Used to export records from the specified Realm.
If a Realm has not been selected an error will be displayed.
SAVE Used to save changes made and to return to the Control Panel form.
CANCEL Used to discard changes made and to return to the Control Panel form.
HELP Used to display online help for this form.

Notes

Loaded Realms are prefixed with an *.

Entry Form

Servertec Internet Server Administrator - Realm Entry

Fields

Realm The name of the realm.
Class File The Class in the form package.class of the Realm to use.
Parameters Any parameters used during the initialization of the Realm.

Zero or more parameters can be specified by entering line delimited key=value pairs.

Actions

OK Used to accept data entered and to return to the Realms form.
CANCEL Used to discard data entered and to return to the Realms form.
HELP Used to display online help for this form.

Import Form

Servertec Internet Server Administrator - Realm Import

Fields

Realm The name of the realm.
Table The database table to import into.
File Name The file on the local file system that contains the records that will be imported.
File Format The format of the file to import, Comma Delimited (CSV) or Fixed Length.
Headers Whether the file being imported contains field headers on the first line.
Overwrite Whether to overwrite existing records.

Actions

Browse... Used to select the local file.
OK Used to submit the data entered and to import the records contained in the specified file. Once the request is process a results form will be displayed showing the number of records that were imported and any errors that may have occurred.
CANCEL Used to discard data entered and to return to the Realms form.
HELP Used to display online help for this form.

Notes

Realm tables must be imported in the following order:
  1. Access Rights
  2. Computers
  3. Users
  4. Groups
  5. Access Control Lists (ACL)
  6. Resources

Export Form

Servertec Internet Server Administrator - Realm Export

Fields

Realm The name of the realm.
Table The database table to export.
File Format The format of the file to generate, Comma Delimited (CSV) or Fixed Length.
Headers Whether to export field headers.

Actions

OK Used to submit the data entered and to export the records contained in the specified table. Once the request is process a results form will be displayed showing the number of records that were exported and any errors that may have occurred.
CANCEL Used to discard data entered and to return to the Realms form.
HELP Used to display online help for this form.

Notes

Changes made will not be used until the server is restarted.

A Realm is a Class that is invoked to check access rights when a request matches a Resource.

Comma Delimited (CSV) Realm tables Import/Export format:
Table Fields
Access Control Lists (ACL) Type,Name,Access_Right
Access Rights Access_Right
Computers Computer,Type
Groups Groupname,Username
Resources URI,Type,Name
Users Username,Password

Fixed Length Realm tables Import/Export format:
Table Fields Length
Access Control Lists (ACL) Type
Name
Access_Right
15
15
15
Access Rights Access_Right 15
Computers Computer
Type
128
15
Groups Groupname
Username
15
15
Resources URI
Type
Name
128
15
15
Users Username
Password
15
15

Configuration

Servertec Internet Server includes support for file, POS and database based realms. File based realms are used to store and retrieve users, groups, access rights and control lists using flat files. POS based realms use Servertec Persistent Object Store and database based realms use any JDBC accessible database.

Select the store to use:
Flat File
Microsoft Access
Oracle
Servertec Persistent Object Store


Use the following steps to configure the file based realm.

  1. Set Class File to stec.iws.FileRealm.

  2. Set Parameters to empty.


Use the following steps to configure the database based realm for Microsoft Access.

  1. Defined a System DSN for the database using the ODBC Data Source Administrator from the Control Panel.

    Driver: Microsoft Access Driver (*mdb)
    Data Source Name: iserver.msaccess
    Database: iws_dir\databases\iserver.mdb

    iws_dir is the directory where the server was installed, normally c:\iws.net.

  2. Set Class File to stec.iws.DatabaseRealm.

  3. Define the following Parameters:

    driver=com.ms.jdbc.odbc.JdbcOdbcDriver
    url=jdbc:odbc:iserver.msaccess

Notes

The realm database makes use of the JDBC-ODBC bridge to access the iserver.mdb database.


Use the following steps to configure the database based realm for Oracle.

  1. If Oracle database server is not running then start it.

  2. If you have not already created an Oracle database for Servertec Internet Server then follow the instructions below to create it.

    1. Start SQLPLUS and login as an administrator.

      sqlplus system/manager

      The user name and password shown above may not be correct on all systems. Please consult the appropriate Oracle documentation or a system database administrator for the correct user name and password.

    2. Create admin user.

      grant connect to admin identified by admin;
      grant dba to admin;
      commit;
      exit

    3. Start SQLPLUS again and this time login using the new admin user.

      sqlplus admin/admin

    4. Assuming that Servertec Internet Server was installed in c:\iws.net, create the database.

      @/iws.net/databases/iserver.sql
      exit

      If Servertec Internet Server was installed in a directory other than c:\iws.net then edit installdir/databases/iserver.sql and change the directory path of the iserver.dbf database to the proper path.

    5. Using the sample TNSNAMES.ORA file in installdir/databases, define a new SQL Net entry named iserver.oracle for Servertec Internet Server.

    6. Start SQL Net Listener.

      lsnrctl start

  3. Set Class File to stec.iws.DatabaseRealm

  4. Define the following Parameters:

    driver=com.ms.jdbc.odbc.JdbcOdbcDriver
    url=jdbc:odbc:iserver.oracle
    user=admin
    password=admin


Use the following steps to configure the Servertec Persistent Object Store realm.
  1. Install and configure Servertec Persistent Object Store.

  2. Set Class File to stec.iws.PosRealm.

  3. Define the following Parameters:

    acls_store=acls_store
    acls_capacity=acls_capacity
    computers_store=computers_store
    computers_capacity=computers_capacity
    groups_store=groups_store
    groups_capacity=groups_capacity
    rights_store=rights_store
    rights_capacity=rights_capacity
    users_store=users_store
    users_capacity=users_capacity

    acls_store the base file name of the ACLs store. If not specified defaults to iws_dir/databases/acls.store.
    acls_capacity the average number of ALCs in the ACLs store.

    The number must be at least 1.

    If not specified defaults to 1024.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    computers_store the base file name of the Computers store. If not specified defaults to iws_dir/databases/computers.store.
    computers_capacity the average number of computers in the Computers store.

    The number must be at least 1.

    If not specified defaults to 1024.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    groups_store the base file name of the Groups store. If not specified defaults to iws_dir/databases/groups.store.
    groups_capacity the average number of groups in the Groups store.

    The number must be at least 1.

    If not specified defaults to 1024.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    rights_store the base file name of the Rights store. If not specified defaults to iws_dir/databases/rights.store.
    rights_capacity the average number of rights in the Rights store.

    The number must be at least 1.

    If not specified defaults to 16.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.

    users_store the base file name of the Users store. If not specified defaults to iws_dir/databases/users.store.
    users_capacity the average number of users in the Users store.

    The number must be at least 1.

    If not specified defaults to 1024.

    Setting this value too small may have a negative impact on performance.

    Setting this value too large will waste disk space.