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