Matthew Farrellee 0f2f822
diff --git a/src/condor_examples/condor_config.generic b/src/condor_examples/condor_config.generic
Matthew Farrellee 0f2f822
index 3375e11..b921459 100644
Matthew Farrellee 0f2f822
--- a/src/condor_examples/condor_config.generic
Matthew Farrellee 0f2f822
+++ b/src/condor_examples/condor_config.generic
Matthew Farrellee 7659d4d
@@ -1,12 +1,31 @@
3e1318f
 ######################################################################
3e1318f
+######################################################################
Matthew Farrellee 7659d4d
+###                                                                ###
Matthew Farrellee 7659d4d
+###  N O T I C E:   D O   N O T   E D I T   T H I S   F I L E      ###
Matthew Farrellee 7659d4d
+###                                                                ###
Matthew Farrellee 7659d4d
+###      Customization should be done via the LOCAL_CONFIG_DIR.    ###
Matthew Farrellee 7659d4d
+###                                                                ###
3e1318f
+######################################################################
3e1318f
+######################################################################
3e1318f
+
3e1318f
+
3e1318f
+######################################################################
3e1318f
 ##
3e1318f
 ##  condor_config
3e1318f
 ##
3e1318f
 ##  This is the global configuration file for condor.  Any settings
3e1318f
-##  made here may potentially be overridden in the local configuration
3e1318f
-##  file.  KEEP THAT IN MIND!  To double-check that a variable is
3e1318f
-##  getting set from the configuration file that you expect, use
3e1318f
-##  condor_config_val -v <variable name>
3e1318f
+##  found here * * s h o u l d   b e   c u s t o m i z e d   i n
Matthew Farrellee 7659d4d
+##  a   l o c a l   c o n f i g u r a t i o n   f i l e. * *
3e1318f
+##
Matthew Farrellee 7659d4d
+##  The local configuration files are located in LOCAL_CONFIG_DIR, set
3e1318f
+##  below.
3e1318f
+##
3e1318f
+##  For a basic configuration, you may only want to start by
Matthew Farrellee 7659d4d
+##  customizing CONDOR_HOST and DAEMON_LIST.
3e1318f
+##
3e1318f
+##  Note: To double-check where a configuration variable is set from
Matthew Farrellee 7659d4d
+##  you can use condor_config_val -v -config <variable name>,
Matthew Farrellee 7659d4d
+##  e.g. condor_config_val -v -config CONDOR_HOST.
3e1318f
 ##
3e1318f
 ##  The file is divided into four main parts:
Matthew Farrellee 7659d4d
 ##  Part 1:  Settings you likely want to customize 
Matthew Farrellee 0f2f822
@@ -53,7 +72,7 @@ CONDOR_HOST	= central-manager-hostname.your.domain
e8dbbab
 ##  Pathnames:
e8dbbab
 ##--------------------------------------------------------------------
e8dbbab
 ##  Where have you installed the bin, sbin and lib condor directories?   
e8dbbab
-RELEASE_DIR		= /usr/local/condor
e8dbbab
+RELEASE_DIR		= /usr
e8dbbab
 
e8dbbab
 ##  Where is the local condor directory for each host?  
e8dbbab
 ##  This is where the local config file(s), logs and
Matthew Farrellee 0f2f822
@@ -61,17 +80,20 @@ RELEASE_DIR		= /usr/local/condor
Matthew Farrellee 7659d4d
 LOCAL_DIR		= $(TILDE)
Matthew Farrellee 7659d4d
 #LOCAL_DIR		= $(RELEASE_DIR)/hosts/$(HOSTNAME)
3e1318f
 
Matthew Farrellee 7659d4d
-##  Where is the machine-specific local config file for each host?
Matthew Farrellee 7659d4d
-LOCAL_CONFIG_FILE	= $(LOCAL_DIR)/condor_config.local
Matthew Farrellee 7659d4d
-#LOCAL_CONFIG_FILE	= $(RELEASE_DIR)/etc/$(HOSTNAME).local
Matthew Farrellee 7659d4d
+## Looking for LOCAL_CONFIG_FILE? You will not find it here. Instead
Matthew Farrellee 7659d4d
+## put a file in the LOCAL_CONFIG_DIR below. It is a more extensible
Matthew Farrellee 7659d4d
+## means to manage configuration. The order in which configuration
Matthew Farrellee 7659d4d
+## files are read from the LOCAL_CONFIG_DIR is lexicographic. For
Matthew Farrellee 7659d4d
+## instance, config in 00MyConfig will be overridden by config in
Matthew Farrellee 7659d4d
+## 97MyConfig.
e8dbbab
 
Matthew Farrellee 7659d4d
 ##  Where are optional machine-specific local config files located?
Matthew Farrellee 7659d4d
 ##  Config files are included in lexicographic order.
Matthew Farrellee 7659d4d
-LOCAL_CONFIG_DIR	= $(LOCAL_DIR)/config
Matthew Farrellee 7659d4d
-#LOCAL_CONFIG_DIR	= $(LOCAL_DIR)/config
Matthew Farrellee 7659d4d
+##  No default.
Matthew Farrellee 7659d4d
+LOCAL_CONFIG_DIR        = $(ETC)/config.d
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## Blacklist for file processing in the LOCAL_CONFIG_DIR
Matthew Farrellee 7659d4d
-## LOCAL_CONFIG_DIR_EXCLUDE_REGEXP = ^((\..*)|(.*~)|(#.*)|(.*\.rpmsave)|(.*\.rpmnew))$
Matthew Farrellee 7659d4d
+LOCAL_CONFIG_DIR_EXCLUDE_REGEXP = ^((\..*)|(.*~)|(#.*)|(.*\.rpmsave)|(.*\.rpmnew))$
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## If the local config file is not present, is it an error?
Matthew Farrellee 7659d4d
 ## WARNING: This is a potential security issue. 
Matthew Farrellee 0f2f822
@@ -409,7 +431,22 @@ ALLOW_READ_STARTD     = $(ALLOW_READ), $(FLOCK_FROM)
Matthew Farrellee 7659d4d
 ##  condor account, it's probably condor.  Otherwise, it's whatever
Matthew Farrellee 7659d4d
 ##  you've set in the CONDOR_IDS environment variable.  See the Admin
Matthew Farrellee 7659d4d
 ##  manual for details on this.
Matthew Farrellee 7659d4d
-LOCK		= $(LOG)
Matthew Farrellee 0f2f822
+LOCK		= /var/lock/condor
Matthew Farrellee 7659d4d
+
Matthew Farrellee 7659d4d
+# Condor allows for creating surrogate lock files that always live on
Matthew Farrellee 7659d4d
+# local disk. This is useful for the times when Condor would otherwise
Matthew Farrellee 7659d4d
+# lock a file on a network filesystem, such as a UserLog.
Matthew Farrellee 7659d4d
+# CREATE_LOCKS_ON_LOCAL_DISK controls this feature, and
Matthew Farrellee 7659d4d
+# LOCAL_DISK_LOCK_DIR controls where the lock files are created. The
Matthew Farrellee 7659d4d
+# local dir must have tmp-like permissions (1777), because multiple
Matthew Farrellee 7659d4d
+# users, e.g. via condor_submit or condor_dagman, will need to
Matthew Farrellee 7659d4d
+# add/remove lock files.
Matthew Farrellee 7659d4d
+# NOTE: This will not provide proper locking if a shared file is
Matthew Farrellee 7659d4d
+# simultaneously accessed from multiple machines. However, that is not
Matthew Farrellee 7659d4d
+# a common event. One example where it is possible is remote
Matthew Farrellee 7659d4d
+# submission with condor_submit -remote.
Matthew Farrellee 7659d4d
+#CREATE_LOCKS_ON_LOCAL_DISK = TRUE
Matthew Farrellee 7659d4d
+LOCAL_DISK_LOCK_DIR = $(LOCK)/local
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ##  If you don't use a fully qualified name in your /etc/hosts file
Matthew Farrellee 7659d4d
 ##  (or NIS, etc.) for either your official hostname or as an alias,
Matthew Farrellee 0f2f822
@@ -475,7 +512,8 @@ GLIDEIN_SERVER_URLS = \
Matthew Farrellee 7659d4d
 ##  the execute machine and just make sure the two strings match.  The
Matthew Farrellee 7659d4d
 ##  default for this setting is False, since it is more secure this
Matthew Farrellee 7659d4d
 ##  way.
Matthew Farrellee 7659d4d
-#TRUST_UID_DOMAIN = False
Matthew Farrellee 7659d4d
+##   Default is False
Matthew Farrellee 7659d4d
+TRUST_UID_DOMAIN = True
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## If you would like to be informed in near real-time via condor_q when
Matthew Farrellee 7659d4d
 ## a vanilla/standard/java job is in a suspension state, set this attribute to
Matthew Farrellee 0f2f822
@@ -514,8 +552,9 @@ GLIDEIN_SERVER_URLS = \
Matthew Farrellee 7659d4d
 ## just disable it).
Matthew Farrellee 7659d4d
 #NEGOTIATOR_IGNORE_USER_PRIORITIES = False
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
-## This is a list of libraries containing ClassAd plug-in functions.
Matthew Farrellee 7659d4d
-#CLASSAD_USER_LIBS =
Matthew Farrellee 7659d4d
+## These are the directories used to locate classad plug-in functions
Matthew Farrellee 7659d4d
+#CLASSAD_SCRIPT_DIRECTORY =
Matthew Farrellee 7659d4d
+#CLASSAD_LIB_PATH =
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## This setting tells Condor whether to delegate or copy GSI X509
Matthew Farrellee 7659d4d
 ## credentials when sending them over the wire between daemons.
Matthew Farrellee 0f2f822
@@ -605,6 +644,9 @@ SHARED_PORT_DEBUG       =
Matthew Farrellee 7659d4d
 MAX_HDFS_LOG            = 1000000
Matthew Farrellee 7659d4d
 HDFS_DEBUG              =
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
+MAX_TRIGGERD_LOG	= 1000000
Matthew Farrellee 7659d4d
+TRIGGERD_DEBUG        	=
Matthew Farrellee 7659d4d
+
Matthew Farrellee 7659d4d
 # High Availability Logs
Matthew Farrellee 7659d4d
 MAX_HAD_LOG		= 1000000
Matthew Farrellee 7659d4d
 HAD_DEBUG		=
Matthew Farrellee 0f2f822
@@ -927,14 +969,18 @@ TESTINGMODE_CLAIM_WORKLIFE = 1200
Matthew Farrellee 7659d4d
 ######################################################################
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ##  Pathnames
Matthew Farrellee 7659d4d
-LOG		= $(LOCAL_DIR)/log
Matthew Farrellee 0f2f822
+LOG		= /var/log/condor
Matthew Farrellee 7659d4d
 SPOOL		= $(LOCAL_DIR)/spool
e8dbbab
 EXECUTE		= $(LOCAL_DIR)/execute
e8dbbab
 BIN		= $(RELEASE_DIR)/bin
3e1318f
 LIB		= $(RELEASE_DIR)/lib
e8dbbab
-INCLUDE		= $(RELEASE_DIR)/include
Matthew Farrellee 0f2f822
+INCLUDE		= $(RELEASE_DIR)/include/condor
e8dbbab
 SBIN		= $(RELEASE_DIR)/sbin
e8dbbab
-LIBEXEC		= $(RELEASE_DIR)/libexec
Matthew Farrellee 0f2f822
+SHARE		= $(RELEASE_DIR)/share/condor
Matthew Farrellee 0f2f822
+RUN		= /var/run/condor
Matthew Farrellee 7659d4d
+DATA		= $(SPOOL)
Matthew Farrellee 0f2f822
+ETC		= /etc/condor
e8dbbab
+LIBEXEC		= $(RELEASE_DIR)/libexec/condor
e8dbbab
 
e8dbbab
 ## If you leave HISTORY undefined (comment it out), no history file
e8dbbab
 ## will be created. 
Matthew Farrellee 0f2f822
@@ -958,6 +1004,7 @@ HAD_LOG		= $(LOG)/HADLog
Matthew Farrellee 7659d4d
 REPLICATION_LOG	= $(LOG)/ReplicationLog
Matthew Farrellee 7659d4d
 TRANSFERER_LOG	= $(LOG)/TransfererLog
Matthew Farrellee 7659d4d
 HDFS_LOG	= $(LOG)/HDFSLog
Matthew Farrellee 7659d4d
+TRIGGERD_LOG	= $(LOG)/TriggerLog
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ##  Lock files
Matthew Farrellee 7659d4d
 SHADOW_LOCK	= $(LOCK)/ShadowLock
Matthew Farrellee 0f2f822
@@ -1078,7 +1125,7 @@ DAEMON_LIST			= MASTER, STARTD, SCHEDD
Matthew Farrellee 7659d4d
 #DC_DAEMON_LIST = \
Matthew Farrellee 7659d4d
 #MASTER, STARTD, SCHEDD, KBDD, COLLECTOR, NEGOTIATOR, EVENTD, \
Matthew Farrellee 7659d4d
 #VIEW_SERVER, CONDOR_VIEW, VIEW_COLLECTOR, HAWKEYE, CREDD, HAD, \
Matthew Farrellee 7659d4d
-#DBMSD, QUILL, JOB_ROUTER, ROOSTER, LEASEMANAGER, HDFS, SHARED_PORT
Matthew Farrellee 7659d4d
+#DBMSD, QUILL, JOB_ROUTER, ROOSTER, LEASEMANAGER, HDFS, SHARED_PORT, TRIGGERD
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ##  Where are the binaries for these daemons?
Matthew Farrellee 0f2f822
@@ -1094,6 +1141,7 @@ ROOSTER                         = $(LIBEXEC)/condor_rooster
Matthew Farrellee 7659d4d
 HDFS				= $(SBIN)/condor_hdfs
Matthew Farrellee 7659d4d
 SHARED_PORT			= $(LIBEXEC)/condor_shared_port
Matthew Farrellee 7659d4d
 TRANSFERER			= $(LIBEXEC)/condor_transferer
Matthew Farrellee 7659d4d
+TRIGGERD			= $(sbin)/condor_triggerd
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ##  When the master starts up, it can place it's address (IP and port)
Matthew Farrellee 7659d4d
 ##  into a file.  This way, tools running on the local machine don't
Matthew Farrellee 0f2f822
@@ -1170,11 +1218,13 @@ PREEN_ARGS			= -m -r
Matthew Farrellee 7659d4d
 ##--------------------------------------------------------------------
Matthew Farrellee 7659d4d
 ## Address to which Condor will send a weekly e-mail with output of
Matthew Farrellee 7659d4d
 ## condor_status.
Matthew Farrellee 7659d4d
-#CONDOR_DEVELOPERS = condor-admin@cs.wisc.edu
Matthew Farrellee 7659d4d
+##  Default is condor-admin@cs.wisc.edu
Matthew Farrellee 7659d4d
+CONDOR_DEVELOPERS = NONE
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## Global Collector to periodically advertise basic information about
Matthew Farrellee 7659d4d
 ## your pool.
Matthew Farrellee 7659d4d
-#CONDOR_DEVELOPERS_COLLECTOR = condor.cs.wisc.edu
Matthew Farrellee 7659d4d
+##  Default is condor.cs.wisc.edu
Matthew Farrellee 7659d4d
+CONDOR_DEVELOPERS_COLLECTOR = NONE
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ##--------------------------------------------------------------------
Matthew Farrellee 0f2f822
@@ -1183,6 +1233,7 @@ PREEN_ARGS			= -m -r
Matthew Farrellee 7659d4d
 ## Determine if the Negotiator will honor SlotWeight attributes, which
Matthew Farrellee 7659d4d
 ## may be used to give a slot greater weight when calculating usage.
Matthew Farrellee 7659d4d
 #NEGOTIATOR_USE_SLOT_WEIGHTS = True
Matthew Farrellee 7659d4d
+NEGOTIATOR_USE_SLOT_WEIGHTS = False
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## How often the Negotaitor starts a negotiation cycle, defined in
Matthew Farrellee 0f2f822
@@ -1620,7 +1671,7 @@ QUEUE_SUPER_USERS	= root, condor
Matthew Farrellee 7659d4d
 ##--------------------------------------------------------------------
Matthew Farrellee 7659d4d
 ##  condor_starter
Matthew Farrellee 7659d4d
 ##--------------------------------------------------------------------
Matthew Farrellee 7659d4d
-##  The condor_starter can renice the processes of Condor
Matthew Farrellee 7659d4d
+##  The condor_starter can renice the processes from remote Condor
Matthew Farrellee 7659d4d
 ##  jobs on your execute machines.  If you want this, uncomment the
Matthew Farrellee 7659d4d
 ##  following entry and set it to how "nice" you want the user
Matthew Farrellee 7659d4d
 ##  jobs. (1-19)  The larger the number, the lower priority the
Matthew Farrellee 0f2f822
@@ -1661,7 +1712,7 @@ PROCD = $(SBIN)/condor_procd
Matthew Farrellee 7659d4d
 #     UNIX); the name will be something like:
Matthew Farrellee 7659d4d
 #         \\.\pipe\condor_procd
Matthew Farrellee 7659d4d
 #
Matthew Farrellee 7659d4d
-PROCD_ADDRESS = $(LOCK)/procd_pipe
Matthew Farrellee 7659d4d
+PROCD_ADDRESS = $(RUN)/procd_pipe
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 # The procd currently uses a very simplistic logging system. Since this
Matthew Farrellee 7659d4d
 # log will not be rotated like other Condor logs, it is only recommended
Matthew Farrellee 0f2f822
@@ -1770,7 +1821,7 @@ JAVA_MAXHEAP_ARGUMENT = -Xmx
3e1318f
 ## them here.  However, do not remove the existing entries, as Condor
3e1318f
 ## needs them.
3e1318f
 
3e1318f
-JAVA_CLASSPATH_DEFAULT = $(LIB) $(LIB)/scimark2lib.jar .
3e1318f
+JAVA_CLASSPATH_DEFAULT = $(SHARE) $(SHARE)/scimark2lib.jar .
3e1318f
 
3e1318f
 ##  JAVA_CLASSPATH_ARGUMENT describes the command-line parameter
3e1318f
 ##  used to introduce a new classpath:
Matthew Farrellee 0f2f822
@@ -2246,8 +2297,8 @@ MAX_VM_GAHP_LOG	= 1000000
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## What kind of virtual machine program will be used for 
Matthew Farrellee 7659d4d
 ## the VM universe?
Matthew Farrellee 7659d4d
-## The two options are vmware and xen.  (Required)
Matthew Farrellee 7659d4d
-#VM_TYPE = vmware
Matthew Farrellee 7659d4d
+## The three primary options are KVM, Xen and VMware.  (Required: no default)
Matthew Farrellee 7659d4d
+#VM_TYPE = kvm
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 ## How much memory can be used for the VM universe? (Required)
Matthew Farrellee 7659d4d
 ## This value is the maximum amount of memory that can be used by the 
Matthew Farrellee 0f2f822
@@ -2478,7 +2529,7 @@ KBDD_ADDRESS_FILE = $(LOG)/.kbdd_address
Matthew Farrellee 7659d4d
 #SSH_TO_JOB_SSHD_ARGS = "-i -e -f %f"
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 # sshd configuration template used by condor_ssh_to_job_sshd_setup.
Matthew Farrellee 7659d4d
-#SSH_TO_JOB_SSHD_CONFIG_TEMPLATE = $(LIB)/condor_ssh_to_job_sshd_config_template
Matthew Farrellee 7659d4d
+SSH_TO_JOB_SSHD_CONFIG_TEMPLATE = $(ETC)/condor_ssh_to_job_sshd_config_template
Matthew Farrellee 7659d4d
 
Matthew Farrellee 7659d4d
 # Path to ssh-keygen
Matthew Farrellee 7659d4d
 #SSH_TO_JOB_SSH_KEYGEN = /usr/bin/ssh-keygen