Solaris PC NetLink 1.0 Administration Guide

About `lanman.ini` File Entries

This section lists and describes the lanman.ini file parameters that you can modify to change SunLink Server system configuration and performance. (Other configuration values are stored in the SunLink Server Registry, as well; see Appendix A, SunLink Server Registry.) The configuration values within the lanman.ini file are vital to the proper operation of the SunLink Server program, and editing this file is a task that should be performed only by experienced administrators.

When SunLink Server software is first installed, the lanman.ini file (/etc/opt/lanman/lanman.ini) contains some default parameter values. Other parameters and the titles of the sections in which they reside are added whenever you change the SunLink Server configuration. Only parameters that have been changed to values other than their default values are added to the lanman.ini file. If a parameter does not appear in the file (or is commented out with a semicolon), it is set to its default value.

Before attempting to change any of the parameters available in the lanman.ini file, it is useful to understand the relationship between the lanman.ini file entries and server defaults.

Every server parameter has a default setting. To display and edit default settings, a utility program called srvconfig is provided in the /opt/lanman/sbin directory.

You can edit the lanman.ini file to set parameters to values other than the defaults. The value assigned to any parameter in the lanman.ini file always supersedes the default value for that parameter. Note that no changes will actually take effect until you have stopped and then restarted the server.

When you want to set the value of a parameter to something other than the default by directly editing the lanman.ini file, locate (or add) the appropriate section title in the file, and then add the desired parameter=value entry.

File Syntax

Within each section of the lanman.ini file, parameters are listed as follows:

The name of each parameter is at the beginning of a line, followed by an equal sign and the value assigned to it: parameter=value.

Comments start with a semicolon (;). If a semicolon precedes a parameter on the line, that parameter is ignored.

When a list of values is assigned to a parameter, the values are separated by commas: parameter=value,value,value, ... (There are some exceptions to this rule, which are noted in the description of the appropriate parameters.)

When a value consists of a path, the path may be absolute, starting with a forward slash (/). If a path does not start with /, it is assumed to be relative to the lanman directory.

If a numeric value begins with 0 (the numeral), it is octal; if it begins with an "X," it is hexadecimal; if it begins with a numeral from 1 to 9, it is decimal.

When a parameter has no assigned value (nothing to the right of the equal sign), the value is 0 for a parameter that requires a number and null for a parameter that requires a character string.

A null value is not valid for all parameters.

How to Change a `lanman.ini` File Parameter

Use the srvconfig command to display default settings for the server parameters:

/opt/lanman/sbin/srvconfig -p | more

Edit the lanman.ini file using vi or a similar text editor.

The file is in the /etc/opt/lanman directory. You may have to add a section heading to the file; for example [ lmxserver ]. You then need to add a parameter=value pair to the appropriate section of the lanman.ini file. (See the section, "About lanman.ini File Entries".)

Stop and restart the server for the new values to take effect.

For more information about the srvconfig command, type man srvconfig at the SunLink Server command prompt.

File Parameters

The following tables describe the configurable parameters in the lanman.ini file. The parameters are grouped according to the section of the lanman.ini file in which they reside.

The lanman.ini file contains additional parameters that are not included in the following tables. These parameters are for debugging purposes and you should not modify them.

Table 2-4 [Lmxserver] Section Parameters


Parameter	Description, Values, and Default Setting
`anncmailslot`	The name of the mail slot used for periodic server announcements. Values: A path up to a maximum of 256 characters. Default: `\\*\MAILSLOT\LANMAN` Note that backslashes must be doubled on input or else the entire input line must be enclosed in single quotation marks. (Type `text\\text` or ``text\text`` to enter text with a single backslash.)
`appsources`	The names of the modules that can write to the application log. Default: The server initializes the value of this parameter at startup.
`country`	The country code for server-generated messages. Default is 001. Other values: Asia--099; Australia--061; Belgium--032; Canada--002; Denmark--045; Finland--358; France--033; Germany--049; Italy--039; Japan--081; Latin America--003; Netherlands--031; Norway--047; Portugal--351; Spain--034; Sweden--046; Switzerland--041; United Kingdon--044; United States--001 (default--001)
`dll_dir`	The path to the directory containing message text files used by SunLink Server Solaris system commands. Default: `/opt/lanman/shares/asu/system32`
`lang`	Defines the character set that SunLink Server software uses for processing client requests. Default: `en_US`
`listenextension`	The extension that the Solaris system Listener program, by default, applies to the name of the server computer. This parameter is ignored if the `listenname` parameter in the `[server]` section is used. Values: 0-13 characters and a null value are acceptable. Default: .`SERVE`
`listennamechk`	If set to yes, it forces any name specified with the `listenname` parameter to be different than the Solaris machine name or the Solaris machine name with a `.serve` extension in order to avoid name conflicts with the Solaris Listener. Default: Vendor specific
`lmaddonpath`	The directory for dynamic libraries bound into the server program and called at various times during server execution, as described in the `/usr/include/lmx/lmaddon.h` header file. The server looks for these dynamic libraries on startup. Values: A path up to a maximum of 256 characters. Default: `/opt/lanman/lib/addon/lmaddon`
`lmgetmsg_path`	Search order for message text files used by SunLink Server. Default: `netmsg.dll`, `kernel32.dll`, `locallspl.dll`, `asumsg.dll`
`lptmpdir`	The location of the spooling directory for temporary files used by the Solaris system's LP (printer) subsystem. Default: `/var/spool/lp/tmp/uname` where `uname` is the server's Solaris system name. (This is not changeable by users.)
`mapaclblob`	Configures whether to use memory-mapped file operations when accessing the SunLink Server Access Control List database. Values: yes, no. Default: yes
`mapchangelogblob`	Configures whether to use memory-mapped file operations when accessing the SunLink Server Change Log database. Values: yes, no. Default: no
`maplsablob`	Configures whether to use memory-mapped file operations when accessing the SunLink Server Local Security Authority database. Values: yes, no. Default: no
`mapregistryblob`	Configures whether to use memory-mapped file operations when accessing the SunLink Server Registry database. Values: yes, no. Default: no
`mapsamblob`	Configures whether to use memory-mapped file operations when accessing the SunLink Server Security Accounts Manager database. Values: yes, no. Default: no
`maxfilesize`	The maximum file size, in kilobytes, that the Solaris system redirector will allow a "local Solaris user" to create on a local system. Values: 100 - unlimited. Default: 2097152
`msgforward`	Specifies if SunLink Server software implements message forwarding between clients. Implementation of message forwarding is not recommended. Values: yes (implement forwarding) or no (do not implement forwarding). Default: no
`nativelm`	An additional field in the session setup request/response. Default: SunLink Server
`nativeos`	An additional field in the session setup request/response. Default: UNIX `x.x` Generic (where `x.x` is the release number)
`netaddonpath`	The directory in which the SunLink Server program looks for dynamic libraries on startup. Dynamic libraries found in the directory are bound into the SunLink Server program and used to access the various network interfaces on the server computer. Sample source for a network interface file is located in the default directory. Values: A path up to a maximum of 256 characters. Default:`/opt/lanman/lib/addon/networks`
`nethelpfile`	The location of the help file used by the `net` `help` command (relative to `/var/opt/lanman/msgfiles`). Default: `/opt/lanman/msgfiles/net.hlp`
`netmsgwait`	The interval, in seconds, that the server waits for a response when it sends a message that requires one. Values: 0 - unlimited. Default: 300
`network`	The network device names and NetBIOS name-passing type for the network(s) the server should use. Values: sets of four items separated by commas, each set of four separated from the next by a space. The following four items are in each set: The device name for virtual circuit access. The device name for datagram network access. A digit identifying the NetBIOS interface convention used by the two devices above. Currently there is only one convention compiled into the server: 0 = OSI NetBIOS convention. The name of the transport provider, as returned by the `nlsprovider` system call. (For networks not configured to accept incoming connections through the Solaris system Listener program, this can be any arbitrary string.)
`prebinduxredir`	Controls the name that the Solaris system `net` command binds when it uses the Solaris system redirector (`uxredir`). If this parameter is set to yes, the server pre-binds a NetBIOS name that will be used by all Solaris system `net` commands. Because this name is pre-bound, the `net` command does not need to bind its own name, and this quickens the Solaris system's `net` access to the server. If this parameter is set to no, then each `net` command will use its own unique name with somewhat slower performance resulting. Values: yes, no. Default: yes
`secsources`	The names of the modules that can write to the security log. Default: The server initializes the value of this parameter at startup.
`srvstathelpfile`	The location of the help file used by the Activity Monitor. Default: `/opt/lanman/msgfiles/srvstat.hlp`
`stacksize`	The size of the stack, in bytes, for each task internal to the server. Values: 12000 - unlimited. Default: 20000
`syssources`	The names of the modules that can write to the system log. Default: The server initializes the value of this parameter at startup.

Table 2-5 [Fsi] Section Parameters


Parameter	Description, Values, and Default Setting
`fsaddonpath`	The location of dynamic link libraries (DLL) that support file systems on the server. Values: A path up to a maximum of 256 characters. Default: `/opt/lanman/lib/addon/fsaddon`
`fslibname`	The subdirectory of the directory identified by `fslibpath` where new file systems are located. Values: A path up to a maximum of 256 characters. Default: `lmfsiops.so`
`fslibpath`	The location of new file systems on the server. Values: A path up to a maximum of 256 characters. Default: `/usr/lib/fs`
`fsmap`	File system type identifiers that map unknown file systems to known file system types. Values: a comma-separated list of mappings. Default: `unknown:s5,nfs:nfs,sfs:vxfs,cdfs:vxfs`
`fsnosupport`	Maps unknown file system to specified file system. Default: `s5`
`remotemounts`	The names of file system types that indicate remotely mounted file systems. Default: `nfs`

Table 2-6 [Workstation] Section Parameters


Parameter	Description, Values, and Default Setting
`domain`	The name of the domain that includes the server. Values: any name of up to 15 characters, including letters, numbers, and the following characters: ! # $ % & ( ) - . ^ _ { } ~ ; Default: `<servername>_dom`

Table 2-7 [Server] Section Parameters


Parameter	Description, Values, and Default Setting
`listenname`	If set, this is the server's name on the network. If not set, the SunLink Server system may receive client connections from the Solaris Listener on the Solaris machine name with a `.serve` extension (such as `liberty.serve`). This is implementation dependent. The Solaris system machine name can be determined by using the `uname` `-n` command. To change the value of the `listenname` parameter, use the `setservername` command. For more information about this command, type `man` `setservername` at the SunLink Server command prompt. Values: any name of 1-15 characters. Default: null
`maxclients`	Identifies the maximum number of simultaneous client sessions that the server must support. Default: 1000.
`srvservices`	The list of keywords for the services that start automatically when the server is started. Because services are started in the order they appear in the `srvservices` entry, you must ensure that `netlogon` appears before any services that require it. Default: `alerter`, `netlogon`, `browser`

Table 2-8 [Psi] Section Parameters


Parameter	Description, Values, and Default Setting
`psaddonpath`	The location of dynamically linked libraries (DLLs) that support printer subsystems on the server. Values: A path up to a maximum of 256 characters. Default: `/opt/lanman/lib/addon/psaddon`

About lanman.ini File Entries

File Syntax

How to Change a lanman.ini File Parameter

File Parameters

About `lanman.ini` File Entries

How to Change a `lanman.ini` File Parameter