- 1 Maintainer
- 2 Version
- 3 Description
- 4 Requirement
- 5 Installation
- 6 Additional options
- 7 Locale settings
- 8 Integration with LemonLDAP::NG
- 9 Office file preview and indexation
- 10 Uninstall
- 11 Source
- 12 Bugs
- 13 Installing Pydio 6 in an ibay on v9 from source
available on Firewall service repo.
Pydio is a web based file manager, formerly known as AjaXplorer. You can take a look at the online demo (use demo as login and password). This contrib integrate Pydio with the SharedFolders contrib. If Pydio is installed, you'll see a new option in the configuration of shared folders asking you if you want to enable access to this shared folders through Pydio.
This contrib has been developped and tested on SME Server 8 and later. It probably won't work on SME 7.
Configure Firewall-Services's and EPEL repositories:
db yum_repositories set fws repository \ BaseURL http://repo.firewall-services.com/centos/\$releasever \ EnableGroups no GPGCheck yes \ Name "Firewall Services" \ GPGKey http://repo.firewall-services.com/RPM-GPG-KEY \ Visible no status disabled
db yum_repositories set fws-testing repository \ BaseURL http://repo.firewall-services.com/centos-testing/\$releasever \ EnableGroups no GPGCheck yes \ Name "Firewall Services Testing" \ GPGKey http://repo.firewall-services.com/RPM-GPG-KEY \ Visible no status disabled
/sbin/e-smith/db yum_repositories set epel repository \ Name 'Epel' \ BaseURL 'http://download.fedoraproject.org/pub/epel/$releasever/$basearch' \ MirrorList 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-$releasever&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
- install the rpms
yum --enablerepo=fws --enablerepo=epel --enablerepo=smecontribs install smeserver-pydio
- Restart the services
Now you should go in the server-manager, and modify an existing share (or create a new one), with Pydio access enabled. Then, you can access the application using this URL: https://your-server.domain.tld/pydio Each user will only see shares to which they have access. Permissions set through the server-manager will apply on Pydio (same as samba)
Some settings are available from the DB, in the pydio entry
- AdminInterface: activate the setting interface that is disabled by default. 'enabled' to activate. You will then have to edit the /var/lib/pydio/plugins/auth.serial/admin/rights.ser file to change the "ajxp.admin";b:0 to"ajxp.admin";b:1 ( or any user you want to access).Be careful changes done with the setting panel might be erased by sme events ( unless using ManualConf enabled)
- ManualConf: if set to enabled will avoid to update configuration. usefull if you want to handle yourself the settings. However you won't have new share folder integrated in your configuration.
- Authentication: Control the way users are authenticated. Correct values are http (apache protects the access, users need to login with their own credentials), or LemonLDAP which uses LemonLDAP-NG to grant access to the application
- AliasOnPrimary: can be enabled or disabled (default is enabled). This prop lets you disable the access to Pydio on your primary domain (the alias /pydio won't be added in apache configuration). This is useful if you want the application to be available only with a virtualhost.
- access: can be public or private (default is private). Control if /pydio is available only from local networks or from the Internet.
- Title: Will be used as the title of the web page (default is Ajaxplorer)
- WelcomMessage: Can be set to a message which will be displayed while the application is loading
- DefaultLanguage: With this prop, you can set the default language for all users (you can see the list of valid languages in /usr/share/pydio/client/i18n/)
- MaxUploadSize: Restrict the file size which can be uploaded (default is 200M)
- PublicShares: can be enabled or disabled (default is enabled). Control if users can share individual files publicly (with or without a password)
- LogoutURL: redirect users to any page you want when they click on disconnect.
- Metastore: can be serial or xattr (default is serial): control the way metedata are stored. With serial, metadata are stored in PHP serialized files in /var/lib/pydio/plugins/metastore.serial/. It'll always work, but the problem is that if you move or rename a file through samba, the metadata will be lost (because Pydio can't notice this). This won't happen if you set this to xattr, because metadata will be stored on the filesystem, using extended user xattr. For this to work, you have to mount your filesystem where shared folders are stored with the user_xattr option
- Indexer: can be enabled or disabled (default is disabled): control the indexer process globally. If disabled, only the shares which explicitly have PydioIndexer enabled will be indexed. If enabled, all the shares, except those which have PydioIndexer disabled will be indexed.
db configuration setprop pydio access public Title 'My own web based file manager' WelcomMessage 'Powered by SME Server' DefaultLanguage fr MaxUploadSize 500M signal-event webapps-update
Some settings are also available on a per shared folder basis:
- PydioIndexer: can be enabled or disabled (default is enabled): control if the content of this share will be indexed each night by Pydio (so you can then search for key word, Pydio will provide very fast result and can also index some file content). The indexation can be resource intensive (especially if you install smeserver-ooo-headless, see below), so if you're not interested, you can disable it for a few shares.
- PydioIndexContent can be enabled or disabled, and is ignored if this share is not indexed. If enabled, the content of the files will be extracted and indexed (txt, html, PDF, even Office documents if smeserver-ooo is available). Indexing content can be time consuming. If disabled, index will only be built on the names of the files and directories.
- PydioHistory: can be enabled or disabled (default is disabled), this should only be turned on on a newly created share. If enabled, git will be used on the shared folder to track each modification. Each revision will be browseable, and you can revert every change you want. If you enable this, you should not enable other access to this shared folder (samba or webdav) as only access through Pydio will handle commits on file modification. You should also be aware that GIT is not very scalable for huge file. For example, you shouldn't enable this option if you store big multimedia files
- user's home access
If you want your users can access to their home with Pydio (only in read only mode)
db configuration setprop pydio HomeDir enabled signal-event webapps-update
in case of problem with your locale (XML problem) you can tweak the file /etc/pydio/bootstrap_conf.php and add your locale. By default the sme server locale is ISO-8859-1
for example this is what you need to add for French language
Integration with LemonLDAP::NG
Pydio can be protected by LemonLDAP::NG. Here're the steps to protect it
Disable the access on the primary domain
You should disable the access to Pydio on your primary domain:
db configuration setprop pydio AliasOnPrimary disabled signal-event webapps-update
Enable LemonLDAP::NG integration
This contrib support LemonLDAP NG auth quite easily:
db configuration setprop pydio Authentication LemonLDAP signal-event webapps-update
Create a new virtualhost for Pydio
Lets create a new virtualhost for Pydio. You can choose the name you want, for example, lets create exchange.domain.tld:
db domains set exchange.$(db configuration get DomainName) domain Content Primary Description 'Pydio' \ DocumentRoot /usr/share/pydio Nameservers internet TemplatePath WebAppVirtualHost \ LemonLDAP enabled signal-event domain-create exchange.$(db configuration get DomainName) signal-event webapps-update
Declare this virtualhost in LemonLDAP
You can now create the virtualhost in LemonLDAP management interface. You can create the rules you want. For example, here're the rules to accept only members of the group 'webexchange'
- Comment: default
- Rule: $groups =~ /\bwebexchange\b/
Office file preview and indexation
You can generate previews for office documents (doc, docx, xls, xlsx, ppt, pptx, odt, ods, odp etc...) in Pydio, and even index their content. For this to work, you need to install OpenOffice on your server in headless mode. This will install a lot of dependancies, so it's not installed automatically. If you want to add support for this, just run the below code. The DAG repository has to be available to resolve dependencies. See Dag.
yum --enablerepo=fws --enablerepo=dag install smeserver-ooo-headless signal-event webapps-update sv u /service/ooo
If you want to remove the contrib, just run:
yum remove pydio
|ID||Product||Version||Status||Summary (4 tasks)|
|11011||SME Contribs||9.3||UNCONFIRMED||Pydio still shows on server manager after uninstall|
|10592||SME Contribs||9.2||UNCONFIRMED||Accessing Pydio failes with "500 Internal Server Error"|
|10530||SME Contribs||9.2||CONFIRMED||mcrypt_encrypt(): Key of size 6 not supported by this algorithm|
|8191||SME Contribs||8.0||UNCONFIRMED||error in yum log while isntalling|
Installing Pydio 6 in an ibay on v9 from source
Go to http://sourceforge.net/projects/ajaxplorer/files/pydio/stable-channel/6.0.7/ and download pydio-core-6.0.7.tar.gz
I use 7zip to untar the file and then scp to copy the files into an ibay.
I created an ibay named pydio
chown -R admin:www /home/e-smith/files/ibays/pydio/html
Change the access on data and its subdirectories to 775
db accounts setprop pydio \ AllowOverride All \ FollowSymLinks enabled \ Group www \ PHPBaseDir /home/e-smith/files/ibays/pydio/html/:/tmp/ \ PublicAccess global \ UserAccess wr-group-rd-everyone
signal-event ibay-modify pydio
/sbin/e-smith/db yum_repositories set rpmforge repository \ Name 'Dag - EL6' \ BaseURL 'http://apt.sw.be/redhat/el6/en/$basearch/dag' \ EnableGroups no \ GPGCheck yes \ GPGKey http://dag.wieers.com/packages/RPM-GPG-KEY.dag.txt \ Visible no \ Exclude freetype,htop,iptraf,rsync,syslinux \ status disabled
/sbin/e-smith/db yum_repositories set epel repository \ Name 'Epel - EL6' \ BaseUrl 'http://download.fedoraproject.org/pub/epel/6/$basearch' \ MirrorList 'http://mirrors.fedoraproject.org/mirrorlist?repo=epel-6&arch=$basearch' \ EnableGroups no \ GPGCheck yes \ GPGKey http://dl.fedoraproject.org/pub/epel/RPM-GPG-KEY-EPEL \ Visible no \ status disabled
yum --enablerepo=epel install php-mcrypt
Create a mysql DB for Pydio
Log into the server as root using putty. Issue the following commands changing the values to suit you needs.
- mysqladmin create (database name)
mysql> grant all on pydio.* to pydioadmin@localhost identified by '(password)'; mysql> flush privileges; mysql> \q
Open /home/e-smith/files/ibays/pydio/html/conf/bootstrap_conf.php and change line 43 to define("AJXP_TMP_DIR", AJXP_DATA_PATH."/tmp");
At this stage if you go to https://ip of server/pydio you should still see the following error "Server charset encoding warning" it is now fine to proceed with the install by clicking the link "click here to continue to Pydio."
Follow the instructions in the wizard to set up pydio.