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 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
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.
|
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.
- Set Class File to stec.iws.FileRealm.
- Set Parameters to empty.
Use the following steps to configure the database based realm for Microsoft
Access.
- Set Class File to stec.iws.DatabaseRealm.
- Define the following Parameters:
driver=sun.jdbc.odbc.JdbcOdbcDriver
url=jdbc:odbc:iserver.msaccess
username=admin
password=admin
- 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.
- Set Class File to stec.iws.DatabaseRealm
- Define the following Parameters:
driver=sun.jdbc.odbc.JdbcOdbcDriver
url=jdbc:odbc:iserver.oracle
username=admin
password=admin
- If Oracle database server is not running then start then it.
- If you have not already created an Oracle database for iServer 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 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.
- Using the sample TNSNAMES.ORA file in
installdir/databases, define a new SQL Net entry named
iserver.oracle for iServer.
- 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.
- Set Class File to stec.iws.DatabaseRealm
- 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.
|
- 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.
|