Contents
-
Introducing NightWatchman Enterprise 7.3
-
How it works
-
Quick starts, evaluations and pilots
-
Implementation
-
Working with NightWatchman Enterprise
-
Troubleshooting
-
Training
-
Reference
-
Supported Platforms
-
Server Sizing
-
Communication ports
-
Server installation properties
- Agent installation properties
-
Server API reference
-
Windows 1E NightWatchman Agent scripting reference
-
Mac 1E Agent scripting reference
-
Extending the Console Query interface
-
NightWatchman Enterprise release information
-
Supported Platforms
1E NightWatchman Agent installer properties
Property | Default value | Notes |
---|---|---|
CERTISSUER | Text used to search for a client certificate in the client certificate store. Use either CERTISSUER or CERTSUBJECT only when using HTTPS for communications and the NightWatchman Management Center Web service is configured to require a client certificate. | |
CERTSUBJECT | Text used to search for a client certificate in the client certificate store. Use either CERTISSUER or CERTSUBJECT only when using HTTPS for communications and the NightWatchman Management Center Web Service is configured to require a client certificate. | |
DEBUG | 13 | The debug level (decimal value) for the NightWatchman. Range is between 0 and 255. |
HARDWAREUTILIZATION | OFF | Controls the gathering of Computer Reclaim (formerly named Hardware Utilization) data used in the Computer Reclaim reports.
|
INSTALLDIR | %PROGRAMFILES%\1E\ | Optional parameter that determines the agent installation directory. It is the same directory for both 32-bit and 64-bit machines, when the correct version of the agent is used. |
LOGPATH | %ALLUSERSPROFILE%\1E\ | Path is created if it does not exist. |
MAXLOGFILESIZE | 1048576 | Integer (in bytes) for of 1E Agent log file. When this size is reached, the file is renamed with a .LO _extension and a new .LOG file is created. The .LO _file is overwritten each time. |
REPORTING | ON | The reporting states. Values are:
|
REPORTINGSERVER | When using HTTP for communications, set this parameter to the FQDN (recommended) or NetBIOS name of the server hosting the NightWatchman Management Center Web service. | |
SECUREREPORTINGSERVER | When using HTTPS for communications, set this parameter to the FQDN (recommended) or NetBIOS name of the server where the NightWatchman Management Center Web Service component secure site has been installed. | |
USEFIPS | 0 | Use FIPS for encrypting communications for NightWatchman.
|
POWEROPTIMIZATION | ON | Controls the gathering of Power/Battery data used in the Power Optimization reports.
See also Understanding Power Optimization. |
REBOOTOPTIMIZATION | ON | Controls the gathering of user reboot data used in the Reboot Summary report.
|
1E Agent component installer properties
The legacy 1E Agent installer for version 7.2.0 and earlier, contains various properties that can be set on the MSIEXEC command-line. The complete set is provided in the following table.
Property | Default value | Notes |
---|---|---|
ACMONDAYTIME | Start of a Monday alarm clock, in the format ACMONDAYTIME=08:00 | |
ACFRIDAYTIME | Start of a Friday alarm clock, in the format ACFRIDAYTIME=08:00 | |
ACSATURDAYTIME | Start of a Saturday alarm clock, in the format ACSATURDAYTIME=08:00 | |
ACSUNDAYTIME | Start of a Sunday alarm clock in the format ACSUNDAYTIME=08:00 | |
ACTHURSDAYTIME | Start of a Thursday alarm clock in the format ACTHURSDAYTIME=08:00 | |
ACTUESDAYTIME | Start of a Tuesday alarm clock in the format ACTUESDAYTIME=08:00 | |
ACTURNONMONITOR | ON | Determines if the monitor is turned on during alarm clocks. Values are:
|
ACWEDNESDAYTIME | Start of a Wednesday alarm clock in the format ACWEDNESDAYTIME=08:00 | |
ADVANCEDSLEEPLESSDETECTION | ON | Determines the state of advanced sleepless detection feature. Values are:
|
BUSYPROCESSDETECTION | ON | Toggles busy process detection on or off.
|
COUNTDOWNSECS | 30 | Integer value (in seconds) to display the countdown time dialog box before the shutdown or log-off action is executed.
|
DISKAC | 60 | Integer value (in minutes) before the hard disks goes into stand-by mode when the computer is running on mains power.
|
DISKDC | 5 | Integer value (in minutes) before the hard drive goes into stand-by mode when the computer is running on battery power.
|
FRIDAYCLOSEACTION | 0 | The action to run when closing the maintenance window.
FRIDAYCLOSEACTION=1 |
FRIDAYOPENTIME | Time for the start of a Friday maintenance window in the format FRIDAYOPENTIME=02:00 | |
FRIDAYPERIODMINS | The duration (in minutes) for the maintenance window on a Friday. For example, to set Friday's maintenance window to be 1 hour: FRIDAYPERIODMINS=60 | |
HIBERNATEAC | 0 | Integer value (in minutes) before the computer goes into hibernate mode when it is running on mains power.
|
HIBERNATEDC | 0 | Integer value (in minutes) before a computer goes into hibernate mode when running on battery power.
|
HTTP | See CERTISSUER, CERTSUBJECT, REPORTINGSERVER and SECUREREPORTINGSERVER for the new methods of setting communications with the NightWatchman Management Center Web service. | |
IGNOREERRORS | OFF | The behavior for NightWatchman when errors are encountered during shutdown.
|
INSTALLSCRIPTS | 1 | Determines if shutdown scripts are installed.
|
INSTALLSLEEPLESS | 1 | Determines if the sleepless detection driver is installed.
|
KEEPAWAKEAFTERWAKEUPMINS | 60 | Time a computer is kept awake following an alarm clock wake up.
|
LOGOFFACTION | Active | Determines the behavior when a user is logged onto the system. In all instances, scripts will be executed to close down applications gracefully.
|
MONDAYCLOSEACTION | 0 | The action to run upon closing the maintenance window.
For example, to set the close action for Monday putting a device on hibernate MONDAYCLOSEACTION=2 |
MONDAYOPENTIME | Time for the start of a Monday maintenance window in the format MONDAYOPENTIME=02:00 | |
MONDAYPERIODMINS | Duration (in minutes) for Monday maintenance windows. For example, to set the maintenance window to 1 hour on Monday: MONDAYPERIODMINS=60 | |
MONITORAC | 15 | Integer value (in minutes) before a display goes into standby-mode when he computer s running on mains power.
|
MONITORDC | 3 | Integer value (in mminutes) before a display goes into standby when the computer is running on battery power.
|
MONITORJOBS | ON | Turns Configuration Manager job monitoring on or off.
|
NWMLOGFILENAME |
| Name for the NightWatchman log file. |
NWMSPOOLDIR |
| Location of the NightWatchman spooler directory, where NightWatchman Management Center Reporting messages are stored before being sent to the NightWatchman Management Center Web service. NWMSPOOLDIR , set by the installer, modifies the settings for communicating with the NightWatchman Management Center Reporting and should not need to be modified under normal circumstances. |
PENDINGJOBWINDOWMINS | 5 | The value modifies the power down behavior according to pending ConfigMgr jobs. It takes an integer that defines the number of minutes in the look-ahead window. We recommend that the PENDINGJOBWINDOWMINS value is set to slightly larger than the ConfigMgr polling refresh interval on the client. When PENDINGJOBWINDOWMINS=0, but MONITORJOBS=ON, the look-ahead functionality is turned off but the check for running ConfigMgr jobs will still happen. MONITORJOBS property must be set to ON (as it is by default) in order for this value to be used. The way that the shutdown behavior is modified is dependent on the type of shutdown, as shown below:
|
PRERUN | OFF | Determines if the PreRun script is run during power down actions. Values are:
|
PIDKEY | The NightWatchman license key. This value should be set to a valid license key obtained from Sales . If PIDKEY is not set, a 30-day evaluation license is generated. | |
POWERSCHEME | OFF | Controls the setting of a NightWatchman power scheme when the service starts and at user login
|
RETRYATTEMPTS | 3 | Integer value that sets the number of repeat times that a shutdown will be attempted if cancelled by the user.
|
RETRYINTERVAL | 60 | Integer value (in minutes) before the service attempts a shutdown if the event was cancelled by the user or the event could not be carried out.
|
RUNALWAYS | OFF | The behavior for running the
|
RUNALWAYSFORSLEEP | OFF | Determines if the RunAlways script is run during a NightWatchman initiated hibernate or standby.
|
RUNONRESUME | OFF | Determines if the
|
SATURDAYCLOSEACTION | 0 | The action to run when closing the maintenance window.
For example, t o set the close action for Saturday's maintenance window to power off. SATURDAYCLOSEACTION=3 |
SATURDAYOPENTIME | Time for the start of a Saturday maintenance window in the format SATURDAYOPENTIME=02:00 | |
SATURDAYPERIODMINS | The duration (in minutes) for the maintenance window on a Saturday. For example, t o set Saturday's maintenance window to be 1 hour: SATURDAYPERIODMINS=60 | |
SCRIPTTIMEOUTSECS | 30 | Integer value that determines the number of seconds NightWatchman waits before it decides that a script has timed out.
|
SHUTDOWN_HOUR | ||
SHUTDOWN_MIN | ||
SHUTDOWNACTION | Normal | The shutdown type.
|
STANDBYAC | 60 | Integer value (in minutes) before the computer goes into standby when it is running on mains power.
|
STANDBYDC | 5 | Integer value (insinuates) before a computer goes into standby when it is running on battery power.
|
STANDBYEXCLUSIONLIST | The process exclusions list. It takes a comma separated list of values where each value is the name of a process as it appears in the Sleepless and Busy processes report. When a NightWatchman client computer is at the point where it should enter a sleep state, NightWatchman checks any named processes on the sleepless exclusion list. | |
SUNDAYCLOSEACTION | 0 | he action to run when closing the maintenance window.
For example, to set the close action for Sunday's maintenance window to hibernate: SUNDAYCLOSEACTION=2 |
SUNDAYOPENTIME | The time for the start of a Sunday maintenance window in the format SUNDAYOPENTIME=02:00 | |
SUNDAYPERIODMINS | The duration (in minutes) for the maintenance window on a Sunday. For example, to set Sunday's maintenance window to 1 hour: SUNDAYPERIODMINS=60 | |
SYSTEMTRAY | ON | Controls the display of the system tray applet. Values are:
|
THURSDAYCLOSEACTION | 0 | The action to run when closing the maintenance window.
For example, to set the close action for Thursday's maintenance window to standby: THURSDAYCLOSEACTION=1 |
THURSDAYOPENTIME | The time for the start of a Thursday maintenance window in the format THURSDAYOPENTIME=02:00 | |
THURSDAYPERIODMINS | The duration (in minutes) for the maintenance window on a Thursday. For example, to set Thursday's maintenance window to 1 hour: THURSDAYPERIODMINS=60 | |
TUESDAYCLOSEACTION | 0 | The action to run when closing the maintenance window.
For example, t o set the close action for Tuesday's maintenance window to leave the computer in its awakened state: TUESDAYCLOSEACTION=0 |
TUESDAYOPENTIME | The time for the start of a Tuesday maintenance window in the format TUESDAYOPENTIME=02:00 | |
TUESDAYPERIODMINS | The duration (in minutes) for the maintenance window on a Tuesday. For example, to set Tuesday's maintenance window to be 1 hour: TUESDAYPERIODMINS=60 | |
TURNONMONITOR | ON | Determines if the monitor is turned on during alarm clock and maintenance windows.
|
USERACTIVITYMAXIDLEMINS | 0 | The duration (in minutes) for the window that governs the recent user activity test. If the user has been active during the specified period prior to a NightWatchman scheduled shutdown the shutdown will be postponed.
The postponement time is governed by the |
WEDNESDAYCLOSEACTION | 0 | The action to run when closing the maintenance window.
For example, t o set the close action for a Wednesday maintenance window to power-off: WEDNESDAYCLOSEACTION=3 |
WEDNESDAYOPENTIME | Start of a Wednesday maintenance window in the format WEDNESDAYOPENTIME=02:00 | |
WEDNESDAYPERIODMINS | The duration (in minutes) for the maintenance window on a Wednesday. For example, to set Wednesday's maintenance window to be 1 hour: WEDNESDAYPERIODMINS=60 |