Taille: 7334
Commentaire: ébauche
|
Taille: 9315
Commentaire: documentation des templates
|
Texte supprimé. | Texte ajouté. |
Ligne 1: | Ligne 1: |
{{{#!rst s============================================================== |
{{{!rst ============================================================== |
Ligne 25: | Ligne 25: |
:: | .. code-block:: sh |
Ligne 35: | Ligne 35: |
:: VERSION=$(wget https://owncloud.org/changelog -O - |\ grep -o "Version \([0-9.]\+\)" |\ head -n 1 |\ sed -e "s/Version //") |
.. code-block:: sh VERSION=`wget https://owncloud.org/changelog -O - |\ sed -n '/Version [0-9\.]\+/{s/^.*Version \([0-9\.]\+\).*$/\1/p;q}'` |
Ligne 45: | Ligne 43: |
:: | .. code-block:: sh |
Ligne 52: | Ligne 50: |
:: | .. code-block:: sh |
Ligne 58: | Ligne 56: |
:: | .. code-block:: sh |
Ligne 64: | Ligne 62: |
:: | .. code-block:: sh |
Ligne 71: | Ligne 69: |
Pour installer owncloud depuis un dépôt Debian/Ubuntu, veuillez suivre les instructions à la page:: `https://software.opensuse.org/download/package?project=isv:ownCloud:community&package=owncloud <https://software.opensuse.org/download/package?project=isv:ownCloud:community&package=owncloud>`_ |
Pour installer owncloud depuis un dépôt Debian/Ubuntu, veuillez suivre les instructions à la page: - `https://software.opensuse.org/download/package?project=isv:ownCloud:community&package=owncloud <https://software.opensuse.org/download/package?project=isv:ownCloud:community&package=owncloud>`_ |
Ligne 76: | Ligne 75: |
:: | .. code-block:: sh |
Ligne 89: | Ligne 88: |
:: | .. code-block:: sh |
Ligne 100: | Ligne 99: |
:: | .. code-block:: php |
Ligne 115: | Ligne 114: |
:: <VirtualHost default:80> |
.. code-block:: xml <VirtualHost _default_:80> |
Ligne 119: | Ligne 118: |
Redirect permanent / `https://nuage.auf.org <https://nuage.auf.org>`_ | Redirect permanent / https://nuage.auf.org |
Ligne 122: | Ligne 121: |
<IfModule mod\_ssl.c> <VirtualHost default:443> |
<IfModule mod_ssl.c> <VirtualHost _default_:443> |
Ligne 137: | Ligne 136: |
ErrorLog ${APACHE\_LOG\_DIR}/nuage.auf.org\_error.log CustomLog ${APACHE\_LOG\_DIR}/nuage.auf.org\_access.log combined LogLevel warn <FilesMatch "\\.(cgi|shtml|phtml|php)$"> SSLOptions +StdEnvVars </FilesMatch> <Directory /usr/lib/cgi-bin> SSLOptions +StdEnvVars </Directory> |
ErrorLog ${APACHE_LOG_DIR}/nuage.auf.org_error.log CustomLog ${APACHE_LOG_DIR}/nuage.auf.org_access.log combined # Possible values include: debug, info, notice, warn, error, crit, # alert, emerg. LogLevel warn <FilesMatch "\.(cgi|shtml|phtml|php)$"> SSLOptions +StdEnvVars </FilesMatch> <Directory /usr/lib/cgi-bin> SSLOptions +StdEnvVars </Directory> |
Ligne 153: | Ligne 154: |
:: | .. code-block:: sh |
Ligne 183: | Ligne 184: |
:: | .. code-block:: html |
Ligne 193: | Ligne 194: |
Ensuite, les templates de courriels doivent être traduits. - Notification d'activité .. code-block:: php <?php /** @var OC_L10N $l */ /** @var array $_ */ $l = $_['overwriteL10N']; print_unescaped($l->t('Bonjour %s,', array($_['username']))); p("\n"); p("\n"); if ((int) $_['timeframe'] === \OCA\Activity\UserSettings::EMAIL_SEND_HOURLY) { print_unescaped($l->t('Vous recevez ce courriel car dans la dernière heure les activités suivantes ont eu lieu à %s', array($_['owncloud_installation']))); } else if ((int) $_['timeframe'] === \OCA\Activity\UserSettings::EMAIL_SEND_DAILY) { print_unescaped($l->t('Vous recevez ce courriel car depuis hier les activités suivantes ont eu lieu à %s', array($_['owncloud_installation']))); } else { print_unescaped($l->t('Vous recevez ce courriel car dans la dernière semaine les activités suivantes ont eu lieu à %s', array($_['owncloud_installation']))); } p("\n"); p("\n"); foreach ($_['activities'] as $activityData) { print_unescaped($l->t('* %1$s - %2$s', $activityData)); p("\n"); } if ($_['skippedCount']) { print_unescaped($l->n('* et %n de plus ', '* et %n de plus ', $_['skippedCount'])); p("\n"); } p("\n"); |
|
Ligne 196: | Ligne 232: |
Pour rendre disponible le modmellon depuis owncloud vous devez Installer le plugin suivant:: `https://apps.owncloud.com/content/show.php/user_servervars?content=158863 <https://apps.owncloud.com/content/show.php/user_servervars?content=158863>`_ |
Pour rendre disponible le modmellon depuis owncloud vous devez Installer le plugin suivant: - `https://apps.owncloud.com/content/show.php/user_servervars?content=158863 <https://apps.owncloud.com/content/show.php/user_servervars?content=158863>`_ |
Ligne 200: | Ligne 238: |
:: | .. code-block:: sh |
Ligne 211: | Ligne 249: |
:: | .. code-block:: sh |
Ligne 219: | Ligne 257: |
Faire les mêmes étapes que lors de l'installation pour le téléchargement. | Pour vérifier la version courante utilisez la commande: .. code-block:: sh owncloud/occ status Pour télécharger la dernière version, suivre les mêmes étapes décrite dans la section `1.1 Installation`_. |
Ligne 222: | Ligne 268: |
:: | .. code-block:: sh |
Ligne 228: | Ligne 274: |
:: | .. code-block:: sh |
Ligne 235: | Ligne 281: |
:: | .. code-block:: sh |
Ligne 241: | Ligne 287: |
:: | .. code-block:: sh |
Ligne 250: | Ligne 296: |
:: | .. code-block:: sh |
Ligne 256: | Ligne 302: |
:: | .. code-block:: sh |
Ligne 266: | Ligne 312: |
:: | .. code-block:: sh |
Ligne 282: | Ligne 328: |
:: mysql owncloud -e "select * from oc_appconfig where appid='user_ldap';" |
.. code-block:: sh mysql owncloud -e "select configkey, configvalue from oc_appconfig where appid='user_ldap';" |
Ligne 288: | Ligne 334: |
:: | .. code-block:: sh |
{{{!rst ============================================================== Guide d'installation, configuration et mise-à-jour de Owncloud ==============================================================
- :Author: Patrick Hetu
.. contents::
1 Serveur
1.1 Installation ~~~~~~~~~~~~~~~~
Notez que l'ensemble des commandes doivent être exécutées en tant que super utilisateur.
1.1.1 Via le code source
1.1.1.1 Dépendances :::::::::::::::::::
.. code-block:: sh
- apt-get update apt-get install mysql-server apache2 php5 php5-gd php5-imagick php5-ldap php5-mcrypt php5-curl git bzip2
1.1.1.2 Installation ::::::::::::::::::::
Vérification de la dernière version disponible et sauvegarde dans la variable VERSION:
.. code-block:: sh
VERSION=`wget https://owncloud.org/changelog -O - |\
- sed -n '/Version [0-9\.]\+/{s/^.*Version \([0-9\.]\+\).*$/\1/p;q}'`
Télécharger l'archive compressé du code source et sa somme sha256:
.. code-block:: sh
wget https://download.owncloud.org/community/owncloud-$VERSION.tar.bz2 wget https://download.owncloud.org/community/owncloud-$VERSION.tar.bz2.sha256
Vérifier la somme:
.. code-block:: sh
sha256sum -c owncloud-$VERSION.tar.bz2.sha256 < owncloud-$VERSION.tar.bz2
Si la somme est correcte, extraire l'archive dans le dossier courant:
.. code-block:: sh
- tar jxvf owncloud-$VERSION.tar.bz2
Rendre l'outil en ligne de commande exécutable.
.. code-block:: sh
- chmod a+x owncloud/occ
1.1.2 ou via le dépôt Deb ^
Pour installer owncloud depuis un dépôt Debian/Ubuntu, veuillez suivre les instructions à la page:
- https://software.opensuse.org/download/package?project=isv:ownCloud:community&package=owncloud <https://software.opensuse.org/download/package?project=isv:ownCloud:community&package=owncloud>_
Puis installer le paquet:
.. code-block:: sh
- apt-get update apt-get install owncloud
1.2 Configuration ~~~~~~~~~~~~~~~~~
1.2.1 Mysql ^
Première étape, création de la base de données et d'un utilisateur avec les commandes:
.. code-block:: sh
- mysql -e "create database owncloud;" mysql -e "grant usage on *.* to owncloud@localhost identified by 'VOTRE_MOT_DE_PASSE';"
1.2.2 Owncloud
Les données de configuration de owncloud spécifique à l'AUF suivantes doivent être ajouter dans le fichier owncloud/config/config.php:
.. code-block:: php
'datadirectory' => '/srv/data', 'ldapIgnoreNamingRules' => false, 'mail_domain' => 'auf.org', 'trusted_domains' =>
- array (
0 => 'nuage.auf.org',
- array (
1.2.3 Apache
Apache doit être configurer avec les VirtualHost suivant:
.. code-block:: xml
<VirtualHost _default_:80>
ServerName nuage.auf.org Redirect permanent / https://nuage.auf.org
<IfModule mod_ssl.c> <VirtualHost _default_:443>
ServerName nuage.auf.org DocumentRoot /var/www/owncloud <Directory />
Options FollowSymLinks AllowOverride None
</Directory> <Directory /var/www/owncloud>
Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all
</Directory>
ErrorLog ${APACHE_LOG_DIR}/nuage.auf.org_error.log CustomLog ${APACHE_LOG_DIR}/nuage.auf.org_access.log combined # Possible values include: debug, info, notice, warn, error, crit, # alert, emerg.
LogLevel warn <FilesMatch "\.(cgi|shtml|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch> <Directory /usr/lib/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
Puis les modules ssl et rewrite doivent être activés:
.. code-block:: sh
- a2enmod ssl a2enmod rewrite service apache2 reload
1.2.3.1 ModSSL ::::::::::::::
voir: https://wiki.auf.org/wikiteki/PKI/Cr%C3%A9ationCertificatServeurSSL <https://wiki.auf.org/wikiteki/PKI/Cr%C3%A9ationCertificatServeurSSL>_
1.2.3.2 ModMellon :::::::::::::::::
voir: https://redmine.auf.org/projects/auth/wiki/MiseEnPlaceSP <https://redmine.auf.org/projects/auth/wiki/MiseEnPlaceSP>_
1.2.4 AUF ^
1.2.4.1 LDAP ::::::::::::
Configurer ldap dans l'interface d'administration: https://nuage.auf.org/index.php/settings/admin <https://nuage.auf.org/index.php/settings/admin>_
1.2.4.2 Theme :::::::::::::
Le fichier owncloud/core/templates/login.php doit être copié vers owncloud/themes/auf/core/templates/ et la ligne suivante doit être ajouter avant le formulaire de connexion:
.. code-block:: html
<a href="/mellon/login?ReturnTo=https%3A%2F%2F<?php p($_SERVER['HTTP_HOST']); ?>%2F%3Fapp%3Duser_servervars"
- onMouseOver="document.idauf_bouton.src='/themes/auf/core/img/idauf_bouton_survol.png';"
onMouseOut="document.idauf_bouton.src='/themes/auf/core/img/idauf_bouton.png';">
<img id="idauf_bouton" width="200" height="32" src="/themes/auf/core/img/idauf_bouton.png" />
</a>
- onMouseOver="document.idauf_bouton.src='/themes/auf/core/img/idauf_bouton_survol.png';"
Puis les fichiers images doivent être téléchargés dans leurs répertoires respectifs.
Ensuite, les templates de courriels doivent être traduits.
- Notification d'activité
.. code-block:: php
<?php /** @var OC_L10N $l */ /** @var array $_ */ $l = $_['overwriteL10N'];
print_unescaped($l->t('Bonjour %s,', array($_['username']))); p("\n"); p("\n");
if ((int) $_['timeframe'] === \OCA\Activity\UserSettings::EMAIL_SEND_HOURLY) {
print_unescaped($l->t('Vous recevez ce courriel car dans la dernière heure les activités suivantes ont eu lieu à %s', array($_['owncloud_installation'])));
} else if ((int) $_['timeframe'] === \OCA\Activity\UserSettings::EMAIL_SEND_DAILY) {
print_unescaped($l->t('Vous recevez ce courriel car depuis hier les activités suivantes ont eu lieu à %s', array($_['owncloud_installation'])));
print_unescaped($l->t('Vous recevez ce courriel car dans la dernière semaine les activités suivantes ont eu lieu à %s', array($_['owncloud_installation'])));
print_unescaped($l->t('* %1$s - %2$s', $activityData)); p("\n");
print_unescaped($l->n('* et %n de plus ', '* et %n de plus ', $_['skippedCount'])); p("\n");
1.2.4.3 SSO :::::::::::
Pour rendre disponible le modmellon depuis owncloud vous devez Installer le plugin suivant:
- https://apps.owncloud.com/content/show.php/user_servervars?content=158863 <https://apps.owncloud.com/content/show.php/user_servervars?content=158863>_
dans le dossier apps/ et l'activer avec la commande:
.. code-block:: sh
- owncloud/occ app:enable user_servervars
et finir sa configuration dans l'interface d'administration.
1.2.4.4 Apps ::::::::::::
Les applications suivantes doivent aussi être activées:
.. code-block:: sh
- owncloud/occ app:enable user_ldap owncloud/occ app:enable activity
1.3 Mise-à-jour ~~~~~~~~~~~~~~~
Pour vérifier la version courante utilisez la commande:
.. code-block:: sh
- owncloud/occ status
Pour télécharger la dernière version, suivre les mêmes étapes décrite dans la section 1.1 Installation_.
Démarrer le mode "Maintenance":
.. code-block:: sh
- owncloud/occ maintenance:mode
Puis faire une sauvegarde de la base de données en cas de problème:
.. code-block:: sh
- NOW=$(date +"%m_%d_%Y")
mysqldump owncloud > owncloud_backup_$NOW.sql
Corriger les permissions du répertoire:
.. code-block:: sh
- chown www-data:www-data owncloud/
Copier les fichiers aux bons endroits:
.. code-block:: sh
- cp -rf $OLD/config/ owncloud cp -rf $OLD/theme/ owncloud/ cp -r $OLD/apps/user_servervars owncloud/apps/ cp $OLD/data owncloud/
Lancer le script de mise-à-jour de owncloud:
.. code-block:: sh
- owncloud/occ upgrade
Mettre le dossier en production et fermer le mode "Maintenance":
.. code-block:: sh
- mv owncloud owncloud-prod/ owncloud-prod/occ maintenance:mode
1.4 Vérification ~~~~~~~~~~~~~~~~
Des applications activées:
.. code-block:: sh
- owncloud/occ app:list
Il faut vérifier que les modules suivantes sont bien activés:
- activity
- files\_pdfviewer
- user\_ldap
- user\_servervars
Vérification de la configuration LDAP
.. code-block:: sh
- mysql owncloud -e "select configkey, configvalue from oc_appconfig where appid='user_ldap';"
Vérification de la configuration de user\_servervars
.. code-block:: sh
- mysql owncloud -e "select * from oc_appconfig where appid='user_servervars;"
}}}