Webshare

From SME Server
Jump to navigation Jump to search


Webshare for SME Server

Maintainer

Darrel May (Contrib)

Description

  • Webshare is an addon for SME Server that provides secure web accessible file and directory storage.
  • Create and set permissions for each share via Server-manager GUI.
  • Can handle many filetypes in the webbrowser.


Step-by-step HowTo for installation of Webshare on a fresh SMEserver 7.x.

Check latest releases at http://mirror.contribs.org/smeserver/releases/7/smecontribs/i386/RPMS/

Installation

1. Log in (with username root) to the SMEserver console.

2. Install smeserver-webshare from the smecontribs repo (which will also install the dependency perl-Apache-Htpasswd)

yum install --enablerepo=smecontribs smeserver-webshare

Note: For sme8 there is a newer compatible rpm, smeserver-webshare-1.0.0-10.el4.sme.noarch.rpm see bugzilla:7621

yum install --enablerepo=smetest smeserver-webshare

You will need to manually enable the old sme7 smetest repo until sme8.x repos are fully populated so your sme8 server can access the compatible package, as follows)

db yum_repositories set sme7test repository \
GPGCheck yes \
MirrorList http://distro.ibiblio.org/pub/linux/distributions/smeserver/mirrorlist/smetest-7 \
Name 'SME 7 - test' \
Visible no \
status disabled
signal-event yum-modify

Wait a minute or two for yum to finish, you can check if yum is still active using

top -i

(Ctrl c to exit) then do

yum clean all

To get the dependency & the sme 8.x compatible package both installed install use this command

yum install smeserver-webshare --enablerepo=sme7test --enablerepo=smecontribs
signal-event post-upgrade; signal-event reboot 


3. Instructions at the end of previous installation advises the following commands:
signal-event post-upgrade and signal-event reboot
but you can skip that (not necessary) and move on.

4. In a web browser login to server-manager as admin.
Under Collaboration there should be a new line named "Webshare". Configure the webshare name, users and passwords.

5. Access the newly created webshare using https://www.yourdomain.com/webshare/websharename Upload and download files as required.


Check installed version

yum info installed smeserver-webshare
yum info installed perl-Apache-Htpasswd

Uninstall

yum remove smeserver-webshare
yum remove perl-Apache-Htpasswd


Adjusting upload file size

Default php settings in sme server will severely limit the file upload size.

These can be adjusted by db commands, see http://wiki.contribs.org/index.php?title=SME_Server:Documentation:Technical_Manual:Booklet#Php

To see the default settings do

config show php

The following commands will set a 50Mb file upload size.

As this includes system overheads, you should specify a value slightly larger than the maximum file size you wish to upload.

db configuration setprop php MaxExecutionTime 3600
db configuration setprop php MemoryLimit 50M
db configuration setprop php PostMaxSize 50M
db configuration setprop php UploadMaxFilesize 50M
expand-template /etc/php.ini
/etc/init.d/httpd-e-smith restart

Using with ibays & SME users

From this Italian forum post http://forums.contribs.org/index.php/topic,46399.msg227523.html#msg227523

are instructions re how to use webshare with an ibay and SME users, so the files/dirs are available also via samba. This allows an ibay to be accessed by the webshare frontend it does not link the standard webshare to the ibay webshare.

Create the custom template and fragment

mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf
cd /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf
pico 86WebSharealias

Contents of 86WebSharealias

{
   my $db       = esmith::ConfigDB->open_ro("WebShare")
   or return "# webshare disabled\n";

   my @webshare = $db->get_all_by_prop( type => 'WebShare' );

   foreach $webshare (@webshare) {
       #name
       my $key = $webshare->key;
       #use  ibay?
       my $useibay = $webshare->prop('UseIbay') || "no";
       #use sme users?
       my $smeusers = $webshare->prop('SmeUsers') || "no";
       $OUT .= "# webshare\/$key\n";

       if ( "$useibay" eq "no" ) {
               $OUT .= "Alias \/webshare\/$key \/opt\/webshare\/$key\n";
               $OUT .= "<Directory \/opt\/webshare\/$key>\n";
       }
       else {
               $OUT .= "Alias \/webshare\/$key \/home\/e-smith\/files\/ibays\/$key\/html\n";
               $OUT .= "<Directory \/home\/e-smith\/files\/ibays\/$key\/html>\n";
       }
       {
           use esmith::util;
           my $release = esmith::util::determineRelease();
           if ( "$release" ge "7.0" ) {
               $OUT .= "    SSLRequireSSL\n";
           }
           else {
               $OUT .= "    RequireSSL on\n";
           }
       }
       $OUT .= "    Options +Indexes\n";
       $OUT .= "    AllowOverride None\n";
       $OUT .= "    order deny,allow\n";
       $OUT .= "    deny from all\n";
       $OUT .= "    allow from all\n";
       $OUT .= "    AuthName \"Restricted $key access only\"\n";
       $OUT .= "    AuthType Basic\n";

       if ( "$smeusers" eq "no" ) {       
               $OUT .= "    AuthUserFile \/home\/e-smith\/db\/webshare\/htpasswd.$key\n";
       }
       else {
               $OUT .= "    AuthExternal pwauth\n";
       }
       $OUT .= "    Require valid-user\n";
       $OUT .= "    AddType application\/x-httpd-php \.php \.php3\n";
       $OUT .= "    php_flag  magic_quotes_gpc  on\n";
       $OUT .= "    php_flag  track_vars        on\n";
       $OUT .= "<\/Directory>\n";
       $OUT .= "\n";
   }
}

Create an ibay in server manager with the name ibaywebsharename, with no password and enable "Execution of dynamic content".

  Note:
ibaywebsharename should be the same as websharename and ibayname


Configure the db setting, expand template & restart service

db WebShare setprop ibaywebsharename UseIbay yes SmeUsers yes
expand-template /etc/httpd/conf/httpd.conf
service httpd-e-smith restart


Copy files from original webshare in /opt to ibay

cd /opt/webshare/ibaywebsharename
cp -a ./* /home/e-smith/files/ibays/ibaywebsharename/html/
cd /home/e-smith/files/ibays/ibaywebsharename/html
rm index.html


  Note:
Previous step is necessary to migrate from old files location to the new one.. it should be not necessary for new webshares not tested


Now Create a link in the /home/e-smith/files/ibays/ibaywebsharename/html dir

mv ./files ./files.old
ln -s ../files

Access the ibay webshare via web browser with this URL (note to use https:)

https://yourdomain.com/ibaywebsharename

Access the ibay webshare files locally via samba network share

\\servername\ibaywebsharename\files

Additional information

special WebShare

to be documented more but reading configuration file you can create a special webshare with user that have right on other webspaces. It seems that to do so you have to create

db WebShare set MultiAccess MultiAccess WebShareName YOURNAME Webshares SHARE2,SHARE3,SHARE5 Users user1:pass1,user2:pass2

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-webshare component or use this link .

Tested software versions

Host: SMEserver v7.1 with update 3 (7.1.3)

Installed: perl-Apache-Htpasswd.noarch 0:1.5.9-1.1.el3.rf

Installed: smeserver-webshare.noarch 0:1.0.0-8dmay