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 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
-
NThe jobs that are being edited by another user will not be displayed.
-
YAll 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
-
NA SEALCC form will be used.
-
YA 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
-
ALLThe user may everything with all jobs.
-
BULK_CHANGEThe user may execute multi-operations with all jobs.
-
CHANGE_ALLThe user may cancel, repeat and delete all jobs.
-
CHANGE_OWNThe user may cancel, repeat and delete their jobs.
-
LIST_ALLThe user may display all jobs.
-
MATCH_IPA job is considered an own job if only the IP address matches and the
JOBUSERNAMEparameter does not match the logon name. -
READ_ALLThe user may display the details (parameters, log file, history) of all jobs.
-
READ_OWNThe user may display the details (parameters, log file, history) of their own jobs.
-
VIEW_FILESThe user may display and download the files belonging to their own jobs.
-
VIEW_FILES_ALLThe user may display and download the files belonging to all jobs.
Default: The user must not execute any operations.
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
-
JOBACTIONSColumn containing the operation icons
-
JOBDURATIONColumn containing the job duration
-
JOBFINALSTATUSColumn containing the current job status values with icons
-
JOBFINALSTATUSICONColumn containing the current job status values as icons without texts
-
JOBIDColumn containing the job IDs with links to the jobs
-
JOBIDNOLINKColumn containing the job IDs without links to the jobs
-
JOBNAMEColumn containing the job names or the job IDs unless
JOBNAMEhas been set with links to the jobs; the second lines contain the job IDs -
JOBNAMENOIDColumn containing the job names or the job IDs unless
JOBNAMEhas been set with links to the jobs -
JOBNAMENOLINKColumn containing the job names or the job IDs unless
JOBNAMEhas been set without links to the jobs -
JOBPRIORITYColumn containing the job priorities
-
JOBSTATEColumn containing the status values of the jobs (
FINISHEDorACTIVEfor example) -
JOBTSCHANGEDColumn containing the times of the latest job changes
-
JOBTSDELETEColumn containing the times when the jobs will be deleted
-
JOBTSFINISHEDColumn containing the times when the jobs were finished
-
JOBTSFORGETColumn containing the times when the jobs will be deleted completely
-
JOBTSINSERTEDColumn containing the times when the jobs were added
-
JOBUSERNAMEColumn containing the user names of the jobs
-
WFNAMEColumn containing the names of the current processes
-
WFNAMENOBREAKColumn containing the names of the current processes without line break
-
WUNODENAMEColumn containing the names of the servers where the jobs are being executed.
Default: No columns are displayed.
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
-
logfileThe link in the History tab opens the
Log Filetab. -
viewparThe link in the History tab opens the
Parameterstab.
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
-
ASCThe job list will be sorted ascending.
-
DESCThe 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
-
activeThe
Activetab will be displayed. -
allThe
Alltab will be displayed. -
errorThe
Errortab will be displayed. -
finishedThe
Finishedtab 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
-
filesThe
Filestab of the job details will be displayed. -
graphThe
Processtab of the job details will be displayed. -
historyThe
Historytab of the job details will be displayed. -
logfileThe
Log Filetab of the job details will be displayed. -
parameterThe
Parameterstab 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
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
-
1010 jobs will be displayed per page.
-
2020 jobs will be displayed per page.
-
3030 jobs will be displayed per page.
-
5050 jobs will be displayed per page.
-
100100 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
-
NThe users and rights management will not be connected to a directory service.
-
YThe 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