Servertec realms.ini
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
How To
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Command Line
Administrator
Localization
Programming
Security
Performance
Deployment
Server API
Servlet / JSP API
Xerces API
CGI
SSI
Servlets
Config Files
acl.ini
aliases.ini
archives.ini
computers.ini
contexts.ini
dbpools.ini
groups.ini
hosts.ini
iws.ini
locales.ini
logger.ini
messages.ini
mimetypes.ini
realms.ini
resources.ini
rights.ini
servlets.ini
session.ini
templates.ini
users.ini
workgroup.ini

Log Files
Classes
Directory Tree
Examples
Legal
Contact Us

 

realms.ini, used to store Realm definitions.

Syntax

alias = class_file{?parameter{&parameter}...}

alias the name of the Realm.
class_file the Class in the form package.class of the Realm to use.
parameter any parameters used during the initialization of the Realm.

Zero or more & delimited key=value pairs can be specified.

Notes

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

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

Example

msaccess = stec.iws.DatabaseRealm
?driver=com.ms.jdbc.odbc.JdbcOdbcDriver
&url=jdbc:odbc:iserver.msaccess

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.

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