mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 's5-ucs' into stable5

Browse Source
This commit is contained in:
Arthur Schiwon 2013-08-08 09:35:53 +02:00
commit 40abc5608a
3 changed files with 73 additions and 76 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
admin_manual/images/ucs-app-center-install.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 74 KiB

BIN
admin_manual/images/ucs-app-center-module.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 104 KiB

149
admin_manual/installation/installation_ucs.rst
View File

@ -4,46 +4,18 @@ Univention Corporate Server
Subscribers to the ownCloud Enterprise edition can also integrate with
:abbr:`UCS (Univention Corporate Server)`.
Prerequisites
~~~~~~~~~~~~~
The ownCloud integration relies on the MySQL database. Since "PostresSQL"
is more in a experimental state and "SQLite" is not very well suited for
multi-user installations, MySQL is the only way first of all. As of UCS
3.0 MySQL is not part of the maintained repository. Hence you you should
install it first and probably deactivate the unmaintained repository
eventually::
ucr set repository/online/unmaintained="yes"
univention-install mysql-server
ucr set repository/online/unmaintained="no"
.. note:: If MySQL is already installed and/or a password for the user root is set, please make sure it is saved in /etc/mysql.secret, otherwise you will experience problems.
In case you want to install ownCloud from the repository, it is already enough
to enable the unmaintained repository for MySQL. You can skip the rest of this
section and read on at :ref:`preconfig`. ownCloud has further dependencies,
which all belong to the maintained repository. Install them as well::
univention-install php5-mysql php5-ldap php5-gd
The package manager is going to remove **libgd2-noxpm**, which is not a problem
and nothing to worry about.
.. _preconfig:
Pre configuration
^^^^^^^^^^^^^^^^^
ownCloud makes use of the UCR, the Univention Configuration Registry. At
the moment, the values are being read during installation only. So you
might want to change them here, but you can do it later from within
ownCloud. For a later version we plan to provide an own ownCloud module
for the UMC (Univention Management Console). We think we found sane
defaults, nevertheless you might have your own requirements. The
installation script will listen to those UCR keys:In case you want to
override any default setting, simply add the key in question to the UCR
and assign your required value.
ownCloud makes use of the UCR, the Univention Configuration Registry. The values
are being read during installation, most of them can be changed later, too.
Changes done directly via ownCloud are not taken over to UCR. We think we found
sane defaults, nevertheless you might have your own requirements. The
installation script will listen to the UCR keys listed below. In case you want
to override any default setting, simply add the key in question to the UCR and
assign your required value.
.. tabularcolumns:: |l|p{5cm}|p{5cm}|l|
.. cssclass:: longtable
@ -60,17 +32,24 @@ and assign your required value.
"owncloud/ldap/base/groups", "cn=groups,$ldap_base", "The groups-subtree in the LDAP directory. If left blank it will fall back to the LDAP base.", 2012.4.0.4
"owncloud/ldap/groupMemberAssoc", "uniqueMember", "The LDAP attribute showing the group-member relationship. Possible values: uniqueMember, memberUid and member", 2012.4.0.4
"owncloud/ldap/tls", 1, "Whether to talk to the LDAP server via TLS.", 2012.0.1
"owncloud/ldap/disableMainServer", 0, "Deactivates the (first) LDAP Configuration", 5.0.9
"owncloud/ldap/cacheTTL", 600, "Lifetime of the ownCloud LDAP Cache in seconds", 5.0.9
"owncloud/ldap/UUIDAttribute", "(empty)", "Attribute that provides a unique value for each user and group entry. Empty value for autodetection.", 5.0.9
"owncloud/ldap/loginFilter", "(&(\|(&(objectClass=posixAccount) (objectClass=shadowAccount)) (objectClass=univentionMail) (objectClass=sambaSamAccount) (objectClass=simpleSecurityObject) (&(objectClass=person) (objectClass=organizationalPerson) (objectClass=inetOrgPerson))) (!(uidNumber=0)) (!(uid=*$)) (&(uid=%uid) (ownCloudEnabled=1)))", "The LDAP filter that shall be used when a user tries to log in.", 2012.0.1
"owncloud/ldap/userlistFilter", "(&(\|(&(objectClass=posixAccount) (objectClass=shadowAccount)) (objectClass=univentionMail) (objectClass=sambaSamAccount) (objectClass=simpleSecurityObject) (&(objectClass=person) (objectClass=organizationalPerson) (objectClass=inetOrgPerson))) (!(uidNumber=0))(!(uid=*$)) (&(ownCloudEnabled=1)))", "The LDAP filter that shall be used when the user list is being retrieved (e.g. for sharing)", 2012.0.1
"owncloud/ldap/groupFilter", "(&(objectClass=posixGroup) (ownCloudEnabled=1))", "The LDAP filter that shall be used when the group list is being retrieved (e.g. for sharing)", 2012.4.0.4
"owncloud/ldap/displayName", "uid", "The LDAP attribute that should be used as username in ownCloud", 2012.0.1
"owncloud/ldap/internalNameAttribute", "uid", "Attribute that should be used to create the user's owncloud internal name", 5.0.9
"owncloud/ldap/displayName", "uid", "The LDAP attribute that should be displayed as name in ownCloud", 2012.0.1
"owncloud/ldap/user/searchAttributes", "uid,givenName,sn,description,employeeNumber,mailPrimaryAddress", "Attributes taken into consideration when searching for users (comma separated)", 5.0.9
"owncloud/ldap/user/quotaAttribute", "ownCloudQuota", "Name of the quota attribute. The default attribute is provided by owncloud-schema.", 5.0.9
"owncloud/ldap/user/homeAttribute", "(empty)", "Attribute that should be used to create the user's owncloud internal home folder", 5.0.9
"owncloud/ldap/group/displayName", "cn", "The LDAP attribute that should be used as groupname in ownCloud", 2012.4.0.4
"owncloud/ldap/group/searchAttributes", "cn,description, mailPrimaryAddress", "Attributes taken into consideration when searching for groups (comma separated)", 5.0.9
"owncloud/join/users/update", "yes", "Wether ownCloud LDAP schema should be applied to existing users", 2012.0.1
"owncloud/group/enableDomainUsers", "1", "Wether the group “Domain Users” shall be enabled for ownCloud on install", 2012.4.0.4
"owncloud/join/users/filter", "(&(\|(&(objectClass=posixAccount) (objectClass=shadowAccount)) (objectClass=univentionMail) (objectClass=sambaSamAccount) (objectClass=simpleSecurityObject) (&(objectClass=person) (objectClass=organizationalPerson) (objectClass=inetOrgPerson))) (!(uidNumber=0)) (!(\|(uid=*$) (uid=owncloudsystemuser) (uid=join-backup) (uid=join-slave))) (!(objectClass=ownCloudUser)))", "Filters, on which LDAP users the ownCloud schema should be applied to. The default excludes system users and already ownCloudUsers.", 2012.0.1
"owncloud/join/groups/filter", "(empty)", "Filters which LDAP groups will be en/disabled for ownCloud when running the script /usr/share/owncloud/update-groups.sh", 2012.4.0.4
If you want to override the default settings, simply create the key in
question in the UCR and assign your required value, for example::
@ -84,61 +63,72 @@ or via UMC:
Installation
^^^^^^^^^^^^
Now, we are ready to install ownCloud. This can be either done through the ownCloud UCS repository or by downloading the packages.
Now, we are ready to install ownCloud. This can be either done through the UCS
App Center (recommended) or by downloading the packages.
Repository
""""""""""
UCS App Center
""""""""""""""
To include the ownCloud UCS repository, you need to configure it using
the UCR. To do so, just use the following command:
Open the Univention Management Console and choose the App Center module. You
will see a variety of available applications, including ownCloud.
::
.. image:: /images/ucs-app-center-module.png
ucr set update/secure_apt="no" \
repository/online/component/owncloud/description="ownCloud" \
repository/online/component/owncloud/server=download.owncloud.com \
repository/online/component/owncloud/prefix=ucs \
repository/online/component/owncloud/defaultpackages=owncloud \
repository/online/component/owncloud/version=current \
repository/online/component/owncloud=enabled
Click on ownCloud 5 and follow the instructions.
Subsequently, install the ownCloud package. It will auto-install
owncloud-schema as well.
.. image:: /images/ucs-app-center-install.png
::
univention-install owncloud
If you want to make use of commercially unsupported packages, install
the unsupported package:
::
univention-install owncloud-unsupported
In the UCS App Center, you can also upgrade from ownCloud 4.5 by installing
ownCloud 5.0. They are provided as seperate apps. It is only possible to have
one version of ownCloud installed.
Manually by download
""""""""""""""""""""
Download the integration packages (`from our website`_ or with wget as
below) and install them from within your download folder (note: the
package owncloud-unsupported is optional):
Download the integration packages `from our website`_ and install them from
within your download folder (note: the package owncloud-unsupported is
optional) via command line:
::
wget http://download.owncloud.com/download/ucs/owncloud_2012.0.1-0_all.deb
wget http://download.owncloud.com/download/ucs/owncloud-schema_2012.0.3-0_all.deb
wget http://download.owncloud.com/download/ucs/owncloud-unsupported_2012.0.3-0_all.deb
dpkg -i owncloud*.deb
dpkg -i owncloud*.deb
ownCloud will be configured to fully work with LDAP. There is only one
local admin user “owncloudadmin”, you can find his password in :file:`/etc/owncloudadmin.secret`. Use this account, if you want to change basic
ownCloud settings.
ownCloud will be configured to fully work with LDAP.
Reinstallation
""""""""""""""
When ownCloud was installed before and uninstalled via AppCenter or via command
line using apt-get remove, ownCloud can be simply installed again. The old
configuration will be used again.
When an older ownCloud was installed and has been purged (only possible via
command line using apt-get purge) the old configuration is gone, but data is
left. This blocks an installation. You can either install the old version and
upgrade to ownCloud 5 or (re)move the old data. This is done by removing the
MySQL database "ownCloud" using the command line:
::
mysql -u root -e "DROP DATABASE owncloud" -p`tail /etc/mysql.secret
In this case you probably also want to remove the data directory
**/var/lib/owncloud** although this is not mandatory.
Postconfiguration (optional)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
There is only one local admin user “owncloudadmin”, you can find his password in
:file:`/etc/owncloudadmin.secret`. Use this account, if you want to change basic
ownCloud settings.
In the installation process a virtual host is set up (Apache is required
therefore). If you want to modify the settings, edit :file:`/etc/apache2/sites-available/owncloud` and restart the web server. You might want to do it to enable HTTPS connections.Besides that, you can edit the **.htaccess-File in /var/www/owncloud/**. In the latter file there are also the PHP limits for file transfer specified.
therefore). If you want to modify the settings, edit
:file:`/etc/apache2/sites-available/owncloud` and restart the web server. You
might want to do it to enable HTTPS connections. Besides that, you can edit the
**.htaccess-File in /var/www/owncloud/**. In the latter file there are also the
PHP limits for file transfer specified.
Using ownCloud
^^^^^^^^^^^^^^
@ -152,7 +142,11 @@ your LDAP credentials.
.. image:: /images/ucsint1.png
Updating users can also be done by the script :file:`/usr/share/owncloud/update-users.sh` . It takes the following UCR variables as parameters: **owncloud/user/enabled** for enabling or disabling, **owncloud/user/quota** as the Quota value and **owncloud/join/users/filter** as LDAP filter to select the users to update.
Updating users can also be done by the script
:file:`/usr/share/owncloud/update-users.sh` . It takes the following UCR
variables as parameters: **owncloud/user/enabled** for enabling or disabling,
**owncloud/user/quota** as the Quota value and **owncloud/join/users/filter** as
LDAP filter to select the users to update.
Groups 2012.4.0.4
"""""""""""""""""
@ -165,8 +159,11 @@ enabled and disabled via UCM as shown in the screen shot below.
.. image:: /images/ucsint.png
Another way to enable or disable groups is to use the script :file:`/usr/share/owncloud/update-groups.sh`. Currently, it takes an argument
which can be 1=enable groups or 0=disable groups. The filter applied is being taken from the UCR variable **owncloud/join/groups/filter**. In case it is empty , a message will be displayed.
Another way to enable or disable groups is to use the script
:file:`/usr/share/owncloud/update-groups.sh`. Currently, it takes an argument
which can be 1=enable groups or 0=disable groups. The filter applied is being
taken from the UCR variable **owncloud/join/groups/filter**. In case it is
empty, a message will be displayed.
.. _from our website: https://owncloud.com/download