Configuration of DPF Tracker - passwd.cfg¶
The %SEAL_CUSTOMDIR%\server\web\conf\passwd.cfg
configuration file is available after [activating the users and rights management] ??? Todo: Link for DPF Tracker.
[DPFTRACKER] Section¶
The [DPFTRACKER]
section in passwd.cfg
contains the generally valid settings for the display in DPF Tracker and the privileges of the users.
The settings in the [DPFTRACKER]
sections can be overwritten by the groupspecific settings in the [group_name]
section.
The following keywords are available in the [DPFTRACKER]
section:
INTERACTIVE_SHOW_ALL_JOBS¶
INTERACTIVE_SHOW_ALL_JOBS
specifies if all jobs are displayed for editing in the interactive working unit, that means including these jobs that are being edited by another user.
Available values: Boolean
-
N
The jobs that are being edited by another user will not be displayed.
-
Y
All jobs will be displayed.
Default: N
Literature - how to create an interactive working unit
Refer to Create an Interactive Working Unit.
INTERACTIVE_TRACKER_SEARCH_PROCESS¶
INTERACTIVE_TRACKER_SEARCH_PROCESS
specifies the process whose jobs are displayed for editing in the interactive working unit.
Available values: String
-
<procname>
The jobs for the
<procname>
process will be displayed for editing in the interactive working unit.
Default: none
Literature - how to create an interactive working unit
Refer to Create an Interactive Working Unit.
INTERACTIVE_USE_NWC¶
INTERACTIVE_USE_NWC
specifies if a SEALCC or a PLOSSYS Webclient form will be used for editing the jobs in the interactive working unit.
Available values: Boolean
-
N
A SEALCC form will be used.
-
Y
A PLOSSYS Webclient form will be used.
Default: N
Literature - how to create an interactive working unit
Refer to Create an Interactive Working Unit.
TRACKER¶
TRACKER
contains the privileges of the users of DPF Tracker, that means which operations on which jobs may be executed by the user. Multiple privileges are separated by blanks.
Available values: Enumeration
-
ALL
The user may everything with all jobs.
-
BULK_CHANGE
The user may execute multi-operations with all jobs.
-
CHANGE_ALL
The user may cancel, repeat and delete all jobs.
-
CHANGE_OWN
The user may cancel, repeat and delete their jobs.
-
LIST_ALL
The user may display all jobs.
-
MATCH_IP
A job is considered an own job if only the IP address matches and the
JOBUSERNAME
parameter does not match the logon name. -
READ_ALL
The user may display the details (parameters, log file, history) of all jobs.
-
READ_OWN
The user may display the details (parameters, log file, history) of their own jobs.
-
VIEW_FILES
The user may display and download the files belonging to their own jobs.
-
VIEW_FILES_ALL
The user may display and download the files belonging to all jobs.
Default: The user must not execute any operations. ??? Todo: Was ist die Kurzschrift dafür?
TRACKER_COLUMNS¶
TRACKER_COLUMNS
contains the columns displayed in the job list. Multiple columns are separated by blanks.
Available values: String
-
<parameter>
Column with the values of any job parameter
-
JOBACTIONS
Column containing the operation icons
-
JOBDURATION
Column containing the job duration
-
JOBFINALSTATUS
Column containing the current job status values with icons
-
JOBFINALSTATUSICON
Column containing the current job status values as icons without texts
-
JOBID
Column containing the job IDs with links to the jobs
-
JOBIDNOLINK
Column containing the job IDs without links to the jobs
-
JOBNAME
Column containing the job names or the job IDs unless
JOBNAME
has been set with links to the jobs; the second lines contain the job IDs -
JOBNAMENOID
Column containing the job names or the job IDs unless
JOBNAME
has been set with links to the jobs -
JOBNAMENOLINK
Column containing the job names or the job IDs unless
JOBNAME
has been set without links to the jobs -
JOBPRIORITY
Column containing the job priorities
-
JOBSTATE
Column containing the status values of the jobs (
FINISHED
orACTIVE
for example) -
JOBTSCHANGED
Column containing the times of the latest job changes
-
JOBTSDELETE
Column containing the times when the jobs will be deleted
-
JOBTSFINISHED
Column containing the times when the jobs were finished
-
JOBTSFORGET
Column containing the times when the jobs will be deleted completely
-
JOBTSINSERTED
Column containing the times when the jobs were added
-
JOBUSERNAME
Column containing the user names of the jobs
-
WFNAME
Column containing the names of the current processes
-
WFNAMENOBREAK
Column containing the names of the current processes without line break
-
WUNODENAME
Column containing the names of the servers where the jobs are being executed.
Default: No columns are displayed. ??? Todo: Was heißt das? Ist der Wert dann leer?
TRACKER_DEFAULT_JOBHISTORY_LINK¶
TRACKER_DEFAULT_JOBHISTORY_LINK
specifies the target of the link in the History
tab in the job details.
Available values: Enumeration
-
logfile
The link in the History tab opens the
Log File
tab. -
viewpar
The link in the History tab opens the
Parameters
tab.
Default: logfile
TRACKER_DEFAULT_JOBLIST_SORT_COLUMN¶
TRACKER_DEFAULT_JOBLIST_SORT_COLUMN
specifies the parameter which is used for sorting the job list. The parameter must also be specified in TRACKER_COLUMNS
.
Available values: String
-
<parameter>
Refer to the available values for
TRACKER_COLUMNS
.
Default: JOBID
TRACKER_DEFAULT_JOBLIST_SORT_ORDER¶
TRACKER_DEFAULT_JOBLIST_SORT_ORDER
specifies the sorting order of the job list.
Available values: Enumeration
-
ASC
The job list will be sorted ascending.
-
DESC
The job list will be sorted descending.
Default: DESC
TRACKER_DEFAULT_JOBLIST_TAB¶
TRACKER_DEFAULT_JOBLIST_TAB
specifies the tab of the job list displayed when opening DPF Tracker.
Available values: Enumeration
-
active
The
Active
tab will be displayed. -
all
The
All
tab will be displayed. -
error
The
Error
tab will be displayed. -
finished
The
Finished
tab will be displayed.
Default: all
TRACKER_DEFAULT_JOBVIEW_TAB¶
TRACKER_DEFAULT_JOBVIEW_TAB
specifies the tab displayed when opening the job details.
Available values: Enumeration
-
files
The
Files
tab of the job details will be displayed. -
graph
The
Process
tab of the job details will be displayed. -
history
The
History
tab of the job details will be displayed. -
logfile
The
Log File
tab of the job details will be displayed. -
parameter
The
Parameters
tab of the job details will be displayed.
Default: logfile
TRACKER_DEFAULT_SEARCH¶
TRACKER_DEFAULT_SEARCH
specifies a search item. In the job list, only the hits when searching this search item are displayed.
Available values: String
Default: none
??? Todo: Beispiel?
TRACKER_DEFAULT_SEARCH_PROCESS¶
TRACKER_DEFAULT_SEARCH_PROCESS
specifies the process whose jobs will be displayed. The filter uses the process to which the job has been assigned.
Available values: String
-
<procname>
The jobs for the
<procname>
process will be displayed.
Default: none
TRACKER_JOBS_PER_PAGE¶
TRACKER_JOBS_PER_PAGE
specifies how many jobs will be displayed per page.
Available values: Enumeration
-
10
10 jobs will be displayed per page.
-
20
20 jobs will be displayed per page.
-
30
30 jobs will be displayed per page.
-
50
50 jobs will be displayed per page.
-
100
100 jobs will be displayed per page.
Default: 10
TRACKER_REFRESH¶
TRACKER_REFRESH
specifies the interval used for refreshing the job list after activating the regular update.
Available values: Integer
-
<s>
Refresh interval in seconds; the user must activate the regular update; refresh every
<s>
seconds -
<-s>
Refresh interval in seconds; the regular update will be activated; refresh every
<s>
seconds
Default: 10
[DPFTRACKER\LANGUAGE\lang]¶
In the [DPFTRACKER\LANGUAGE\lang]
subsections, you specify the column titles for the specific language.
Available values: String
-
<param> = <title>
In the column containing the
<param>
parameter,<title>
is displayed as title.
Default: The parameter name is displayed as title.
Example for the [DPFTRACKER] Section¶
By default, the All
tab is displayed when opening DPF Tracker and the Log File
tab when opening the job details. The link in the History
tab opens the log file, too. Per page, 20 jobs are displayed. The column containing the messages from DpfJobMessage
is titled Meldung
in the German version and Message
in the English one.
[DPFTRACKER]
TRACKER_DEFAULT_JOBLIST_TAB = all
TRACKER_DEFAULT_JOBVIEW_TAB = logfile
TRACKER_DEFAULT_JOBHISTORY_LINK = logfile
TRACKER_JOBS_PER_PAGE = 20
[DPFTRACKER\LANGUAGE\DE]
DpfJobMessage = Meldung
[DPFTRACKER\LANGUAGE\EN]
DpfJobMessage = Message
[GLOBAL] Section¶
The [GLOBAL]
section in passwd.cfg contains the user groups and the connection data to the directory service.
The following keywords are available in the [GLOBAL]
section: keywords
GROUPS¶
GROUPS
contains the names of the user groups.
SEALCC
Do not change the GROUPS
keyword in the [GLOBAL]
section manually but use the users and rights management in SEALCC.
For more information, refer to the documentation:
LDAP¶
LDAP
specifies if the users and rights management is connected to a directory service.
Available values: Boolean
-
N
The users and rights management will not be connected to a directory service.
-
Y
The users and rights management will be connected to a directory service.
Default: N
LDAP_BASE¶
LDAP_BASE
specifies the BaseDN as of which the search for the user will be started in the directory tree.
Available values: String
Default: none
LDAP_GROUP_ATTRIBUTES¶
LDAP_GROUP_ATTRIBUTES
specifies the LDAP field name specifying the group name.
Available values: String
Default: none
LDAP_GROUP_DEFAULT¶
LDAP_GROUP_DEFAULT
specifies the group to which a user is assigned if an explicit mapping does not exist for them.
Available values: String
Default: none
LDAP_GROUP_DN LDAP_USER_DN¶
LDAP_GROUP_DN LDAP_USER_DN
specifies the distinguished name (DN) the groups are searched for.
Available values: String
Default: none
LDAP_GROUP_FILTER¶
LDAP_GROUP_FILTER
specifies how the group information will be evaluated.
Available values: String
Default: none
LDAP_PORT¶
LDAP_PORT
specifies the port number under which the directory service can be reached.
Available values: String
Default: none
LDAP_SEARCH_DN¶
LDAP_SEARCH_DN
specifies the distinguished name (DN) of the search user, that means the user who may log on to the directory service for searching.
Available values: String
Default: none
LDAP_SEARCH_PWD¶
LDAP_SEARCH_PWD
specifies the password for the search user.
Available values: String
Default: none
Hint - encrypt
Call the following command in order that the password will be entered encrypted into LDAP_SEARCH_PWD
.
tools\sealcc\ldaptest.pl -storepwd -user user
LDAP_SERVER¶
LDAP_SERVER
specifies the server where the directory service is running.
Available values: String
Default: none
LDAP_USER_DN¶
LDAP_USER_DN
specifies the distinguished name (DN) the users are searched for.
Available values: String
Default: none
LDAP_USER_FILTER¶
LDAP_USER_FILTER
specifies how the user information will be evaluated.
Available values: String
Default: none
LDAP_VERSION¶
LDAP_VERSION
specifies the version of the LDAP protocol.
Available values: Integer
Default: none
Example for the [GLOBAL] Section¶
[GLOBAL]
GROUPS = USER ADMINISTRATOR ANONYMOUS
LDAP = N
LDAP_SERVER = roettvmwl
LDAP_PORT = 389
LDAP_BASE = dc=maxcrc,dc=com
LDAP_VERSION = 3
LDAP_SEARCH_DN = CN=searchuser,DC=test,DC=local
LDAP_SEARCH_PWD = encrypted
LDAP_USER_DN = ou=users,dc=test,dc=com
LDAP_USER_FILTER = (&(objectclass=*)(uid=%user%))
LDAP_GROUP_DN = ou=groups,dc=test,dc=com
LDAP_GROUP_FILTER = (&(objectclass=groupOfNames) (member=uid=...))
LDAP_GROUP_ATTRIBUTES = cn
LDAP_GROUP_DEFAULT = USER
[GROUP_MAPPING] Section¶
The [GROUP_MAPPING]
section in passwd.cfg contains the mapping of the SEALCC groups to the LDAP groups line-by-line in the following format:
ldap_group = sealcc_group
SEALCC LDAP Connection
For more information, refer to SEAL Control Center, System Description and SEALCC LDAP Connection.
Example for the [GROUP_MAPPING] Section¶
[GROUP_MAPPING]
Support = USER
Sysadmin = ADMINISTRATOR
[group_name] Section¶
The [<group_name>]
section in passwd.cfg contains the settings for the display in DPF Tracker and the privileges that are specific for the users of the <group_name>
user group.
The generally valid settings are specified in the [DPFTRACKER]
section.
In the [<group_name>]
section, the same keywords as in the [DPFTRACKER]
section keywords are available.
Example for the [ANONYMOUS] Section¶
[ANONYMOUS]
TRACKER = READ_OWN MATCH_IP
TRACKER_COLUMNS = JOBNAME JOBUSERNAME WFNAME JOBFINALSTATUS
[LOGIN] Section¶
The [LOGIN]
section in passwd.cfg
contains the settings of the user accounts.
SEALCC
Do not change the GROUPS
keyword in the [GLOBAL]
section manually but use the users and rights management in SEALCC.
For more information, refer to the documentation:
Example for the [LOGIN] Section¶
[LOGIN]
sample = $2a$0...
Admin = $2a$05...
sealsupport = $2a$05...
[Admin]
GROUP = ADMINISTRATOR
[sample]
GROUP = USER
[sealsupport]
GROUP = ADMINISTRATOR
NAME = Built-In SEAL Support User
FULLNAME = Built-In SEAL Support User