content:en_us:6_owncloud

ownCloud

ownCloud for ClearOS provides an enterprise-grade file sync and share solution that is easy to use an consumer-grade products, but is integrated right into ClearOS. ClearOS and ownCloud allow you to deliver file sharing services that conform to your data security and compliance policies. Your employees will love ownCloud’s clean, professional user interfaces; you’ll enjoy peace of mind, knowing that your data is under IT control at all times.

This document provides instructions for the ClearOS integration, further more detailed ownCloud documentation including users and administrators manuals can be found here.

Installation

If your system does not have this app available, you can install it via the Marketplace.

You can find this feature in the menu system at the following location:

Server > File > ownCloud for Home

Configuration

The ownCloud app interface is provided by the webserver running on ClearOS, and can be accessed directly via the link found on the app page. Once you have installed the app, the LDAP configuration and backend is tied in with the webconfig user interface. To get yourself up and running create or edit an existing user

Go to System > Accounts > Users, create or edit an existing user and enable 'ownCloud' access from the dropdown menu. Access is granted on a per user basis and permits the configuration of per-user quotas

You can then navigate with your browser to https://yourdomain.com/owncloud and login with your users credentials. These credentials can also be used for your mobile apps, desktop etc to obtain access to your private cloud!. The web interface allows you to share files to specific local users on the ClearOS system, to local groups defined within the webconfig, or to external users with email addresses. These shares can be limited to specific time periods, with or without passwords!

The web interface provides your user with various links to the mobile or desktop apps that are available for Apple, Android, Windows etc. For external access to your cloud please make sure you webserver can be reached remotely and you have opened TCP ports 80(HTTP) or 443(HTTPS)

For those that like to get to grips with the configuration files, you can find the ownCloud configuration at /usr/share/owncloud/config/config.php. It is possible to restrict the domain access to one or a list of specific domains - this may be useful if your webserver hosts several virtual domains. This can be acheived by editing 'trusted_domains'

Administration

ownCloud is integrated into the ClearOS LDAP system and so primarily user configuration should be carried out through the ClearOS webconfig interface. There is also a special 'administrator' user setup on install who is able to extent or otherwise configure ownCloud through the ownCloud interface. This special user exists on within ownCloud and is setup with the username admin on first install. Please make sure you change the default password.

3rd-Party Apps

ownCloud comes with built in support for file sync, WebDAV access, external mount points, contacts, calendar, file revisions, deleted files, PDF viewer, photo and video viewer and basic document editing. Additional 3rd party apps are available and can be installed by using the ownCloud admin interface. Login with the 'admin' user, select 'admin' menu on the top right hand side, then select the '+Apps' button at the bottom left hand side.

Apps include:- bookmarks, encryption, external sites, tasks, news, notes and many more available from http://apps.owncloud.com

Storage location

The initial storage location is within the standard ClearOS data structure located at /var/clearos/owncloud/data, but could easily be moved elsewhere to a drive or mount point with more storage space for example.

If the default location is not suitable you can directly modify the path at /usr/share/owncloud/config/config.php - but first remember to copy the directory structure including the hidden '.ocdata' file to your new location. It is also possible to use the Storage Manager app to 'mound –bind' your data to a central storage position. In a future version of the app this will hopefully be automated through the webconfig.

The storage location is deliberately separate from the main ownCloud folder so that the app can be completely removed and reinstalled without losing any data. The storage location can be easily migrated from one location to another or between server if required (assuming they both authenticate to the same LDAP server, e.g. in a master/slave scenario).
It is also possible to add additional data your users mount points by mounting 'external' data storages. This could be a local NAS sever, Samba share, Flexshare, FTP server or even another Dropbox or Google Drive account. This can be configured through the ownCloud interface admin. Please note that the 'apache' web server user must be given read access to the folder to access the files.

Known Issues

The administrator user will be warned that the PHP version is outdated and will recommend at least version v5.3.8. ClearOS default PHP version is 5.3.3 with backported security fixes. This warning is cosmetic only and is not known to impact on the behaviour or performance of the app. ClearOS 7 will contain a newer verison of PHP

Please note that the ClearOS LDAP configuration is used by ownCloud to authenticate, but ownCloud does not modify the LDAP database in any way. Therefore the Quota settings whilst visible in the ownCloud interface cannot be administered here for LDAP users.

If you have an existing ownCloud custom installation please confider backing it up and removing it prior to installing this app. The ownCloud RPM is specifically built to be compatible with ClearOS and the app will install and auto configure ownCloud to use the data in the standard ClearOS places, and will also create a database within ClearOS System MySQL. This will likely trample over any existing setup and therefore it is recommend you remove it prior to installing. The cloud data can then be migrated afterwards to /var/clearos/owncloud/data

Help

content/en_us/6_owncloud.txt · Last modified: 2015/08/11 14:32 (external edit)