3.4 Configuring Global NCP Server Parameters

NCP Server provides several global parameters for the SET utility that can be used to customize NCP Server for a given server. Initially, the parameters and default settings are in force, but the parameters are not explicitly added to the /etc/opt/novell/ncpserv.conf file. After you modify its default setting, an entry for the parameter and its new setting are added to the file. The parameter entry remains in the file even if you modify the setting back to the default.

IMPORTANT:If you use NCP Server in a cluster, make sure to set the same global policies on each OES 2 Linux node in the cluster where you plan to fail over the shared volumes.

There are three methods available for modifying parameter settings:

The following sections identify the global NCP Server parameters with their default values and valid options. For additional information about each parameter, see Section A.2, NCPCON SET Parameters.

3.4.1 Directory Cache Management for NCP Server

Table 3-2 Server Parameter Information for Directory Cache Management

Parameter Name and Description

Default Value

Value Options

MAXIMUM_CACHED_FILES_PER_SUBDIRECTORY

Controls the maximum number of file entries that can be cached by the system for a given folder in the directory cache.

10240

Minimum is 512 files.

MAXIMUM_CACHED_FILES_PER_VOLUME

Controls the maximum number of file entries that can be cached by the system for a given volume in the directory cache.

256000

Minimum is 2048 files.

MAXIMUM_LAZY_CLOSE_FILES

Controls the maximum number of files’ handles that can be lazy closed in the directory cache.

4096

16 to 64000

MAXIMUM_CACHED_SUBDIRECTORIES_PER_VOLUME

Controls the maximum number of folder entries that can be cached by the system for a volume in the directory cache.

102400

4096

LOG_CACHE_STATISTICS

Controls whether cache statistics are logged in the ncpserv.log file.

0

0 - Disable

1 - Enable

3.4.2 Dynamic Storage Technology for NCP Server

For information about configuring global policies for DST, see the OES 2 SP3: Dynamic Storage Technology Administration Guide.

Table 3-3 Server Parameter Information for Dynamic Storage Technology

Parameter Name and Description

Default Value

Value Options

DUPLICATE_SHADOW_FILE_ACTION

Controls how duplicate files conflicts are handled.

0

0 - Show duplicate shadow files (default)

1 - Hide duplicate shadow files

2 - Rename duplicate shadow files

3 - Delete duplicate files from shadow area

4 - Move duplicate shadow files to /._DUPLICATE_FILES

DUPLICATE_SHADOW_FILE_BROADCAST

Controls whether broadcast messages are sent to NCP users whenever duplicate files conflicts occur.

1

0 - Disable

1 - Enable

REPLICATE_PRIMARY_TREE_TO_SHADOW

Controls how the primary tree is replicated from the primary tree to the shadow tree. By default, it is disabled, and paths are replicated to the secondary storage area when data is actually moved from the primary location to the secondary location. If it is enabled, the entire tree is replicated even if no files in a path have been moved to the secondary storage location.

0

0 - Disable

1 - Enable

SHIFT_ACCESSED_SHADOW_FILES

Controls whether files are moved from the secondary volume to the primary volume if the volume is accessed twice during a specified elapsed time. Use SHIFT_DAYS_SINCE_LAST_ACCESS to specify the time period. The file is moved after it is closed.

0

0 - Disable

1 - Enable

SHIFT_MODIFIED_SHADOW_FILES

Controls whether files are moved from the secondary volume to the primary volume if the file is modified. The file is moved after it is closed.

1

0 - Disable

1 - Enable

SHIFT_DAYS_SINCE_LAST_ACCESS

Specifies the number of elapsed days during which a file must be accessed twice before it is moved. This applies only if SHIFT_ACCESSED_SHADOW_FILES is enabled.

1

0 - Disable

1 to 365 (in days)

3.4.3 Locks Management for File Access on NCP Server

Table 3-4 Server Parameter Information for Locks Management

Parameter Name and Description

Default Value

Value Options

CROSS_PROTOCOL_LOCKS

Controls cross-protocol file locking support with Samba.

Cross-protocol locks help prevent the same file from being concurrently accessed for modifications from both a Samba and NCP client.

1

1 - Enable

0 - Disable

OPLOCK_SUPPORT_LEVEL

Controls NCP opportunistic locking.

2

0 - Disable

1 - Exclusive locks

2 - Shared and exclusive locks

MAXIMUM_FILE_LOCKS_PER_CONNECTION

1000

This value is hard coded. Modifying the value has no effect.

3.4.4 Logs for NCP Server Events

Table 3-5 Server Parameter Information for Logging NCP Server Events

Parameter Name and Description

Default Value

Value Options

LOG_LEVEL

Controls the nature and types of messages that are logged to the /var/opt/novell/log/ncpserv.log file.

WARN

Each level logs entries for its level and the levels above it.

  • NOTHING
  • ERROR
  • WARNING
  • INFO
  • DEBUG
  • ALL

LOG_CACHE_STATISTICS

Controls whether cache statistics are logged in the ncpserv.log file.

0

0 - Disable

1 - Enable

LOG_IDBROKER_ERRORS

Controls whether ID broker errors are logged in the ncpserv.log file.

0

0 - Disable

1 - Enable

LOG_MAXIMUM_FILE_SIZE

This parameter is used to control the maximum size of the ncpserv.log file in bytes. The default is 4 MB.

4000000

Maximum file size in bytes.

LOG_MEMORY_STATISTICS

Controls whether memory statistics are logged in the ncpserv.log file.

0

0 - Disable

1 - Enable

LOG_TIMESTAMPS

Enables or disables timestamps for each message. With this parameter turned on, a timestamp is appended to each message.

1

0 - Disable

1 - Enable

3.4.5 NCP Communications

Table 3-6 Server Parameter Information for Communications

Parameter Name and Description

Default Value

Value Options

FIRST_WATCHDOG_PACKET

Controls how long to wait in minutes of inactivity before checking to see if an NCP connection is still alive.

0

0 - Disable

1-120(minutes) - Enable

DISABLE_BROADCAST

Controls the ability to broadcast messages from the NCP Server.

0

0 - Disable

1 - Enable

3.4.6 NCP Server Environment

Table 3-7 Server Parameter Information for the NCP Server Environment

Parameter Name and Description

Default Value

Value Options

ALLOW_UTF8

Controls UTF-8 support for file names. When ALLOW_UTF8 is enabled, you must also enable UTF8 support in the Novell Client. If you want the server to support clients from different locales (code pages) and allow them to share files, you must use the UTF-8 NCPs.

1

0 - Disable

1 - Enable

LOCAL_CODE_PAGE

Controls which base code page is used by the NCP Server.

CP437

Valid language codes

NCP_FILE_SERVER_NAME

This parameter is set by eDirectory when the NCP Server is installed, and must not be modified arbitrarily.

For information, see Section 3.12, Modifying the NCP File Server Name.

Server hostname

This setting must match the server hostname, such as server1.

3.4.7 NCP Volumes

Table 3-8 Server Parameter Information for Volume and File Management

Parameter Name and Description

Default Value

Value Options

COMMIT_FILE

0

0 - Disable

1 - Enable

EXECUTE_ATTRIBUTE_SUPPORT

1

0 - Disable

1 - Enable

KEEP_NSS_FILE_DELETOR_IDS

1

0 - Disable

1 - Enable

SENDFILE_SUPPORT

0

0 - Disable

1 - Enable

SYNC_TRUSTEES_TO_NSS_AT_VOLUME_MOUNT

Controls trustee resynchronization for an NSS volume when it is mounted for NCP.

0

0 - Disable

1 - Enable

VOLUME_GONE_WARN_USERS

Controls whether a message is broadcast to warn users when the volume path is no longer present.

1

0 - Disable

1 - Enable

3.4.8 NCP Volumes Low-Space Warning

Table 3-9 Server Parameter Information for Volume Low-Space Warning

Parameter Name and Description

Default Value

Value Options

VOLUME_EMPTY_WARN_USERS

Controls whether a message is broadcast to warn users when no volume space is available.

1

0 - Disable

1 - Enable

VOLUME_LOW_WARN_USERS

Controls whether a message is broadcast to warn users when volume space is low.

1

0 - Disable

1 - Enable

VOLUME_LOW_WARNING_RESET_THRESHOLD

Sets the high watermark threshold (in MB), which is the level where the low watermark threshold is reset, and users no longer receive the low-space message.

128

0 to 100000

VOLUME_LOW_WARNING_THRESHOLD

Sets the low watermark threshold (in MB) that indicates space is low.

64

0 to 100000