Skip to main content

Installation

After downloading the installer file, the installation process can be started by double-clicking on the MooseFS-Pro-Windows-Client-Installer-*.exe file. During the installation process, you will be asked to set the necessary parameters:

  • MFS master host
    Specify the host name of the MooseFS Master Server. Required field.

  • MFS master port
    Specify the port of the MooseFS Master Server (default: 9421). Required field.

  • Mount point (eg. M:)
    Specify the drive letter at which MooseFS cluster will be mounted. Ensure that the specified letter is not in use (no other hard disk drives or network services are mounted using the selected drive letter). Required field.

  • Master password
    Specify the password defined in the mfsexports.cfg file on the Master Server. If the MooseFS Master Server does not use password authentication, leave this field empty.

  • Master path (eg. /)
    Specify which MooseFS subdirectory should be mounted. The default is /, which is the root folder of the entire cluster. This option is equivalent to mfsmount -o mfssubfolder=PATH (or -S PATH) Linux command.

Then, select which user maping mode will be used.

Static user mapping mode​

In this mode each client call uses the same user ID and grop ID independently of the logged in Windows user. This is a good choice in environments without an Active Directory configuration.

Example:

alt text

LDAP/AD user mapping mode​

This mode allows access to the cluster resources to be managed based on LDAP/AD to UID and GUID user mapping.

  • LDAP host
    LDAP/AD host address. Required field.

  • LDAP port
    LDAP/AD host port number. Required field.

  • LDAP base DN
    Distinguished Name base. For example: dc=moosefs,dc=lan.

  • LDAP user DN
    Active Directory user name, which has privileges to query AD.

  • LDAP user password
    Active Directory user password.

If the Windows® machine is connected to Active Directory, all the fields apart from LDAP host and LDAP port can be left blank, as in this case system configuration will be used for the rest of LDAP parameters. Also, user credentials will be set based on currently logged in user.

alt text

Additional installer options​

By default, the installer displays the user interface and all prompts. It is possible to run the installer without user interface and prompts. To run the installation in quiet (unattended) mode, run MooseFS-Pro-Windows-Client-Installer-*.exe /quiet in a command prompt with Administrator privileges.

Quiet installation does not set Windows® registry values, so this step must be done manually before installation.

All available options for the installer are listed below:

  • /install – the default action of the installer
  • /uninstall – removes the installed package
  • /layout – creates a complete local copy of the package in the directory
  • /passive – displays minimal UI without prompts
  • /quiet – displays no UI and no prompts
  • /norestart – suppresses any attempts to restart. By default the UI will prompt before restarting.

Registry file example​

This is moosefs.reg example file with user mapping set to LDAP:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\MooseFS]
"READ_CACHE_MB"=dword:00000064
"MASTER_HOST"="mfsmaster.mfs.lan"
"MASTER_PORT"="9421"
"MOUNT_POINT"="M:"
"MASTER_PASSWORD"=""
"MASTER_PATH"="/"
"UID2SID"="LDAP"
"LDAP_HOST"="dc1.mfs.lan"
"LDAP_PORT"=dword:00000185
"LDAP_BASE_DN"=""
"LDAP_USER_DN"=""
"LDAP_USER_PASS"=""

File locations​

After installation the following files are present in the system:

MooseFS Windows® Client files:

  • C:\Program Files\MooseFS
    • dokan2.dll – Dokan user mode library
    • mfsmanager.exe – MooseFS Windows® Client Manager
    • mfssrv.exe – MooseFS Windows® Client Service

Dokan files:

  • C:\Windows\System32
    • dokan2.dll – Dokan user mode library
    • dokannp2.dll – Dokan Network Provider
    • dokanfuse2.dll – Dokan FUSE library
    • drivers\dokan2.sys – Dokan File System Driver