Servertec   Realms
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
Add-ons
How To
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Users
iServer
Administration
Login
Monitor
Control Panel
Manage
Server
Virtual Hosts
Workgroup
Session
Servlets
Contexts
Aliases
Mime Types
Locales
Country Codes
Messages
Pools
Realms
Resources
Users
Groups
Computers
Access Rights
ACLs
Logger
Templates
Keystore
Certificates
File System
Archives

Deployment

Reference
Samples
Sales
Legal
Feedback

 

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

List Form

iServer 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

iServer Administrator - Realm Entry

Fields

Realm The name of the realm.
Class File The Java Class in the form package.class of the Realm to use.

The CLASSPATH will be searched for the specified Realm.

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

iServer 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

iServer 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.

Configuration

iServer includes support for both file and database based realms. File based realms are used to store and retrieve users, groups, access rights and control lists using flat files and database based realms using any JDBC accessible database.

Select the store to use:
Flat File
Microsoft Access
Oracle
Other


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. Set Class File to stec.iws.DatabaseRealm.
  2. Define the following Parameters:
    driver=sun.jdbc.odbc.JdbcOdbcDriver
    url=jdbc:odbc:iserver.msaccess
    username=admin
    password=admin
  3. If you have not already created a System DSN for iServer then from the Windows Control Panel run ODBC Data Sources (32bit) and add a new System DSN named iserver.msaccess that uses a Microsoft Access driver and that references c:\iws\databases\iserver.mdb, assuming that iServer was installed in c:\iws.

The example provided above makes use of the JDBC-ODBC bridge to access the iserver.mdb database. It will only work under Microsoft Windows 9x/NT and may not work with JView.


Use the following steps to configure the database based realm for Oracle.
  1. Set Class File to stec.iws.DatabaseRealm
  2. Define the following Parameters:
    driver=sun.jdbc.odbc.JdbcOdbcDriver
    url=jdbc:odbc:iserver.oracle
    username=admin
    password=admin
  3. If Oracle database server is not running then start then it.
  4. If you have not already created an Oracle database for iServer 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 iServer was installed in /iws create the database.
      @/iws/databases/iserver.sql
      exit

      If iServer was installed in a directory other than /iws then edit installdir/databases/iserver.sql and change the directory path of the iserver.ora 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 iServer.
    6. Start SQL Net Listener.
      lsnrctl start

The example provided above makes use of the JDBC-ODBC bridge to access the Oracle database. It will only work under Microsoft Windows 9x/NT and may not work with JView.


Use the following steps to configure the database based realm for any JDBC accessible database.
  1. Set Class File to stec.iws.DatabaseRealm
  2. Define the following Parameters:
    driver=driver
    url=url
    username=username
    password=password

    driver The JDBC driver used to access the database.
    url The JDBC URL that references the database.
    username The username.
    password The password.

  3. If you have not already created a database for iServer then using the instruction for configuring database based realm for Oracle as a guideline and /iws/databases/iserver.sql as a template create the appropriate user login, database, tables, stored procedures and views.

Notes

A Realm is a Java 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

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

 top of page
 Built with iScript Copyright © 1997-2000 Servertec. All rights reserved.
Last Modified: Thu Aug 10 13:06:59 EDT 2000