Servertec   Realms
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Users
iServer
Administration
Login
Control Panel
Manage
Server
Session
Servlets
Filters
Aliases
Mime Types
Messages
Pools
Realms
Resources
Users
Groups
Access Rights
ACLs
Logger
Templates

Deployment

Reference
Samples
Sales
Legal
Feedback

 

Used to list, add, edit or remove Realms.

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

Form

iServer Administrator - Realm Entry

Fields

    Realm The name of the realm.
    Class File The package.class name 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.

Configuration

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

    Select the method 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 DNS for iServer then from the Control Panel run ODBC Data Sources (32bit) and add a new System DNS named iserver.msaccess that uses a Microsoft Access driver and assuming that iServer was installed in c:\iws that references c:\iws\databases\iserver.mdb.

    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 first edit /iws/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 /iws/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 accessiable database.

    1. Set Class File to stec.iws.DatabaseLogger
    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.

Actions

    SAVE Used to save changes made and to return the Control Panel form.
    CANCEL Used to discard changes made and to return the Control Panel form.

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.

Notes

    Changes made will not be used until the iServer is restarted.
 top of page
 Built with iScript Copyright © 1997-1999 Servertec. All rights reserved.
Last Modified: Mon Jun 28 23:14:48 EDT 1999