Document new libsmbclient-php for external smb storages

[ghost]

SMB external storage now based on libsmbclient (owncloud/core#10673)

from https://github.com/owncloud/core/wiki/ownCloud-8.1-Features

In the linked PR the following is stated:

New SMB storage backend based on https://github.com/icewind1991/SMB which supports either wrapping smbclient or use libsmbclient directly trough libsmbclient-php.

Currently the only place where libsmbclient/php5-libsmbclient is noticed is for the EE:

https://doc.owncloud.org/server/8.1/admin_manual/release_notes.html#windows-network-drive
https://doc.owncloud.org/server/8.1/admin_manual/enterprise_external_storage/windows-network-drive_configuration.html

[ghost]

On Debian/Ubuntu for example libsmbclient-php is not available. Only:

http://packages.ubuntu.com/search?keywords=php-smb
https://packages.debian.org/search?keywords=php-smb

which are both depending on a non-available package "php5-smbclient".

I think thats really something what should be clarified.

[RobinMcCorkell]

Note: we do not need the php-smb package, that's a version of @icewind1991 's 'SMB' project, which is included in the ownCloud source tree. We just need the mystery 'php5-smbclient'

[ghost]

Thanks for the clarification. I just had a short search on the net and found the OBS repositories where it seems the php5-smbclient was/is included in the oC 7 repositories:

http://download.opensuse.org/repositories/isv:/ownCloud:/community:/7.0/xUbuntu_14.10/
http://download.opensuse.org/repositories/isv:/ownCloud:/community:/7.0/Debian_7.0/

but is now missing in 8.1:

http://download.opensuse.org/repositories/isv:/ownCloud:/community:/8.1/xUbuntu_14.10/
http://download.opensuse.org/repositories/isv:/ownCloud:/community:/8.1/Debian_7.0/

Edit

According to: owncloud/core#13022 the php5-smbclient is only packaged for the EE and not for the CE in oC 7.

[ghost]

Created packaging request for php5-smbclient in owncloud/core#18152

Additionally some places where only smbclient is mentioned:

https://github.com/owncloud/documentation/blob/master/admin_manual/installation/source_installation.rst
https://github.com/owncloud/documentation/blob/master/admin_manual/configuration_files/external_storage_configuration_gui.rst
https://github.com/owncloud/documentation/blob/master/admin_manual/configuration_files/external_storage_configuration.rst

[jnweiger]

php5-libsmbclient is now available from the 8.1 Linux repositories too. Here are the install instructions: https://software.opensuse.org/download.html?project=isv%3AownCloud%3Acommunity%3A8.1&package=php5-libsmbclient

[carlaschroder]

Ok then, to be totally awesomely perfectly crystal clear: php5-libsmbclient, which is special oC secret sauce (ok, not very secret) is required for SMB external storage? And not standard distro packages like smbclient or libsmbclient?

@RealRancor @Xenopathic @jnweiger

[RobinMcCorkell]

@carlaschroder Correct. php5-libsmbclient (or variations thereof, another common name is libsmbclient-php) provides the PHP module that ownCloud can use to directly interface with the libsmbclient code. The alternative, which is still supported, is to use the smbclient binary to connect, but this has obvious performance and reliability drawbacks compared to the native library.

[carlaschroder]

Excellent. Thanks @Xenopathic

[mickg10]

Note that the packages referenced above do not work for 32-bit versions of linux that a good many people run.

[ghost]

@mickg10 Maybe report this to the core tracker to get it fixed?

[carlaschroder]

It's php5-libsmbclient for all distros. See http://download.opensuse.org/repositories/isv:/ownCloud:/community:/8.1/

[jnweiger]

@mickg10 here is the list of Platforms for which we build php5-libsmbclient. 32bit are there too.
https://build.opensuse.org/package/show/isv:ownCloud:community:8.1/php5-libsmbclient

[carlaschroder]

master: 6e446e4
stable8.1: c69675a

[carlaschroder]

I think you can close this, @RealRancor. If the docs need further tweaking please open a new issue.

[adrianoafonso]

Hello there
@carlaschroder I can't install php5-libsmbclient on my raspberry pi 1. Is it available for this platform?

I tried:

echo 'deb http://download.opensuse.org/repositories/isv:/ownCloud:/community:/8.1/Debian_7.0/ /' >> /etc/apt/sources.list.d/php5-libsmbclient.list
wget http://download.opensuse.org/repositories/isv:ownCloud:community:8.1/Debian_7.0/Release.key
apt-key add - < Release.key

apt-get update
apt-get install php5-libsmbclient

And also with this repository:

deb http://download.opensuse.org/repositories/isv:/ownCloud:/community/Debian_7.0/ /

[RobinMcCorkell]

@adrianoafonso The binary packages in the repositories are only for x86 and x86_64, not armv6h. You will need to compile it yourself.

[jnweiger]

@adrianoafonso raspberry pi is an armv7 platform. php5-libsmbclient is architecture-dependant. We only build for i386 and x86_64 here. Sorry.,

Just because I am curious, I enabled an armv7l build. It works for Ubuntu_14.04, but fails for Debian7. Maybe that works for you?

If some raspberry enthusiast wants to investigate, here is a starting point:
https://build.opensuse.org/project/monitor?utf8=%E2%9C%93&commit=Filter%3A&succeeded=1&failed=1&unresolvable=1&broken=1&blocked=1&dispatching=1&scheduled=1&building=1&finished=1&signing=1&locked=1&deleting=1&pkgname=&repo_CentOS-CentOS_6=1&repo_CentOS-CentOS_7=1&repo_CentOS_6=1&repo_CentOS_6_PHP54=1&repo_CentOS_6_PHP55=1&repo_CentOS_6_PHP56=1&repo_CentOS_7=1&repo_Debian_7_0=1&repo_Debian_8_0=1&repo_Fedora_20=1&repo_Fedora_21=1&repo_SLE_12=1&repo_SLE_12_GA=1&repo_openSUSE_13_1=1&repo_openSUSE_13_2=1&repo_openSUSE_Leap_42_1=1&repo_openSUSE_Tumbleweed=1&repo_xUbuntu_12_04=1&repo_xUbuntu_14_04=1&repo_xUbuntu_14_10=1&repo_xUbuntu_15_04=1&repo_xUbuntu_15_10=1&arch_armv6l=1&arch_armv7l=1&project=isv%3AownCloud%3Acommunity%3A8.1&defaults=0

[RobinMcCorkell]

@jnweiger Raspberry Pi 1 is an armv6h board, not armv7l 😞

[jnweiger]

right. armv6l added too. Let's see.

[adrianoafonso]

Thanks for the answers @Xenopathic and @jnweiger!
That's as enlighten me!
I hope that could be solved, believe me, that are many people accessing this http://www.adrianoafonso.net/blog/2014/criar-um-servidor-owncloud-debian/ using rasps 1 and 2.

[adrianoafonso]

Hello there again.
Just reporting that I updated today:

Start-Date: 2016-06-23  10:58:42
Commandline: apt-get upgrade
Upgrade: php5-libsmbclient:amd64 (0.5.0-9.1, 0.5.0-9.2), libxslt1.1:amd64 (1.1.28-2+b2, 1.1.28-2+deb8u1)
End-Date: 2016-06-23  10:58:46

And any of the CIFS shares that I had configured broke down.
Trying to rollback php5-libsmbclient 0.5.0-9.1.

[ghost]

@adrianoafonso The issue tracker here is used for issues / requests for the documentation. :-)