Appendix A SunLink Server Registry

In the SunLink Server program, most configuration information is centrally stored in a single database called the Registry. Ordinarily, you use SunLink Server Manager to change Registry values by way of the graphical user interface. However, you may also use the Windows Registry Editor to change values by editing the Registry database manually.

This appendix provides the following information:

• Overview of the SunLink Server Registry structure

• Description of Registry Editor

• Descriptions of the SunLink Server Registry keys and values

SunLink Server Registry Structure

The SunLink Server Registry is a database organized in an hierarchical structure. It is composed of subtrees and their keys, and value entries. A key also can contain additional subkeys.

The following table identifies and defines the SunLink Server Registry subtrees.

Table A-1 SunLink Server Registry Subtrees

Root Key Name	Description
HKEY_LOCAL_MACHINE	Contains information about the local computer system, including hardware and operating system data such as bus type, system memory, device drivers, and startup control data.
HKEY_USERS	Contains all actively loaded user profiles and the default profile. Users who are accessing a server remotely do not have profiles under this key on the server; their profiles are loaded into the Registry on their own computers.

The SunLink Server Registry is stored in the /var/opt/lanman/datafiles directory on the SunLink Server computer.

Each Registry key can contain data items called value entries. Keys are analogous to folders, and value entries are analogous to files within the folders.

A value entry has three parts, which always appear in the following order: the name of the value, the data type of the value, and the value itself, which can be data of any length.

Data types, such as REG_SZ or REG_EXPAND_SZ, describe the format of the data, which can be up to 1 Mbyte. Data types from 0 to 0x7fffffff are reserved for definition by the system, and applications should not use these types. Data types from 0x80000000 to 0xffffffff are reserved for use by applications.

The following table lists and defines the data types currently used by the system.

Table A-2 Registry Data Types

Data Type	Description
REG_BINARY	Binary data. For example:  Component Information : REG_BINARY : 00 00 00...
REG_DWORD	Data represented by a number that is 4 bytes long. Many keys for device drivers and services are this type and can be displayed in Registry Editor in binary, hexadecimal, or decimal format. For example, entries for service error controls are this type:  ErrorControl : REG_DWORD : 0x1
REG_EXPAND_SZ	An expandable data string, which is text that contains a variable to be replaced when called by an appli­cation. For example, for the following value, the string %SystemRoot% will be replaced by the actual location of the directory containing the SunLink Server system files: File : REG_EXPAND_SZ : %SystemRoot%\file.exe
REG_MULTI_SZ	A multiple string. Values that contain lists or multiple values in human readable text are usually this type. Entries are separated by NULL characters.   AlertNames : REG_MULTI_SZ : Administrator tom
REG_SZ	A sequence of characters representing human readable text. For example, a component's description is usually this type:  DisplayName : REG_SZ : Alerter

Using Registry Editor

You can use the Registry Editor to view Registry entries for the various components in SunLink Server. You can also use Registry Editor to modify or add Registry entries.

The Registry Editor application, Regedt32.exe, does not appear in any default folders. It is installed automatically in the %SystemRoot%\system32 folder on Windows NT systems. Click Run on the Start menu or switch to a command prompt and type regedt32.

Connecting to a Remote Registry

To edit the SunLink Server Registry using the Windows NT Registry Editor, you must connect to the SunLink Server system from the Registry Editor of a remote Windows NT computer. To do so, use the Select Computer command in the Registry menu of the Registry Editor.

Connecting to the SunLink Server Registry remotely will result in the display of the HKEY_USERS and HKEY_LOCAL_MACHINE subtrees.

For more information about connecting to a remote Registry, see your Registry Editor Help.

---

Caution -

Using the Windows 95 Registry Editor to edit the SunLink Server Registry remotely is not recommended.

---

Viewing the Registry

Registry Editor displays the subtrees of the Registry. The hierarchical structure that appears in Registry Editor is similar to the hierarchical directory structures of Windows NT Explorer.

Your ability to make changes to the Registry using Registry Editor depends on your access permissions. Generally, you can make the same kinds of changes using Registry Editor as your permissions allow for other administrative tools.

Registry Editor Commands

You can use the mouse or commands to manipulate the windows and panes in the Registry Editor in the same way as in the Windows NT Explorer. For example:

• Double-click a key name to expand or collapse an entry. Or click commands from the View and Tree menus to control the display of a selected key and its data.

• Use the mouse or arrow keys to move the vertical split bar in each window to control the size of the left and right panes.

• Click Tile or Cascade from the Window menu to arrange the Registry Editor windows.

• Click Auto Refresh from the Options menu to update the display continuously. You can also click one of the Refresh commands from the View menu to update the display of Registry information when Auto Refresh is turned off.

The following table shows some keyboard methods for managing the display of data in each Registry Editor window.

Table A-3 Keyboard Commands for Managing Registry Editor Data Display

Procedure	Keyboard Action
Expand one level of a selected Registry key.	Press Enter.
Expand all of the levels of the predefined handle in the active Registry window.	Press CTRL + *
Expand a branch of a selected Registry key.	Press the numeric keypad asterisk (*) key.
Collapse a branch of a selected Registry key.	Press Enter or - on the numeric keypad.

The following table lists the policies and their associated SunLink Server Registry keys, including locations, that can be modified using the Windows NT Registry Editor or, in some cases, SunLink Server Manager.

Table A-4 Registry Policies, Keys, and Locations

Policy	SunLink Server Registry Key
Alerter Service	(SYSTEM\Current\ControlSet\Services\Alerter\Parameters) IncludeMessageHeader CountNotOnNetworkCache NotOnNetworkCacheTimeout
Computer Browser Service	(SYSTEM\CurrentControlSet\Services\Browser\Parameters) MasterUpdate BackupUpdate BackupRecovery MoreLog
Connected Clients	(SYSTEM\CurrentControlSet\Services\Netlogon\Parameters) AutoDisconnect LogonQuery QueryDelay RelogonDelay
File Name Space Mapping	(SYSTEM\CurrentControlSet\Services\AdvancedServer\FileServiceParameters) NameSpaceMapping UniqueSuffixLength MixedCaseSupport TruncatedExtensions MappingSeparator
Netlogon Service	(SYSTEM\CurrentControlSet\Services\Netlogon\Parameters) Scripts Pulse (PDC only) Update (BDC only) Randomize (BDC only) SSIPasswdAge (BDC only)
Server Announcement	(SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters) Hidden SrvAnnounce LmAnnounce
Solaris Account Mapping	(SYSTEM\CurrentControlSet\Services\AdvancedServer\UserServiceParameters) CreateUnixUser ForceUniqueUnixUserAccount NewUserShell SyncUnixHomeDirectory
Solaris File System Integration	(SYSTEM\CurrentControlSet\Services\AdvancedServer\FileServiceParameters) IgnoreUnixPermissions UnixDirectoryCheck UnixFilePerms UnixDirectoryPerms UseUnixLocks
UPS Service	(SYSTEM\CurrentControlSet\Services\UPS\Parameters) IgnoreSIGPWR PowerFailAddress PowerFailMessage PowerMessageInterval
Users Alerts	(SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters) AccessAlert ErrorAlert LogonAlert

Registry Keys and Values

This section describes the SunLink Server Registry keys that are changed during administration. You may want to modify these values directly using the SunLink Server Manager or a Registry Editor. You do not need to be concerned with every key in the SunLink Server Registry; only those keys that you may have reason to change are described. Note that you must stop and then restart the SunLink Server program for most changes to the Registry to take effect.

The SunLink Server Registry keys described in this section are defined in subkeys located in the following path:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services

• \AdvancedServer

• \Alerter

• \Browser

• \EventLog

• \LanmanServer

• \LanmanWorkstation

• \Netlogon

• \Netrun

• \Replicator

• \UPS

• \WINS

SunLink Server Key Descriptions

The SunLink Server subkey of the SunLink Server Registry contains the following subkeys in the following path:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer

• \AlertParameters

• \FileServiceParameters

• \NetAdminParameters

• \Parameters

• \ProcessParameters

• \RpcParameters

• \ShareParameters

• \UserServiceParameters

The following sections describe the entries contained within those subkeys.

Alert Parameters Entries

The Registry path that contains entries for the SunLink Server Alerter service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\AlertParameters

• AlertAdminOnLicenseOverflow REG_DWORD 0 or 1

  Specifies whether the server sends an administrative alert message when the maximum allowable number of clients is exceeded.

  Default: 0 (message will not be sent)

• AlertUserOnLicenseOverflow REG_DWORD 0 or 1

  Specifies whether the server sends a message to a client that tried to link but failed when the maximum allowable number of clients was exceeded.

  Default: 0 (message will not be sent)

File Service Parameters Entries

The Registry path that contains entries for the SunLink Server file service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\FileServiceParameters

• AclCacheSize REG_DWORD 0 - 100

  Specifies the number of entries in ACL cache that keeps track of the results or recent access checks performed on SunLink Server resources.

  Default: 6

• EAFilePrefix REG_SZ Character string

  Prefix used to name files containing extended attribute data. For example, by default, the extended attributes for file foo are stored in .ea@foo.

  Default: .ea@

• EnableSoftCompat REG_DWORD 0, 1, or 2

  Specifies how SunLink Server handles file opens in read-only compatibility mode. Use 0 to keep the compatibility mode; 1 to translate to read-only/DenyWrite mode for files with special extensions (for example, .EXE, .COM, and .BAT) specified by the value of the EnableSoftFileExtensions key; and 2 to translate to read-only/DenyWrite mode for all file opens.

  Default: 1 (translate files with special extensions to read-only/DenyWrite)

• EnableSoftFileExtensions REG_MULTI_SZ List

  Specifies the file extensions for which the compatibility mode will be translated to read-only/DenyWrite if the value of the EnableSoftCompat key is set to 1.

  Default: bat com exe dll cmd

• ForceDirectoryAcl REG_DWORD 0 or 1

  Determines whether the SunLink Server program will create an Access Control List for a newly created directory if an explicit Access Control List was not provided by the client computer. If an Access Control List is not created, one will be inherited automatically from its parent directory whenever it is needed.

  Default: 1 (create new Access Control List)

• ForceFileAcl REG_DWORD 0 or 1

  Determines whether the SunLink Server will create an Access Control List for a newly created file if an explicit Access Control List was not provided by the client computer. If an Access Control List is not created, one will be inherited automatically from its parent directory whenever it is needed.

  Default: 0 (will not create new Access Control List)

• ForceFileFlush REG_DWORD 0 or 1

  Specifies whether to force a Solaris fsync(2) system call when an SMB flush request is received. Not forcing fsync(2) system calls can improve file server performance; files will be flushed automatically to disk by the Solaris fsflush daemon periodically, regardless of the setting of this key.

  Default: 0 (will not force fsync system call)

• IgnoreUnixPermissions REG_DWORD 0 or 1

  Gives users the option to bypass Solaris system permissions when working with files and directories. For example, enabling this option would allow SunLink Server users to write to or delete files for which they have sufficient SunLink Server permissions even though only Solaris system Read permissions had been granted to those files.

  Default: 0 (enforce Solaris system permissions)

  You can change the value of this key using the SunLink Server Manager.

• MappingSeparator REG_SZ Character string up to 7 characters

  Specifies the string that will be appended to the file name before its unique suffix to indicate that the name is mapped. This value matters only in Solaris system to Windows NT file name mapping. The default is a tilde (~), the same as in Solaris system to 8.3 mapping, but it is possible to set it to enable the client to easily identify files containing characters illegal in Windows NT. By default, a file named my? will be mapped to my_~xyz. When the value of this key is set to ~slm~, the name will be mapped to my_~slm~xyz. If an invalid parameter is placed in the Registry, the MappingSeparator will be replaced by the default value.

  Default: ~

  You can change the value of this key using the SunLink Server Manager.

• MaxEASize REG_DWORD 1 - infinity

  Specifies the buffer size in bytes that is allocated for extended attributes.

  Default: 4096

• MaxFileSizeInKB REG_DWORD 100 - infinity

  The maximum file size, in Kbytes, that the SunLink Server program will allow a user to create on the server.

  Default: 20000

• MemoryMapFiles REG_DWORD 0 or 1

  Specifies whether the server uses the Solaris system mmap system call to memory map file data into the server's address space for efficiency. File mapping is attempted only for read-only files.

  Default: 1 (memory map read-only files)

• MixedCaseSupport REG_DWORD 0 or 1

  Specifies whether mixed-case support is enabled on the server. Mixed-case support allows clients to access file names containing uppercase characters on the Solaris system. Enabling mixed-case support may negatively affect the server's performance.

  Default: 1 (enables mixed case)

  You can change the value of this key using the SunLink Server Manager.

• NameSpaceMapping REG_DWORD 0, 1, 2, or 3

  Specifies the type of file name space mapping enabled on the server.

  A value of 0 indicates that there is no name space mapping enabled.

  A value of 1 specifies that only Solaris system to 8.3 mapping is enabled. This allows 8.3-style clients, such as MS-DOS, Windows 3.1, and Windows for Workgroups, to access files with long file names and file names containing characters that are invalid in DOS ( + , ; = [ ] ? " \ < > * | : . [space] )

  A value of 2 specifies that only Solaris system to Windows NT mapping is enabled. This allows Windows NT-style clients, such as Windows 95, Windows NT, and OS/2, to access files with file names containing characters that are illegal in Windows NT (? " \ < > * | :).

  A value of 3 specifies that both Solaris system to 8.3 and Solaris system to Windows NT mappings are enabled.

  Default: 3

  You can change the value of this key using the SunLink Server Manager.

• OplockTimeout REG_DWORD 1 - infinity

  The interval of time (in seconds) that the server waits for acknowledgment from a client of an "oplock" broken notification.

  Default: 30

• ReadAheadCount REG_DWORD 0 (always read ahead) - infinity

  The number of sequential file accesses by a client that the server must detect before it begins reading ahead.

  Default: 2

• ReportNTFS REG_DWORD 0 or 1

  Specifies whether to report share Solaris system volumes as NTFS or actual Solaris file system type.

  Default: 1 (report as NTFS)

• SyncAclFileOnWrite REG_DWORD 0 or 1

  Determines whether the server will force changes to the Access Control List (ACL) file to be written to disk using an fsync(2) system call or whether the server will permit the operating system to write the changes to disk normally.

  Default: 0 (write ACL changes to disk normally)

• TruncatedExtensions REG_DWORD 0 or 1

  Specifies whether to replace the last character of the file extension of a mapped file name with a tilde (~). This key applies to file extensions that originally were longer than three characters. This feature can be used to distinguish longer file extensions from similar three-character extensions that were unchanged. For example, enabling this feature prevents a file named file1.document from being mapped to a file named file~xyz.doc, which could cause some clients to consider this file a Microsoft Word file. (This key affects only Solaris system to 8.3 file mapping.)

  Default: 1 (Do not replace last character with a tilde)

• UniqueSuffixLength REG_DWORD 0 - 7

  Specifies the length of the alphanumeric suffix appended to the file name to guarantee the mapping uniqueness. The longer the suffix, the higher the probability that the mapped name is unique. If the mapped name is not unique within a directory, name collisions may occur. They may cause the client to be denied access to the file it needs, or the client may get access to a different file than the one it requested.

  It is not advisable to set UniqueSuffixLength to a value less than 3, unless the preservation of a longer file name prefix outweighs possible name collision problems.

  Default: 3

  You can change the value of this key using the SunLink Server Manager.

• UnixCloseCount REG_DWORD 1 - 20

  The number of least recently accessed open files that the server closes transparently to avoid reaching the Solaris system's per-process limit. The server uses a technique called file descriptor multiplexing to allow clients to open far more files than the per-process limits would normally allow.

  Default: 5

• UnixDirectoryCheck REG_DWORD 0, 1, or 2

  Specifies whether the SunLink Server program will allow clients to write to Solaris system directories that do not have Write permissions. Microsoft client software treats the Read-only attribute as advisory and does not limit the behavior of directories. In contrast, the Solaris operating environment treats Read-only permissions as mandatory and prohibits users from writing in directories for which they do not have Write permission.

  A value of 0 allows writing only to directories with Write permissions; a value of 1 allows writing to directories belonging to or created by the SunLink Server program (as determined by checking group memberships of directory); and a value of 2 ignores Solaris directory permissions.

  Default: 1

  You can change the value of this key using the SunLink Server Manager.

• UnixDirectoryPerms REG_DWORD 0 - 511

  The Solaris system permissions for newly created directories.

  Default: 509 (0775 octal)

  You can change the value of this key using the SunLink Server Manager.

• UnixFilePerms REG_DWORD 0 - 4095

  The Solaris system permissions for newly created files.

  Default: 1460 (02664 octal)

  You can change the value of this key using the SunLink Server Manager.

• UnixQuotas REG_DWORD 0 or 1

  Specifies whether the SunLink Server program provides Solaris system disk quota support. This ensures that creating or writing to the file is performed under the Solaris system UID of the Solaris system user to which the SunLink Server user is mapped. Each action counts toward that user's quota; an error message is sent to the client when the quota is exceeded. Two quotas are supported: i-node and block quotas for UFS and NFS file systems. This is true to the extent of the ability of these file systems to support Solaris system quotas.

  Default: 0 (no support for disk quotas)

• UseEAs REG_DWORD 0 or 1

  Specifies support for OS/2 extended attributes.

  Default: 0 (no support for extended attributes)

• UseNfSLocks REG_DWORD 0 or 1

  Specifies whether the server tries to set Solaris system record locks in files as requested by clients. Record locks may not work on NFS files on a server running NFS. If the value of the UseUnixLocks key is 0, this feature has no effect on the server.

  Default: 0 (do not set locks)

• UseOplocks REG_DWORD 0 or 1

  Specifies whether SunLink Server grants opportunistic locks to clients who request them on opens.

  Default: 1 (use opportunistic locks)

• UseUnixLocks REG_DWORD 0 or 1

  Specifies whether record locks created by clients are reflected in the Solaris file system.

  Default: 0 (locks are not reflected in Solaris file system)

  You can change the value of this key using the SunLink Server Manager.

• WriteBehind REG_DWORD 0 or 1

  Specifies whether physical Solaris system writes are performed before or after the server responds to the client. If Solaris system writes are performed before the server responds to the client, then the server appears to be slower (because the response is delayed), but the server can report disk full errors to clients. If Solaris system writes are performed after the response is sent, disk full errors during write SMBs are not reported to the client.

  Default: 1 (enable write behind)

Net Administration Parameters Entries

The Registry path that contains entries for the SunLink Server Net Administration is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\NetAdminParameters

• NetAdminGroupName REG_SZ Character string

  The Solaris system group name assigned to the net admin \\servername /c command.

  Default: DOS---

• NetAdminPath REG_SZ Character string up to 256 characters

  The Solaris system path used to find commands submitted by the net admin \\servername /c command.

  Default: /opt/lanman/bin:/usr/bin

• NetAdminUserName REG_SZ Character string

  The Solaris system user account name assigned to a process executed by the net admin \\servername /c command.

  Default: lmxadmin

Parameters Entries

The Registry path that contains entries for the SunLink Server Parameters is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\Parameters

• CheckPrintQueueInMinutes REG_DWORD 1 - infinity

  The interval in minutes at which the server determines whether a printer queue should be started.

  Default: 10 minutes

• DisableUpLevelPrinting REG_DWORD 0 or 1

  Specifies whether to disable or enable Windows NT-style printing.

  Do not change this value from the default setting of 0. Doing so will disable all printing services.

  Default: 0

• MaxDirectoryBufferSize REG_DWORD 1 - infinity

  The maximum size of a buffer that the server will use for a getdents(2) system call to read the contents of a Solaris system directory. Because SunLink Server will attempt to allocate these buffers using the GC memory allocator, one should consider increasing the SizeGcBufferPoolInKB key if one increases this value.

  Default: 32768 bytes

• MaxIpcTryCount REG_DWORD 1 - infinity

  The number of read() system calls after which the server checks whether other work could be done by the server. There is a considerable amount of interprocess communication (IPC) between server processes. The server uses the read system call to receive IPC messages, but read does not always return the entire message. This key ensures that the server does not keep trying to get an IPC message at the expense of other activities the process could perform.

  Default: 20

• MaxMailslotReadTime REG_DWORD 1 - infinity

  The amount of time in seconds to wait for a local mailslot application to read a class 1 mailslot. A value specified here keeps the server from waiting indefinitely for a message to be delivered.

  Default: 90 seconds

• MaxMessageSize REG_DWORD 1024 - infinity

  The maximum amount of data that a client can exchange with the server.

  Default: 4156 bytes

• MaxPrintQueueNameLength REG_DWORD 1 - 255 characters

  Provides dynamic control of the allowable length of the name of a printer queue. LP subsystem commands currently allow class names to be as large as 255 characters, but jobs sent to these classes cannot be controlled and many of the Solaris system commands to manipulate these jobs result in a fatal error. This key is used by printer queue functions to restrict access to queues based on the length of the queue name.

  Default: 14

• MaxRawSize REG_DWORD 8192 bytes - infinity

  Specifies the maximum size (in bytes) of the raw send or receive buffers that the SunLink Server program will use for processing Read Block Raw, Write Block Raw, Transaction, Transaction 2, or NT Transaction SMBs.

  Default: 32768

• MaxServiceWaitTime REG_DWORD 5 seconds - infinity

  Specifies the amount of time (in seconds) the server will wait for a service to respond when it changes the following statuses of the services: pause, continue, install, uninstall.

  Default: 60

• NativeLM REG_SZ Character string

  An additional field in the session setup request/response. This field is generated at run time.

  Default: (Vendor-specific)

• NativeOS REG_SZ Character string

  An additional field in the session setup request/response. This field is generated at run time.

  Default: (platform-dependent)

• SendByeMessage REG_DWORD 0 or 1

  Specifies whether the server sends a message to every client in the domain in the event that it is going to stop for any reason other than a normal shutdown. The message states that the SunLink Server program has stopped.

  Default: 1 (send a message)

• SizeGcBufferPoolInKB REG_DWORD 1 - infinity

  The buffer size in Kbytes allocated for each server process for client files.

  Default: 200 Kbytes

Process Parameters Entries

The Registry path that contains entries for the SunLink Server Process Parameters is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\ProcessParameters

• CoreOk REG_DWORD 0 or 1

  Specifies whether the server can create a core dump file on disastrous failures.

  Default: 0 (do not create core file)

• KeepSpareServer REG_DWORD 0 or 1

  Specifies whether the server should have a spare lmx.srv process available for another client. New client connections are likely to be quicker if this key is enabled.

  Default: 1 (start lmx.srv process)

• LockNapInMSec REG_DWORD 1 - infinity

  Specifies the length of time in milliseconds that the server sleeps when shared memory lock contention occurs. The server retries busy locks at intervals specified in this key until the length of time specified in the value of the MaxLockTimeInSeconds key elapses.

  Default: 10 milliseconds

• MaxLockTimeInSeconds REG_DWORD 5 - infinity

  The maximum interval in seconds that a server process waits for a shared memory lock to become available.

  Default: 300 seconds (5 minutes)

• MaxVCPerProc REG_DWORD 0 - 101

  The maximum number of virtual circuits that each lmx.srv process should be able to handle. This limit normally is calculated on the fly by SunLink Server software using the value of the VCDistribution Registry key and the value of the maxclients parameter in the lanman.ini file. If the value of this key is non-zero, its value is used instead of the calculated value.

  Default: 0 (Use value of VCDistribution key)

• MaxVCs REG_DWORD

  The maximum number of virtual circuits that can be established to a SunLink Server computer. This key permits administrators to manually override the sizing of shared memory.

  Do not change the value of this key.

• MinSmbWorkerTasks REG_DWORD

  Determines how many SMBWORKER tasks are preallocated by lmx.srv processes on startup. Do not change the value of this key.

• MinVCPerProc REG_DWORD

  The minimum number of virtual circuits that each lmx.srv process should be able to handle. This limit normally is calculated on the fly by SunLink Server using the value of the VCDistribution Registry key and the value of the maxclients parameter in the lanman.ini file. If this value is non-zero, its value is used instead of the calculated value.

  Default: 0 (Use value of VCDistribution key)

• NumCIStructs REG_DWORD

  Sizes the CLIENTINFO array in shared memory.

  Do not change the value of this key.

• NumCLIENT_SESSION REG_DWORD 5 - 128

  Limits the number of trust relationships that a server can maintain with other domains. This figure should be at least one greater than the number of domains trusted by the server's domain.

  Default: 5

• NumHashTables REG_DWORD 8 - infinity (powers of 2)

  The number of buckets for the hash table in shared memory to keep track of the various modes that clients have used to open files and set record locks.

  Do not change the value of this key.

  Default: 128

• NumSERVER_SESSION REG_DWORD 5 - infinity

  Limits the number of servers and Windows NT clients that can authenticate with the server. This figure should be large because it limits the number of Windows NT clients that can contact the server. On a primary domain controller, it must be at least the number of servers and Windows NT clients in the domain.

  Default: 100

• NumUStructs REG_DWORD 1 - infinity

  The number of structures allocated in shared memory to handle record lock and open file records. The sum of open files and record locks cannot exceed the value of this key.

  Default: 1000

• SpareServerTime REG_DWORD 0 - infinity

  The interval in seconds that a spare lmx.srv process is allowed to run without serving a client before being terminated.

  Default: 120 seconds (2 minutes)

• StopOnCore REG_DWORD 0 or 1

  Specifies whether the lmx.ctrl process is to stop if it finds that an lmx.srv process has terminated unexpectedly.

  Default: 0 (do not stop SunLink Server)

• VCDistribution REG_MULTI_SZ List

  Specifies the distribution of virtual circuits or sessions over lmx.srv processes. The architecture of the server allows multiple sessions to be served by each lmx.srv process on the Solaris system. The server must decide if a new session should be handed off to an existing lmx.srv process or if a new process should be started. This key specifies the distribution of sessions over the lmx.srv processes.

  Values are entered in sets of three integers separated by commas, each set of three numbers on a new line. In each set, the first number specifies the number of clients; the second is the minimum number of virtual circuits each lmx.srv process should support; the third is the maximum number of virtual circuits each process should support.

  Default: 1,2,12

  20,2,20

  35,2,24

  50,3,28

  85,4,28

  100,5,32

  130,6,36

  180,8,42

  250,9,44

  350,10,50

  500,10,60

  750,10,80

  1000,10,101

The following table describes the meaning of the default values.

Table A-5 lmx.srv Processes Default Value Meaning

Client Range	Min. Sessions per lmx.srv	Max. Sessions per lmx.srv
1-19	2	12
20-34	2	20
35-49	2	24
50-84	3	28
85-99	4	28
100-129	5	32
130-179	6	36
180-249	8	42
250-349	9	44
350-499	10	50
500-749	10	60
750-999	10	80
1000+	10	101

RPC Parameters Entries

The Registry path that contains entries for the SunLink Server RPC Parameters is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\RpcParameters

• BrowserMaxCalls REG_DWORD 5 - infinity

  The maximum number of open browser sessions that an lmx.srv process can support simultaneously.

  Default: 60

• EventlogMaxCalls REG_DWORD 5 - infinity

  The maximum number of open event log sessions that an lmx.srv process can support simultaneously.

  Default: 60

• LsarpcMaxCalls REG_DWORD 5 - infinity

  The maximum number of open LSA RPC sessions that an lmx.srv process can support simultaneously.

  Default: 60

• NetlogonMaxCalls REG_DWORD 5 - infinity

  The maximum number of open Netlogon sessions that an lmx.srv process can support simultaneously.

  Default: 60

• SamrMaxCalls REG_DWORD 5 - infinity

  The maximum number of SAM sessions that an lmx.srv process can support simultaneously.

  Default: 20

• SpoolssMaxCalls REG_DWORD 5 - infinity

  The maximum number of print sessions that an lmx.srv process can support simultaneously.

  Default: 50

• SrvsvcMaxCalls REG_DWORD 5 - infinity

  The maximum number of server sessions that an lmx.srv process can support simultaneously.

  Default: 60

• SvcctlMaxCalls REG_DWORD 5 - infinity

  The maximum number of service control sessions that an lmx.srv process can support simultaneously.

  Default: 60

• WinregMaxCalls REG_DWORD 5 - infinity

  The maximum number of Registry sessions that an lmx.srv process can support simultaneously.

  Default: 60

• WkssvcMaxCalls REG_DWORD 5 - infinity

  The maximum number of workstation sessions that an lmx.srv process can support simultaneously.

  Default: 60

Share Parameters Entries

The Registry path that contains entries for the SunLink Server Share Parameters is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\ShareParameters

• KeepAdministrativeShares REG_DWORD 0 or 1

  Specifies whether administrators are prevented from removing the ADMIN$ and IPC$ shared resources.

  Default: 1 (prevented from removing shared resources)

• MakeUnixDirectoriesOnShare REG_DWORD 0 or 1

  When creating a new share using Server Manager, specifies whether SunLink Server software should create a directory automatically if one does not exist.

  Default: 1 (create new directory)

• ShareCacheCount REG_DWORD 5 - infinity

  The number of share names to store in the sharefile cache.

  Default: 40

• ShareReadCount REG_DWORD 1 - infinity

  The number of share entries to read during sharefile operations. A value greater than 1 causes the server to read ahead SHAREENTRY structures from the sharefile.

  Default: 10

User Service Parameters Entries

The Registry path that contains entries for the SunLink Server User Service Parameters is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AdvancedServer\UserServiceParameters

• CreateUnixUser REG_DWORD 0 or 1

  Automatically creates and assigns a similarly named Solaris system user account to every new SunLink Server user account created in the domain in which the server is a member. The value of this key must be set to 1 on every server on which Solaris system accounts are to be created. Note that new SunLink Server users are assigned to the Solaris system lmworld account.

  Default: 0 (do not create Solaris system user account)

  You can change the value of this key using the SunLink Server Manager.

• Exclude REG_SZ Character string

  Specifies existing Solaris system user IDs excluded from being assigned to SunLink Server user accounts. If a SunLink Server user account is created whose name matches an existing Solaris system user account whose ID is contained in the exclude list, a new Solaris system user account will be generated automatically and assigned to the SunLink Server user account. This can be used to ensure that certain existing Solaris system user accounts never are assigned automatically to newly created SunLink Server user accounts, even if the ForceUniqueUnixUserAccount key is set to 0.

  Default: 0 - 100

• ForceUniqueUnixUserAccount REG_DWORD 0 or 1

  Specifies whether to assign automatically an existing Solaris system user account to a newly created SunLink Server user account. If you select 1, then the system does not assign existing Solaris system user accounts. Instead, new Solaris system user accounts are generated automatically and assigned to SunLink Server user accounts when they are created.

  Default: 0 (A new SunLink Server user account can be assigned automatically to an existing Solaris system user account with an equal or similar name, provided that the Solaris system user account is not specified in the exclude list.)

  You can change the value of this key using the SunLink Server Manager.

• GroupUpdateTime REG_DWORD 0 - infinity

  The interval in seconds at which the server checks the Solaris system file /etc/group for changes.

  Default: 3600 seconds (1 hour)

• NewUserShell REG_SZ Character string

  The login shell for new user accounts. The default prevents new users from logging in to the Solaris system using a terminal emulator. To enable login, set this key to a real value, such as /bin/sh.

  You can change the value of this key using the SunLink Server Manager.

  Default: /bin/false

• SyncUnixHomeDirectory REG_DWORD 0 or 1

  Whenever the home directory of a SunLink Server user account changes, this key changes the home directory of the associated Solaris system user account to match the SunLink Server home directory.

  You can change the value of this key using the SunLink Server Manager.

  Default: 0 (do not synchronize home directories)

• UserComment REG_SZ Character string

  The comment to assign to all automatically created Solaris system user accounts.

  Default: SunLink Server user

• UserRemark REG_SZ 0 - 48 characters

  The comment string associated with the USERS shared directory.

  Default: User's Directory

Alerter Service Parameters

The Registry path that contains entries for the SunLink Server Alerter service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Alerter\Parameters

• AlertNames REG_MULTI_SZ List

  A list of the user accounts and computer names that should receive administrative alerts.

  Default: None

• CountNotOnNetworkCache REG_DWORD 0 - infinity

  Specifies the number of non-running cached clients to which the Alerter service should not send messages. When the Alerter service tries to send a popup message to a client, NetBIOS name resolution can cause unwanted delays if the client is not on the network. To circumvent this problem, the Alerter service caches the names of clients that are not running and does not send alerts to these clients.

  Default: 10

• IncludeMessageHeader REG_DWORD 0 or 1

  Specifies whether the Alerter service should add four lines of header information to messages (sender, recipient, subject, and date).

  Default: 0 (do not include headers)

• NotOnNetworkCacheTimeout REG_DWORD 0 - infinity

  Specifies how long in seconds that non-running clients should remain in the server's cache of clients.

  Default: 120 seconds (2 minutes)

Browser Service Parameters

You can use SunLink Server Manager to change the values of all of the following keys. The Registry path that contains entries for the SunLink Server Computer Browser service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Browser\Parameters

• BackupRecovery REG_DWORD 60 - infinity

  Specifies the period of time in seconds that must elapse before a server that has ceased being a backup browser can become a backup browser again.

  Default: 1800 seconds (30 minutes)

  You can change the value of this key using the SunLink Server Manager.

• BackupUpdate REG_DWORD 60 - infinity

  Indicates the interval in seconds at which the backup browser refreshes its browse lists with the master browser.

  Default: 720 seconds (12 minutes)

  You can change the value of this key using the SunLink Server Manager.

• MasterUpdate REG_DWORD 60 - infinity

  Indicates the interval in seconds at which the master browser ages its browse lists and updates its lists with the domain master browser.

  Default: 720 seconds (12 minutes)

  You can change the value of this key using the SunLink Server Manager.

• MoreLog REG_DWORD 0 or 1

  Indicates whether the Computer Browser service should record additional system log entries for events such as election packets that the Computer Browser service receives and the role of the browser server (master or backup).

  Default: 0 (do not record additional entries)

EventLog Service Entries

The subkey for EventLog contains at least three subkeys for the three types of logs: Application, Security, and System. These logfile subkeys contain subkeys that define the locations of the related event message files and the supported types of events, as follows:

• Application - Perflib, Perfmon, Replicator, RemoteBoot

• Security - LSA, SC Manager, Security, Security Account Manager, Spooler

• System - Alerter, Browser, EventLog, NetLogon, Print, Rdr, SAM, server, Service Control Manager, Srv, Wins, workstation

Each of the three logfile subkeys for the EventLog service can contain the value entries described in this section. The Registry path for these entries is the following, where logfile is System, Application, or Security.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\logfile

These entries are described for informational purposes only. This information is usually maintained by Event Viewer.

• File REG_EXPAND_SZ Path and file name

  Specifies the fully qualified path name of the file for this log.

  Default: %SystemRoot%\var\opt\lanman\logs\filename

• MaxSize REG_DWORD Multiples of 64 Kbytes

  Specifies the maximum size of the log file. This value can be set using the Event Viewer.

  Default: 524288 (512 Kbytes)

• Retention REG_DWORD 0 to infinity

  Specifies in seconds that records newer than this value will not be overwritten. This is what causes a log full event. This value can be set using the Event Viewer.

  Default: 604800 seconds (7 days)

• Sources REG_MULTI_SZ List

  Specifies the applications, services, or groups of applications that write events to this log. Each source may be a subkey of the logfile subkey. (The appsources, secsources, and syssources keys also are in the lanman.ini file.)

  Default: (varies according to log file)

The subkeys under a logfile subkey are created by the applications that write events in the related event log. These subkeys contain information specific to the source of an event under the following types of value entries.

• EventMessageFile REG_EXPAND_SZ Character string

  Specifies the path and file name for the event identifier text message file.

• CategoryMessageFile REG_EXPAND_SZ Character string

  Specifies the path and file name for the category text message file. The category and event identifier message strings may be in the same file.

• CategoryCount REG_DWORD 0 - infinity

  Specifies the number of categories supported.

• TypesSupported REG_DWORD 0 - infinity

  Specifies a bitmask of supported types.

Net Logon Service Parameters

The Registry path with entries for the SunLink Server Net Logon service follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Netlogon\Parameters

• LogonQuery REG_DWORD 60 - infinity

  Specifies the interval, in seconds, at which the server checks if linked clients are still active.

  Default: 900 (15 minutes)

• Pulse REG_DWORD 60 - 3600 (1 hour)

  Specifies the interval, in seconds, for sending update notices when no updates are occurring to the master user accounts database. This keyword applies only to a primary domain controller and is ignored by other servers.

  Default: 300 (5 minutes)

• QueryDelay REG_DWORD 1 - infinity

  Specifies the interval in seconds that a client can wait before responding to the server's inquiry about whether it is active.

  Default: 2

• Randomize REG_DWORD 5 to 120

  Specifies the period, in seconds, within which a BDC randomizes its request to a PDC for updates after receiving an update notice. This keyword reduces the chance that BDCs in the same domain will simultaneously request an update.

  Default: 30 seconds

• RelogonDelay REG_DWORD 1 - infinity

  Specifies the interval in seconds that a client can wait before logging back on to the server after the server has been stopped and restarted.

  Default: 2

• Scripts REG_EXPAND_SZ

  Specifies the location of the logon scripts directory.

  Default on primary domain controller: %SystemRoot%\var\opt\lanman\shares\asu\repl\export\scripts

  Default on backup domain controller: %SystemRoot%\var\opt\lanman\shares\asu\repl\import\scripts

• SSIPasswdAge REG_DWORD 86400 (24 hours) - infinity

  Specifies the time, in seconds, at which a backup domain controller must change the password that it sends to the primary domain controller to verify its eligibility to receive user accounts database updates.

  Values: 604800 (7 days)

• Update REG_DWORD 0 or 1

  If this value is set, the server synchronizes the user accounts database with the primary domain controller every time it starts. This keyword applies only to a backup domain controller and is ignored by the primary domain controller. Note that full synchronization is a very time-consuming operation.

  Default: 0 (do not synchronize)

Netrun Service Parameters

The Registry path that contains entries for the SunLink Server Netrun service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Netrun\Parameters

• MaxRuns REG_DWORD 1 - 10

  Sets the maximum number of Netrun requests that can run simultaneously.

  Default: 3

• RunPath REG_SZ Path up to 256 characters

  Sets the path where programs accessible via the Netrun service are located. Only programs located in a runpath can be executed from a client or another server. Separate multiple path entries with colons (:).

  Default: \tmp

Replicator Service Entries

The Registry path that contains entries for the SunLink Server Directory Replicator service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Replicator\Parameters

• ExportList REG_SZ Character string

  Lists an unlimited number of servers or domains that receive notices when the export directory is updated. These servers subsequently replicate from the export server. If no value is specified, the export server sends a notice to its domain. Separate multiple names with a semicolon (;). This value is ignored if the value of the Replicate key is 2 (Import).

  Do not use the UNC name when you specify a computer name; that is, do not include two backslashes (\\) at the beginning of the name.

  Default: (local domain name)

• ExportPath REG_SZ or REG_EXPAND_SZ Path name

  Specifies the export path. All files to be replicated must be in a subdirectory of the export directory. This value is ignored if the value of the Replicate key is set to 2 (Import).

  Default: C:\var\opt\lanman\shares\asu\repl\export

• GuardTime REG_DWORD 0 to one-half of Interval

  Sets the number of minutes an export directory must be stable (no changes to any files) before import servers can replicate its files.

  This option applies only to directories with tree integrity.

  Default: 2

• ImportList REG_SZ Character string

  Lists an unlimited number of servers or domains from which files and directories are to be replicated. If no value is specified, files and directories will be replicated from the server's domain. Separate multiple names with a semicolon (;). This value is ignored if the value of the Replicate key is 1 (Export).

  Do not use the UNC name when you specify a computer name; that is, do not include two backslashes (\\) at the beginning of the name.

• ImportPath REG_SZ or REG_EXPAND_SZ Pathname

  Specifies the path on the import server to receive replicas from the export servers. This value is ignored if the value of the Replicate key is 1 (Export).

  Default: C:\var\opt\lanman\shares\asu\repl\import

• Interval REG_DWORD At least twice as large as GuardTime value

  Specifies how often in minutes an export server checks the replicated directories for changes. Used in conjunction with the Pulse key. Ignored on import servers. The value of Interval must be at least twice as large as the value of GuardTime. Otherwise, the Replicator service will not start.

  Default: 5

• MaxFilesInDirectory REG_DWORD 0 - infinity

  Specifies the maximum number of files in an import directory that can be replicated.

  Default: 2000

• Pulse REG_DWORD 1 - 10

  Specifies in minutes how often the export server repeats the last update notice. These repeat notices are sent even when no changes have occurred, so that import servers that missed the original update notice can get the notice. The server waits the equivalent of (Pulse * Interval) minutes before sending each repeat notice.

  Default: 3

• Random REG_DWORD 1 - 120

  Specifies the maximum time in seconds that the import servers can wait before requesting an update. An import server uses the export server's value of Random to generate a random number of seconds (from 0 to the value of Random). The import server waits this long after receiving an update notice before requesting the replica from the export server. This prevents the export server from being overloaded by simultaneous update requests.

  Default: 60

• Replicate REG_DWORD 1, 2, or 3

  Specifies the Replicator action, according to the following:

  1 = Export - The server maintains a master tree to be replicated.

  2 = Import - The server receives update notices from the export server.

  3 = Both - The server is to export and import directories or files.

  Default: Varies with role of server

• TryUser REG_DWORD 0 or 1

  Specifies whether the import server should try to update directories when a user name is logged on locally.

  Default: 0

• UnixDirectoryGroup REG_SZ Character string

  Specifies the Solaris system group account name for replicated directories.

  Default: DOS

• UnixDirectoryOwner REG_SZ Character string

  Specifies the Solaris system user account name for replicated directories.

  Default: lmxadmin

• UnixFileGroup REG_SZ Character string

  Specifies the Solaris system group account name for replicated files.

  Default: DOS

• UnixFileOwner REG_SZ Character string

  Specifies the Solaris system user account name for replicated files.

  Default: lmxadmin

UPS Service Parameters Entries

The Registry path that contains entries for the SunLink Server Uninterruptible Power Supply service is as follows:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\UPS\Parameters

• IgnoreSIGPWR REG_DWORD 0 or 1

  Specifies whether UPS service will be enabled.

  Default: 1 (disables UPS service)

  You can change the value of this key using the SunLink Server Manager.

• PowerFailAddress REG_SZ String up to 15 characters

  Specifies the NetBIOS name to which the server sends a message when it receives a SIGPWR signal.

  Default: * (all users)

  You can change the value of this key using the SunLink Server Manager.

• PowerFailMessage REG_SZ String up to 500 characters

  The text of the message to be sent by the server when it receives a SIGPWR signal.

  Default: "The system has experienced a power failure. Please close all applications and files and log off immediately."

  You can change the value of this key using the SunLink Server Manager.

• PowerMessageInterval REG_DWORD 0 - infinity

  Specifies the interval in minutes at which the server repeats the message sent when it receives a SIGPWR signal. A value of 0 indicates that the message should be sent one time only.

  Default: 1

  You can change the value of this key using the SunLink Server Manager.