Server Service Entries

With Registry Editor, you can modify the startup parameters for the Server service. Unless otherwise noted, these parameters are found in this path:


HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
\LanmanServer\Parameters

The parameters that control network bindings for this service are described in "NetRules Subkey Entries," earlier in this chapter.

AlertSched REG_DWORD 1 to 65535 minutes

Specifies in Microsoft LAN Manager and in Windows NT how often the server checks alert conditions and sends needed alert messages.

Default: 5

BlockingThreads REG_DWORD 1 to 9999 for NTAS

Specifies the number of threads set aside by the server to service requests that can block the thread for a significant amount of time. Larger values can increase performance but use more memory. A value that is too large can impede performance by causing excessive task switching.

Default: (depends on configuration; max. 4 for Windows NT Workstation)

ConnectionlessAutoDisc REG_DWORD 15 minutes to infinity

Disconnect time for clients using direct hosted IPX. If the client does not send a request to the server during this interval, the client is disconnected regardless of whether it has open files or pipes.

Default: 15

CriticalThreads REG_DWORD 1 to 9999

Special-purpose threads used for time-critical tasks.

Default: 1

DiskSpaceThreshold REG_DWORD 0 to 99 percent

Specifies the percentage of free disk space remaining before an alert is sent.

Default: 10 percent

EnableFCBopens REG_DWORD 0 or 1

Specifies whether MS-DOS File Control Blocks (FCBs) are folded together, so multiple remote opens are performed as a single open on the server. This saves resources on the server.

Default: 1 (true)

EnableOplockForceClose REG_DWORD 0 or 1

If a client has an opportunistic lock (oplock) and does not respond to an oplock break, there are two possible behaviors that this parameter selects:

Value

Meaning

0 (false)

Fail the second open, thereby limiting access to the file. (This is typical behavior for a client running LAN Manager version 2.0.)

1 (true)

Force closed the open instance of the client that has the oplock, risking the loss of cached data. (This is typical behavior for a client running LAN Manager version 2.1.)


Default: 0 (false)

EnableOplocks REG_DWORD 0 or 1

Specifies whether the server allows clients to use oplocks on files. Oplocks are a significant performance enhancement, but have the potential to cause lost cached data on some networks, particularly wide-area networks.

Default: 1 (true)

EnableRaw REG_DWORD 0 or 1

Specifies whether the server processes raw Server Message Blocks (SMBs). If enabled, this allows more data to be transferred per transaction and improves performance. However, it is possible that processing raw SMBs can impede performance on certain networks. This parameter is automatically tuned by the server.

Default: 1 (true)

EnableSharedNetDrives REG_DWORD 0 or 1

If NWCS is installed, set this value to 1 to reshare the drives connected via NWCS (i.e. Novell drives) as NT shares. It does not allow resharing of NT shares.

Default: 1

EnableSoftCompat REG_DWORD 0 or 1

Specifies whether the server maps a request to a normal open request with shared-read access when the server receives a compatibility open request with read access. Mapping such requests allows several MS-DOS-based computers to open a single file for read access. However, this feature can potentially cause functionality problems with some MS-DOS-based applications.

Default: 1 (true)

EnableWFW311DirectIpx REG_DWORD True or false

Specifies whether the server should allow old direct-hosted IPX clients to connect. Some old WFW clients provide inadequate named pipe support when running over direct-hosted IPX, causing named pipe applications to hang. If the user does not need named pipe support, this flag can be set to true to allow normal file I/O.

Default: false

ErrorThreshold REG_DWORD 1 to 65535

Sets the number of errors that can occur within an AlertSched interval before the server sends an alert message.

Default: 10

Hidden REG_DWORD 0 or 1

If this parameter is disabled, the server's name and comment can be viewed by others on the domain. If enabled, the server's name and comment will not be announced.

Default: 0 (false)

InitConnTable REG_DWORD 1 to 128

Specifies the initial number of tree connections to be allocated in the connection table. The server automatically increases the table as necessary, so setting the parameter to a higher value is an optimization.

Default: 8

InitFileTable REG_DWORD 1 to 256

Specifies the initial number of file entries to be allocated in the file table of each server connection.

Default: 16

InitSearchTable REG_DWORD 1 to 2048

Specifies the initial number of entries in the connection's search table.

Default: 8

InitSessTable REG_DWORD 1 to 64

Specifies the initial number of session entries to be allocated in the session table of each server connection.

Default: 4

InitWorkItems REG_DWORD 1 to 512

Specifies the initial number of receive buffers, or work items, used by the server. Allocating work items costs a certain amount of memory initially, but not as much as having to allocate additional buffers later.

Default: (depends on configuration)

IRPstackSize REG_DWORD 1 to 12

Specifies the number of stack locations in I/O Request Packets (IRPs) used by the server. It may be necessary to increase this number for certain transports, MAC drivers, or local file system drivers. Each increment costs 36 bytes of memory per work item (that is, #work items * 36 bytes = total memory cost).

Default: 5

LinkInfoValidTime REG_DWORD 0 to 100,000 seconds

Specifies the amount of time during which the transport link information is still valid. If more than this amount of time has passed since the last query, the server requires transport link information.

Default: 60

MaxFreeConnections REG_DWORD 2 to 8 items

Specifies the maximum number of free connection blocks maintained per endpoint.

Default: Depends upon configuration

MaxGlobalOpenSearch REG_DWORD 1 to infinity

The maximum number of core searches that can be active in the server at one time. This is to ensure that resources used by active core searches cannot exceed a certain limit. A high value allows more searches to be active, but can use up more server resources. A low value would save server resources, but can affect clients that needs a lot of searches to be active.

Default: 4096

MaxLinkDelay REG_DWORD 0 to 100,000 seconds

Specifies the maximum time allowed for a link delay. If delays exceed this number, the server disables raw I/O for this connection.

Default: 60

MaxKeepSearch REG_DWORD 10 to 10000 seconds

Specifies the maximum time during which an incomplete MS-DOS search will be kept by the server. Larger values ensure better interoperability with MS-DOS utilities such as tree-copy and delete-node. However, larger values can cause unusual local behavior (such as a failure of a local directory-delete operation) and higher memory use on the server.

Default: 1800

MaxMpxCt REG_DWORD 1 to 100 requests

Provides a suggested maximum to clients for the number of simultaneous requests outstanding to this server. A higher value can increase server performance but requires higher use of server work items.

Default: 50

MaxNonpagedMemoryUsage REG_DWORD 1 MB to infinite bytes

Specifies the maximum size of nonpaged memory that the server can have allocated at any time. Adjust this parameter if you want to administer memory quota control.

Default: (depends on system and server configuration)

MaxPagedMemoryUsage REG_DWORD 1 MB to infinite bytes

Specifies the maximum size of pageable memory that the server can have allocated at any time. Adjust this parameter if you want to administer memory quota control.

Default: (depends on system and server configuration)

MaxRawWorkItems REG_DWORD 1 to 512 items

Sets the maximum raw work items the server can allocate. If this limit is reached, then the server will reject raw I/O operations from the client.

Default: (depends on configuration)

MaxWorkItems REG_DWORD 1 to 512 items

Specifies the maximum number of receive buffers, or work items, the server can allocate. If this limit is reached, the transport must initiate flow control at a significant performance cost.

Default: (depends on configuration; max. 64 for Windows NT Workstation)

MaxWorkItemIdleTime REG_DWORD 10 to 1800 seconds

Specifies the amount of time that a work item can stay on the idle queue before it is freed.

Default: 30

MinFreeConnections REG_DWORD 2 to 5 items

Specifies the minimum number of free connection blocks maintained per endpoint.

Default: (depends upon configuration)

MinFreeWorkItems REG_DWORD 0 to 10 items

Specifies the minimum number of available receive work items that are needed for the server to begin processing a potentially blocking SMB. A larger value for this parameter ensures that work items are available more frequently for nonblocking requests, but it also increases the likelihood that blocking requests will be rejected.

Default: 2

MinLinkThroughput REG_DWORD 0 to infinite bytes per second

Specifies the minimum link throughput allowed by the server before it disables raw and opportunistic locks for this connection.

Default: 0

MinRcvQueue REG_DWORD 0 to 10 items

Specifies the minimum number of free receive work items needed by the server before it begins allocating more. A larger value for this parameter helps ensure that there will always be work items available, but a value that is too large is simply inefficient.

Default: 2

NetworkErrorThreshold REG_DWORD 1 to 100 percent

Triggers an alert whenever the percentage of failing network operations relative to total network operations exceeds this value during the AlertSched interval.

Default: 5 percent

NonBlockingThreads REG_DWORD 1 to 9999

Specifies the number of threads set aside by the server to service requests that cannot block the thread for a significant amount of time. Larger values can increase performance but use more memory. A value that is too large can impede performance by causing excessive task switching.

Default: (depends on configuration; max. 8 for Windows NT Workstation)

NullSessionPipes REG_DWORD List of pipes

List of pipes that the client is allowed to access using the null session. If a pipe is not on this list, the request to access it will be denied. Used with RestrictNullSessionAccess and NullSessionShares.

Default: (none)

NullSessionShares REG_DWORD List of shares

List of file shares the client is allowed to access using the null session. If a share is not on this list, the request to access it will be denied. Used with RestrictNullSessionAccess and NullSessionPipes.

Default: (none)

OpenSearch REG_DWORD 1 to 2048 searches

Specifies the maximum number of outstanding searches on the server, per connection. A single client can have up to the OpenSearch number of active searches. This includes all types of searches, including MS-DOS, OS/2, and Windows NT.

Default: 2048

OplockBreakWait REG_DWORD 10 to 180 seconds

Specifies the time that the server waits for a client to respond to an oplock break request. Smaller values can allow detection of crashed clients more quickly but can potentially cause loss of cached data.

Default: 35

RawWorkItems REG_DWORD 1 to 512 items

Specifies the number of special work items for raw I/O that the server uses. A larger value for this parameter can increase performance but costs more memory.

Default: (depends on configuration)

RemoveDuplicateSearches REG_DWORD True or false

Specifies whether the server should close duplicate searches from the same client. This lessens the likelihood of the server hitting the MaxGlobalOpenSearch limit by closing identical searches. This must be set to False if a client needs multiple identical searches to be active.

Default: true

RestrictNullSessionAccess REG_DWORD True or false

Specifies whether the server should limit access to requests coming in through the null session. If true, NullSessionPipes and NullSessionShares are used. Used with NullSessionPipes and NullSessionShares.

Default: true

ScavTimeout REG_DWORD 1 to 300 seconds

Specifies the time that the scavenger remains idle before waking up to service requests. A smaller value for this parameter improves the response of the server to various events but costs CPU cycles.

Default: 30

ScavQosInfoUpdateTime REG_DWORD 0 to 100,000 seconds

Specifies the time that can pass before the scavenger goes through the list of active connections to update the link information.

Default: 300

SessConns REG_DWORD 1 to 2048 connections

Specifies the maximum number of tree connections that can be made on the server via a single virtual circuit.

Default: 2048

SessOpens REG_DWORD 1 to 2048 files

Specifies the maximum number of files that can be open on a single virtual circuit.

Default: 2048

SessUsers REG_DWORD 1 to 2048 users

Specifies the maximum number of users that can be logged on to a server via a single virtual circuit.

Default: 2048

SharingViolationRetries REG_DWORD 0 to 1000

The number of times the server retries an operation when it gets sharing violation back from the file system. Operations affected include opens, renames, and deletes. This minimizes network traffic in cases where the client keeps retrying these operations whenever it gets a sharing violation.

Default: 5

SharingViolationDelay REG_DWORD 0 to 1000 milliseconds

The number of milliseconds that the server delays for each retry. If this value is too low, then a sharing violation error is more likely at the server's next retry. If set too high, then the response to the client might get delayed much more than what is necessary and will negatively affect performance.

Default: 200

SizReqBuf REG_DWORD 512 to 65536 bytes

Specifies the size of request buffers that the server uses. Small buffers use less memory; large buffers may improve performance.

Default: 4356

ThreadPriority REG_DWORD 0, 1, 2, or 15

Specifies the priority of all server threads in relation to the base priority of the process. Higher priority can give better server performance at the cost of local responsiveness. Lower priority balances server needs with the needs of other processes on the system. Values 0 to 2 are relative to normal or background processes. The default value of 1 is equivalent to the foreground process. A value of 15 runs the server threads at real-time priority—which is not recommended.

Default: 1

Users REG_DWORD 1 to infinite

Specifies the maximum number of users that can be simultaneously logged on to the server.

Default: 0xffffffff (infinite); max. 10 for Windows NT Workstation

XactMemSize REG_DWORD 64K to 16 MB

Specifies the maximum amount of virtual memory used by the Xactsrv service. A larger value for this parameter helps ensure that memory is available for downlevel clients but costs virtual address space and potentially costs pageable memory.

Default: 1 MB