Difference between revisions of "Wsdd"

From SME Server
Jump to navigationJump to search
Line 1: Line 1:
 +
{{Needs review}}
 +
{{Level|Developer}}
 
{{Languages}}
 
{{Languages}}
 +
 
===Maintainer===
 
===Maintainer===
 
[mailto:jcrisp@safeandsoundit.co.uk [[User:ReetP|Jonn C.]]] from [ https://www.reetspetit.com/  
 
[mailto:jcrisp@safeandsoundit.co.uk [[User:ReetP|Jonn C.]]] from [ https://www.reetspetit.com/  
Line 68: Line 71:
 
# User=wsdd
 
# User=wsdd
 
# Group=wsdd
 
# Group=wsdd
 +
 +
[[Category:Contrib]]
 +
[[Category:Howto]]
 +
[[Category:Security]]
 +
[[Category: Administration:Certificates]]

Revision as of 12:48, 27 November 2020

Edit-find-replace.png Not reviewed:
This howto or contrib has not been reviewed and might contain code that could harm your installation. For more information on the review process have a look at the Development Review page.


PythonIcon.png Skill level: Developer
Risk of inconsistencies with Koozali SME Server methodology, upgrades & functionality is high. One must be knowledgeable about how changes impact their Koozali SME Server. Significant risk of irreversible harm.



Maintainer

Jonn C. from [ https://www.reetspetit.com/

Version

Contrib 10:
smeserver-wsdd
The latest version of smeserver-wsdd is available in the SME repository, click on the version number(s) for more information.


Description

wsdd implements a Web Service Discovery host daemon. This enables (Samba) hosts, like your local server device, to be found by Web Service Discovery Clients like Windows.

It also implements the client side of the discovery protocol which allows to search for Windows machines and other devices implementing WSD. This mode of operation is called discovery mode.

Purpose

Since NetBIOS discovery is not supported by Windows anymore, wsdd makes hosts to appear in Windows again using the Web Service Discovery method. This is beneficial for devices running Samba, like NAS or file sharing servers on your local network. The discovery mode searches for other WSD servers in the local subnet.

Background

With Windows 10 version 1511, support for SMBv1 and thus NetBIOS device discovery was disabled by default. Depending on the actual edition, later versions of Windows starting from version 1709 ("Fall Creators Update") do not allow the installation of the SMBv1 client anymore. This causes hosts running Samba not to be listed in the Explorer's "Network (Neighborhood)" views. While there is no connectivity problem and Samba will still run fine, users might want to have their Samba hosts to be listed by Windows automatically.

You may ask: What about Samba itself, shouldn't this functionality be included in Samba!? Yes, maybe. However, using Samba as file sharing service is still possible even if the host running Samba is not listed in the Network Neighborhood. You can still connect using the host name (given that name resolution works) or IP address. So you can have network drives and use shared folders as well. In addition, there is a patch lurking around in the Samba bug tracker since 2015. So it may happen that this feature gets integrated into Samba at some time in the future.

Installation

Add EPEL repo

/sbin/e-smith/db yum_repositories set epel repository \
Name 'Epel - EL7' \
BaseURL 'http://download.fedoraproject.org/pub/epel/7/$basearch' \
MirrorList 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-7&arch=$basearch' \
EnableGroups no \
GPGCheck yes \
GPGKey http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL \
Exclude perl-Razor-Agent \
Visible no \
status disabled
signal-event yum-modify

yum install smeserver-wsdd-0.1-2.noarch.rpm --enablerepo = epel,smecontribs

Signal-event reboot - the rpm now does systemctl enable wsdd

Usage

[root@sme10 ~]# config show wsdd

wsdd=service
    TCPPorts=3702,5357
    UDPPort=3702
    access=private
    status=enabled
  1. systemctl status wsdd
  2. systemctl enable wsdd
  3. systemctl start wsdd
  4. systemctl restart wsdd
  5. systemctl disable wsdd

/usr/lib/systemd/system/wsdd.service [Unit] Description=Web Services Dynamic Discovery host daemon After=network-online.target After=bootstrap-console.service Wants=network-online.target

  1. Wants=smb.service

[Service] Type=simple ExecStart=/usr/bin/wsdd 4 -i eth0 -w TF_SL --shortlog ExecStartPre=/bin/sleep 30

  1. User=wsdd
  2. Group=wsdd