SMB Mount Manager

As an alternative to the SMB connection via Java (uses SMBv2), the SMB mount manager is available, which provides a higher performance and additionally supports SMBv3. Note: Siehe auch How to detect, enable and disable SMBv1, SMBv2, and SMBv3 in Windows and Windows Server.

The SMB Mount Manager mounts SMB shares as network drives (mount points) via the operating system.

Alternatively, it can also work with internal symlinks (see properties windows.useShareMount and baseMountPoint).

When the SMB Mount Manager is activated, all previous entries in SMB channels, SMB Inbound Agents, and SMB Response Routes can (and must) be retained. The only difference is that Lobster_data handles the connection of the external drives at operating system level.

Configuration

The following entry must be set in configuration file ./etc/startup.xml.


<!-- use internal smb mount manager, default is false -->
<Set name="enableMountManager">true</Set>


In addition, the file ./etc/admin/datawizard/smbmount.properties must be present and configured. Note: See also section Structure of a Properties File.


#File has to be in <_dataInstallDir>/etc/admin/datawizard
#
# Basic smb mount manager config file
#
#
# for windows system, define the available driver letters
windows.drives=GHIJKLMNOPQRSTUVWXY
#
#
# for windows system, use drive letters or shared folder
windows.useShareMount=true
 
# for not windows systems: define a base mount point where all shares are mounted underneith
# for windows systems with windows.useShareMount=true: define a folder where all symlinks to the shares are created
baseMountPoint=./mnt
#
#
# mount commands for each supported OS
#
 
# unix/linux
unix.mount=/bin/mount -t cifs -o user={USER},domain={DOMAIN},password={PASSWORD} //{SERVER}/{SHARE} {MOUNTPOINT}
unix.umount=/bin/umount {MOUNTPOINT}
 
# mac os x
mac.mount=/sbin/mount_smbfs //{DOMAIN};{USER}:{PASSWORD}@{SERVER}/{SHARE} {MOUNTPOINT}
mac.umount=/sbin/umount {MOUNTPOINT}
 
# windows
windows.mount=C:\\Windows\\system32\\net.exe use {MOUNTPOINT} \\\\{SERVER}\\{SHARE} /user:{DOMAIN}\\{USER} \"{PASSWORD}\"
windows.umount=C:\\Windows\\system32\\net.exe use {MOUNTPOINT} /DELETE
 
# others /unknown
other.mount=please define a command here!
other.umount=please define an umount command here!


Important note: The placeholders in curly brackets are automatically populated by the entries in SMB channels, Input Agents File and Response Routes File. You do not have to replace any of the placeholders.


Property

Description

windows.drives=EFGHIJKLMNOPQRSTUVWXYZ

The available Windows drive letters. You may need to make an adjustment here if certain drive letters are already in use on your system.

windows.useShareMount

If false, 'normal' network drives are use.

Falls true, the integration takes place via symlinks. This can circumvent the use of normal network drives and thus the limitation of the limited number of (drive) letters. Property baseMountPoint is used to specify the folder in which the symlinks are placed. Important note: You have to set key EnableLUA to 0x0 in the Windows Registry (execute regedit in the Windows console). You will find the key under HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Policies\System.

baseMountPoint=./mnt

For UNIX and MacOS systems, the base mount point name can be specified. Default: ./mnt

This property is also used for symlinks under Windows (see property windows.useShareMount).

windows.mount
windows.umount

Mounting and unmounting SMB shares under Windows. Note: The entries in the configuration file can be used in exactly the same way.

unix.mount
unix.umount

Mounting and unmounting SMB shares under Unix/Linux. Note: The entries in the configuration file can be used in exactly the same way.

mac.mount
mac.umount

Mounting and unmounting SMB shares under Mac. Note: The entries in the configuration file can be used in exactly the same way.