Used to list, add, edit, remove, load, unload and reload Realms.
List Form
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
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
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:
- Access Rights
- Computers
- Users
- Groups
- Access Control Lists (ACL)
- Resources
Export Form
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.
- Set Class File to stec.iws.FileRealm.
- Set Parameters to empty.
Use the following steps to configure the database based realm for Microsoft
Access.
- 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.
- Set Class File to stec.iws.DatabaseRealm.
- 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.
- If Oracle database server is not running then start it.
- If you have not already created an Oracle database for Servertec
Internet Server then follow the instructions below to create it.
- 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.
- Create admin user.
grant connect to admin identified by admin;
grant dba to admin;
commit;
exit
- Start SQLPLUS again and this time login using the new admin
user.
sqlplus admin/admin
- 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.
- Using the sample TNSNAMES.ORA file in
installdir/databases, define a new SQL Net entry named
iserver.oracle for Servertec Internet Server.
- Start SQL Net Listener.
lsnrctl start
- Set Class File to stec.iws.DatabaseRealm
- 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.
- Install and configure Servertec Persistent Object Store.
- Set Class File to stec.iws.PosRealm.
- 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.
|
|