 |
 |
 |
 |
Server Configuration
The CorporateTime Server contains four UNIX daemons / multi-threaded Windows NT services with an extra daemon/service added for implementations using CorporateConnect. Administrators can control and define the server environment and behaviour using an extensive number of configurable parameters.
This chapter examines the function of each daemon/service, and the overall structure of the CorporateTime Server architecture. A section follows outlining the information needed to optimally tune and configure CorporateTime Server for your environment.
CorporateTime daemons / services
The five (5) CorporateTime Server daemons / services are:
- "CorporateTime Lock Manager"
- "CorporateTime Engine"
- "CorporateTime Synchronous Network Connection"
- "CorporateTime Corporate-Wide Services"
- "CorporateTime Directory Access Server" (CorporateConnect only)
CorporateTime Lock Manager
The CorporateTime Lock Manager (unilckd) manages the concurrent access to local nodes (sometimes referred to as local databases). In other words, the function of this daemon/service is to queue and process the many requests for node access coming from CorporateTime Engine threads. Both the CorporateTime Lock Manager and the CorporateTime Engine must be running to operate the CorporateTime Server.
CorporateTime Engine
The CorporateTime Engine (uniengd) is the database engine for CorporateTime Server. It provides functionality to accept and service client requests. Since many of these requests can be received at the same time, the servicing CorporateTime Engines must rely on the CorporateTime Lock Manager to ensure orderly access to the local nodes. Thus, as mentioned above, both the CorporateTime Lock Manager and the CorporateTime Engine must be running for access to local nodes.
CorporateTime Synchronous Network Connection
The CorporateTime Synchronous Network Connection daemon/service (unisncd) fulfills two roles in the CorporateTime Server architecture. In all implementations, the unisncd is used to maintain open TCP/IP connections to other nodes on the network and to grant those connections to clients that request access to another node. The connections granted are unidirectional: from a current node to another node, but not vice versa. It is therefore important to ensure that node connections are set in both directions. A unique node identification number called a node-ID distinguishes each node. A group of nodes connected together form a node network.
In its second function, used only in implementations with a directory server, the unisncd acts as a broker in granting connections to the Directory Access Server (unidasd).
The CorporateTime Synchronous Network Connection service grants connections on a "first in, first out" (FIFO) basis. Requests that cannot be processed immediately are put in a queue. The number of connections between two nodes may be increased or decreased. Thus, it is possible to minimize the traffic and connection time between two nodes or to minimize the number of connections used. If a CorporateTime Synchronous Network Connection service loses a connection due to network problems, it will attempt to reconnect later.
Configuration
The Synchronous Network Connection daemon/service is an iterative server whose purpose is to maintain open connections to many CorporateTime Engines simultaneously and to broker connections between CorporateTime Engines (uniengd) and CorporateTime Directory Access Servers (unidasd) in an external directory context. For technical information about the configuration of the CorporateTime Synchronous Network Connections daemon/service, including a list of the parameters and their default values, see "Server configuration". Unless otherwise indicated, the CorporateTime Synchronous Network Connections daemon/service must be re-started in order for a configuration change to take effect.
CorporateTime Corporate-Wide Services
The CorporateTime Corporate-Wide Services (unicwsd) allow the exchange of information between users who reside on different nodes. People on one node may need to view calendar information or schedule events with users from another node. This service also provides mail notification via an SMTP mail server.
The CorporateTime Corporate-Wide Services communicate with other nodes using TCP/IP sockets and named pipe connections. These links provide fast communication and instant free-time lookups when scheduling an event. The TCP/IP sockets and named pipe connections are provided and managed by the CorporateTime Synchronous Node Connection daemon/service (unisncd).
Processing
The CorporateTime Corporate-Wide Services process local requests for remote information as well as requests from other nodes for local information. Local requests are requests for information concerning users on another node, or simply requests to send mail messages to remote users. These requests are made by the users on the local node and are put in a local queue. CorporateTime Corporate-Wide Services process the requests by reading them one after another from the queue. If a TCP/IP connection is available, the information requested by the local user can be accessed by connecting directly to the other node.
The only mail handling is the sending of notifications when a user creates an event and the attendees need to be notified. These mail notifications are dependent on user controlled options.
Configuration
For technical information concerning the configuration of the CorporateTime Corporate-Wide Services daemon/service, including a list of the parameters and their default values, see "Server configuration". Unless otherwise indicated, the CorporateTime Corporate-Wide Services must be re-started in order for a configuration change to take effect.
CorporateTime Directory Access Server
The CorporateTime Directory Access Server (unidasd) is used to maintain open connections to an LDAP Directory Server for implementations using CorporateConnect. Connections to the Directory Access Server are granted by the CorporateTime Synchronous Network Connection (unisncd) daemon/service.
CorporateTime architecture
Client connection requests are initially processed via the uniengd daemon/service through the Berkeley Sockets Interface. During the connection process, a forked uniengd server is created for the client for all subsequent requests. Database access requests are synchronized via the unilckd daemon/service through Interprocess Communication Requests (System V IPC).
User validation. All user attributes are stored in the Directory Server. The local uniengd server process borrows a persistent connection from the unisncd (synchronous network daemon) to the unidasd proxy. This process, then acting as a client, connects directly to the Directory Server which may be on a remote server.
Scheduling meetings with remote users (users on other nodes) is transparent to CorporateTime users. When a user creates a meeting with a user on a remote server, this places a request in the database which is handled by the unicwsd (corporate-wide services) daemon/service, whose job it is to place remote copies on other nodes.
Server configuration
The administrator can control and define both server and client behaviour using configurable parameters located in the /users/unison/misc/unison.ini file. These CorporateTime Server parameters should be reviewed and tuned on a per installation basis.
The stated default values are not necessarily the optimal settings for your CorporateTime installation. The unison.ini file supplied with the software, outside of the main package, contains settings that provide a good starting point for further configuration. It is strongly recommended that for reference purposes you keep a copy, in either printed or electronic format, of this file before modification.
NoteWhen a parameter is not supplied, the default value is automatically assumed.
Configuration parameters
The types of behaviour that can be modified fall under the following headings:
- Controlling client behaviour
- Controlling client connections to server
- Controlling server behaviour
- Controlling server interactions with directory server
Table 7.1 · Server Configuration Parameters [PRODUCT] name Name of the product 83 [PRODUCT] version CorporateTime Server version number 83 [LIC] license Product license 82 [SYS] sys_owner User under which processes run 107 autosync Enable daemon synchronization during start/stop 109 [ENG] passwords Case sensitivity of passwords 86 pwdreturnonitemget Returning password to client 87 max_userlogons Maximum number of concurrent sessions by a given user 101 max_addrlogons Maximum number of concurrent sessions from a specific client 101 activity Statistics logging: user connections 109 stats Statistics logging: user sessions 109 localcharset Character set for log files 110 dac_dirdownfailoverlog Logging of dac_dirdownfailover errors 111 dac_failederrlog Logging of failure errors 111 dac_configerrlog Logging of configuration errors 112 dac_miscerrlog Logging of miscellaneous errors 112 dac_ignorederrlog Logging of non-critical errors 112 utf8_onfailprintmesg Logging of failure to instantiate UTF-8 conversion functionality 113 dac_itemget Database Item retrieval 113 utf8_autoconvert Enable conversion of data to UTF-8 format 113 dir_internal_nodes Coexistence of LDAP and non-LDAP nodes 119 notify Mail notification 120 usermailmap User mail mapping 120 resourcemailmap Resource mail mapping 121 dac_rscconnectmodel Persistence of connections from uniengd to unidasd 126 dac_maxretry SNC to DAS connection retries 126 dac_retrywaitsecs SNC to DAS connection retry delay 127 dac_retrywaitusecs SNC to DAS connection retry delay 127 so_any Listening on any IP address associated with a multi-homed machine 127 dac_dirdownfailover Use of internal cache on directory server inaccessibility 103 readlocktimeout Database lock timeout for reads 101 writelocktimeout Database lock timeout for writes 102 standards Supported Internet standards 103 capi_storage Supported CAPI version 104 [DAS] dir_updcalonly Allow user to update personal attributes 87 enable Automatic start of DAS daemon/service 106 stats Statistics logging: unidasd 111 so_any Listening on any IP address associated with a multi-homed machine 128 so_reuseaddr Re-use of socket address 128 dir_service Set directory service 130 [LCK] lck_users Maximum number of logged-on users 100 [DB] db_pages Number of pages in the database cache 114 db_indexpages Number of pages for transaction overflow cache 114 db_openrepeat Maximum number of database reconnection attempts 114 db_opensleep Interval between database reconnection attempts 115 db_files Maximum number of database files open per user 115 taf_max_retry Number of retries on the database locking mechanism 115 [DBI] dbi_name Name of the empty node database used as a template for node creation 104 dbversion Node database version number 105 [CWS] enable Automatic start of CWS daemon/service 105 startupsleep Time to sleep on start-up 106 trace Statistics logging: verbose switch 110 smtpmail Mail server 121 unixmail Mail server 121 smtpmailprogram Mail utility 122 unixmailprogram Mail utility 122 smtpmailpath Pathname of the mail utility 122 sendmailpath Pathname of the mail utility 123 smtpmailhost Host name of the smtp mail server 123 smtpmaillog Redirection of mail script output 123 mailhdrtofield "To:" field of mail header 124 mailhdrtoname UTF-8 for names in "To:" field of mail header 124 mimecontentcharset Character set for content portion of mail message 124 tmp_dir Temporary directory for mail server 125 maxmailsleep Sleep time between mail server connection retries 125 warninggap Delay between sending of warning messages 126 noreqsleep Sleep time between checks on request queue 129 requestmaxage Maximum age of request in queue 129 [SNC] enable Automatic start of the SNC daemon/service 105 [TIMEZONE] default Default time zone 129 rules Time zone rules 130 checksum Checksum of the time zone rules file 130 [LIMITS] allowattachments Allow agenda attachments 83 maxattachmentsize Maximum size of attachments 84 autocontrol Interval for checks for new agenda entries 84 maxrecur Maximum number of instances for a repeating meeting, note, or day event 84 maxremleadtime Maximum lead time on a reminder 85 agendaview Default view for agenda 85 maxwinopen Maximum number of open windows 85 groupviewmax Maximum number of users in a group view 86 maxviewcombined Maximum number of individual agendas in a group agenda 86 maxpasswordage Password aging 87 pubgroups Right to create public groups 88 Enable mail notification 88 maxmaildistr Maximum number of people in a mail notification distribution 88 mincharsearch Minimum number of characters in the "Surname" edit box 88 maxsearchresult Maximum number of search results displayed 89 page-forward "Next" button in search dialogue box 89 page-backward "Previous" button in search dialogue box 90 resourceconflicts Double-booking of resources 90 settimezone Permission to change default time zone 91 publishab Enable publishing of address books 91 maxpersabentries Maximum number of personal address book entries 92 remotewait Retry interval for remote data requests to server 102 remotemaxretry Retry limit for remote data requests to server 103 ssignin Allow users to log on without supplying password 102 [YOURNODEID] localnodes Allow resources in remote node to appear as local 91 aliases Node alias(es) 118 name Node name 118 timezone Time zone of node 119 version Database version number 120 [UTL] host Host name of system 107 lock_timeout Database lock operation timeout 116 external_backup Specify alternate backup utility 116 external_restore Specify alternate restore utility 117 backup_timeout Backup operation timeout 117 restore_timeout Restore operation timeout 118 [YOURHOSTNAME, unidas] numconnect Number of connections to unidasd servers 108 dir_adminmodcalonly Permissions for modifying directory server attributes 133 dir_adminupdcalonly Permissions for updating directory server attributes 133 [LOCALE] charset Character set for content portion of mail message 124 [LDAP] dsa Name of directory server 131 host Name of directory server host 131 version LDAP protocol version number 131 port Port number of the LDAP directory server 132 charset Character set used by the directory server 132 dsausesearchtocompare Directory server support for ldap_compare() requests 132 attrpreservelist Attribute preserve List 133 attr_country Name of the "country" attribute 134 attr_generation Name of the "generation qualifier" attribute 134 attr_organization Name of the "organization" attribute 135 attr_fax Name of the "fax" attribute 135 attr_givenname Name of the "given name" attribute 135 attr_mail Name of the "mail" attribute 135 admin Location of the calendar server administrators 136 admingroup Group entry for calendar server administrators 136 basedn Distinguished Name of the subtree containing the calendar server entries 137 binddn Distinguished Name used for anonymous connections 137 mgrdn Distinguished Name of the directory server administrator 137 bindpwd Password used for anonymous connections 138 defaultpwd Password to use during migrations for users without passwords 138 dsausedeladdtoreplacepwd Directory server handling of changes to passwords 138 debug Enable debugging mode 139 [WEBLINK] mode Enabling Web Access functionality 92 browser-path-win Browser to launch for Windows clients 92 online-url Web page to load for clients working on-line 93 command-name Text to appear in Help menu and in ToolTip 93 command-description-online Command description in on-line mode 93 command-description-offline Command description in off-line mode 94 download-mode File transfer protocol 94 offline-source-win Source of web pages for Windows clients in off-line mode 94 offline-source-mac Source of web pages for Mac clients in off-line mode 95 offline-source-version Version of off-line web page 95 download-fail Error message to display if download fails 96 [WEBLINK-FRENCH] mode Enabling French language Web Access functionality 96 browser-path-win French language browser to launch for Windows clients 97 online-url French language web page to load for clients working on-line 97 command-name French language text to appear in Help menu and in ToolTip 97 command-description-online French language command description in on-line mode 98 command-description-offline French language command description in off-line mode 98 download-mode File transfer protocol 98 offline-source-win Source of French language web pages for Windows clients in off-line mode 99 offline-source-mac Source of French language web pages for Mac clients in off-line mode 99 offline-source-version Version of French language off-line web pages 100 download-fail Error message to display if download fails 100 Optional [SNC] parameters max_socket Maximum number of connections among all nodes 106 wait_sbh Number of minutes to wait for remote node connection 139 request_chunk_size Number of requests that are reset at a time 139 snc_tr_block Block size used to communicate between processes 140 snc_tr_recv_timeout Time-out for received transmissions 140 snc_tr_send_timeout Time-out for sent transmissions 141 snc_so_rcvbuf Size of the socket layer receive buffer 141 snc_so_sndbuf Size of the socket layer send buffer 141 snc_so_linger Unsent messages on termination of SNC daemon/service 141 snc_so_keepalive Idle connections 142 Product license
Section
Parameter
Description
A license for the product expressed in the form <date>/<product name>/<checksum>. This string should not be altered without explicit instructions from CS&T.
Accepted values
The license supplied with the product or an updated version provided by qualified support personnel.
Default value
Product name
Section
Parameter
Description
Specifies the name of the product. Set during installation, this value should not be edited or removed.
Accepted values
Default value
Product version number
Section
Parameter
Description
Specifies the version number of the CorporateTime Server. Set during installation, this value should not be edited or removed.
Accepted values
Default value
Controlling client behaviour
Allow agenda attachments
Section
Parameter
Description
Determines whether or not attachments to meetings or tasks are allowed in the client.
Accepted values
FALSE (attachments not allowed)
Default value
Maximum size of attachments
Section
Parameter
Description
Determines the maximum size, in bytes, allowed for attachments to meetings, tasks and other agenda entries. This parameter is meaningful only if the allowattachments parameter is TRUE. Suggested value is 102400 or 100K.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Interval for checks for new agenda entries
Section
Parameter
Description
Determines the minimum number of minutes that can be set by a user as the interval between each agenda refresh call made to the server (i.e. each check for new agenda entries).
If this value is less than lck_users/60, the value of lck_users/60 will take precedence. For example, if autocontrol=15 and lck_users=1200, a refresh will not occur before 20 (i.e. 1200/60) minutes has elapsed.
Accepted values
0 or any positive integer up to a maximum value of (216-1)
Default value
Maximum number of instances for a repeating meeting, note, or day event
Section
Parameter
Description
The maximum number of instances a user can create for a single repeating meeting, note or day event.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
60 (60 instances per meeting, note, or day event)
Maximum lead time on a reminder
Section
Parameter
Description
Specifies the maximum number of days in advance of an event that you can set a reminder to ring.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Default view for agenda
Section
Parameter
Description
Determines the default view in which agenda windows are opened. This functionality is implemented for CorporateTime Client 4.1 and above.
Accepted values
Default value
Maximum number of open windows
Section
Parameter
Description
Determines the maximum number of windows (views) that can be opened at the same time in the user interface.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Maximum number of users in a group view
Section
Parameter
Description
Specifies the maximum number of users that can be displayed in a group view.
Accepted values
A positive integer up to the value of (232-1)
Default value
Maximum number of individual agendas in a group agenda
Section
Parameter
Description
Determines the maximum number of individual agendas that may be included in a group agenda.
Accepted values
A value greater than 2 and less than 232
Default value
Case sensitivity of passwords
Section
Parameter
Description
Determines whether the user password verification is case sensitive or case insensitive.
Accepted values
ignorecase (for case insensitive)
Default value
Password aging
Section
Parameter
Description
Controls password aging. The value represents the number of days that a password can exist before users are required to change it.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
76543 (for all intents and purposes, password aging is OFF)
Returning password to client
Section
Parameter
Description
Determines whether or not the password of the logged-on user will be sent to the client when the record of that user is retrieved during a session.
Accepted values
FALSE (password is not returned)
Default value
Allow user to update personal attributes
Section
Parameter
Description
Determines whether or not users can update the inetOrgPerson attributes maintained by the directory server and contained within the CorporateTime schema.
Accepted values
Default value
Right to create public groups
Section
Parameter
Description
Determines if users holding the necessary access rights are allowed to create public groups.
Accepted values
TRUE (users are permitted to create public groups)
FALSE (users are not permitted to create public groups)
Default value
Enable mail notification
Section
Parameter
Description
Determines whether or not mail notification is enabled, regardless of how the client is set up.
Accepted values
TRUE (mail notification is enabled)
FALSE (mail notification is disabled)
Default value
Maximum number of people in a mail notification distribution
Section
Parameter
Description
Specifies the maximum number of users in a mail notification distribution list.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Minimum number of characters in the "Surname" edit box
Section
Parameter
Description
Determines the minimum number of search characters which the user must supply in the "Surname" field when performing a directory search from the client. The default value of 0 allows a user to execute a search without limits and retrieve the complete database of users.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Maximum number of search results displayed
Section
Parameter
Description
Determines the maximum number of entries that the search dialogue box can list as a search result in either the CorporateTime client, or the CorporateTime Server Administrator. This parameter should be tuned relative to the size of your installation. In the case of a directory server, this parameter should also be tuned to any search limits configured in the directory server. Consult the relevant CorporateConnect appendix for your directory server, or your directory server documentation to determine what these limits are and how to configure them.
Accepted values
0 or any positive integer up to the value of (232-1)
Default value
100 (only 100 entries will be listed at a time)
"Next" button in search dialogue box
Section
Parameter
Description
Determines whether or not the "next" button will be enabled in the search dialogue box of the CorporateTime Client.
When a search is done, the maxsearchresult parameter in the [LIMITS] section determines the maximum number of search results that will be returned to the client. Assume page-forward is TRUE, maxsearchresult is set to "100", and we do a search for all users whose surname begins with "S". If there are 220 such users in the database, we would be presented with the first 100 users. We would then click on the "next" button to see the next 100 users, and click again to see the last 20.
This functionality is disabled when the server is connected to a directory server.
Accepted values
TRUE (the "next" button will be enabled)
FALSE (the "next" button will be disabled)
Default value
"Previous" button in search dialogue box
Section
Parameter
Description
Determines whether the "previous" button will be enabled in the search dialogue box. This button performs the reverse operation of the page-forward parameter, allowing the user to return to previously-listed entries of the search result.
This functionality is disabled when the server is connected to a directory server.
Accepted values
TRUE (the "previous" button will be enabled)
FALSE (the "previous" button will be disabled)
Default value
Double-booking resources
Section
Parameter
Description
Determines whether double-booking of resources is allowed.
Accepted values
TRUE (double-bookings are allowed)
FALSE (double-bookings are not allowed)
Default value
Allow resources in remote node to appear as local
Section
Parameter
Description
Specifies which remote resources will be considered local for scheduling purposes when using the CorporateTime client. If you want users on separate but connected nodes to view and treat all resources as local (a common situation when two or more nodes are in close geographic proximity), you would enter the relevant node-ID(s) after this parameter. Nodes must be connected to enable this feature.
Accepted values
Valid node-IDs, separated by a comma
Default value
Permission to change default timezone
Section
Parameter
Description
Determines whether or not the user is permitted to change his/her time zone setting in the client from that set for the node.
Accepted values
TRUE (users permitted to set a different time zone)
FALSE (users not permitted to set a different time zone)
Default value
Enable publishing of address books
Section
Parameter
Description
Enables the publishing of address books. This functionality is implemented for CorporateTime Client 4.1 and above.
Accepted values
TRUE (enables the publishing of address books)
FALSE (disables the publishing of address books)
Default value
Maximum number of personal address book entries
Section
Parameter
Description
Determines the maximum number of personal address book entries. This functionality is implemented for CorporateTime Client 4.0 and above.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Enabling Web Access functionality
Section
Parameter
Description
Determines whether the web access functionality is enabled and how it is configured. Note that if this parameter is set to custom, ALL of the other [WEBLINK] parameters must have values specified in the unison.ini file. If this is not the case, the value of this parameter will revert to the default (cst).
Accepted values
off (web access functionality is not enabled)
cst (web access functionality is enabled, and the values for all of the other [WEBLINK] parameters are taken directly from the code; any values set in the unison.ini file for these other parameters are ignored)
custom (web access functionality is enabled, and values for all of the other [WEBLINK] parameters are taken from the unison.ini file)
Default value
Browser to launch for Windows clients
Section
Parameter
Description
Determines which web browser will be launched for Windows clients. This is the location of the web browser on the local machine of each signed-on user.
Accepted values
<file-path> (A string with a maximum length of 150 characters.)
Default value
(when mode=cst) Windows is polled for the default browser to launch. If no value is found, the user is prompted for the browser path.
Web page to load for clients working on-line
Section
Parameter
Description
Determines the web page loaded for clients working in on-line mode.
Accepted values
http://<default-url> (where the complete string is a maximum of 150 characters in length)
Default value
(when mode=cst) http://www.cst.ca/weblink/index.htm
Text to appear in Help menu and in ToolTip
Section
Parameter
Description
Determines the text string that will appear in the Help menu for the "Web Access" item, as well as in the pop-up ToolTip.
Accepted values
A string up to a maximum of 150 characters in length.
Default value
(when mode=cst) Product Information
Command description in on-line mode
Section
Parameter
Description
Under Windows clients, determines the description of the Web Access command that appears on the status bar when the client is working in on-line mode. Under Macintosh clients, determines the description of the Web Access command that appears in Balloon help when the client is working in on-line mode.
Accepted values
A string up to a maximum of 150 characters in length.
Default value
(when mode=cst) Click here to access product information on the web.
Command description in off-line mode
Section
Parameter
Description
Under Windows clients, determines the description of the Web Access command that appears on the status bar when the client is working in off-line mode. Under Macintosh clients, determines the description of the Web Access command that appears in Balloon help when the client is working in off-line mode.
Accepted values
A string up to a maximum of 150 characters in length.
Default value
(when mode=cst) Click here to access product information on the web.
File transfer protocol
Section
Parameter
Description
Determines the file transfer protocol to be used when downloading the web pages for viewing in off-line mode.
Accepted values
file (use the file sharing protocol)
Default value
Source of web pages for Windows clients in off-line mode
Section
Parameter
Description
Determines the source of the web pages to be displayed on Windows clients working in off-line mode.
Accepted values
<file path> (where the complete string is a maximum of 150 characters in length)
Default value
No default value. Only meaningful when mode=custom.
Source of web pages for Mac clients in off-line mode
Section
Parameter
Description
Determines the source of the web page to be displayed on Macintosh clients working in off-line mode.
Accepted values
<user>:<pw>@[<zone>]:<AFP Server Name> [,<ip>[,<port>]];<volume path>:
A string with a maximum of 150 characters in length which obeys the above format and the following restrictions:
Default value
- <user> is a maximum of 31 characters in length
- <pw> is a maximum of 8 characters in length
- <zone> is a maximum of 31 characters in length; default value is the asterisk symbol "*" (without the quotes)
- <AFP Server Name> is a maximum of 31 characters in length
- <ip> is a maximum of 31 characters in length
- <port> is a numerical value 0 to 32767 inclusive; default value is 548
- <volume path> is a maximum of 64 characters in length
No default value. Only meaningful when mode=custom.
Version of off-line web page
Section
Parameter
Description
Determines the version of the off-line web page. This provides a mechanism for the administrator to ensure that the most recent version of the off-line web page is the one being accessed.
Accepted values
A character string with a maximum length of 150 characters.
Default value
No default. Only meaningful when mode=custom.
Error message to display if download fails
Section
Parameter
Description
Determines the error message to be displayed if a download fails.
Accepted values
A character string with a maximum length of 150 characters.
Default value
(when mode=cst) Your on-line account did not supply all the information needed to support this operation. Please contact your system administrator.
Enabling French language Web Access functionality
Section
Parameter
Description
Determines whether the web access functionality is enabled and how it is configured. Note that if this parameter is set to custom, ALL of the other [WEBLINK-FRENCH] parameters must have values specified in the unison.ini file. If this is not the case, the value of this parameter will revert to the default (cst).
Accepted values
off (web access functionality is not enabled)
cst (web access functionality is enabled, and the values for all of the other [WEBLINK-FRENCH] parameters are taken directly from the code; any values set in the unison.ini file for these other parameters are ignored)
custom (web access functionality is enabled, and values for all of the other [WEBLINK-FRENCH] parameters are taken from the unison.ini file)
Default value
French language browser to launch for Windows clients
Section
Parameter
Description
Determines which French language web browser will be launched for Windows clients. This is the location of the web browser on the local machine of each signed-on user.
Accepted values
<file-path> (A string with a maximum length of 150 characters.)
Default value
(when mode=cst) Windows is polled for the default browser to launch. If no value is found, the user is prompted for the browser path.
French language web page to load for clients working on-line
Section
Parameter
Description
Determines which French language web page is loaded for clients working in on-line mode.
Accepted values
http://<french-url> (where the complete string is a maximum of 150 characters in length)
Default value
(when mode=cst) http://www.cst.ca/weblink/index.htm
French language text to appear in Help menu and in ToolTip
Section
Parameter
Description
Determines the French language text string that will appear in the Help menu for the "Web Access" item, as well as in the pop-up ToolTip.
Accepted values
An ASCII string up to a maximum of 150 characters in length.
Default value
(when mode=cst) Information sur le produit
French language command description in on-line mode
Section
Parameter
Description
Under Windows clients, determines the French language description of the Web Access command that appears on the status bar when the client is working in on-line mode. Under Macintosh clients, determines the French language description of the Web Access command that appears in Balloon help when the client is working in on-line mode.
Accepted values
An ASCII string up to a maximum of 150 characters in length.
Default value
(when mode=cst) Lancer le navigateur Web pour visualiser l'information sur le produit
French language command description in off-line mode
Section
Parameter
Description
Under Windows clients, determines the French language description of the Web Access command that appears on the status bar when the client is working in off-line mode. Under Macintosh clients, determines the French language description of the Web Access command that appears in Balloon help when the client is working in off-line mode.
Accepted values
An ASCII string up to a maximum of 150 characters in length.
Default value
(when mode=cst) Lancer le navigateur Web pour visualiser l'information sur le produit
File transfer protocol
Section
Parameter
Description
Determines the file transfer protocol to be used when downloading the web pages for viewing in off-line mode.
Accepted values
file (use the file sharing protocol)
Default value
Source of French language web pages for Windows clients in off-line mode
Section
Parameter
Description
Determines the source of the French language web pages to be displayed on Windows clients working in off-line mode.
Accepted values
<file path> (where the complete string is a maximum of 150 characters in length)
Default value
No default value. Only meaningful when mode=custom.
Source of French language web pages for Mac clients in off-line mode
Section
Parameter
Description
Determines the source of the web page to be displayed on Macintosh clients working in off-line mode.
Accepted values
<user>:<pw>@[<zone>]:<AFP Server Name> [,<ip>[,<port>]];<volume path>:
An ASCII string with a maximum of 150 characters in length which obeys the above format and the following restrictions:
Default value
- <user> is a maximum of 31 characters in length
- <pw> is a maximum of 8 characters in length
- <zone> is a maximum of 31 characters in length; default value is the asterisk symbol "*" (without the quotes)
- <AFP Server Name> is a maximum of 31 characters in length
- <ip> is a maximum of 31 characters in length
- <port> is a numerical value 0 to 32767 inclusive; default value is 548
- <volume path> is a maximum of 64 characters in length
No default value. Only meaningful when mode=custom.
Version of French language off-line web pages
Section
Parameter
Description
Determines the version of the off-line French language web page. This provides a mechanism for the administrator to ensure that the most recent version of the off-line French language web page is the one being accessed.
Accepted values
An ASCII string with a maximum length of 150 characters.
Default value
No default. Only meaningful when mode=custom.
Error message to display if download fails
Section
Parameter
Description
Determines the error message to be displayed if a download fails.
Accepted values
An ASCII string with a maximum length of 150 characters.
Default value
(when mode=cst) Le telechargement s'est acheve correctement. Les fichiers de mode déconnecte ont ete restaures.
Controlling client connections to server
Maximum number of logged-on users
Section
Parameter
Description
Specifies the maximum number of logged-on CorporateTime users. Setting this value higher than required wastes system resources.
Accepted values
A positive integer up to 3800 (NT) or 5000 (UNIX).
Default value
Maximum number of concurrent sessions by a given user
Section
Parameter
Description
Specifies the maximum number of concurrent "named" CorporateTime Server sessions that each user may invoke. A session is "named" if it is associated with a specific user and "unnamed" if it is not associated with a specific user.
Accepted values
0 (no limit is to be enforced) or any positive integer
Default value
Number of concurrent sessions from a specific client
Section
Parameter
Description
Specifies the maximum number of concurrent "unnamed" CorporateTime Server sessions that can be invoked by a single client, that is, from a single Internet address. A session is "named" if it is associated with a specific user and "unnamed" if it is not associated with a specific user.
Accepted values
0 (no limit is to be enforced) or any positive integer
Default value
Database lock timeout for reads
Section
Parameter
Description
Determines the number of contiguous seconds that the server is permitted to lock the database for a client read request. If this maximum is exceeded, the uniengd server will terminate (and thus the associated user session as well), and the timeout will be logged to eng.log.
Accepted values
0 or any positive integer up to the value of (232-1)
Default value
Database lock timeout for writes
Section
Parameter
Description
Determines the number of contiguous seconds that the server is permitted to lock the database for a client write request. If this maximum is exceeded, the uniengd server will terminate (and thus the associated user session as well), and the timeout will be logged to eng.log.
Accepted values
0 or any positive integer up to the value of (232-1)
Default value
Retry interval for remote data requests to server
Section
Parameter
Description
Specifies the number of seconds the client will wait before retrying a call to the server for data from a remote server.
Accepted values
A positive integer up to the value of (232-1)
Default value
Allow users to log on without supplying password
Section
Parameter
Description
Determines if a user is allowed to sign on to a client without providing a password. This functionality is available only for CorporateTime clients (4.2 and above) running in a password protected Windows environment.
Accepted values
TRUE (user may sign on without password)
FALSE (user requires password)
Default value
Retry limit for remote data requests to server
Section
Parameter
Description
Specifies the number of retries of a call to the server requesting data from a remote server that will be made before returning an error.
Accepted values
A positive integer up to the value of (232-1)
Default value
Use of internal cache on directory server inaccessibility
Section
Parameter
Description
Determines whether or not the internal cache will be used when the directory server is down, and thus whether or not it is possible to continue using a CorporateTime client in such a situation. The CorporateTime client must have signed in when the directory server was up. Operations in this situation are limited to ones which do not require modifications to the directory server information. Permitted operations are: item retrievals, searches, and creation/modification of agenda entries.
Accepted values
TRUE (client will operate with directory server down)
FALSE (client will not operate with directory server down)
Default value
Calendar standards (CAPI)
Section
Parameter
Description
Lists the supported Internet standards.
Accepted values
ICAL2.0 (support for IETF ICAL 2.0 standard; must be activated to enable CAPI support
CAPI (required if CAPI applications are used)
Default value
Supported CAPI version
Section
Parameter
Description
Specifies the supported version of CS&T's Calendar API (CAPI). This parameter is read only if [ENG] standards specifies ICAL2.0.
Accepted values
BASIC (setting for CAPI support with pre-4.0 CorporateTime Server)
OPTFH (support for CAPI 1.1 and higher)
Default value
Controlling server behaviour
Internal Database
Section
Parameter
Description
Specifies the name of the empty node database used as a template for node creation. Set during installation, this value should not be edited or removed.
Accepted values
Default value
Node database version
Section
Parameter
Description
Specifies the node database version number. Set during installation, this value should not be edited or removed.
Accepted values
Default value
Automatic start of CWS daemon/service
Section
Parameter
Description
Controls whether or not the unicwsd, the Corporate-Wide Services daemon/ service, is automatically started. This parameter must be set to TRUE if your CorporateTime Server configuration has multiple nodes or mail notification.
Accepted values
TRUE (unicwsd automatically starts)
FALSE (unicwsd does not automatically start)
Default value
Automatic start of the SNC daemon/service
Section
Parameter
Description
Determines whether or not the unisncd daemon/service will be started with the other services when the CorporateTime system is brought up. The unisncd service must be started if your CorporateTime implementation contains multiple nodes.
Accepted values
FALSE (unisncd is not started)
Default value
Automatic start of DAS daemon/service
Section
Parameter
Description
Determines whether or not the unidasd daemon/service is automatically started when the CorporateTime Server is started. The unidasd daemon/service is required only for installations using CorporateConnect to work with a directory server.
Accepted values
TRUE (unidasd will be started)
FALSE (unidasd will not be started)
Default value
Time to sleep on start-up
Section
Parameter
Description
Specifies the number of seconds the Corporate-Wide Services daemon/service will wait (sleep) at the start-up of the CorporateTime Server before attempting to process any requests. This delay is intended to provide enough time for the SNC daemon/service to start up and establish the necessary connections to nodes. Tuning of this parameter may be necessary for servers with many nodes, or many connections, or where the bandwidth is low.
Accepted values
Default value
Maximum number of connections among all nodes
Section
Parameter
Description
Specifies the maximum number of connections among all nodes. In situations where multiple nodes exist on a server, this parameter is used to minimize the number of system resources (namely, the number of sockets) required to instantiate the node network defined in the /users/unison/misc/nodes.ini file. The SNC daemon/service in this case will distribute the total number of connections evenly among all nodes.
This parameter may need to be tuned based on usage statistics. Contact CS&T support for more details on the recommended configuration for your CorporateTime installation..
Accepted values
The minimal configuration is two connections per node. The upper limit is the maximum number of open files allowed per process, a limit imposed by the operating system.
Default value
Host name of system
Section
Parameter
Description
Specifies the host name of the system on which the CorporateTime Server is running. There is NO default so you MUST include this parameter.
Accepted values
Any valid (fully-specified) host name
Default value
User under which processes run
Section
Parameter
Description
Specifies the user under which the CorporateTime Server processes will run. In all cases, CorporateTime Server executes services with the effective user controlling security set to unison.
Accepted values (UNIX)
Accepted values (NT)
Default value
Number of connections to directory server
Section
Parameter
Description
Specifies the number of connections to establish to the directory server. A number of variables must be considered when setting this parameter. Guidelines are provided for installations contained within the following configuration:
- hardware configuration adequately supports the demands of the software (see Appendices A, B and C)
- CorporateTime clients used are not web-based (i.e. Windows, Mac or Motif clients)
- configured users per host does not exceed 5,000
- logged-on users per host does not exceed 2,500
- logged-on users per node does not exceed 1,000
- logged-on users per node is greater than 250
- connected nodes per host does not exceed 4
- number of nodes in a network does not exceed 10
- dac_itemget = FALSE
Administrators of CorporateTime installations which do not match the specified configuration should contact CS&T support for further assistance in setting this parameter.
Accepted values
Default value
Enable daemon synchronization during start/stop
Section
Parameter
Description
Enables the daemon synchronization mechanism during start-up and shutdown operations.
Accepted values
TRUE (use of synchronization mechanism enabled)
FALSE (use of synchronization mechanism disabled; sleep calls are used for synchronization)
Default value
Statistics logging: user connections
Section
Parameter
Description
Determines whether or not logging of CorporateTime Server sign-ons and sign-offs is done. The resulting log is useful for tracking CorporateTime Server usage and for monitoring possible security violations. If logging is enabled, the size of the log file (/users/unison/log/act.log) should be closely monitored as it can grow quickly.
Accepted values
Default value
Statistics logging: user sessions
Section
Parameter
Description
Determines whether or not logging of CorporateTime Server user session statistics (CPU consumption, user wait times, and network traffic) is doneIf logging is enabled, the size of the log file (/users/unison/log/stats.log) should be closely monitored since it can grow quickly.
Accepted values
Default value
Character set for log files
Section
Parameter
Description
Defines the character set used in the log files. Data stored in the calendar database will be converted to this character set for display in log files. Thus, if for a Japanese configuration the parameter was set to Shift_JIS, names in the /users/unison/log/act.log would be displayed in Shift_JIS.
Accepted values
Default value
Statistics logging: verbose switch
Section
Parameter
Description
Determines how much information is written to the unicwsd daemon/service log file (/users/unison/log/cws.log). If set to TRUE, a more verbose style of logging is enabled whereby each transaction performed by the CWS daemon/service is logged. This will cause the log file to grow rapidly and should only be used for a short time for testing or debugging purposes.
Accepted values
TRUE (enables verbose logging)
FALSE (disables verbose logging)
Default value
Statistics logging: unidasd
Section
Parameter
Description
Determines whether or not unidasd statistics are generated and logged to the dasstats.log and the dsstats.log files. The log files grow quickly and thus should be generated for only a short time for testing or debugging purposes.
Accepted values
Default value
Logging of dac_dirdownfailover errors
Section
Parameter
Description
Determines whether or not the use of the failover mechanism, controlled by the dac_dirdownfailover parameter, will be logged to the /users/unison/log/eng.log file.
Accepted values
Default value
Logging of failure errors
Section
Parameter
Description
Determines whether or not directory server access related errors that appear in the client interface as "unexpected error" are logged to the /users/unison/log/eng.log file.
Accepted values
Default value
Logging of configuration errors
Section
Parameter
Description
Determines whether or not three directory server access errors are logged to the /users/unison/log/eng.log file. The three errors are: "unable to connect to the SNC daemon/service"; "no connections to the directory access (DAS) daemon/service are currently available" and "the number of retries to obtain a connection has been attained; no connections to the directory access (DAS) daemon/service are configured".
Accepted values
Default value
Logging of miscellaneous errors
Section
Parameter
Description
Determines whether or not three types of directory server access errors related to the client are logged to the /users/unison/log/eng.log file. The three errors are: password discrepancy due to changes made in the directory server through another application; an LDAP client-side error; an LDAP server-side error.
Accepted values
Default value
Logging of non-critical errors
Section
Parameter
Description
Determines whether or not non-critical directory server access errors are logged to the /users/unison/log/eng.log file.
Accepted values
Default value
Logging of failure to instantiate UTF-8 conversion functionality
Section
Parameter
Description
Determines whether or not an error message is logged to /users/unison/log/eng.log if the server is unable to instantiate UTF-8 conversion functionality for a given user session. Enough information is logged in the error message to determine why the functionality could not be created.
Accepted values
TRUE (error message is logged to eng.log)
FALSE (no error message is logged)
Default value
Database item retrieval
Section
Parameter
Description
Determines whether an item being retrieved (as a result of a search or a signon) is retrieved from the directory server or from the internal cache.
Accepted values
TRUE (items are retrieved from the directory server)
FALSE (items are retrieved from the internal cache)
Default value
Enable conversion of data to UTF-8 format
Section
Parameter
Description
Determines whether or not data input from the client is converted and stored in the server in UTF-8 format.
Accepted values
TRUE (input data is converted to UTF-8)
FALSE (input data is not converted to UTF-8)
Default value
Number of pages in the database cache
Section
Parameter
Description
Specifies the number of pages for the database cache. The greater the value, the greater the amount of memory used and the better the performance. As the number increases beyond a certain point, the performance enhancement returns diminish.
Accepted values
Default value
Number of pages for transaction overflow cache
Section
Parameter
Description
Specifies the number of pages for the transaction overflow cache.
Accepted values
Default value
Maximum number of database reconnection attempts
Section
Parameter
Description
Specifies the maximum number of attempts that will be made to reconnect to the database.
Accepted values
Default value
Interval between database reconnection attempts
Section
Parameter
Description
Specifies the number of seconds to wait (sleep) between attempts to connect to the database.
Accepted values
Default value
Maximum number of database files open per user
Section
Parameter
Description
Specifies the number of database files that may be opened for each user. Increasing this number can improve performance.
Accepted values
A positive integer up to the maximum set by the operating system for number of open files per process. On UNIX systems this maximum is the value of the system variable NOFILE, which may be found in the file /usr/include/sys/param.h.
Default value
Maximum number of retries on the database locking mechanism
Section
Parameter
Description
Specifies the maximum number of retries on the database locking mechanism.
Accepted values
Default value
Database lock operation timeout
Section
Parameter
Description
Sets the timeout, in seconds, for the lock operation on the database.
Accepted values
Default value
Specify alternate backup utility
Section
Parameter
Description
Specifies an alternate backup utility to be invoked by unidbbackup. The value of this parameter is used to construct the following command line:
value_of_external_backup [-f] -s src -d dst
-f indicates that the source is a file (absence of this flag indicates the source is a directory)
-s specifies the source to be backed up ("src" is any valid file or directory name)
-d specifies the destination for the backup, as specified by the user
and both "src" and "dst" are any valid file or directory name
The generated command line must be valid. It may be that an intermediate script is required to take this command line, create one which is valid, and then invoke it. In this case, the value of external_backup would be set to the appropriate value for invoking the intermediate script.
Accepted values
Default value
Specify alternate restore utility
Section
Parameter
Description
Specifies an alternate restore utility to be invoked by unidbrestore. The value of this parameter is used to construct the following command line:
value_of_external_restore [-f] -s src -d dst
-f indicates that the source is a file (absence of this flag indicates the source is a directory)
-s specifies the source to be restored ("src" is any valid file or directory name)
-d specifies the destination for the restore, as specified by the user
and both "src" and "dst" are any valid file or directory name
The generated command line must be valid. It may be that an intermediate script is required to take this command line, create one which is valid, and then invoke it. In this case, the value of external_restore would be set to the appropriate value for invoking the intermediate script.
Accepted values
Default value
Backup operation timeout
Section
Parameter
Description
Sets the timeout, in seconds, for the backup operation on the database.
Accepted values
Default value
Restore operation timeout
Section
Parameter
Description
Sets the timeout, in seconds, for the restore operation on the database.
Accepted values
Default value
Default value
Node alias(es)
Section
Parameter
Description
Specifies the name (alias) or names (aliases) of the nodes configured on a server. When multiple nodes are configured on a server, users must indicate to which node they want to connect. Since, in general, a name is easier to remember than a numeric node-ID, aliases can be configured.
Accepted values
A list of one or more aliases where each alias is an alphanumeric string containing at least one letter and no spaces; each alias in the list is separated from the next by a comma
Default value
Node name
Section
Parameter
Description
The name of the root directory for the node database found under /users/unison/db/nodes/<name>. The value of this parameter is automatically generated during node creation. The first node created is labelled `N0', the second `N1', and following up to `N9'. Subsequent nodes continue the cycle through the alphabet from O to Z and then from A to L.
Accepted values
A code composed of a letter (A-Z) and a number (0-9)
Default value
Time zone of node
Section
Parameter
Description
Indicates the time zone of the node. This parameter is set automatically at the time the node is created and must not be changed.
The value of this parameter is set to either the time zone specified by the administrator creating the new node, or, where none is specified, the value of the [TIMEZONE] default parameter.
The timezone parameter allows nodes in a multiple node configuration to be associated with different time zones.
Accepted values
Default value
Coexistence of LDAP and non-LDAP nodes
Section
Parameter
Description
Identifies all nodes with an internal directory in an installation where the CorporateTime network requires the coexistence of nodes using an LDAP directory and those with their own internal directory.
Accepted values
Valid node-IDs, separated by a comma and enclosed within {}. E.g. dir_internal_nodes={10000,10001}
Default value
Database version number
Section
Parameter
Description
Specifies the version of the node database. This is a reference value set automatically during node creation. It must NEVER be manually edited.
Accepted values
Default value
Mail Notification
Section
Parameter
Description
Determines whether or not notification by SMTP-based UNIX mail is done on event creation. This parameter applies only to pre-3.0 versions of the client.
Accepted values
Default value
User mail mapping
Section
Parameter
Description
Specifies the attribute in the user record which contains the e-mail address of the user.
Accepted values
Default value
Resource mail mappings
Section
Parameter
Description
Specifies the attribute in the resource record which contains the e-mail address of the resource.
Accepted values
Default value
Mail server
Section
Parameter
Description
Determines whether or not mail notifications will be sent using the SMTP mail server. This parameter should always be set to TRUE, regardless of whether or not mail notification is enabled. Mail notification is enabled or disabled using the mail parameter in the [LIMITS] section.
This parameter supercedes unixmail. For backwards compatibility, if smtpmail is not set, and a value for the unixmail parameter can be found, that value will be used.
Accepted values
TRUE (the SMTP mail server is used)
FALSE (the SMTP mail server is not used)
Default value
Mail server
Section
Parameter
Description
This parameter is superceded by smtpmail.
Mail utility
Section
Parameter
Description
The mail utility used to transfer messages to the SMTP mail server. This parameter supercedes unixmailprogram. For backwards compatibility, if smtpmailprogram is not set, and a value for the unixmailprogram parameter can be found, that value will be used.
Accepted values
Default value (UNIX)
Default value (NT)
Mail utility
Section
Parameter
Description
This parameter is superceded by smtpmailprogram.
Pathname of the mail utility
Section
Parameter
Description
Specifies the directory pathname of the local mail utility. This parameter supercedes unixmailpath. For backwards compatibility, if smtpmailpath is not set, and a value for the unixmailpath parameter can be found, that value will be used.
Accepted values
Default value (UNIX)
Default value (NT)
Pathname of the mail utility
Section
Parameter
Description
This parameter is superceded by smtpmailpath.
Host name of the smtp mail server
Section
Parameter
Description
Specifies the host name on which the SMTP mail server is running. This parameter supercedes mailhost. For backwards compatibility, if smtpmailhost is not set, and a value for the mailhost parameter can be found, that value will be used.
Accepted values
Default value (NT)
Redirection of mail script output
Section
Parameter
Description
Specifies the file to which any script output resulting from the invocation of the mail utility will be redirected.
Under UNIX, unicwsd delivers e-mail by calling the system() function to execute sendmail (or the mail utility configured). The input to the system() function is a Bourne Shell script. If this script produces output, the issue arises of what to do with that output: as a daemon process, unicwsd has no stdout or stderr. To ensure that the output does not get sent to uniengd (and result in a deadlocking of communications between the two daemons), it is redirected to the file specified by this parameter.
Accepted values
A valid file name (/dev/null may also be used if no log of the output is required)
Default value (UNIX)
/users/unison/log/smtpmail.log
"To:" field of mail header
Section
Parameter
Description
Determines whether or not the "To:" field of the header is displayed.
Accepted values
TRUE ("To:" field is displayed)
FALSE ("To:" field is not displayed)
Default value
UTF-8 for names in "To:" field of mail header
Section
Parameter
Description
Determines whether or not names are included with addresses in the "To:" field of the mail header. While addresses are constructed using ASCII characters (and hence present no display problem for mail readers), names may contain non-ASCII characters. In cases where the mail reader is unable to properly display the non-ASCII characters, it may be preferable to simply remove the names from the "To:" field altogether.
Accepted values
FALSE (names are not included)
Default value
Character set for content portion of mail message
Section
Parameter
Description
Determines the character set used to encode the content and subject portion of the (MIME) mail message.
Accepted values
Default value
Character set for content portion of mail message
Section
Parameter
Description
Determines the character set used to encode the content portion of the mail message.
Accepted values
Default value
Temporary directory for mail server
Section
Parameter
Description
Specifies the temporary directory used by the mail server to store working files.
Accepted values
Default value
Sleep time between mail server connection retries
Section
Parameter
Description
Specifies the maximum number of seconds the unicwsd will wait (sleep) when it cannot connect to the mail server before trying again. This sleep time starts at 300 seconds (5 minutes) and is incremented by 600 seconds (10 minutes) each time a connect is retried, up to the defined maximum.
Accepted values
Default value
Delay between sending of warning messages
Section
Parameter
Description
The minimum number of seconds between each warning message sent to the CorporateTime Administrator when the attempt to make a connection to a remote node fails.
Accepted values
Default value
Persistence of connections from uniengd to unidasd
Section
Parameter
Description
Determines whether connections between the uniengd and the unidasd are persistent or on-demand. The ideal of maintaining persistent connections (for speed) is balanced against the number of open file descriptors permitted by the operating system.
Accepted values
ondemand (connection maintained for the duration of each specific request)
persistent (open connections maintained)
Default value
SNC to DAS connection retries
Section
Parameter
Description
Specifies the maximum number of retries the SNC daemon/service will make when attempting to establish a connection to the DAS daemon/service.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
SNC to DAS connection retry delay
Section
Parameter
Description
Specifies the number of seconds that the SNC daemon/service will wait between retries when attempting to establish a connection to the DAS. This value is combined with the value of dac_retrywaitusecs to determine the total time between retries.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
SNC to DAS connection retry delay
Section
Parameter
Description
Determines the number of microseconds that the SNC daemon/service will wait between retries when attempting to establish a connection to the DAS. This value is combined with the value of dac_retrywaitsecs to determine the total time between retries.
Accepted values
0 or any positive integer up to a maximum value of (232-1)
Default value
Listening on any IP address associated with a multi-homed machine [ENG]
Section
Parameter
Description
Determines whether or not the uniengd daemon/service process will listen for packets directed at ANY of the addresses associated with the machine hosting the CorporateTime Server. This is only relevant when the CorporateTime Server is running on a machine which has multiple IP addresses.
Accepted values
TRUE (listens for packets destined for ANY of the addresses associated with the machine)
FALSE (only listens for packets destined for the IP address given to it on start-up)
Default value
Listening on any IP address associated with a multi-homed machine [DAS]
Section
Parameter
Description
Determines whether or not the unidasd daemon/service process will listen for packets directed at ANY of the addresses associated with the machine hosting the CorporateTime Server. This is only relevant when the CorporateTime Server is running on a machine which has multiple IP addresses.
Accepted values
TRUE (listens for packets destined for ANY of the addresses associated with the machine)
FALSE (only listens for packets destined for the IP address given to it on start-up)
Default value
Re-use of socket address
Section
Parameter
Description
Determines whether or not, on creation of the socket address for the unidasd daemon, the local portion of the address handed to the operating system is flagged as re-usable. Note that this is relevant only for the start-up of the unidasd daemon and not for any subsequent unidasd servers.
Accepted values
TRUE (the local portion of the address is flagged re-usable)
FALSE (the local portion of the address is flagged not re-usable)
Default value
Sleep time between checks on request queue
Section
Parameter
Description
The number of seconds the Corporate-Wide Services daemon/service will wait (sleep) when there are no requests in the local queue. After that time, the unicwsd will again check its queue for pending requests. This setting affects how long it will take to propagate data, such as remote user invitations, to other nodes.
Accepted values
A positive integer up to a maximum value of (232 -1)
Default value
Maximum age of request in queue
Section
Parameter
Description
Specifies the maximum number of minutes that a request labelled CANTSERVICE will remain on the Corporate-Wide Services queue before being assigned a lower servicing priority.
Accepted values
A positive integer up to a maximum value of (232-1)
Default value
Default time zone
Section
Parameter
Description
Specifies the local time zone.
Accepted values
Any time zone that appears in the /users/unison/misc/timezone.ini file (e.g. "EST-5EDT")
Default value
Time zone rules
Section
Parameter
Description
Specifies the name of the file containing time zone rules.
Accepted values
A valid fully-specified file name
Default value
/users/unison/misc/timezone.ini
Checksum of the time zone rules file
Section
Parameter
Description
Contains the checksum of the time zone rules file. This is a preset value and it must not be altered under any circumstance.
Accepted values
Default value
Controlling server interactions with directory server
Set directory service
Section
Parameter
Description
Specifies the directory service that the unidasd daemon/service will access. The value of this parameter is also found as the name of the section in the /user/unison/misc/unison.ini file where the configuration parameters for the directory service will be found. For example, if dir_service=LDAP, the LDAP directory service configuration parameters would be found in the [LDAP] section of the unison.ini file.
Accepted values
Default value
Name of directory server
Section
Parameter
Description
Specifies the name of the LDAP directory server.
Accepted values
Netscape (for the Netscape LDAP directory server)
CDS_GDS500 (for the CDS LDAP directory server)
ISOCOR_GDS (for the ISOCOR LDAP directory server)
Default value
Name of directory server host
Section
Parameter
Description
Specifies the name of the host on which the LDAP directory server runs.
Accepted values
Default value
LDAP protocol version number
Section
Parameter
Description
Specifies the LDAP protocol version number to use.
Accepted values
Default value
Port number of the LDAP directory server
Section
Parameter
Description
Specifies the port number of the LDAP directory server.
Accepted values
Default value
Character set used by the directory server
Section
Parameter
Description
Indicates the character set used by the LDAP directory server, and thus the character set that the CorporateTime Server must use for data destined for the LDAP directory server.
Accepted values
A valid character set name for which a .map file exists in the directory specified by the charsetdir parameter. The charmap.config file in that directory may be consulted to determine the .map file associated with a particular character set as well as the set of valid names for that character set.
Default value
Directory server support for ldap_compare() requests
Section
Parameter
Description
Indicates whether the LDAP directory server can handle ldap_compare() calls properly or whether ldap_search() calls must be used instead.
Accepted values
TRUE (ldap_compare() must be used)
FALSE (ldap_search() calls are handled properly)
Default value
Permissions for modifying directory server attributes
Section
Parameter
Description
Specifies whether the CorporateTime reserved users can modify all Directory Server attributes or are limited to modifying only the CorporateTime attributes in the directory server.
Accepted values
TRUE (permit modifications only to CorporateTime attributes in the directory server)
FALSE (permit modifications to all attributes in the directory server)
Default value
Permissions for updating directory server attributes
Section
Parameter
Description
Specifies whether the CorporateTime reserved users can update all directory server attributes or are limited to updating only the CorporateTime attributes in the directory server.
Accepted values
TRUE (only permit updates to CorporateTime attributes in the directory server)
FALSE (permit updates to all attributes in the directory server)
Default value
Attribute preserve list
Section
Parameter
Description
Specifies a list of attributes (a "preserve list") which are not to be deleted when a CorporateTime user is deleted (i.e. when the user's calendar attributes as well as their ctCalUser object class are deleted). If the CorporateTime user entries also use the inetOrgPerson object class, this parameter should be configured as follows:
{"employeeNumber", "givenName", "initials", "mail", "ou"}
Any fields mapped to attributes outside of the ctCalUser object class (e.g. attr_organization="uid") should also be added to the "preserve list".
Accepted values
A list of strings, where each string in the list is the name of a user attribute which is not to be deleted when the user is deleted
Default value
Name of the "country" attribute
Section
Parameter
Description
Determines the attribute name that the LDAP directory server will use for the "country" attribute.
Accepted values
Any attribute name defined in the LDAP directory server schema
Default value
Name of the "generation qualifier" attribute
Section
Parameter
Description
Determines the attribute name that the LDAP directory server will use for the "generation qualifier" attribute.
Accepted values
Any attribute name defined in the LDAP directory server schema
Default value
Name of the "organization" attribute
Section
Parameter
Description
Determines the attribute name that the LDAP directory server will use for the "organization" attribute.
Accepted values
Any attribute name defined in the LDAP directory server schema
Default value
Name of the "fax" attribute
Section
Parameter
Description
Determines the attribute name that the LDAP directory server will use for the "fax" attribute.
Accepted values
Any attribute name defined in the LDAP directory server schema
Default value
Name of the "given name" attribute
Section
Parameter
Description
Determines the attribute name that the LDAP directory server will use for the "given name" attribute.
Accepted values
Any attribute name defined in the LDAP directory server schema
Default value
Name of the "mail" attribute
Section
Parameter
Description
Determines the attribute name that the LDAP directory server will use for the "mail" attribute.
Accepted values
Any attribute name defined in the LDAP directory server schema
Default value
Location of the calendar server administrators
Section
Parameter
Description
Specifies part of the Distinguished Name (DN) of the location under which the CorporateTime Server administrators will be created. The DN of this location is constructed by appending the value of the basedn parameter to the value of the admin parameter. For example, where admin="ou=calendar servers" and basedn="o=acme", the DN for the location under which the CorporateTime Server administrators will be created is "ou=calendar servers, o=acme".
Accepted values
A valid Distinguished Name or Relative Distinguished Name (see your LDAP directory server documentation for further information on the correct form)
Default value
Group entry for calendar server administrators
Section
Parameter
Description
Specifies part of the Distinguished Name (DN) of the group entry for the CorporateTime Server administrators (the administrators are added to this group). The DN of the group entry is constructed by appending the value of the basedn parameter to the value of the admingroup parameter. For example, where admingroup="cn=calendar server admins" and basedn="o=acme", the DN for the group entry of the CorporateTime Server administrators is "cn=calendar server admins, o=acme".
Accepted values
A valid Distinguished Name or Relative Distinguished Name (see your LDAP directory server documentation for further information on the correct form)
Default value
cn=CorporateTime Server Admins
Distinguished Name of the subtree containing the calendar server entries
Section
Parameter
Description
Specifies the Distinguished Name of the LDAP directory server subtree containing the CorporateTime entries.
Accepted values
A valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form of a Distinguished Name)
Default value
Distinguished Name used for anonymous connections
Section
Parameter
Description
Specifies the Distinguished Name used by the LDAP directory server for anonymous connections.
Accepted values
Any valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form of a Distinguished Name)
Default value
Distinguished Name of the directory server administrator
Section
Parameter
Description
Specifies the Distinguished Name of the LDAP directory server administrator.
Accepted values
A valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form of a Distinguished Name)
Default value
Password used for anonymous connections
Section
Parameter
Description
Specifies the password used by the LDAP directory server for anonymous connections.
Accepted values
Default value
Password to use during migrations for users without passwords
Section
Parameter
Description
Specifies the password to use during migrations for users without passwords.
Accepted values
Default value
Directory server handling of changes to passwords
Section
Parameter
Description
Determines how the LDAP directory server handles changes to passwords.
Accepted values
TRUE (passwords must first be erased and then set afresh)
FALSE (passwords may be reset without first erasing them)
Default value
Enable debugging mode
Section
Parameter
Description
Enables debugging mode on the LDAP directory server.
Accepted values
FALSE (disable debugging mode)
Default value
Additional parameters
The following parameters are documented here for reference purposes only. It is unlikely that the default values supplied for these parameters would require tuning in the majority of CorporateTime Server implementations.
Optional [SNC] parameters
Number of minutes to wait for remote node connection
Section
Parameter
Description
Specifies the number of minutes to wait if the SNC daemon/service is not able to connect to the remote node.
Accepted values
Default value
Number of requests that are reset at a time
Section
Parameter
Description
Specifies the number of requests that are reset at a time by the SNC daemon/service. When the SNC daemon/service establishes a connection, it also examines the request queue of each local node and resets all requests labelled CANTSERVICE to NOTSERVICED. To minimize the time that another process may be made to wait for access to the node database while the SNC daemon/service resets the request queue (which is in the node database), this parameter allows the resetting to be performed in "chunks" of requests.
Accepted values
Default value
Block size for communications
Section
Parameter
Description
Specifies the block size, in bytes, that will be used for communications between the uniengd and the unidasd. This value should not be changed without first consulting your support provider.
Accepted values
0 (choose the default from the trn library)
Default value
Time-out for received transmissions
Section
Parameter
Description
Specifies the time-out value for received transmissions. This value should be increased substantially if the CorporateTime administrator expects a large volume of recurring events with both local and remote attendees. A tenfold increase (i.e. 600) should suffice.
Accepted values
Default value
Time-out for sent transmissions
Section
Parameter
Description
Specifies the time-out value for sent transmissions.
Accepted values
Default value
Size of the socket layer receive buffer
Section
Parameter
Description
Specifies the size, in bytes, of the socket layer receive buffer. This value should not be changed without first consulting your support provider.
Accepted values
0 (let trn library supply a default value)
Default value
Size of the socket layer send buffer
Section
Parameter
Description
Specifies the size, in bytes, of the socket layer send buffer. This value should not be changed without first consulting your support provider.
Accepted values
0 (let trn library supply a default value)
Default value
Unsent messages on termination of SNC daemon/service
Section
Parameter
Description
Determines what is done with any unsent data that exists in the socket send buffer at the time the SNC daemon/service is terminated.
Accepted values
TRUE (system will attempt to deliver the unsent data)
FALSE (system will discard any unsent data)
Default value
Idle connections
Section
Parameter
Description
Determines whether or not the system keeps idle connections active.
If this parameter is set to TRUE, a network packet is sent periodically to determine whether or not the process on the other end of an idle connection is still running. If no acknowledgement is received from that process within a specified period of time, it is assumed to have terminated and the connection is no longer maintained.
If this parameter is set to FALSE, periodic checking on idle connections is not done, and the connection is maintained indefinitely.
Accepted values
TRUE (periodically checks idle connections and terminates ones which have no acknowledging process at the other end)
FALSE (maintains idle connections indefinitely)
Default value
[SNC] Section
Multiple Configurations
Each time the CorporateTime Synchronous Network Connection service connects to a CorporateTime Engine, a section could be used to describe the connection, transaction, and socket options. Defaults always apply if none is present. For example:
[ computername | ALL , unieng , node-ID | ALL ]
The section name consists of three parts: the computer name, the service name (uniengd) and the associated node. In the example above, eight new options have been introduced:
retry = 1
Indicates the number of times the SNC service should retry to establish a connection.
connect_timeout = 30
The time-out (in seconds) used to indicated that a connection has failed.
max_wait_before_retry = 64
The maximum time (in minutes) for the retry mechanism.
send_cleanup_timeout = 200
Determines the time-out (in milliseconds) associated with the connection shutdown.
recv_cleanup_timeout = 200
Determines the time-out (in milliseconds) associated with the connection shutdown.
unstable_net_period = 15
The above three parameters are used to define an unstable network. In the above case, when the SNC service finds unstable_net_lost_per_min connections for unstable_net_period minutes, the service enters the retry mechanism mode. In this case, the SNC service waits for unstable_net_first_retry minutes before reconnecting to the node.
| Corporate Software & Technologies http://www.cst.ca Voice: (514) 733-8500 Fax: (514) 733-8878 info@cst.ca |
| |
|
|
|