Skip to main content

NightWatchman Enterprise 7.3

WakeUp Server installer properties

WakeUp Server installer properties

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

Property

Default value

Notes

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

OFF

The 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.

Note

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

BURSTDELAY

5

Delay (in seconds) between each batch of wake-up requests transmitted to a 1E Agent system.

CHECKPOLICYREFRESHINNAME

0

Determines 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

Note

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

13

The 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

Note

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.

Note

If FEEDBACKENABLED is disabled, WakeUp reports will be unavailable.

  • 0 – reporting disabled.

  • 1 – reporting enabled.

HTTP

HTTP

Note

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.

Note

  • 32Bit Machines: C:\Program Files\1E\WakeUpSvr\

  • 64Bit Machines: C:\Program Files(x86)\1E\WakeUpSvr\

LOGFILENAME

WakeUpSvr.log

Specifies 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

1776

Sets the UDP port used to send wakeup broadcasts.

MAGICPACKETDELAY

10

The time delay in milliseconds between sending Magic Packets.

MAXBURST

100

The 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.

Note

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.

Note

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.

Note

No. of systems

Poll interval (secs)

Max wakeups per poll

1000

30 (120 per hour)

8 (1000/120)

5000

20 (180 per hour)

28 (5000/180)

10000

60 (60 per hour)

166 (10000/60

MINREADVERTTIME

60

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

Note

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.

Note

MINREWAKEUPTIME is not applicable to manual wakeups.

NOAUTOTHROTTLE

0

Auto 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

1

Determines 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 key

The 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.

Note

The server must be installed in multi-agent mode.

PINGTIMEOUT

1

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

Note

The server must be installed in multi-agent mode.

POLLINTERVALSECS

600

Time (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

120

Time (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

Note

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.

Note

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.

Note

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.

Note

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.

Note

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.

Note

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"

Note

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

SERVERCOMPONENTS

Selects whether to install the WakeUp Server service component.

Note

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

0

Determines 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.

Note

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.

Note

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.

Note

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.

Note

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

Note

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.

In this section: