WakeUp Server installer properties

The following table shows the WakeUp Server installation switches which enable configuration of certain WakeUp console parameters at install time.

PropertyDefault valueNotes
ADDLOCAL
 Allows you to install the WakeUp console extensions silently. Assumes the Configuration Manager console is already installed.
  • GUI – installs the WakeUp server GUI
  • CMAdminGUI – installs the Configuration Manager console extensions
AFREPORTING
OFFThe reporting state.
  • OFF – turns WakeUp reporting off.
  • ON – turns the WakeUp reporting on. Only available if the REPORTINGSERVER switch is set.
AGENTTCP_PORT
1776

Listening port used by the WakeUp server to communicate with the 1E Agents.

The value for this property must be the same for the WakeUp server and all Agents.

BURSTDELAY

5Delay (in seconds) between each batch of wake-up requests transmitted to a 1E Agent system.
CHECKPOLICYREFRESHINNAME
0Determines whether policy refreshes are sent depending on specific text included in the Configuration Manager deployment name and/or comment.
  • 0 – sent unless NoPolicyRefresh text is used
  • 1 – sent only when PolicyRefreshEnabled text is used
CHECKWAKEUPINNAME
0
Determines whether wakeups are sent depending on specific text included in the Configuration Manager deployment name and/or comment.
  • 0 – sent unless NoWakeUps text is used
  • 1 – sent only when WakeUpsEnabled text is used
If this option is enabled (1) then any Software Updates Assignment in Configuration Manager that you want to associate with WakeUp must have WakeUpsEnabled text in the name or comment.
CERTIFICATENAME
 Sets the name for the TLS certificate template used for secure communications when running Intel AMT service in enterprise mode.
DEBUG
13The debug level for the WakeUp server.
ENCRYPTIONLEVEL
0
Encryption level used in communications between WakeUp Servers and Agents.
  • 0 – no encryption
  • 1 – partial (mixed) encryption
  • 2 – full encryption
When configuring this option you will need to ensure that the same setting is made for all WakeUp Server and 1E Agent components. Partial (mixed) encryption is allowed only on WakeUp Servers in scenarios where there is mixture of Agents configured as 0 and 2, for example during an upgrade or migration. When all Agents are configured the same, then you should modify the WakeUp Server setting.

If USEFIPS is enabled, it overrides ENCRYPTIONLEVEL and both WakeUp and NightWatchman components uses FIPS, requiring all NightWatchman and WakeUp server components and Agents to use FIPS.
FEEDBACKENABLED
1

Enables or disables 1E Agent reporting on advertisement status.

If FEEDBACKENABLED is disabled, WakeUp reports will be unavailable.
  • 0 – reporting disabled.
  • 1 – reporting enabled.

HTTP

HTTP

HTTP is not supported. WakeUp server supports only HTTP for reporting to the NightWatchman Management Center. If REPORTING is ON and clients are using HTTPS to report to the NightWatchman Management Center, you must configure the NightWatchman Management Center Web service to use both HTTP and HTTPS.

INSTALLDIR

C:\Program Files\1E\WakeUpSvr\

Optional parameter that determines the installation directory.

  • 32Bit Machines: C:\Program Files\1E\WakeUpSvr\
  • 64Bit Machines: C:\Program Files(x86)\1E\WakeUpSvr\
LOGFILENAME
WakeUpSvr.logSpecifies the name of the log file.
LOGPATH
%ALLUSERSPROFILE%\1E\
WakeUpSvr\

Path to the log file.

LOGVIEWPATH
 Specifies the path to a log viewer. This is used to define the path to an alternative log viewer to such as TRACE32.
MAGICPACKET_PORT
1776Sets the UDP port used to send wakeup broadcasts.
MAGICPACKETDELAY
10The time delay in milliseconds between sending Magic Packets.
MAXBURST
100The maximum numbers of wakeup requests that is forwarded to a 1E Agent system in a single hit.
MAXCONNECTIONS
16

The maximum number of connections that the WakeUp Server attempts to open at any given time. MAXCONNECTIONS is relevant only if TCP/IP agent communication is used.

There is an inbuilt maximum limit of 64.

MAXLOGFILESIZE
1048576 bytes (1 MB)Maximum size (in bytes) for the log file. Once the file reaches the specified size, a copy will be made with a .lo_ extension in the same directory as the original file. A new log file is then created.
MAXPINGSPERBURST
256

Number of ping packets to generate in a single burst.

MAXPINGSPERBURST requires that the server is installed in multi-agent mode.
MAXWAKEUPSPERPOLL
1000

Maximum number of magic packets to be sent per poll interval. This is based on the maximum number of systems likely to require waking in one hour of advertisement processing. This figure also depends on the poll interval and is set in order to make it possible to process all outstanding wakeup requests within one hour.

No. of systemsPoll interval (secs)Max wakeups per poll
100030 (120 per hour)8 (1000/120)
500020 (180 per hour)28 (5000/180)
1000060 (60 per hour)166 (10000/60
MINREADVERTTIME
60

Minimum time (in seconds) before the same advertisement is reprocessed.

This timer is only relevant if short poll intervals are required.
MINREWAKEUPTIME
20

Minimum time (in seconds) between wakeups of the same machine. For example, a system may be a member of two or more collections and may have more than one advertisement due. MINREWAKEUPTIME prevents a system from receiving multiple magic packets when it has already been awakened.

MINREWAKEUPTIME is not applicable to manual wakeups.
NOAUTOTHROTTLE
0Auto throttle automatically increases the number of wakeups per polling cycle if the wakeup list grows to the point where all systems cannot be processed within one hour.
  • 0 – enables auto throttle.
  • 1 – disables auto throttle.
NOTZSUPPORT
1Determines whether all wakeups occur relative to the client or Configuration Manager Server time.
  • 0 – wakeups occur relative to the time on the local client system.
  • 1 – wakeups occur relative to the time on the Configuration Manager server.
PIDKEY
30-day evaluation license keyThe WakeUp Server license key obtained obtained from Sales. The default behavior if PIDKEY is not defined is a 30-day evaluation license, after which the WakeUp Server service will not start.
PINGBURSTDELAY
2

Delay (in seconds) between successive ping bursts.

The server must be installed in multi-agent mode.
PINGTIMEOUT
1

Ttime (in seconds) to wait for a response from the 1E Agents.

The server must be installed in multi-agent mode.
POLLINTERVALSECS
600Time (in seconds) between reporting spooler directory scans. WakeUp looks for new reporting messages added since the last spooler directory scan, if the Agility Framework server was unavailable at the last scan.
POLLTIME
120Time (in seconds) between database scans. This parameter is also used to define the period between wakeups. WakeUp will look for new advertisements added since the last database scan and will action them according to the other WakeUp Server settings.
PWMI
0
Determines the state of the installer Apply WMI Namespace checkbox.
  • 1 – checkbox is selected
Do not use the PWMI property unless WMIACCOUNT is also specified. This is because the checkbox will always be enabled if this property is used.

REPEATCOUNT

0

Number of times to repeat sending Magic Packets.

If you suspect that your network is prone to dropping datagram packets you should try different configurations for the REPEATCOUNT and REPEATDELAY settings. Otherwise, these should be left at their default values.
REPEATDELAY
0

Delay (in seconds) before resending a repeated magic packet.

If you suspect that your network is prone to dropping datagram packets you should try different configurations for the REPEATCOUNT and REPEATDELAY settings. Otherwise, these should be left at their default values.
REPORTING
ON
The reporting state. May be set to:
  • ON – reporting is enabled and is forwarded to the server defined in REPORTINGSERVER.
  • OFF – no information is sent to reporting server.
REPORTING=ON and REPORTINGSERVER  are mandatory when using NightWatchman Management Center so that the WakeUp Server is registered.
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.

REPORTING=ON and REPORTINGSERVER are mandatory when using NightWatchman Management Center so that the WakeUp Server is registered.

If HTTP is not using standard port 80 then specify the port number after the server name:
  REPORTINGSERVER="ACMESERVER.ACME.COM:8080"

SCENARIO
C

The WakeUp installation scenario.

Option C is strongly recommended
  • A – installs WakeUp in stand-alone server mode.
  • B – installs WakeUp in dedicated agent mode.
  • C – installs WakeUp in multi-agent mode.
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.

If HTTPS is not using standard port 443 then specify the port number after the server name:
  SECUREREPORTINGSERVER="ACMESERVER.ACME.COM:7433"

This property is used only by the WakeUp Agent component of WakeUp Server. 
SERVERCOMPONENTS
 

Selects whether to install the WakeUp Server service component.

This option should not be used unless directed by 1E Support.
  • 0 – do not install the WakeUp Server service component.
  • 1 – installs the WakeUp Server service component.
SERVERTYPE
SMS is selected if the installer detects it is running on a Configuration Manager Site server and able to connect to an SMS Provider.The WakeUp service type to install.
  • NMC – installs the NightWatchman Management Center oriented WakeUp Server service.  Also known as AFR strategy.
  • SMS – installs the Configuration Manager oriented WakeUp Server service.  Also known as Configuration Manager or SMS strategy
SPOOLDIR
%ALLUSERSPROFILE%\1E\
Reporting\WakeUp\
The location of the WakeUp spooler directory, where NightWatchman Management Center Reporting messages are stored before being sent to the NightWatchman Management Center Web Service. SPOOLDIR should not need to be modified under normal circumstances.
SUBCOLLSENABLED
0Determines if sub collections are included when processing advertisements.
  • 0 – do not process sub-collections.
  • 1 – process sub-collections.
SUBNETRESCAN
30

Time (in minutes) to wait before the WakeUp Server rescans the subnet to detect 1E Agents.

The server must is installed in multi-agent mode.
SVCPASSWORD
 Sets the password for the WakeUp Intel AMT service account.
SVCUSER
 The service account for the WakeUp Intel AMT service depending on the value for the AMTMODE switch
  • Enterprise – account should be a member of the Intel AMT Collections Managers group.
  • SMB – account is used for digest authentication. Must have access to the Intel AMT Power Control realm on the target computers.
TCP_PORT
1777

The listening port used by the 1E Agents to communicate with the WakeUp Server.

This must be different to the AGENTTCP_PORT value and must be the same for the WakeUp Server and all Agents.
USEFIPS
0
Controls the use of FIPS for encrypting communications for both WakeUp and NightWatchman components.
  • 0 – do not use FIPS encrypted communications.
  • 1 – use FIPS encrypted communications.

When configuring this option you will need to ensure that the same setting is made for all NightWatchman Management Center, WakeUp Server and 1E Agent components. If USEFIPS is enabled it will override ENCRYPTIONLEVEL .
WAKEUPSVCPASSWORD
 Sets the password for the WakeUp service, used when installing a distributed Configuration Manager configuration where the Configuration Manager Provider is remote from the Configuration Manager server.
WAKEUPSVCUSER
 Sets the user name for the WakeUp service, used when installing a distributed Configuration Manager configuration where the Configuration Manager Provider is remote from the Configuration Manager server.
WEBWAKEUPSTATUSBYPING
1

The method used by Web WakeUp when determining whether a computer has been awoken.

Requires a 6.0.500 or later 1E Agent to be installed on the target computer
  • 0 – 1E WakeUp Server requests the 1E Agent that woke the computer to determine the computer status.
  • 1 – 1E WakeUp Server sends an ICMP ping to determine a computer's status (as used in earlier versions of Web WakeUp)

WMIACCOUNT

 
The AD account or group that is granted administrator rights to the WakeUp Server WMI namespace. This namespace is used by the WakeUp Server Console, the NightWatchman Management Center Console Service and any custom scripts that use the WakeUp Server API.

If required, it should be set in the following format:
Domain\User
The WakeUp Server installer grants the WMIACCOUNT (account or group) full rights to the root\N1E namespace on the WakeUp Server, and in order to allow remote connections, adds the same to the Distributed COM Users local group.  For more detail see accounts need to install the WakeUp server.


When installing WakeUp Server in silent or non-interactive mode, then it is necessary to specify the PWMI property to 1 in addition to the WMIACCOUNT property.