https://wiki.koozali.org/api.php?action=feedcontributions&user=Cool34000&feedformat=atomSME Server - User contributions [en]2024-03-28T23:04:02ZUser contributionsMediaWiki 1.35.5https://wiki.koozali.org/index.php?title=Popfile/fr&diff=14150Popfile/fr2010-01-22T21:57:07Z<p>Cool34000: maj fr</p>
<hr />
<div>{{Languages|Popfile}}<br />
=POPFile 0.21.2 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
POPFile est un outil de classement automatique du courriel. Une fois correctement personnalisé et entraîné, il fonctionne à l'arrière-plan de votre ordinateur en analysant le courriel quand il arrive et en le classant selon vos souhaits. Vous pouvez lui demander d'effectuer une simple manoeuvre, comme par exemple mettre de côté le "pollupostage" ("courriel-poubelle"), ou une plus compliquée comme le classement du courriel en une douzaine de dossiers. Considérez-le comme l'assistant personnel de votre boîte de réception.<br />
Pour plus d'informations visitez ''http://popfile.sourceforge.net/''.<br />
<br />
==Installation et désinstallation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-popfile --enablerepo=smecontribs<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-popfile<br />
yum remove perl-DBD-SQLite<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un ''signal event post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
Vous pouvez maintenant récupérer les mails par l'intermédiaire de POPFile, vous avez juste besoin de modifier la configuration de votre client de messagerie favoris:<br />
Serveur POP3: '''nom-du-serveur-sme'''<br />
Login : '''nom-du-serveur-sme:votre-login'''<br />
Port POP3 : '''1100'''<br />
Pour ajouter des catégories ou simplement configurer POPFile, ouvrez votre navigateur favoris à l'adresse ''http://'''nom-du-serveur-sme:7676''.<br />
{{Warning box|type=warning|Pour des raisons de sécurité, veuillez créer un mot de passe après votre 1ère connexion !}}<br />
<br />
==Informations additionnelles==<br />
*[http://popfile.sourceforge.net/ Site web]<br />
*[http://popfile.sourceforge.net/wiki/howtos:outlook Comment configurer Outlook avec POPFile]<br />
*[http://getpopfile.org/docs/howtos:mozilla_netscape Comment configurer Thunderbird avec POPFile]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Mail/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=OpenVPN_Bridge/fr&diff=13321OpenVPN Bridge/fr2009-08-16T16:28:04Z<p>Cool34000: bug de redirection</p>
<hr />
<div>== Open VPN Bridge ==<br />
<br />
{{Languages|Open_VPN_Bridge}}<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Administration]]</div>Cool34000https://wiki.koozali.org/index.php?title=Denyhosts/fr&diff=13156Denyhosts/fr2009-07-04T08:29:56Z<p>Cool34000: /* Installation */ typo</p>
<hr />
<div>{{Languages|Denyhosts}}<br />
=Denyhosts SSH pour SME7=<br />
<br />
==Mainteneur==<br />
[http://smeserver.pialasse.com/ Unnilennium aka Jean-Philippe PIALASSE] (Contrib)<br />
<br />
==Description==<br />
<br />
* Denyhosts banni les hôtes qui tentent de se connecter sans permission en ssh sur votre serveur.<br />
* Il possède une interface intégrée au server-manager afin de voir la liste des hôtes bannis, ajouter des hôtes à ne jamais bannir, et lancer ou suspendre le service.<br />
<br />
<br />
==Installation==<br />
<br />
1. Se connecter en console en tant que root.<br />
<br />
2. Installer smeserver-denyhosts<br />
<br />
yum install smeserver-denyhosts --enablerepo=smecontribs<br />
<br />
Vous aurez une question y/N, répondez y si tout vous semble bon.<br />
<br />
3. A la fin de l'installation on vous demandera de faire un :<br />
<br><code>signal-event post-upgrade;signal-event reboot</code><br />
<br> vous pouvez l'ignorer en exécutant.<br />
/etc/e-smith/events/actions/navigation-conf<br />
<br />
4. Ouvrez votre navigateur web et rendez vous sur le server-manager. <br />
<br>Sous "Securité" ou "Security" il doit y avoir une entrée "SSH Denyhosts".<br />
<br />
Rendez vous y et configurez les hôtes à ne pas bannir avant de lancer le service.<br />
<br />
<br />
<br />
Alternativement vous pouvez installer grace au server-manager sous l'onglet "Mise à jour logicielle". Le dépôt smecontribs doit être sélectionné dans la configuration. Sélectionnez smeserver-denyhosts dans l'ajout de nouveau paquets. Reconfigurez et redémarrez à la fin. Puis rendez vous dans "SSH Denyhosts" dans le server manager après l'avoir rafraichit afin de rajoute rles hôtes à ne pas bannir et lancer le service.<br />
<br />
==Désinstallation==<br />
<br />
yum remove smeserver-denyhosts denyhosts<br />
<br />
ou alternativement supprimez smeserver-denyhosts '''et''' denyhosts depuis le panel "Mise à jour logicielle".<br />
<br />
==Utilisation==<br />
<br />
Vous pouvez accéder à l'interface de SSH denyhosts dans le server-manager.<br />
<br />
==Informations additionnelles==<br />
<br />
Pour changer l'adresse destinataire des messages en cas d'ajout d'hôte vous pouvez faire (par défaut admin@localhost) :<br />
<br />
config setprop denyhosts AdminEmail youremail@yourdomaine.tld<br />
signal-event conf-denyhosts<br />
<br />
=== Vérifier la version installée ===<br />
yum info installed smeserver-denyhosts<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Administration/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Category:Backup/fr&diff=12739Category:Backup/fr2009-04-11T14:10:04Z<p>Cool34000: missing category</p>
<hr />
<div>== Contribs de sauvegardes pour SME Server ==<br />
----</div>Cool34000https://wiki.koozali.org/index.php?title=Category:Contrib/fr&diff=12738Category:Contrib/fr2009-04-11T14:08:06Z<p>Cool34000: /* Catégories des Contribs */</p>
<hr />
<div>{{Languages|:Category:Contrib}}<br />
== SME Server Contribs ==<br />
Les contribs sont des paquetages qui sont conçus pour ajouter des fonctionnalités à la distribution.<br />
Ces contribs sont de préférence dans le repository SME Dev de la distribution et ont une catégorie.<br />
{{Note box|Si vos contribs ne se trouvent pas dans le repository SME Dev ou n'ont pas de catégorie dans le Bugtracker, s'il vous plait faites le.}}<br />
<br />
==Avoir votre Contrib dans la section Contribs de Bugzilla==<br />
Pour avoir votre Contrib listée dans la section SME Contribs du bugtracker, il suffit simplement de remplir un rapport de bug en cliquant {{BugzillaFileBug|product=SME%20Server%20bug%20tracker|component=New%20product%20required|summary=|comment=|title=ici}}. Spécifiez brièvement ce que fait votre Contribs.<br />
<br />
==Avoir votre Contrib dans le repository SME Dev==<br />
{{Incomplete}}<br />
Pour garder toutes les contribs dans un même endroit et aussi faciliter leur installation il est préférable d'avoir votre Contrib dans le repository SME Dev.<br />
Pour avoir des détails sur la manière de travailler avec le repository SME Dev, allez voir [http://mirror.contribs.org/smeserver/contribs/gordonr/devguide/html/devguide.html#AEN1577 Section environnement de développement SME Server EN] du [http://mirror.contribs.org/smeserver/contribs/gordonr/devguide/html/devguide.html Guide du développeur EN].<br />
<br />
== Contribs disponibles ==<br />
Vous pourrez trouver une liste des Contribs dans le [http://bugs.contribs.org/describecomponents.cgi?product=SME%20Contribs Bugtracker de SME Server]<br />
<br />
Propriétaires de Contrib [[Help:Starting_a_new_page| créez une page]] dans le Wiki.<br />
<br />
== Catégories des Contribs ==<br />
*[[:Category:Administration/fr]] - Administration<br />
*[[:Category:Backup/fr]] - Sauvegarde<br />
*[[:Category:Groupware/fr]] - Groupware<br />
*[[:Category:Mail/fr]] - Applications eMail<br />
*[[:Category:Webapps/fr]] - Applications Web</div>Cool34000https://wiki.koozali.org/index.php?title=Affa/fr&diff=12734Affa/fr2009-04-09T19:50:54Z<p>Cool34000: fix template translation</p>
<hr />
<div>{{Languages|Affa}}<br />
{{Level|type=Niveau de compétence: Avancé|Advanced|Les instructions dans cette page requièrent un niveau avancé. Une bonne compréhension de Linux et de SME est recommandée.}}<br />
<br />
=== Développeur ===<br />
Michael Weinberger<br />
<br />
=== Traducteur ===<br />
[http://bj-informatique.com/affa.php?lang=fr jibe]<br />
<br />
Affa signifie '''A'''utomatische '''F'''estplatten '''F'''ern'''a'''rchivierung, soit approximativement en français : Sauvegarde automatique de disque dur à distance.<br />
<br />
<br />
=== Description ===<br />
Le but principal de ce paquetage Affa est de transformer un serveur SME 7 en un serveur dédié de sauvegardes en quelques minutes. Affa sauvegarde autant que vous le désirez de serveurs SME sur n'importe quel autre serveur ayant sshd en service et rsync installé. Une fois qu'il est configuré, Affa fonctionne sans surveillance et de manière fiable, envoyant des messages d'avertissement en cas d'erreur. <br />
<br />
Toutes les archives sont des sauvegardes complètes, puisque Affa utilise la technique des hardlink. Une nouvelle sauvegarde complète ne nécessite donc que l'espace disque pour les différences et les nécessités du système de fichier pour les hardlinks et les répertoires (ce qui représente généralement 2-3%).<br />
<br />
Affa est basé sur le programme rsync et supporte l'option --compress. Cela vous permet de lancer des sauvegardes via internet ou VPN. ne configuration typique consiste en un ou plusieurs serveurs de sauvegarde Affa placés en des lieux déportés, qui sauvegardent les serveurs de production via le VPN.<br />
<br />
Une caractéristique spéciale est l'option "rise", qui vous permet de convertir votre serveur de sauvegarde en serveur de production depuis une archive sauvegardée en cas de perte totale de votre serveur de production. Cette conversion est exécutée en un temps très court, même avec une énorme quantité de données. Cette possibilité de conversion utilise les hardlinks et de ce fait n'utilise pas d'espace disque supplémentaire.<br />
<br />
Affa est un outil en ligne de commande pour les administrateurs système et est conçu intentionnellement sans interface graphique. De ce fait, il peut être géré efficacement depuis la console même via une connexion internet lente.<br />
<br />
'''Note:''' Ce document concerne la version 2 Release Candidate d'Affa. La documentation de la dernière version 1 stable se trouve [http://wiki.contribs.org/index.php?title=Affa&oldid=11974 ici].<br />
<br />
==== Un coup d'oeil aux caractéristiques d'Affa ====<br />
* Affa est sûr : Tous transferts et connexions sont faits en utilisant le protocole ssh avec une authentification par clés publique/privée.<br />
* Lance périodiquement des sauvegardes complètes sans intervention. * Seules les différences avec la sauvegarde complète précédente sont transférées par le réseau<br />
* Utilise rsync avec l'option de compression pour les connexions lentes, ce qui permet des sauvegardes via internet/VPN<br />
* Utilise la technique des hardlink pour réduire l'espace disque physique à seulement ce qui est nécessaire pour les différences entre deux sauvegardes complètes<br />
* Mémorise un nombre configurable de sauvegardes automatisées, journalières, hebdomadaires, mensuelles et annuelles<br />
* On peut naviguer dans les archives sans avoir à les décompresser. Il n'est pas nécessaire de les décompresser d'abord.<br />
* Les archives peuvent être attachées à un partage Samba.<br />
* Les tâches de sauvegarde sont démarrées par le démon cron<br />
* Les travaux interrompus continuent au redémarrage en tenant compte des données déjà transférées<br />
* Sauvegarde les répertoires et fichiers e-smith par défaut, lorsque la propriété SMEServer est mise à 'yes'<br />
* Des répertoires et fichiers supplémentaires peuvent être inclus<br />
* Des répertoires et fichiers peuvent être exclus de la sauvegarde<br />
* Les serveurs Linux non SME peuvent être sauvegardés en mettant la propriété SMEServer à 'no' et en utilisant une liste d'inclusion<br />
* En mode ESXi, les machines virtuelles actives peuvent être sauvegardées. Voir [[Sauvegarde de machines virtuelles ESXi avec Affa]]<br />
* Priorité configurable (nice level) pour les process rsync sur les serveurs backup et source<br />
* Possibilité de lancer des programmes personnels avant et après le lancement d'une tâche (par exemple, lancement d'une sauvegarde sur bande)<br />
* Vérification de l'espace disque disponible après le lancement d'une tâche avec niveaux d'avertissement strict, normal ou risqué<br />
* Vérification étendue des conditions d'échec<br />
* Envoi de messages d'échec à une liste configurable d'adresses email<br />
* Envoi d'un message d'avertissement si le serveur de backup n'a plus d'espace disque disponible<br />
* Installe un chien de garde optionnel sur le serveur source vérifiant la disponibilité du serveur de backup (SME server seulement)<br />
* Le chien de garde envoie des avertissements, si une sauvegarde programmée n'a pas été lancée (SME server seulement)<br />
* Le chien de garde envoie un message journalier de rappel tant que l'erreur n'est pas corrigée (SME server seulement)<br />
* Possibilité d'afficher l'état courant de toutes les tâches, montrant les heures de dernier et prochain lancement, la taille et l'espace disque utilisé<br />
* Le status peut être envoyé par email journellement, hebdomadairement ou mensuellement<br />
* Possibilit d'afficher toutes les archives existantes pour une tâche, montrant la date, le nombre de fichiers et l'espace disque<br />
* Possibilité d'envoyer (et de retirer) la clé publique au serveur source (SME server et ESXi seulement)<br />
* Option pour convertir le serveur de sauvegardes en serveur de production (SME server seulement)<br />
* La fonction de conversion ne déplace pas physiquement les données et est donc extrêmement rapide et ne nécessite (presque) pas d'espace disque<br />
* La fonction de conversion peut être lancée à distance puisque les drivers ethernet du serveur de sauvegarde sont conservés<br />
* Comparaison des RPMs installés entre les serveurs source et de sauvegarde. Envoie un avertissement s'il n'y a pas correspondance.<br />
* Annulation de la conversion pour remise en service du serveur de sauvegardes<br />
* Configurable par commandes style e-smith db, avec un enregistrement pour chaque tâche et un enregistrement par défaut commun à toutes les tâches<br />
* Logs dans /var/log/affa/JOB.log et /var/log/affa/affa.log avec option debug pour plus de détails<br />
* Les fichiers de log sont permutés hebdomadairement, avec 5 fichiers conservés<br />
<br />
<br />
=== Installation ou mise à jour ===<br />
Dernière version: '''smeserver-affa-2.0.0-rc4.noarch.rpm'''<br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/smeserver-affa-2.0.0-rc4.noarch.rpm</nowiki><br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm</nowiki><br />
/usr/bin/yum --enablerepo=smecontribs localinstall \<br />
smeserver-affa-2.0.0-rc4.noarch.rpm \<br />
perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm<br />
<br />
Après la première installation d'Affa, lancez la commande suivante pour initialiser la base de données Affa.<br />
affa --make-cronjobs<br />
et déconnectez-vous puis reconnectez-vous à la console pour que le complément automatique de bash (touche TAB) prenne effet<br />
<br />
=== Exemple de démarrage rapide ===<br />
Vous avez un serveur de production SME 7 dont le nom est 'prodbox' et l'IP 10.200.48.1. Installez un second SME 7 comme serveur de sauvegardes avec le nom 'affabox' et l'IP 10.200.48.2. <br />
<br />
<ol></li><li>loggez-vous dans 'affabox' et installez les paquetages mentionnés ci-dessus.<br />
</li><li>copiez le script d'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
</li><li>editez /root/prodbox-job.pl et mettez<br />
my $jobname='prodbox';<br />
et<br />
'remoteHostName‘=>'10.200.48.1',<br />
Eventuellement, si le port du serveur distant est configuré, par exemple, en 2222, mettez<br />
'sshPort'=>2222,<br />
</li><li>sauvegardez et lancez le fichier 'prodbox-job.pl'. Cela enregistrera la configuration (et crée les entrées de base de données et les tâches cron)<br />
/root/prodbox-job.pl<br />
</li><li>Générez les clés DSA et envoyez la clé publique à la 'prodbox'<br />
{{Note box|Initialement, lorsque vous faites cette étape, vous devez temporairement mettre oui à "Autoriser l'authentification par SSH à l'aide de mots de passe standards" dans l'accès à distance sur le serveur de production}}<br />
affa --send-key prodbox<br />
</li><li>Lancez la tâche à la main<br />
<br />
affa --run prodbox<br />
</li></ol><br />
<br />
=== Configuration ===<br />
La configuration est stockée dans une base de données style e-smith. Utilisez la commande db pour configurer Affa.<br />
Le nom de tâche est la clé d'enregistrement de type 'job'.<br>Pour configurer un nouveau travail avec le nom 'prodbox', entrez :<br />
<br />
db affa set prodbox job<br />
<br />
Puis positionnez les propriétés<br />
<br />
db affa setprop prodbox remoteHostName 192.168.1.1<br />
db affa setprop prodbox TimeSchedule '0030,0730,1130,1330,1730,2030'<br />
db affa setprop prodbox Description 'My Production Server'<br />
db affa setprop prodbox status enabled<br />
et ainsi de suite...<br />
<br />
Alternativement, vous pouvez utiliser un script comme décrit ci-dessus dans le chapitre 'Démarrage rapide'.<br />
<br />
Pour vérifier votre travail, tapez :<br />
<br />
db affa show prodbox<br />
<br />
Pour finir, mettez en place les tâches cron :<br />
affa --make-cronjobs<br />
<br />
==== Propriétés de configuration de tâches ====<br />
'''Note:''' Les valeurs par défaut données dans ce tableau sont celles du programme Affa et ne doivent pas être confondues avec les valeurs prépositionnées dans les scripts d'aide, par exemple jobconfig-sample.pl.<br />
{| border="1" cellpadding="3" cellspacing=0<br />
|-<br />
| '''Propriété''' || '''Valeur''' || '''Defaut''' || '''Description''' <br />
|-<br />
| remoteHostName <br />
| FQHN ou IP || || FQHN ou IP de l'hôte source (obligatoire)<br />
|-<br />
| TimeSchedule <br />
| HHMM,HHMM,... || || N'a pas besoin d'être ordonné. Au moins une heure est obligatoire. '''Important:''' Utiliser le bon format HHMM est essentiel. Affa ne le vérifie pas. Un TimeSchedule mal formatté provoquera d'étranges erreurs Perl. <br />
|-<br />
| Description<br />
| texte || || <br />
|-<br />
| scheduledKeep<br />
| entier >= 1 || 1|| Combien de sauvegardes programmées doivent être conservées <br />
|-<br />
| dailyKeep<br>weeklyKeep<br>monthlyKeep<br>yearlyKeep<br />
| entier >= 0 || 7<br>4<br>12<br>2<br>|| Combien de sauvegardes quotidiennes, hebdomadaires, mensuelles ou annuelles doivent être conservées <br />
|-<br />
| SMEServer<br />
| yes ''ou'' no || yes || Positionné à 'yes', les répertoires e-smith par défaut sont automatiquement inclus et la propriété RPMCheck=yes peut être utilisée<br />
<br />
|-<br />
| Include[0]<br>Include[1]<br>...<br />
| full path || || Fichiers ou répertoires supplémentaires à inclure à la sauvegarde <br />
|-<br />
| Exclude[0]<br>Exclude[1]<br>...<br />
| full path || || Fichiers ou répertoires supplémentaires à exclure de la sauvegarde <br />
|-<br />
| RPMCheck<br />
| yes ''ou'' no || no || Seulement applicable aux tâches qui sauvegardent un serveur SME 7.<br>Compares les RPM de l'hôte source avec ceux de l'hôte de sauvegarde affa. Envoie un message avec une liste de différences s'il n'y a pas correspondance. Cette vérification est utile, si vous voulez avoir la possibilité de convertir le serveur de sauvegarde en serveur de production.<br />
|-<br />
| DiskSpaceWarn<br />
| strict ''ou'' normal ''ou'' risky ''ou'' none || strict || lance une vérification de l'espace disque après qu'une tâche soit terminée. Avec le niveau 'strict' un message d'avertissement sera envoyé si l'espace disponible est moins que la taille de la sauvegarde qui vient de s'achever. Avec les niveaux 'normal'/'risky' le message est envoyé si moins de 50%/10% de la taille de la sauvegarde reste disponible.<br />
'''Note:''' Lorsque RootDir est un lien symbolique vers un autre système de fichiers, l'espace disque utilisé du système de fichiers local est vérifié à la place de celui du système de fichiers lié. Positionnez le point de montage comme RootDir pour avoir une vérification correcte.<br />
|-<br />
| localNice <br />
| -19...+19 || 0 || lance le process local rsync par nice. <br />
|-<br />
| remoteNice<br />
| -19...+19 || 0 || lance le process rsync de la source par nice. <br />
|-<br />
| Watchdog<br />
| yes ''ou'' no || yes || Seulement applicable aux tâches qui sauvegardent un serveur SME 7.<br>Quand une tâche est lancée, affa installe un script chien de garde sur la source dans /etc/cron.d/, qui envoie un message d'avertissement si la prochaine tâche programmée (prise dans la propriété TimeSchedule + 10 minutes) n'a pas été lancée. Cela garantit que vous serez prévenu même en cas de panne du serveur affa. Le script chien de garde envoie un message de rappel quotidien si l'erreur persiste. La tâche lancée suivante remplace le script chien de garde avec un nouveau temps de déclenchement. <br />
|-<br />
| sshPort<br />
| port du service || 22 || Lorsque sshd sur le serveur source ou votre firewall écoute sur un port non standard, précisez le port ici.<br />
|-<br />
| ConnectionCheckTimeout<br />
| secondes || 120 || Avant que le process rsync démarre sur l'hôte source distant, affa vérifie la connexion ssh et se termine avec une erreur après le temps configuré, si l'hôte ne répond pas.<br />
|- <br />
| rsyncTimeout<br />
| secondes || 900 || Rsync se termine si aucune donnée n'est transférée pendant le temps configuré. Cela évite un gelage permanent dans le cas d'une erreur sur le réseau.<br />
|- <br />
| BandwidthLimit<br />
| entier>=0 Ko/s || 0 || Limite la vitesse de transfert des données. A valeur à zero specifie qu'il n'y a pas de limite.<br />
|- <br />
| rsyncCompress<br />
| yes ''ou'' no || no || Compresse les données transférées. Peut être utile avec les connexions internet lentes. Cela augmente la charge CPU sur les hôtes source et de sauvegarde.<br />
|-<br />
| EmailAddresses<br />
| name@domain.com,name@domain.com,... || admin|| Liste séparée par des virgules des adresses email où les messages seront envoyés.<br>'''Note:''' Par défaut, Affa n'envoie de messages que pour les erreurs, jamais en cas de succès (voir la propriété chattyOnSuccess).<br />
|-<br />
| RetryAttempts<br />
| entier >= 0 || 3 || Quand positionné à une valeur >0, Affa relance une tâche échouée RetryAttemps fois avec un délai de RetryAfter secondes.<br />
|-<br />
| RetryAfter <br />
| secondes >= 3 || 600 || Quand positionné à une valeur >0, attend RetryAfter secondes avant de relancer la tâche suite à une erreur. Utile seulement avec RetryAttempts>0<br />
|-<br />
| RetryNotification<br />
| yes ''ou'' no || yes || Quand positionné à no, Affa n'envoie pas de message d'erreur lorsqu'une tâche a échoué et que RetryAttemps est configuré. Un message d'erreur n'est envoyé que lorsque le dernier essai a échoué.<br />
|-<br />
| RetryAttempts<br />
| entier >= 0 || 0 || Quand positionné à une valeur >0, Affa envoie un message pour les tâches terminées avec succès et décrémente la valeur chattyOnSuccess. Lorsque la valeur atteint 0, Affa revient à son comportement par défaut et n'envoie plus de messages qu'en cas d'erreur.<br />
|-<br />
| AutomountDevice<br>AutomountPoint<br />
| full path || || Unité et point de montage de l'unité de sauvegarde (ex. disque USB). L'unité est montée automatiquement avant qu'une tâche soit lancées et démontée après la fin de la tâche. Avec ces deux propriétés vides, aucun montage automatique n'est effectué.<br />
|-<br />
| AutomountOptions<br />
| chaine de caractères || || Une chaine d'options passées à la commande de montage automatique<br />
|-<br />
| AutoUnmount <br />
| yes ''ou'' no || yes || Quand positionné à 'no' l'unité montée automatiquement reste montée après l'exécution d'Affa.<br />
|-<br />
| preJobCommand<br>postJobCommand<br />
| full path || || Programmes (locaux sur le serveur affa) à exécuter avant/après qu'une tâche soit lancée. Le nom de la tâche et le type (programmée, journalière etc.) sont passés en arguments au programme. Le code de sortie est de plus passé à la commande de programme post-tâche. Voir /usr/lib/affa/ pour des exemples de scripts perl.<br />
|-<br />
| RootDir<br />
| full path || /var/affa || Où stocker les archives de sauvegarde. N'utilisez pas /home/e-smith ou /root puisqu'ils sont inclus dans les répertoires à sauvegarder, ce qui empêcherait la fonction de conversion de fonctionner ! Répertoire conseillé : /var/affa<br />
|-<br />
| SambaShare<br />
| yes ''ou'' no|| yes || Accède aux archives de la tâche via SMB.<br />
|-<br />
| Debug <br />
| yes ''ou'' no || no || Positionné à 'yes', donne plus de détails dans le fichier de log.<br />
|-<br />
| status<br />
| enabled ''ou'' disabled || enabled || Positionné à 'disable', aucune entrée cron ne sera faite. Vous pouvez encore lancer les tâches à la main.<br />
|-<br />
| rsync--inplace<br />
| yes ''ou'' no || yes || Positionné à 'no', si la version rsync de la source ne supporte pas cette option (comme rsync sur SME6)<br />
|-<br />
| rsync--modify-window<br />
| entier >= 0 || 0 || En comparant deux horodatages, rsync les traite comme étant égaux s'ils ne diffèrent pas de plus de la valeur modify-window. C'est normalement 0 pour une correspondance exacte. Une valeur >= 0 est pratique si vous ne pouvez pas garder les horloges de la source et du serveur Affa synchonisées.<br />
|-<br />
| rsyncOptions<br />
| texte || || chaine d'options aditionnelles à passer à rsync.<br />
|-<br />
| rsyncdMode<br />
| yes ''ou'' no || no || Positionné à yes pour se connecter au démon rsync de l'hôte distant (au lieu de lancer rsync over ssh).<br />
|-<br />
| rsyncdModule<br />
| texte || AFFA || Le nom du module rsyncd (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| rsyncdUser<br />
| texte || affa || Le nom d'utilisateur pour authentification au démon rsync (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| rsyncdPassword<br />
| texte || || Le mot de passe pour authentification au démon rsync (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| remoteOS<br />
| cygwin || || avec remoteOS=cygwin les options --send-key et --revoke-key utilisent le compte 'Administrator' et le chemin correct pour la clé publique sur un hôte distant sous Windows/Cygwin. <br />
|- <br />
| ESXi<br />
| yes ''ou'' no || no || active le mode de sauvegarde VMware ESXi pour les machines virtuelles.<br>Voir [[Sauvegarde des machines virtuelles ESXi avec Affa]]<br />
|-<br />
| ESXiVMName<br />
| texte || || Le nom de la VM tel qu'affiché dans le client VI.<br />
|-<br />
| ESXiUsername<br />
| texte || || Le nom du client VI avec la permission de créer et détruire les instantanés (snapshots).<br />
|-<br />
| ESXiPassword<br />
| texte || || Le mot de passe de l'utilisateur ESXiUsername<br />
|-<br />
| chunkFiles<br />
| texte || || Noms de fichiers qu'Affa devrait découper et compresser. Plusieurs noms doivent être séparés par un slash (/), ex. 'mysql.dump/pgsql.dump' découpe les deux fichiers mysql.dump et pgsql.dump. Avec ESXi=yes c'est implicitement positionné à '*.vmdk'. Voir aussi les options de ligne de commande --chunk-archive et --unchunk-archive<br />
|}<br />
<br />
==== Propriétés de la configuration par défaut ====<br />
Toutes les propriétées peuvent être positionnées par défaut dans l'enregistrement DefaultAffaConfig. C'est pratique, lorsque vous configurez plusieurs tâches similaires. <br />
<br />
Exemple : Vous voulez positionner la propriété 'localNice' à 19 pour toutes les tâches. Tapez<br />
db affa setprop DefaultAffaConfig localNice 19<br />
et ne positionnez pas cette propriété pour les tâches.<br />
Les propriétés positionnées dans les tâches sont prioritaires sur les propriétés par défaut.<br />
<br />
La propriété spéciale 'sendStatus' ne s'applique que dans l'enregistrement DefaultAffaConfig. Elle contrôle le rapport d'état (status) envoyé par mail et peut prendre les valeurs 'none', 'daily', 'weekly' ou 'monthly'. <br />
<br />
Pour configurer un rapport hebdomadaire, tapez :<br />
db affa setprop DefaultAffaConfig sendStatus weekly<br />
puis configurez cronjob :<br />
affa --make-cronjobs<br />
<br />
==== Désactivation globale ====<br />
Toutes les tâches peuvent être désactivées en positionnant l'enregistrement AffaGlobalDisable sur 'yes'.<br />
db affa set AffaGlobalDisable yes<br />
affa --make-cronjobs<br />
<br />
Pour réactiver :<br />
db affa set AffaGlobalDisable no<br />
affa --make-cronjobs<br />
<br />
=== Utilisation et options de ligne de commande ===<br />
{{Note box|Les options peuvent être abrégées tant qu'elles restent uniques, ex. --mak est identique à --make-cronjobs}}<br />
'''affa --run JOB'''<br />
Lance une tâche. Normalement effectué par cronjob. <br />
<br />
<br />
'''affa --make-cronjobs'''<br />
Configure les tâches cron comme programmées dans les enregistrements de tâches.<br />
<br />
<br />
'''affa --send-key JOB'''<br />
'''affa --send-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Génère d'abord la clé DSA pour le serveur Affa, si cela n'a pas déjà été fait. Envoie ensuite la clé publique à l'hôte 'remoteHostName' comme configuré dans l'enregistrement de la tâche et génère l'entrée ssh known host (hôte connu) spécifique à la tâche. <br />
{{Note box|Initialement, lorsque vous faites cette étape, vous aurez besoin d'activer temporairement "Autoriser l'authentification par SSH à l'aide de mots de passe standards" sur le serveur de production.}}<br />
{{Note box|<nowiki>l'option --send-key fonctionne pour SME Server comme serveur distant et pour les systèmes sur lesquels les clés publiques sont stockées dans /root/.ssh/authorized_keys2 et sur lesquels les commandes /bin/cat, /bin/touch, /bin/grep et /bin/mv sont disponibles. Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}<br />
<br />
<br />
'''affa --full-restore JOB [ARCHIVE]'''<br />
Effectue une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur source distant comme défini dans l'enregistrement JOB. Si [ARCHIVE] n'est pas donnée, l'archive 'scheduled.0' est utilisée comme défaut. La restauration totale reconstruit le serveur comme il était au moment de la sauvegarde. Après la restauration l'hôte source est redémarré.<br />
<br />
<br />
'''affa --rise [--all] JOB [ARCHIVE]'''<br />
Lance une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur Affa <b>(!)</b> comme défini dans l'enregistrement JOB. Autrement dit, une fois terminée, le serveur de sauvegarde reboote comme un clone du serveur source. Assurez-vous d'avoir arrêté le serveur source avant de rebooter le serveur de sauvegardes, sinon l'interface réseau ne sera pas activée. Cela est important, lorsque vous lancez --rise à distance. La fonction --rise ne fonctionne qu'avec les serveurs SME 7et ne devrait être utilisée que sur les serveurs de sauvegardes dédiés.<br />
<br />
Avec l'option --all, tous les fichiers et répertoires de l'archive tels que définis par les propriétés include[] sont restaurés. Les fichiers et répertoires avec le même nom sur le serveur Affa seront écrasés et ne peuvent pas être restaurés par un undoris. Cela ne devrait pas poser de problème sur un serveur Affa dédié qui ne contient aucune autre donnée. Après un éventuel undorise ces données aditionnelles restaurées doivent être supprimées manuellement.<br />
<br />
Remarquez que le processus rise sauvegarde le serveur Affa lui-même avant d'effectuer la restauration de l'archive. Cette sauvegarde est utilisée par un éventuel undorise pour restaurer le serveur Affa. Seulement les fichiers et répertoires standards sont sauvegardés. Les données dans des endroits non standard (comme /opt) ne sont pas touchées et existeront encore après le rise. Voir aussi : [[Backup_server_config#Standard_backup_.26_restore_inclusions]]<br />
<br />
<br />
'''affa --undo-rise'''<br />
Cette fonction reconvertit en serveur de sauvegarde un serveur Affa préalablement converti en serveur de production. Après un redémarrage, toutes les tâches configurées fonctionneront à nouveau.<br />
<br />
<br />
'''affa --unchunk-archive JOB ARCHIVE'''<br />
Concatène et décompresse tous les fichiers découpés dans l'archive ARCHIVE de la tâche JOB pour rendre l'archive prête pour une restauration. Notez que l'archives la plus récente scheduled.0 n'est jamais découpée et donc qu'elle peut être restaurée telle quelle sans re-concaténation préalable.<br />
<br />
<br />
'''affa --chunk-archive JOB ARCHIVE'''<br />
Découpe et compresse tous les fichiers dont les noms correspondent à la propriété chunkFiles pour économiser l'espace disque. Cela ne devrait être utilisé que comme l'inverse de --unchunk-archive. Les découpages sont stockés en fichiers bzip2 dans un répertoire nommé FILENAME.affa-chunks avec 8 niveaux de profondeur.<br />
<br />
<br />
<br />
'''affa --create-backup-file JOB [ARCHIVE] [--outfile=FILE]'''<br />
Crée une archive tar gzippée FILE depuis l'ARCHIVE de la tâche JOB. Pendant la création la somme MD5 est calculée puis le fichier tar enregistré lui est comparé. L'archive par défaut est schedule.0 et le fichier FILE par défaut est./smeserver.tg. La somme de contrôle est écrite dans FILE.md5sum.<br />
<br />
Un fichier smeserver.tgz stocké sur un disque USB peut être utilisé pour restauration lors d'une nouvelle installation de SME Server.<br />
<br />
<br />
'''affa --list-archives [--csv] JOB'''<br />
Affiche un tableau de toutes les archives de la tâche JOB existantes, avec la date, le nombre de fichiers, la taille et l'espace disque utilisé. <br />
<small><pre><br />
Affa version 2.0.0-rc4 on affa1.mydomain.de (10.204.48.2)<br />
+------------------------------------------------------------------------------+<br />
| Job: primmail |<br />
| Description: Mailserver Albstadt |<br />
| Directory: /var/affa/primmail/ |<br />
| Hostname: 10.204.144.2 |<br />
| Email: admin@mydomain.de |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| Run | Completion date | Exec Time | Files | Size | Recvd |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| M 9 | Sun 2008 Mar 02 06:11 | 0h29m47s | 679010 | 80GB | 60MB |<br />
| M 8 | Sun 2008 Mar 30 06:12 | 0h26m59s | 701683 | 83GB | 48MB |<br />
| M 7 | Sun 2008 Apr 27 06:16 | 0h28m01s | 731332 | 87GB | 47MB |<br />
| M 6 | Sun 2008 Jun 01 06:20 | 0h27m37s | 755529 | 90GB | 50MB |<br />
| M 5 | Sun 2008 Jun 29 06:24 | 0h28m39s | 800200 | 94GB | 52MB |<br />
| M 4 | Sun 2008 Jul 27 06:28 | 0h29m10s | 835398 | 99GB | 59MB |<br />
| M 3 | Sun 2008 Aug 31 06:34 | 0h34m53s | 869409 | 101GB | 65MB |<br />
| M 2 | Sun 2008 Sep 28 06:38 | 0h33m19s | 910889 | 106GB | 59MB |<br />
| M 1 | Sun 2008 Oct 26 06:42 | 0h38m41s | 932627 | 110GB | 61MB |<br />
| M 0 | Sun 2008 Nov 30 06:48 | 0h51m44s | 954090 | 116GB | 75MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| W 3 | Sun 2008 Dec 14 06:50 | 0h53m34s | 962267 | 118GB | 68MB |<br />
| W 2 | Sun 2008 Dec 21 06:52 | 0h53m11s | 974914 | 120GB | 69MB |<br />
| W 1 | Wed 2008 Dec 24 06:52 | 0h48m58s | 974536 | 120GB | 64MB |<br />
| W 0 | Sun 2008 Dec 28 06:58 | 0h39m01s | 977003 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| D 6 | Tue 2008 Dec 30 06:52 | 0h54m45s | 976872 | 120GB | 77MB |<br />
| D 5 | Wed 2008 Dec 31 06:52 | 0h49m10s | 977764 | 120GB | 63MB |<br />
| D 4 | Thu 2009 Jan 01 06:28 | 0h28m09s | 977879 | 120GB | 60MB |<br />
| D 3 | Fri 2009 Jan 02 06:53 | 0h53m21s | 978144 | 120GB | 68MB |<br />
| D 2 | Sat 2009 Jan 03 06:53 | 0h53m15s | 978072 | 120GB | 60MB |<br />
| D 1 | Sun 2009 Jan 04 06:53 | 0h53m16s | 976478 | 120GB | 70MB |<br />
| D 0 | Mon 2009 Jan 05 06:52 | 0h52m42s | 977062 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| S 1 | Mon 2009 Jan 05 17:57 | 0h27m48s | 976353 | 120GB | 98MB |<br />
| S 0 | Tue 2009 Jan 06 06:52 | 0h52m55s | 976539 | 120GB | 70MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
</pre></small><br />
Avec --csv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --status [--csv]'''<br />
Affiche un tableau de toutes les tâches actives (status enabled), avec l'heure de dernier et prochain lancement, la taille, l'espace disque utilisé par la plus récente archive, la date d'exécution du dernier lancement, et le nombre d'archives programmées (S), quotidiennes (D), hebdomadaires (W), mensuelles (M) et annuelles (Y). Le dernier lancement (colonne 'Last') affiche 'failed' si une tâche n'a pas été lancée dans les dernières 24h. Pour les tâches désactivées, 'Last' affiche toujours 'failed' au bout de 24 h. Pour voir la date et l'heure du dernier lancement de ces tâches, utilisez l'option --list-archives. La colonne 'Next' montre l'heure à laquelle le prochain lancement aura lieu, si 'Enabled' est à 'yes'.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| Job | ENA | Last | Exec Time | Next | Size | N of S,D,W,M,Y |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| erp-alb-rsyncd | yes | 00:20 | 0h00m14s | 00:20 | 46MB | 1, 7, 4,10, 0 |<br />
| erp-fra-rsyncd | yes | 02:46 | 0h01m03s | 02:45 | 712MB | 1, 7, 4,10, 0 |<br />
| esxi-TS-W2K | yes | 00:37 | 4h22m08s | 20:15 | 60GB | 1, 7, 1, 0, 0 |<br />
| esxi-W2KR2 | yes | 02:22 | 3h52m09s | 22:30 | 40GB | 1, 7, 1, 0, 0 |<br />
| helpdesk | yes | 00:25 | 0h00m47s | 00:25 | 117MB | 1, 7, 4,10, 0 |<br />
| imageserv | yes | running (pid 16477) | 1, 7, 4,10, 0 |<br />
| intraweb | yes | 06:34 | 0h04m50s | 18:00 | 2.1GB | 2, 7, 4,10, 0 |<br />
| pdcalb | yes | 21:19 | 0h14m27s | 21:05 | 89GB | 1, 7, 4,10, 0 |<br />
| pdcfra | yes | 04:18 | 0h03m33s | 04:15 | 33GB | 1, 7, 4,10, 0 |<br />
| primmail | yes | 06:52 | 0h52m55s | 17:30 | 120GB | 2, 7, 4,10, 0 |<br />
| rayofhope | yes | 21:52 | 0h07m40s | 21:45 | 26GB | 1, 7, 4,10, 0 |<br />
| smecrmpg | yes | 22:35 | 0h00m21s | 22:35 | 70MB | 1, 7, 4,10, 0 |<br />
| sozserv | yes | 02:09 | 0h04m03s | 02:05 | 5.9GB | 1, 7, 4,10, 0 |<br />
| wiki | yes | 03:45 | 0h00m27s | 03:45 | 278MB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| az32share | no | - | 0h00m22s | 03:05 | 1.3GB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
</pre></small><br />
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --disk-usage'''<br />
Affiche l'utilisation actuelle du disque pour les répertoires racine de tous les systèmes de fichiers.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup2.mydomain.de (10.204.0.52)<br />
+------+--------+--------+----------------------------------------------------+<br />
| Use% | Used | Avail | Root Dir |<br />
+------+--------+--------+----------------------------------------------------+<br />
| 71% | 938GB | 365GB | /var/affa |<br />
| 20% | 194GB | 759GB | /mnt/affadev |<br />
+------+--------+--------+----------------------------------------------------+<br />
</pre></small><br />
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --show-schedule [--all]'''<br />
Affiche un calendrier 'graphique' de toutes les tâches actives. La résolution est de 30 minutes. Un 'X' indique les heures de lancement programmés. La durée de la dernière exécution est marquée avec des '='.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
TIME 0:00 4:00 8:00 12:00 16:00 20:00<br />
erp-alb-rsyncd X------- -------- -------- -------- -------- --------<br />
helpdesk X------- -------- -------- -------- -------- --------<br />
esxi-W2KR2 =====--- -------- -------- -------- -------- -----X==<br />
esxi-TS-W2K ==------ -------- -------- -------- -------- X=======<br />
imageserv ---X---- -------- -------- -------- -------- --------<br />
sozserv ----X--- -------- -------- -------- -------- --------<br />
erp-fra-rsyncd -----X-- -------- -------- -------- -------- --------<br />
wiki -------X -------- -------- -------- -------- --------<br />
pdcfra -------- X------- -------- -------- -------- --------<br />
primmail -------- ----X=-- -------- -------- ---X---- --------<br />
intraweb -------- -----X-- -------- -------- ----X--- --------<br />
pdcalb -------- -------- -------- -------- -------- --X-----<br />
rayofhope -------- -------- -------- -------- -------- ---X----<br />
smecrmpg -------- -------- -------- -------- -------- -----X--<br />
1 disabled jobs not listed. Use --all to display.<br />
</pre></small><br />
<br />
<br />
'''affa --send-status'''<br />
Envoie le tableau d'état, l'espace disque utilisé et la liste des archives de toutes les tâches à l'adresse email configurée dans l'enregistrement 'DefaultAffaConfig'. Cette commande est utilisée par la tâche cron 'affa status'.<br />
<br />
<br />
'''affa --mailtest JOB'''<br />
Envoie un email de test aux adresses email configurées dans l'enregistrement de la tâche. Avec la propriété 'Watchdog' à 'yes', un email de test est envoyé depuis le serveur distant aussi. Utilisez cela pour vérifier que l'envoi des mails fonctionne.<br><br />
'''Note:''' Par défaut, Affa n'envoie des messages qu'en cas d'erreur, jamais en cas de succès (voir la propriété 'chattyOnSuccess').<br />
<br />
<br />
'''affa --cleanup JOB'''<br />
Après que vous ayez diminué le temps de conservation (scheduledKeep), les archives avec un indice plus élevé ne seront plus supprimées automatiquement et existeront toujours. Cette option trouve ces archives et les supprime.<br />
<br />
<br />
'''affa --rename-job JOB NEWNAME'''<br />
Renomme la tâche JOB en NEWNAME, y compris tous les enregistrements de la base de données et les répertoires d'archive.<br />
<br />
<br />
'''affa --move-archive JOB NEWROOTDIR'''<br />
Déplace le répertoire d'archive de JOB vers NEWROOTDIR et ajuste la propriété RootDir. NEWROOTDIR doit être un chemin complet (full path) commençant par un slash. Comme le déplacement d'un système de fichiers à un autre (par exemple d'un disque USB à un disque local) n'est pas possible, Affa se sert dans ce cas d'une commande de copie et efface ensuite le répertoire source. Selon la taille de l'archive, la copie d'un système de fichiers à l'autre peut prendre longtemps.<br />
<br />
<br />
'''affa --delete-job [--revoke-key] JOB'''<br />
Efface irréversiblement une tâche, y compris toutes les archives, la configuration et les bases de données attachées. En passant l'option '--revoke-key', la clé publique sur le serveur distant sera détruite.<br />
<br />
<br />
'''affa --revoke-key JOB'''<br />
'''affa --revoke-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Détruit la clé DSA publique sur le serveur distant.<br />
{{Note box|<nowiki>L'option --revoke-key seule fonctionne sur SME Server comme serveur distant et pour les systèmes où les clés sont stockées dans /root/.ssh/authorized_keys2 Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}<br />
<br />
<br />
'''affa --check-connections'''<br />
Contrôle le login ssh pour toutes les tâches configurées. Pour les tâches pour lesquelles la clé publique n'avait pas encore été envoyée, il vous sera demandé le mot de passe et la clé sera envoyée ensuite.<br />
<br />
<br />
'''affa --kill JOB'''<br />
Termine la tâche en cours JOB et tous les processus fils (les processus rsync)..<br />
<br />
'''affa --debug'''<br />
Active un journal verbeux. Remplace la tâche et les configurations globales.<br />
<br />
=== Exemples de configuration ===<br />
==== Serveur de sauvegarde dédié ====<br />
* Configurez une tâche pour chaque serveur que vous voulez sauvegarder<br />
* Envoyez les clés publiques à chaque serveur.<br />
affa --send-key JOBNAME<br />
* Envoie la clé DSA correspontante à la tâche JOBNAME.<br />
affa --check-connections<br />
* Vérifie que les connexions sans mot de passe fonctionnent.<br />
affa --show-schedule<br />
* Vérifie si les tâches planifiées sont réparties dans la journée.<br />
affa --make-cronjobs<br />
* Crée les tâches cron.<br />
affa --status<br />
* Vérifie l'état après 24 heures.<br />
<br />
<br />
==== Sauvegarder une ibay individuellement ====<br />
Supposons que nous voulions sauvegarder les ibays 'staff1' et 'staff2' de notre serveur de production dont l'adresse IP WAN est 82.123.1.1 sur un serveur Affa déporté via internet, toutes les nuits à 2h30.<br />
* On se connecte sur le serveur Affa et on installe les paquetages comme décrit ci-dessus.<br />
* On copie l'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/ibay-staff-job.pl<br />
* On édite /root/ibay-staff-job.pl pour y mettre :<br />
my $jobname='ibay-staff';<br />
et<br />
'remoteHostName‘=>'82.123.1.1',<br />
'TimeSchedule'=>'0230',<br />
'SMEServer'=>'no',<br />
'Include[0]'=>'/home/e-smith/files/ibays/staff1',<br />
'Include[1]'=>'/home/e-smith/files/ibays/staff2',<br />
* On enregistre la configuration<br />
/root/ibay-staff-job.pl<br />
* On envoie la clé publique au serveur de production<br />
affa --send-key ibay-staff<br />
* On vérifie le lendemain matin :<br />
affa --list-archives ibay-staff<br />
affa --status<br />
* Vérifie l'état après 24 heures.<br />
ls /var/affa/ibay-staff<br />
<br />
==== Deux serveurs de production qui se sauvegardent mutuellement ====<br />
Vous avez deux sites connectés via un VPN et un serveur SME fonctionnant sur chaque site. Dans ce cas, vous n'avez pas besoin d'un serveur de sauvegarde Affa dédié. Les deux serveurs de production peuvent en plus agir chacun comme un serveur Affa sauvegardant le serveur de l'autre site. Installez simplement Affa et configurez une tâche qui sauvegarde l'autre serveur. Vous pouvez utiliser toutes les fonctionnalités Affa excepté la fonctionnalité rise. <br />
En utilisant la fonctionnalité rise, le serveur devient n'importe lequel des systèmes sauvegardés, ce qui est moins utile dans ce scénario puisque cela vous donnerait une copie fonctionnelle du serveur de l'autre site lorsque celui-ci est en panne.<br />
<br />
Pour obtenir une redondance et une restauration plus rapide, vous pouvez configurer une sauvegarde locale sur un disque USB externe ou sur un NAS.<br />
<br />
Attention de ne pas sauvegarder à nouveau les archives de l'autre site. Configurez la propriété RootDir vers un chemin qui n'est pas inclu dans la liste de sauvegarde par défaut de SME. En laissant la propriété RootDir par défaut sur '/var/affa', cela est garanti.<br />
<br />
==== Sauvegarde d'un ordinateur Windows ====<br />
Sauvegarder les données d'un système Windows nécessite que le démon Rsyncd Cygwin soit installé et configuré sous Windows. La procédure "rsync over ssh" ne fonctionne pas, puisque le processus rsync Cigwin se plante systématiquement après le transfert de quelques fichiers. <br />
<br />
===== Configuration de Rsyncd sur l'ordinateur Windows ===== <br />
Installez la base Cygwin, le paquetage rsync puis configurez le service Rsyncd comme décrit dans ce document : [[Rsyncd setup on a windows computer for use with Affa backup]]'. <br />
L'installation du service sshd est optionnelle et n'est pas nécessaire pour la sauvegarde elle-même, mais avoir une connexion ssh peut être très utile pour l'administration et pour exécuter des scripts sur le système Windows. Affa supporte l'envoi de la clé publique vers un ordinateur Windows Cygwin pour une connexion sans mot de passe.<br />
<br />
Note: Affa ne sauvegarde pas l'information Windows Access Control List (ACL). Vous pourriez avoir à corriger les ACLs après une restauration.<br />
<br />
===== Configuration du mode Affa Rsyncd (exemple de démarrage rapide) =====<br />
Vous voulez sauvegarder les répertoires ''Mes Documents''des utilisateurs ''ssorglos'' et ''bsimpson'' depuis l'ordinateur Windows 'ws001' avec l'IP 192.168.1.65 sur votre serveur Affa 'affabox' avec l'IP 192.168.1.3.<br />
* connectez-vous sur 'affabox' et copiez le script exemple de configuration Cygwin<br />
cp /usr/lib/affa/jobconfig-cygwin-sample.pl /root/ws001-mydocs-job.pl<br />
* editez /root/ws001-mydocs-job.pl et mettez<br />
my $jobname='ws001-mydocs';<br />
et<br />
'remoteHostName‘=>'192.168.1.65',<br />
'rsyncdPassword'=>'<i>secretword</i>',<br />
'Include[0]'=>'/c/Documents and Settings/ssorglos/My Documents/', ''# N'utilisez pas les backslashes dans les chemins !''<br />
'Include[1]'=>'/c/Documents and Settings/bsimpson/My Documents/',<br />
où ''secretword'' doit être remplacé par le mot de passe que vous avez choisi dans rsyncd.secretsfile sur l'ordinateur Windows.<br />
* Enregistrez la configuration (cela crée les entrées de base de données et configure les tâches cron.<br />
/root/ws001-mydocs-job.pl<br />
* Lancez la tâche manuellement. Après l'achèvement, vérifiez l'archive /var/affa/ws001-mydocs/scheduled.0 et le journal /var/log/affa/ws001-mydocs.log.<br />
affa --run ws001-mydocs<br />
<br />
===== Configuration manuelle d'Affa en mode Rsyncd =====<br />
Au cas où vous voudriez configurer manuellement en utilisant les commandes db, voici les paramètres obligatoires pour le mode Rsyncd Cygwin.<br />
db affa setprop JOB rsyncdMode yes<br />
db affa setprop JOB rsyncdModule AFFA<br />
db affa setprop JOB rsyncdUser affa<br />
db affa setprop JOB rsyncdPassword ''secretword''<br />
db affa setprop JOB SMEServer no<br />
db affa setprop JOB RPMCheck no<br />
db affa setprop JOB Watchdog no<br />
Optionel pour une connexion ssh.<br />
db affa setprop JOB remoteOS cygwin <br />
<br />
<br />
==== Utiliser Affa pour sauvegarder un NAS monté par NFS ou un disque USB local ====<br />
<br />
On désire sauvegarder notre serveur SME 7 de production dont le nom d'hôte est 'prodbox' et l'IP 10.200.48.1 sur un système de fichiers monté plutôt que de configurer un serveur Affa dédié.<br />
<br />
===== Configuration du NAS =====<br />
On dispose d'un serveur FREENAS dont l'adresse IP est 10.200.48.2 en fonction et avec le service NFS activé. Le disque est monté sur /mnt/affashare. On a autorisé l'adresse IP de notre serveur de production à accéder au partage /mnt/affashare.<br />
* On se logge sur 'prodbox' et on installe les paquetages NFS :<br />
/usr/bin/yum install --enablerepo=smecontribs smeserver-nfs<br />
* maintenant, on active et on démarre le service portmapper.<br />
config setprop portmap status enabled<br />
service portmap start<br />
<br />
* On monte le partage NFS :<br />
mkdir -p /mnt/affadevice<br />
mount 10.200.48.2:/mnt/affashare /mnt/affadevice<br />
<br />
<br />
===== Alternative : configuration du disque USB =====<br />
* On se logge sur 'prodbox'<br />
* On connecte le disque USB sur le bus USB. On doit maintenant déterminer sur quel 'device' le noyau a placé le lecteur. On regarde /var/log/messages et on cherche la ligne d'initialisation correspondante (Initializing USB Mass Storage driver). Quelques lignes plus bas, on trouve le nom du device. Supposons qu'il s'agisse de 'sdh'. Si ce n'est pas le cas, on remplacera dans les instructions ci-après /dev/sdh par la valeur trouvée.<br />
* On crée une partition linux avec fdisk : '''Il faut bien vérifier que c'est bien le disque USB qui est attaché avant de continuer !'''<br />
<br />
fdisk /dev/sdh<br />
On trouvera probablement une partition dos vfat, qu'on devra d'abord détruire. Supposons que nous ayons créé une seule partition ''/dev/sdh1''.<br />
* On formatte avec un système ext3 :<br />
mkfs.ext3 /dev/sdh1<br />
* On crée le point de montage :<br />
mkdir -p /mnt/affadevice<br />
* On ajoute notre disque USB dans /etc/fstab. On crée donc une nouvelle ligne avec :<br />
/dev/sdh1 /mnt/affadevice ext3 defaults<br />
* On monte le disque :<br />
mount /mnt/affadevice<br />
* On fait une vérification croisée avec df :<br />
df<br />
<br />
<br />
===== Configuration d'Affa =====<br />
On veut lancer des sauvegardes à 11h30, 15h30, 19h30 et on veut garder les 3 dernières, 7 journalières, 5 hebdomadaires, 12 mensuelles et 1 annuelle.<br />
* On se logge sur 'prodbox' et on installe les paquetages Affa comme indiqué ci-dessus.<br />
* On copie l'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
* On édite /root/prodbox-job.pl pour y mettre :<br />
my $jobname='prodbox';<br />
et<br />
'remoteHostName‘=>'localhost',<br />
'TimeSchedule'=>'1130,1530,1930',<br />
'scheduledKeep'=>3,<br />
'dailyKeep'=>7,<br />
'weeklyKeep'=>5,<br />
'monthlyKeep'=>12,<br />
'yearlyKeep'=>1,<br />
'RootDir=>'/mnt/affadevice',<br />
On vérifie les autres propriétés et on les change si besoin.<br />
* On enregistre la configuration<br />
/root/prodbox-job.pl<br />
* On lance la tâche manuellement :<br />
<br />
affa --run prodbox<br />
<br />
<br />
===== Limitations =====<br />
Avec ce type de configuration, on ne peut pas utiliser la fonction 'rise' (conversion du serveur de sauvegarde en serveur de production), puisqu'elle nécessite que l'archive soit sur le même système de fichiers que le serveur. La fonction 'rise' utilise les hardlinks, qui ne fonctionnent pas entre systèmes de fichiers différents.<br />
<br />
===== Automount : montage automatique =====<br />
Avoir les archives de sauvegarde sur le même système de fichiers est toujours un risque, qui peut être minimisé en utilisant la fonction automount. Ainsi, le système de fichiers externe n'est monté que durant le déroulement d'une tâche.<br />
<br />
Dans l'exemple NAS, configurez :<br />
'AutomountDevice=>'10.200.48.2:/mnt/affashare',<br />
'AutomountPoint =>'mnt/affadevice',<br />
et sautez l'étape 2<br />
<br />
Dans l'exemple du disque USB, configurez :<br />
'AutomountDevice=>'/dev/sdc1',<br />
'AutomountPoint =>'mnt/affadevice',<br />
et sautez les étapes 5 à 8.<br />
<br />
Le point de montage sera automatiquement créé, s'il n'existe pas. <br><br />
Pour accéder au répertoire de l'archive, vous devez le monter à la main.<br />
<br />
=== Restauration ===<br />
==== Restauration de fichiers ou répertoires individuels ====<br />
'''Example 1:''' Nous sommes le Mardi 6 Janvier 2009 quand l'utilisateur 'briedlin' vous demande de restaurer les messages de sa boite 'orders' qu'il a malencontreusement détruite Lundi.<br />
<br />
* Vous devez d'abord regarder quelles sont les archives disponibles. Le nom de tâche de ce serveur de sauvegardes est 'primmail. Pour avoir une liste de toutes les archives, lancez <br />
affa --list-archives primmail<br />
''(voir la liste exemple dans le chapitre [[Affa#Usage_and_command_line_options]]''<br />
* Choisissez l'archive daily.0, qui a été créée la nuit de Lundi. Maintenant, restaurez la mailbox 'orders' en utilisant la commande rsync.<br />
* Maintenant, lancez la commande rsync (notez le slash en fin !) sur le serveur de sauvegarde Affa.<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av -e 'ssh -p 2222' /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
<br />
<br />
'''Example 2:''' Un utilisateur a effacé le fichier orderform.pdf dans l'ibay 'docs' du serveur 10.204.48.1 et vous demande de le restaurer.<br />
<br />
* Vous avez cherché et trouvé la dernière version de ce fichier dans l'archive hebdomadaire de la tâche 'prodserv'.<br />
* Pour la recopier vers le serveur 10.204.48.1 lancez sur le serveur Affa<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av -e 'ssh -p 2222' /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
<br />
<br />
'''Example 3:''' Restaurer un fichier avec un caractère spécial dans le chemin<br />
<br />
N'utilisez pas les variables shell pour raccourcir la commande. Cela compliquerait les choses plus que cela aiderait.<br />
Mettez entre guillemets les chemins source et destination. Dans le chemin de destination, echappez les caractères blancs avec un double backslash et les parenthèses avec un simple backslash. Sur le serveur de sauvegardes AFFA lancez :<br />
rsync -av "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
<br />
rsync -av -e 'ssh -p 2222' "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
==== Restauration complète ====<br />
Pour lancer une restauration complète des utilisateurs et des données de configuration, lancez sur le serveur Affa<br />
affa --full-restore <JOB> [<ARCHIVE>]<br />
Cela synchroniste (par rsync) les données de la sauvegarde ARCHIVE vers l'ordinateur 'remoteHostname' défini dans la configuration de la tâche JOB. <br />
<br />
Exemple:<br />
Vous avez sauvegardé votre serveur de production 'prodsrv' par une tâche 'prodbox'. Pour restaurer la dernière sauvegarde, lancez<br />
affa --full-restore prodbox<br />
<br />
Pour restaurer la plus ancienne archive daily.3, lancez <br />
affa --full-restore prodbox daily.3<br />
<br />
{{Warning box| Une restauration complète reconstruit le serveur tel qu'il était au moment de la sauvegarde. Cela signifie que tous les fichiers créés ou les changement de configuration due serveur effectués après la sauvegarde seront perdus. Après la restauration, le serveur restauré redémarre automatiquement. }}<br />
<br />
==== Migration d'un serveur SME7 vers un nouveau matériel en utilisant la fonctionnalité "Affa rise" ====<br />
Merci de consulter cet Howto: [[Moving SME to new Hardware]]<br />
<br />
<br />
==== Restauration d'un disque USB sur un nouveau serveur ====<br />
<br />
<br />
Cette astuce vient de http://forums.contribs.org/index.php?topic=42412.0<br />
<br />
Q) J'ai des sauvegardes complètes stockées sur un disque dur USB connecté sur notre serveur de sauvegarde Affa. J'ai besoin de restaurer une ancienne sauvegarde mensuelle de notre tâche "mailbackup" sur un serveur de tests à la place du système original. Si je le fais depuis le serveur de sauvegardes, je vois les instructions pour remonter ce serveur depuis la sauvegarde courante, mais je veux restaurer d'un état datant d'environ un mois, avant que d'étranges choses se soient passées. Et je veux le faire sur une machine qui n'est pas notre serveur de sauvegarde ni notre serveur de production. J'ai tenté d'imaginer comment faire, mais je suis perdu dans les options. Mon but est de faire quelques tests.<br />
<br />
R) Sur votre serveur de tests, configurez une tâche "mailbackup" identique à celle de votre serveur de sauvegardes, mais paramétrez correctement RootDir en /var/affa et mettez la propriété "status" sur "disabled" Connectez le lecteur USB et copiez l'archive de la tâche "mailbackup" dans /var/affa. Ensuite, lancez affa --rise mailbackup ARCHIVE<br />
<br />
Rappelez-vous qu'Affa place les scripts de configuration de tâches dans les répertoires d'archive. Dans votre cas, c'est mailbackup-setup.pl. Copiez-le sur votre serveur de tests, changez les propriétés RootDir et status, puis exécutez-le.<br />
<br />
=== FAQ ===<br />
'''Quels fichiers et répertoires sont inclus par défaut ?'''<br />
<br />
Avec SMEServer=no aucun.<br />
<br />
Avec SMEServer=yes la liste par défaut des sauvegardes SME. TLa commande suivante affiche la liste :<br />
perl -e 'use esmith::Backup;$b=new esmith::Backup;print join("\n",$b->restore_list)."\n"' <br />
<br />
<br />
'''Puis-je sauvegarder exclusivement des fichiers d'images contenus dans un répertoire spécifique ?'''<br />
<br />
Oui. Supposant que vous voulez sauvegarder tous les fichiers gif et jpg du répertoire /home/e-smith/files/ibays/pictures/files utilisez cette configuration<br />
db affa setprop JOBNAME SMEServer no # Ne pas inclure les répertoires et fichiers par défaut de SME Server<br />
db affa setprop JOBNAME Include[0] '/home/e-smith/files/ibays/pictures/files' # Commencer à chercher ici<br />
db affa setprop JOBNAME Include[1] '*/' # Chercher récursivement dans l'arborescence<br />
db affa setprop JOBNAME Include[2] '*.gif' # Copier les fichiers qui correspondent à ce profil<br />
db affa setprop JOBNAME Include[3] '*.jpg' <br />
db affa setprop JOBNAME Exclude[0] '*' # Exclure tous les autres<br />
db affa setprop JOBNAME rsyncOptions '-m' # Ne pas créer les répertoires vides<br />
<br />
<br />
'''Comment puis-je déplacer une archive de sauvegarde de mon serveur de production dans une agence distante vers le serveur Affa en utilisant un disque USB ? Je veux éviter de télécharger la première sauvegarde complète depuis internet.<br />
Installez Affa sur votre serveur de production, connectez et montez le disque USB.''' Configurez une tâche pour enregistrer la sauvegarde sur le disque USB. Une fois la tâche exécutée, connectez le disque USB à votre serveur Affa et configurez la tâche de la même manière. Utilisez le script de configuration du répertoire d'archive. Vous n'avez à mofier que la propriété "remoteHostName". Maintenant, utilisez l'option --move-archive pour transférer l'archive sur le disque local. Si ce n'est pas déjà fait, envoyez la clé publique à votre serveur de production. C'est fait.<br />
<br />
<br />
'''Comment je sauvegarde deux serveurs SME derrière un pare-feu ?'''<br />
D'abord, vous devez configurer les port forwardings pour le service ssh sur votre pare-feu. Utilisez un port non standard, par ex. 2200->22, pour votre second serveur. Configurez une tâche sur votre serveur de sauvegarde Affa pour chacun de vos serveurs de production. Configurez la propriété sshPort=2200 pour votre second serveur.<br />
<br />
=== Désinstallation ===<br />
Cela supprime le paquetage Affa installé, toutes les données de configuration et toutes les archives de sauvegarde.<br />
<br />
Lancez les commandes suivantes pour chaque tâche :<br />
affa --revoke-key JOBNAME<br />
affa --delete-job JOBNAME<br />
Verifie que toutes les tâches ont été supprimées.<br />
affa --status<br />
Suprime le paquetage Affa<br />
rpm -e smeserver-affa<br />
et, si ces paquetages ne sont pas des dépendances d'autres paquetages :<br />
Nettoyage général<br />
rm -f /etc/cron.d/affa /etc/cron.d/affa-status<br />
rm -rf /home/e-smith/db/affa /home/e-smith/db/affa-report<br />
rm -rf /var/affa /var/log/affa<br />
<br />
=== Rapport de bugs ===<br />
Affa est répertorié dans [http://bugs.contribs.org/enter_bug.cgi?product=SME%20Contribs&component=smeserver-affa bugtracker contribs section].<br />
SVP, rapportez là tous les bugs, demandes de nouvelles fonctionnalités et problèmes de documentation. <br />
<br />
=== Informations complémentaires ===<br />
Pour les détails de performance, la liste des modifications etc. voyez [[:Affa:Additional information]]<br />
<br />
=== Références ===<br />
* Article Wikipedia http://en.wikipedia.org/wiki/Rsync<br />
* Site Rsync http://rsync.samba.org/<br />
* Article Wiki [[Moving SME to new Hardware]]<br />
* Article Wiki [[Backup with Affa and FreeDup]]<br />
* Article Wiki [[Rsyncd setup on a windows computer for use with Affa backup]]<br />
* Article Wiki [[Backup Windows Computers Using Affa]]<br />
* Article Wiki [[Backup of ESXi Virtual Machines using Affa]]<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Backup/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Affa/fr&diff=12733Affa/fr2009-04-09T19:35:15Z<p>Cool34000: fix lang</p>
<hr />
<div>{{Languages|Affa}}<br />
{{Level|Advanced}}<br />
<br />
=== Développeur ===<br />
Michael Weinberger<br />
<br />
=== Traducteur ===<br />
[http://bj-informatique.com/affa.php?lang=fr jibe]<br />
<br />
Affa signifie '''A'''utomatische '''F'''estplatten '''F'''ern'''a'''rchivierung, soit approximativement en français : Sauvegarde automatique de disque dur à distance.<br />
<br />
<br />
=== Description ===<br />
Le but principal de ce paquetage Affa est de transformer un serveur SME 7 en un serveur dédié de sauvegardes en quelques minutes. Affa sauvegarde autant que vous le désirez de serveurs SME sur n'importe quel autre serveur ayant sshd en service et rsync installé. Une fois qu'il est configuré, Affa fonctionne sans surveillance et de manière fiable, envoyant des messages d'avertissement en cas d'erreur. <br />
<br />
Toutes les archives sont des sauvegardes complètes, puisque Affa utilise la technique des hardlink. Une nouvelle sauvegarde complète ne nécessite donc que l'espace disque pour les différences et les nécessités du système de fichier pour les hardlinks et les répertoires (ce qui représente généralement 2-3%).<br />
<br />
Affa est basé sur le programme rsync et supporte l'option --compress. Cela vous permet de lancer des sauvegardes via internet ou VPN. ne configuration typique consiste en un ou plusieurs serveurs de sauvegarde Affa placés en des lieux déportés, qui sauvegardent les serveurs de production via le VPN.<br />
<br />
Une caractéristique spéciale est l'option "rise", qui vous permet de convertir votre serveur de sauvegarde en serveur de production depuis une archive sauvegardée en cas de perte totale de votre serveur de production. Cette conversion est exécutée en un temps très court, même avec une énorme quantité de données. Cette possibilité de conversion utilise les hardlinks et de ce fait n'utilise pas d'espace disque supplémentaire.<br />
<br />
Affa est un outil en ligne de commande pour les administrateurs système et est conçu intentionnellement sans interface graphique. De ce fait, il peut être géré efficacement depuis la console même via une connexion internet lente.<br />
<br />
'''Note:''' Ce document concerne la version 2 Release Candidate d'Affa. La documentation de la dernière version 1 stable se trouve [http://wiki.contribs.org/index.php?title=Affa&oldid=11974 ici].<br />
<br />
==== Un coup d'oeil aux caractéristiques d'Affa ====<br />
* Affa est sûr : Tous transferts et connexions sont faits en utilisant le protocole ssh avec une authentification par clés publique/privée.<br />
* Lance périodiquement des sauvegardes complètes sans intervention. * Seules les différences avec la sauvegarde complète précédente sont transférées par le réseau<br />
* Utilise rsync avec l'option de compression pour les connexions lentes, ce qui permet des sauvegardes via internet/VPN<br />
* Utilise la technique des hardlink pour réduire l'espace disque physique à seulement ce qui est nécessaire pour les différences entre deux sauvegardes complètes<br />
* Mémorise un nombre configurable de sauvegardes automatisées, journalières, hebdomadaires, mensuelles et annuelles<br />
* On peut naviguer dans les archives sans avoir à les décompresser. Il n'est pas nécessaire de les décompresser d'abord.<br />
* Les archives peuvent être attachées à un partage Samba.<br />
* Les tâches de sauvegarde sont démarrées par le démon cron<br />
* Les travaux interrompus continuent au redémarrage en tenant compte des données déjà transférées<br />
* Sauvegarde les répertoires et fichiers e-smith par défaut, lorsque la propriété SMEServer est mise à 'yes'<br />
* Des répertoires et fichiers supplémentaires peuvent être inclus<br />
* Des répertoires et fichiers peuvent être exclus de la sauvegarde<br />
* Les serveurs Linux non SME peuvent être sauvegardés en mettant la propriété SMEServer à 'no' et en utilisant une liste d'inclusion<br />
* En mode ESXi, les machines virtuelles actives peuvent être sauvegardées. Voir [[Sauvegarde de machines virtuelles ESXi avec Affa]]<br />
* Priorité configurable (nice level) pour les process rsync sur les serveurs backup et source<br />
* Possibilité de lancer des programmes personnels avant et après le lancement d'une tâche (par exemple, lancement d'une sauvegarde sur bande)<br />
* Vérification de l'espace disque disponible après le lancement d'une tâche avec niveaux d'avertissement strict, normal ou risqué<br />
* Vérification étendue des conditions d'échec<br />
* Envoi de messages d'échec à une liste configurable d'adresses email<br />
* Envoi d'un message d'avertissement si le serveur de backup n'a plus d'espace disque disponible<br />
* Installe un chien de garde optionnel sur le serveur source vérifiant la disponibilité du serveur de backup (SME server seulement)<br />
* Le chien de garde envoie des avertissements, si une sauvegarde programmée n'a pas été lancée (SME server seulement)<br />
* Le chien de garde envoie un message journalier de rappel tant que l'erreur n'est pas corrigée (SME server seulement)<br />
* Possibilité d'afficher l'état courant de toutes les tâches, montrant les heures de dernier et prochain lancement, la taille et l'espace disque utilisé<br />
* Le status peut être envoyé par email journellement, hebdomadairement ou mensuellement<br />
* Possibilit d'afficher toutes les archives existantes pour une tâche, montrant la date, le nombre de fichiers et l'espace disque<br />
* Possibilité d'envoyer (et de retirer) la clé publique au serveur source (SME server et ESXi seulement)<br />
* Option pour convertir le serveur de sauvegardes en serveur de production (SME server seulement)<br />
* La fonction de conversion ne déplace pas physiquement les données et est donc extrêmement rapide et ne nécessite (presque) pas d'espace disque<br />
* La fonction de conversion peut être lancée à distance puisque les drivers ethernet du serveur de sauvegarde sont conservés<br />
* Comparaison des RPMs installés entre les serveurs source et de sauvegarde. Envoie un avertissement s'il n'y a pas correspondance.<br />
* Annulation de la conversion pour remise en service du serveur de sauvegardes<br />
* Configurable par commandes style e-smith db, avec un enregistrement pour chaque tâche et un enregistrement par défaut commun à toutes les tâches<br />
* Logs dans /var/log/affa/JOB.log et /var/log/affa/affa.log avec option debug pour plus de détails<br />
* Les fichiers de log sont permutés hebdomadairement, avec 5 fichiers conservés<br />
<br />
<br />
=== Installation ou mise à jour ===<br />
Dernière version: '''smeserver-affa-2.0.0-rc4.noarch.rpm'''<br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/smeserver-affa-2.0.0-rc4.noarch.rpm</nowiki><br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm</nowiki><br />
/usr/bin/yum --enablerepo=smecontribs localinstall \<br />
smeserver-affa-2.0.0-rc4.noarch.rpm \<br />
perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm<br />
<br />
Après la première installation d'Affa, lancez la commande suivante pour initialiser la base de données Affa.<br />
affa --make-cronjobs<br />
et déconnectez-vous puis reconnectez-vous à la console pour que le complément automatique de bash (touche TAB) prenne effet<br />
<br />
=== Exemple de démarrage rapide ===<br />
Vous avez un serveur de production SME 7 dont le nom est 'prodbox' et l'IP 10.200.48.1. Installez un second SME 7 comme serveur de sauvegardes avec le nom 'affabox' et l'IP 10.200.48.2. <br />
<br />
<ol></li><li>loggez-vous dans 'affabox' et installez les paquetages mentionnés ci-dessus.<br />
</li><li>copiez le script d'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
</li><li>editez /root/prodbox-job.pl et mettez<br />
my $jobname='prodbox';<br />
et<br />
'remoteHostName‘=>'10.200.48.1',<br />
Eventuellement, si le port du serveur distant est configuré, par exemple, en 2222, mettez<br />
'sshPort'=>2222,<br />
</li><li>sauvegardez et lancez le fichier 'prodbox-job.pl'. Cela enregistrera la configuration (et crée les entrées de base de données et les tâches cron)<br />
/root/prodbox-job.pl<br />
</li><li>Générez les clés DSA et envoyez la clé publique à la 'prodbox'<br />
{{Note box|Initialement, lorsque vous faites cette étape, vous devez temporairement mettre oui à "Autoriser l'authentification par SSH à l'aide de mots de passe standards" dans l'accès à distance sur le serveur de production}}<br />
affa --send-key prodbox<br />
</li><li>Lancez la tâche à la main<br />
<br />
affa --run prodbox<br />
</li></ol><br />
<br />
=== Configuration ===<br />
La configuration est stockée dans une base de données style e-smith. Utilisez la commande db pour configurer Affa.<br />
Le nom de tâche est la clé d'enregistrement de type 'job'.<br>Pour configurer un nouveau travail avec le nom 'prodbox', entrez :<br />
<br />
db affa set prodbox job<br />
<br />
Puis positionnez les propriétés<br />
<br />
db affa setprop prodbox remoteHostName 192.168.1.1<br />
db affa setprop prodbox TimeSchedule '0030,0730,1130,1330,1730,2030'<br />
db affa setprop prodbox Description 'My Production Server'<br />
db affa setprop prodbox status enabled<br />
et ainsi de suite...<br />
<br />
Alternativement, vous pouvez utiliser un script comme décrit ci-dessus dans le chapitre 'Démarrage rapide'.<br />
<br />
Pour vérifier votre travail, tapez :<br />
<br />
db affa show prodbox<br />
<br />
Pour finir, mettez en place les tâches cron :<br />
affa --make-cronjobs<br />
<br />
==== Propriétés de configuration de tâches ====<br />
'''Note:''' Les valeurs par défaut données dans ce tableau sont celles du programme Affa et ne doivent pas être confondues avec les valeurs prépositionnées dans les scripts d'aide, par exemple jobconfig-sample.pl.<br />
{| border="1" cellpadding="3" cellspacing=0<br />
|-<br />
| '''Propriété''' || '''Valeur''' || '''Defaut''' || '''Description''' <br />
|-<br />
| remoteHostName <br />
| FQHN ou IP || || FQHN ou IP de l'hôte source (obligatoire)<br />
|-<br />
| TimeSchedule <br />
| HHMM,HHMM,... || || N'a pas besoin d'être ordonné. Au moins une heure est obligatoire. '''Important:''' Utiliser le bon format HHMM est essentiel. Affa ne le vérifie pas. Un TimeSchedule mal formatté provoquera d'étranges erreurs Perl. <br />
|-<br />
| Description<br />
| texte || || <br />
|-<br />
| scheduledKeep<br />
| entier >= 1 || 1|| Combien de sauvegardes programmées doivent être conservées <br />
|-<br />
| dailyKeep<br>weeklyKeep<br>monthlyKeep<br>yearlyKeep<br />
| entier >= 0 || 7<br>4<br>12<br>2<br>|| Combien de sauvegardes quotidiennes, hebdomadaires, mensuelles ou annuelles doivent être conservées <br />
|-<br />
| SMEServer<br />
| yes ''ou'' no || yes || Positionné à 'yes', les répertoires e-smith par défaut sont automatiquement inclus et la propriété RPMCheck=yes peut être utilisée<br />
<br />
|-<br />
| Include[0]<br>Include[1]<br>...<br />
| full path || || Fichiers ou répertoires supplémentaires à inclure à la sauvegarde <br />
|-<br />
| Exclude[0]<br>Exclude[1]<br>...<br />
| full path || || Fichiers ou répertoires supplémentaires à exclure de la sauvegarde <br />
|-<br />
| RPMCheck<br />
| yes ''ou'' no || no || Seulement applicable aux tâches qui sauvegardent un serveur SME 7.<br>Compares les RPM de l'hôte source avec ceux de l'hôte de sauvegarde affa. Envoie un message avec une liste de différences s'il n'y a pas correspondance. Cette vérification est utile, si vous voulez avoir la possibilité de convertir le serveur de sauvegarde en serveur de production.<br />
|-<br />
| DiskSpaceWarn<br />
| strict ''ou'' normal ''ou'' risky ''ou'' none || strict || lance une vérification de l'espace disque après qu'une tâche soit terminée. Avec le niveau 'strict' un message d'avertissement sera envoyé si l'espace disponible est moins que la taille de la sauvegarde qui vient de s'achever. Avec les niveaux 'normal'/'risky' le message est envoyé si moins de 50%/10% de la taille de la sauvegarde reste disponible.<br />
'''Note:''' Lorsque RootDir est un lien symbolique vers un autre système de fichiers, l'espace disque utilisé du système de fichiers local est vérifié à la place de celui du système de fichiers lié. Positionnez le point de montage comme RootDir pour avoir une vérification correcte.<br />
|-<br />
| localNice <br />
| -19...+19 || 0 || lance le process local rsync par nice. <br />
|-<br />
| remoteNice<br />
| -19...+19 || 0 || lance le process rsync de la source par nice. <br />
|-<br />
| Watchdog<br />
| yes ''ou'' no || yes || Seulement applicable aux tâches qui sauvegardent un serveur SME 7.<br>Quand une tâche est lancée, affa installe un script chien de garde sur la source dans /etc/cron.d/, qui envoie un message d'avertissement si la prochaine tâche programmée (prise dans la propriété TimeSchedule + 10 minutes) n'a pas été lancée. Cela garantit que vous serez prévenu même en cas de panne du serveur affa. Le script chien de garde envoie un message de rappel quotidien si l'erreur persiste. La tâche lancée suivante remplace le script chien de garde avec un nouveau temps de déclenchement. <br />
|-<br />
| sshPort<br />
| port du service || 22 || Lorsque sshd sur le serveur source ou votre firewall écoute sur un port non standard, précisez le port ici.<br />
|-<br />
| ConnectionCheckTimeout<br />
| secondes || 120 || Avant que le process rsync démarre sur l'hôte source distant, affa vérifie la connexion ssh et se termine avec une erreur après le temps configuré, si l'hôte ne répond pas.<br />
|- <br />
| rsyncTimeout<br />
| secondes || 900 || Rsync se termine si aucune donnée n'est transférée pendant le temps configuré. Cela évite un gelage permanent dans le cas d'une erreur sur le réseau.<br />
|- <br />
| BandwidthLimit<br />
| entier>=0 Ko/s || 0 || Limite la vitesse de transfert des données. A valeur à zero specifie qu'il n'y a pas de limite.<br />
|- <br />
| rsyncCompress<br />
| yes ''ou'' no || no || Compresse les données transférées. Peut être utile avec les connexions internet lentes. Cela augmente la charge CPU sur les hôtes source et de sauvegarde.<br />
|-<br />
| EmailAddresses<br />
| name@domain.com,name@domain.com,... || admin|| Liste séparée par des virgules des adresses email où les messages seront envoyés.<br>'''Note:''' Par défaut, Affa n'envoie de messages que pour les erreurs, jamais en cas de succès (voir la propriété chattyOnSuccess).<br />
|-<br />
| RetryAttempts<br />
| entier >= 0 || 3 || Quand positionné à une valeur >0, Affa relance une tâche échouée RetryAttemps fois avec un délai de RetryAfter secondes.<br />
|-<br />
| RetryAfter <br />
| secondes >= 3 || 600 || Quand positionné à une valeur >0, attend RetryAfter secondes avant de relancer la tâche suite à une erreur. Utile seulement avec RetryAttempts>0<br />
|-<br />
| RetryNotification<br />
| yes ''ou'' no || yes || Quand positionné à no, Affa n'envoie pas de message d'erreur lorsqu'une tâche a échoué et que RetryAttemps est configuré. Un message d'erreur n'est envoyé que lorsque le dernier essai a échoué.<br />
|-<br />
| RetryAttempts<br />
| entier >= 0 || 0 || Quand positionné à une valeur >0, Affa envoie un message pour les tâches terminées avec succès et décrémente la valeur chattyOnSuccess. Lorsque la valeur atteint 0, Affa revient à son comportement par défaut et n'envoie plus de messages qu'en cas d'erreur.<br />
|-<br />
| AutomountDevice<br>AutomountPoint<br />
| full path || || Unité et point de montage de l'unité de sauvegarde (ex. disque USB). L'unité est montée automatiquement avant qu'une tâche soit lancées et démontée après la fin de la tâche. Avec ces deux propriétés vides, aucun montage automatique n'est effectué.<br />
|-<br />
| AutomountOptions<br />
| chaine de caractères || || Une chaine d'options passées à la commande de montage automatique<br />
|-<br />
| AutoUnmount <br />
| yes ''ou'' no || yes || Quand positionné à 'no' l'unité montée automatiquement reste montée après l'exécution d'Affa.<br />
|-<br />
| preJobCommand<br>postJobCommand<br />
| full path || || Programmes (locaux sur le serveur affa) à exécuter avant/après qu'une tâche soit lancée. Le nom de la tâche et le type (programmée, journalière etc.) sont passés en arguments au programme. Le code de sortie est de plus passé à la commande de programme post-tâche. Voir /usr/lib/affa/ pour des exemples de scripts perl.<br />
|-<br />
| RootDir<br />
| full path || /var/affa || Où stocker les archives de sauvegarde. N'utilisez pas /home/e-smith ou /root puisqu'ils sont inclus dans les répertoires à sauvegarder, ce qui empêcherait la fonction de conversion de fonctionner ! Répertoire conseillé : /var/affa<br />
|-<br />
| SambaShare<br />
| yes ''ou'' no|| yes || Accède aux archives de la tâche via SMB.<br />
|-<br />
| Debug <br />
| yes ''ou'' no || no || Positionné à 'yes', donne plus de détails dans le fichier de log.<br />
|-<br />
| status<br />
| enabled ''ou'' disabled || enabled || Positionné à 'disable', aucune entrée cron ne sera faite. Vous pouvez encore lancer les tâches à la main.<br />
|-<br />
| rsync--inplace<br />
| yes ''ou'' no || yes || Positionné à 'no', si la version rsync de la source ne supporte pas cette option (comme rsync sur SME6)<br />
|-<br />
| rsync--modify-window<br />
| entier >= 0 || 0 || En comparant deux horodatages, rsync les traite comme étant égaux s'ils ne diffèrent pas de plus de la valeur modify-window. C'est normalement 0 pour une correspondance exacte. Une valeur >= 0 est pratique si vous ne pouvez pas garder les horloges de la source et du serveur Affa synchonisées.<br />
|-<br />
| rsyncOptions<br />
| texte || || chaine d'options aditionnelles à passer à rsync.<br />
|-<br />
| rsyncdMode<br />
| yes ''ou'' no || no || Positionné à yes pour se connecter au démon rsync de l'hôte distant (au lieu de lancer rsync over ssh).<br />
|-<br />
| rsyncdModule<br />
| texte || AFFA || Le nom du module rsyncd (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| rsyncdUser<br />
| texte || affa || Le nom d'utilisateur pour authentification au démon rsync (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| rsyncdPassword<br />
| texte || || Le mot de passe pour authentification au démon rsync (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| remoteOS<br />
| cygwin || || avec remoteOS=cygwin les options --send-key et --revoke-key utilisent le compte 'Administrator' et le chemin correct pour la clé publique sur un hôte distant sous Windows/Cygwin. <br />
|- <br />
| ESXi<br />
| yes ''ou'' no || no || active le mode de sauvegarde VMware ESXi pour les machines virtuelles.<br>Voir [[Sauvegarde des machines virtuelles ESXi avec Affa]]<br />
|-<br />
| ESXiVMName<br />
| texte || || Le nom de la VM tel qu'affiché dans le client VI.<br />
|-<br />
| ESXiUsername<br />
| texte || || Le nom du client VI avec la permission de créer et détruire les instantanés (snapshots).<br />
|-<br />
| ESXiPassword<br />
| texte || || Le mot de passe de l'utilisateur ESXiUsername<br />
|-<br />
| chunkFiles<br />
| texte || || Noms de fichiers qu'Affa devrait découper et compresser. Plusieurs noms doivent être séparés par un slash (/), ex. 'mysql.dump/pgsql.dump' découpe les deux fichiers mysql.dump et pgsql.dump. Avec ESXi=yes c'est implicitement positionné à '*.vmdk'. Voir aussi les options de ligne de commande --chunk-archive et --unchunk-archive<br />
|}<br />
<br />
==== Propriétés de la configuration par défaut ====<br />
Toutes les propriétées peuvent être positionnées par défaut dans l'enregistrement DefaultAffaConfig. C'est pratique, lorsque vous configurez plusieurs tâches similaires. <br />
<br />
Exemple : Vous voulez positionner la propriété 'localNice' à 19 pour toutes les tâches. Tapez<br />
db affa setprop DefaultAffaConfig localNice 19<br />
et ne positionnez pas cette propriété pour les tâches.<br />
Les propriétés positionnées dans les tâches sont prioritaires sur les propriétés par défaut.<br />
<br />
La propriété spéciale 'sendStatus' ne s'applique que dans l'enregistrement DefaultAffaConfig. Elle contrôle le rapport d'état (status) envoyé par mail et peut prendre les valeurs 'none', 'daily', 'weekly' ou 'monthly'. <br />
<br />
Pour configurer un rapport hebdomadaire, tapez :<br />
db affa setprop DefaultAffaConfig sendStatus weekly<br />
puis configurez cronjob :<br />
affa --make-cronjobs<br />
<br />
==== Désactivation globale ====<br />
Toutes les tâches peuvent être désactivées en positionnant l'enregistrement AffaGlobalDisable sur 'yes'.<br />
db affa set AffaGlobalDisable yes<br />
affa --make-cronjobs<br />
<br />
Pour réactiver :<br />
db affa set AffaGlobalDisable no<br />
affa --make-cronjobs<br />
<br />
=== Utilisation et options de ligne de commande ===<br />
{{Note box|Les options peuvent être abrégées tant qu'elles restent uniques, ex. --mak est identique à --make-cronjobs}}<br />
'''affa --run JOB'''<br />
Lance une tâche. Normalement effectué par cronjob. <br />
<br />
<br />
'''affa --make-cronjobs'''<br />
Configure les tâches cron comme programmées dans les enregistrements de tâches.<br />
<br />
<br />
'''affa --send-key JOB'''<br />
'''affa --send-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Génère d'abord la clé DSA pour le serveur Affa, si cela n'a pas déjà été fait. Envoie ensuite la clé publique à l'hôte 'remoteHostName' comme configuré dans l'enregistrement de la tâche et génère l'entrée ssh known host (hôte connu) spécifique à la tâche. <br />
{{Note box|Initialement, lorsque vous faites cette étape, vous aurez besoin d'activer temporairement "Autoriser l'authentification par SSH à l'aide de mots de passe standards" sur le serveur de production.}}<br />
{{Note box|<nowiki>l'option --send-key fonctionne pour SME Server comme serveur distant et pour les systèmes sur lesquels les clés publiques sont stockées dans /root/.ssh/authorized_keys2 et sur lesquels les commandes /bin/cat, /bin/touch, /bin/grep et /bin/mv sont disponibles. Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}<br />
<br />
<br />
'''affa --full-restore JOB [ARCHIVE]'''<br />
Effectue une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur source distant comme défini dans l'enregistrement JOB. Si [ARCHIVE] n'est pas donnée, l'archive 'scheduled.0' est utilisée comme défaut. La restauration totale reconstruit le serveur comme il était au moment de la sauvegarde. Après la restauration l'hôte source est redémarré.<br />
<br />
<br />
'''affa --rise [--all] JOB [ARCHIVE]'''<br />
Lance une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur Affa <b>(!)</b> comme défini dans l'enregistrement JOB. Autrement dit, une fois terminée, le serveur de sauvegarde reboote comme un clone du serveur source. Assurez-vous d'avoir arrêté le serveur source avant de rebooter le serveur de sauvegardes, sinon l'interface réseau ne sera pas activée. Cela est important, lorsque vous lancez --rise à distance. La fonction --rise ne fonctionne qu'avec les serveurs SME 7et ne devrait être utilisée que sur les serveurs de sauvegardes dédiés.<br />
<br />
Avec l'option --all, tous les fichiers et répertoires de l'archive tels que définis par les propriétés include[] sont restaurés. Les fichiers et répertoires avec le même nom sur le serveur Affa seront écrasés et ne peuvent pas être restaurés par un undoris. Cela ne devrait pas poser de problème sur un serveur Affa dédié qui ne contient aucune autre donnée. Après un éventuel undorise ces données aditionnelles restaurées doivent être supprimées manuellement.<br />
<br />
Remarquez que le processus rise sauvegarde le serveur Affa lui-même avant d'effectuer la restauration de l'archive. Cette sauvegarde est utilisée par un éventuel undorise pour restaurer le serveur Affa. Seulement les fichiers et répertoires standards sont sauvegardés. Les données dans des endroits non standard (comme /opt) ne sont pas touchées et existeront encore après le rise. Voir aussi : [[Backup_server_config#Standard_backup_.26_restore_inclusions]]<br />
<br />
<br />
'''affa --undo-rise'''<br />
Cette fonction reconvertit en serveur de sauvegarde un serveur Affa préalablement converti en serveur de production. Après un redémarrage, toutes les tâches configurées fonctionneront à nouveau.<br />
<br />
<br />
'''affa --unchunk-archive JOB ARCHIVE'''<br />
Concatène et décompresse tous les fichiers découpés dans l'archive ARCHIVE de la tâche JOB pour rendre l'archive prête pour une restauration. Notez que l'archives la plus récente scheduled.0 n'est jamais découpée et donc qu'elle peut être restaurée telle quelle sans re-concaténation préalable.<br />
<br />
<br />
'''affa --chunk-archive JOB ARCHIVE'''<br />
Découpe et compresse tous les fichiers dont les noms correspondent à la propriété chunkFiles pour économiser l'espace disque. Cela ne devrait être utilisé que comme l'inverse de --unchunk-archive. Les découpages sont stockés en fichiers bzip2 dans un répertoire nommé FILENAME.affa-chunks avec 8 niveaux de profondeur.<br />
<br />
<br />
<br />
'''affa --create-backup-file JOB [ARCHIVE] [--outfile=FILE]'''<br />
Crée une archive tar gzippée FILE depuis l'ARCHIVE de la tâche JOB. Pendant la création la somme MD5 est calculée puis le fichier tar enregistré lui est comparé. L'archive par défaut est schedule.0 et le fichier FILE par défaut est./smeserver.tg. La somme de contrôle est écrite dans FILE.md5sum.<br />
<br />
Un fichier smeserver.tgz stocké sur un disque USB peut être utilisé pour restauration lors d'une nouvelle installation de SME Server.<br />
<br />
<br />
'''affa --list-archives [--csv] JOB'''<br />
Affiche un tableau de toutes les archives de la tâche JOB existantes, avec la date, le nombre de fichiers, la taille et l'espace disque utilisé. <br />
<small><pre><br />
Affa version 2.0.0-rc4 on affa1.mydomain.de (10.204.48.2)<br />
+------------------------------------------------------------------------------+<br />
| Job: primmail |<br />
| Description: Mailserver Albstadt |<br />
| Directory: /var/affa/primmail/ |<br />
| Hostname: 10.204.144.2 |<br />
| Email: admin@mydomain.de |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| Run | Completion date | Exec Time | Files | Size | Recvd |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| M 9 | Sun 2008 Mar 02 06:11 | 0h29m47s | 679010 | 80GB | 60MB |<br />
| M 8 | Sun 2008 Mar 30 06:12 | 0h26m59s | 701683 | 83GB | 48MB |<br />
| M 7 | Sun 2008 Apr 27 06:16 | 0h28m01s | 731332 | 87GB | 47MB |<br />
| M 6 | Sun 2008 Jun 01 06:20 | 0h27m37s | 755529 | 90GB | 50MB |<br />
| M 5 | Sun 2008 Jun 29 06:24 | 0h28m39s | 800200 | 94GB | 52MB |<br />
| M 4 | Sun 2008 Jul 27 06:28 | 0h29m10s | 835398 | 99GB | 59MB |<br />
| M 3 | Sun 2008 Aug 31 06:34 | 0h34m53s | 869409 | 101GB | 65MB |<br />
| M 2 | Sun 2008 Sep 28 06:38 | 0h33m19s | 910889 | 106GB | 59MB |<br />
| M 1 | Sun 2008 Oct 26 06:42 | 0h38m41s | 932627 | 110GB | 61MB |<br />
| M 0 | Sun 2008 Nov 30 06:48 | 0h51m44s | 954090 | 116GB | 75MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| W 3 | Sun 2008 Dec 14 06:50 | 0h53m34s | 962267 | 118GB | 68MB |<br />
| W 2 | Sun 2008 Dec 21 06:52 | 0h53m11s | 974914 | 120GB | 69MB |<br />
| W 1 | Wed 2008 Dec 24 06:52 | 0h48m58s | 974536 | 120GB | 64MB |<br />
| W 0 | Sun 2008 Dec 28 06:58 | 0h39m01s | 977003 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| D 6 | Tue 2008 Dec 30 06:52 | 0h54m45s | 976872 | 120GB | 77MB |<br />
| D 5 | Wed 2008 Dec 31 06:52 | 0h49m10s | 977764 | 120GB | 63MB |<br />
| D 4 | Thu 2009 Jan 01 06:28 | 0h28m09s | 977879 | 120GB | 60MB |<br />
| D 3 | Fri 2009 Jan 02 06:53 | 0h53m21s | 978144 | 120GB | 68MB |<br />
| D 2 | Sat 2009 Jan 03 06:53 | 0h53m15s | 978072 | 120GB | 60MB |<br />
| D 1 | Sun 2009 Jan 04 06:53 | 0h53m16s | 976478 | 120GB | 70MB |<br />
| D 0 | Mon 2009 Jan 05 06:52 | 0h52m42s | 977062 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| S 1 | Mon 2009 Jan 05 17:57 | 0h27m48s | 976353 | 120GB | 98MB |<br />
| S 0 | Tue 2009 Jan 06 06:52 | 0h52m55s | 976539 | 120GB | 70MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
</pre></small><br />
Avec --csv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --status [--csv]'''<br />
Affiche un tableau de toutes les tâches actives (status enabled), avec l'heure de dernier et prochain lancement, la taille, l'espace disque utilisé par la plus récente archive, la date d'exécution du dernier lancement, et le nombre d'archives programmées (S), quotidiennes (D), hebdomadaires (W), mensuelles (M) et annuelles (Y). Le dernier lancement (colonne 'Last') affiche 'failed' si une tâche n'a pas été lancée dans les dernières 24h. Pour les tâches désactivées, 'Last' affiche toujours 'failed' au bout de 24 h. Pour voir la date et l'heure du dernier lancement de ces tâches, utilisez l'option --list-archives. La colonne 'Next' montre l'heure à laquelle le prochain lancement aura lieu, si 'Enabled' est à 'yes'.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| Job | ENA | Last | Exec Time | Next | Size | N of S,D,W,M,Y |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| erp-alb-rsyncd | yes | 00:20 | 0h00m14s | 00:20 | 46MB | 1, 7, 4,10, 0 |<br />
| erp-fra-rsyncd | yes | 02:46 | 0h01m03s | 02:45 | 712MB | 1, 7, 4,10, 0 |<br />
| esxi-TS-W2K | yes | 00:37 | 4h22m08s | 20:15 | 60GB | 1, 7, 1, 0, 0 |<br />
| esxi-W2KR2 | yes | 02:22 | 3h52m09s | 22:30 | 40GB | 1, 7, 1, 0, 0 |<br />
| helpdesk | yes | 00:25 | 0h00m47s | 00:25 | 117MB | 1, 7, 4,10, 0 |<br />
| imageserv | yes | running (pid 16477) | 1, 7, 4,10, 0 |<br />
| intraweb | yes | 06:34 | 0h04m50s | 18:00 | 2.1GB | 2, 7, 4,10, 0 |<br />
| pdcalb | yes | 21:19 | 0h14m27s | 21:05 | 89GB | 1, 7, 4,10, 0 |<br />
| pdcfra | yes | 04:18 | 0h03m33s | 04:15 | 33GB | 1, 7, 4,10, 0 |<br />
| primmail | yes | 06:52 | 0h52m55s | 17:30 | 120GB | 2, 7, 4,10, 0 |<br />
| rayofhope | yes | 21:52 | 0h07m40s | 21:45 | 26GB | 1, 7, 4,10, 0 |<br />
| smecrmpg | yes | 22:35 | 0h00m21s | 22:35 | 70MB | 1, 7, 4,10, 0 |<br />
| sozserv | yes | 02:09 | 0h04m03s | 02:05 | 5.9GB | 1, 7, 4,10, 0 |<br />
| wiki | yes | 03:45 | 0h00m27s | 03:45 | 278MB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| az32share | no | - | 0h00m22s | 03:05 | 1.3GB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
</pre></small><br />
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --disk-usage'''<br />
Affiche l'utilisation actuelle du disque pour les répertoires racine de tous les systèmes de fichiers.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup2.mydomain.de (10.204.0.52)<br />
+------+--------+--------+----------------------------------------------------+<br />
| Use% | Used | Avail | Root Dir |<br />
+------+--------+--------+----------------------------------------------------+<br />
| 71% | 938GB | 365GB | /var/affa |<br />
| 20% | 194GB | 759GB | /mnt/affadev |<br />
+------+--------+--------+----------------------------------------------------+<br />
</pre></small><br />
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --show-schedule [--all]'''<br />
Affiche un calendrier 'graphique' de toutes les tâches actives. La résolution est de 30 minutes. Un 'X' indique les heures de lancement programmés. La durée de la dernière exécution est marquée avec des '='.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
TIME 0:00 4:00 8:00 12:00 16:00 20:00<br />
erp-alb-rsyncd X------- -------- -------- -------- -------- --------<br />
helpdesk X------- -------- -------- -------- -------- --------<br />
esxi-W2KR2 =====--- -------- -------- -------- -------- -----X==<br />
esxi-TS-W2K ==------ -------- -------- -------- -------- X=======<br />
imageserv ---X---- -------- -------- -------- -------- --------<br />
sozserv ----X--- -------- -------- -------- -------- --------<br />
erp-fra-rsyncd -----X-- -------- -------- -------- -------- --------<br />
wiki -------X -------- -------- -------- -------- --------<br />
pdcfra -------- X------- -------- -------- -------- --------<br />
primmail -------- ----X=-- -------- -------- ---X---- --------<br />
intraweb -------- -----X-- -------- -------- ----X--- --------<br />
pdcalb -------- -------- -------- -------- -------- --X-----<br />
rayofhope -------- -------- -------- -------- -------- ---X----<br />
smecrmpg -------- -------- -------- -------- -------- -----X--<br />
1 disabled jobs not listed. Use --all to display.<br />
</pre></small><br />
<br />
<br />
'''affa --send-status'''<br />
Envoie le tableau d'état, l'espace disque utilisé et la liste des archives de toutes les tâches à l'adresse email configurée dans l'enregistrement 'DefaultAffaConfig'. Cette commande est utilisée par la tâche cron 'affa status'.<br />
<br />
<br />
'''affa --mailtest JOB'''<br />
Envoie un email de test aux adresses email configurées dans l'enregistrement de la tâche. Avec la propriété 'Watchdog' à 'yes', un email de test est envoyé depuis le serveur distant aussi. Utilisez cela pour vérifier que l'envoi des mails fonctionne.<br><br />
'''Note:''' Par défaut, Affa n'envoie des messages qu'en cas d'erreur, jamais en cas de succès (voir la propriété 'chattyOnSuccess').<br />
<br />
<br />
'''affa --cleanup JOB'''<br />
Après que vous ayez diminué le temps de conservation (scheduledKeep), les archives avec un indice plus élevé ne seront plus supprimées automatiquement et existeront toujours. Cette option trouve ces archives et les supprime.<br />
<br />
<br />
'''affa --rename-job JOB NEWNAME'''<br />
Renomme la tâche JOB en NEWNAME, y compris tous les enregistrements de la base de données et les répertoires d'archive.<br />
<br />
<br />
'''affa --move-archive JOB NEWROOTDIR'''<br />
Déplace le répertoire d'archive de JOB vers NEWROOTDIR et ajuste la propriété RootDir. NEWROOTDIR doit être un chemin complet (full path) commençant par un slash. Comme le déplacement d'un système de fichiers à un autre (par exemple d'un disque USB à un disque local) n'est pas possible, Affa se sert dans ce cas d'une commande de copie et efface ensuite le répertoire source. Selon la taille de l'archive, la copie d'un système de fichiers à l'autre peut prendre longtemps.<br />
<br />
<br />
'''affa --delete-job [--revoke-key] JOB'''<br />
Efface irréversiblement une tâche, y compris toutes les archives, la configuration et les bases de données attachées. En passant l'option '--revoke-key', la clé publique sur le serveur distant sera détruite.<br />
<br />
<br />
'''affa --revoke-key JOB'''<br />
'''affa --revoke-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Détruit la clé DSA publique sur le serveur distant.<br />
{{Note box|<nowiki>L'option --revoke-key seule fonctionne sur SME Server comme serveur distant et pour les systèmes où les clés sont stockées dans /root/.ssh/authorized_keys2 Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}<br />
<br />
<br />
'''affa --check-connections'''<br />
Contrôle le login ssh pour toutes les tâches configurées. Pour les tâches pour lesquelles la clé publique n'avait pas encore été envoyée, il vous sera demandé le mot de passe et la clé sera envoyée ensuite.<br />
<br />
<br />
'''affa --kill JOB'''<br />
Termine la tâche en cours JOB et tous les processus fils (les processus rsync)..<br />
<br />
'''affa --debug'''<br />
Active un journal verbeux. Remplace la tâche et les configurations globales.<br />
<br />
=== Exemples de configuration ===<br />
==== Serveur de sauvegarde dédié ====<br />
* Configurez une tâche pour chaque serveur que vous voulez sauvegarder<br />
* Envoyez les clés publiques à chaque serveur.<br />
affa --send-key JOBNAME<br />
* Envoie la clé DSA correspontante à la tâche JOBNAME.<br />
affa --check-connections<br />
* Vérifie que les connexions sans mot de passe fonctionnent.<br />
affa --show-schedule<br />
* Vérifie si les tâches planifiées sont réparties dans la journée.<br />
affa --make-cronjobs<br />
* Crée les tâches cron.<br />
affa --status<br />
* Vérifie l'état après 24 heures.<br />
<br />
<br />
==== Sauvegarder une ibay individuellement ====<br />
Supposons que nous voulions sauvegarder les ibays 'staff1' et 'staff2' de notre serveur de production dont l'adresse IP WAN est 82.123.1.1 sur un serveur Affa déporté via internet, toutes les nuits à 2h30.<br />
* On se connecte sur le serveur Affa et on installe les paquetages comme décrit ci-dessus.<br />
* On copie l'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/ibay-staff-job.pl<br />
* On édite /root/ibay-staff-job.pl pour y mettre :<br />
my $jobname='ibay-staff';<br />
et<br />
'remoteHostName‘=>'82.123.1.1',<br />
'TimeSchedule'=>'0230',<br />
'SMEServer'=>'no',<br />
'Include[0]'=>'/home/e-smith/files/ibays/staff1',<br />
'Include[1]'=>'/home/e-smith/files/ibays/staff2',<br />
* On enregistre la configuration<br />
/root/ibay-staff-job.pl<br />
* On envoie la clé publique au serveur de production<br />
affa --send-key ibay-staff<br />
* On vérifie le lendemain matin :<br />
affa --list-archives ibay-staff<br />
affa --status<br />
* Vérifie l'état après 24 heures.<br />
ls /var/affa/ibay-staff<br />
<br />
==== Deux serveurs de production qui se sauvegardent mutuellement ====<br />
Vous avez deux sites connectés via un VPN et un serveur SME fonctionnant sur chaque site. Dans ce cas, vous n'avez pas besoin d'un serveur de sauvegarde Affa dédié. Les deux serveurs de production peuvent en plus agir chacun comme un serveur Affa sauvegardant le serveur de l'autre site. Installez simplement Affa et configurez une tâche qui sauvegarde l'autre serveur. Vous pouvez utiliser toutes les fonctionnalités Affa excepté la fonctionnalité rise. <br />
En utilisant la fonctionnalité rise, le serveur devient n'importe lequel des systèmes sauvegardés, ce qui est moins utile dans ce scénario puisque cela vous donnerait une copie fonctionnelle du serveur de l'autre site lorsque celui-ci est en panne.<br />
<br />
Pour obtenir une redondance et une restauration plus rapide, vous pouvez configurer une sauvegarde locale sur un disque USB externe ou sur un NAS.<br />
<br />
Attention de ne pas sauvegarder à nouveau les archives de l'autre site. Configurez la propriété RootDir vers un chemin qui n'est pas inclu dans la liste de sauvegarde par défaut de SME. En laissant la propriété RootDir par défaut sur '/var/affa', cela est garanti.<br />
<br />
==== Sauvegarde d'un ordinateur Windows ====<br />
Sauvegarder les données d'un système Windows nécessite que le démon Rsyncd Cygwin soit installé et configuré sous Windows. La procédure "rsync over ssh" ne fonctionne pas, puisque le processus rsync Cigwin se plante systématiquement après le transfert de quelques fichiers. <br />
<br />
===== Configuration de Rsyncd sur l'ordinateur Windows ===== <br />
Installez la base Cygwin, le paquetage rsync puis configurez le service Rsyncd comme décrit dans ce document : [[Rsyncd setup on a windows computer for use with Affa backup]]'. <br />
L'installation du service sshd est optionnelle et n'est pas nécessaire pour la sauvegarde elle-même, mais avoir une connexion ssh peut être très utile pour l'administration et pour exécuter des scripts sur le système Windows. Affa supporte l'envoi de la clé publique vers un ordinateur Windows Cygwin pour une connexion sans mot de passe.<br />
<br />
Note: Affa ne sauvegarde pas l'information Windows Access Control List (ACL). Vous pourriez avoir à corriger les ACLs après une restauration.<br />
<br />
===== Configuration du mode Affa Rsyncd (exemple de démarrage rapide) =====<br />
Vous voulez sauvegarder les répertoires ''Mes Documents''des utilisateurs ''ssorglos'' et ''bsimpson'' depuis l'ordinateur Windows 'ws001' avec l'IP 192.168.1.65 sur votre serveur Affa 'affabox' avec l'IP 192.168.1.3.<br />
* connectez-vous sur 'affabox' et copiez le script exemple de configuration Cygwin<br />
cp /usr/lib/affa/jobconfig-cygwin-sample.pl /root/ws001-mydocs-job.pl<br />
* editez /root/ws001-mydocs-job.pl et mettez<br />
my $jobname='ws001-mydocs';<br />
et<br />
'remoteHostName‘=>'192.168.1.65',<br />
'rsyncdPassword'=>'<i>secretword</i>',<br />
'Include[0]'=>'/c/Documents and Settings/ssorglos/My Documents/', ''# N'utilisez pas les backslashes dans les chemins !''<br />
'Include[1]'=>'/c/Documents and Settings/bsimpson/My Documents/',<br />
où ''secretword'' doit être remplacé par le mot de passe que vous avez choisi dans rsyncd.secretsfile sur l'ordinateur Windows.<br />
* Enregistrez la configuration (cela crée les entrées de base de données et configure les tâches cron.<br />
/root/ws001-mydocs-job.pl<br />
* Lancez la tâche manuellement. Après l'achèvement, vérifiez l'archive /var/affa/ws001-mydocs/scheduled.0 et le journal /var/log/affa/ws001-mydocs.log.<br />
affa --run ws001-mydocs<br />
<br />
===== Configuration manuelle d'Affa en mode Rsyncd =====<br />
Au cas où vous voudriez configurer manuellement en utilisant les commandes db, voici les paramètres obligatoires pour le mode Rsyncd Cygwin.<br />
db affa setprop JOB rsyncdMode yes<br />
db affa setprop JOB rsyncdModule AFFA<br />
db affa setprop JOB rsyncdUser affa<br />
db affa setprop JOB rsyncdPassword ''secretword''<br />
db affa setprop JOB SMEServer no<br />
db affa setprop JOB RPMCheck no<br />
db affa setprop JOB Watchdog no<br />
Optionel pour une connexion ssh.<br />
db affa setprop JOB remoteOS cygwin <br />
<br />
<br />
==== Utiliser Affa pour sauvegarder un NAS monté par NFS ou un disque USB local ====<br />
<br />
On désire sauvegarder notre serveur SME 7 de production dont le nom d'hôte est 'prodbox' et l'IP 10.200.48.1 sur un système de fichiers monté plutôt que de configurer un serveur Affa dédié.<br />
<br />
===== Configuration du NAS =====<br />
On dispose d'un serveur FREENAS dont l'adresse IP est 10.200.48.2 en fonction et avec le service NFS activé. Le disque est monté sur /mnt/affashare. On a autorisé l'adresse IP de notre serveur de production à accéder au partage /mnt/affashare.<br />
* On se logge sur 'prodbox' et on installe les paquetages NFS :<br />
/usr/bin/yum install --enablerepo=smecontribs smeserver-nfs<br />
* maintenant, on active et on démarre le service portmapper.<br />
config setprop portmap status enabled<br />
service portmap start<br />
<br />
* On monte le partage NFS :<br />
mkdir -p /mnt/affadevice<br />
mount 10.200.48.2:/mnt/affashare /mnt/affadevice<br />
<br />
<br />
===== Alternative : configuration du disque USB =====<br />
* On se logge sur 'prodbox'<br />
* On connecte le disque USB sur le bus USB. On doit maintenant déterminer sur quel 'device' le noyau a placé le lecteur. On regarde /var/log/messages et on cherche la ligne d'initialisation correspondante (Initializing USB Mass Storage driver). Quelques lignes plus bas, on trouve le nom du device. Supposons qu'il s'agisse de 'sdh'. Si ce n'est pas le cas, on remplacera dans les instructions ci-après /dev/sdh par la valeur trouvée.<br />
* On crée une partition linux avec fdisk : '''Il faut bien vérifier que c'est bien le disque USB qui est attaché avant de continuer !'''<br />
<br />
fdisk /dev/sdh<br />
On trouvera probablement une partition dos vfat, qu'on devra d'abord détruire. Supposons que nous ayons créé une seule partition ''/dev/sdh1''.<br />
* On formatte avec un système ext3 :<br />
mkfs.ext3 /dev/sdh1<br />
* On crée le point de montage :<br />
mkdir -p /mnt/affadevice<br />
* On ajoute notre disque USB dans /etc/fstab. On crée donc une nouvelle ligne avec :<br />
/dev/sdh1 /mnt/affadevice ext3 defaults<br />
* On monte le disque :<br />
mount /mnt/affadevice<br />
* On fait une vérification croisée avec df :<br />
df<br />
<br />
<br />
===== Configuration d'Affa =====<br />
On veut lancer des sauvegardes à 11h30, 15h30, 19h30 et on veut garder les 3 dernières, 7 journalières, 5 hebdomadaires, 12 mensuelles et 1 annuelle.<br />
* On se logge sur 'prodbox' et on installe les paquetages Affa comme indiqué ci-dessus.<br />
* On copie l'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
* On édite /root/prodbox-job.pl pour y mettre :<br />
my $jobname='prodbox';<br />
et<br />
'remoteHostName‘=>'localhost',<br />
'TimeSchedule'=>'1130,1530,1930',<br />
'scheduledKeep'=>3,<br />
'dailyKeep'=>7,<br />
'weeklyKeep'=>5,<br />
'monthlyKeep'=>12,<br />
'yearlyKeep'=>1,<br />
'RootDir=>'/mnt/affadevice',<br />
On vérifie les autres propriétés et on les change si besoin.<br />
* On enregistre la configuration<br />
/root/prodbox-job.pl<br />
* On lance la tâche manuellement :<br />
<br />
affa --run prodbox<br />
<br />
<br />
===== Limitations =====<br />
Avec ce type de configuration, on ne peut pas utiliser la fonction 'rise' (conversion du serveur de sauvegarde en serveur de production), puisqu'elle nécessite que l'archive soit sur le même système de fichiers que le serveur. La fonction 'rise' utilise les hardlinks, qui ne fonctionnent pas entre systèmes de fichiers différents.<br />
<br />
===== Automount : montage automatique =====<br />
Avoir les archives de sauvegarde sur le même système de fichiers est toujours un risque, qui peut être minimisé en utilisant la fonction automount. Ainsi, le système de fichiers externe n'est monté que durant le déroulement d'une tâche.<br />
<br />
Dans l'exemple NAS, configurez :<br />
'AutomountDevice=>'10.200.48.2:/mnt/affashare',<br />
'AutomountPoint =>'mnt/affadevice',<br />
et sautez l'étape 2<br />
<br />
Dans l'exemple du disque USB, configurez :<br />
'AutomountDevice=>'/dev/sdc1',<br />
'AutomountPoint =>'mnt/affadevice',<br />
et sautez les étapes 5 à 8.<br />
<br />
Le point de montage sera automatiquement créé, s'il n'existe pas. <br><br />
Pour accéder au répertoire de l'archive, vous devez le monter à la main.<br />
<br />
=== Restauration ===<br />
==== Restauration de fichiers ou répertoires individuels ====<br />
'''Example 1:''' Nous sommes le Mardi 6 Janvier 2009 quand l'utilisateur 'briedlin' vous demande de restaurer les messages de sa boite 'orders' qu'il a malencontreusement détruite Lundi.<br />
<br />
* Vous devez d'abord regarder quelles sont les archives disponibles. Le nom de tâche de ce serveur de sauvegardes est 'primmail. Pour avoir une liste de toutes les archives, lancez <br />
affa --list-archives primmail<br />
''(voir la liste exemple dans le chapitre [[Affa#Usage_and_command_line_options]]''<br />
* Choisissez l'archive daily.0, qui a été créée la nuit de Lundi. Maintenant, restaurez la mailbox 'orders' en utilisant la commande rsync.<br />
* Maintenant, lancez la commande rsync (notez le slash en fin !) sur le serveur de sauvegarde Affa.<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av -e 'ssh -p 2222' /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
<br />
<br />
'''Example 2:''' Un utilisateur a effacé le fichier orderform.pdf dans l'ibay 'docs' du serveur 10.204.48.1 et vous demande de le restaurer.<br />
<br />
* Vous avez cherché et trouvé la dernière version de ce fichier dans l'archive hebdomadaire de la tâche 'prodserv'.<br />
* Pour la recopier vers le serveur 10.204.48.1 lancez sur le serveur Affa<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av -e 'ssh -p 2222' /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
<br />
<br />
'''Example 3:''' Restaurer un fichier avec un caractère spécial dans le chemin<br />
<br />
N'utilisez pas les variables shell pour raccourcir la commande. Cela compliquerait les choses plus que cela aiderait.<br />
Mettez entre guillemets les chemins source et destination. Dans le chemin de destination, echappez les caractères blancs avec un double backslash et les parenthèses avec un simple backslash. Sur le serveur de sauvegardes AFFA lancez :<br />
rsync -av "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
<br />
rsync -av -e 'ssh -p 2222' "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
==== Restauration complète ====<br />
Pour lancer une restauration complète des utilisateurs et des données de configuration, lancez sur le serveur Affa<br />
affa --full-restore <JOB> [<ARCHIVE>]<br />
Cela synchroniste (par rsync) les données de la sauvegarde ARCHIVE vers l'ordinateur 'remoteHostname' défini dans la configuration de la tâche JOB. <br />
<br />
Exemple:<br />
Vous avez sauvegardé votre serveur de production 'prodsrv' par une tâche 'prodbox'. Pour restaurer la dernière sauvegarde, lancez<br />
affa --full-restore prodbox<br />
<br />
Pour restaurer la plus ancienne archive daily.3, lancez <br />
affa --full-restore prodbox daily.3<br />
<br />
{{Warning box| Une restauration complète reconstruit le serveur tel qu'il était au moment de la sauvegarde. Cela signifie que tous les fichiers créés ou les changement de configuration due serveur effectués après la sauvegarde seront perdus. Après la restauration, le serveur restauré redémarre automatiquement. }}<br />
<br />
==== Migration d'un serveur SME7 vers un nouveau matériel en utilisant la fonctionnalité "Affa rise" ====<br />
Merci de consulter cet Howto: [[Moving SME to new Hardware]]<br />
<br />
<br />
==== Restauration d'un disque USB sur un nouveau serveur ====<br />
<br />
<br />
Cette astuce vient de http://forums.contribs.org/index.php?topic=42412.0<br />
<br />
Q) J'ai des sauvegardes complètes stockées sur un disque dur USB connecté sur notre serveur de sauvegarde Affa. J'ai besoin de restaurer une ancienne sauvegarde mensuelle de notre tâche "mailbackup" sur un serveur de tests à la place du système original. Si je le fais depuis le serveur de sauvegardes, je vois les instructions pour remonter ce serveur depuis la sauvegarde courante, mais je veux restaurer d'un état datant d'environ un mois, avant que d'étranges choses se soient passées. Et je veux le faire sur une machine qui n'est pas notre serveur de sauvegarde ni notre serveur de production. J'ai tenté d'imaginer comment faire, mais je suis perdu dans les options. Mon but est de faire quelques tests.<br />
<br />
R) Sur votre serveur de tests, configurez une tâche "mailbackup" identique à celle de votre serveur de sauvegardes, mais paramétrez correctement RootDir en /var/affa et mettez la propriété "status" sur "disabled" Connectez le lecteur USB et copiez l'archive de la tâche "mailbackup" dans /var/affa. Ensuite, lancez affa --rise mailbackup ARCHIVE<br />
<br />
Rappelez-vous qu'Affa place les scripts de configuration de tâches dans les répertoires d'archive. Dans votre cas, c'est mailbackup-setup.pl. Copiez-le sur votre serveur de tests, changez les propriétés RootDir et status, puis exécutez-le.<br />
<br />
=== FAQ ===<br />
'''Quels fichiers et répertoires sont inclus par défaut ?'''<br />
<br />
Avec SMEServer=no aucun.<br />
<br />
Avec SMEServer=yes la liste par défaut des sauvegardes SME. TLa commande suivante affiche la liste :<br />
perl -e 'use esmith::Backup;$b=new esmith::Backup;print join("\n",$b->restore_list)."\n"' <br />
<br />
<br />
'''Puis-je sauvegarder exclusivement des fichiers d'images contenus dans un répertoire spécifique ?'''<br />
<br />
Oui. Supposant que vous voulez sauvegarder tous les fichiers gif et jpg du répertoire /home/e-smith/files/ibays/pictures/files utilisez cette configuration<br />
db affa setprop JOBNAME SMEServer no # Ne pas inclure les répertoires et fichiers par défaut de SME Server<br />
db affa setprop JOBNAME Include[0] '/home/e-smith/files/ibays/pictures/files' # Commencer à chercher ici<br />
db affa setprop JOBNAME Include[1] '*/' # Chercher récursivement dans l'arborescence<br />
db affa setprop JOBNAME Include[2] '*.gif' # Copier les fichiers qui correspondent à ce profil<br />
db affa setprop JOBNAME Include[3] '*.jpg' <br />
db affa setprop JOBNAME Exclude[0] '*' # Exclure tous les autres<br />
db affa setprop JOBNAME rsyncOptions '-m' # Ne pas créer les répertoires vides<br />
<br />
<br />
'''Comment puis-je déplacer une archive de sauvegarde de mon serveur de production dans une agence distante vers le serveur Affa en utilisant un disque USB ? Je veux éviter de télécharger la première sauvegarde complète depuis internet.<br />
Installez Affa sur votre serveur de production, connectez et montez le disque USB.''' Configurez une tâche pour enregistrer la sauvegarde sur le disque USB. Une fois la tâche exécutée, connectez le disque USB à votre serveur Affa et configurez la tâche de la même manière. Utilisez le script de configuration du répertoire d'archive. Vous n'avez à mofier que la propriété "remoteHostName". Maintenant, utilisez l'option --move-archive pour transférer l'archive sur le disque local. Si ce n'est pas déjà fait, envoyez la clé publique à votre serveur de production. C'est fait.<br />
<br />
<br />
'''Comment je sauvegarde deux serveurs SME derrière un pare-feu ?'''<br />
D'abord, vous devez configurer les port forwardings pour le service ssh sur votre pare-feu. Utilisez un port non standard, par ex. 2200->22, pour votre second serveur. Configurez une tâche sur votre serveur de sauvegarde Affa pour chacun de vos serveurs de production. Configurez la propriété sshPort=2200 pour votre second serveur.<br />
<br />
=== Désinstallation ===<br />
Cela supprime le paquetage Affa installé, toutes les données de configuration et toutes les archives de sauvegarde.<br />
<br />
Lancez les commandes suivantes pour chaque tâche :<br />
affa --revoke-key JOBNAME<br />
affa --delete-job JOBNAME<br />
Verifie que toutes les tâches ont été supprimées.<br />
affa --status<br />
Suprime le paquetage Affa<br />
rpm -e smeserver-affa<br />
et, si ces paquetages ne sont pas des dépendances d'autres paquetages :<br />
Nettoyage général<br />
rm -f /etc/cron.d/affa /etc/cron.d/affa-status<br />
rm -rf /home/e-smith/db/affa /home/e-smith/db/affa-report<br />
rm -rf /var/affa /var/log/affa<br />
<br />
=== Rapport de bugs ===<br />
Affa est répertorié dans [http://bugs.contribs.org/enter_bug.cgi?product=SME%20Contribs&component=smeserver-affa bugtracker contribs section].<br />
SVP, rapportez là tous les bugs, demandes de nouvelles fonctionnalités et problèmes de documentation. <br />
<br />
=== Informations complémentaires ===<br />
Pour les détails de performance, la liste des modifications etc. voyez [[:Affa:Additional information]]<br />
<br />
=== Références ===<br />
* Article Wikipedia http://en.wikipedia.org/wiki/Rsync<br />
* Site Rsync http://rsync.samba.org/<br />
* Article Wiki [[Moving SME to new Hardware]]<br />
* Article Wiki [[Backup with Affa and FreeDup]]<br />
* Article Wiki [[Rsyncd setup on a windows computer for use with Affa backup]]<br />
* Article Wiki [[Backup Windows Computers Using Affa]]<br />
* Article Wiki [[Backup of ESXi Virtual Machines using Affa]]<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Backup/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Affa&diff=12732Affa2009-04-09T19:32:53Z<p>Cool34000: </p>
<hr />
<div>{{Languages|Affa}}<br />
{{Level|Advanced}}<br />
<br />
=== Maintainer ===<br />
Michael Weinberger<br />
<br />
Affa stands for '''A'''utomatische '''F'''estplatten '''F'''ern'''a'''rchivierung<br />
<br />
=== Description ===<br />
The main purpose of this affa package is to make a SME 7 Server a dedicated backup box in a few minutes. Affa backs up as many SME servers as you like or any other servers which have sshd running and rsync installed. Once it is configured, Affa runs reliably unattended and sends warning messages in case of any errors. <br />
<br />
All backup archives are full backups, as Affa make use of the hardlink technique. Therefore a new full backup only needs disk space for the differences plus the filesystem overhead for the hardlinks and directories (which is typically 2-3%).<br />
<br />
Affa is based on the rsync program and supports the rsync --compress option. This allows you to run backups over the internet or VPN. A typical setup is one or more Affa backup servers placed in different locations, which backup the production server(s) over the VPN.<br />
<br />
A special feature is the rise option, which allows you to rise the backup server to your production server from a backup archive in case of a dead loss of your production server. The rise is executed within a extremely short time, even with huge amount of data. The rise feature uses hardlinks and therefore does not use up additional disk space.<br />
<br />
Affa is a command line tool for system administrators and is intentionally designed without a GUI. Therefore it can be efficiently managed on the console and over slow internet connections.<br />
<br />
'''Note:''' This documents refers to the Affa Version 2 Release Candidate. Latest stable version 1 documentation can be found [http://wiki.contribs.org/index.php?title=Affa&oldid=11974 here].<br />
<br />
==== Affa features at a glance ====<br />
* Affa is secure: All transfers and connections are made by using the ssh protocol with public/private key authentication<br />
* Periodically runs unattended full backups. Only differences to the previous full backup are transferred over the network<br />
* Using rsync with optional bandwidth limit and compression allows backups over the internet<br />
* Uses hardlink technique, i.e. physical disk space only needed for the differences between two full backups<br />
* Keeps a configurable number of scheduled, daily, weekly, monthly and yearly full backup archives<br />
* The archives are browseable. No need to unpack them first.<br />
* Archives can be mapped to a Samba share.<br />
* Backup jobs are started by the cron daemon<br />
* Interrupted jobs continuing with already transfered data when restarted<br />
* Backups the default e-smith directories and files, when property SMEServer is set to yes<br />
* Additional directories and files can be included<br />
* Directories and files can be excluded from the backup<br />
* Non-SME server linux systems can be backed up by setting the SMEServer property to no and using an include list<br />
* In ESXi mode, running virtual machines can be backed up. See [[Backup of ESXi Virtual Machines using Affa]]<br />
* Configurable nice level for rsync processes on the backup and source server<br />
* Optional run of custom programs before and after a job run (e.g. running tape backup)<br />
* Checks the disk space left after a job run with warning levels strict, normal or risky<br />
* Extensive checking of failure conditions<br />
* Sends failure messages to a configurable list of email addresses<br />
* Sends a warning message, if the backup server runs out of disk space<br />
* Installs an optional watchdog on the source server in case the backupserver fails (SME Server only)<br />
* Watchdog sends warning, if an expected backup did not run (SME Server only)<br />
* Watchdog sends a daily reminder message, if the error continues unchecked (SME Server only)<br />
* Option to display current status of all jobs showing times of last and next run, size and disk usage<br />
* Status can be mailed on a daily, weekly or monthly schedule<br />
* Option to display all existing archives of a job shown date, number of files, size and bytes tranferred from the source<br />
* Option to send (and revoke) the public key to the source server (SME Server and ESXi only)<br />
* Option to rise the backup server to a production server from a backup (SME Server only)<br />
* The rise feature does not physically move data and therefore is extremly fast and needs (almost) no extra disk space<br />
* Rise option can be run remotely as the NIC driver configuration of the backup server are preserved<br />
* Compares installed RPMs on source with backup server. Sends warning message, if not in sync<br />
* Undo rise option to restore the backup server<br />
* Configurable via a e-smith style db, with one record for each job and a default record for all jobs<br />
* Logs to /var/log/affa/JOB.log and /var/log/affa/affa.log with optional debug switch for higher verbosity<br />
* Log files are rotated weekly, with 5 logs kept<br />
<br />
<br />
=== Installation or Update ===<br />
Latest version: '''smeserver-affa-2.0.0-rc4.noarch.rpm'''<br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/smeserver-affa-2.0.0-rc4.noarch.rpm</nowiki><br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm</nowiki><br />
/usr/bin/yum --enablerepo=smecontribs localinstall \<br />
smeserver-affa-2.0.0-rc4.noarch.rpm \<br />
perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm<br />
<br />
When you have installed Affa for the first time run the following command to initialize the Affa database<br />
affa --make-cronjobs<br />
and logout and re-login to the console to take the bash auto-completion (TAB key) in effect.<br />
<br />
=== Quick start example ===<br />
You have a SME 7 production server with hostname 'prodbox‘ and IP 10.200.48.1.<br><br />
Set up a second SME 7 box as your backupserver with hostname 'affabox‘ and IP 10.200.48.2. <br />
<br />
<ol></li><li>log into the 'affabox' and install the packages as described above.<br />
</li><li>copy the config helper script sample<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
</li><li>edit /root/prodbox-job.pl and set<br />
my $jobname='prodbox';<br />
and<br />
'remoteHostName‘=>'10.200.48.1',<br />
optionally, if the remote server port is configured to e.g. 2222 then set<br />
'sshPort'=>2222,<br />
</li><li>save and run the 'prodbox-job.pl' file. This will write the configuration (this makes the database entries and sets up the cronjobs)<br />
/root/prodbox-job.pl<br />
</li><li>generate the DSA keys and send the public key to the 'prodbox'<br />
{{Note box|When initially doing this step, you will need to temporarily enable "Allow secure shell access using standard passwords" on the production server}}<br />
affa --send-key prodbox<br />
</li><li>run the job manually<br />
<br />
affa --run prodbox<br />
</li></ol><br />
<br />
=== Configuration ===<br />
The configuration is stored in an e-smith style database. Use the db command to configure Affa.<br />
The jobname is the record key with the type 'job'.<br>To setup a new job with the name 'prodbox' enter:<br />
<br />
db affa set prodbox job<br />
<br />
then set the properties<br />
<br />
db affa setprop prodbox remoteHostName 192.168.1.1<br />
db affa setprop prodbox TimeSchedule '0030,0730,1130,1330,1730,2030'<br />
db affa setprop prodbox Description 'My Production Server'<br />
db affa setprop prodbox status enabled<br />
and so on...<br />
<br />
Alternatively you can you use a script as described above in the 'Quick start' chapter.<br />
<br />
To verify your work, type:<br />
<br />
db affa show prodbox<br />
<br />
Finally set up the cronjobs:<br />
affa --make-cronjobs<br />
<br />
==== Job configuration properties ====<br />
'''Note:''' The default values shown in this table are the Affa program defaults and not to be confused with the preset values in the helper scripts, e.g. jobconfig-sample.pl.<br />
{| border="1" cellpadding="3" cellspacing=0<br />
|-<br />
| '''Property''' || '''Value''' || '''Default''' || '''Description''' <br />
|-<br />
| remoteHostName <br />
| FQHN or IP || || FQHN or IP of the source host (mandatory)<br />
|-<br />
| TimeSchedule <br />
| HHMM,HHMM,... || || doesn't need to be ordered. At least one time is mandatory. '''Important:''' Using the proper format HHMM is essential. Affa does not check it. Badly formatted TimeSchedule will cause strange Perl errors. <br />
|-<br />
| Description<br />
| text string || || <br />
|-<br />
| scheduledKeep<br />
| integer >= 1 || 1|| how many of the scheduled backups should be kept<br />
|-<br />
| dailyKeep<br>weeklyKeep<br>monthlyKeep<br>yearlyKeep<br />
| integer >= 0 || 7<br>4<br>12<br>2<br>|| how many of the daily, weekly, monthly or yearly backups should be kept<br />
|-<br />
| SMEServer<br />
| yes ''or'' no || yes || when set to yes the default e-smith directories are automatically included and the property RPMCheck=yes can be used<br />
<br />
|-<br />
| Include[0]<br>Include[1]<br>...<br />
| full path || || additional files or directories to include<br />
|-<br />
| Exclude[0]<br>Exclude[1]<br>...<br />
| full path || || additional files or directories exclude from backup<br />
|-<br />
| RPMCheck<br />
| yes ''or'' no || no || Only applicable to jobs that backups a SME 7 server.<br>Compares the packages installation of the source host with this affa backup host. Sends a message with diff list if not in sync. This check is usefull, if you want have the option to rise the backup server to a production server from a backup.<br />
|-<br />
| DiskSpaceWarn<br />
| strict ''or'' normal ''or'' risky ''or'' none || strict || run a disk space check after a job has been completed. With level 'strict' a warning message will be sent, if the available space is less then the size of the just completed backup. With level 'normal'/'risky' the message is sent, if less than 50%/10% of the backup size is still available.<br />
'''Note:''' When RootDir is a symbolic link to another filesystem the disk usage of the local filesystem rather than the linked filesystem is checked. Set the mountpoint as the RootDir to get correct checking.<br />
|-<br />
| localNice <br />
| -19...+19 || 0 || run rsync local process niced. <br />
|-<br />
| remoteNice<br />
| -19...+19 || 0 || run rsync process on source niced. <br />
|-<br />
| Watchdog<br />
| yes ''or'' no || yes || Only applicable to jobs that backups a SME 7 server.<br>When a job is started, affa installs a watchdog script on the source in /etc/cron.d/, which sends a warning message, if the next scheduled job (taken from the TimeSchedule property + 10 minutes) did not run. This guarantees, that you will be notfied even in case of a affa server outage. The watchdog script send a daily reminder message, if the error continues. The next run job replaces the watchdog script with a new trigger time.<br />
|-<br />
| sshPort<br />
| service port || 22 || When sshd on the source host or your firewall listen on a non-standard port set the port here.<br />
|-<br />
| ConnectionCheckTimeout<br />
| seconds || 120 || before the rsync process is started on the remote source host, affa checks the ssh connection and exits with an error after the configured time, if the host does not respond.<br />
|- <br />
| rsyncTimeout<br />
| seconds || 900 || Rsync exits, if no data is transferred for the configured time. This avoids infinitely hanging in case of a network error.<br />
|- <br />
| BandwidthLimit<br />
| integer>=0 kilobytes per second|| 0 || Limits the data transfer rate. A value of zero specifies no limit.<br />
|- <br />
| rsyncCompress<br />
| yes ''or'' no || no || compress the transferred data. May be useful with slow internet connections. Increases CPU load on source and backup host.<br />
|-<br />
| EmailAddresses<br />
| name@domain.com,name@domain.com,... || admin|| comma separated list of mail addresses, where the messages should be sent to<br>'''Note:''' By default Affa only sends messages on errors, never on success (see property chattyOnSuccess).<br />
|-<br />
| RetryAttempts<br />
| integer >= 0 || 3 || when set to a value>0, Affa re-run a failed job RetryAttempts times with a delay of RetryAfter seconds.<br />
|-<br />
| RetryAfter <br />
| seconds >= 3 || 600 || when set to a value>0, wait RetryAfter seconds before re-running the job after an error. Only applicable with RetryAttempts>0<br />
|-<br />
| RetryNotification<br />
| yes ''or'' no || yes || when set to no, Affa does not send an error message when a job has failed and RetryAttempts is configured. An error message is only send when the last attempt has failed.<br />
|-<br />
| chattyOnSuccess<br />
| integer >= 0 || 0 || when set to a value>0, Affa sends a message on a successfully completed job run and decrements the chattyOnSuccess value. When the value has reached zero, Affa falls back to the default and only sends messages on errors.<br />
|-<br />
| AutomountDevice<br>AutomountPoint<br />
| full path || || Device and mountpoint of backup device (e.g. USB disk). Device is automounted before a job starts and unmounted after job completion. With both properties empty no automount is done.<br />
|-<br />
| AutomountOptions<br />
| string || || An option string passed to the mount command<br />
|-<br />
| AutoUnmount <br />
| yes ''or'' no || yes || When set to 'no' the automounted device stay mounted after the Affa run.<br />
|-<br />
| preJobCommand<br>postJobCommand<br />
| full path || || programs (local on the affa server) to be executed before/after a job run. The job name and type (scheduled, daily etc.) are passed as arguments to the program. The exit code is additionally passed to the post job command program. See /usr/lib/affa/ for sample perl scripts.<br />
|-<br />
| RootDir<br />
| full path || /var/affa || where to store the backup archives, Do not use /home/e-smith or /root as these are included in the backup and therefore the rise option will not work! Recommended: /var/affa<br />
|-<br />
| SambaShare<br />
| yes ''or'' no|| yes || Access to the job archives via SMB<br />
|-<br />
| Debug <br />
| yes ''or'' no || no || set to yes to increase log verbosity<br />
|-<br />
| status<br />
| enabled ''or'' disabled || enabled || with set to disabled, no cron entries will made. You can still run a job manually.<br />
|-<br />
| rsync--inplace<br />
| yes ''or'' no || yes || set to no, if the rsync version on the source does not support this option (like rsync on SME6)<br />
|-<br />
| rsync--modify-window<br />
| integer >= 0 || 0 || When comparing two timestamps, rsync treats the timestamps as being equal if they differ by no more than the modify-window value. This is normally 0 for an exact match. A value >= 0 is useful if you can't get the clocks of the source and the Affa server in sync.<br />
|-<br />
| rsyncOptions<br />
| string || || addtional option string to be passed to rsync<br />
|-<br />
| rsyncdMode<br />
| yes ''or'' no || no || set to yes to connect to the rsync daemon on the remote host (instead of running rsync over ssh)<br />
|-<br />
| rsyncdModule<br />
| string || AFFA || the rsyncd module name (only applicable with rsyncdMode=yes)<br />
|-<br />
| rsyncdUser<br />
| string || affa || the username for authentication to the rsync daemon (only applicable with rsyncdMode=yes)<br />
|-<br />
| rsyncdPassword<br />
| string || || the password for authentication to the rsync daemon (only applicable with rsyncdMode=yes)<br />
|-<br />
| remoteOS<br />
| cygwin || || with remoteOS=cygwin the options --send-key and --revoke-key uses the account 'Administrator' and the correct path for the public key on a Windows/Cygwin remote host. <br />
|- <br />
| ESXi<br />
| yes ''or'' no || no || enable VMware ESXi virtual machine backup mode<br>See [[Backup of ESXi Virtual Machines using Affa]]<br />
|-<br />
| ESXiVMName<br />
| string || || The name of the VM as displayed in the VI Client<br />
|-<br />
| ESXiUsername<br />
| string || || The name of the VI client with permission to created an delete snapshots<br />
|-<br />
| ESXiPassword<br />
| string || || The password of the user ESXiUsername<br />
|-<br />
| chunkFiles<br />
| string || || Filenames that Affa should chunk and compress. Multiple file names are to be separated by the slash (/) character, e.g. 'mysql.dump/pgsql.dump' chunks the two files mysql.dump and pgsql.dump. With ESXi=yes it is implicitly set to '*.vmdk'. See also command line options --chunk-archive and --unchunk-archive<br />
|}<br />
<br />
==== Default configuration properties ====<br />
All properties can be set as defaults in the DefaultAffaConfig record. This is useful, when you set up many similar jobs. <br />
<br />
Example: You want to set the property 'localNice' to 19 for all jobs. Then run<br />
db affa setprop DefaultAffaConfig localNice 19<br />
and don't set this property for the jobs.<br />
Properties set in the job record overrides the defaults.<br />
<br />
The special property 'sendStatus' is only applicable to the DefaultAffaConfig record. It controls the status report sent by email and can be set to the values 'none', 'daily', 'weekly' or 'monthly'. <br />
<br />
To setup a weekly status report run:<br />
db affa setprop DefaultAffaConfig sendStatus weekly<br />
then setup the cronjob:<br />
affa --make-cronjobs<br />
<br />
==== Global disable ====<br />
All jobs can be disabled with setting the AffaGlobalDisable record type to 'yes'.<br />
db affa set AffaGlobalDisable yes<br />
affa --make-cronjobs<br />
<br />
to re-enable run:<br />
db affa set AffaGlobalDisable no<br />
affa --make-cronjobs<br />
<br />
=== Usage and command line options ===<br />
{{Note box|Options can be abbreviated to uniqueness, e.g. --mak is equal to --make-cronjobs}}<br />
'''affa --run JOB'''<br />
Starts a job run. Usually done by the cronjob. <br />
<br />
<br />
'''affa --make-cronjobs'''<br />
Configures the cronjobs as scheduled in the jobs records.<br />
<br />
<br />
'''affa --send-key JOB'''<br />
'''affa --send-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
This first generates the DSA key for the Affa Server, if not already done. Then it sends the public key to the host 'remoteHostName' as configured in the record of job JOB and generates the job specific ssh known host entry. <br />
{{Note box|When initially doing this step, you will need to temporarily enable "Allow secure shell access using standard passwords" on the production server.}}<br />
{{Note box|<nowiki>By default, the --send-key option works for a SME Server as a remote server and for systems where the keys are stored in /root/.ssh/authorized_keys2 and the commands /bin/cat, /bin/touch, /bin/grep and /bin/mv are available. With remoteOS=cygwin it works for a Cygwin/Windows remote server.</nowiki>}}<br />
<br />
<br />
'''affa --full-restore JOB [ARCHIVE]'''<br />
Does a full restore of the standard and additional included files and directories from the backup ARCHIVE on the remote source server as defined in the JOB record. If ARCHIVE is not given, the archive 'scheduled.0' is used as the default. The full restore reconstructs the server as it was at the time of the backup. After the restore the source host reboots.<br />
<br />
<br />
'''affa --rise [--all] JOB [ARCHIVE]'''<br />
Runs a full restore on the Affa server <b>(!)</b> of all standard files and directories from the backup ARCHIVE of job JOB. In other words: After completion, the Affa box reboots as a clone of the source server. Ensure, that the source server has been powered off before you reboot the Affa box, otherwise the network interface will not come up. This is important, when you run --rise remotely. The --rise feature only works with SME 7 servers und should only be used on dedicated backup servers.<br />
<br />
With option --all, all files and directories of the archive as defined by the include[] properties are restored. Files or directories with the same name on the Affa server will be overwritten and cannot be restored by a undorise. This should not be an issue on a dedicated Affa server which does not hold any other data. After a possible undorise those additional restored dada must be removed manually.<br />
<br />
Please note, that the rise process backs up the the Affa server itself before doing the restore from the archive. This backup is used by a possible undorise run to restore the Affa server. Only the standard files and directories are backed up. Data in non-standard loctions (like /opt) are untouched and will still exist after the rise run. See also: [[Backup_server_config#Standard_backup_.26_restore_inclusions]]<br />
<br />
<br />
'''affa --undo-rise'''<br />
This feature reverts a risen Affa box to a backup server. After a reboot, all configured jobs will work again.<br />
<br />
<br />
'''affa --unchunk-archive JOB ARCHIVE'''<br />
Concatenate and uncompress all chunked files in the archive ARCHIVE of job JOB to make the archive ready for a restore. Note that the most recent archive scheduled.0 is never chunked and therfore can be restored as it is without previous unchunking.<br />
<br />
<br />
'''affa --chunk-archive JOB ARCHIVE'''<br />
Chunk and compress all files that match the names in property chunkFiles to save disk space. The should only be used as the reversal of --unchunk-archive. Chunks are stored as bzip2 files in a directory named FILENAME.affa-chunks with 8 levels depth.<br />
<br />
<br />
<br />
'''affa --create-backup-file JOB [ARCHIVE] [--outfile=FILE]'''<br />
Creates a gzipped tar archive FILE from the ARCHIVE of job JOB. During creation the MD5 checksum is calculated against which the written tar is checked. The default ARCHIVE is scheduled.0 and default the FILE is ./smeserver.tgz. The checksum is written to FILE.md5sum.<br />
<br />
A smeserver.tgz file stored on an USB disk can be used for restore during a SME Server fresh install.<br />
<br />
<br />
'''affa --list-archives [--csv] JOB'''<br />
Displays a table of all present archives of job JOB with date, number of files, size and and bytes received. <br />
<small><pre><br />
Affa version 2.0.0-rc4 on affa1.mydomain.de (10.204.48.2)<br />
+------------------------------------------------------------------------------+<br />
| Job: primmail |<br />
| Description: Mailserver Albstadt |<br />
| Directory: /var/affa/primmail/ |<br />
| Hostname: 10.204.144.2 |<br />
| Email: admin@mydomain.de |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| Run | Completion date | Exec Time | Files | Size | Recvd |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| M 9 | Sun 2008 Mar 02 06:11 | 0h29m47s | 679010 | 80GB | 60MB |<br />
| M 8 | Sun 2008 Mar 30 06:12 | 0h26m59s | 701683 | 83GB | 48MB |<br />
| M 7 | Sun 2008 Apr 27 06:16 | 0h28m01s | 731332 | 87GB | 47MB |<br />
| M 6 | Sun 2008 Jun 01 06:20 | 0h27m37s | 755529 | 90GB | 50MB |<br />
| M 5 | Sun 2008 Jun 29 06:24 | 0h28m39s | 800200 | 94GB | 52MB |<br />
| M 4 | Sun 2008 Jul 27 06:28 | 0h29m10s | 835398 | 99GB | 59MB |<br />
| M 3 | Sun 2008 Aug 31 06:34 | 0h34m53s | 869409 | 101GB | 65MB |<br />
| M 2 | Sun 2008 Sep 28 06:38 | 0h33m19s | 910889 | 106GB | 59MB |<br />
| M 1 | Sun 2008 Oct 26 06:42 | 0h38m41s | 932627 | 110GB | 61MB |<br />
| M 0 | Sun 2008 Nov 30 06:48 | 0h51m44s | 954090 | 116GB | 75MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| W 3 | Sun 2008 Dec 14 06:50 | 0h53m34s | 962267 | 118GB | 68MB |<br />
| W 2 | Sun 2008 Dec 21 06:52 | 0h53m11s | 974914 | 120GB | 69MB |<br />
| W 1 | Wed 2008 Dec 24 06:52 | 0h48m58s | 974536 | 120GB | 64MB |<br />
| W 0 | Sun 2008 Dec 28 06:58 | 0h39m01s | 977003 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| D 6 | Tue 2008 Dec 30 06:52 | 0h54m45s | 976872 | 120GB | 77MB |<br />
| D 5 | Wed 2008 Dec 31 06:52 | 0h49m10s | 977764 | 120GB | 63MB |<br />
| D 4 | Thu 2009 Jan 01 06:28 | 0h28m09s | 977879 | 120GB | 60MB |<br />
| D 3 | Fri 2009 Jan 02 06:53 | 0h53m21s | 978144 | 120GB | 68MB |<br />
| D 2 | Sat 2009 Jan 03 06:53 | 0h53m15s | 978072 | 120GB | 60MB |<br />
| D 1 | Sun 2009 Jan 04 06:53 | 0h53m16s | 976478 | 120GB | 70MB |<br />
| D 0 | Mon 2009 Jan 05 06:52 | 0h52m42s | 977062 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| S 1 | Mon 2009 Jan 05 17:57 | 0h27m48s | 976353 | 120GB | 98MB |<br />
| S 0 | Tue 2009 Jan 06 06:52 | 0h52m55s | 976539 | 120GB | 70MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
</pre></small><br />
With --csv, the output is in machine readable colon separated format.<br />
<br />
<br />
'''affa --status [--csv]'''<br />
Displays a table of all configured jobs with enable status, time of last and next run, size of the most recent archive, exectution time of the last run and the number of scheduled (S), daily (D), weekly (W), monthly (M) and yearly (Y) archives. Last time shows 'failed', if a job did not run in the last 24h. For disabled jobs 'Last' always shows 'failed' after 24 h. To see the date and time of the last run of those jobs use the --list-archives option. Column 'Next' shows the time when the next run will be started, if 'Enabled' is 'yes'.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| Job | ENA | Last | Exec Time | Next | Size | N of S,D,W,M,Y |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| erp-alb-rsyncd | yes | 00:20 | 0h00m14s | 00:20 | 46MB | 1, 7, 4,10, 0 |<br />
| erp-fra-rsyncd | yes | 02:46 | 0h01m03s | 02:45 | 712MB | 1, 7, 4,10, 0 |<br />
| esxi-TS-W2K | yes | 00:37 | 4h22m08s | 20:15 | 60GB | 1, 7, 1, 0, 0 |<br />
| esxi-W2KR2 | yes | 02:22 | 3h52m09s | 22:30 | 40GB | 1, 7, 1, 0, 0 |<br />
| helpdesk | yes | 00:25 | 0h00m47s | 00:25 | 117MB | 1, 7, 4,10, 0 |<br />
| imageserv | yes | running (pid 16477) | 1, 7, 4,10, 0 |<br />
| intraweb | yes | 06:34 | 0h04m50s | 18:00 | 2.1GB | 2, 7, 4,10, 0 |<br />
| pdcalb | yes | 21:19 | 0h14m27s | 21:05 | 89GB | 1, 7, 4,10, 0 |<br />
| pdcfra | yes | 04:18 | 0h03m33s | 04:15 | 33GB | 1, 7, 4,10, 0 |<br />
| primmail | yes | 06:52 | 0h52m55s | 17:30 | 120GB | 2, 7, 4,10, 0 |<br />
| rayofhope | yes | 21:52 | 0h07m40s | 21:45 | 26GB | 1, 7, 4,10, 0 |<br />
| smecrmpg | yes | 22:35 | 0h00m21s | 22:35 | 70MB | 1, 7, 4,10, 0 |<br />
| sozserv | yes | 02:09 | 0h04m03s | 02:05 | 5.9GB | 1, 7, 4,10, 0 |<br />
| wiki | yes | 03:45 | 0h00m27s | 03:45 | 278MB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| az32share | no | - | 0h00m22s | 03:05 | 1.3GB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
</pre></small><br />
With --csv, the output is printed in a machine readable colon separated format.<br />
<br />
<br />
'''affa --disk-usage'''<br />
Shows the current disk usage of all root dir filesystems<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup2.mydomain.de (10.204.0.52)<br />
+------+--------+--------+----------------------------------------------------+<br />
| Use% | Used | Avail | Root Dir |<br />
+------+--------+--------+----------------------------------------------------+<br />
| 71% | 938GB | 365GB | /var/affa |<br />
| 20% | 194GB | 759GB | /mnt/affadev |<br />
+------+--------+--------+----------------------------------------------------+<br />
</pre></small><br />
With --csv, the output is printed in a machine readable colon separated format.<br />
<br />
<br />
'''affa --show-schedule [--all]'''<br />
Prints a 'graphical' timetable for all enabled jobs. The resolution is 30 minutes. An 'X' character marks the scheduled start times. The last performance duration is marked with '=' characters.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
TIME 0:00 4:00 8:00 12:00 16:00 20:00<br />
erp-alb-rsyncd X------- -------- -------- -------- -------- --------<br />
helpdesk X------- -------- -------- -------- -------- --------<br />
esxi-W2KR2 =====--- -------- -------- -------- -------- -----X==<br />
esxi-TS-W2K ==------ -------- -------- -------- -------- X=======<br />
imageserv ---X---- -------- -------- -------- -------- --------<br />
sozserv ----X--- -------- -------- -------- -------- --------<br />
erp-fra-rsyncd -----X-- -------- -------- -------- -------- --------<br />
wiki -------X -------- -------- -------- -------- --------<br />
pdcfra -------- X------- -------- -------- -------- --------<br />
primmail -------- ----X=-- -------- -------- ---X---- --------<br />
intraweb -------- -----X-- -------- -------- ----X--- --------<br />
pdcalb -------- -------- -------- -------- -------- --X-----<br />
rayofhope -------- -------- -------- -------- -------- ---X----<br />
smecrmpg -------- -------- -------- -------- -------- -----X--<br />
1 disabled jobs not listed. Use --all to display.<br />
</pre></small><br />
<br />
<br />
'''affa --send-status'''<br />
Sends the status table, the disk-usage and the archive list of all jobs to the email addresses configured in the 'DefaultAffaConfig' record. Used by the cronjob 'affa-status'.<br />
<br />
<br />
'''affa --mailtest JOB'''<br />
Sends a test email to the email addresses configured in the JOB record. With property Watchdog=yes, a test email is sent from the remote host, too. Use this to verify, that your mail processing is functional.<br><br />
'''Note:''' By default Affa only sends messages on errors, never on success (see property chattyOnSuccess).<br />
<br />
<br />
'''affa --cleanup JOB'''<br />
After you have lowered a keep value, e.g. scheduledKeep, then archives with a higher indices will no longer be shifted and will exist for ever. This option finds these archives and deletes them.<br />
<br />
<br />
'''affa --rename-job JOB NEWNAME'''<br />
Renames the job JOB to NEWNAME including all database records and archive directories.<br />
<br />
<br />
'''affa --move-archive JOB NEWROOTDIR'''<br />
Moves the archive directory of job JOB to the rootdir NEWROOTDIR and adjusts the property RootDir. NEWROOTDIR must be a full path starting with a slash. As moving across filesystems (e.g. from an external USB drive to the local disk) is not possible, Affa uses a copy command in this case and deletes the source directory after that. Depending on the archive size, copying across filesystems can take a long time.<br />
<br />
<br />
'''affa --delete-job [--revoke-key] JOB'''<br />
Irreversibly deletes a job including all archives, configuration and report databases. With given --revoke-key option, the public key on the remote server will be deleted.<br />
<br />
<br />
'''affa --revoke-key JOB'''<br />
'''affa --revoke-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Deletes the public dsa key on the remote server.<br />
{{Note box|<nowiki>By default, the --send-key option works for a SME Server as a remote server and for systems where the keys are stored in /root/.ssh/authorized_keys2. With remoteOS=cygwin it works for a Cygwin/Windows remote server.</nowiki>}}<br />
<br />
<br />
'''affa --check-connections'''<br />
Checks the ssh login for all configured jobs. For jobs where the public key was not yet sent, you are prompted for the password and the key will be sent then.<br />
<br />
<br />
'''affa --kill JOB'''<br />
Terminates the running job JOB and all its child processes (rsync processes).<br />
<br />
'''affa --debug'''<br />
Enables verbose logging. Overrides job and global configurations.<br />
<br />
=== Example setups ===<br />
==== Dedicated backup server ====<br />
* Set up a job for every server you want to backup<br />
* Send the public keys to every server<br />
affa --send-key JOBNAME<br />
* Check whether password-less logins are working<br />
affa --check-connections<br />
* Check whether the scheduled jobs are evenly distributed over the day<br />
affa --show-schedule<br />
* Create the cron jobs<br />
affa --make-cronjobs<br />
* Check the status after 24 hours<br />
affa --status<br />
<br />
<br />
==== Backup of single ibays ====<br />
Suppose you want to backup the ibays 'staff1' and 'staff2' on your production server with WAN IP 82.123.1.1 to an Affa server in a different location over the internet every night at 2:30am.<br />
* log into the Affa server and install the packages as described above.<br />
* copy the config helper script sample<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/ibay-staff-job.pl<br />
* edit /root/ibay-staff-job.pl and set<br />
my $jobname='ibay-staff';<br />
and<br />
'remoteHostName‘=>'82.123.1.1',<br />
'TimeSchedule'=>'0230',<br />
'SMEServer'=>'no',<br />
'Include[0]'=>'/home/e-smith/files/ibays/staff1',<br />
'Include[1]'=>'/home/e-smith/files/ibays/staff2',<br />
* write the configuration<br />
/root/ibay-staff-job.pl<br />
* send the public key to the production server<br />
affa --send-key ibay-staff<br />
* check next morning<br />
affa --list-archives ibay-staff<br />
affa --status<br />
ls /var/affa/ibay-staff<br />
<br />
==== Two production servers backup each other ====<br />
You have two sites connnected via a VPN and a SME Server running on each site. In that case you don't need a dedicated Affa backup server. Both production servers can additionally act as Affa backup servers backing up the server of the other site. Simply install Affa and configure a job that backs up the other one. You can use all Affa features except of the rise feature. <br />
When using the rise feature the server become any of the backed up systems, which is less useful in this scenario as it would give you a running copy of the server of the other site while the server of this site is down.<br />
<br />
To get redundancy and a faster restore you can configure a local backup to an external USB or NAS device.<br />
<br />
Please pay attention, that you do not backup the archives back to the other site. Set the RootDir property to a path which is not included in the SME default backup list. When leaving the RootDir property to its default '/var/affa', this is guaranteed.<br />
<br />
==== Backing up a Windows computer ====<br />
Backing up data from a Windows system requires the Cygwin Rsyncd daemon installed and configured on Windows. The standard procedure ''rsync over ssh'' does not work, as the Cygwin rsync process always hangs after some files were transferred. <br />
<br />
===== Rsyncd setup on the Windows computer ===== <br />
Install the Cygwin base, the rsync package and configure the Rsyncd service as described in this document: [[Rsyncd setup on a windows computer for use with Affa backup]]'. <br />
The installation of the sshd service is optional and not needed for the backup itself, but having a ssh login can be very helpful for administration or executing scripts on the Windows system. Affa supports sending the public key to a Windows Cygwin for password-less login.<br />
<br />
Note: Affa does not backup the Windows Access Control List (ACL) information. You may need to correct the ACLs manually after a restore.<br />
<br />
===== Affa Rsyncd mode setup (Quick start example) =====<br />
You want to backup the ''My Documents'' folders of the users ''ssorglos'' and ''bsimpson'' from the Windows computer 'ws001' with IP 192.168.1.65 to your Affa server 'affabox' with IP 192.168.1.3.<br />
* log into the 'affabox' and copy the Cygwin config helper script sample<br />
cp /usr/lib/affa/jobconfig-cygwin-sample.pl /root/ws001-mydocs-job.pl<br />
* edit /root/ws001-mydocs-job.pl and set<br />
my $jobname='ws001-mydocs';<br />
and<br />
'remoteHostName‘=>'192.168.1.65',<br />
'rsyncdPassword'=>'<i>secretword</i>',<br />
'Include[0]'=>'/c/Documents and Settings/ssorglos/My Documents/', ''# don't use backslashes in pathnames!''<br />
'Include[1]'=>'/c/Documents and Settings/bsimpson/My Documents/',<br />
where ''secretword'' must be replaced by the password you have chosen in the rsyncd.secretsfile on the Windows box.<br />
* write the configuration (this makes the database entries and sets up the cronjobs)<br />
/root/ws001-mydocs-job.pl<br />
* run the job manually. After completion check the archive /var/affa/ws001-mydocs/scheduled.0 and the logfile /var/log/affa/ws001-mydocs.log<br />
affa --run ws001-mydocs<br />
<br />
===== Affa Rsyncd mode manual setup =====<br />
In case you want to do the setup manually using the db command, these are the mandatory settings for Cygwin Rsyncd mode<br />
db affa setprop JOB rsyncdMode yes<br />
db affa setprop JOB rsyncdModule AFFA<br />
db affa setprop JOB rsyncdUser affa<br />
db affa setprop JOB rsyncdPassword ''secretword''<br />
db affa setprop JOB SMEServer no<br />
db affa setprop JOB RPMCheck no<br />
db affa setprop JOB Watchdog no<br />
Optional for ssh login<br />
db affa setprop JOB remoteOS cygwin <br />
<br />
<br />
==== Use Affa to backup to a NFS-mounted NAS or a local attached USB drive ====<br />
<br />
You want to backup your SME 7 production server with hostname 'prodbox‘ and IP 10.200.48.1 on a mounted filesystem instead of setting up a dedicated Affa box.<br />
<br />
===== Setup NAS =====<br />
You have a [http://www.freenas.org FreeNAS] box with IP 10.200.48.2 up and running with NFS service enabled. The disk is mounted to /mnt/affashare. You have authorized the IP address of your prodbox server to access share /mnt/affashare.<br />
* log into the 'prodbox' and install the NFS packages<br />
/usr/bin/yum install --enablerepo=smecontribs smeserver-nfs<br />
* now enable and start the portmapper service<br />
config setprop portmap status enabled<br />
service portmap start<br />
<br />
* mount the NFS share<br />
mkdir -p /mnt/affadevice<br />
mount 10.200.48.2:/mnt/affashare /mnt/affadevice<br />
<br />
<br />
===== Alternatively setup a USB drive =====<br />
* log into the 'prodbox' <br />
* connect a USB hard disk to the USB Bus. Now you must determine what device the kernel has assigned to the drive. View the /var/log/message and search for ''Initializing USB Mass Storage driver''. A few lines below you'll find the name of the device. In this example it is ''sdh''. Replace ''/dev/sdh'' by ''your device'' in following instructions.<br />
* use the fdisk program to create a linux partition. '''Verify that this is really the attached USB drive before you continue!'''<br />
<br />
fdisk /dev/sdh<br />
You'll most likely find an existing vfat dos partition, which you have to delete first. In the following we assume, that you have created a single partition ''/dev/sdh1''.<br />
* now format the drive with an ext3 filesystem<br />
mkfs.ext3 /dev/sdh1<br />
* make the mount point<br />
mkdir -p /mnt/affadevice<br />
* add the following line to the /etc/fstab<br />
/dev/sdh1 /mnt/affadevice ext3 defaults<br />
* mount the drive<br />
mount /mnt/affadevice<br />
* crosscheck your work using the df command<br />
df<br />
<br />
<br />
===== Setup Affa =====<br />
You want to run backups on 11:30 h, 15:30 h and 19:30 h and you want to keep the last 3 scheduled backups, 7 daily, 5 weekly, 12 monthly and 1 yearly backups.<br />
* log into the 'prodbox' and install the Affa packages as described above.<br />
* copy the config helper script sample<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
* edit /root/prodbox-job.pl and set<br />
my $jobname='prodbox';<br />
and<br />
'remoteHostName‘=>'localhost',<br />
'TimeSchedule'=>'1130,1530,1930',<br />
'scheduledKeep'=>3,<br />
'dailyKeep'=>7,<br />
'weeklyKeep'=>5,<br />
'monthlyKeep'=>12,<br />
'yearlyKeep'=>1,<br />
'RootDir=>'/mnt/affadevice',<br />
Review the other properties and change them to your needs.<br />
* write the configuration<br />
/root/prodbox-job.pl<br />
* run the job manually<br />
<br />
affa --run prodbox<br />
<br />
<br />
===== Limitations =====<br />
With this kind of setup you cannot use the affa rise feature, as it requires the backup archive to be located on the '''same fileystem''' as the server installation. The rise option uses hardlinks, which are not working across filesystems.<br />
<br />
===== Automount =====<br />
Having the backup archives in the same filesystem is always a risk, which can be minimized by using the automount feature. Then the external filesystem is only mounted during a job run.<br />
<br />
In the NAS example set<br />
'AutomountDevice=>'10.200.48.2:/mnt/affashare',<br />
'AutomountPoint =>'mnt/affadevice',<br />
and skip the step 2.<br />
<br />
In the USB drive example set<br />
'AutomountDevice=>'/dev/sdc1',<br />
'AutomountPoint =>'mnt/affadevice',<br />
and skip the steps 5 to 8.<br />
<br />
The mount point will be automatically created, if it does not exist. <br><br />
To access the archive directory, you need to mount it manually.<br />
<br />
=== Restore ===<br />
==== Restore single files or directories ====<br />
'''Example 1:''' It's Tuesday January 6th 2009, when user 'briedlin' asks you to restore the messages of his mailbox 'orders' he has accidentally deleted on Monday.<br />
<br />
* You first must check what backup archives are available. The jobname of this server backup is 'primmail'. To get a listing of all archives run <br />
affa --list-archives primmail<br />
''(see the example listing in chapter [[Affa#Usage_and_command_line_options]]''<br />
* Choose the daily.0 archive, which was created Monday night. Now restore the mailbox 'orders' using the rsync command.<br />
* Now run the rsync command ''(note the trailing slash!)'' on the Affa backup server:<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# this variable is used to shorten the next command line''<br />
rsync -av /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
If the servers are configured to use a different ssh port eg 2222, then instead do:<br />
<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# this variable is used to shorten the next command line''<br />
rsync -av -e 'ssh -p 2222' /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
<br />
<br />
'''Example 2:''' A user has deleted the file orderform.pdf from ibay 'docs' on the server 10.204.48.1 and asks you to restore it.<br />
<br />
* You have searched and found the latest version of this file in weekly archive of job 'prodserv'.<br />
* To copy it back to the server 10.204.48.1 run on the Affa server<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# this variable is used to shorten the next command line''<br />
rsync -av /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
* If the servers are configured to use a different ssh port eg 2222, then instead do:<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# this variable is used to shorten the next command line''<br />
rsync -av -e 'ssh -p 2222' /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
<br />
<br />
'''Example 3:''' Restoring a file with special characters in the path<br />
<br />
Do not use shell variables to shorten the command. It would complicate things more than it would help.<br />
Quote the source and destination path. In the destination path escape blank characters with a double backslash and brackets with a single backslash. On the Affa backup server do:<br />
rsync -av "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
If the servers are configured to use a different ssh port eg 2222, then instead do:<br />
<br />
rsync -av -e 'ssh -p 2222' "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
==== Full restore ====<br />
To run a full restore of user and configuration data run on the Affa server<br />
affa --full-restore <JOB> [<ARCHIVE>]<br />
This rsyncs the data from the backup ARCHIVE back to the 'remoteHostname' defined in the configuration of the job JOB. <br />
<br />
Example:<br />
You have backuped your production server 'prodsrv' as job 'prodbox'. To restore from the latest backup run<br />
affa --full-restore prodbox<br />
<br />
To restore from the older archive daily.3 run <br />
affa --full-restore prodbox daily.3<br />
<br />
{{Warning box| A full restore reconstructs the server as it was at the time of the backup. That means, that all files created or server configuration changes made after the backup will be lost. After the restore is done, the restored server reboots automatically. }}<br />
<br />
==== Moving a SME 7 server installation to new hardware using the Affa rise feature ====<br />
Please see this Howto: [[Moving SME to new Hardware]]<br />
<br />
<br />
==== Restore from USB drive on new server ====<br />
<br />
This tip comes from http://forums.contribs.org/index.php?topic=42412.0<br />
<br />
Q) I have complete backups using affa stored on a usb hard drive connected to our affa backup server. I need to restore an earlier monthly backup of our job "mailbackup" to a test server rather than back to the original system. If I did it from the backup server I see the instructions of how to rise that server to the current backup on that server but I want to restore a point about a month ago before some strange things happened. And I want to do it on a machine that is not our backup server or our production server. I tried to figure out how but am lost in the options. My goal is to do some testing.<br />
<br />
A) On your testserver setup a job mailbackup identical to that on your backup server but set property RootDir to /var/affa and property status to disabled. Connect the USB drive and copy the archive of the job mailbackup to /var/affa. Then run affa --rise mailbackup ARCHIVE<br />
<br />
Remember that Affa places job setup scripts into the archive directories. In your case it is mailbackup-setup.pl. Copy it to your testserver, change the RootDir and status properties and execute it.<br />
<br />
=== FAQ ===<br />
'''What files and directories are included by default?'''<br />
<br />
With SMEServer=no nothing at all.<br />
<br />
With SMEServer=yes the SME default backup list. The following command displays the list:<br />
perl -e 'use esmith::Backup;$b=new esmith::Backup;print join("\n",$b->restore_list)."\n"' <br />
<br />
<br />
'''Can I exclusively backup image files from a specific directory?'''<br />
<br />
Yes. Assuming you want to backup all gif and jpg files from directory /home/e-smith/files/ibays/pictures/files use this configuration<br />
db affa setprop JOBNAME SMEServer no # do not include SME Server default directories and files<br />
db affa setprop JOBNAME Include[0] '/home/e-smith/files/ibays/pictures/files' # start searching here<br />
db affa setprop JOBNAME Include[1] '*/' # search the tree recursively<br />
db affa setprop JOBNAME Include[2] '*.gif' # copy files that match these patterns<br />
db affa setprop JOBNAME Include[3] '*.jpg' <br />
db affa setprop JOBNAME Exclude[0] '*' # exclude all others<br />
db affa setprop JOBNAME rsyncOptions '-m' # do not create empty folders<br />
<br />
<br />
'''How can I move a backup archive from my production server in a remote branch office to the Affa server using an USB disk? I want to avoid to download the first full backup over the internet.'''<br />
Install Affa on your production server, connect and mount the USB disk. Setup a job to write the archive to the USB disk. After the job run, connect the USB disk to your Affa server and setup the job in the same way. Use the setup script from the archive directory. You only need to change the remoteHostName property. Now use the --move-archive option to move the archive to the local disk. If not already done, send the public key to your production server. You're done.<br />
<br />
<br />
'''How do I backup two SME servers behind a firewall?'''<br />
First you need to configure port forwardings for the ssh service on your firewall. Use a non-standard port, e.g 2200->22, for your second server. Setup a job on your Affa server for each of your production servers. Set up the job property sshPort=2200 for second server.<br />
<br />
=== Uninstall ===<br />
This removes the installed Affa package, all configuration data and all backup archives.<br />
<br />
Run the following commands for each job:<br />
affa --revoke-key JOBNAME<br />
affa --delete-job JOBNAME<br />
Verify that all jobs have been deleted<br />
affa --status<br />
Remvove the Affa package<br />
rpm -e smeserver-affa<br />
and, if these packages are not needed by any other packages:<br />
rpm -e perl-Filesys-DiskFree perl-Compress-Bzip2<br />
Cleaning up<br />
rm -f /etc/cron.d/affa /etc/cron.d/affa-status<br />
rm -rf /home/e-smith/db/affa /home/e-smith/db/affa-report<br />
rm -rf /var/affa /var/log/affa<br />
<br />
=== Bug report ===<br />
Affa is listed in the [http://bugs.contribs.org/enter_bug.cgi?product=SME%20Contribs&component=smeserver-affa bugtracker contribs section].<br />
Please report all bugs, new feature requests and documentation issues there. <br />
<br />
=== Additional information ===<br />
For details of performance, changelog etc see [[:Affa:Additional information]]<br />
<br />
=== References ===<br />
* Wikipedia article http://en.wikipedia.org/wiki/Rsync<br />
* Rsync homepage http://rsync.samba.org/<br />
* Wiki article [[Moving SME to new Hardware]]<br />
* Wiki article [[Backup with Affa and FreeDup]]<br />
* Wiki article [[Rsyncd setup on a windows computer for use with Affa backup]]<br />
* Wiki article [[Backup Windows Computers Using Affa]]<br />
* Wiki article [[Backup of ESXi Virtual Machines using Affa]]<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Backup]]</div>Cool34000https://wiki.koozali.org/index.php?title=Affa/fr&diff=12726Affa/fr2009-04-09T02:41:28Z<p>Cool34000: Adding FR translation - Thanks to Jibe</p>
<hr />
<div>{{Languages|Affa}}<br />
{{Level|Advanced}}<br />
<br />
=== Développeur ===<br />
Michael Weinberger<br />
<br />
=== Traducteur ===<br />
[http://bj-informatique.com/affa.php?lang=fr jibe]<br />
<br />
Affa signifie '''A'''utomatische '''F'''estplatten '''F'''ern'''a'''rchivierung, soit approximativement en français : Sauvegarde automatique de disque dur à distance.<br />
<br />
<br />
=== Description ===<br />
Le but principal de ce paquetage Affa est de transformer un serveur SME 7 en un serveur dédié de sauvegardes en quelques minutes. Affa sauvegarde autant que vous le désirez de serveurs SME sur n'importe quel autre serveur ayant sshd en service et rsync installé. Une fois qu'il est configuré, Affa fonctionne sans surveillance et de manière fiable, envoyant des messages d'avertissement en cas d'erreur. <br />
<br />
Toutes les archives sont des sauvegardes complètes, puisque Affa utilise la technique des hardlink. Une nouvelle sauvegarde complète ne nécessite donc que l'espace disque pour les différences et les nécessités du système de fichier pour les hardlinks et les répertoires (ce qui représente généralement 2-3%).<br />
<br />
Affa est basé sur le programme rsync et supporte l'option --compress. Cela vous permet de lancer des sauvegardes via internet ou VPN. ne configuration typique consiste en un ou plusieurs serveurs de sauvegarde Affa placés en des lieux déportés, qui sauvegardent les serveurs de production via le VPN.<br />
<br />
Une caractéristique spéciale est l'option "rise", qui vous permet de convertir votre serveur de sauvegarde en serveur de production depuis une archive sauvegardée en cas de perte totale de votre serveur de production. Cette conversion est exécutée en un temps très court, même avec une énorme quantité de données. Cette possibilité de conversion utilise les hardlinks et de ce fait n'utilise pas d'espace disque supplémentaire.<br />
<br />
Affa est un outil en ligne de commande pour les administrateurs système et est conçu intentionnellement sans interface graphique. De ce fait, il peut être géré efficacement depuis la console même via une connexion internet lente.<br />
<br />
'''Note:''' Ce document concerne la version 2 Release Candidate d'Affa. La documentation de la dernière version 1 stable se trouve [http://wiki.contribs.org/index.php?title=Affa&oldid=11974 ici].<br />
<br />
==== Un coup d'oeil aux caractéristiques d'Affa ====<br />
* Affa est sûr : Tous transferts et connexions sont faits en utilisant le protocole ssh avec une authentification par clés publique/privée.<br />
* Lance périodiquement des sauvegardes complètes sans intervention. * Seules les différences avec la sauvegarde complète précédente sont transférées par le réseau<br />
* Utilise rsync avec l'option de compression pour les connexions lentes, ce qui permet des sauvegardes via internet/VPN<br />
* Utilise la technique des hardlink pour réduire l'espace disque physique à seulement ce qui est nécessaire pour les différences entre deux sauvegardes complètes<br />
* Mémorise un nombre configurable de sauvegardes automatisées, journalières, hebdomadaires, mensuelles et annuelles<br />
* On peut naviguer dans les archives sans avoir à les décompresser. Il n'est pas nécessaire de les décompresser d'abord.<br />
* Les archives peuvent être attachées à un partage Samba.<br />
* Les tâches de sauvegarde sont démarrées par le démon cron<br />
* Les travaux interrompus continuent au redémarrage en tenant compte des données déjà transférées<br />
* Sauvegarde les répertoires et fichiers e-smith par défaut, lorsque la propriété SMEServer est mise à 'yes'<br />
* Des répertoires et fichiers supplémentaires peuvent être inclus<br />
* Des répertoires et fichiers peuvent être exclus de la sauvegarde<br />
* Les serveurs Linux non SME peuvent être sauvegardés en mettant la propriété SMEServer à 'no' et en utilisant une liste d'inclusion<br />
* En mode ESXi, les machines virtuelles actives peuvent être sauvegardées. Voir [[Sauvegarde de machines virtuelles ESXi avec Affa]]<br />
* Priorité configurable (nice level) pour les process rsync sur les serveurs backup et source<br />
* Possibilité de lancer des programmes personnels avant et après le lancement d'une tâche (par exemple, lancement d'une sauvegarde sur bande)<br />
* Vérification de l'espace disque disponible après le lancement d'une tâche avec niveaux d'avertissement strict, normal ou risqué<br />
* Vérification étendue des conditions d'échec<br />
* Envoi de messages d'échec à une liste configurable d'adresses email<br />
* Envoi d'un message d'avertissement si le serveur de backup n'a plus d'espace disque disponible<br />
* Installe un chien de garde optionnel sur le serveur source vérifiant la disponibilité du serveur de backup (SME server seulement)<br />
* Le chien de garde envoie des avertissements, si une sauvegarde programmée n'a pas été lancée (SME server seulement)<br />
* Le chien de garde envoie un message journalier de rappel tant que l'erreur n'est pas corrigée (SME server seulement)<br />
* Possibilité d'afficher l'état courant de toutes les tâches, montrant les heures de dernier et prochain lancement, la taille et l'espace disque utilisé<br />
* Le status peut être envoyé par email journellement, hebdomadairement ou mensuellement<br />
* Possibilit d'afficher toutes les archives existantes pour une tâche, montrant la date, le nombre de fichiers et l'espace disque<br />
* Possibilité d'envoyer (et de retirer) la clé publique au serveur source (SME server et ESXi seulement)<br />
* Option pour convertir le serveur de sauvegardes en serveur de production (SME server seulement)<br />
* La fonction de conversion ne déplace pas physiquement les données et est donc extrêmement rapide et ne nécessite (presque) pas d'espace disque<br />
* La fonction de conversion peut être lancée à distance puisque les drivers ethernet du serveur de sauvegarde sont conservés<br />
* Comparaison des RPMs installés entre les serveurs source et de sauvegarde. Envoie un avertissement s'il n'y a pas correspondance.<br />
* Annulation de la conversion pour remise en service du serveur de sauvegardes<br />
* Configurable par commandes style e-smith db, avec un enregistrement pour chaque tâche et un enregistrement par défaut commun à toutes les tâches<br />
* Logs dans /var/log/affa/JOB.log et /var/log/affa/affa.log avec option debug pour plus de détails<br />
* Les fichiers de log sont permutés hebdomadairement, avec 5 fichiers conservés<br />
<br />
<br />
=== Installation ou mise à jour ===<br />
Dernière version: '''smeserver-affa-2.0.0-rc4.noarch.rpm'''<br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/smeserver-affa-2.0.0-rc4.noarch.rpm</nowiki><br />
wget <nowiki>http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Affa2/perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm</nowiki><br />
/usr/bin/yum --enablerepo=smecontribs localinstall \<br />
smeserver-affa-2.0.0-rc4.noarch.rpm \<br />
perl-Compress-Bzip2-2.09-1.2.el4.rf.i386.rpm<br />
<br />
Après la première installation d'Affa, lancez la commande suivante pour initialiser la base de données Affa.<br />
affa --make-cronjobs<br />
et déconnectez-vous puis reconnectez-vous à la console pour que le complément automatique de bash (touche TAB) prenne effet<br />
<br />
=== Exemple de démarrage rapide ===<br />
Vous avez un serveur de production SME 7 dont le nom est 'prodbox' et l'IP 10.200.48.1. Installez un second SME 7 comme serveur de sauvegardes avec le nom 'affabox' et l'IP 10.200.48.2. <br />
<br />
<ol></li><li>loggez-vous dans 'affabox' et installez les paquetages mentionnés ci-dessus.<br />
</li><li>copiez le script d'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
</li><li>editez /root/prodbox-job.pl et mettez<br />
my $jobname='prodbox';<br />
et<br />
'remoteHostName‘=>'10.200.48.1',<br />
Eventuellement, si le port du serveur distant est configuré, par exemple, en 2222, mettez<br />
'sshPort'=>2222,<br />
</li><li>sauvegardez et lancez le fichier 'prodbox-job.pl'. Cela enregistrera la configuration (et crée les entrées de base de données et les tâches cron)<br />
/root/prodbox-job.pl<br />
</li><li>Générez les clés DSA et envoyez la clé publique à la 'prodbox'<br />
{{Note box|Initialement, lorsque vous faites cette étape, vous devez temporairement mettre oui à "Autoriser l'authentification par SSH à l'aide de mots de passe standards" dans l'accès à distance sur le serveur de production}}<br />
affa --send-key prodbox<br />
</li><li>Lancez la tâche à la main<br />
<br />
affa --run prodbox<br />
</li></ol><br />
<br />
=== Configuration ===<br />
La configuration est stockée dans une base de données style e-smith. Utilisez la commande db pour configurer Affa.<br />
Le nom de tâche est la clé d'enregistrement de type 'job'.<br>Pour configurer un nouveau travail avec le nom 'prodbox', entrez :<br />
<br />
db affa set prodbox job<br />
<br />
Puis positionnez les propriétés<br />
<br />
db affa setprop prodbox remoteHostName 192.168.1.1<br />
db affa setprop prodbox TimeSchedule '0030,0730,1130,1330,1730,2030'<br />
db affa setprop prodbox Description 'My Production Server'<br />
db affa setprop prodbox status enabled<br />
et ainsi de suite...<br />
<br />
Alternativement, vous pouvez utiliser un script comme décrit ci-dessus dans le chapitre 'Démarrage rapide'.<br />
<br />
Pour vérifier votre travail, tapez :<br />
<br />
db affa show prodbox<br />
<br />
Pour finir, mettez en place les tâches cron :<br />
affa --make-cronjobs<br />
<br />
==== Propriétés de configuration de tâches ====<br />
'''Note:''' Les valeurs par défaut données dans ce tableau sont celles du programme Affa et ne doivent pas être confondues avec les valeurs prépositionnées dans les scripts d'aide, par exemple jobconfig-sample.pl.<br />
{| border="1" cellpadding="3" cellspacing=0<br />
|-<br />
| '''Propriété''' || '''Valeur''' || '''Defaut''' || '''Description''' <br />
|-<br />
| remoteHostName <br />
| FQHN ou IP || || FQHN ou IP de l'hôte source (obligatoire)<br />
|-<br />
| TimeSchedule <br />
| HHMM,HHMM,... || || N'a pas besoin d'être ordonné. Au moins une heure est obligatoire. '''Important:''' Utiliser le bon format HHMM est essentiel. Affa ne le vérifie pas. Un TimeSchedule mal formatté provoquera d'étranges erreurs Perl. <br />
|-<br />
| Description<br />
| texte || || <br />
|-<br />
| scheduledKeep<br />
| entier >= 1 || 1|| Combien de sauvegardes programmées doivent être conservées <br />
|-<br />
| dailyKeep<br>weeklyKeep<br>monthlyKeep<br>yearlyKeep<br />
| entier >= 0 || 7<br>4<br>12<br>2<br>|| Combien de sauvegardes quotidiennes, hebdomadaires, mensuelles ou annuelles doivent être conservées <br />
|-<br />
| SMEServer<br />
| yes ''ou'' no || yes || Positionné à 'yes', les répertoires e-smith par défaut sont automatiquement inclus et la propriété RPMCheck=yes peut être utilisée<br />
<br />
|-<br />
| Include[0]<br>Include[1]<br>...<br />
| full path || || Fichiers ou répertoires supplémentaires à inclure à la sauvegarde <br />
|-<br />
| Exclude[0]<br>Exclude[1]<br>...<br />
| full path || || Fichiers ou répertoires supplémentaires à exclure de la sauvegarde <br />
|-<br />
| RPMCheck<br />
| yes ''ou'' no || no || Seulement applicable aux tâches qui sauvegardent un serveur SME 7.<br>Compares les RPM de l'hôte source avec ceux de l'hôte de sauvegarde affa. Envoie un message avec une liste de différences s'il n'y a pas correspondance. Cette vérification est utile, si vous voulez avoir la possibilité de convertir le serveur de sauvegarde en serveur de production.<br />
|-<br />
| DiskSpaceWarn<br />
| strict ''ou'' normal ''ou'' risky ''ou'' none || strict || lance une vérification de l'espace disque après qu'une tâche soit terminée. Avec le niveau 'strict' un message d'avertissement sera envoyé si l'espace disponible est moins que la taille de la sauvegarde qui vient de s'achever. Avec les niveaux 'normal'/'risky' le message est envoyé si moins de 50%/10% de la taille de la sauvegarde reste disponible.<br />
'''Note:''' Lorsque RootDir est un lien symbolique vers un autre système de fichiers, l'espace disque utilisé du système de fichiers local est vérifié à la place de celui du système de fichiers lié. Positionnez le point de montage comme RootDir pour avoir une vérification correcte.<br />
|-<br />
| localNice <br />
| -19...+19 || 0 || lance le process local rsync par nice. <br />
|-<br />
| remoteNice<br />
| -19...+19 || 0 || lance le process rsync de la source par nice. <br />
|-<br />
| Watchdog<br />
| yes ''ou'' no || yes || Seulement applicable aux tâches qui sauvegardent un serveur SME 7.<br>Quand une tâche est lancée, affa installe un script chien de garde sur la source dans /etc/cron.d/, qui envoie un message d'avertissement si la prochaine tâche programmée (prise dans la propriété TimeSchedule + 10 minutes) n'a pas été lancée. Cela garantit que vous serez prévenu même en cas de panne du serveur affa. Le script chien de garde envoie un message de rappel quotidien si l'erreur persiste. La tâche lancée suivante remplace le script chien de garde avec un nouveau temps de déclenchement. <br />
|-<br />
| sshPort<br />
| port du service || 22 || Lorsque sshd sur le serveur source ou votre firewall écoute sur un port non standard, précisez le port ici.<br />
|-<br />
| ConnectionCheckTimeout<br />
| secondes || 120 || Avant que le process rsync démarre sur l'hôte source distant, affa vérifie la connexion ssh et se termine avec une erreur après le temps configuré, si l'hôte ne répond pas.<br />
|- <br />
| rsyncTimeout<br />
| secondes || 900 || Rsync se termine si aucune donnée n'est transférée pendant le temps configuré. Cela évite un gelage permanent dans le cas d'une erreur sur le réseau.<br />
|- <br />
| BandwidthLimit<br />
| entier>=0 Ko/s || 0 || Limite la vitesse de transfert des données. A valeur à zero specifie qu'il n'y a pas de limite.<br />
|- <br />
| rsyncCompress<br />
| yes ''ou'' no || no || Compresse les données transférées. Peut être utile avec les connexions internet lentes. Cela augmente la charge CPU sur les hôtes source et de sauvegarde.<br />
|-<br />
| EmailAddresses<br />
| name@domain.com,name@domain.com,... || admin|| Liste séparée par des virgules des adresses email où les messages seront envoyés.<br>'''Note:''' Par défaut, Affa n'envoie de messages que pour les erreurs, jamais en cas de succès (voir la propriété chattyOnSuccess).<br />
|-<br />
| RetryAttempts<br />
| entier >= 0 || 3 || Quand positionné à une valeur >0, Affa relance une tâche échouée RetryAttemps fois avec un délai de RetryAfter secondes.<br />
|-<br />
| RetryAfter <br />
| secondes >= 3 || 600 || Quand positionné à une valeur >0, attend RetryAfter secondes avant de relancer la tâche suite à une erreur. Utile seulement avec RetryAttempts>0<br />
|-<br />
| RetryNotification<br />
| yes ''ou'' no || yes || Quand positionné à no, Affa n'envoie pas de message d'erreur lorsqu'une tâche a échoué et que RetryAttemps est configuré. Un message d'erreur n'est envoyé que lorsque le dernier essai a échoué.<br />
|-<br />
| RetryAttempts<br />
| entier >= 0 || 0 || Quand positionné à une valeur >0, Affa envoie un message pour les tâches terminées avec succès et décrémente la valeur chattyOnSuccess. Lorsque la valeur atteint 0, Affa revient à son comportement par défaut et n'envoie plus de messages qu'en cas d'erreur.<br />
|-<br />
| AutomountDevice<br>AutomountPoint<br />
| full path || || Unité et point de montage de l'unité de sauvegarde (ex. disque USB). L'unité est montée automatiquement avant qu'une tâche soit lancées et démontée après la fin de la tâche. Avec ces deux propriétés vides, aucun montage automatique n'est effectué.<br />
|-<br />
| AutomountOptions<br />
| chaine de caractères || || Une chaine d'options passées à la commande de montage automatique<br />
|-<br />
| AutoUnmount <br />
| yes ''ou'' no || yes || Quand positionné à 'no' l'unité montée automatiquement reste montée après l'exécution d'Affa.<br />
|-<br />
| preJobCommand<br>postJobCommand<br />
| full path || || Programmes (locaux sur le serveur affa) à exécuter avant/après qu'une tâche soit lancée. Le nom de la tâche et le type (programmée, journalière etc.) sont passés en arguments au programme. Le code de sortie est de plus passé à la commande de programme post-tâche. Voir /usr/lib/affa/ pour des exemples de scripts perl.<br />
|-<br />
| RootDir<br />
| full path || /var/affa || Où stocker les archives de sauvegarde. N'utilisez pas /home/e-smith ou /root puisqu'ils sont inclus dans les répertoires à sauvegarder, ce qui empêcherait la fonction de conversion de fonctionner ! Répertoire conseillé : /var/affa<br />
|-<br />
| SambaShare<br />
| yes ''ou'' no|| yes || Accède aux archives de la tâche via SMB.<br />
|-<br />
| Debug <br />
| yes ''ou'' no || no || Positionné à 'yes', donne plus de détails dans le fichier de log.<br />
|-<br />
| status<br />
| enabled ''ou'' disabled || enabled || Positionné à 'disable', aucune entrée cron ne sera faite. Vous pouvez encore lancer les tâches à la main.<br />
|-<br />
| rsync--inplace<br />
| yes ''ou'' no || yes || Positionné à 'no', si la version rsync de la source ne supporte pas cette option (comme rsync sur SME6)<br />
|-<br />
| rsync--modify-window<br />
| entier >= 0 || 0 || En comparant deux horodatages, rsync les traite comme étant égaux s'ils ne diffèrent pas de plus de la valeur modify-window. C'est normalement 0 pour une correspondance exacte. Une valeur >= 0 est pratique si vous ne pouvez pas garder les horloges de la source et du serveur Affa synchonisées.<br />
|-<br />
| rsyncOptions<br />
| texte || || chaine d'options aditionnelles à passer à rsync.<br />
|-<br />
| rsyncdMode<br />
| yes ''ou'' no || no || Positionné à yes pour se connecter au démon rsync de l'hôte distant (au lieu de lancer rsync over ssh).<br />
|-<br />
| rsyncdModule<br />
| texte || AFFA || Le nom du module rsyncd (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| rsyncdUser<br />
| texte || affa || Le nom d'utilisateur pour authentification au démon rsync (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| rsyncdPassword<br />
| texte || || Le mot de passe pour authentification au démon rsync (seulement applicable avec rsyncdMode=yes)<br />
|-<br />
| remoteOS<br />
| cygwin || || avec remoteOS=cygwin les options --send-key et --revoke-key utilisent le compte 'Administrator' et le chemin correct pour la clé publique sur un hôte distant sous Windows/Cygwin. <br />
|- <br />
| ESXi<br />
| yes ''ou'' no || no || active le mode de sauvegarde VMware ESXi pour les machines virtuelles.<br>Voir [[Sauvegarde des machines virtuelles ESXi avec Affa]]<br />
|-<br />
| ESXiVMName<br />
| texte || || Le nom de la VM tel qu'affiché dans le client VI.<br />
|-<br />
| ESXiUsername<br />
| texte || || Le nom du client VI avec la permission de créer et détruire les instantanés (snapshots).<br />
|-<br />
| ESXiPassword<br />
| texte || || Le mot de passe de l'utilisateur ESXiUsername<br />
|-<br />
| chunkFiles<br />
| texte || || Noms de fichiers qu'Affa devrait découper et compresser. Plusieurs noms doivent être séparés par un slash (/), ex. 'mysql.dump/pgsql.dump' découpe les deux fichiers mysql.dump et pgsql.dump. Avec ESXi=yes c'est implicitement positionné à '*.vmdk'. Voir aussi les options de ligne de commande --chunk-archive et --unchunk-archive<br />
|}<br />
<br />
==== Propriétés de la configuration par défaut ====<br />
Toutes les propriétées peuvent être positionnées par défaut dans l'enregistrement DefaultAffaConfig. C'est pratique, lorsque vous configurez plusieurs tâches similaires. <br />
<br />
Exemple : Vous voulez positionner la propriété 'localNice' à 19 pour toutes les tâches. Tapez<br />
db affa setprop DefaultAffaConfig localNice 19<br />
et ne positionnez pas cette propriété pour les tâches.<br />
Les propriétés positionnées dans les tâches sont prioritaires sur les propriétés par défaut.<br />
<br />
La propriété spéciale 'sendStatus' ne s'applique que dans l'enregistrement DefaultAffaConfig. Elle contrôle le rapport d'état (status) envoyé par mail et peut prendre les valeurs 'none', 'daily', 'weekly' ou 'monthly'. <br />
<br />
Pour configurer un rapport hebdomadaire, tapez :<br />
db affa setprop DefaultAffaConfig sendStatus weekly<br />
puis configurez cronjob :<br />
affa --make-cronjobs<br />
<br />
==== Désactivation globale ====<br />
Toutes les tâches peuvent être désactivées en positionnant l'enregistrement AffaGlobalDisable sur 'yes'.<br />
db affa set AffaGlobalDisable yes<br />
affa --make-cronjobs<br />
<br />
Pour réactiver :<br />
db affa set AffaGlobalDisable no<br />
affa --make-cronjobs<br />
<br />
=== Utilisation et options de ligne de commande ===<br />
{{Note box|Les options peuvent être abrégées tant qu'elles restent uniques, ex. --mak est identique à --make-cronjobs}}<br />
'''affa --run JOB'''<br />
Lance une tâche. Normalement effectué par cronjob. <br />
<br />
<br />
'''affa --make-cronjobs'''<br />
Configure les tâches cron comme programmées dans les enregistrements de tâches.<br />
<br />
<br />
'''affa --send-key JOB'''<br />
'''affa --send-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Génère d'abord la clé DSA pour le serveur Affa, si cela n'a pas déjà été fait. Envoie ensuite la clé publique à l'hôte 'remoteHostName' comme configuré dans l'enregistrement de la tâche et génère l'entrée ssh known host (hôte connu) spécifique à la tâche. <br />
{{Note box|Initialement, lorsque vous faites cette étape, vous aurez besoin d'activer temporairement "Autoriser l'authentification par SSH à l'aide de mots de passe standards" sur le serveur de production.}}<br />
{{Note box|<nowiki>l'option --send-key fonctionne pour SME Server comme serveur distant et pour les systèmes sur lesquels les clés publiques sont stockées dans /root/.ssh/authorized_keys2 et sur lesquels les commandes /bin/cat, /bin/touch, /bin/grep et /bin/mv sont disponibles. Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}<br />
<br />
<br />
'''affa --full-restore JOB [ARCHIVE]'''<br />
Effectue une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur source distant comme défini dans l'enregistrement JOB. Si [ARCHIVE] n'est pas donnée, l'archive 'scheduled.0' est utilisée comme défaut. La restauration totale reconstruit le serveur comme il était au moment de la sauvegarde. Après la restauration l'hôte source est redémarré.<br />
<br />
<br />
'''affa --rise [--all] JOB [ARCHIVE]'''<br />
Lance une restauration totale depuis l'archive de sauvegarde [ARCHIVE] sur le serveur Affa <b>(!)</b> comme défini dans l'enregistrement JOB. Autrement dit, une fois terminée, le serveur de sauvegarde reboote comme un clone du serveur source. Assurez-vous d'avoir arrêté le serveur source avant de rebooter le serveur de sauvegardes, sinon l'interface réseau ne sera pas activée. Cela est important, lorsque vous lancez --rise à distance. La fonction --rise ne fonctionne qu'avec les serveurs SME 7et ne devrait être utilisée que sur les serveurs de sauvegardes dédiés.<br />
<br />
Avec l'option --all, tous les fichiers et répertoires de l'archive tels que définis par les propriétés include[] sont restaurés. Les fichiers et répertoires avec le même nom sur le serveur Affa seront écrasés et ne peuvent pas être restaurés par un undoris. Cela ne devrait pas poser de problème sur un serveur Affa dédié qui ne contient aucune autre donnée. Après un éventuel undorise ces données aditionnelles restaurées doivent être supprimées manuellement.<br />
<br />
Remarquez que le processus rise sauvegarde le serveur Affa lui-même avant d'effectuer la restauration de l'archive. Cette sauvegarde est utilisée par un éventuel undorise pour restaurer le serveur Affa. Seulement les fichiers et répertoires standards sont sauvegardés. Les données dans des endroits non standard (comme /opt) ne sont pas touchées et existeront encore après le rise. Voir aussi : [[Backup_server_config#Standard_backup_.26_restore_inclusions]]<br />
<br />
<br />
'''affa --undo-rise'''<br />
Cette fonction reconvertit en serveur de sauvegarde un serveur Affa préalablement converti en serveur de production. Après un redémarrage, toutes les tâches configurées fonctionneront à nouveau.<br />
<br />
<br />
'''affa --unchunk-archive JOB ARCHIVE'''<br />
Concatène et décompresse tous les fichiers découpés dans l'archive ARCHIVE de la tâche JOB pour rendre l'archive prête pour une restauration. Notez que l'archives la plus récente scheduled.0 n'est jamais découpée et donc qu'elle peut être restaurée telle quelle sans re-concaténation préalable.<br />
<br />
<br />
'''affa --chunk-archive JOB ARCHIVE'''<br />
Découpe et compresse tous les fichiers dont les noms correspondent à la propriété chunkFiles pour économiser l'espace disque. Cela ne devrait être utilisé que comme l'inverse de --unchunk-archive. Les découpages sont stockés en fichiers bzip2 dans un répertoire nommé FILENAME.affa-chunks avec 8 niveaux de profondeur.<br />
<br />
<br />
<br />
'''affa --create-backup-file JOB [ARCHIVE] [--outfile=FILE]'''<br />
Crée une archive tar gzippée FILE depuis l'ARCHIVE de la tâche JOB. Pendant la création la somme MD5 est calculée puis le fichier tar enregistré lui est comparé. L'archive par défaut est schedule.0 et le fichier FILE par défaut est./smeserver.tg. La somme de contrôle est écrite dans FILE.md5sum.<br />
<br />
Un fichier smeserver.tgz stocké sur un disque USB peut être utilisé pour restauration lors d'une nouvelle installation de SME Server.<br />
<br />
<br />
'''affa --list-archives [--csv] JOB'''<br />
Affiche un tableau de toutes les archives de la tâche JOB existantes, avec la date, le nombre de fichiers, la taille et l'espace disque utilisé. <br />
<small><pre><br />
Affa version 2.0.0-rc4 on affa1.mydomain.de (10.204.48.2)<br />
+------------------------------------------------------------------------------+<br />
| Job: primmail |<br />
| Description: Mailserver Albstadt |<br />
| Directory: /var/affa/primmail/ |<br />
| Hostname: 10.204.144.2 |<br />
| Email: admin@mydomain.de |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| Run | Completion date | Exec Time | Files | Size | Recvd |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| M 9 | Sun 2008 Mar 02 06:11 | 0h29m47s | 679010 | 80GB | 60MB |<br />
| M 8 | Sun 2008 Mar 30 06:12 | 0h26m59s | 701683 | 83GB | 48MB |<br />
| M 7 | Sun 2008 Apr 27 06:16 | 0h28m01s | 731332 | 87GB | 47MB |<br />
| M 6 | Sun 2008 Jun 01 06:20 | 0h27m37s | 755529 | 90GB | 50MB |<br />
| M 5 | Sun 2008 Jun 29 06:24 | 0h28m39s | 800200 | 94GB | 52MB |<br />
| M 4 | Sun 2008 Jul 27 06:28 | 0h29m10s | 835398 | 99GB | 59MB |<br />
| M 3 | Sun 2008 Aug 31 06:34 | 0h34m53s | 869409 | 101GB | 65MB |<br />
| M 2 | Sun 2008 Sep 28 06:38 | 0h33m19s | 910889 | 106GB | 59MB |<br />
| M 1 | Sun 2008 Oct 26 06:42 | 0h38m41s | 932627 | 110GB | 61MB |<br />
| M 0 | Sun 2008 Nov 30 06:48 | 0h51m44s | 954090 | 116GB | 75MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| W 3 | Sun 2008 Dec 14 06:50 | 0h53m34s | 962267 | 118GB | 68MB |<br />
| W 2 | Sun 2008 Dec 21 06:52 | 0h53m11s | 974914 | 120GB | 69MB |<br />
| W 1 | Wed 2008 Dec 24 06:52 | 0h48m58s | 974536 | 120GB | 64MB |<br />
| W 0 | Sun 2008 Dec 28 06:58 | 0h39m01s | 977003 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| D 6 | Tue 2008 Dec 30 06:52 | 0h54m45s | 976872 | 120GB | 77MB |<br />
| D 5 | Wed 2008 Dec 31 06:52 | 0h49m10s | 977764 | 120GB | 63MB |<br />
| D 4 | Thu 2009 Jan 01 06:28 | 0h28m09s | 977879 | 120GB | 60MB |<br />
| D 3 | Fri 2009 Jan 02 06:53 | 0h53m21s | 978144 | 120GB | 68MB |<br />
| D 2 | Sat 2009 Jan 03 06:53 | 0h53m15s | 978072 | 120GB | 60MB |<br />
| D 1 | Sun 2009 Jan 04 06:53 | 0h53m16s | 976478 | 120GB | 70MB |<br />
| D 0 | Mon 2009 Jan 05 06:52 | 0h52m42s | 977062 | 120GB | 61MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
| S 1 | Mon 2009 Jan 05 17:57 | 0h27m48s | 976353 | 120GB | 98MB |<br />
| S 0 | Tue 2009 Jan 06 06:52 | 0h52m55s | 976539 | 120GB | 70MB |<br />
+-------+-----------------------+-----------+----------------+--------+--------+<br />
</pre></small><br />
Avec --csv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --status [--csv]'''<br />
Affiche un tableau de toutes les tâches actives (status enabled), avec l'heure de dernier et prochain lancement, la taille, l'espace disque utilisé par la plus récente archive, la date d'exécution du dernier lancement, et le nombre d'archives programmées (S), quotidiennes (D), hebdomadaires (W), mensuelles (M) et annuelles (Y). Le dernier lancement (colonne 'Last') affiche 'failed' si une tâche n'a pas été lancée dans les dernières 24h. Pour les tâches désactivées, 'Last' affiche toujours 'failed' au bout de 24 h. Pour voir la date et l'heure du dernier lancement de ces tâches, utilisez l'option --list-archives. La colonne 'Next' montre l'heure à laquelle le prochain lancement aura lieu, si 'Enabled' est à 'yes'.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| Job | ENA | Last | Exec Time | Next | Size | N of S,D,W,M,Y |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| erp-alb-rsyncd | yes | 00:20 | 0h00m14s | 00:20 | 46MB | 1, 7, 4,10, 0 |<br />
| erp-fra-rsyncd | yes | 02:46 | 0h01m03s | 02:45 | 712MB | 1, 7, 4,10, 0 |<br />
| esxi-TS-W2K | yes | 00:37 | 4h22m08s | 20:15 | 60GB | 1, 7, 1, 0, 0 |<br />
| esxi-W2KR2 | yes | 02:22 | 3h52m09s | 22:30 | 40GB | 1, 7, 1, 0, 0 |<br />
| helpdesk | yes | 00:25 | 0h00m47s | 00:25 | 117MB | 1, 7, 4,10, 0 |<br />
| imageserv | yes | running (pid 16477) | 1, 7, 4,10, 0 |<br />
| intraweb | yes | 06:34 | 0h04m50s | 18:00 | 2.1GB | 2, 7, 4,10, 0 |<br />
| pdcalb | yes | 21:19 | 0h14m27s | 21:05 | 89GB | 1, 7, 4,10, 0 |<br />
| pdcfra | yes | 04:18 | 0h03m33s | 04:15 | 33GB | 1, 7, 4,10, 0 |<br />
| primmail | yes | 06:52 | 0h52m55s | 17:30 | 120GB | 2, 7, 4,10, 0 |<br />
| rayofhope | yes | 21:52 | 0h07m40s | 21:45 | 26GB | 1, 7, 4,10, 0 |<br />
| smecrmpg | yes | 22:35 | 0h00m21s | 22:35 | 70MB | 1, 7, 4,10, 0 |<br />
| sozserv | yes | 02:09 | 0h04m03s | 02:05 | 5.9GB | 1, 7, 4,10, 0 |<br />
| wiki | yes | 03:45 | 0h00m27s | 03:45 | 278MB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
| az32share | no | - | 0h00m22s | 03:05 | 1.3GB | 1, 7, 4, 8, 0 |<br />
+----------------+-----+-------+-----------+-------+-------+----------------+<br />
</pre></small><br />
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --disk-usage'''<br />
Affiche l'utilisation actuelle du disque pour les répertoires racine de tous les systèmes de fichiers.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup2.mydomain.de (10.204.0.52)<br />
+------+--------+--------+----------------------------------------------------+<br />
| Use% | Used | Avail | Root Dir |<br />
+------+--------+--------+----------------------------------------------------+<br />
| 71% | 938GB | 365GB | /var/affa |<br />
| 20% | 194GB | 759GB | /mnt/affadev |<br />
+------+--------+--------+----------------------------------------------------+<br />
</pre></small><br />
Avec --cxv, le tableau est généré selon un format séparé par des deux-points (:) lisible par les programmes.<br />
<br />
<br />
'''affa --show-schedule [--all]'''<br />
Affiche un calendrier 'graphique' de toutes les tâches actives. La résolution est de 30 minutes. Un 'X' indique les heures de lancement programmés. La durée de la dernière exécution est marquée avec des '='.<br />
<small><pre><br />
Affa version 2.0.0-rc4 on backup.mydomain.de (10.204.48.2)<br />
TIME 0:00 4:00 8:00 12:00 16:00 20:00<br />
erp-alb-rsyncd X------- -------- -------- -------- -------- --------<br />
helpdesk X------- -------- -------- -------- -------- --------<br />
esxi-W2KR2 =====--- -------- -------- -------- -------- -----X==<br />
esxi-TS-W2K ==------ -------- -------- -------- -------- X=======<br />
imageserv ---X---- -------- -------- -------- -------- --------<br />
sozserv ----X--- -------- -------- -------- -------- --------<br />
erp-fra-rsyncd -----X-- -------- -------- -------- -------- --------<br />
wiki -------X -------- -------- -------- -------- --------<br />
pdcfra -------- X------- -------- -------- -------- --------<br />
primmail -------- ----X=-- -------- -------- ---X---- --------<br />
intraweb -------- -----X-- -------- -------- ----X--- --------<br />
pdcalb -------- -------- -------- -------- -------- --X-----<br />
rayofhope -------- -------- -------- -------- -------- ---X----<br />
smecrmpg -------- -------- -------- -------- -------- -----X--<br />
1 disabled jobs not listed. Use --all to display.<br />
</pre></small><br />
<br />
<br />
'''affa --send-status'''<br />
Envoie le tableau d'état, l'espace disque utilisé et la liste des archives de toutes les tâches à l'adresse email configurée dans l'enregistrement 'DefaultAffaConfig'. Cette commande est utilisée par la tâche cron 'affa status'.<br />
<br />
<br />
'''affa --mailtest JOB'''<br />
Envoie un email de test aux adresses email configurées dans l'enregistrement de la tâche. Avec la propriété 'Watchdog' à 'yes', un email de test est envoyé depuis le serveur distant aussi. Utilisez cela pour vérifier que l'envoi des mails fonctionne.<br><br />
'''Note:''' Par défaut, Affa n'envoie des messages qu'en cas d'erreur, jamais en cas de succès (voir la propriété 'chattyOnSuccess').<br />
<br />
<br />
'''affa --cleanup JOB'''<br />
Après que vous ayez diminué le temps de conservation (scheduledKeep), les archives avec un indice plus élevé ne seront plus supprimées automatiquement et existeront toujours. Cette option trouve ces archives et les supprime.<br />
<br />
<br />
'''affa --rename-job JOB NEWNAME'''<br />
Renomme la tâche JOB en NEWNAME, y compris tous les enregistrements de la base de données et les répertoires d'archive.<br />
<br />
<br />
'''affa --move-archive JOB NEWROOTDIR'''<br />
Déplace le répertoire d'archive de JOB vers NEWROOTDIR et ajuste la propriété RootDir. NEWROOTDIR doit être un chemin complet (full path) commençant par un slash. Comme le déplacement d'un système de fichiers à un autre (par exemple d'un disque USB à un disque local) n'est pas possible, Affa se sert dans ce cas d'une commande de copie et efface ensuite le répertoire source. Selon la taille de l'archive, la copie d'un système de fichiers à l'autre peut prendre longtemps.<br />
<br />
<br />
'''affa --delete-job [--revoke-key] JOB'''<br />
Efface irréversiblement une tâche, y compris toutes les archives, la configuration et les bases de données attachées. En passant l'option '--revoke-key', la clé publique sur le serveur distant sera détruite.<br />
<br />
<br />
'''affa --revoke-key JOB'''<br />
'''affa --revoke-key --host=TARGETHOST [--port=PORT] [--remoteOS=cygwin]'''<br />
Détruit la clé DSA publique sur le serveur distant.<br />
{{Note box|<nowiki>L'option --revoke-key seule fonctionne sur SME Server comme serveur distant et pour les systèmes où les clés sont stockées dans /root/.ssh/authorized_keys2 Avec remoteOS=cygwin cela fonctionne pour les serveurs distants sous Cygwin/Windows.</nowiki>}}<br />
<br />
<br />
'''affa --check-connections'''<br />
Contrôle le login ssh pour toutes les tâches configurées. Pour les tâches pour lesquelles la clé publique n'avait pas encore été envoyée, il vous sera demandé le mot de passe et la clé sera envoyée ensuite.<br />
<br />
<br />
'''affa --kill JOB'''<br />
Termine la tâche en cours JOB et tous les processus fils (les processus rsync)..<br />
<br />
'''affa --debug'''<br />
Active un journal verbeux. Remplace la tâche et les configurations globales.<br />
<br />
=== Exemples de configuration ===<br />
==== Serveur de sauvegarde dédié ====<br />
* Configurez une tâche pour chaque serveur que vous voulez sauvegarder<br />
* Envoyez les clés publiques à chaque serveur.<br />
affa --send-key JOBNAME<br />
* Envoie la clé DSA correspontante à la tâche JOBNAME.<br />
affa --check-connections<br />
* Vérifie que les connexions sans mot de passe fonctionnent.<br />
affa --show-schedule<br />
* Vérifie si les tâches planifiées sont réparties dans la journée.<br />
affa --make-cronjobs<br />
* Crée les tâches cron.<br />
affa --status<br />
* Vérifie l'état après 24 heures.<br />
<br />
<br />
==== Sauvegarder une ibay individuellement ====<br />
Supposons que nous voulions sauvegarder les ibays 'staff1' et 'staff2' de notre serveur de production dont l'adresse IP WAN est 82.123.1.1 sur un serveur Affa déporté via internet, toutes les nuits à 2h30.<br />
* On se connecte sur le serveur Affa et on installe les paquetages comme décrit ci-dessus.<br />
* On copie l'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/ibay-staff-job.pl<br />
* On édite /root/ibay-staff-job.pl pour y mettre :<br />
my $jobname='ibay-staff';<br />
et<br />
'remoteHostName‘=>'82.123.1.1',<br />
'TimeSchedule'=>'0230',<br />
'SMEServer'=>'no',<br />
'Include[0]'=>'/home/e-smith/files/ibays/staff1',<br />
'Include[1]'=>'/home/e-smith/files/ibays/staff2',<br />
* On enregistre la configuration<br />
/root/ibay-staff-job.pl<br />
* On envoie la clé publique au serveur de production<br />
affa --send-key ibay-staff<br />
* On vérifie le lendemain matin :<br />
affa --list-archives ibay-staff<br />
affa --status<br />
* Vérifie l'état après 24 heures.<br />
ls /var/affa/ibay-staff<br />
<br />
==== Deux serveurs de production qui se sauvegardent mutuellement ====<br />
Vous avez deux sites connectés via un VPN et un serveur SME fonctionnant sur chaque site. Dans ce cas, vous n'avez pas besoin d'un serveur de sauvegarde Affa dédié. Les deux serveurs de production peuvent en plus agir chacun comme un serveur Affa sauvegardant le serveur de l'autre site. Installez simplement Affa et configurez une tâche qui sauvegarde l'autre serveur. Vous pouvez utiliser toutes les fonctionnalités Affa excepté la fonctionnalité rise. <br />
En utilisant la fonctionnalité rise, le serveur devient n'importe lequel des systèmes sauvegardés, ce qui est moins utile dans ce scénario puisque cela vous donnerait une copie fonctionnelle du serveur de l'autre site lorsque celui-ci est en panne.<br />
<br />
Pour obtenir une redondance et une restauration plus rapide, vous pouvez configurer une sauvegarde locale sur un disque USB externe ou sur un NAS.<br />
<br />
Attention de ne pas sauvegarder à nouveau les archives de l'autre site. Configurez la propriété RootDir vers un chemin qui n'est pas inclu dans la liste de sauvegarde par défaut de SME. En laissant la propriété RootDir par défaut sur '/var/affa', cela est garanti.<br />
<br />
==== Sauvegarde d'un ordinateur Windows ====<br />
Sauvegarder les données d'un système Windows nécessite que le démon Rsyncd Cygwin soit installé et configuré sous Windows. La procédure "rsync over ssh" ne fonctionne pas, puisque le processus rsync Cigwin se plante systématiquement après le transfert de quelques fichiers. <br />
<br />
===== Configuration de Rsyncd sur l'ordinateur Windows ===== <br />
Installez la base Cygwin, le paquetage rsync puis configurez le service Rsyncd comme décrit dans ce document : [[Rsyncd setup on a windows computer for use with Affa backup]]'. <br />
L'installation du service sshd est optionnelle et n'est pas nécessaire pour la sauvegarde elle-même, mais avoir une connexion ssh peut être très utile pour l'administration et pour exécuter des scripts sur le système Windows. Affa supporte l'envoi de la clé publique vers un ordinateur Windows Cygwin pour une connexion sans mot de passe.<br />
<br />
Note: Affa ne sauvegarde pas l'information Windows Access Control List (ACL). Vous pourriez avoir à corriger les ACLs après une restauration.<br />
<br />
===== Configuration du mode Affa Rsyncd (exemple de démarrage rapide) =====<br />
Vous voulez sauvegarder les répertoires ''Mes Documents''des utilisateurs ''ssorglos'' et ''bsimpson'' depuis l'ordinateur Windows 'ws001' avec l'IP 192.168.1.65 sur votre serveur Affa 'affabox' avec l'IP 192.168.1.3.<br />
* connectez-vous sur 'affabox' et copiez le script exemple de configuration Cygwin<br />
cp /usr/lib/affa/jobconfig-cygwin-sample.pl /root/ws001-mydocs-job.pl<br />
* editez /root/ws001-mydocs-job.pl et mettez<br />
my $jobname='ws001-mydocs';<br />
et<br />
'remoteHostName‘=>'192.168.1.65',<br />
'rsyncdPassword'=>'<i>secretword</i>',<br />
'Include[0]'=>'/c/Documents and Settings/ssorglos/My Documents/', ''# N'utilisez pas les backslashes dans les chemins !''<br />
'Include[1]'=>'/c/Documents and Settings/bsimpson/My Documents/',<br />
où ''secretword'' doit être remplacé par le mot de passe que vous avez choisi dans rsyncd.secretsfile sur l'ordinateur Windows.<br />
* Enregistrez la configuration (cela crée les entrées de base de données et configure les tâches cron.<br />
/root/ws001-mydocs-job.pl<br />
* Lancez la tâche manuellement. Après l'achèvement, vérifiez l'archive /var/affa/ws001-mydocs/scheduled.0 et le journal /var/log/affa/ws001-mydocs.log.<br />
affa --run ws001-mydocs<br />
<br />
===== Configuration manuelle d'Affa en mode Rsyncd =====<br />
Au cas où vous voudriez configurer manuellement en utilisant les commandes db, voici les paramètres obligatoires pour le mode Rsyncd Cygwin.<br />
db affa setprop JOB rsyncdMode yes<br />
db affa setprop JOB rsyncdModule AFFA<br />
db affa setprop JOB rsyncdUser affa<br />
db affa setprop JOB rsyncdPassword ''secretword''<br />
db affa setprop JOB SMEServer no<br />
db affa setprop JOB RPMCheck no<br />
db affa setprop JOB Watchdog no<br />
Optionel pour une connexion ssh.<br />
db affa setprop JOB remoteOS cygwin <br />
<br />
<br />
==== Utiliser Affa pour sauvegarder un NAS monté par NFS ou un disque USB local ====<br />
<br />
On désire sauvegarder notre serveur SME 7 de production dont le nom d'hôte est 'prodbox' et l'IP 10.200.48.1 sur un système de fichiers monté plutôt que de configurer un serveur Affa dédié.<br />
<br />
===== Configuration du NAS =====<br />
On dispose d'un serveur FREENAS dont l'adresse IP est 10.200.48.2 en fonction et avec le service NFS activé. Le disque est monté sur /mnt/affashare. On a autorisé l'adresse IP de notre serveur de production à accéder au partage /mnt/affashare.<br />
* On se logge sur 'prodbox' et on installe les paquetages NFS :<br />
/usr/bin/yum install --enablerepo=smecontribs smeserver-nfs<br />
* maintenant, on active et on démarre le service portmapper.<br />
config setprop portmap status enabled<br />
service portmap start<br />
<br />
* On monte le partage NFS :<br />
mkdir -p /mnt/affadevice<br />
mount 10.200.48.2:/mnt/affashare /mnt/affadevice<br />
<br />
<br />
===== Alternative : configuration du disque USB =====<br />
* On se logge sur 'prodbox'<br />
* On connecte le disque USB sur le bus USB. On doit maintenant déterminer sur quel 'device' le noyau a placé le lecteur. On regarde /var/log/messages et on cherche la ligne d'initialisation correspondante (Initializing USB Mass Storage driver). Quelques lignes plus bas, on trouve le nom du device. Supposons qu'il s'agisse de 'sdh'. Si ce n'est pas le cas, on remplacera dans les instructions ci-après /dev/sdh par la valeur trouvée.<br />
* On crée une partition linux avec fdisk : '''Il faut bien vérifier que c'est bien le disque USB qui est attaché avant de continuer !'''<br />
<br />
fdisk /dev/sdh<br />
On trouvera probablement une partition dos vfat, qu'on devra d'abord détruire. Supposons que nous ayons créé une seule partition ''/dev/sdh1''.<br />
* On formatte avec un système ext3 :<br />
mkfs.ext3 /dev/sdh1<br />
* On crée le point de montage :<br />
mkdir -p /mnt/affadevice<br />
* On ajoute notre disque USB dans /etc/fstab. On crée donc une nouvelle ligne avec :<br />
/dev/sdh1 /mnt/affadevice ext3 defaults<br />
* On monte le disque :<br />
mount /mnt/affadevice<br />
* On fait une vérification croisée avec df :<br />
df<br />
<br />
<br />
===== Configuration d'Affa =====<br />
On veut lancer des sauvegardes à 11h30, 15h30, 19h30 et on veut garder les 3 dernières, 7 journalières, 5 hebdomadaires, 12 mensuelles et 1 annuelle.<br />
* On se logge sur 'prodbox' et on installe les paquetages Affa comme indiqué ci-dessus.<br />
* On copie l'exemple de configuration<br />
cp /usr/lib/affa/jobconfig-sample.pl /root/prodbox-job.pl<br />
* On édite /root/prodbox-job.pl pour y mettre :<br />
my $jobname='prodbox';<br />
et<br />
'remoteHostName‘=>'localhost',<br />
'TimeSchedule'=>'1130,1530,1930',<br />
'scheduledKeep'=>3,<br />
'dailyKeep'=>7,<br />
'weeklyKeep'=>5,<br />
'monthlyKeep'=>12,<br />
'yearlyKeep'=>1,<br />
'RootDir=>'/mnt/affadevice',<br />
On vérifie les autres propriétés et on les change si besoin.<br />
* On enregistre la configuration<br />
/root/prodbox-job.pl<br />
* On lance la tâche manuellement :<br />
<br />
affa --run prodbox<br />
<br />
<br />
===== Limitations =====<br />
Avec ce type de configuration, on ne peut pas utiliser la fonction 'rise' (conversion du serveur de sauvegarde en serveur de production), puisqu'elle nécessite que l'archive soit sur le même système de fichiers que le serveur. La fonction 'rise' utilise les hardlinks, qui ne fonctionnent pas entre systèmes de fichiers différents.<br />
<br />
===== Automount : montage automatique =====<br />
Avoir les archives de sauvegarde sur le même système de fichiers est toujours un risque, qui peut être minimisé en utilisant la fonction automount. Ainsi, le système de fichiers externe n'est monté que durant le déroulement d'une tâche.<br />
<br />
Dans l'exemple NAS, configurez :<br />
'AutomountDevice=>'10.200.48.2:/mnt/affashare',<br />
'AutomountPoint =>'mnt/affadevice',<br />
et sautez l'étape 2<br />
<br />
Dans l'exemple du disque USB, configurez :<br />
'AutomountDevice=>'/dev/sdc1',<br />
'AutomountPoint =>'mnt/affadevice',<br />
et sautez les étapes 5 à 8.<br />
<br />
Le point de montage sera automatiquement créé, s'il n'existe pas. <br><br />
Pour accéder au répertoire de l'archive, vous devez le monter à la main.<br />
<br />
=== Restauration ===<br />
==== Restauration de fichiers ou répertoires individuels ====<br />
'''Example 1:''' Nous sommes le Mardi 6 Janvier 2009 quand l'utilisateur 'briedlin' vous demande de restaurer les messages de sa boite 'orders' qu'il a malencontreusement détruite Lundi.<br />
<br />
* Vous devez d'abord regarder quelles sont les archives disponibles. Le nom de tâche de ce serveur de sauvegardes est 'primmail. Pour avoir une liste de toutes les archives, lancez <br />
affa --list-archives primmail<br />
''(voir la liste exemple dans le chapitre [[Affa#Usage_and_command_line_options]]''<br />
* Choisissez l'archive daily.0, qui a été créée la nuit de Lundi. Maintenant, restaurez la mailbox 'orders' en utilisant la commande rsync.<br />
* Maintenant, lancez la commande rsync (notez le slash en fin !) sur le serveur de sauvegarde Affa.<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
<br />
export RDIR=/home/e-smith/files/users/briedlin/Maildir/.orders/ ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av -e 'ssh -p 2222' /var/affa/primmail/daily.0/$RDIR 10.204.48.1:$RDIR<br />
<br />
<br />
<br />
'''Example 2:''' Un utilisateur a effacé le fichier orderform.pdf dans l'ibay 'docs' du serveur 10.204.48.1 et vous demande de le restaurer.<br />
<br />
* Vous avez cherché et trouvé la dernière version de ce fichier dans l'archive hebdomadaire de la tâche 'prodserv'.<br />
* Pour la recopier vers le serveur 10.204.48.1 lancez sur le serveur Affa<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
export RFILE=/home/e-smith/files/ibays/docs/files/orderform.pdf ''# cette variable est utilisée pour raccourcir la ligne de commande suivante''<br />
rsync -av -e 'ssh -p 2222' /var/affa/prodserv/weekly.1/$RFILE 10.204.48.1:$RFILE<br />
<br />
<br />
<br />
'''Example 3:''' Restaurer un fichier avec un caractère spécial dans le chemin<br />
<br />
N'utilisez pas les variables shell pour raccourcir la commande. Cela compliquerait les choses plus que cela aiderait.<br />
Mettez entre guillemets les chemins source et destination. Dans le chemin de destination, echappez les caractères blancs avec un double backslash et les parenthèses avec un simple backslash. Sur le serveur de sauvegardes AFFA lancez :<br />
rsync -av "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
Si les serveurs sont configurés pour utiliser un port ssh différent, ex. 2222, à la place faites :<br />
<br />
rsync -av -e 'ssh -p 2222' "/var/affa/fileshare/daily.4/home/e-smith/files/ibays/mechfiles/files/Valve Control (Design Gr)/VALVE LIST FOR ISSUED.xls" "192.168.1.7:/home/e-smith/files/ibays/mechfiles/files/Valve\\ Control\\ \(Design\\ Gr\)/VALVE\\ LIST\\ FOR\\ ISSUED.xls"<br />
<br />
==== Restauration complète ====<br />
Pour lancer une restauration complète des utilisateurs et des données de configuration, lancez sur le serveur Affa<br />
affa --full-restore <JOB> [<ARCHIVE>]<br />
Cela synchroniste (par rsync) les données de la sauvegarde ARCHIVE vers l'ordinateur 'remoteHostname' défini dans la configuration de la tâche JOB. <br />
<br />
Exemple:<br />
Vous avez sauvegardé votre serveur de production 'prodsrv' par une tâche 'prodbox'. Pour restaurer la dernière sauvegarde, lancez<br />
affa --full-restore prodbox<br />
<br />
Pour restaurer la plus ancienne archive daily.3, lancez <br />
affa --full-restore prodbox daily.3<br />
<br />
{{Warning box| Une restauration complète reconstruit le serveur tel qu'il était au moment de la sauvegarde. Cela signifie que tous les fichiers créés ou les changement de configuration due serveur effectués après la sauvegarde seront perdus. Après la restauration, le serveur restauré redémarre automatiquement. }}<br />
<br />
==== Migration d'un serveur SME7 vers un nouveau matériel en utilisant la fonctionnalité "Affa rise" ====<br />
Merci de consulter cet Howto: [[Moving SME to new Hardware]]<br />
<br />
<br />
==== Restauration d'un disque USB sur un nouveau serveur ====<br />
<br />
<br />
Cette astuce vient de http://forums.contribs.org/index.php?topic=42412.0<br />
<br />
Q) J'ai des sauvegardes complètes stockées sur un disque dur USB connecté sur notre serveur de sauvegarde Affa. J'ai besoin de restaurer une ancienne sauvegarde mensuelle de notre tâche "mailbackup" sur un serveur de tests à la place du système original. Si je le fais depuis le serveur de sauvegardes, je vois les instructions pour remonter ce serveur depuis la sauvegarde courante, mais je veux restaurer d'un état datant d'environ un mois, avant que d'étranges choses se soient passées. Et je veux le faire sur une machine qui n'est pas notre serveur de sauvegarde ni notre serveur de production. J'ai tenté d'imaginer comment faire, mais je suis perdu dans les options. Mon but est de faire quelques tests.<br />
<br />
R) Sur votre serveur de tests, configurez une tâche "mailbackup" identique à celle de votre serveur de sauvegardes, mais paramétrez correctement RootDir en /var/affa et mettez la propriété "status" sur "disabled" Connectez le lecteur USB et copiez l'archive de la tâche "mailbackup" dans /var/affa. Ensuite, lancez affa --rise mailbackup ARCHIVE<br />
<br />
Rappelez-vous qu'Affa place les scripts de configuration de tâches dans les répertoires d'archive. Dans votre cas, c'est mailbackup-setup.pl. Copiez-le sur votre serveur de tests, changez les propriétés RootDir et status, puis exécutez-le.<br />
<br />
=== FAQ ===<br />
'''Quels fichiers et répertoires sont inclus par défaut ?'''<br />
<br />
Avec SMEServer=no aucun.<br />
<br />
Avec SMEServer=yes la liste par défaut des sauvegardes SME. TLa commande suivante affiche la liste :<br />
perl -e 'use esmith::Backup;$b=new esmith::Backup;print join("\n",$b->restore_list)."\n"' <br />
<br />
<br />
'''Puis-je sauvegarder exclusivement des fichiers d'images contenus dans un répertoire spécifique ?'''<br />
<br />
Oui. Supposant que vous voulez sauvegarder tous les fichiers gif et jpg du répertoire /home/e-smith/files/ibays/pictures/files utilisez cette configuration<br />
db affa setprop JOBNAME SMEServer no # Ne pas inclure les répertoires et fichiers par défaut de SME Server<br />
db affa setprop JOBNAME Include[0] '/home/e-smith/files/ibays/pictures/files' # Commencer à chercher ici<br />
db affa setprop JOBNAME Include[1] '*/' # Chercher récursivement dans l'arborescence<br />
db affa setprop JOBNAME Include[2] '*.gif' # Copier les fichiers qui correspondent à ce profil<br />
db affa setprop JOBNAME Include[3] '*.jpg' <br />
db affa setprop JOBNAME Exclude[0] '*' # Exclure tous les autres<br />
db affa setprop JOBNAME rsyncOptions '-m' # Ne pas créer les répertoires vides<br />
<br />
<br />
'''Comment puis-je déplacer une archive de sauvegarde de mon serveur de production dans une agence distante vers le serveur Affa en utilisant un disque USB ? Je veux éviter de télécharger la première sauvegarde complète depuis internet.<br />
Installez Affa sur votre serveur de production, connectez et montez le disque USB.''' Configurez une tâche pour enregistrer la sauvegarde sur le disque USB. Une fois la tâche exécutée, connectez le disque USB à votre serveur Affa et configurez la tâche de la même manière. Utilisez le script de configuration du répertoire d'archive. Vous n'avez à mofier que la propriété "remoteHostName". Maintenant, utilisez l'option --move-archive pour transférer l'archive sur le disque local. Si ce n'est pas déjà fait, envoyez la clé publique à votre serveur de production. C'est fait.<br />
<br />
<br />
'''Comment je sauvegarde deux serveurs SME derrière un pare-feu ?'''<br />
D'abord, vous devez configurer les port forwardings pour le service ssh sur votre pare-feu. Utilisez un port non standard, par ex. 2200->22, pour votre second serveur. Configurez une tâche sur votre serveur de sauvegarde Affa pour chacun de vos serveurs de production. Configurez la propriété sshPort=2200 pour votre second serveur.<br />
<br />
=== Désinstallation ===<br />
Cela supprime le paquetage Affa installé, toutes les données de configuration et toutes les archives de sauvegarde.<br />
<br />
Lancez les commandes suivantes pour chaque tâche :<br />
affa --revoke-key JOBNAME<br />
affa --delete-job JOBNAME<br />
Verifie que toutes les tâches ont été supprimées.<br />
affa --status<br />
Suprime le paquetage Affa<br />
rpm -e smeserver-affa<br />
et, si ces paquetages ne sont pas des dépendances d'autres paquetages :<br />
Nettoyage général<br />
rm -f /etc/cron.d/affa /etc/cron.d/affa-status<br />
rm -rf /home/e-smith/db/affa /home/e-smith/db/affa-report<br />
rm -rf /var/affa /var/log/affa<br />
<br />
=== Rapport de bugs ===<br />
Affa est répertorié dans [http://bugs.contribs.org/enter_bug.cgi?product=SME%20Contribs&component=smeserver-affa bugtracker contribs section].<br />
SVP, rapportez là tous les bugs, demandes de nouvelles fonctionnalités et problèmes de documentation. <br />
<br />
=== Informations complémentaires ===<br />
Pour les détails de performance, la liste des modifications etc. voyez [[:Affa:Additional information]]<br />
<br />
=== Références ===<br />
* Article Wikipedia http://en.wikipedia.org/wiki/Rsync<br />
* Site Rsync http://rsync.samba.org/<br />
* Article Wiki [[Moving SME to new Hardware]]<br />
* Article Wiki [[Backup with Affa and FreeDup]]<br />
* Article Wiki [[Rsyncd setup on a windows computer for use with Affa backup]]<br />
* Article Wiki [[Backup Windows Computers Using Affa]]<br />
* Article Wiki [[Backup of ESXi Virtual Machines using Affa]]<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Backup]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/fr&diff=12689Egroupware/fr2009-04-03T05:56:33Z<p>Cool34000: /* Synchronisation de MS Outlook */</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupware 1.4.004 pour SME 7.x=<br />
<br />
==Mainteneurs==<br />
[[User:Berdie/fr|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
eGroupWare est un logiciel Collaboratif professionel et gratuit. Il vous permet de gérer vos contacts, vos rendez-vous, vos taches, et bien plus pour toute votre activité.<br />
eGroupWare est un serveur Collaboratif (groupware). Il est conçu nativement avec une interface Web qui vous permet d'accéder à vos données de n'importe quel plate-forme sur la planète.<br />
Vous avez le choix d'accéder au serveur eGroupWare avec votre client groupware préféré (Kontact, Evolution, Outlook) ainsi qu'avec votre téléphone portable ou votre PDA, par SyncML.<br />
<br />
eGroupWare est international. A ce jour, il supporte plus de [http://www.egroupware.org/languages 25 languages] incluant le support rtl.<br />
<br />
Pour plus d'informations, visitez ''http://www.egroupware.org/''.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.004-1.noarch.rpm<br />
yum localinstall smeserver-egroupware-1.4.004-1.noarch.rpm<br />
<br />
==Mise à jour==<br />
{{Warning box|'''A cause d'un bug dans les vieilles versions du RPM'''*''', VOUS DEVEZ DESINSTALLER LE VIEUX RPM AVANT LA MISE A JOUR AVEC LA COMMANDE SUIVANTE:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Ceci empêchera que les fichiers d'installation et la base de données MySQL soient supprimés.'''<br />
<br />
<nowiki>*</nowiki>'' Versions affectées: smeserver-egroupware-1.4-10 et antérieures''}}<br />
<br />
Vous pouvez alors mettre à jour votre version 1.4 existante avec la commande suivante:<br />
rpm -Uvh smeserver-egroupware-1.4.004-1.noarch.rpm<br />
Si vous mettez à jour la version d'eGroupWare (par exemple v1.4.001 vers v1.4.002) vous devez terminer la mise à jour dans Config-Admin Setup avec vos identifiants existants. Cliquez sur mettre à jour...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Revérifiez l'installation<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Si tout s'est bien passé, la mise à jour de version est effectuée !<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Une sauvegarde est effectuée par le RPM avant la mise à jour. Tous les fichiers et la base de données MySQL DataBase sont sauvegardés dans /opt/eGW_RPM_BACKUP<br />
'''Vous devez déplacer cette sauvegarde dans un endroit plus sur.'''<br />
<br />
Cette étape automatique est juste une sécurité, '''effectuez vos propres sauvegardes avant de mettre à jour.'''<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-egroupware<br />
Dans la nouvelle release (1.4.002-x), si vous souhaitez supprimer définitivement eGroupWare de votre serveur, vous devez taper la commande suivante:<br />
sh /root/eGW_Full_Uninstall.sh<br />
Ceci supprimera les fichiers d'installation d'eGroupWare, la base de données MySQL et les entrées dans la base de données de SME.<br />
<br />
==Démarrer avec eGroupWare==<br />
Veuillez effectuer la configuration initiale '''AVANT''' de vous connecter à eGroupware.<br />
Après cette étape, les utilisateurs SME pourront se connecter avec leurs login + mot de passe SME.<br />
A la 1ere connexion d'un utilisateur SME valide, le compte est automatiquement créé dans eGroupware.<br />
<br />
===Configuration initiale===<br />
Vous trouverez les fichiers d'installation de la dossier ''/opt/egroupware''. Pour terminer la configuration d'eGroupware, ouvrez votre navigateur à l'adresse ''https://votredomaine.com/egroupware/setup'' et connectez vous avec l'utilisateur ''config-admin'' + mot de passe ''admin'' dans Setup/Config Admin.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Vous devez maintenant créer le compte d'administration d'eGroupware. Utilisez un compte existant de SME (même utilisateur et même mot de passe), par exemple l'admin (déconseillé pour des raisons de sécurité) pour pouvoir envoyer et recevoir les mails administratifs dans eGroupware.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Déconnectez vous après avoir créé le compte d'administration.<br />
<br />
===Changement des mots de passe de config-admin / header-admin===<br />
Ouvrez votre navigateur et connectez vous avec l'utilisateur ''header-admin'' et le mot de passe ''admin'' à Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Changez les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' maintenant :<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Enregistrez vos changements en cliquant sur "Ecrire".<br />
<br />
{{Warning box|Pour des raisons de sécurité, veuillez changer les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' dès votre 1ère connexion !}}<br />
<br />
===Paramétrage de l'accessibilité===<br />
Le comportement par défaut d'eGroupware est : accessible depuis le LAN + Internet avec https "forcée" (SSL + rewrite rule).<br />
<br />
Vous pouvez facilement modifier ce comportement par défaut avec les commandes suivantes :<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Une fois les changements effectués, appliquez les modifications et redémarrez Apache :<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronisation===<br />
<br />
eGroupware fournit '''la synchronisation du calendrier, des tâches, des notes et du carnet d'adresse''' pour des clients comme MS Outlook et les PDA. Malheureusement, il faut php5 pour que cela fonctionne et cela n'est pas implémenté sur SME 7.x. En fait, il est possible de synchroniser Outlook avec le protocole ''xmlrpc'' et le logiciel ''eGWOSync''.<br />
<br />
====Synchronisation de MS Outlook====<br />
<br />
Vous pouvez synchroniser les données d'eGroupware avec Outlook en suivant ces étapes:<br />
<br />
'''1. Installez le certificat dans MS Internet Explorer'''<br />
<br />
*Démarrez Internet Explorer<br />
*Allez à l'adresse https://votredomaine.com<br />
*Cliquez sur "Afficher les certificats"<br />
*Cliquez sur "Installer le certificat" et terminez l'assitant d'installation du certificat<br />
{{Note box|Sous Vista, vous devez ajouter votre domaine à la liste des sites approuvés pour être capable d'accéder à l'installation du certificat.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Fermez MS Outlook s'il est ouvert.<br />
*Dans le panneau de configuration, allez dans les options de messagerie.<br />
*Afficher les profils... -> supprimer tous les profils<br />
*Redémarrez MS Outlook, créez un nouveau profile avec votre compte mail<br />
<br />
'''3. eGWOSync'''<br />
<br />
Téléchargez [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] et [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], si nécessaire.<br />
<br />
*Vous avez besoin de .NET Version 1.x, si vous avez déja une version supérieure, vous devrez également installer .NET 1.x<br />
*User/Password = compte utilisateur/mots de passe SME<br />
*Domain = default<br />
*Hostname = domaine SME<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = laisser par défaut<br />
*Faire le test<br />
<br />
'''4. Funambol'''<br />
<br />
Page de téléchargement de [http://www.funambol.com/opensource Funambol]<br />
<br />
Lien direct vers [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14]<br />
<br />
1) Ouvrez Outlook et allez dans le paramétrage de Funambol (Funambol --> Option)<br />
4) Selectionnez tous les items<br />
5) Baissez le niveau de log dans '''''/opt/egroupware/phpgwapi/inc/horde/config/conf.php''''' (changer $conf['log']['priority'] = '''PEAR_LOG_DEBUG''' en $conf['log']['priority'] = '''PEAR_LOG_INFO''')<br />
6) Options de paramétrage:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>https://votredomaine.com/egroupware/rpc.php</nowiki> ou <nowiki>https://IP Serveur/egroupware/rpc.php</nowiki><br />
Username = Votre utilisateur eGroupWare<br />
Password = Votre mot de passe eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 Septembre 2007 (MDT)<br />
<br />
==Addon Gallery2==<br />
Gallery2 est le 1er addon disponible pour eGroupWare 1.4.002<br />
<br />
Il a été intégré dans smeserver-egroupware-1.4.002-3.noarch.rpm (mais non installé par défaut)<br />
<br />
===Description===<br />
Gallery est une application web open source d'organisation d'albums photos. Gallery vous donne une façon intuitive d'intégrer la gestion de photos uniformement dans votre site web, que vous ayez un petit site personel ou une plus large communauté.<br />
<br />
Pour plus d'informations, visitez ''http://gallery.menalto.com/''.<br />
<br />
===Installation de Gallery2===<br />
Pour commencer, connectez vous au Config setup avec votre utilisateur config-admin et son mot de passe et cliquez sur ''Gérer les applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Cochez simplement la case d'installation de Gallery et sauvegardez.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Configuration de Gallery2===<br />
Une fois installé, vous devez paramétrer votre site web et créer la base de données. Cette étape a été préparée par le RPM d'installation.<br />
<br />
Ouvrez votre navigateur à l'adresse ''https://yourdomain.com/egroupware/gallery/gallery2/install'' et suivez les instructions.<br />
<br />
Dans la 4ème étape, le chemin vers le dossier de stockage est demandé. L'installation du RPM a préparé ''/opt/egroupware/files/g2data'', veuillez ne pas changer le chemin et les permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
Dans la 5ème étape, les informations MySQL sont demandées. L'installation du RPM a préparé ''egwuser'' ''egroupware'' et votre ''DbPassword'' automatiquement. Cliquez simplement sur sauvegarder et finissez l'installation.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Icone Gallery2===<br />
Une fois la configuration terminée, vous pouvez ajouter l'icone dans l'interface d'eGroupWare.<br />
Connectez vous à eGroupWare avec un compte admin et éditez un utilisateur ou un groupe pour lui ajouter l'application Gallery.<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|Gallery peut être accédé sans authentification à l'adresse ''https://votredomaine.com/egroupware/gallery/gallery2''}}<br />
<br />
==Informations supplémentaire==<br />
<br />
*[http://www.egroupware.org Site web d'eGroupWare]<br />
*[http://gallery.menalto.com/ Site web de Gallery]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 topic sur le forum de contribs.org]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 topic sur le forum de contribs.org]<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Groupware/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware&diff=12688Egroupware2009-04-03T05:51:55Z<p>Cool34000: /* MS Outlook Synchronization */ log level for funambol (avoid the 10GB daily log) thanks to Simon van Sleuwen</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupWare 1.4.004 for SME 7.x and above=<br />
<br />
==Maintainers==<br />
[[User:Berdie/de|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
[[User:Snoopyski|Stéphane Gauvin]]<br/><br />
mailto:sgauvin@serviceinfosg.com<br />
<br />
==Description==<br />
eGroupWare is a [http://www.egroupware.org/philosophy free] enterprise ready groupware software for your network. It enables you to manage contacts, appointments, todos and many more for your whole business.<br />
<br />
eGroupWare is a groupware server. It comes with a native web-interface which provides the ability to access your data from any platform with a web browser, both inside and outside the local network. Moreover you also have the choice to access the eGroupWare server with your favorite groupware client (Kontact, Evolution, Outlook) and also with your mobile or PDA via SyncML.<br />
<br />
eGroupWare is international. At this time, it supports more than [http://www.egroupware.org/languages 25 languages] including rtl support.<br />
<br />
For more information see ''http://www.egroupware.org/''.<br />
<br />
With this RPM you can use eGroupWare on your SME 7.x (and above). You can install it as one single package in a very comfortable way.<br />
<br />
==Installation==<br />
For installation run the following commands:<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.004-1.noarch.rpm<br />
yum localinstall smeserver-egroupware-1.4.004-1.noarch.rpm<br />
The rpm is about 26Mbytes in size, so may take some minutes to download.<br />
<br />
==Update/Upgrade==<br />
'''Please note that this RPM cannot upgrade eGroupWare 1.2.x'''<br />
{{Warning box|'''Because of a bug in old RPM versions'''*''', YOU MUST UNINSTALL THE OLD RPM BEFORE UPDATING WITH THE FOLLOWING COMMAND:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''This will prevent installation files and MySQL to be deleted.'''<br />
<br />
<nowiki>*</nowiki>'' Affected versions are smeserver-egroupware-1.4-10 and older''}}<br />
<br />
Then, you can update your existing 1.4 installation with<br />
rpm -Uvh smeserver-egroupware-1.4.004-1.noarch.rpm<br />
If you were upgrading eGroupWare version (i.e.1.4.001 to 1.4.002) you must finish the upgrade at the Config-Admin Setup with your existing credentials. Then click on upgrade...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Then re-check your install<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
If all went ok, upgrade is done!<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
A backup is done by the RPM before updating. All Files and MySQL DataBase are saved in /opt/eGW_RPM_BACKUP<br />
'''You must move the backup to a safe directory.'''<br />
<br />
This automatic step is just for safety, '''make your own backup before updating/upgrading.'''<br />
<br />
==Uninstallation==<br />
To uninstall use the following command:<br />
yum remove smeserver-egroupware<br />
In the new release (1.4.002-x), if you want to completely remove eGroupWare from your server, you need the following command:<br />
sh /root/eGW-Full-Uninstall.sh<br />
This will delete eGroupWare's installation files, MySQL database and SME database entries.<br />
<br />
==Starting with eGroupWare==<br />
Please perform the Intial Configuration '''FIRST''' before login to eGroupWare.<br />
After that SME users can login to eGroupWare with their used SME account + password. At first login, eGroupWare creates user accounts and passwords automatically and synchronize them to the SME Server.<br />
<br />
===Inital Configuration===<br />
You can find eGroupWare in the ''/opt/egroupware'' directory. For using eGroupWare start your browser with the URL ''http://servername/egroupware/setup'' and logon with the user ''config-admin'' + password ''admin'' at Setup/Config Admin Login.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Now you should create eGroupWare's admin-account. Because eGroupWare uses mail authentication, the admin-account must be a valid SME account/password. This account will be able to use and administer eGroupWare.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Logout after creating the admin account.<br />
<br />
===Changing passwords for eGW config-admin / header-admin===<br />
Go to your browser and logon with the user ''header-admin'' + password ''admin'' at Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Change the passwords for the users ''config-admin'' and ''header-admin''now:<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Store the new passwords with "Write". <br />
<br />
{{Warning box|For security-reasons, change the passwords for the users ''config-admin'' and ''header-admin'' after your first login !}}<br />
<br />
===Adjusting accessibility===<br />
The default behaviour of eGroupWare is: accessible from LAN + Internet with "forced https" (with SSL on and a rewrite rule to force a redirection to the SSL page)<br />
You can easily change those defaults settings with following commands:<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Once done, apply modifications and restart Apache:<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronization===<br />
eGroupWare provides '''Synchronization of calender, todo's, notes and addressbook''' with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the ''xmlrpc'' protocol and the ''eGWOSync'' application.<br />
<br />
====MS Outlook Synchronization====<br />
You can sync eGroupWare-Data to MS Outlook as follows:<br />
<br />
'''1. Install certificate with MS Internet Explorer'''<br />
<br />
*Start Internet Explorer<br />
*Enter URL = https://servername<br />
*Enter "show certificate"<br />
*Enter "install certificate" and go on to install your SME certificate<br />
{{Note box|Under Vista, you have to put your domain in the approved website list before being able to install the certificate.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Close your MS Outlook if active.<br />
*Go to system control, register mail.<br />
*show profiles... -> delete all profiles<br />
*Start MS Outlook, create a new profile with your mail account<br />
<br />
'''3. eGWOSync'''<br />
<br />
Download [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] and [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], if necessary. If your .NET release is newer than version 1.x, you must install both versions on your system.<br />
<br />
*You need .NET Version 1.x, eGWOSync accepts no newer versions<br />
*User/Password = SME user account/password<br />
*Domain = default<br />
*Hostname = SME domain<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = keep default values<br />
*Perform test<br />
<br />
'''4. Funambol'''<br />
<br />
Download Web site: [http://www.funambol.com/opensource Funambol Web Site]<br />
Download Funambol 6.5.7 link [http://download.forge.objectweb.org/sync4j/funambol-outlook-plugin-6.5.7.exe]<br />
<br />
1) Install the last Funambol Plugin<br />
2) Change "7" to "0" for mbstring.func_overload = 0 in php.ini <br />
3) Open Outlook go to the Funambol Setup (Funambol --> Option)<br />
4) Select all items<br />
5) lower the log level in '''''/opt/egroupware/phpgwapi/inc/horde/config/conf.php''''' (change $conf['log']['priority'] = '''PEAR_LOG_DEBUG''' to $conf['log']['priority'] = '''PEAR_LOG_INFO''')<br />
6) Setup options:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>http://Domain Name/egroupware/rpc.php</nowiki> or <nowiki>http://Server IP/egroupware/rpc.php</nowiki><br />
Username = Your user login name for eGroupWare<br />
Password = Your user password for eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcalendar<br />
Data Format = SIF<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
'''NOTES:'''<br />
<br />
To get success with synchronisation put thoses settings in .htaccess file in the root folder of egroupware (/opt/egroupware/html/.htaccess):<br />
<br />
Run this on PuTTY (NOTE: this does not appear to work SME7.3, leaving the i-bay with an AllowOverride setting of 'none'):<br />
<br />
#db accounts setprop egroupware AllowOverride All<br />
#signal-event ibay-modify egroupware<br />
<br />
'''.htaccess file settings:'''<br />
<br />
*AddType text/xml .xml<br />
*php_value memory_limit 32M<br />
*php_value max_execution_time 60<br />
*php_flag register_globals Off<br />
*php_flag magic_quotes_gpc Off<br />
*php_flag magic_quotes_runtime Off<br />
*php_value upload_max_filesize 16M<br />
*php_flag session.use_trans_sid Off<br />
*php_value session.gc_probability 1<br />
*php_value session.gc_divisor 10<br />
*php_value mbstring.func_overload 7<br />
* <Files rpc.php><br />
* php_value mbstring.func_overload 0<br />
* Order allow,deny<br />
* Allow from all<br />
* </Files><br />
---<br />
--[[User:Snoopyski|Stéphane Gauvin -- Service Informatique SG]] 09:29, 1 March 2008 (MST)<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 September 2007 (MDT)<br />
<br />
====syncml configuration====<br />
<br />
From http://forums.contribs.org/index.php?topic=40242.new;topicseen#new<br />
<br />
Here are the steps to configure syncml with egroupware:<br />
<br />
1. Install php5-cgi as explained in this howto http://sme.firewall-services.com/spip.php?article46 <br />
<br />
(Stop after Step 3, Step 4 is just an example)<br />
<br />
<br />
2. Create a custom-template so that rpc.php is handled by php5:<br />
<br />
vim /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/90egw-syncml<br />
<br />
and enter the following:<br />
<br />
<Location /egroupware/rpc.php><br />
AddHandler php5-cgi .php<br />
Action php5-cgi /php5-cgi/php<br />
</Location><br />
<br />
<br />
3. Edit /etc/php5/php.ini (this file has no templates so you can edit it directly)<br />
<br />
On Line 304<br />
<br />
memory_limit = 8M<br />
<br />
change it to a bigger value, for example<br />
<br />
memory_limit = 32M<br />
<br />
On Line 1191 uncomment the line:<br />
<br />
mbstring.func_overload = 0<br />
<br />
(This may not be useful as php5-cgi has been compiled without mbstring support).<br />
<br />
There is no need for a htaccess file (htaccess could configure php4 because <br />
it's an apache module but not php5-cgi).<br />
<br />
expand-template /etc/httpd/conf/httpd.conf <br />
sv t /service/httpd-e-smith<br />
sv s /service/httpd-e-smith<br />
<br />
To check syntax is OK do:<br />
httpd -t<br />
<br />
syncml has been tested with the Funambol plugin for Outlook (several versions) & works OK.<br />
<br />
==Gallery2 addon==<br />
Gallery2 is the first addon available for eGroupWare 1.4.002<br />
<br />
It has been integrated in smeserver-egroupware-1.4.002-3.noarch.rpm (but not installed by default)<br />
<br />
===Description===<br />
Gallery is an open source web based photo album organizer. Gallery gives you an intuitive way to blend photo management seamlessly into your own website whether you're running a small personal site or a large community site.<br />
<br />
For more information see ''http://gallery.menalto.com/''.<br />
<br />
===Gallery2 install===<br />
First, login at Config setup with your existing creditentials and clic on ''Manage Applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Then simply click on Gallery install checkbox and save your changes.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Gallery2 setup===<br />
Once Installed, you need to configure your website and create the database. This step has been prepared by the RPM install.<br />
<br />
Open your web browser at ''https://yourdomain.com/egroupware/gallery/gallery2/install'' and follow instructions.<br />
<br />
In the 4th step, you will be asked for a storage folder. RPM install has prepared ''/opt/egroupware/files/g2data'', please don't change neither path nor permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
In the 5th step, you will be asked for MySQL informations. RPM install has prepared ''egwuser'' ''egroupware'' and your DbPassword automatically. Just save and finish the install.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Gallery2 icon===<br />
Once the setup is done you can add the icon in eGroupWare's interface.<br />
Login to eGroupWare with an admin account, and edit a user or a group and add gallery<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|The gallery can also be accessed with no authentication at ''https://yourdomain.com/egroupware/gallery/gallery2''}}<br />
<br />
==Additional information==<br />
<br />
*[http://www.egroupware.org eGroupWare Homepage]<br />
*[http://gallery.menalto.com/ Gallery Homepage]<br />
*[http://www.egroupware.org/wiki eGroupWare Documentation]<br />
*[http://www.egroupware.org/index.php?page_name=wiki&wikipage=ManualSetupUpdate Howto Update eGroupWare]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Groupware]]<br />
[[Category: Webapps]]</div>Cool34000https://wiki.koozali.org/index.php?title=User:Cool34000&diff=10387User:Cool340002008-08-12T18:56:07Z<p>Cool34000: </p>
<hr />
<div>{{Languages}}<br />
[[Image:No_MA%27AM.jpg|180px|]]<br />
<br />
I'm a Microsoft certified administrator from south France.<br />
<br />
I've been using SME since 2006. I just love this distro, this is the easiest, the fastest and the safest way to install a Linux server!<br />
<br />
I've created/translated a few pages on this wiki. I've also created a few RPMs (mostly webapps) for SME 7.x that you can manually download at [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/ my contribs space] (a few RPMs are now in "smeconbtribs")<br />
<br />
<br />
List of contribs/Howtos:<br />
*[http://wiki.contribs.org/Apache_Tomcat Apache Tomcat]<br />
*[http://wiki.contribs.org/Egroupware eGroupWare]<br />
*[http://wiki.contribs.org/KPlaylist kPlaylist]<br />
*[http://wiki.contribs.org/Linux_Logo Linux_Logo]<br />
*[http://wiki.contribs.org/OCS_Inventory_Tools OCS Inventory and GLPI]<br />
*[http://wiki.contribs.org/OsCommerce osCommerce]<br />
*[http://wiki.contribs.org/Popfile popfile]<br />
*[http://wiki.contribs.org/SMF SMF]<br />
*[http://wiki.contribs.org/TeamSpeak_Server Teamspeak Server]<br />
<br />
<br />
''[mailto:sylvaingomez@free.fr Sylvain Gomez]''</div>Cool34000https://wiki.koozali.org/index.php?title=Linux_Logo/fr&diff=10385Linux Logo/fr2008-08-11T19:05:32Z<p>Cool34000: /* Avant de commencer */</p>
<hr />
<div>{{Languages|Linux Logo}}<br />
<br />
= Linux_Logo pour SME 7.x =<br />
Linux Logo affiche un logo avec quelques informations système.<br />
<br />
Les OS supportés sont Linux (la plupart des architectures) et quelques OS non-Linux.<br />
<br />
Visitez la [http://www.deater.net/weave page web de l'auteur] et [http://deater.net/weave/vmwprod/linux_logo/ son article sur Linux Logo] pour plus de détails.<br />
<br />
[[Image:linux_logo SME.png]]<br />
== Avant de commencer ==<br />
Il vous faut en 1er ajouter '''''dag''''' à la liste des dépots ("repositories")<br />
<br />
Un howto existe [http://wiki.contribs.org/Dag ici]<br />
<br />
== Installation du RPM linux_logo ==<br />
Installez linux_logo avec la commande suivante :<br />
yum install linux_logo --enablerepo=dag<br />
<br />
== Ajout du logo SME ==<br />
Vous pouvez télécharger le fichier (logo) avec la commande suivante :<br />
cd /root<br />
wget "http://mirror.contribs.org/contribs/sgomez/contribs/linux_logo/sme.logo"<br />
Il y a plusieurs façons et options pour lancer linux_logo... Voila un exemple.<br />
<br />
Editez le fichier /root/.bash_profile et ajouter ce qui suit à la fin du fichier :<br />
# Launch linux_logo<br />
linux_logo -u -D /root/sme.logo<br />
Pour plus d'informations, consultez le manuel avec la commande suivante :<br />
man linux_logo<br />
<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br />
----<br />
[[Category: Administration/fr]]<br />
[[Category: Howto/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Sysmon/fr&diff=10384Sysmon/fr2008-08-11T19:00:50Z<p>Cool34000: fixed lang in categories</p>
<hr />
<div>{{Languages|Sysmon}}<br />
=== Maintainer ===<br />
[[User:MasterSleepy|Michel Van hees]]<br />
<br />
=== Description ===<br />
<br />
* System Monitor construit des graphiques concernant la santé du serveur SME.<br />
* Il ajoute un panneau dans le server-manager.<br />
<br />
=== Installation ===<br />
<br />
RRDtool 1.0.x et perl-rrdtool sont indispensable:<br />
wget <nowiki>"http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=getit&lid=317"</nowiki><br />
wget <nowiki>"ftp://fr2.rpmfind.net/linux/dag/redhat/el4/en/i386/dag/RPMS/perl-rrdtool-1.0.50-3.el4.rf.i386.rpm"</nowiki><br />
wget <nowiki>"http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=getit&lid=300"</nowiki><br />
Sysstat est également requit mais sera installé depuis les repository avec yum.<br />
<br />
yum localinstall rrdtool-1.0.50-3.el4.rf.i386.rpm perl-rrdtool-1.0.50-3.el4.rf.i386.rpm smeserver-system_monitor-1.0-1.noarch.rpm<br />
<br />
=== Mise à jour ===<br />
<br />
Les bases RRD créées sont automatiquements déplacer dans un répertoire de backup /var/lib/rrdsm/backup/<br />
Si vous mettez à jour depuis une version au moins 5, vous pouvez réutiliser ces fichiers.<br />
service systemmonitor stop<br />
rm /var/lib/rrdsm/*.rrd<br />
mv /var/lib/rrdsm/backup/*.rrd /var/lib/rrdsm/<br />
service systemmonitor start<br />
<br />
=== Désinstallation ===<br />
yum remove smeserver-system_monitor<br />
<br />
Supprimer les bases rrd manuellement dans le répertoire /var/lib/rrdsm/.<br />
<br />
== Utilisation ==<br />
<br />
Vous pouvez accéder à l'interface System Monitor dans le server-manager.<br />
<br />
=== Problèmes connus ===<br />
<br />
Lors de la mise à jour, le paramétrage du service peut disparaitre<br />
Vérifier leur existance avec la commande<br />
db configuration show systemmonitor<br />
Si rien ne s'affiche, saississez les commandes suivantes:<br />
db configuration set systemmonitor service status enabled debug release<br />
service systemmonitor stop<br />
service systemmonitor start<br />
<br />
Depuis la version 6, un mode debug a été mis en place afin de permettre le debuguage a distance.<br />
Pour l'activer, saississez la commande suivante :<br />
db configuration setprop sysmon debug debug<br />
Attendez 5 minutes et aller voir dans le fichier /var/log/systemmonitor<br />
Envoyer moi un extrait, voir tout, mon adresse se trouve dans les spécifications du RPM.<br />
<br />
=== Additional information ===<br />
<br />
*[http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=viewsdownload&sid=61&orderby=dateD MasterSleepy Web site]<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Administration/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=SystemMonitor/fr&diff=10383SystemMonitor/fr2008-08-11T19:00:44Z<p>Cool34000: fixed lang in categories</p>
<hr />
<div>{{Languages|SystemMonitor}}<br />
== System Monitor pour SME Server ==<br />
<br />
=== Maintainer ===<br />
[[User:MasterSleepy|Michel Van hees]]<br />
<br />
=== Description ===<br />
<br />
* System Monitor construit des graphiques concernant la santé du serveur SME.<br />
* Il ajoute un panneau dans le server-manager.<br />
<br />
=== Installation ===<br />
<br />
RRDtool et perl-rrdtool sont indispensable:<br />
yum install rrdtool perl-rrdtool --enablerepo=smecontribs<br />
wget <nowiki>"http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=getit&lid=300"</nowiki><br />
Sysstat est également requit mais sera installé depuis les repository avec yum.<br />
<br />
yum localinstall smeserver-system_monitor-1.0-1.noarch.rpm<br />
<br />
=== Mise à jour ===<br />
<br />
Les bases RRD créées sont automatiquements déplacer dans un répertoire de backup /var/lib/rrdsm/backup/<br />
Si vous mettez à jour depuis une version au moins 5, vous pouvez réutiliser ces fichiers.<br />
service systemmonitor stop<br />
rm /var/lib/rrdsm/*.rrd<br />
mv /var/lib/rrdsm/backup/*.rrd /var/lib/rrdsm/<br />
service systemmonitor start<br />
<br />
=== Désinstallation ===<br />
yum remove smeserver-system_monitor<br />
<br />
Supprimer les bases rrd manuellement dans le répertoire /var/lib/rrdsm/.<br />
<br />
== Utilisation ==<br />
<br />
Vous pouvez accéder à l'interface System Monitor dans le server-manager.<br />
<br />
=== Problèmes connus ===<br />
<br />
Lors de la mise à jour, le paramétrage du service peut disparaitre<br />
Vérifier leur existance avec la commande<br />
db configuration show systemmonitor<br />
Si rien ne s'affiche, saississez les commandes suivantes:<br />
db configuration set systemmonitor service status enabled debug release<br />
service systemmonitor stop<br />
service systemmonitor start<br />
<br />
Depuis la version 6, un mode debug a été mis en place afin de permettre le debuguage a distance.<br />
Pour l'activer, saississez la commande suivante :<br />
db configuration setprop sysmon debug debug<br />
Attendez 5 minutes et aller voir dans le fichier /var/log/systemmonitor<br />
Envoyer moi un extrait, voir tout, mon adresse se trouve dans les spécifications du RPM.<br />
<br />
=== Additional information ===<br />
<br />
*[http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=viewsdownload&sid=61&orderby=dateD MasterSleepy Web site]<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Administration/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Linux_Logo/fr&diff=10382Linux Logo/fr2008-08-11T18:56:46Z<p>Cool34000: Nouvel article</p>
<hr />
<div>{{Languages|Linux Logo}}<br />
<br />
= Linux_Logo pour SME 7.x =<br />
Linux Logo affiche un logo avec quelques informations système.<br />
<br />
Les OS supportés sont Linux (la plupart des architectures) et quelques OS non-Linux.<br />
<br />
Visitez la [http://www.deater.net/weave page web de l'auteur] et [http://deater.net/weave/vmwprod/linux_logo/ son article sur Linux Logo] pour plus de détails.<br />
<br />
[[Image:linux_logo SME.png]]<br />
== Avant de commencer ==<br />
Il vous faut en 1er ajouter '''''dag''''' à la liste de dépots ("repository")<br />
<br />
Un howto existe [http://wiki.contribs.org/Dag ici]<br />
<br />
== Installation du RPM linux_logo ==<br />
Installez linux_logo avec la commande suivante :<br />
yum install linux_logo --enablerepo=dag<br />
<br />
== Ajout du logo SME ==<br />
Vous pouvez télécharger le fichier (logo) avec la commande suivante :<br />
cd /root<br />
wget "http://mirror.contribs.org/contribs/sgomez/contribs/linux_logo/sme.logo"<br />
Il y a plusieurs façons et options pour lancer linux_logo... Voila un exemple.<br />
<br />
Editez le fichier /root/.bash_profile et ajouter ce qui suit à la fin du fichier :<br />
# Launch linux_logo<br />
linux_logo -u -D /root/sme.logo<br />
Pour plus d'informations, consultez le manuel avec la commande suivante :<br />
man linux_logo<br />
<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br />
----<br />
[[Category: Administration/fr]]<br />
[[Category: Howto/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Linux_Logo&diff=10380Linux Logo2008-08-11T18:47:27Z<p>Cool34000: New article</p>
<hr />
<div>{{Languages|Linux Logo}}<br />
<br />
= Linux_Logo for SME 7.x =<br />
Linux Logo shows a logo with some System Info.<br />
<br />
It supports Linux (most architectures) and some non-Linux OSes.<br />
<br />
See the author's [http://www.deater.net/weave homepage] and [http://deater.net/weave/vmwprod/linux_logo/ Linux Logo article] for more details.<br />
<br />
[[Image:linux_logo SME.png]]<br />
== Before starting ==<br />
First, you need to add '''''dag''''' repository.<br />
<br />
See the quick howto [http://wiki.contribs.org/Dag here]<br />
<br />
== Installing linux_logo RPM ==<br />
Install linux_logo with the followwing command:<br />
yum install linux_logo --enablerepo=dag<br />
<br />
== Adding an SME custom logo ==<br />
You now need to download the SME style logo with the following command:<br />
cd /root<br />
wget "http://mirror.contribs.org/contribs/sgomez/contribs/linux_logo/sme.logo"<br />
There are many ways and options to launch linux_logo... Here's one method!<br />
<br />
Edit the file /root/.bash_profile and add the following at the end of the file:<br />
# Launch linux_logo<br />
linux_logo -u -D /root/sme.logo<br />
For more info, refer to the man page:<br />
man linux_logo<br />
<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br />
----<br />
[[Category: Administration]]<br />
[[Category: Howto]]</div>Cool34000https://wiki.koozali.org/index.php?title=File:Linux_logo_SME.png&diff=10379File:Linux logo SME.png2008-08-11T18:13:21Z<p>Cool34000: </p>
<hr />
<div></div>Cool34000https://wiki.koozali.org/index.php?title=Popfile/fr&diff=10378Popfile/fr2008-08-09T12:38:15Z<p>Cool34000: new repo fix (smecontribs)</p>
<hr />
<div>{{Languages|Popfile}}<br />
=POPFile 0.21.2 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
POPFile est un outil de classement automatique du courriel. Une fois correctement personnalisé et entraîné, il fonctionne à l'arrière-plan de votre ordinateur en analysant le courriel quand il arrive et en le classant selon vos souhaits. Vous pouvez lui demander d'effectuer une simple manoeuvre, comme par exemple mettre de côté le "pollupostage" ("courriel-poubelle"), ou une plus compliquée comme le classement du courriel en une douzaine de dossiers. Considérez-le comme l'assistant personnel de votre boîte de réception.<br />
Pour plus d'informations visitez ''http://popfile.sourceforge.net/''.<br />
<br />
==Installation et désinstallation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-popfile --enablerepo=smecontribs<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-popfile<br />
yum remove perl-DBD-SQLite<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un ''signal event post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
Vous pouvez maintenant récupérer les mails par l'intermédiaire de POPFile, vous avez juste besoin de modifier la configuration de votre client de messagerie favoris:<br />
Serveur POP3: '''nom-du-serveur-sme'''<br />
Login : '''nom-du-serveur-sme:votre-login'''<br />
Port POP3 : '''1100'''<br />
Pour ajouter des catégories ou simplement configurer POPFile, ouvrez votre navigateur favoris à l'adresse ''http://'''nom-du-serveur-sme:7676''.<br />
{{Warning box|type=warning|Pour des raisons de sécurité, veuillez créer un mot de passe après votre 1ère connexion !}}<br />
<br />
==Informations additionnelles==<br />
*[http://popfile.sourceforge.net/ Site web]<br />
*[http://popfile.sourceforge.net/wiki/howtos:outlook Comment configurer Outlook avec POPFile]<br />
<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Mail/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Popfile&diff=10377Popfile2008-08-09T12:36:40Z<p>Cool34000: new repo fix (smecontribs)</p>
<hr />
<div>{{Languages|Popfile}}<br />
=POPFile 0.21.2 for SME 7.x=<br />
<br />
==Maintainer==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
POPFile is an automatic mail classification tool. Once properly set up and trained, it will scan all email as it arrives and classify it based on your training. You can give it a simple job, like separating out junk e-mail, or a complicated one-like filing mail into a dozen folders. Think of it as a personal assistant for your inbox.<br />
For more information see ''http://popfile.sourceforge.net/''.<br />
<br />
==Installation and Uninstall==<br />
For installation just hit the following command<br />
yum install smeserver-popfile --enablerepo=smecontribs<br />
For uninstall just hit the following command<br />
yum remove smeserver-popfile<br />
yum remove perl-DBD-SQLite<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
==Use==<br />
You can now retrieve emails via POPFile, you just need to set the following configuration to your favorite email client:<br />
POP3 Server: '''your-sme-server-name'''<br />
Login : '''your-sme-server-name:your-sme-login'''<br />
POP3 Port : '''1100'''<br />
To add buckets or simply configure POPfile, start your favorite browser at ''http://your-sme-server-name:7676''.<br />
{{Warning box|For security-reasons, create a password after your first login!}}<br />
<br />
==Additional information==<br />
*[http://popfile.sourceforge.net/ Website]<br />
*[http://popfile.sourceforge.net/wiki/howtos:outlook Howto configure Outlook with POPFile]<br />
<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Mail]]</div>Cool34000https://wiki.koozali.org/index.php?title=Phpmyadminmulti&diff=9760Phpmyadminmulti2008-05-20T21:32:32Z<p>Cool34000: /* Utilisation */</p>
<hr />
<div>{{Languages|Phpmyadminmulti}}<br />
==Maintainer==<br />
[[User:MasterSleepy|Michel Van hees]]<br/><br />
<br />
==Description==<br />
Automatic installation of [http://www.phpmyadmin.net PHPMyAdmin] on SME Server.<br />
<br />
[http://www.phpmyadmin.net PHPMyAdmin] can handle all MySQL database that are on SME Server.<br />
==Version==<br />
Current version : 2.11.5<br />
<br />
==Installation==<br />
<br />
wget <nowiki>"http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=getit&lid=296"</nowiki><br />
yum localinstall smeserver-phpmyadmin-multiuser-*.noarch.rpm<br />
<br />
==Uninstallation==<br />
<br />
yum remove smeserver-phpmyadmin-multiuser<br />
<br />
==Use==<br />
You can access phpmyadmin interface by opening your web browser at the address:<br />
https://[IP or DOMAIN]/myadmin<br />
<br />
A login and a password is needed to connect.<br />
By default, the installation process creates a user "admin" with "admin" as password.<br />
<br />
'''Of course, the first thing you have to do, is change the admin password.'''<br />
<br />
Use the following commands (replace newpassword with your actual desired admin password).<br />
<br />
You can also use the same commands to reset the admin password to admin, if you have any problems connecting (ie replace newpassword with the word admin). You must be logged in as the root user.<br />
mysql --execute="grant all privileges on *.* to admin@localhost identified by 'newpassword' WITH GRANT OPTION"<br />
mysql --execute="flush privileges"<br />
<br />
==Settings==<br />
By default, installation process limit access at phpmyadmin to local network.<br />
<br />
To enable phpmyadmin to be access from internet and local network :<br />
<br />
db configuration setprop phpmyadminmulti access public<br />
signal-event console-save<br />
<br />
To limit access to local network :<br />
<br />
db configuration setprop phpmyadminmulti access private<br />
signal-event console-save<br />
<br />
<br />
==Additional information==<br />
*[http://www.phpmyadmin.net PHPMyAdmin website]<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Administration]]</div>Cool34000https://wiki.koozali.org/index.php?title=Phpmyadminmulti&diff=9759Phpmyadminmulti2008-05-20T21:32:18Z<p>Cool34000: /* Deinstallation */</p>
<hr />
<div>{{Languages|Phpmyadminmulti}}<br />
==Maintainer==<br />
[[User:MasterSleepy|Michel Van hees]]<br/><br />
<br />
==Description==<br />
Automatic installation of [http://www.phpmyadmin.net PHPMyAdmin] on SME Server.<br />
<br />
[http://www.phpmyadmin.net PHPMyAdmin] can handle all MySQL database that are on SME Server.<br />
==Version==<br />
Current version : 2.11.5<br />
<br />
==Installation==<br />
<br />
wget <nowiki>"http://www.vanhees.cc/index.php?name=CmodsDownload&file=index&req=getit&lid=296"</nowiki><br />
yum localinstall smeserver-phpmyadmin-multiuser-*.noarch.rpm<br />
<br />
==Uninstallation==<br />
<br />
yum remove smeserver-phpmyadmin-multiuser<br />
<br />
==Utilisation==<br />
You can access phpmyadmin interface by opening your web browser at the address:<br />
https://[IP or DOMAIN]/myadmin<br />
<br />
A login and a password is needed to connect.<br />
By default, the installation process creates a user "admin" with "admin" as password.<br />
<br />
'''Of course, the first thing you have to do, is change the admin password.'''<br />
<br />
Use the following commands (replace newpassword with your actual desired admin password).<br />
<br />
You can also use the same commands to reset the admin password to admin, if you have any problems connecting (ie replace newpassword with the word admin). You must be logged in as the root user.<br />
mysql --execute="grant all privileges on *.* to admin@localhost identified by 'newpassword' WITH GRANT OPTION"<br />
mysql --execute="flush privileges"<br />
<br />
==Settings==<br />
By default, installation process limit access at phpmyadmin to local network.<br />
<br />
To enable phpmyadmin to be access from internet and local network :<br />
<br />
db configuration setprop phpmyadminmulti access public<br />
signal-event console-save<br />
<br />
To limit access to local network :<br />
<br />
db configuration setprop phpmyadminmulti access private<br />
signal-event console-save<br />
<br />
<br />
==Additional information==<br />
*[http://www.phpmyadmin.net PHPMyAdmin website]<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Administration]]</div>Cool34000https://wiki.koozali.org/index.php?title=Talk:Phpmyadminmulti&diff=9726Talk:Phpmyadminmulti2008-05-15T20:42:40Z<p>Cool34000: </p>
<hr />
<div>What are the benefits of this package compared to the [[PHPMyAdmin]]? - <small>—&nbsp;[[User:Cactus|Cactus]] ([[User talk:Cactus|talk]]&nbsp;|&nbsp;[[Special:Contributions/Cactus|contribs]])&nbsp;</small> 03:49, 15 May 2008 (MDT)<br />
----<br />
This version is multi user...<br />
It comes with a default user : admin (pwd admin by default) and all existing MySQL users can login...<br />
The maintainer is also updating this RPM more often than DMay's version...<br />
<br />
Sylvain<br />
----<br />
Just because it is updated doesn't mean it is better. Well written packages won't need to be updated. This is especially true of integration packages. phpmyadmin package can be pulled from rpmforge and the sme part shouldn't have to change at all.<br />
<br />
It would be nice to combine the best of both packages into one so we only have to maintain one and keep the confusion to a minimum. Does anyone want to look at what is different and see what it would take to combine these? Possibly with a db switch to enable/disable multi-user functionality. <small>— [[User:Slords|Slords]] ([[User talk:Slords|talk]] • [[Special:Contributions/Slords|contribs]]).</small> 11:24, 15 May 2008 (MDT)<br />
<br />
:That's was what I was after, seeing if I could combine the two. Since I already cleaned out smeserver-phpmyadmin and converted it to be an integrational RPM. <small>—&nbsp;[[User:Cactus|Cactus]] ([[User talk:Cactus|talk]]&nbsp;|&nbsp;[[Special:Contributions/Cactus|contribs]])&nbsp;</small> 12:03, 15 May 2008 (MDT)<br />
----<br />
The more it is updated, the less security issues...<br />
<br />
I agree, RPM could be merged... I can remember there is only one single change in the Apache template (or something like that).<br />
<br />
I don't know if there are any RPM already build for this tool... That would be great!<br />
<br />
I'll contact MasterSleepy to see what can be done ;)</div>Cool34000https://wiki.koozali.org/index.php?title=Talk:Phpmyadminmulti&diff=9720Talk:Phpmyadminmulti2008-05-15T11:14:35Z<p>Cool34000: </p>
<hr />
<div>What are the benefits of this package compared to the [[PHPMyAdmin]]? - <small>—&nbsp;[[User:Cactus|Cactus]] ([[User talk:Cactus|talk]]&nbsp;|&nbsp;[[Special:Contributions/Cactus|contribs]])&nbsp;</small> 03:49, 15 May 2008 (MDT)<br />
----<br />
This version is multi user...<br />
It comes with a default user : admin (pwd admin by default) and all existing MySQL users can login...<br />
The maintainer is also updating this RPM more often than DMay's version...<br />
<br />
Sylvain<br />
----</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/fr&diff=9716Egroupware/fr2008-05-12T15:16:25Z<p>Cool34000: new rpm version</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupware 1.4.004 pour SME 7.x=<br />
<br />
==Mainteneurs==<br />
[[User:Berdie/fr|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
eGroupWare est un logiciel Collaboratif professionel et gratuit. Il vous permet de gérer vos contacts, vos rendez-vous, vos taches, et bien plus pour toute votre activité.<br />
eGroupWare est un serveur Collaboratif (groupware). Il est conçu nativement avec une interface Web qui vous permet d'accéder à vos données de n'importe quel plate-forme sur la planète.<br />
Vous avez le choix d'accéder au serveur eGroupWare avec votre client groupware préféré (Kontact, Evolution, Outlook) ainsi qu'avec votre téléphone portable ou votre PDA, par SyncML.<br />
<br />
eGroupWare est international. A ce jour, il supporte plus de [http://www.egroupware.org/languages 25 languages] incluant le support rtl.<br />
<br />
Pour plus d'informations, visitez ''http://www.egroupware.org/''.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.004-1.noarch.rpm<br />
yum localinstall smeserver-egroupware-1.4.004-1.noarch.rpm<br />
<br />
==Mise à jour==<br />
{{Warning box|'''A cause d'un bug dans les vieilles versions du RPM'''*''', VOUS DEVEZ DESINSTALLER LE VIEUX RPM AVANT LA MISE A JOUR AVEC LA COMMANDE SUIVANTE:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Ceci empêchera que les fichiers d'installation et la base de données MySQL soient supprimés.'''<br />
<br />
<nowiki>*</nowiki>'' Versions affectées: smeserver-egroupware-1.4-10 et antérieures''}}<br />
<br />
Vous pouvez alors mettre à jour votre version 1.4 existante avec la commande suivante:<br />
rpm -Uvh smeserver-egroupware-1.4.004-1.noarch.rpm<br />
Si vous mettez à jour la version d'eGroupWare (par exemple v1.4.001 vers v1.4.002) vous devez terminer la mise à jour dans Config-Admin Setup avec vos identifiants existants. Cliquez sur mettre à jour...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Revérifiez l'installation<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Si tout s'est bien passé, la mise à jour de version est effectuée !<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Une sauvegarde est effectuée par le RPM avant la mise à jour. Tous les fichiers et la base de données MySQL DataBase sont sauvegardés dans /opt/eGW_RPM_BACKUP<br />
'''Vous devez déplacer cette sauvegarde dans un endroit plus sur.'''<br />
<br />
Cette étape automatique est juste une sécurité, '''effectuez vos propres sauvegardes avant de mettre à jour.'''<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-egroupware<br />
Dans la nouvelle release (1.4.002-x), si vous souhaitez supprimer définitivement eGroupWare de votre serveur, vous devez taper la commande suivante:<br />
sh /root/eGW_Full_Uninstall.sh<br />
Ceci supprimera les fichiers d'installation d'eGroupWare, la base de données MySQL et les entrées dans la base de données de SME.<br />
<br />
==Démarrer avec eGroupWare==<br />
Veuillez effectuer la configuration initiale '''AVANT''' de vous connecter à eGroupware.<br />
Après cette étape, les utilisateurs SME pourront se connecter avec leurs login + mot de passe SME.<br />
A la 1ere connexion d'un utilisateur SME valide, le compte est automatiquement créé dans eGroupware.<br />
<br />
===Configuration initiale===<br />
Vous trouverez les fichiers d'installation de la dossier ''/opt/egroupware''. Pour terminer la configuration d'eGroupware, ouvrez votre navigateur à l'adresse ''https://votredomaine.com/egroupware/setup'' et connectez vous avec l'utilisateur ''config-admin'' + mot de passe ''admin'' dans Setup/Config Admin.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Vous devez maintenant créer le compte d'administration d'eGroupware. Utilisez un compte existant de SME (même utilisateur et même mot de passe), par exemple l'admin (déconseillé pour des raisons de sécurité) pour pouvoir envoyer et recevoir les mails administratifs dans eGroupware.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Déconnectez vous après avoir créé le compte d'administration.<br />
<br />
===Changement des mots de passe de config-admin / header-admin===<br />
Ouvrez votre navigateur et connectez vous avec l'utilisateur ''header-admin'' et le mot de passe ''admin'' à Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Changez les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' maintenant :<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Enregistrez vos changements en cliquant sur "Ecrire".<br />
<br />
{{Warning box|Pour des raisons de sécurité, veuillez changer les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' dès votre 1ère connexion !}}<br />
<br />
===Paramétrage de l'accessibilité===<br />
Le comportement par défaut d'eGroupware est : accessible depuis le LAN + Internet avec https "forcée" (SSL + rewrite rule).<br />
<br />
Vous pouvez facilement modifier ce comportement par défaut avec les commandes suivantes :<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Une fois les changements effectués, appliquez les modifications et redémarrez Apache :<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronisation===<br />
<br />
eGroupware fournit '''la synchronisation du calendrier, des tâches, des notes et du carnet d'adresse''' pour des clients comme MS Outlook et les PDA. Malheureusement, il faut php5 pour que cela fonctionne et cela n'est pas implémenté sur SME 7.x. En fait, il est possible de synchroniser Outlook avec le protocole ''xmlrpc'' et le logiciel ''eGWOSync''.<br />
<br />
====Synchronisation de MS Outlook====<br />
<br />
Vous pouvez synchroniser les données d'eGroupware avec Outlook en suivant ces étapes:<br />
<br />
'''1. Installez le certificat dans MS Internet Explorer'''<br />
<br />
*Démarrez Internet Explorer<br />
*Allez à l'adresse https://votredomaine.com<br />
*Cliquez sur "Afficher les certificats"<br />
*Cliquez sur "Installer le certificat" et terminez l'assitant d'installation du certificat<br />
{{Note box|Sous Vista, vous devez ajouter votre domaine à la liste des sites approuvés pour être capable d'accéder à l'installation du certificat.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Fermez MS Outlook s'il est ouvert.<br />
*Dans le panneau de configuration, allez dans les options de messagerie.<br />
*Afficher les profils... -> supprimer tous les profils<br />
*Redémarrez MS Outlook, créez un nouveau profile avec votre compte mail<br />
<br />
'''3. eGWOSync'''<br />
<br />
Téléchargez [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] et [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], si nécessaire.<br />
<br />
*Vous avez besoin de .NET Version 1.x, si vous avez déja une version supérieure, vous devrez également installer .NET 1.x<br />
*User/Password = compte utilisateur/mots de passe SME<br />
*Domain = default<br />
*Hostname = domaine SME<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = laisser par défaut<br />
*Faire le test<br />
<br />
'''4. Funambol'''<br />
<br />
Page de téléchargement de [http://www.funambol.com/opensource Funambol]<br />
<br />
Lien direct vers [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14]<br />
<br />
1) Ouvrez Outlook et allez dans le paramétrage de Funambol (Funambol --> Option)<br />
4) Selectionnez tous les items<br />
5) Options de paramétrage:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>https://votredomaine.com/egroupware/rpc.php</nowiki> ou <nowiki>https://IP Serveur/egroupware/rpc.php</nowiki><br />
Username = Votre utilisateur eGroupWare<br />
Password = Votre mot de passe eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 Septembre 2007 (MDT)<br />
<br />
==Addon Gallery2==<br />
Gallery2 est le 1er addon disponible pour eGroupWare 1.4.002<br />
<br />
Il a été intégré dans smeserver-egroupware-1.4.002-3.noarch.rpm (mais non installé par défaut)<br />
<br />
===Description===<br />
Gallery est une application web open source d'organisation d'albums photos. Gallery vous donne une façon intuitive d'intégrer la gestion de photos uniformement dans votre site web, que vous ayez un petit site personel ou une plus large communauté.<br />
<br />
Pour plus d'informations, visitez ''http://gallery.menalto.com/''.<br />
<br />
===Installation de Gallery2===<br />
Pour commencer, connectez vous au Config setup avec votre utilisateur config-admin et son mot de passe et cliquez sur ''Gérer les applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Cochez simplement la case d'installation de Gallery et sauvegardez.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Configuration de Gallery2===<br />
Une fois installé, vous devez paramétrer votre site web et créer la base de données. Cette étape a été préparée par le RPM d'installation.<br />
<br />
Ouvrez votre navigateur à l'adresse ''https://yourdomain.com/egroupware/gallery/gallery2/install'' et suivez les instructions.<br />
<br />
Dans la 4ème étape, le chemin vers le dossier de stockage est demandé. L'installation du RPM a préparé ''/opt/egroupware/files/g2data'', veuillez ne pas changer le chemin et les permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
Dans la 5ème étape, les informations MySQL sont demandées. L'installation du RPM a préparé ''egwuser'' ''egroupware'' et votre ''DbPassword'' automatiquement. Cliquez simplement sur sauvegarder et finissez l'installation.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Icone Gallery2===<br />
Une fois la configuration terminée, vous pouvez ajouter l'icone dans l'interface d'eGroupWare.<br />
Connectez vous à eGroupWare avec un compte admin et éditez un utilisateur ou un groupe pour lui ajouter l'application Gallery.<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|Gallery peut être accédé sans authentification à l'adresse ''https://votredomaine.com/egroupware/gallery/gallery2''}}<br />
<br />
==Informations supplémentaire==<br />
<br />
*[http://www.egroupware.org Site web d'eGroupWare]<br />
*[http://gallery.menalto.com/ Site web de Gallery]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 topic sur le forum de contribs.org]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 topic sur le forum de contribs.org]<br />
<br />
Have much fun with eGroupware as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Groupware/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/de&diff=9715Egroupware/de2008-05-12T15:13:51Z<p>Cool34000: new rpm version</p>
<hr />
<div>{{Languages|Egroupware}}<br />
<br />
=eGroupware 1.4.004 für SME 7.x=<br />
<br />
<br />
==Maintainers==<br />
[[User:Berdie/de|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
<br />
==Beschreibung==<br />
eGroupware 1.4 für SMEserver 7.x ist ein leistungsfähiges modulares Internet/Intranet Anwendungsframework und stellt Groupware-Funktionen zur Verfügung. Bereitgestellt werden die Funktionen E-Mail, Kontakte, Termine, Aufgaben und vieles mehr.<br />
eGroupWare ist ein Groupware-Server und enthält eine Web-Plattform, mit der weltweit der Zugang über das Internet möglich ist. Darüber hinaus ist es auch möglich, eGroupWare mit Offline-Clients (Kontact, Evolution, Outlook) und sogar mit Handys und PDA zu synchronisieren. eGroupWare ist international und in mehr als 25 Sprachen verfügbar.<br />
Mehr über eGroupware können Sie unter ''http://www.egroupware.org/'' erfahren.<br />
<br />
Mit dieser Erweiterung kann eGroupWare auf Ihrem SME 7.x (und höher) benutzt werden. Die Installation erfolgt als ein einziges Paket extrem einfach.<br />
<br />
==Installation und Deinstallation==<br />
Die Installation erfolgt ganz einfach mit<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.004-1.noarch.rpm<br />
yum localinstall smeserver-egroupware-1.4.004-1.noarch.rpm<br />
Die Deinstallation erfolgt mit<br />
yum remove smeserver-egroupware<br />
Die yum-Empfehlung, die Befehle ''signal event post-upgrade'' und anschließend ''signal-event reboot'' durchzuführen, kann ignoriert werden.<br />
<br />
'''Achtung, mit diesem RPM ist das Upgrade von eGroupWare 1.2.x nicht möglich'''<br />
{{Warning box|'''Durch einen bug in alten RPM Versionen'''*''', MUSS ERST DAS ALTE RPM DEINSTALLIERT WERDEN, BEVOR IHR SYSTEM AUF DEN NEUEN STAND GEBRACHT WERDEN KANN MIT:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Dieser Befehl schützt davor, Installationsdateien und MySQL-Datenbanken zu löschen.'''<br />
<br />
<nowiki>*</nowiki>'' Betroffene Versionen sind smeserver-egroupware-1.4-10 und älter''}}<br />
<br />
Anschließend können Sie die existierende 1.4-Installation aktualisieren mit<br />
rpm -Uvh smeserver-egroupware-1.4.004-1.noarch.rpm<br />
Falls dabei die eGroupWare Version aktualsiert wird (z.B. von 1.4.001 nach 1.4.002), müssen Sie das Upgrade mit dem Config-Admin Setup und bisherigem Passwort beenden. Danach auf Upgrade klicken...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Danach nochmals die Installation prüfen<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Falls keine Fehler auftauchen, ist der Upgrade fertig!<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Eine Sicherung wurde durch das RPM vor dem Upgrade durchgeführt. Alle Dateien und die MySQL-Datenbank finden Sie unter /opt/eGW_RPM_BACKUP<br />
'''Speichern Sie die Sicherung in einem sicheren Verzeichnis ab.'''<br />
<br />
Dieser automatische Schritt ist nur aus Sicherheitsgründen. '''Erstellen Sie bitte eigene Sicherungen vor dem Upgrade.'''<br />
<br />
<br />
==Deinstallation==<br />
Um die Anwendung zu deinstallieren, geben Sie einfach folgenden Befehl ein:<br />
rpm -e smeserver-egroupware<br />
Zusätzlich ist in neuem Release (1.4.002-x) der Befehl 'sh /root/eGW_Full_Uninstall.sh' erforderlich, mit dem Instalaltionsdateien, die MySQL-Datenbank und SME Datenbankeinträge gelöscht werden.<br />
<br />
<br />
==Anwendung==<br />
<br />
Führen Sie '''UNBEDINGT VOR''' dem ersten Anmelden bei eGroupware die Erstkonfiguration durch.<br />
Anschließend können sich die SME Benutzer an eGroupware mit Ihrem gewohnten SME Benutzernamen + Kennwort anmelden. Bei der ersten Anmeldung werden Benutzer automatisch so angelegt, dass diese mit den SME Benutzern identisch sind.<br />
<br />
===Erstkonfiguration===<br />
Sie finden eGroupware im Verzeichnis ''/opt/egroupware''. Um eGroupware zu nutzen, starten Sie Ihren Browser mit der URL ''http://servername/egroupware/setup'' und melden sich mit dem Benutzer ''config-admin'' + Kennwort ''admin'' im Setup-/Konfigurationsadmin-Login an.<br />
[[Image:EGW-config-admin-de.png]]<br />
<br />
Legen Sie jetzt das Administrator-Konto 'admin' an, dabei muss das Kennwort mit dem Kennwort des SME Admin identisch sein, um SME Admin Mails mit diesem Benutzer in eGroupware empfangen zu können. <br />
<br />
[[Image:EGW-create-admin-account-de.png]]<br />
<br />
Melden Sie sich anschließend ab.<br />
<br />
===Ändern der Kennwörter für eGW config-admin / header-admin===<br />
<br />
Starten Sie den Browser und melden Sie sich mit dem Benutzer ''header-admin'' + Kennwort ''admin'' im Login Headerverwaltung an. <br />
<br />
[[image:EGW-header-admin-de.png]]<br />
<br />
Ändern Sie jetzt die Kennwörter die Benutzer ''config-admin'' und ''header-admin'':<br />
<br />
[[image:EGW-password-config-admin-de.png]]<br />
<br />
[[image:EGW-password-header-admin-de.png]]<br />
<br />
Schließen Sie den Vorgang mit "Schreiben" ab. <br />
<br />
{{Warning box|type=Warnung|Aus Sicherheitsgründen wird dringend empfohlen, die Kennwörter für die Benutzer ''config-admin'' und ''header-admin'' unmittelbar nach der ersten Anmeldung zu ändern !}}<br />
<br />
===Spezielle Einstellungen===<br />
In der Voreinstellung ist eGroupWare über LAN und Internet nur mit dem "erzwungenen" https-Protokoll und SSL erreichbar.<br />
Das können Sie mit folgenden Befehlen an der Serverkonsole ändern:<br />
<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Anschließend aktivieren Sie Ihre Änderungen und starten Apache neu:<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# svc -h /service/httpd-e-smith<br />
<br />
===Synchronisation===<br />
<br />
eGroupware unterstützt die '''Synchronisation von Kalender, Aufgaben, Notizen und Adressbuch''' mit Offline-Clients wie MS Outlook und PDA's. Dafür ist allerdings PHP5 erforderlich, das noch nicht im SME 7 implementiert ist. Dennoch ist zumindest über das ''xmlrpc'' Protokoll und die Anwendung ''eGWOSync'' die Synchronisation mit MS Outlook möglich.<br />
<br />
====MS Outlook Synchronisation====<br />
<br />
eGroupware-Daten mit MS Outlook können folgendermaßen synchronisiert werden:<br />
<br />
'''1. Zertifikat über MS Internet Explorer installieren'''<br />
<br />
*Internet Explorer starten<br />
*URL = https://servername eingeben<br />
*Auf "Zertifikat anzeigen" klicken<br />
*Auf "Zertifikat installieren" klicken und das Zertifikat installieren<br />
{{Note box|Unter Vista muss zusätzlich die Domäne in die Liste der vertrauenswürdigen Websites kopiert werden, bevor das Zertifikat installiert werden kann.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*MS Outlook beenden, falls es aktiv sein sollte.<br />
*Aufruf der Systemsteuerung, Register Mail.<br />
*Profile anzeigen... -> alle vorhandenen Profile entfernen<br />
*MS Outlook starten, Profil komplett neu anlegen, dabei auch Mailkonto anlegen<br />
<br />
'''3. eGWOSync'''<br />
<br />
Laden Sie sich [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] und ggfs. auch [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET] in der passenden Version herunter.<br />
Sollte .NET in einer aktuelleren Version installiert sein, muss diese vorher erst deinstalliert werden.<br />
<br />
*Es muss .NET Version 1.x installiert sein, neuere .NET-Versionen werden von eGWOSync nicht akzeptiert<br />
*User/Password = SME Benutzer/Kennwort<br />
*Domain = default<br />
*Hostname = SME Hauptdomäne<br />
*Port = 443<br />
*Use SSL = aktiv<br />
*URL = Voreinstellung beibehalten<br />
*Test durchführen<br />
<br />
'''4. Funambol'''<br />
<br />
Laden Sie sich Funambol [http://www.http://www.funambol.com/opensource Funambol Web Site]<br />
unter [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14] herunter.<br />
<br />
1) Installieren Sie Funambol 6.0.14<br />
2) Ändern Sie den Wert "7" to "0" für den Schlüssel 'mbstring.func_overload = 0' in php.ini <br />
3) Öffnen Sie Outlook über Funambol Setup (Funambol --> Option)<br />
4) Markieren Sie alle Einträge<br />
5) Setup Optionen:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>http://Domain Name/egroupware/rpc.php</nowiki> or <nowiki>http://Server IP/egroupware/rpc.php</nowiki><br />
Username = Ihr login name für eGroupWare<br />
Password = Ihr Password für eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
==Weitere Informationen==<br />
<br />
*[http://www.egroupware.org Website]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]<br />
<br />
Ich wünsche allen Nutzern viel Spass beim Einsatz von eGroupware !<br />
<br />
''Dietmar Berteld (berdie)''</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware&diff=9714Egroupware2008-05-12T15:10:13Z<p>Cool34000: new rpm version</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupWare 1.4.004 for SME 7.x and above=<br />
<br />
==Maintainers==<br />
[[User:Berdie/de|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
[[User:Snoopyski|Stéphane Gauvin]]<br/><br />
mailto:sgauvin@serviceinfosg.com<br />
<br />
==Description==<br />
eGroupWare is a [http://www.egroupware.org/philosophy free] enterprise ready groupware software for your network. It enables you to manage contacts, appointments, todos and many more for your whole business.<br />
<br />
eGroupWare is a groupware server. It comes with a native web-interface which allowes to access your data from any platform all over the planet. Moreover you also have the choice to access the eGroupWare server with your favorite groupware client (Kontact, Evolution, Outlook) and also with your mobile or PDA via SyncML.<br />
<br />
eGroupWare is international. At the time, it supports more than [http://www.egroupware.org/languages 25 languages] including rtl support.<br />
<br />
For more information see ''http://www.egroupware.org/''.<br />
<br />
With this RPM you can use eGroupWare on your SME 7.x (and above). You can install it as one single package in a very comfortable way.<br />
<br />
==Installation==<br />
For installation just hit the following command<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/egroupware/smeserver-egroupware-1.4.004-1.noarch.rpm<br />
yum localinstall smeserver-egroupware-1.4.004-1.noarch.rpm<br />
<br />
==Update/Upgrade==<br />
'''Please note that this RPM cannot upgrade eGroupWare 1.2.x'''<br />
{{Warning box|'''Because of a bug in old RPM versions'''*''', YOU MUST UNINSTALL THE OLD RPM BEFORE UPDATING WITH THE FOLLOWING COMMAND:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''This will prevent installation files and MySQL to be deleted.'''<br />
<br />
<nowiki>*</nowiki>'' Affected versions are smeserver-egroupware-1.4-10 and older''}}<br />
<br />
Then, you can update your existing 1.4 installation with<br />
rpm -Uvh smeserver-egroupware-1.4.004-1.noarch.rpm<br />
If you were upgrading eGroupWare version (i.e.1.4.001 to 1.4.002) you must finish the upgrade at the Config-Admin Setup with your existing credentials. Then click on upgrade...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Then re-check your install<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
If all went ok, upgrade is done!<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
A backup is done by the RPM before updating. All Files and MySQL DataBase are saved in /opt/eGW_RPM_BACKUP<br />
'''You must move the backup to a safe directory.'''<br />
<br />
This automatic step is just for safety, '''make your own backup before updating/upgrading.'''<br />
<br />
==Uninstallation==<br />
For uninstall just hit the following command<br />
yum remove smeserver-egroupware<br />
In the new release (1.4.002-x), if you want to completly remove eGroupWare from your server, you need the following command:<br />
sh /root/eGW_Full_Uninstall.sh<br />
This will delete eGroupWare's installation files, MySQL DB and SME DB entries.<br />
<br />
==Starting with eGroupWare==<br />
Please perform the Intial Configuration '''FIRST''' before login to eGroupWare.<br />
After that SME users can login to eGroupWare with their used SME account + password. At first login, eGroupWare creates user accounts and passwords automatically and synchronize them to the SME Server.<br />
<br />
===Inital Configuration===<br />
You can find eGroupWare in the ''/opt/egroupware'' directory. For using eGroupWare start your browser with the URL ''http://servername/egroupware/setup'' and logon with the user ''config-admin'' + password ''admin'' at Setup/Config Admin Login.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Now you should create eGroupWare's admin-account. Because eGroupWare uses mail authentication, the admin-account must be a valid SME account/password. This account will be able to use+administrate eGroupWare.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Logout after creating the admin account.<br />
<br />
===Changing passwords for eGW config-admin / header-admin===<br />
Go to your browser and logon with the user ''header-admin'' + password ''admin'' at Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Change the passwords for the users ''config-admin'' and ''header-admin''now:<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Store the new passwords with "Write". <br />
<br />
{{Warning box|For security-reasons, change the passwords for the users ''config-admin'' and ''header-admin'' after your first login !}}<br />
<br />
===Adjusting accessibility===<br />
The default behaviour of eGroupWare is: accessible from LAN + Internet with "forced https" (SSL on + rewrite rule)<br />
You can easily change those defaults settings with following commands:<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Once done, apply modifications and restart Apache:<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronization===<br />
eGroupWare provides '''Synchronization of calender, todo's, notes and addressbook''' with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the ''xmlrpc'' protocol and the ''eGWOSync'' application.<br />
<br />
====MS Outlook Synchronization====<br />
You can sync eGroupWare-Data to MS Outlook as follows:<br />
<br />
'''1. Install certificate with MS Internet Explorer'''<br />
<br />
*Start Internet Explorer<br />
*Enter URL = https://servername<br />
*Enter "show certificate"<br />
*Enter "install certificate" and go on to install your SME certificate<br />
{{Note box|Under Vista, you have to put your domain in the approved website list before being able to install the certificate.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Finish your MS Outlook if active.<br />
*Go to system control, register mail.<br />
*show profiles... -> delete all profiles<br />
*Start MS Outlook, create a new profile with your mail account<br />
<br />
'''3. eGWOSync'''<br />
<br />
Download [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] and [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], if necessary. If your .NET release is newer than version 1.x, you must install both versions on your system.<br />
<br />
*You need .NET Version 1.x, eGWOSync accepts no newer versions<br />
*User/Password = SME user account/password<br />
*Domain = default<br />
*Hostname = SME domain<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = keep default values<br />
*Perform test<br />
<br />
'''4. Funambol'''<br />
<br />
Download Web site: [http://www.funambol.com/opensource Funambol Web Site]<br />
Download Funambol 6.5.7 link [http://download.forge.objectweb.org/sync4j/funambol-outlook-plugin-6.5.7.exe]<br />
<br />
1) Install the last Funambol Plugin<br />
2) Change "7" to "0" for mbstring.func_overload = 0 in php.ini <br />
3) Open Outlook go to the Funambol Setup (Funambol --> Option)<br />
4) Select all items<br />
5) Setup options:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>http://Domain Name/egroupware/rpc.php</nowiki> or <nowiki>http://Server IP/egroupware/rpc.php</nowiki><br />
Username = Your user login name for eGroupWare<br />
Password = Your user password for eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcalendar<br />
Data Format = SIF<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
'''NOTES:'''<br />
<br />
To get success with synchronisation put thoses settings in .htaccess file in the root folder of egroupware (html):<br />
<br />
Run this on PuTTY:<br />
<br />
#db accounts setprop egroupware AllowOverride All<br />
#signal-event ibay-modify egroupware<br />
<br />
'''.htaccess file settings:'''<br />
<br />
*AddType text/xml .xml<br />
*php_value memory_limit 32M<br />
*php_value max_execution_time 60<br />
*php_flag register_globals Off<br />
*php_flag magic_quotes_gpc Off<br />
*php_flag magic_quotes_runtime Off<br />
*php_value upload_max_filesize 16M<br />
*php_flag session.use_trans_sid Off<br />
*php_value session.gc_probability 1<br />
*php_value session.gc_divisor 10<br />
*php_value mbstring.func_overload 7<br />
* <Files rpc.php><br />
* php_value mbstring.func_overload 0<br />
* Order allow,deny<br />
* Allow from all<br />
* </Files><br />
---<br />
--[[User:Snoopyski|Stéphane Gauvin -- Service Informatique SG]] 09:29, 1 March 2008 (MST)<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 September 2007 (MDT)<br />
<br />
====syncml configuration====<br />
<br />
From http://forums.contribs.org/index.php?topic=40242.new;topicseen#new<br />
<br />
Here are the steps to configure syncml with egroupware:<br />
<br />
1. Install php5-cgi as explained in this howto http://sme.firewall-services.com/spip.php?article46 <br />
<br />
(Stop after Step 3, Step 4 is just an example)<br />
<br />
<br />
2. Create a custom-template so that rpc.php is handled by php5:<br />
<br />
vim /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/90egw-syncml<br />
<br />
and enter the following:<br />
<br />
<Location /egroupware/rpc.php><br />
AddHandler php5-cgi .php<br />
Action php5-cgi /php5-cgi/php<br />
</Location><br />
<br />
<br />
3. Edit /etc/php5/php.ini (this file has no templates so you can edit it directly)<br />
<br />
On Line 304<br />
<br />
memory_limit = 8M<br />
<br />
change it to a bigger value, for example<br />
<br />
memory_limit = 32M<br />
<br />
On Line 1191 uncomment the line:<br />
<br />
mbstring.func_overload = 0<br />
<br />
(This may not be useful as php5-cgi has been compiled without mbstring support).<br />
<br />
There is no need for a htaccess file (htaccess could configure php4 because <br />
it's an apache module but not php5-cgi).<br />
<br />
expand-template /etc/httpd/conf/httpd.conf <br />
sv t /service/httpd-e-smith<br />
sv s /service/httpd-e-smith<br />
<br />
To check syntax is OK do:<br />
httpd -t<br />
<br />
syncml has been tested with the Funambol plugin for Outlook (several versions) & works OK.<br />
<br />
==Gallery2 addon==<br />
Gallery2 is the first addon available for eGroupWare 1.4.002<br />
<br />
It has been integrated in smeserver-egroupware-1.4.002-3.noarch.rpm (but not installed by default)<br />
<br />
===Description===<br />
Gallery is an open source web based photo album organizer. Gallery gives you an intuitive way to blend photo management seamlessly into your own website whether you're running a small personal site or a large community site.<br />
<br />
For more information see ''http://gallery.menalto.com/''.<br />
<br />
===Gallery2 install===<br />
First, login at Config setup with your existing creditentials and clic on ''Manage Applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Then simply click on Gallery install checkbox and save your changes.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Gallery2 setup===<br />
Once Installed, you need to configure your website and create the database. This step has been prepared by the RPM install.<br />
<br />
Open your web browser at ''https://yourdomain.com/egroupware/gallery/gallery2/install'' and follow instructions.<br />
<br />
In the 4th step, you will be asked for a storage folder. RPM install has prepared ''/opt/egroupware/files/g2data'', please don't change neither path nor permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
In the 5th step, you will be asked for MySQL informations. RPM install has prepared ''egwuser'' ''egroupware'' and your DbPassword automatically. Just save and finish the install.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Gallery2 icon===<br />
Once the setup is done you can add the icon in eGroupWare's interface.<br />
Login to eGroupWare with an admin account, and edit a user or a group and add gallery<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|The gallery can also be accessed with no authentication at ''https://yourdomain.com/egroupware/gallery/gallery2''}}<br />
<br />
==Additional information==<br />
<br />
*[http://www.egroupware.org eGroupWare Homepage]<br />
*[http://gallery.menalto.com/ Gallery Homepage]<br />
*[http://www.egroupware.org/wiki eGroupWare Documentation]<br />
*[http://www.egroupware.org/index.php?page_name=wiki&wikipage=ManualSetupUpdate Howto Update eGroupWare]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]<br />
<br />
<br />
Have much fun with eGroupWare as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Groupware]]<br />
[[Category: Webapps]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server/fr&diff=9713TeamSpeak Server/fr2008-05-12T15:04:06Z<p>Cool34000: /* Installation */</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
=TeamSpeak Server 2.0.24.1 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak est une application de qualité et évolutive qui permet aux personnes de parler entre eux sur Internet. TeamSpeak est consistué d'une partie serveur et cliente. Le serveur agit comme un hôte pour des connexions clientes multiples, capable de gérer littéralement des milliers d'utilisateurs simultanés. Le résultat est une solution de téléconférence par Internet qui ouvre les portes d'applications comme la conversation de coéquipiers pour le jeu en ligne, la réduction des couts pour les entreprises qui font des communications longues distances ou encore la conversation entre amis ou la famille.<br />
<br />
Pour plus d'informations, visitez ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
L'utilisation est gratuite à des fins non commerciales.<br />
Merci de lire leur [http://www.goteamspeak.com/index.php?page=faq FAQ] pour plus d'informations sur les licences et les conditions d'utilisations.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/teamspeak/smeserver-teamspeak-server-2.0.24.1-2.noarch.rpm<br />
yum localinstall smeserver-teamspeak-server-2.0.24.1-2.noarch.rpm<br />
<br />
==Mise à jour==<br />
Ce RPM ne peut pas être mis à jour, veuillez désinstaller l'ancienne version avant d'installer la nouvelle.<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante <br />
yum remove smeserver-teamspeak-server<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un signal event ''post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
===Partie client===<br />
*Téléchargez la dernière version du client (TS est disponible pour toutes les plateformes)<br />
*Connectez vous au serveur avec le client et profitez !<br />
<br />
Vous pouvez voir qui est connecté et vous connecter à TeamSpeak en utilisant le nouveau site inclus à l'adresse http://votredomaine.com/tsweb<br />
<br />
[[Image:tsweb.png]]<br />
<br />
===Partie serveur===<br />
{{Note box|En mode server-only, vous devez translater le port UDP 8767 de votre routeur vers votre SME !}}<br />
====Administration====<br />
*La page d'administration de TeamSpeak Server est accessible à l'adresse http://your-sme-server-name:14534 (Depuis le LAN seulement !)<br />
Vous aurez besoin des mots de passes admin et superadmin qui peuvent être récupérés en tapant la commande suivante au prompt<br />
service teamspeak passwords<br />
<br />
====Bannière personnalisée====<br />
Si vous voulez une bannière personnalisée, éditez le fichier '''''/opt/teamspeak/server.ini''''' et ajoutez les lignes suivantes à la fin du fichier :<br />
[ISP] <br />
GFX URL=http://lien_vers_image/banniere.jpg<br />
La bannière DOIT ETRE au format JPG (150x80 pixels maxi)<br />
<br />
==Ligne de commandes==<br />
Le service TeamSpeak accepte les arguments suivants :<br />
service teamspeak {start|stop|restart|status|passwords}<br />
Pour voir la configuration complète du service TeamSpeak :<br />
config show teamspeak<br />
<br />
====Réglages optionnels du Firewall====<br />
*Vous pourriez avoir besoin de rendre l'interface web globalement accessible :<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*Vous pourriez avoir besoin de visionner l'activité du serveur sur votre site web (si le serveur web est en dehors de votre LAN) :<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
Vous pouvez même utiliser les 2 :<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Ajouter une instance serveur sur le port 8768 (le serveur doit être déclaré dans l'interface web !)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|En mode server-only, vous devez translater ces ports de votre routeur vers votre SME !}}<br />
<br />
Pour revenir aux réglages par défaut, tapez les commandes suivantes :<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Informations additionnelles==<br />
*[http://www.goteamspeak.com/ Page d'accueil]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Section téléchargement]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Démarrage]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server&diff=9712TeamSpeak Server2008-05-12T15:03:46Z<p>Cool34000: /* Installation */</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
==Maintainer==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak is a quality, scalable application which enables people to speak with one another over the Internet. TeamSpeak consists of both client and server software. The server acts as a host to multiple client connections, capable of handling literally thousands of simultaneous users. This results in an Internet based teleconferencing solution that works in a variety of applications such as team mates speaking with one another while playing their favorite online game, small businesses cutting costs on long distance charges, or for personal communication with friends and family.<br />
For more information see ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
TeamSpeak is free of charge to non-commercial users.<br />
Please see their [http://www.goteamspeak.com/index.php?page=faq FAQ] for more information on licensing and terms of use.<br />
<br />
==Installation==<br />
For installation just hit the following command<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/teamspeak/smeserver-teamspeak-server-2.0.24.1-2.noarch.rpm<br />
yum localinstall smeserver-teamspeak-server-2.0.24.1-2.noarch.rpm<br />
<br />
==Update==<br />
This RPM is not updatable. Please uninstall old version before installing the new one.<br />
<br />
==Uninstallation==<br />
For uninstall just hit the following command<br />
yum remove smeserver-teamspeak-server<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
==Use==<br />
===Client side===<br />
*Download and install latest TeamSpeak client (TS is available on all platforms)<br />
*Connect to your server with the client and enjoy!<br />
<br />
You can see who is connected and connect to TeamSpeak using the new built-in website at http://yourdomain.com/tsweb<br />
<br />
[[Image:tsweb.png]]<br />
<br />
===Server side===<br />
{{Note box|In server-only mode, you will have to forward UDP port 8767 from your router to your SME!}}<br />
====Administration====<br />
*The webpage for administrating TeamSpeak Server is at http://your-sme-server-name:14534 (LAN only by default!)<br />
You will need admin and superadmin passwords which can be retrieved by typing this command at a linux-prompt<br />
service teamspeak passwords<br />
<br />
====Custom banner====<br />
If you want a custom banner, edit '''''/opt/teamspeak/server.ini''''' and add following lines at the end of the file:<br />
[ISP] <br />
GFX URL=http://link_to_image/banner.jpg<br />
Banner logo MUST BE JPG (150x80 pixels max)<br />
<br />
====Commandline====<br />
TeamSpeak's service accepts following commands:<br />
service teamspeak {start|stop|restart|status|passwords}<br />
To view the full configuration of TeamSpeak service:<br />
config show teamspeak<br />
<br />
====Optionnal Firewall settings====<br />
*You could want the web interface to be globaly accessible:<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*You could also want to view your server's activity on your website (if the web server is outside your LAN):<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
You can even use both:<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Allow another server instance on port 8768 (server still needs to be added in the web interface!)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|In server-only mode, you need to forward these ports from your router to your SME!}}<br />
<br />
<br />
To revert to defaults settings, issue following commands:<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Additional information==<br />
*[http://www.goteamspeak.com/ Homepage]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Download section]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Getting Started]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server/fr&diff=9711TeamSpeak Server/fr2008-05-12T14:58:50Z<p>Cool34000: new rpm version</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
=TeamSpeak Server 2.0.24.1 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak est une application de qualité et évolutive qui permet aux personnes de parler entre eux sur Internet. TeamSpeak est consistué d'une partie serveur et cliente. Le serveur agit comme un hôte pour des connexions clientes multiples, capable de gérer littéralement des milliers d'utilisateurs simultanés. Le résultat est une solution de téléconférence par Internet qui ouvre les portes d'applications comme la conversation de coéquipiers pour le jeu en ligne, la réduction des couts pour les entreprises qui font des communications longues distances ou encore la conversation entre amis ou la famille.<br />
<br />
Pour plus d'informations, visitez ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
L'utilisation est gratuite à des fins non commerciales.<br />
Merci de lire leur [http://www.goteamspeak.com/index.php?page=faq FAQ] pour plus d'informations sur les licences et les conditions d'utilisations.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/teamspeak/smeserver-teamspeak-server-2.0.24.1-2.noarch.rpm<br />
yum localinstall smeserver-teamspeak-server<br />
<br />
==Mise à jour==<br />
Ce RPM ne peut pas être mis à jour, veuillez désinstaller l'ancienne version avant d'installer la nouvelle.<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante <br />
yum remove smeserver-teamspeak-server<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un signal event ''post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
===Partie client===<br />
*Téléchargez la dernière version du client (TS est disponible pour toutes les plateformes)<br />
*Connectez vous au serveur avec le client et profitez !<br />
<br />
Vous pouvez voir qui est connecté et vous connecter à TeamSpeak en utilisant le nouveau site inclus à l'adresse http://votredomaine.com/tsweb<br />
<br />
[[Image:tsweb.png]]<br />
<br />
===Partie serveur===<br />
{{Note box|En mode server-only, vous devez translater le port UDP 8767 de votre routeur vers votre SME !}}<br />
====Administration====<br />
*La page d'administration de TeamSpeak Server est accessible à l'adresse http://your-sme-server-name:14534 (Depuis le LAN seulement !)<br />
Vous aurez besoin des mots de passes admin et superadmin qui peuvent être récupérés en tapant la commande suivante au prompt<br />
service teamspeak passwords<br />
<br />
====Bannière personnalisée====<br />
Si vous voulez une bannière personnalisée, éditez le fichier '''''/opt/teamspeak/server.ini''''' et ajoutez les lignes suivantes à la fin du fichier :<br />
[ISP] <br />
GFX URL=http://lien_vers_image/banniere.jpg<br />
La bannière DOIT ETRE au format JPG (150x80 pixels maxi)<br />
<br />
==Ligne de commandes==<br />
Le service TeamSpeak accepte les arguments suivants :<br />
service teamspeak {start|stop|restart|status|passwords}<br />
Pour voir la configuration complète du service TeamSpeak :<br />
config show teamspeak<br />
<br />
====Réglages optionnels du Firewall====<br />
*Vous pourriez avoir besoin de rendre l'interface web globalement accessible :<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*Vous pourriez avoir besoin de visionner l'activité du serveur sur votre site web (si le serveur web est en dehors de votre LAN) :<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
Vous pouvez même utiliser les 2 :<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Ajouter une instance serveur sur le port 8768 (le serveur doit être déclaré dans l'interface web !)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|En mode server-only, vous devez translater ces ports de votre routeur vers votre SME !}}<br />
<br />
Pour revenir aux réglages par défaut, tapez les commandes suivantes :<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Informations additionnelles==<br />
*[http://www.goteamspeak.com/ Page d'accueil]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Section téléchargement]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Démarrage]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server&diff=9710TeamSpeak Server2008-05-12T14:54:18Z<p>Cool34000: new rpm version</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
==Maintainer==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak is a quality, scalable application which enables people to speak with one another over the Internet. TeamSpeak consists of both client and server software. The server acts as a host to multiple client connections, capable of handling literally thousands of simultaneous users. This results in an Internet based teleconferencing solution that works in a variety of applications such as team mates speaking with one another while playing their favorite online game, small businesses cutting costs on long distance charges, or for personal communication with friends and family.<br />
For more information see ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
TeamSpeak is free of charge to non-commercial users.<br />
Please see their [http://www.goteamspeak.com/index.php?page=faq FAQ] for more information on licensing and terms of use.<br />
<br />
==Installation==<br />
For installation just hit the following command<br />
wget http://mirror.contribs.org/contribs/sgomez/contribs/teamspeak/smeserver-teamspeak-server-2.0.24.1-2.noarch.rpm<br />
yum localinstall smeserver-teamspeak-server<br />
==Update==<br />
This RPM is not updatable. Please uninstall old version before installing the new one.<br />
<br />
==Uninstallation==<br />
For uninstall just hit the following command<br />
yum remove smeserver-teamspeak-server<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
==Use==<br />
===Client side===<br />
*Download and install latest TeamSpeak client (TS is available on all platforms)<br />
*Connect to your server with the client and enjoy!<br />
<br />
You can see who is connected and connect to TeamSpeak using the new built-in website at http://yourdomain.com/tsweb<br />
<br />
[[Image:tsweb.png]]<br />
<br />
===Server side===<br />
{{Note box|In server-only mode, you will have to forward UDP port 8767 from your router to your SME!}}<br />
====Administration====<br />
*The webpage for administrating TeamSpeak Server is at http://your-sme-server-name:14534 (LAN only by default!)<br />
You will need admin and superadmin passwords which can be retrieved by typing this command at a linux-prompt<br />
service teamspeak passwords<br />
<br />
====Custom banner====<br />
If you want a custom banner, edit '''''/opt/teamspeak/server.ini''''' and add following lines at the end of the file:<br />
[ISP] <br />
GFX URL=http://link_to_image/banner.jpg<br />
Banner logo MUST BE JPG (150x80 pixels max)<br />
<br />
====Commandline====<br />
TeamSpeak's service accepts following commands:<br />
service teamspeak {start|stop|restart|status|passwords}<br />
To view the full configuration of TeamSpeak service:<br />
config show teamspeak<br />
<br />
====Optionnal Firewall settings====<br />
*You could want the web interface to be globaly accessible:<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*You could also want to view your server's activity on your website (if the web server is outside your LAN):<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
You can even use both:<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Allow another server instance on port 8768 (server still needs to be added in the web interface!)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|In server-only mode, you need to forward these ports from your router to your SME!}}<br />
<br />
<br />
To revert to defaults settings, issue following commands:<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Additional information==<br />
*[http://www.goteamspeak.com/ Homepage]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Download section]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Getting Started]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib]]</div>Cool34000https://wiki.koozali.org/index.php?title=File:Tsweb.png&diff=9709File:Tsweb.png2008-05-12T14:50:59Z<p>Cool34000: </p>
<hr />
<div></div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware&diff=9322Egroupware2008-04-23T17:43:24Z<p>Cool34000: /* Update/Upgrade */ new repo fix</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupWare 1.4.002 for SME 7.x and above=<br />
<br />
==Maintainers==<br />
[[User:Berdie/de|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
[[User:Snoopyski|Stéphane Gauvin]]<br/><br />
mailto:sgauvin@serviceinfosg.com<br />
<br />
==Description==<br />
eGroupWare is a [http://www.egroupware.org/philosophy free] enterprise ready groupware software for your network. It enables you to manage contacts, appointments, todos and many more for your whole business.<br />
<br />
eGroupWare is a groupware server. It comes with a native web-interface which allowes to access your data from any platform all over the planet. Moreover you also have the choice to access the eGroupWare server with your favorite groupware client (Kontact, Evolution, Outlook) and also with your mobile or PDA via SyncML.<br />
<br />
eGroupWare is international. At the time, it supports more than [http://www.egroupware.org/languages 25 languages] including rtl support.<br />
<br />
For more information see ''http://www.egroupware.org/''.<br />
<br />
With this RPM you can use eGroupWare on your SME 7.x (and above). You can install it as one single package in a very comfortable way.<br />
<br />
==Installation==<br />
For installation just hit the following command<br />
yum install smeserver-egroupware --enablerepo=smecontribs<br />
<br />
==Update/Upgrade==<br />
'''Please note that this RPM cannot upgrade eGroupWare 1.2.x'''<br />
{{Warning box|'''Because of a bug in old RPM versions'''*''', YOU MUST UNINSTALL THE OLD RPM BEFORE UPDATING WITH THE FOLLOWING COMMAND:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''This will prevent installation files and MySQL to be deleted.'''<br />
<br />
<nowiki>*</nowiki>'' Affected versions are smeserver-egroupware-1.4-10 and older''}}<br />
<br />
Then, you can update your existing 1.4 installation with<br />
yum install smeserver-egroupware --enablerepo=smecontribs<br />
If you were upgrading eGroupWare version (i.e.1.4.001 to 1.4.002) you must finish the upgrade at the Config-Admin Setup with your existing credentials. Then click on upgrade...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Then re-check your install<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
If all went ok, upgrade is done!<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
A backup is done by the RPM before updating. All Files and MySQL DataBase are saved in /opt/eGW_RPM_BACKUP<br />
'''You must move the backup to a safe directory.'''<br />
<br />
This automatic step is just for safety, '''make your own backup before updating/upgrading.'''<br />
<br />
==Uninstallation==<br />
For uninstall just hit the following command<br />
yum remove smeserver-egroupware<br />
In the new release (1.4.002-x), if you want to completly remove eGroupWare from your server, you need the following command:<br />
sh /root/eGW_Full_Uninstall.sh<br />
This will delete eGroupWare's installation files, MySQL DB and SME DB entries.<br />
<br />
==Starting with eGroupWare==<br />
Please perform the Intial Configuration '''FIRST''' before login to eGroupWare.<br />
After that SME users can login to eGroupWare with their used SME account + password. At first login, eGroupWare creates user accounts and passwords automatically and synchronize them to the SME Server.<br />
<br />
===Inital Configuration===<br />
You can find eGroupWare in the ''/opt/egroupware'' directory. For using eGroupWare start your browser with the URL ''http://servername/egroupware/setup'' and logon with the user ''config-admin'' + password ''admin'' at Setup/Config Admin Login.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Now you should create eGroupWare's admin-account. Because eGroupWare uses mail authentication, the admin-account must be a valid SME account/password. This account will be able to use+administrate eGroupWare.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Logout after creating the admin account.<br />
<br />
===Changing passwords for eGW config-admin / header-admin===<br />
Go to your browser and logon with the user ''header-admin'' + password ''admin'' at Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Change the passwords for the users ''config-admin'' and ''header-admin''now:<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Store the new passwords with "Write". <br />
<br />
{{Warning box|For security-reasons, change the passwords for the users ''config-admin'' and ''header-admin'' after your first login !}}<br />
<br />
===Adjusting accessibility===<br />
The default behaviour of eGroupWare is: accessible from LAN + Internet with "forced https" (SSL on + rewrite rule)<br />
You can easily change those defaults settings with following commands:<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Once done, apply modifications and restart Apache:<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronization===<br />
eGroupWare provides '''Synchronization of calender, todo's, notes and addressbook''' with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the ''xmlrpc'' protocol and the ''eGWOSync'' application.<br />
<br />
====MS Outlook Synchronization====<br />
You can sync eGroupWare-Data to MS Outlook as follows:<br />
<br />
'''1. Install certificate with MS Internet Explorer'''<br />
<br />
*Start Internet Explorer<br />
*Enter URL = https://servername<br />
*Enter "show certificate"<br />
*Enter "install certificate" and go on to install your SME certificate<br />
{{Note box|Under Vista, you have to put your domain in the approved website list before being able to install the certificate.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Finish your MS Outlook if active.<br />
*Go to system control, register mail.<br />
*show profiles... -> delete all profiles<br />
*Start MS Outlook, create a new profile with your mail account<br />
<br />
'''3. eGWOSync'''<br />
<br />
Download [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] and [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], if necessary. If your .NET release is newer than version 1.x, you must install both versions on your system.<br />
<br />
*You need .NET Version 1.x, eGWOSync accepts no newer versions<br />
*User/Password = SME user account/password<br />
*Domain = default<br />
*Hostname = SME domain<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = keep default values<br />
*Perform test<br />
<br />
'''4. Funambol'''<br />
<br />
Download Web site: [http://www.funambol.com/opensource Funambol Web Site]<br />
Download Funambol 6.5.7 link [http://download.forge.objectweb.org/sync4j/funambol-outlook-plugin-6.5.7.exe]<br />
<br />
1) Install the last Funambol Plugin<br />
2) Change "7" to "0" for mbstring.func_overload = 0 in php.ini <br />
3) Open Outlook go to the Funambol Setup (Funambol --> Option)<br />
4) Select all items<br />
5) Setup options:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>http://Domain Name/egroupware/rpc.php</nowiki> or <nowiki>http://Server IP/egroupware/rpc.php</nowiki><br />
Username = Your user login name for eGroupWare<br />
Password = Your user password for eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcalendar<br />
Data Format = SIF<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
'''NOTES:'''<br />
<br />
To get success with synchronisation put thoses settings in .htaccess file in the root folder of egroupware (html):<br />
<br />
Run this on PuTTY:<br />
<br />
#db accounts setprop egroupware AllowOverride All<br />
#signal-event ibay-modify egroupware<br />
<br />
'''.htaccess file settings:'''<br />
<br />
*AddType text/xml .xml<br />
*php_value memory_limit 32M<br />
*php_value max_execution_time 60<br />
*php_flag register_globals Off<br />
*php_flag magic_quotes_gpc Off<br />
*php_flag magic_quotes_runtime Off<br />
*php_value upload_max_filesize 16M<br />
*php_flag session.use_trans_sid Off<br />
*php_value session.gc_probability 1<br />
*php_value session.gc_divisor 10<br />
*php_value mbstring.func_overload 7<br />
* <Files rpc.php><br />
* php_value mbstring.func_overload 0<br />
* Order allow,deny<br />
* Allow from all<br />
* </Files><br />
---<br />
--[[User:Snoopyski|Stéphane Gauvin -- Service Informatique SG]] 09:29, 1 March 2008 (MST)<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 September 2007 (MDT)<br />
<br />
====syncml configuration====<br />
<br />
From http://forums.contribs.org/index.php?topic=40242.new;topicseen#new<br />
<br />
Here are the steps to configure syncml with egroupware:<br />
<br />
1. Install php5-cgi as explained in this howto http://sme.firewall-services.com/spip.php?article46 <br />
<br />
(Stop after Step 3, Step 4 is just an example)<br />
<br />
<br />
2. Create a custom-template so that rpc.php is handled by php5:<br />
<br />
vim /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/90egw-syncml<br />
<br />
and enter the following:<br />
<br />
<Location /egroupware/rpc.php><br />
AddHandler php5-cgi .php<br />
Action php5-cgi /php5-cgi/php<br />
</Location><br />
<br />
<br />
3. Edit /etc/php5/php.ini (this file has no templates so you can edit it directly)<br />
<br />
On Line 304<br />
<br />
memory_limit = 8M<br />
<br />
change it to a bigger value, for example<br />
<br />
memory_limit = 32M<br />
<br />
On Line 1191 uncomment the line:<br />
<br />
mbstring.func_overload = 0<br />
<br />
(This may not be useful as php5-cgi has been compiled without mbstring support).<br />
<br />
There is no need for a htaccess file (htaccess could configure php4 because <br />
it's an apache module but not php5-cgi).<br />
<br />
expand-template /etc/httpd/conf/httpd.conf <br />
sv t /service/httpd-e-smith<br />
sv s /service/httpd-e-smith<br />
<br />
To check syntax is OK do:<br />
httpd -t<br />
<br />
syncml has been tested with the Funambol plugin for Outlook (several versions) & works OK.<br />
<br />
==Gallery2 addon==<br />
Gallery2 is the first addon available for eGroupWare 1.4.002<br />
<br />
It has been integrated in smeserver-egroupware-1.4.002-3.noarch.rpm (but not installed by default)<br />
<br />
===Description===<br />
Gallery is an open source web based photo album organizer. Gallery gives you an intuitive way to blend photo management seamlessly into your own website whether you're running a small personal site or a large community site.<br />
<br />
For more information see ''http://gallery.menalto.com/''.<br />
<br />
===Gallery2 install===<br />
First, login at Config setup with your existing creditentials and clic on ''Manage Applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Then simply click on Gallery install checkbox and save your changes.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Gallery2 setup===<br />
Once Installed, you need to configure your website and create the database. This step has been prepared by the RPM install.<br />
<br />
Open your web browser at ''https://yourdomain.com/egroupware/gallery/gallery2/install'' and follow instructions.<br />
<br />
In the 4th step, you will be asked for a storage folder. RPM install has prepared ''/opt/egroupware/files/g2data'', please don't change neither path nor permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
In the 5th step, you will be asked for MySQL informations. RPM install has prepared ''egwuser'' ''egroupware'' and your DbPassword automatically. Just save and finish the install.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Gallery2 icon===<br />
Once the setup is done you can add the icon in eGroupWare's interface.<br />
Login to eGroupWare with an admin account, and edit a user or a group and add gallery<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|The gallery can also be accessed with no authentication at ''https://yourdomain.com/egroupware/gallery/gallery2''}}<br />
<br />
==Additional information==<br />
<br />
*[http://www.egroupware.org eGroupWare Homepage]<br />
*[http://gallery.menalto.com/ Gallery Homepage]<br />
*[http://www.egroupware.org/wiki eGroupWare Documentation]<br />
*[http://www.egroupware.org/index.php?page_name=wiki&wikipage=ManualSetupUpdate Howto Update eGroupWare]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]<br />
<br />
<br />
Have much fun with eGroupWare as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Groupware]]<br />
[[Category: Webapps]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/fr&diff=9321Egroupware/fr2008-04-23T17:42:36Z<p>Cool34000: /* Mise à jour */ new repo fix</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupware 1.4.002 pour SME 7.x=<br />
<br />
==Mainteneurs==<br />
[[User:Berdie/fr|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
eGroupWare est un logiciel Collaboratif professionel et gratuit. Il vous permet de gérer vos contacts, vos rendez-vous, vos taches, et bien plus pour toute votre activité.<br />
eGroupWare est un serveur Collaboratif (groupware). Il est conçu nativement avec une interface Web qui vous permet d'accéder à vos données de n'importe quel plate-forme sur la planète.<br />
Vous avez le choix d'accéder au serveur eGroupWare avec votre client groupware préféré (Kontact, Evolution, Outlook) ainsi qu'avec votre téléphone portable ou votre PDA, par SyncML.<br />
<br />
eGroupWare est international. A ce jour, il supporte plus de [http://www.egroupware.org/languages 25 languages] incluant le support rtl.<br />
<br />
Pour plus d'informations, visitez ''http://www.egroupware.org/''.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-egroupware --enablerepo=sme-contribs<br />
<br />
==Mise à jour==<br />
{{Warning box|'''A cause d'un bug dans les vieilles versions du RPM'''*''', VOUS DEVEZ DESINSTALLER LE VIEUX RPM AVANT LA MISE A JOUR AVEC LA COMMANDE SUIVANTE:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Ceci empêchera que les fichiers d'installation et la base de données MySQL soient supprimés.'''<br />
<br />
<nowiki>*</nowiki>'' Versions affectées: smeserver-egroupware-1.4-10 et antérieures''}}<br />
<br />
Vous pouvez alors mettre à jour votre version 1.4 existante avec la commande suivante:<br />
yum install smeserver-egroupware --enablerepo=smecontribs<br />
Si vous mettez à jour la version d'eGroupWare (par exemple v1.4.001 vers v1.4.002) vous devez terminer la mise à jour dans Config-Admin Setup avec vos identifiants existants. Cliquez sur mettre à jour...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Revérifiez l'installation<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Si tout s'est bien passé, la mise à jour de version est effectuée !<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Une sauvegarde est effectuée par le RPM avant la mise à jour. Tous les fichiers et la base de données MySQL DataBase sont sauvegardés dans /opt/eGW_RPM_BACKUP<br />
'''Vous devez déplacer cette sauvegarde dans un endroit plus sur.'''<br />
<br />
Cette étape automatique est juste une sécurité, '''effectuez vos propres sauvegardes avant de mettre à jour.'''<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-egroupware<br />
Dans la nouvelle release (1.4.002-x), si vous souhaitez supprimer définitivement eGroupWare de votre serveur, vous devez taper la commande suivante:<br />
sh /root/eGW_Full_Uninstall.sh<br />
Ceci supprimera les fichiers d'installation d'eGroupWare, la base de données MySQL et les entrées dans la base de données de SME.<br />
<br />
==Démarrer avec eGroupWare==<br />
Veuillez effectuer la configuration initiale '''AVANT''' de vous connecter à eGroupware.<br />
Après cette étape, les utilisateurs SME pourront se connecter avec leurs login + mot de passe SME.<br />
A la 1ere connexion d'un utilisateur SME valide, le compte est automatiquement créé dans eGroupware.<br />
<br />
===Configuration initiale===<br />
Vous trouverez les fichiers d'installation de la dossier ''/opt/egroupware''. Pour terminer la configuration d'eGroupware, ouvrez votre navigateur à l'adresse ''https://votredomaine.com/egroupware/setup'' et connectez vous avec l'utilisateur ''config-admin'' + mot de passe ''admin'' dans Setup/Config Admin.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Vous devez maintenant créer le compte d'administration d'eGroupware. Utilisez un compte existant de SME (même utilisateur et même mot de passe), par exemple l'admin (déconseillé pour des raisons de sécurité) pour pouvoir envoyer et recevoir les mails administratifs dans eGroupware.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Déconnectez vous après avoir créé le compte d'administration.<br />
<br />
===Changement des mots de passe de config-admin / header-admin===<br />
Ouvrez votre navigateur et connectez vous avec l'utilisateur ''header-admin'' et le mot de passe ''admin'' à Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Changez les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' maintenant :<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Enregistrez vos changements en cliquant sur "Ecrire".<br />
<br />
{{Warning box|Pour des raisons de sécurité, veuillez changer les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' dès votre 1ère connexion !}}<br />
<br />
===Paramétrage de l'accessibilité===<br />
Le comportement par défaut d'eGroupware est : accessible depuis le LAN + Internet avec https "forcée" (SSL + rewrite rule).<br />
<br />
Vous pouvez facilement modifier ce comportement par défaut avec les commandes suivantes :<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Une fois les changements effectués, appliquez les modifications et redémarrez Apache :<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronisation===<br />
<br />
eGroupware fournit '''la synchronisation du calendrier, des tâches, des notes et du carnet d'adresse''' pour des clients comme MS Outlook et les PDA. Malheureusement, il faut php5 pour que cela fonctionne et cela n'est pas implémenté sur SME 7.x. En fait, il est possible de synchroniser Outlook avec le protocole ''xmlrpc'' et le logiciel ''eGWOSync''.<br />
<br />
====Synchronisation de MS Outlook====<br />
<br />
Vous pouvez synchroniser les données d'eGroupware avec Outlook en suivant ces étapes:<br />
<br />
'''1. Installez le certificat dans MS Internet Explorer'''<br />
<br />
*Démarrez Internet Explorer<br />
*Allez à l'adresse https://votredomaine.com<br />
*Cliquez sur "Afficher les certificats"<br />
*Cliquez sur "Installer le certificat" et terminez l'assitant d'installation du certificat<br />
{{Note box|Sous Vista, vous devez ajouter votre domaine à la liste des sites approuvés pour être capable d'accéder à l'installation du certificat.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Fermez MS Outlook s'il est ouvert.<br />
*Dans le panneau de configuration, allez dans les options de messagerie.<br />
*Afficher les profils... -> supprimer tous les profils<br />
*Redémarrez MS Outlook, créez un nouveau profile avec votre compte mail<br />
<br />
'''3. eGWOSync'''<br />
<br />
Téléchargez [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] et [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], si nécessaire.<br />
<br />
*Vous avez besoin de .NET Version 1.x, si vous avez déja une version supérieure, vous devrez également installer .NET 1.x<br />
*User/Password = compte utilisateur/mots de passe SME<br />
*Domain = default<br />
*Hostname = domaine SME<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = laisser par défaut<br />
*Faire le test<br />
<br />
'''4. Funambol'''<br />
<br />
Page de téléchargement de [http://www.funambol.com/opensource Funambol]<br />
<br />
Lien direct vers [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14]<br />
<br />
1) Ouvrez Outlook et allez dans le paramétrage de Funambol (Funambol --> Option)<br />
4) Selectionnez tous les items<br />
5) Options de paramétrage:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>https://votredomaine.com/egroupware/rpc.php</nowiki> ou <nowiki>https://IP Serveur/egroupware/rpc.php</nowiki><br />
Username = Votre utilisateur eGroupWare<br />
Password = Votre mot de passe eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 Septembre 2007 (MDT)<br />
<br />
==Addon Gallery2==<br />
Gallery2 est le 1er addon disponible pour eGroupWare 1.4.002<br />
<br />
Il a été intégré dans smeserver-egroupware-1.4.002-3.noarch.rpm (mais non installé par défaut)<br />
<br />
===Description===<br />
Gallery est une application web open source d'organisation d'albums photos. Gallery vous donne une façon intuitive d'intégrer la gestion de photos uniformement dans votre site web, que vous ayez un petit site personel ou une plus large communauté.<br />
<br />
Pour plus d'informations, visitez ''http://gallery.menalto.com/''.<br />
<br />
===Installation de Gallery2===<br />
Pour commencer, connectez vous au Config setup avec votre utilisateur config-admin et son mot de passe et cliquez sur ''Gérer les applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Cochez simplement la case d'installation de Gallery et sauvegardez.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Configuration de Gallery2===<br />
Une fois installé, vous devez paramétrer votre site web et créer la base de données. Cette étape a été préparée par le RPM d'installation.<br />
<br />
Ouvrez votre navigateur à l'adresse ''https://yourdomain.com/egroupware/gallery/gallery2/install'' et suivez les instructions.<br />
<br />
Dans la 4ème étape, le chemin vers le dossier de stockage est demandé. L'installation du RPM a préparé ''/opt/egroupware/files/g2data'', veuillez ne pas changer le chemin et les permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
Dans la 5ème étape, les informations MySQL sont demandées. L'installation du RPM a préparé ''egwuser'' ''egroupware'' et votre ''DbPassword'' automatiquement. Cliquez simplement sur sauvegarder et finissez l'installation.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Icone Gallery2===<br />
Une fois la configuration terminée, vous pouvez ajouter l'icone dans l'interface d'eGroupWare.<br />
Connectez vous à eGroupWare avec un compte admin et éditez un utilisateur ou un groupe pour lui ajouter l'application Gallery.<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|Gallery peut être accédé sans authentification à l'adresse ''https://votredomaine.com/egroupware/gallery/gallery2''}}<br />
<br />
==Informations supplémentaire==<br />
<br />
*[http://www.egroupware.org Site web d'eGroupWare]<br />
*[http://gallery.menalto.com/ Site web de Gallery]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 topic sur le forum de contribs.org]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 topic sur le forum de contribs.org]<br />
<br />
Have much fun with eGroupware as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Groupware/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server/fr&diff=9320TeamSpeak Server/fr2008-04-23T17:27:50Z<p>Cool34000: new repo fix</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
=TeamSpeak Server 2.0.24.1 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak est une application de qualité et évolutive qui permet aux personnes de parler entre eux sur Internet. TeamSpeak est consistué d'une partie serveur et cliente. Le serveur agit comme un hôte pour des connexions clientes multiples, capable de gérer littéralement des milliers d'utilisateurs simultanés. Le résultat est une solution de téléconférence par Internet qui ouvre les portes d'applications comme la conversation de coéquipiers pour le jeu en ligne, la réduction des couts pour les entreprises qui font des communications longues distances ou encore la conversation entre amis ou la famille.<br />
<br />
Pour plus d'informations, visitez ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
L'utilisation est gratuite à des fins non commerciales.<br />
Merci de lire leur [http://www.goteamspeak.com/index.php?page=faq FAQ] pour plus d'informations sur les licences et les conditions d'utilisations.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-teamspeak-server --enablerepo=smecontribs<br />
<br />
==Mise à jour==<br />
Ce RPM ne peut pas être mis à jour, veuillez désinstaller l'ancienne version avant d'installer la nouvelle.<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante <br />
yum remove smeserver-teamspeak-server<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un signal event ''post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
===Partie client===<br />
*Téléchargez la dernière version du client (TS est disponible pour toutes les plateformes)<br />
*Connectez vous au serveur avec le client et profitez !<br />
<br />
===Partie serveur===<br />
{{Note box|En mode server-only, vous devez translater le port UDP 8767 de votre routeur vers votre SME !}}<br />
====Administration====<br />
*La page d'administration de TeamSpeak Server est accessible à l'adresse http://your-sme-server-name:14534 (Depuis le LAN seulement !)<br />
Vous aurez besoin des mots de passes admin et superadmin qui peuvent être récupérés en tapant la commande suivante au prompt<br />
service teamspeak passwords<br />
<br />
====Bannière personnalisée====<br />
Si vous voulez une bannière personnalisée, éditez le fichier '''''/opt/teamspeak/server.ini''''' et ajoutez les lignes suivantes à la fin du fichier :<br />
[ISP] <br />
GFX URL=http://lien_vers_image/banniere.jpg<br />
La bannière DOIT ETRE au format JPG (150x80 pixels maxi)<br />
<br />
==Ligne de commandes==<br />
Le service TeamSpeak accepte les arguments suivants :<br />
service teamspeak {start|stop|restart|status|passwords}<br />
Pour voir la configuration complète du service TeamSpeak :<br />
config show teamspeak<br />
<br />
====Réglages optionnels du Firewall====<br />
*Vous pourriez avoir besoin de rendre l'interface web globalement accessible :<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*Vous pourriez avoir besoin de visionner l'activité du serveur sur votre site web (code php non documenté ici) :<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
Vous pouvez même utiliser les 2 :<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Ajouter une instance serveur sur le port 8768 (le serveur doit être déclaré dans l'interface web !)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|En mode server-only, vous devez translater ces ports de votre routeur vers votre SME !}}<br />
<br />
Pour revenir aux réglages par défaut, tapez les commandes suivantes :<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Informations additionnelles==<br />
*[http://www.goteamspeak.com/ Page d'accueil]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Section téléchargement]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Démarrage]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server/fr&diff=9319TeamSpeak Server/fr2008-04-23T17:26:11Z<p>Cool34000: new repo fix</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
=TeamSpeak Server 2.0.24.1 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak est une application de qualité et évolutive qui permet aux personnes de parler entre eux sur Internet. TeamSpeak est consistué d'une partie serveur et cliente. Le serveur agit comme un hôte pour des connexions clientes multiples, capable de gérer littéralement des milliers d'utilisateurs simultanés. Le résultat est une solution de téléconférence par Internet qui ouvre les portes d'applications comme la conversation de coéquipiers pour le jeu en ligne, la réduction des couts pour les entreprises qui font des communications longues distances ou encore la conversation entre amis ou la famille.<br />
<br />
Pour plus d'informations, visitez ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
L'utilisation est gratuite à des fins non commerciales.<br />
Merci de lire leur [http://www.goteamspeak.com/index.php?page=faq FAQ] pour plus d'informations sur les licences et les conditions d'utilisations.<br />
<br />
==Téléchargement==<br />
Vous pouvez télécharger ce paquetage ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/teamspeak/smeserver-teamspeak-server-2.0.24.1-1.noarch.rpm ici]''. Si vous voulez le sauvegarder directement sur votre serveur SME Server, voici les commandes à exécuter au prompt <br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/teamspeak/smeserver-teamspeak-server-2.0.24.1-1.noarch.rpm<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-teamspeak-server --enablerepo=smecontribs<br />
<br />
==Mise à jour==<br />
Ce RPM ne peut pas être mis à jour, veuillez désinstaller l'ancienne version avant d'installer la nouvelle.<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante <br />
yum remove smeserver-teamspeak-server<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un signal event ''post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
===Partie client===<br />
*Téléchargez la dernière version du client (TS est disponible pour toutes les plateformes)<br />
*Connectez vous au serveur avec le client et profitez !<br />
<br />
===Partie serveur===<br />
{{Note box|En mode server-only, vous devez translater le port UDP 8767 de votre routeur vers votre SME !}}<br />
====Administration====<br />
*La page d'administration de TeamSpeak Server est accessible à l'adresse http://your-sme-server-name:14534 (Depuis le LAN seulement !)<br />
Vous aurez besoin des mots de passes admin et superadmin qui peuvent être récupérés en tapant la commande suivante au prompt<br />
service teamspeak passwords<br />
<br />
====Bannière personnalisée====<br />
Si vous voulez une bannière personnalisée, éditez le fichier '''''/opt/teamspeak/server.ini''''' et ajoutez les lignes suivantes à la fin du fichier :<br />
[ISP] <br />
GFX URL=http://lien_vers_image/banniere.jpg<br />
La bannière DOIT ETRE au format JPG (150x80 pixels maxi)<br />
<br />
==Ligne de commandes==<br />
Le service TeamSpeak accepte les arguments suivants :<br />
service teamspeak {start|stop|restart|status|passwords}<br />
Pour voir la configuration complète du service TeamSpeak :<br />
config show teamspeak<br />
<br />
====Réglages optionnels du Firewall====<br />
*Vous pourriez avoir besoin de rendre l'interface web globalement accessible :<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*Vous pourriez avoir besoin de visionner l'activité du serveur sur votre site web (code php non documenté ici) :<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
Vous pouvez même utiliser les 2 :<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Ajouter une instance serveur sur le port 8768 (le serveur doit être déclaré dans l'interface web !)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|En mode server-only, vous devez translater ces ports de votre routeur vers votre SME !}}<br />
<br />
Pour revenir aux réglages par défaut, tapez les commandes suivantes :<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Informations additionnelles==<br />
*[http://www.goteamspeak.com/ Page d'accueil]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Section téléchargement]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Démarrage]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=TeamSpeak_Server&diff=9318TeamSpeak Server2008-04-23T17:24:56Z<p>Cool34000: new repo fix</p>
<hr />
<div>{{Languages|TeamSpeak_Server}}<br />
=TeamSpeak Server 2.0.24.1 for SME 7.x=<br />
<br />
==Maintainer==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
TeamSpeak is a quality, scalable application which enables people to speak with one another over the Internet. TeamSpeak consists of both client and server software. The server acts as a host to multiple client connections, capable of handling literally thousands of simultaneous users. This results in an Internet based teleconferencing solution that works in a variety of applications such as team mates speaking with one another while playing their favorite online game, small businesses cutting costs on long distance charges, or for personal communication with friends and family.<br />
For more information see ''http://www.goteamspeak.com/''.<br />
<br />
==Licence==<br />
TeamSpeak is free of charge to non-commercial users.<br />
Please see their [http://www.goteamspeak.com/index.php?page=faq FAQ] for more information on licensing and terms of use.<br />
<br />
==Installation==<br />
For installation just hit the following command<br />
yum install smeserver-teamspeak-server --enablerepo=smecontribs<br />
==Update==<br />
This RPM is not updatable. Please uninstall old version before installing the new one.<br />
<br />
==Uninstallation==<br />
For uninstall just hit the following command<br />
yum remove smeserver-teamspeak-server<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
==Use==<br />
===Client side===<br />
*Download and install latest TeamSpeak client (TS is available on all platforms)<br />
*Connect to your server with the client and enjoy!<br />
<br />
===Server side===<br />
{{Note box|In server-only mode, you will have to forward UDP port 8767 from your router to your SME!}}<br />
====Administration====<br />
*The webpage for administrating TeamSpeak Server is at http://your-sme-server-name:14534 (LAN only by default!)<br />
You will need admin and superadmin passwords which can be retrieved by typing this command at a linux-prompt<br />
service teamspeak passwords<br />
<br />
====Custom banner====<br />
If you want a custom banner, edit '''''/opt/teamspeak/server.ini''''' and add following lines at the end of the file:<br />
[ISP] <br />
GFX URL=http://link_to_image/banner.jpg<br />
Banner logo MUST BE JPG (150x80 pixels max)<br />
<br />
====Commandline====<br />
TeamSpeak's service accepts following commands:<br />
service teamspeak {start|stop|restart|status|passwords}<br />
To view the full configuration of TeamSpeak service:<br />
config show teamspeak<br />
<br />
====Optionnal Firewall settings====<br />
*You could want the web interface to be globaly accessible:<br />
db configuration setprop teamspeak TCPPort 14534<br />
signal-event remoteaccess-update<br />
*You could also want to view your server's activity on your website (php code not documented here):<br />
db configuration setprop teamspeak TCPPort 51234<br />
signal-event remoteaccess-update<br />
You can even use both:<br />
db configuration setprop teamspeak TCPPort 14534,51234<br />
signal-event remoteaccess-update<br />
*Allow another server instance on port 8768 (server still needs to be added in the web interface!)<br />
db configuration setprop teamspeak UDPPort 8767,8768<br />
signal-event remoteaccess-update<br />
{{Note box|In server-only mode, you need to forward these ports from your router to your SME!}}<br />
<br />
<br />
To revert to defaults settings, issue following commands:<br />
db configuration delprop teamspeak TCPPort<br />
db configuration setprop teamspeak UDPPort 8767<br />
signal-event remoteaccess-update<br />
<br />
==Additional information==<br />
*[http://www.goteamspeak.com/ Homepage]<br />
*[http://www.goteamspeak.com/index.php?page=downloads Download section]<br />
*[http://www.goteamspeak.com/index.php?page=faq FAQ]<br />
*[http://www.goteamspeak.com/index.php?page=getstarted Getting Started]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
<br />
----<br />
[[Category: Contrib]]</div>Cool34000https://wiki.koozali.org/index.php?title=OCS_Inventory_Tools/fr&diff=9317OCS Inventory Tools/fr2008-04-23T17:19:58Z<p>Cool34000: /* Installation du serveur */ new repo fix</p>
<hr />
<div>{{Languages|OCS Inventory Tools}}<br />
<br />
=Maintaineur=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
Remerciement spécial à [http://remi.collet.free.fr/ Rémi Collet] qui a fourni un Agent Linux OCS unifié fonctionnel (et bien plus !)<br />
<br />
Un gros merci également à Didier Liroulet et la team OCS pour sa documentation sans failles (Voir '''''/opt/inventory/ocs/ocsreports/files/guide.pdf''''')<br />
<br />
Et pour finir, merci à [[User:Snoble|Stefen Noble]] pour les tests, le temps passé et l'aide fournie !<br />
<br />
=Outils d'Inventaire pour SME 7.x=<br />
<br />
==Description d'OCS Inventory NG==<br />
Open Computer and Software Inventory Next Generation est une application déstinée pour aider l'administrateur système ou réseau à garder un oeil sur la configuration des machines du réseau et sur les logiciels qui y sont installés.<br />
Les informations sur le matériel et les systèmes d'exploitations sont collectés.<br />
Utilisé en combinaison avec des logiciels de gestion de ressources informatiques comme l'outil open source GLPI, vous disposerez d'un inventaire et d'une gestion de vos ressources puissante avec mises à jour automatique de la configuration des ordinateurs, gestion des licences, help desk et bien plus.<br />
<br />
Pour plus d'informations visitez ''http://www.ocsinventory-ng.org/''.<br />
<br />
==Description de GLPI==<br />
GLPI est une application libre, distribuée sous licence GPL destinée à la gestion de parc informatique et de helpdesk.<br />
GLPI est composé d’un ensemble de services web écrits en PHP qui permettent de recenser et de gérer l’intégralité des composantes matérielles ou logicielles d’un parc informatique, et ainsi d’optimiser le travail des techniciens grâce à une maintenance plus cohérente.<br />
<br />
Pour plus d'informations, visitez ''http://www.glpi-project.org/''.<br />
<br />
=Installation du serveur=<br />
==Téléchargement==<br />
Vous aurez besoin de ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz quelques dépendances]''.<br />
<br />
Si vous voulez le sauvegarder directement sur votre serveur SME Server, voici les commandes à exécuter au prompt :<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz<br />
<br />
==Installation==<br />
Pour commencer, vous devez installer les dépendances.<br />
<br />
Selon votre version de SME (7.1.? et antérieur), vous aurez besoin d'installer mod_perl et de mettre à jour perl-Compress-Zlib<br />
yum localinstall mod_perl<br />
yum update perl-Compress-Zlib<br />
Les autres dépendances Perl ont étés packagées dans un fichier pour plus de facilité. Décompressez simplement le dossier et installez les RPMs en utilisant YUM :<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*.rpm<br />
Enfin, installez OCS Reports et GLPI avec la commande suivante :<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un ''signal event post-upgrade'' et un ''signal-event reboot''.<br />
<br />
La documentation complète peut être trouvée [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf ici].<br />
<br />
Par soucis d'économie de bande passante, ce fichier n'est plus inclus dans le RPM à partir de la version ''1-6''. Veuillez télécharger ce fichier séparemment et copier le dans ''/opt/inventory/ocs/ocsreports/files/''. Vous pouvez utilisez les commandes suivantes pour le téléchargement :<br />
cd /opt/inventory/ocs/ocsreports/files/<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf<br />
{{Note box|Tant que ce fichier ne sera pas au bon endroit, l'icone d'aide de l'interface web d'ocs ne fonctionnera pas.}}<br />
<br />
==Mise à jour==<br />
===Anciens RPMs===<br />
La mise à jour des vieux RPMs ('''''smeserver-ocs_inventory_ng''''' et '''''smeserver-glpi''''') n'est pas possible.<br />
<br />
'''Vous devez désinstaller les 2 RPMs avant de commencer !'''<br />
<br />
Si vous souhaitez conserver vos anciennes données, vous devez désinstaller les vieilles versions avec les commandes suivantes :<br />
rpm -e smeserver-glpi --noscripts<br />
rpm -e smeserver-ocs_inventory_ng --noscripts<br />
Il y a 3 nouvelles dépendances, vous devez donc les installer. Ces RPMs sont dans [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz l'archive Tarball].<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*remi*.rpm<br />
<br />
Puis installez la nouvelle version avec la commande suivante :<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
<br />
===Nouveau RPM===<br />
La mise à jour du nouveau RPM ('''''smeserver-inventory-tools''''') est possible.<br />
<br />
Utiliser YUM pour la mise à jour :<br />
yum update smeserver-inventory-tools --enablerepo=smecontribs<br />
<br />
==Commandes spéciales==<br />
Pour voir la configuration d'OCS et GLPI, vous pouvez taper les commandes suivantes :<br />
config show ocs<br />
config show glpi<br />
Vous pouvez changer quelques paramètres :<br />
Paramètre DB | Options | Default | Explication<br />
# HTTPS | on/off | off | active/désactive le mode https forcé des interfaces web<br />
# PublicAccess | local/global | local | Accessibilité des interfaces web<br />
# MaxUpload | xM | 100M | Taille maximum des fichiers à uploader<br />
# InventoryAccess | local/global | global | Accessibilité du serveur OCS (pour recevoir les inventaires)<br />
# InventoryDelay | >1 | 600 | Temps d'attente (sec) pour éviter les surcharges serveur(cron de l'Agent)<br />
# URL | nouvel alias | | Alias optionnels pour les interfaces web d'ocs et de glpi<br />
Après avoir modifié la configuration d'OCS et/ou GLPI, vous devez appliquez vos modifications en tapant la commande suivante :<br />
signal-event domain-modify<br />
Cela apportera les modifications nécessaires aux templates et services en une seule commande !<br />
<br />
exemple:<br />
config setprop ocs HTTPS on PublicAccess global<br />
config setprop glpi HTTPS on PublicAccess global<br />
signal-event domain-modify<br />
<br />
==Désinstallation==<br />
Pour désinstaller OCS Reports et GLPI, tapez la commande suivante :<br />
yum remove smeserver-inventory-tools<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un ''signal event post-upgrade'' et un ''signal-event reboot''.<br />
<br />
Pour supprimer complètement OCS Reports et GLPI (fichiers d'installation; utilisateur et base de données MySQL; l'Agent Linux), tapez la commande suivante :<br />
sh /root/OCS_GLPI-Full-Uninstall.sh<br />
Vous devrez également désinstaller les dépendances si vous ne les utilisez plus...<br />
<br />
=Installation du client=<br />
La partie cliente est disponible pour [http://www.ocsinventory-ng.org/index.php?page=1-01 toutes les plateformes].<br />
<br />
Téléchargez la dernière version en fonction de votre système d'exploitation.<br />
<br />
Après avoir installé l'agent, vous devriez le lancer manuellement pour envoyer votre 1er inventaire (puisqu'il est mis à jour 1 seule fois par jour par défaut)<br />
<br />
==Agent OCS pour SME 7.x==<br />
===Avec ''smeserver-inventory-tools''===<br />
La partie cliente d'OCS sera déja installée si vous avez installé ''smeserver-inventory-tools''.<br />
<br />
Vous devriez voir l'inventaire de votre serveur SME dans l'interface web d'OCS après l'installation du RPM.<br />
<br />
Si vous avez mis à jour à partir des anciens RPMs, tapez la commande suivante pour lancer le 1er inventaire:<br />
ocsinventory-agent -s localhost<br />
<br />
'''Ne modifiez pas ''/etc/ocsinventory-agent/ocsinv.conf'', ce fichier utilise le système de templates de SME dans l'installation complète du RPM.'''<br />
<br />
===Sans ''smeserver-inventory-tools''===<br />
Si vous souhaitez inventorier d'autres serveurs SME (sans installer la partie serveur et les sites web), vous aurez besoin de ces 3 RPMs (présents dans l'archive Tarball) :<br />
*monitor-edid-1.11-1.el4.remi.i386.rpm<br />
*ocsinventory-agent-0.0.6-1.el4.remi.noarch.rpm<br />
*ocsinventory-ipdiscover-1.01-2.el4.remi.i386.rpm<br />
Editez ''/etc/ocsinventory-agent/ocsinv.conf'' et modifiez les lignes suivantes :<br />
OCSSERVER=votredomaine.com<br />
OCSTAG=votre_tag<br />
Redémarrez crond puisque cela n'est pas effectué par ces RPMs :<br />
/etc/rc.d/init.d/crond restart<br />
Enfin, lancez le 1er inventaire manuellement :<br />
ocsinventory-agent -s votredomaine.com -t votre_tag<br />
<br />
==Agent OCS pour Windows==<br />
Il y a 2 différentes manières d'envoyer des inventaires sous Windows. Téléchargez la dernière version du client (OCSNG_WIN32_AGENT_1.xx_repack.zip) depuis le site d'ocs. Cette archive contient 3 exécutables. <br />
<br />
Reportez vous à la section 4.1 du fichier d'aide d'OCS.<br />
===Utilisation du service===<br />
Utiliser OCS en tant que service est probablement ce que vous aurez besoin.<br />
<br />
Lancez l'installation d'''OcsAgentSetup.exe'' et fournissez le paramétrage par défaut du service.<br />
[[Image:OCS-winagent-setup.png]]<br><br />
----<br />
Lancez le 1er inventaire en tapant la commande suivante dans la fenêtre 'exécuter' :<br />
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:votre_tag<br />
Attendez quelques secondes et allez sur http://votre-serveur/ocs, vous devriez voir votre 1er inventaire !<br />
<br />
Par défaut, l'Agent contactera le Serveur 1 fois par jour.<br />
<br />
Vous pouvez modifier ce paramètre par défaut dans les options de l'interface web d'OCS. Vos changements seront appliqués la prochaine fois que l'Agent recontactera le Serveur.<br />
----<br />
Pour tout problème, vérifiez le log dans ''C:\Program Files\OCS Inventory Agent\NOM_ORDINATEUR.log''<br />
===Utilisation du lanceur seul===<br />
Vous pouvez également faire vos inventaires sans installer le service.<br />
<br />
Le lanceur d'OCS est découpé en 2 fichiers exécutables:<br />
*''ocsagent.exe'' - Cet exécutable contient tous les fichiers nécessaire au fonctionnement du lanceur.<br />
*''OcsLogon.exe'' - Cet exécutable est le lanceur<br />
<br />
Bien entendu, ''ocsagent.exe'' doit être décompressé avant d'exécuter le lanceur.<br />
<br />
Ceci peut être effectué en exécutant directement ''ocsagent.exe'' : les fichiers se décompresseront dans ''c:\ocs-ng\''.<br />
<br />
Vous pouvez aussi importer ce fichier dans la base de données MySQL d'ocs pour que le lanceur le télécharge si besoin. Ceci est documenté dans [http://wiki.contribs.org/index.php?title=OCS_Inventory_Tools&action=submit#MySQL_importation la section Importation MySQL].<br />
<br />
Les commandes sont les même qu'avec le service :<br />
"C:\Chemin_vers\OcsLogon.exe" /server:votredomaine.com /np /debug /tag:votre_tag<br />
Pour des inventaires encore plus rapides et faciles, vous pouvez également renommer le lanceur en utilisant votre nom de domaine : (n'oubliez pas .exe)<br />
"C:\Chemin_vers\votredomaine.com'''.exe'''" /np /debug /tag:votre_tag<br />
----<br />
Pour tout problème, vérifiez le log dans ''C:\ocs-ng\NOM_ORDINATEUR.log''<br />
----<br />
<br />
===Importation d'''ocsagent.exe'' dans MySQL===<br />
Le principal avantage de cette méthode est que vous pouvez envoyer le lanceur par Internet rapidement ou le mettre sur une disquette (il ne pèse que 65Ko !) Votre lecteur de disquette va vous parraitre bien plus puissant après ca !<br />
<br />
Cela permet également de mettre à jour les fichiers présents dans ''ocsagent.exe'' sur les postes clients (qui utilisent le service ou le lanceur seul).<br />
<br />
Un [http://prdownloads.sourceforge.net/ocsinventory/OCSNG_PACKAGER_1.01.zip?download packager] est disponible sur le site d'ocs pour recréer ce fichier avec vos modifications (un certificat SSL par exemple !)<br />
[[Image:OCS-packager.png]]<br><br />
----<br />
La 1ère chose à faire et de copier ''ocsagent.exe'' (modifié ou non) dans '''''/opt/inventory/ocs/ocsreports/files/'''''.<br />
<br />
L'installeur est bloqué (install.php), vous devez le débloquer avec la commande suivante :<br />
chmod 660 /opt/inventory/ocs/ocsreports/dbconfig.inc.php<br />
Ensuite, vous devez importer ce fichier dans la base de données d'OCS. Rendez-vous à l'adresse http://votredomaine.com/ocs/install.php<br />
<br />
Utilisez le compte ocs pré-configuré pour cela :<br />
[[Image:OCS-installphp.png]]<br><br />
----<br />
Si vous obtenez un message d'erreur (cannot alter database), rafraichissez la page et vous devriez voir un import réussi.<br />
[[Image:OCS-installphp-ocsagent.png]]<br><br />
----<br />
Le fichier ''ocsagent.exe'' est maintenant importé.<br />
<br />
<br />
{{Warning box|install.php remettra le mot de passe d'ocs à sa valeur d'origine ('ocs'). Appliquez vos modifications avec la commande suivante :<br />
signal-event domain-modify<br />
Cela remettra également les permissions à 440 sur le fichier ''dbconfig.inc.php''<br />
}}<br />
Vous pouvez maintenant utiliser ''OcsLogon.exe'' seul, il se chargera de télécharger ''ocsagent.exe'' si nécessaire !<br />
<br />
Si vous voulez désinstaller ''ocsagent.exe'' de votre base de données, effacez simplement le fichier du serveur et relancez ''install.php''. Ceci supprimera le fichier de la base de données.<br />
<br />
==Agent OCS pour Linux==<br />
Téléchargez le client générique linux tar.gz, décompressez le, lisez le fichier README, puis en tant que root, lancez le script de setup.<br />
<br />
Des dépendances Perl supplémentaires sont requises, utilisez votre gestionnaire de packets pour trouver les dépendances manquantes à l'aide du README (ou des messages d'erreurs de dépendances). Reportez vous à la section 4.2 du fichier d'aide d'OCS.<br />
<br />
Pour lancer un inventaire<br />
ocsinventory-client.pl -server=server.net -tag=network3<br />
<br />
Vérifiez l'heure d'exécution de la tâche planifiée et ses options dans<br />
/etc/cron.d/ocsinventory-client<br />
<br />
=Utilisation d'OCS Inventory NG=<br />
Reportez vous au fichier d'aide pour des détails supplémentaires.<br />
==Accès==<br />
L'interface web d'OCS Reports est accessible à l'adresse http://votre-serveur/ocs<br />
<br />
'''Avant de vous connecter, choisissez votre langue (les drapeaux dans le coin supérieur droit)'''<br />
[[Image:OCS_login_page.png]]<br><br />
Login : admin<br><br />
Password: admin<br />
<br />
{{Warning box|type=warning|Pour des raisons de sécurité, veuillez changer le mot de passe admin après votre 1ère connexion !}}<br />
Les inventaires peuvent être réalisés depuis Internet mais l'interface web est seulement disponible de l'intérieur de votre réseau pour plus de sécurité par défaut.<br />
<br />
Reportez vous aux sections 5 & 6 du fichier d'aide d'OCS.<br />
<br />
==Découverte IP==<br />
La fonctionnalité de découverte IP (IP discovery) permet à OCS Inventory NG de découvrir tous les périphériques réseaux connectés à votre réseau.<br />
Pour cela, le serveur de communication demande aux ordinateurs les plus actifs exécutant l'agent OCS Inventory NG de scanner des adresse MAC de leur sous-réseaux à chaque lancement.<br />
Reportez vous à la section 7 du fichier d'aide d'OCS.<br />
<br />
===Modification du comportement par défault===<br />
Vous pourriez vouloir modifier le comportement par défaut de la découverte IP.<br />
<br />
Pour forcer un ordinateur à découvrir, ouvrez simplement son inventaire. Cliquez sur l'icone ''Traitements personnalisés'' puis ''Modifiez'' le comportement IpDiscover.<br />
[[Image:OCS-ipdiscover-step1.png]]<br><br />
----<br />
Choisissez l'adresse IP de l'ordinateur sélectionné et validez vos changements.<br />
[[Image:OCS-ipdiscover-step2.png]]<br><br />
----<br />
Vous devriez voir vos modifications.<br />
<br />
[[Image:OCS-ipdiscover-step3.png]]<br><br />
A ce stade, IpDiscover sera exécuté au prochain lancement de l'agent !<br />
<br />
'''Lancez manuellement l'inventaire pour forcer la découverte IP''' ou attendez une jusqu'au prochain inventaire quotidien.<br />
----<br />
===Ajout de réseaux et catégories===<br />
Cliquez maitenant sur ''Sécurité'' et allez dans ''Configuration''<br />
[[Image:OCS-ipdiscover-step4.png]]<br><br />
----<br />
Ajoutez votre propre sous réseau. Tous les champs sont obligatoires.<br />
[[Image:OCS-ipdiscover-step5.png]]<br><br />
----<br />
Passez à la création de type de périphériques et créez vos catégories...<br />
[[Image:OCS-ipdiscover-step6.png]]<br><br />
----<br />
===Utilisation===<br />
Retournez dans ''Sécurité'' et ouvrez le ''Détail des réseaux interconnectés''. Maintenant que votre réseau est créé, vous devriez voir IpDiscover fonctionner...<br />
<br />
Cliquez sur les périphériques ''Non-inventoriés''.<br />
[[Image:OCS-ipdiscover-step7.png]]<br><br />
----<br />
Il ne reste plus qu'à enregistrer les nouveaux périphériques dans les catégories !<br />
[[Image:OCS-ipdiscover-step8.png]]<br><br />
----<br />
[[Image:OCS-ipdiscover-step9.png]]<br><br />
----<br />
<br />
==Télédéploiement de paquets==<br />
OCS Inventory NG inclus une fonctionnalité de télédéploiement de paquets sur les ordinateurs clients. Depuis la console centrale d'OCS, vous pouvez envoyer des paquets qui seront téléchargés par HTTP/HTTPS et qui seront lancés par l'agent sur l'hôte cible.<br />
<br />
'''Cette fonctionnalité est disponible UNIQUEMENT SUR LE LAN'''<br />
<br />
===Certificat SSL===<br />
Le déploiement de paquets utilise SSL pour authentifier les Agents.<br />
<br />
Pour permettre à l'Agent de s'identifier avec le serveur, vous devez '''copier le fichier ''cacert.pem'' dans le dossier d'installation de l'Agent'''<br />
<br />
Ce fichier se trouve dans le dossier '''''/home/e-smith/ssl.crt/'''''<br />
<br />
====Utilisation du certificat par défaut cacert.pem====<br />
Si le fichier ''/home/e-smith/ssl.crt/cacert.pem'' n'existe pas, l'installation du RPM le créera en copiant votre certificat original SME dans ce fichier. C'est une méthode simple et rapide.<br />
<br />
Copiez le fichier '''''cacert.pem''''' dans le dossier d'installation de vos agents. Passez à la prochaine section !<br />
<br />
====Utilisation d'un certificat personnalisé====<br />
Si vous avez suivi ce [http://wiki.contribs.org/Custom_CA_Certificate howto] pour créer un certificat valide, vous pouvez l'utiliser pour le la fonctionnalité de télédéploiement.<br />
<br />
Téléchargez chez cacert.org le certificat avec la commande suivante :<br />
wget http://www.cacert.org/certs/root.crt<br />
Et remplacez le fichier existant avec la commande suivante :<br />
cp root.crt /home/e-smith/ssl.crt/cacert.pem<br />
Copiez ce fichier dans le répertoire d'installation de vos agents.<br />
<br />
===Le menu Télédéploiement===<br />
Ouvrez l'interface web d'OCS et cliquez sur l'icone de Télédéploiement.<br />
[[Image:OCS-deployment-menu.png]]<br><br />
----<br />
<br />
====Création de paquets====<br />
Le paquets de déploiement peuvent être soit des fichiers '''''.zip''''' (Windows) soit des fichiers '''''.tar.gz''''' (Linux)<br />
<br />
'''N'essayez pas de déployer d'autres types de fichiers.'''<br />
<br />
Il y a plusieurs options pour le déploiement de paquets. Pour un apercu rapide, visitez [http://www.ocsinventory-ng.org/index.php?page=package-deployment le site d'ocs].<br />
Pour les détails reportez-vous à la section 8.3 du fichier d'aide.<br />
Pour les [http://alufis35.uv.es/OCS-Deployment-Tips-and-tricks.html astuces], visitez le site de Pablo Iranzo (en anglais).<br><br />
[[Image:OCS-buildpackage.png]]<br><br />
----<br />
Après avoir créé le paquet de déploiement, vous devriez voir un message de succès :<br />
[[Image:OCS-success-build.png]]<br><br />
----<br />
<br />
====Activation de paquets====<br />
Une fois qu'un paquet est ajouté, il faut l'activer.<br />
[[Image:OCS-activate-package1.png]]<br><br />
----<br />
Fournissez le chemin vers le dossier download. Comme cette fonctionnalité est disponible UNIQUEMENT SUR LE LAN, veuillez fournir le nom interne du serveur ou son adresse IP dans les 2 champs.<br />
<br />
Attention, c'est le chemin que devra résoudre l'agent (valeur ''localhost'' interdite !)<br />
<br />
[[Image:OCS-activate-package2.png]]<br><br />
----<br />
Ne prettez pas attention au message d'erreur pendant l'activation.<br />
[[Image:OCS-activate-package3.png]]<br><br />
----<br />
<br />
====Paquets activés====<br />
Ici, vous pourrez voir les paquets activés...<br />
[[Image:OCS-activated-package.png]]<br><br />
<br />
===Télédéployer les paquets===<br />
Tout devrait être prêt !<br />
<br />
L'étape finale consiste à affecter les paquets aux ordinateurs...<br />
<br />
Voici un howto rapide pour déployer un paquet sur ''un seul ordinateur''.<br />
<br />
Pour savoir comment déployer sur de plusieurs ordinateurs en même temps, reportez vous à la section 8.5 du fichier d'aide.<br />
<br />
<br />
Ouvrez l'inventaire de l'ordinateur désiré puis cliquez sur l'icone ''Configuration'' et ajoutez un nouveau paquet.<br />
[[Image:OCS-deploy-single-pc1.png]]<br><br />
----<br />
Vous devriez voir tous les paquets activés disponibles, affectez celui de votre choix et confirmez vos changements.<br />
[[Image:OCS-deploy-single-pc2.png]]<br><br />
----<br />
De retour à la page de Configuration, vous devriez vous maintenant voir les paquets affectés ainsi que leur état.<br />
[[Image:OCS-deploy-single-pc3.png]]<br><br />
----<br />
La prochaine fois que l'Agent contactera le serveur, le paquet devrait être télédéployé ! Comme de coutume, vous pouvez lancer manuellement pour forcer la mise à jour.<br />
<br />
Reportez vous à la section 8.1 du fichier d'aide pour comprendre le fonctionnement du téléchargement.<br />
<br />
=Utilisation de GLPI=<br />
==Accès==<br />
L'interface web de GLPI est accessible à l'adresse http://votre-server/glpi<br />
<br />
Login : glpi<br />
<br />
Mot de passe : glpi<br />
{{Warning box|type=warning|Pour des raisons de sécurité, veuillez changer le mot de passe admin après votre 1ère connexion !}}<br />
L'interface web de GLPI n'est accessible que de l'intérieur de votre réseau pour des raisons de sécurité par défaut.<br />
==Les bases==<br />
[http://glpi-project.org/wiki/doku.php?id=accueil Wiki de GLPI]<br />
<br />
[http://glpi-project.org/wiki/doku.php?id=fr:premierspas 1er pas...]<br />
{{Incomplete}}<br />
===Authentification externe===<br />
Vous pouvez configurer GLPI pour que vos utilisateur SME users puissent se connecter. Pour cela, nous allons utiliser IMAP.<br />
<br />
Dans l'interface de GLPI interface, cliquez sur l'icone ''Administration'' et ouvrez le menu ''Configuration''. Cliquez sur ''Authenficication Externe''.<br />
<br />
Les réglages sont sur la photo d'écran :<br />
[[Image:GLPI-imap-auth.png]]<br><br />
----<br />
Appliquez vos changements. Les utilisateurs SME peuvent désormais se connecter à l'interface de GLPI avec leur utilisateur+mot de passe !<br />
<br />
Déconnectez vous et reconnectez vous avec un compte existant :<br />
[[Image:GLPI-user-interface.png]]<br><br />
----<br />
<br />
===Synchronisation de GLPI avec OCS===<br />
Vous pouvez importer les inventaires OCS dans GLPI.<br />
Cliquez simplement sur ''OCSNG'' dans le menu ''Outils''.<br />
[[Image:GLPI-sync-OCS-1.png]]<br><br />
----<br />
Puis importez/mettez à jour les inventaires d'OCS dans GLPI<br />
[[Image:GLPI-sync-OCS-2.png]]<br><br />
----<br />
==Mode avancé==<br />
===Synchronisation de GLPI avec LDAP===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Article en relation sur le Wiki de GLPI]<br />
{{Incomplete}}<br />
===Synchronisation de GLPI avec Active Directory===<br />
[http://glpi-project.org/wiki/doku.php?id=fr:ldap Article en relation sur le Wiki de GLPI]<br />
{{Incomplete}}<br />
==Plugins==<br />
[http://glpi-project.org/wiki/doku.php?id=fr:plugins Article en relation sur le Wiki de GLPI]<br />
{{Incomplete}}<br />
<br />
=Informations additionnelles=<br />
*[http://www.ocsinventory-ng.org/ Site web d'OCS]<br />
*[http://www.glpi-project.org/ Site web de GLPI]<br />
*[http://www.ocsinventory-ng.org/index.php?page=1-01 Section téléchargement d'OCS]<br />
*[http://forums.ocsinventory-ng.org/ Les forums OCS]<br />
*[http://remi.collet.free.fr/rpms/ RPMs de Rémi Collet]<br />
<br />
Howtos originaux :<br />
*[http://sme.firewall-services.com/spip.php?article42 Howto]<br />
*[http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi Howto ancienne version]<br />
<br />
<br />
''Stefen Noble (Snoble)''<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Administration/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=OCS_Inventory_Tools&diff=9316OCS Inventory Tools2008-04-23T17:17:16Z<p>Cool34000: /* New RPM version */ new repo fix</p>
<hr />
<div>{{Languages|OCS Inventory Tools}}<br />
<br />
=Maintainer=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
Special thanks to [http://remi.collet.free.fr/ Rémi Collet] who provided a working OCS Unified Agent Linux (and so much more!)<br />
<br />
Big thanks to Didier Liroulet and OCS team for this full documentated software (See '''''/opt/inventory/ocs/ocsreports/files/guide.pdf''''')<br />
<br />
And last but not least, thanks to [[User:Snoble|Stefen Noble]] for testings, time spent and help provided!<br />
<br />
=Inventory tools for SME 7.x=<br />
<br />
==OCS Inventory NG Description==<br />
Open Computer and Software Inventory Next Generation is an application designed to help a network or system administrator keep track of the computers configuration and software that are installed on the network.<br />
<br />
It is also able to detect all active devices on your network, such as switch, router, network printer and unattended devices. For each one, it stores MAC and IP addresses and allows you to classify them.<br />
<br />
Last, but not least, OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages (software setup, commands or only files to store on client computers) which will be downloaded through HTTP/HTTPS and launched by agent on client computer.<br />
<br />
Used with a IT and Asset Management Software such as open source tool GLPI, you will have a powerfull inventory and asset management software with automatic updates of computer configuration, license management, help desk and more.<br />
<br />
For more information see ''http://www.ocsinventory-ng.org/''.<br />
<br />
==GLPI Description==<br />
GLPI is the Information Resource-Manager with an additional Administration- Interface. You can use it to build up a database with an inventory for your company (computer, software, printers...). It has enhanced functions to make the daily life for the administrators easier, like a job-tracking-system with mail-notification and methods to build a database with basic information about your network-topology.<br />
<br />
For more information see ''http://www.glpi-project.org/''.<br />
<br />
=Server Installation=<br />
==Download==<br />
You will need ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz a few dependencies]''.<br />
If you want to save it directly on your SME Server, you can give these commands at the prompt:<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz<br />
<br />
==Install==<br />
First, you need to install the dependencies.<br />
<br />
According to your SME Server version, (SME 7.1.? and older), you may need to install mod_perl or update perl-Compress-Zlib<br />
yum install mod_perl<br />
yum update perl-Compress-Zlib<br />
<br />
Other Perl dependencies have been packaged in one file for easy downloading. Simply uncompress the tarball and install RPMs using yum:<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*.rpm<br />
Finally, you can install OCS Reports and GLPI with the following command:<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To save some bandwidth, the help file was split from ''1-6+ RPM versions''. Please download this file separately and copy it in ''/opt/inventory/ocs/ocsreports/files/''. Until you put this file in the right place, the help icon in ocs interface will not work. (we may merge the help file back into the rpm later)<br />
<br />
cd /opt/inventory/ocs/ocsreports/files/<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf<br />
<br />
==Update==<br />
===Old RPMs version===<br />
Update from old RPMs ('''''smeserver-ocs_inventory_ng''''' and '''''smeserver-glpi''''') is not possible.<br />
<br />
'''You must uninstall both RPMs first!'''<br />
<br />
If you want to keep your data, you need to uninstall old versions with following commnands:<br />
rpm -e smeserver-glpi --noscripts<br />
rpm -e smeserver-ocs_inventory_ng --noscripts<br />
There are 3 new dependencies, so you need to install them. These RPMs can be found in the [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz Tarball].<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*remi*.rpm<br />
And then install the new version with<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
<br />
=== New RPM version===<br />
Update from new RPM ('''''smeserver-inventory-tools''''') is possible.<br />
<br />
Use YUM to update:<br />
yum update smeserver-inventory-tools --enablerepo=smecontribs<br />
<br />
==Special commands==<br />
To view OCS and GLPI's configuration, you can type the following at the prompt:<br />
config show ocs<br />
config show glpi<br />
You can change a few parameters:<br />
DB parameter | Options | Default | Explanation<br />
# HTTPS | on/off | off | Enable/Disable forced https mode of web interfaces<br />
# PublicAccess | local/global | local | Accessibility of web interfaces<br />
# MaxUpload | xM | 100M | Max uploadable file size<br />
# InventoryAccess | local/global | global | Accessibility of OCS Server (to receive inventories)<br />
# InventoryDelay | >1 | 600 | Time to wait (sec) to avoid server overload (Agent cron)<br />
# URL | new alias | | Optionnal aliases for ocs and glpi web interfaces<br />
After any change to OCS or GLPI configuration, you should apply modifications by typing the following at the prompt:<br />
signal-event domain-modify<br />
It will expand and restart needed templates and services in one command!<br />
<br />
example:<br />
config setprop ocs HTTPS on PublicAccess global<br />
config setprop glpi HTTPS on PublicAccess global<br />
signal-event domain-modify<br />
<br />
==Uninstallation==<br />
To uninstall OCS Reports and GLPI, just hit the following command:<br />
yum remove smeserver-inventory-tools<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To completly remove OCS Reports and GLPI (installation files ; MySQL user+database ; OCS Agent) you will need the following command:<br />
sh /root/OCS_GLPI-Full-Uninstall.sh<br />
You should also uninstall all dependencies if you don't need them anymore...<br />
<br />
=Client Installation=<br />
<br />
The client side is available [http://www.ocsinventory-ng.org/index.php?page=1-01 on all platforms]. Download the latest client version according to your OS.<br />
<br />
After installing the Agent, you should launch it manually to upload your first inventory (as it's updated once per day by default)<br />
<br />
While you are installing the agent, copy the cacert.pem file, see the SSL section below.<br />
<br />
==OCS Agent for SME Server==<br />
===With ''smeserver-inventory-tools''===<br />
The client-side of OCS will already be installed if you install ''smeserver-inventory-tools''.<br />
<br />
You should see an inventory of your SME Server in OCS web interface after the RPM install.<br />
<br />
If you updated from old RPMs, issue the following command to create your first inventory:<br />
ocsinventory-agent -s localhost<br />
<br />
'''Do not modify ''/etc/ocsinventory-agent/ocsinv.conf'' as this file uses SME templates system in the full install.'''<br />
<br />
===Without ''smeserver-inventory-tools''===<br />
If you want to inventory other SME Servers (without installing the server-side and web interfaces), you only need following packages in the dependencies tarball:<br />
*monitor-edid-1.11-1.el4.remi.i386.rpm<br />
*ocsinventory-agent-0.0.6-1.el4.remi.noarch.rpm<br />
*ocsinventory-ipdiscover-1.01-2.el4.remi.i386.rpm<br />
Then edit ''/etc/ocsinventory-agent/ocsinv.conf'' and modify following lines:<br />
OCSSERVER=yourdomain.com<br />
OCSTAG=your_tag<br />
And finally launch the first inventory manually:<br />
ocsinventory-agent -s yourdomain.com -t your_tag<br />
<br />
==OCS Agent for Windows==<br />
There are 2 differents ways of sending inventories on Windows. Download the latest client software, OCSNG_WIN32_AGENT_1.xx_repack.zip from ocs website. This archive contains 3 executables. <br />
<br />
See Section 4.1 in the internal OCS help file.<br />
===Service use===<br />
Using OCS as a service is what you will probably need.<br />
<br />
Launch the install of ''OcsAgentSetup.exe'' and provide default settings of the service.<br />
[[Image:OCS-winagent-setup.png]]<br><br />
----<br />
Then launch the first inventory by typing the following in the 'execute box':<br />
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag<br />
Wait a few seconds and go to http://your-server/ocs, you should see your computer's inventory.<br />
<br />
By default, Agent will contact the Server once a day.<br />
<br />
You can override this default behaviour in ocs web interface options. Your changes will be applied next time the Agent contacts the Server.<br />
----<br />
For troubleshooting, look at the log file in ''C:\Program Files\OCS Inventory Agent\COMPUTER_NAME.log''<br />
===Standalone use===<br />
You can also make inventories on Windows without installing the service.<br />
<br />
OCS standalone client is cut into 2 executables:<br />
*''ocsagent.exe'' - This file contains all needed files for the launcher<br />
*''OcsLogon.exe'' - This file is the standalone executable (launcher)<br />
<br />
Of course, ''ocsagent.exe'' must be uncompressed before launching the standalone executable.<br />
<br />
This can be done by executing directly ''ocsagent.exe'': files will uncompress in ''c:\ocs-ng''.<br />
<br />
You can also import this file into ocs' MySQL database so that the standalone executable can download it if needed. This is documented in [http://wiki.contribs.org/index.php?title=OCS_Inventory_Tools&action=submit#MySQL_importation section MySQL importation].<br />
<br />
The command line is the same as for the service:<br />
"C:\Path_to_file\OcsLogon.exe" /server:yourdomain.com /np /debug /tag:your_tag<br />
For easier and faster inventorying, you can also rename this standalone executable to your domain name (don't forget ''.exe''):<br />
"C:\Path_to_file\yourdomain.com'''.exe'''" /np /debug /tag:your_tag<br />
<br />
For troubleshooting, look at the log file in ''C:\ocs-ng\COMPUTER_NAME.log''<br />
----<br />
===Importing ''ocsagent.exe'' in MySQL===<br />
The main advantage of this method is that you can send the standalone executable by Internet very quickly or even put the standalone executable on a floppy disk as it's only 65KB! How powerful looks your old floppy disk drive now?<br />
<br />
This also allows to update files archived in ''ocsagent.exe'' on your clients (can be service or standalone executable).<br />
<br />
A [http://prdownloads.sourceforge.net/ocsinventory/OCSNG_PACKAGER_1.01.zip?download packager] is available at ocs website. This will allow you to repackage ''ocsagent.exe'' with your own modifications (i.e. an SSL certificate!)<br />
[[Image:OCS-packager.png]]<br><br />
----<br />
1st thing you need is to copy ''ocsagent.exe'' (modified or not) in '''''/opt/inventory/ocs/ocsreports/files/'''''.<br />
<br />
Installer is locked (install.php), you need to change perms with the following command:<br />
chmod 660 /opt/inventory/ocs/ocsreports/dbconfig.inc.php<br />
<br />
Then, you can import this file in the database. Go to http://yourdomain.com/ocs/install.php<br />
<br />
Use the pre-configured account 'ocs' for that:<br />
[[Image:OCS-installphp.png]]<br><br />
----<br />
If you get a warning message (cannot alter database), refresh the page and you should see a successful import.<br />
[[Image:OCS-installphp-ocsagent.png]]<br><br />
----<br />
''ocsagent.exe'' is now in the database!<br />
{{Warning box|install.php has reset ocs password to 'ocs'. Re-apply your changes with following command:<br />
signal-event domain-modify<br />
This will also reset chmod to 440 on ''dbconfig.inc.php''<br />
}}<br />
You can now use ''OcsLogon.exe'' alone, it will download/update ''ocsagent.exe'' if needed!<br />
<br />
If you want to remove ''ocsagent.exe'' from your database, simply delete the file from the server and redo install.php. This will delete the file from the database.<br />
<br />
==OCS Agent for Linux==<br />
Download the generic linux tar.gz, unpack, read the README, and as root, run the setup script. <br />
<br />
You may required additional perl- packages, use you package management tools to search for the missing dependencies based on the README or the error messages. See Section 4.2 in the internal OCS help file.<br />
<br />
To run an inventory <br />
ocsinventory-client.pl -server=server.net -tag=network3<br />
<br />
Check the time (will the PC be on) and command given in <br />
/etc/cron.d/ocsinventory-client<br />
<br />
=OCS Inventory NG Usage=<br />
Full documentation can be found in the ocs help file, the help icon in ocs interface.<br />
<br />
==Access==<br />
OCS Reports' web interface can be reached at http://your-server/ocs<br />
<br />
'''Before login, please choose your language (flags on the top right corner)'''<br />
[[Image:OCS_login_page.png]]<br><br />
Login : admin<br><br />
Password: admin<br />
<br />
{{Warning box|For security-reasons, change admin's password after your first login, top right icon next to logout!}}<br />
Inventories can be done from WAN but the web interface is only available from inside your network for security reasons by default.<br />
See Sections 5 & 6 in the internal OCS help file for Reporting and Administration help.<br />
<br />
==IP discovery==<br />
IP discovery feature allow OCS Inventory NG to discover all network connected devices on the network. For this, Communication server asks a number of most “active” computers running OCS Inventory NG agent to scan for MAC addresses in their sub network at each run. See Section 7 in the internal OCS help file.<br />
<br />
===Modifying default behaviour===<br />
You may want to override the default IP Discovery behaviour.<br />
<br />
To force a computer to ipdiscover, simply open its inventory. Click on ''Customization'' icon and ''update'' the ipdiscover behaviour.<br />
[[Image:OCS-ipdiscover-step1.png]]<br><br />
----<br />
Now choose the IP of selected computer and save your changes.<br />
[[Image:OCS-ipdiscover-step2.png]]<br><br />
----<br />
You should now see your modifications.<br />
<br />
[[Image:OCS-ipdiscover-step3.png]]<br><br />
At this point, ipdiscover will run next time with the agent!<br />
<br />
'''Manually launch the inventory to force ipdiscover''' or wait a day for the next inventory.<br />
----<br />
===Adding networks and devices categories===<br />
Now click on ''Security'' and go to ''Config''<br />
[[Image:OCS-ipdiscover-step4.png]]<br><br />
----<br />
Add you own network/subnet. All fields are mandatory.<br />
[[Image:OCS-ipdiscover-step5.png]]<br><br />
----<br />
We can also add categories. Let's do that! Click on 'Network devices types'<br />
[[Image:OCS-ipdiscover-step6.png]]<br><br />
----<br />
<br />
===Usage===<br />
Go back to ''Security'' and click on ''Network information''. Now that your network is created, you should see ipdiscover working...<br />
<br />
Click on ''non-inventoried'' devices.<br />
[[Image:OCS-ipdiscover-step7.png]]<br><br />
----<br />
Now all you have to do is registering new devices!<br />
[[Image:OCS-ipdiscover-step8.png]]<br><br />
----<br />
[[Image:OCS-ipdiscover-step9.png]]<br><br />
----<br />
<br />
==Deploying packages==<br />
OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages which will be downloaded through HTTP/HTTPS and launched by agent on client computer. See Section 8 in the internal OCS help file.<br />
<br />
'''This feature is LAN ONLY'''<br />
<br />
===SSL certificate===<br />
Deployment feature uses SSL to authenticate Agents.<br />
<br />
To allow the Agent to authenticate with the Server, you need to '''copy the ''cacert.pem'' file in your agents' installation directory'''<br />
<br />
This file is located in '''''/home/e-smith/ssl.crt/'''''<br />
<br />
====Using default cacert.pem====<br />
If the file ''/home/e-smith/ssl.crt/cacert.pem'' can not be found, the RPM install will create it by copying your original SME certificate into this file. This is a quick and a simple method.<br />
<br />
Copy the '''''cacert.pem''''' file in your agents' installation directory. Skip to next section!<br />
<br />
====Using a custom certificate====<br />
If you've followed this [http://wiki.contribs.org/Custom_CA_Certificate howto] to create a valid certificate, you can use this certificate with OCS Deployment feature.<br />
<br />
Download cacert.org certificate with the following command:<br />
wget http://www.cacert.org/certs/root.crt<br />
And replace the old file with the following command:<br />
cp root.crt /home/e-smith/ssl.crt/cacert.pem<br />
Copy this file into your agents' installation directory.<br />
<br />
===Deployment menu===<br />
Open OCS' web interface and click on Deployment icon.<br />
[[Image:OCS-deployment-menu.png]]<br><br />
----<br />
<br />
====Building a deployment packages====<br />
Deployment packages can be either '''''.zip''''' files (Windows) or '''''tar.gz''''' files (Linux)<br />
<br />
'''Don't try to deploy other file type.'''<br />
<br />
There are many options to deploy packages, <br />
for an overview see [http://www.ocsinventory-ng.org/index.php?page=package-deployment the ocs website]<br />
for detail see section 8.3 of the help file,<br />
for [http://alufis35.uv.es/OCS-Deployment-Tips-and-tricks.html Tips and tricks] see Pablo Iranzo's site<br />
[[Image:OCS-buildpackage.png]]<br><br />
----<br />
After creating the deployment package, you should get this successful screen:<br />
[[Image:OCS-success-build.png]]<br><br />
----<br />
<br />
====Activating deployment packages====<br />
Once a package is added, you need to activate it.<br />
[[Image:OCS-activate-package1.png]]<br><br />
----<br />
Provide paths to download folder. As this feature is LAN ONLY, provide internal name or IP address for both fields.<br />
<br />
Be careful, this path will be resolved by the agent (value ''localhost'' forbidden here!)<br />
<br />
[[Image:OCS-activate-package2.png]]<br><br />
----<br />
Don't pay attention to the warning messages when activating, Just click Yes.<br />
[[Image:OCS-activate-package3.png]]<br><br />
----<br />
You can also ignore any warning messages when deleting a package, the package is removed.<br />
<br />
====Activated deployment packages====<br />
Here you will be able to see activated packages...<br />
[[Image:OCS-activated-package.png]]<br><br />
<br />
===Deploying your packages===<br />
All should be ready to go now!<br />
<br />
The final step is to affect the created package to computers...<br />
<br />
Here's a quick howto for deploying the package ''on a single computer''.<br />
<br />
To learn how to deploy on multiple computers, see section 8.5 of the help file.<br />
<br />
<br />
Open the desired computer's inventory on click on ''Config'' icon and add a new package<br />
[[Image:OCS-deploy-single-pc1.png]]<br><br />
----<br />
You should see all activated packages, affect the one you want and confirm changes<br />
[[Image:OCS-deploy-single-pc2.png]]<br><br />
----<br />
Back at Config page, you should now see affected packages and their states.<br />
[[Image:OCS-deploy-single-pc3.png]]<br><br />
----<br />
Next time the Agent contacts the server, it is notified of the package, and sometime later should be deployed! As usual, you can manually launch the agent to force the update.<br />
<br />
See section 8.1 of the help file to understand how download works<br />
<br />
=GLPI Usage=<br />
==Access==<br />
GLPI's web interface can be reached at http://your-server/glpi<br />
<br />
Login : glpi<br />
<br />
Password: glpi<br />
{{Warning box|For security-reasons, change admin's password after your first login!}}<br />
GLPI's web interface is only available from inside your network for security reasons by default.<br />
==Basics==<br />
[http://glpi-project.org/wiki/doku.php?id=en:welcome GLPI Wiki]<br />
<br />
[http://glpi-project.org/wiki/doku.php?id=en:begin What's next?]<br />
{{Incomplete}}<br />
===External authentication===<br />
You can configure GLPI so that your SME users can login. For this, we will use SME integrated IMAP feature.<br />
<br />
In GLPI interface, clic on ''Administration'' icon and open ''Setup'' menu. Then clic on ''External Authentications''.<br />
<br />
Settings are on the screenshot:<br />
[[Image:GLPI-imap-auth.png]]<br><br />
----<br />
Apply your changes. SME users can now connect with their existing user+password into GLPI interface!<br />
<br />
Logout and login with an existing SME account:<br />
[[Image:GLPI-user-interface.png]]<br><br />
----<br />
===Sync GLPI with OCS===<br />
You can import OCS inventories into GLPI.<br />
Simply clic on ''OCSNG'' in ''Tools'' menu.<br />
[[Image:GLPI-sync-OCS-1.png]]<br><br />
----<br />
Then Import/Update OCS inventories into GLPI<br />
[[Image:GLPI-sync-OCS-2.png]]<br><br />
----<br />
<br />
==Advanced==<br />
===Sync GLPI with LDAP===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]<br />
{{Incomplete}}<br />
===Sync GLPI with Active Directory===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]<br />
{{Incomplete}}<br />
==Plugins==<br />
[http://glpi-project.org/wiki/doku.php?id=en:plugins Related GLPI Wiki article]<br />
{{Incomplete}}<br />
<br />
=Additional information=<br />
*[http://www.ocsinventory-ng.org/ OCS website]<br />
*[http://www.glpi-project.org/ GLPI website]<br />
*[http://www.ocsinventory-ng.org/index.php?page=1-01 OCS download section]<br />
*[http://forums.ocsinventory-ng.org/ OCS forums ]<br />
*[http://remi.collet.free.fr/rpms/ Rémi Collet's RPMs repo]<br />
<br />
Initial howtos:<br />
*[http://sme.firewall-services.com/spip.php?article42 Howto]<br />
*[http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi Old version howto]<br />
<br />
<br />
''Stefen Noble (Snoble)''<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Administration]]</div>Cool34000https://wiki.koozali.org/index.php?title=OCS_Inventory_Tools&diff=9315OCS Inventory Tools2008-04-23T17:15:41Z<p>Cool34000: /* Old RPMs version */ new repo fix</p>
<hr />
<div>{{Languages|OCS Inventory Tools}}<br />
<br />
=Maintainer=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
Special thanks to [http://remi.collet.free.fr/ Rémi Collet] who provided a working OCS Unified Agent Linux (and so much more!)<br />
<br />
Big thanks to Didier Liroulet and OCS team for this full documentated software (See '''''/opt/inventory/ocs/ocsreports/files/guide.pdf''''')<br />
<br />
And last but not least, thanks to [[User:Snoble|Stefen Noble]] for testings, time spent and help provided!<br />
<br />
=Inventory tools for SME 7.x=<br />
<br />
==OCS Inventory NG Description==<br />
Open Computer and Software Inventory Next Generation is an application designed to help a network or system administrator keep track of the computers configuration and software that are installed on the network.<br />
<br />
It is also able to detect all active devices on your network, such as switch, router, network printer and unattended devices. For each one, it stores MAC and IP addresses and allows you to classify them.<br />
<br />
Last, but not least, OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages (software setup, commands or only files to store on client computers) which will be downloaded through HTTP/HTTPS and launched by agent on client computer.<br />
<br />
Used with a IT and Asset Management Software such as open source tool GLPI, you will have a powerfull inventory and asset management software with automatic updates of computer configuration, license management, help desk and more.<br />
<br />
For more information see ''http://www.ocsinventory-ng.org/''.<br />
<br />
==GLPI Description==<br />
GLPI is the Information Resource-Manager with an additional Administration- Interface. You can use it to build up a database with an inventory for your company (computer, software, printers...). It has enhanced functions to make the daily life for the administrators easier, like a job-tracking-system with mail-notification and methods to build a database with basic information about your network-topology.<br />
<br />
For more information see ''http://www.glpi-project.org/''.<br />
<br />
=Server Installation=<br />
==Download==<br />
You will need ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz a few dependencies]''.<br />
If you want to save it directly on your SME Server, you can give these commands at the prompt:<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz<br />
<br />
==Install==<br />
First, you need to install the dependencies.<br />
<br />
According to your SME Server version, (SME 7.1.? and older), you may need to install mod_perl or update perl-Compress-Zlib<br />
yum install mod_perl<br />
yum update perl-Compress-Zlib<br />
<br />
Other Perl dependencies have been packaged in one file for easy downloading. Simply uncompress the tarball and install RPMs using yum:<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*.rpm<br />
Finally, you can install OCS Reports and GLPI with the following command:<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To save some bandwidth, the help file was split from ''1-6+ RPM versions''. Please download this file separately and copy it in ''/opt/inventory/ocs/ocsreports/files/''. Until you put this file in the right place, the help icon in ocs interface will not work. (we may merge the help file back into the rpm later)<br />
<br />
cd /opt/inventory/ocs/ocsreports/files/<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf<br />
<br />
==Update==<br />
===Old RPMs version===<br />
Update from old RPMs ('''''smeserver-ocs_inventory_ng''''' and '''''smeserver-glpi''''') is not possible.<br />
<br />
'''You must uninstall both RPMs first!'''<br />
<br />
If you want to keep your data, you need to uninstall old versions with following commnands:<br />
rpm -e smeserver-glpi --noscripts<br />
rpm -e smeserver-ocs_inventory_ng --noscripts<br />
There are 3 new dependencies, so you need to install them. These RPMs can be found in the [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz Tarball].<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*remi*.rpm<br />
And then install the new version with<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
<br />
=== New RPM version===<br />
Update from new RPM ('''''smeserver-inventory-tools''''') is possible.<br />
<br />
Use YUM to update:<br />
yum localinstall smeserver-inventory-tools-1-'''x'''.i386.rpm<br />
Where'' "'''x'''" ''is the new version number<br />
==Special commands==<br />
To view OCS and GLPI's configuration, you can type the following at the prompt:<br />
config show ocs<br />
config show glpi<br />
You can change a few parameters:<br />
DB parameter | Options | Default | Explanation<br />
# HTTPS | on/off | off | Enable/Disable forced https mode of web interfaces<br />
# PublicAccess | local/global | local | Accessibility of web interfaces<br />
# MaxUpload | xM | 100M | Max uploadable file size<br />
# InventoryAccess | local/global | global | Accessibility of OCS Server (to receive inventories)<br />
# InventoryDelay | >1 | 600 | Time to wait (sec) to avoid server overload (Agent cron)<br />
# URL | new alias | | Optionnal aliases for ocs and glpi web interfaces<br />
After any change to OCS or GLPI configuration, you should apply modifications by typing the following at the prompt:<br />
signal-event domain-modify<br />
It will expand and restart needed templates and services in one command!<br />
<br />
example:<br />
config setprop ocs HTTPS on PublicAccess global<br />
config setprop glpi HTTPS on PublicAccess global<br />
signal-event domain-modify<br />
<br />
==Uninstallation==<br />
To uninstall OCS Reports and GLPI, just hit the following command:<br />
yum remove smeserver-inventory-tools<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To completly remove OCS Reports and GLPI (installation files ; MySQL user+database ; OCS Agent) you will need the following command:<br />
sh /root/OCS_GLPI-Full-Uninstall.sh<br />
You should also uninstall all dependencies if you don't need them anymore...<br />
<br />
=Client Installation=<br />
<br />
The client side is available [http://www.ocsinventory-ng.org/index.php?page=1-01 on all platforms]. Download the latest client version according to your OS.<br />
<br />
After installing the Agent, you should launch it manually to upload your first inventory (as it's updated once per day by default)<br />
<br />
While you are installing the agent, copy the cacert.pem file, see the SSL section below.<br />
<br />
==OCS Agent for SME Server==<br />
===With ''smeserver-inventory-tools''===<br />
The client-side of OCS will already be installed if you install ''smeserver-inventory-tools''.<br />
<br />
You should see an inventory of your SME Server in OCS web interface after the RPM install.<br />
<br />
If you updated from old RPMs, issue the following command to create your first inventory:<br />
ocsinventory-agent -s localhost<br />
<br />
'''Do not modify ''/etc/ocsinventory-agent/ocsinv.conf'' as this file uses SME templates system in the full install.'''<br />
<br />
===Without ''smeserver-inventory-tools''===<br />
If you want to inventory other SME Servers (without installing the server-side and web interfaces), you only need following packages in the dependencies tarball:<br />
*monitor-edid-1.11-1.el4.remi.i386.rpm<br />
*ocsinventory-agent-0.0.6-1.el4.remi.noarch.rpm<br />
*ocsinventory-ipdiscover-1.01-2.el4.remi.i386.rpm<br />
Then edit ''/etc/ocsinventory-agent/ocsinv.conf'' and modify following lines:<br />
OCSSERVER=yourdomain.com<br />
OCSTAG=your_tag<br />
And finally launch the first inventory manually:<br />
ocsinventory-agent -s yourdomain.com -t your_tag<br />
<br />
==OCS Agent for Windows==<br />
There are 2 differents ways of sending inventories on Windows. Download the latest client software, OCSNG_WIN32_AGENT_1.xx_repack.zip from ocs website. This archive contains 3 executables. <br />
<br />
See Section 4.1 in the internal OCS help file.<br />
===Service use===<br />
Using OCS as a service is what you will probably need.<br />
<br />
Launch the install of ''OcsAgentSetup.exe'' and provide default settings of the service.<br />
[[Image:OCS-winagent-setup.png]]<br><br />
----<br />
Then launch the first inventory by typing the following in the 'execute box':<br />
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag<br />
Wait a few seconds and go to http://your-server/ocs, you should see your computer's inventory.<br />
<br />
By default, Agent will contact the Server once a day.<br />
<br />
You can override this default behaviour in ocs web interface options. Your changes will be applied next time the Agent contacts the Server.<br />
----<br />
For troubleshooting, look at the log file in ''C:\Program Files\OCS Inventory Agent\COMPUTER_NAME.log''<br />
===Standalone use===<br />
You can also make inventories on Windows without installing the service.<br />
<br />
OCS standalone client is cut into 2 executables:<br />
*''ocsagent.exe'' - This file contains all needed files for the launcher<br />
*''OcsLogon.exe'' - This file is the standalone executable (launcher)<br />
<br />
Of course, ''ocsagent.exe'' must be uncompressed before launching the standalone executable.<br />
<br />
This can be done by executing directly ''ocsagent.exe'': files will uncompress in ''c:\ocs-ng''.<br />
<br />
You can also import this file into ocs' MySQL database so that the standalone executable can download it if needed. This is documented in [http://wiki.contribs.org/index.php?title=OCS_Inventory_Tools&action=submit#MySQL_importation section MySQL importation].<br />
<br />
The command line is the same as for the service:<br />
"C:\Path_to_file\OcsLogon.exe" /server:yourdomain.com /np /debug /tag:your_tag<br />
For easier and faster inventorying, you can also rename this standalone executable to your domain name (don't forget ''.exe''):<br />
"C:\Path_to_file\yourdomain.com'''.exe'''" /np /debug /tag:your_tag<br />
<br />
For troubleshooting, look at the log file in ''C:\ocs-ng\COMPUTER_NAME.log''<br />
----<br />
===Importing ''ocsagent.exe'' in MySQL===<br />
The main advantage of this method is that you can send the standalone executable by Internet very quickly or even put the standalone executable on a floppy disk as it's only 65KB! How powerful looks your old floppy disk drive now?<br />
<br />
This also allows to update files archived in ''ocsagent.exe'' on your clients (can be service or standalone executable).<br />
<br />
A [http://prdownloads.sourceforge.net/ocsinventory/OCSNG_PACKAGER_1.01.zip?download packager] is available at ocs website. This will allow you to repackage ''ocsagent.exe'' with your own modifications (i.e. an SSL certificate!)<br />
[[Image:OCS-packager.png]]<br><br />
----<br />
1st thing you need is to copy ''ocsagent.exe'' (modified or not) in '''''/opt/inventory/ocs/ocsreports/files/'''''.<br />
<br />
Installer is locked (install.php), you need to change perms with the following command:<br />
chmod 660 /opt/inventory/ocs/ocsreports/dbconfig.inc.php<br />
<br />
Then, you can import this file in the database. Go to http://yourdomain.com/ocs/install.php<br />
<br />
Use the pre-configured account 'ocs' for that:<br />
[[Image:OCS-installphp.png]]<br><br />
----<br />
If you get a warning message (cannot alter database), refresh the page and you should see a successful import.<br />
[[Image:OCS-installphp-ocsagent.png]]<br><br />
----<br />
''ocsagent.exe'' is now in the database!<br />
{{Warning box|install.php has reset ocs password to 'ocs'. Re-apply your changes with following command:<br />
signal-event domain-modify<br />
This will also reset chmod to 440 on ''dbconfig.inc.php''<br />
}}<br />
You can now use ''OcsLogon.exe'' alone, it will download/update ''ocsagent.exe'' if needed!<br />
<br />
If you want to remove ''ocsagent.exe'' from your database, simply delete the file from the server and redo install.php. This will delete the file from the database.<br />
<br />
==OCS Agent for Linux==<br />
Download the generic linux tar.gz, unpack, read the README, and as root, run the setup script. <br />
<br />
You may required additional perl- packages, use you package management tools to search for the missing dependencies based on the README or the error messages. See Section 4.2 in the internal OCS help file.<br />
<br />
To run an inventory <br />
ocsinventory-client.pl -server=server.net -tag=network3<br />
<br />
Check the time (will the PC be on) and command given in <br />
/etc/cron.d/ocsinventory-client<br />
<br />
=OCS Inventory NG Usage=<br />
Full documentation can be found in the ocs help file, the help icon in ocs interface.<br />
<br />
==Access==<br />
OCS Reports' web interface can be reached at http://your-server/ocs<br />
<br />
'''Before login, please choose your language (flags on the top right corner)'''<br />
[[Image:OCS_login_page.png]]<br><br />
Login : admin<br><br />
Password: admin<br />
<br />
{{Warning box|For security-reasons, change admin's password after your first login, top right icon next to logout!}}<br />
Inventories can be done from WAN but the web interface is only available from inside your network for security reasons by default.<br />
See Sections 5 & 6 in the internal OCS help file for Reporting and Administration help.<br />
<br />
==IP discovery==<br />
IP discovery feature allow OCS Inventory NG to discover all network connected devices on the network. For this, Communication server asks a number of most “active” computers running OCS Inventory NG agent to scan for MAC addresses in their sub network at each run. See Section 7 in the internal OCS help file.<br />
<br />
===Modifying default behaviour===<br />
You may want to override the default IP Discovery behaviour.<br />
<br />
To force a computer to ipdiscover, simply open its inventory. Click on ''Customization'' icon and ''update'' the ipdiscover behaviour.<br />
[[Image:OCS-ipdiscover-step1.png]]<br><br />
----<br />
Now choose the IP of selected computer and save your changes.<br />
[[Image:OCS-ipdiscover-step2.png]]<br><br />
----<br />
You should now see your modifications.<br />
<br />
[[Image:OCS-ipdiscover-step3.png]]<br><br />
At this point, ipdiscover will run next time with the agent!<br />
<br />
'''Manually launch the inventory to force ipdiscover''' or wait a day for the next inventory.<br />
----<br />
===Adding networks and devices categories===<br />
Now click on ''Security'' and go to ''Config''<br />
[[Image:OCS-ipdiscover-step4.png]]<br><br />
----<br />
Add you own network/subnet. All fields are mandatory.<br />
[[Image:OCS-ipdiscover-step5.png]]<br><br />
----<br />
We can also add categories. Let's do that! Click on 'Network devices types'<br />
[[Image:OCS-ipdiscover-step6.png]]<br><br />
----<br />
<br />
===Usage===<br />
Go back to ''Security'' and click on ''Network information''. Now that your network is created, you should see ipdiscover working...<br />
<br />
Click on ''non-inventoried'' devices.<br />
[[Image:OCS-ipdiscover-step7.png]]<br><br />
----<br />
Now all you have to do is registering new devices!<br />
[[Image:OCS-ipdiscover-step8.png]]<br><br />
----<br />
[[Image:OCS-ipdiscover-step9.png]]<br><br />
----<br />
<br />
==Deploying packages==<br />
OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages which will be downloaded through HTTP/HTTPS and launched by agent on client computer. See Section 8 in the internal OCS help file.<br />
<br />
'''This feature is LAN ONLY'''<br />
<br />
===SSL certificate===<br />
Deployment feature uses SSL to authenticate Agents.<br />
<br />
To allow the Agent to authenticate with the Server, you need to '''copy the ''cacert.pem'' file in your agents' installation directory'''<br />
<br />
This file is located in '''''/home/e-smith/ssl.crt/'''''<br />
<br />
====Using default cacert.pem====<br />
If the file ''/home/e-smith/ssl.crt/cacert.pem'' can not be found, the RPM install will create it by copying your original SME certificate into this file. This is a quick and a simple method.<br />
<br />
Copy the '''''cacert.pem''''' file in your agents' installation directory. Skip to next section!<br />
<br />
====Using a custom certificate====<br />
If you've followed this [http://wiki.contribs.org/Custom_CA_Certificate howto] to create a valid certificate, you can use this certificate with OCS Deployment feature.<br />
<br />
Download cacert.org certificate with the following command:<br />
wget http://www.cacert.org/certs/root.crt<br />
And replace the old file with the following command:<br />
cp root.crt /home/e-smith/ssl.crt/cacert.pem<br />
Copy this file into your agents' installation directory.<br />
<br />
===Deployment menu===<br />
Open OCS' web interface and click on Deployment icon.<br />
[[Image:OCS-deployment-menu.png]]<br><br />
----<br />
<br />
====Building a deployment packages====<br />
Deployment packages can be either '''''.zip''''' files (Windows) or '''''tar.gz''''' files (Linux)<br />
<br />
'''Don't try to deploy other file type.'''<br />
<br />
There are many options to deploy packages, <br />
for an overview see [http://www.ocsinventory-ng.org/index.php?page=package-deployment the ocs website]<br />
for detail see section 8.3 of the help file,<br />
for [http://alufis35.uv.es/OCS-Deployment-Tips-and-tricks.html Tips and tricks] see Pablo Iranzo's site<br />
[[Image:OCS-buildpackage.png]]<br><br />
----<br />
After creating the deployment package, you should get this successful screen:<br />
[[Image:OCS-success-build.png]]<br><br />
----<br />
<br />
====Activating deployment packages====<br />
Once a package is added, you need to activate it.<br />
[[Image:OCS-activate-package1.png]]<br><br />
----<br />
Provide paths to download folder. As this feature is LAN ONLY, provide internal name or IP address for both fields.<br />
<br />
Be careful, this path will be resolved by the agent (value ''localhost'' forbidden here!)<br />
<br />
[[Image:OCS-activate-package2.png]]<br><br />
----<br />
Don't pay attention to the warning messages when activating, Just click Yes.<br />
[[Image:OCS-activate-package3.png]]<br><br />
----<br />
You can also ignore any warning messages when deleting a package, the package is removed.<br />
<br />
====Activated deployment packages====<br />
Here you will be able to see activated packages...<br />
[[Image:OCS-activated-package.png]]<br><br />
<br />
===Deploying your packages===<br />
All should be ready to go now!<br />
<br />
The final step is to affect the created package to computers...<br />
<br />
Here's a quick howto for deploying the package ''on a single computer''.<br />
<br />
To learn how to deploy on multiple computers, see section 8.5 of the help file.<br />
<br />
<br />
Open the desired computer's inventory on click on ''Config'' icon and add a new package<br />
[[Image:OCS-deploy-single-pc1.png]]<br><br />
----<br />
You should see all activated packages, affect the one you want and confirm changes<br />
[[Image:OCS-deploy-single-pc2.png]]<br><br />
----<br />
Back at Config page, you should now see affected packages and their states.<br />
[[Image:OCS-deploy-single-pc3.png]]<br><br />
----<br />
Next time the Agent contacts the server, it is notified of the package, and sometime later should be deployed! As usual, you can manually launch the agent to force the update.<br />
<br />
See section 8.1 of the help file to understand how download works<br />
<br />
=GLPI Usage=<br />
==Access==<br />
GLPI's web interface can be reached at http://your-server/glpi<br />
<br />
Login : glpi<br />
<br />
Password: glpi<br />
{{Warning box|For security-reasons, change admin's password after your first login!}}<br />
GLPI's web interface is only available from inside your network for security reasons by default.<br />
==Basics==<br />
[http://glpi-project.org/wiki/doku.php?id=en:welcome GLPI Wiki]<br />
<br />
[http://glpi-project.org/wiki/doku.php?id=en:begin What's next?]<br />
{{Incomplete}}<br />
===External authentication===<br />
You can configure GLPI so that your SME users can login. For this, we will use SME integrated IMAP feature.<br />
<br />
In GLPI interface, clic on ''Administration'' icon and open ''Setup'' menu. Then clic on ''External Authentications''.<br />
<br />
Settings are on the screenshot:<br />
[[Image:GLPI-imap-auth.png]]<br><br />
----<br />
Apply your changes. SME users can now connect with their existing user+password into GLPI interface!<br />
<br />
Logout and login with an existing SME account:<br />
[[Image:GLPI-user-interface.png]]<br><br />
----<br />
===Sync GLPI with OCS===<br />
You can import OCS inventories into GLPI.<br />
Simply clic on ''OCSNG'' in ''Tools'' menu.<br />
[[Image:GLPI-sync-OCS-1.png]]<br><br />
----<br />
Then Import/Update OCS inventories into GLPI<br />
[[Image:GLPI-sync-OCS-2.png]]<br><br />
----<br />
<br />
==Advanced==<br />
===Sync GLPI with LDAP===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]<br />
{{Incomplete}}<br />
===Sync GLPI with Active Directory===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]<br />
{{Incomplete}}<br />
==Plugins==<br />
[http://glpi-project.org/wiki/doku.php?id=en:plugins Related GLPI Wiki article]<br />
{{Incomplete}}<br />
<br />
=Additional information=<br />
*[http://www.ocsinventory-ng.org/ OCS website]<br />
*[http://www.glpi-project.org/ GLPI website]<br />
*[http://www.ocsinventory-ng.org/index.php?page=1-01 OCS download section]<br />
*[http://forums.ocsinventory-ng.org/ OCS forums ]<br />
*[http://remi.collet.free.fr/rpms/ Rémi Collet's RPMs repo]<br />
<br />
Initial howtos:<br />
*[http://sme.firewall-services.com/spip.php?article42 Howto]<br />
*[http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi Old version howto]<br />
<br />
<br />
''Stefen Noble (Snoble)''<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Administration]]</div>Cool34000https://wiki.koozali.org/index.php?title=OCS_Inventory_Tools&diff=9314OCS Inventory Tools2008-04-23T17:13:34Z<p>Cool34000: /* Server Installation */ new repo fix</p>
<hr />
<div>{{Languages|OCS Inventory Tools}}<br />
<br />
=Maintainer=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
Special thanks to [http://remi.collet.free.fr/ Rémi Collet] who provided a working OCS Unified Agent Linux (and so much more!)<br />
<br />
Big thanks to Didier Liroulet and OCS team for this full documentated software (See '''''/opt/inventory/ocs/ocsreports/files/guide.pdf''''')<br />
<br />
And last but not least, thanks to [[User:Snoble|Stefen Noble]] for testings, time spent and help provided!<br />
<br />
=Inventory tools for SME 7.x=<br />
<br />
==OCS Inventory NG Description==<br />
Open Computer and Software Inventory Next Generation is an application designed to help a network or system administrator keep track of the computers configuration and software that are installed on the network.<br />
<br />
It is also able to detect all active devices on your network, such as switch, router, network printer and unattended devices. For each one, it stores MAC and IP addresses and allows you to classify them.<br />
<br />
Last, but not least, OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages (software setup, commands or only files to store on client computers) which will be downloaded through HTTP/HTTPS and launched by agent on client computer.<br />
<br />
Used with a IT and Asset Management Software such as open source tool GLPI, you will have a powerfull inventory and asset management software with automatic updates of computer configuration, license management, help desk and more.<br />
<br />
For more information see ''http://www.ocsinventory-ng.org/''.<br />
<br />
==GLPI Description==<br />
GLPI is the Information Resource-Manager with an additional Administration- Interface. You can use it to build up a database with an inventory for your company (computer, software, printers...). It has enhanced functions to make the daily life for the administrators easier, like a job-tracking-system with mail-notification and methods to build a database with basic information about your network-topology.<br />
<br />
For more information see ''http://www.glpi-project.org/''.<br />
<br />
=Server Installation=<br />
==Download==<br />
You will need ''[http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz a few dependencies]''.<br />
If you want to save it directly on your SME Server, you can give these commands at the prompt:<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz<br />
<br />
==Install==<br />
First, you need to install the dependencies.<br />
<br />
According to your SME Server version, (SME 7.1.? and older), you may need to install mod_perl or update perl-Compress-Zlib<br />
yum install mod_perl<br />
yum update perl-Compress-Zlib<br />
<br />
Other Perl dependencies have been packaged in one file for easy downloading. Simply uncompress the tarball and install RPMs using yum:<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*.rpm<br />
Finally, you can install OCS Reports and GLPI with the following command:<br />
yum install smeserver-inventory-tools --enablerepo=smecontribs<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To save some bandwidth, the help file was split from ''1-6+ RPM versions''. Please download this file separately and copy it in ''/opt/inventory/ocs/ocsreports/files/''. Until you put this file in the right place, the help icon in ocs interface will not work. (we may merge the help file back into the rpm later)<br />
<br />
cd /opt/inventory/ocs/ocsreports/files/<br />
wget http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/guide.pdf<br />
<br />
==Update==<br />
===Old RPMs version===<br />
Update from old RPMs ('''''smeserver-ocs_inventory_ng''''' and '''''smeserver-glpi''''') is not possible.<br />
<br />
'''You must uninstall both RPMs first!'''<br />
<br />
If you want to keep your data, you need to uninstall old versions with following commnands:<br />
rpm -e smeserver-glpi --noscripts<br />
rpm -e smeserver-ocs_inventory_ng --noscripts<br />
There are 3 new dependencies, so you need to install them. These RPMs can be found in the [http://mirror.contribs.org/smeserver/contribs/sgomez/contribs/inventory/dependencies/ocs_perl_deps.tar.gz Tarball].<br />
tar -xzf ./ocs_perl_deps.tar.gz<br />
yum localinstall ./ocs_perl_deps/*remi*.rpm<br />
And then install the new version with<br />
yum localinstall smeserver-inventory-tools-1-7.i386.rpm<br />
<br />
=== New RPM version===<br />
Update from new RPM ('''''smeserver-inventory-tools''''') is possible.<br />
<br />
Use YUM to update:<br />
yum localinstall smeserver-inventory-tools-1-'''x'''.i386.rpm<br />
Where'' "'''x'''" ''is the new version number<br />
==Special commands==<br />
To view OCS and GLPI's configuration, you can type the following at the prompt:<br />
config show ocs<br />
config show glpi<br />
You can change a few parameters:<br />
DB parameter | Options | Default | Explanation<br />
# HTTPS | on/off | off | Enable/Disable forced https mode of web interfaces<br />
# PublicAccess | local/global | local | Accessibility of web interfaces<br />
# MaxUpload | xM | 100M | Max uploadable file size<br />
# InventoryAccess | local/global | global | Accessibility of OCS Server (to receive inventories)<br />
# InventoryDelay | >1 | 600 | Time to wait (sec) to avoid server overload (Agent cron)<br />
# URL | new alias | | Optionnal aliases for ocs and glpi web interfaces<br />
After any change to OCS or GLPI configuration, you should apply modifications by typing the following at the prompt:<br />
signal-event domain-modify<br />
It will expand and restart needed templates and services in one command!<br />
<br />
example:<br />
config setprop ocs HTTPS on PublicAccess global<br />
config setprop glpi HTTPS on PublicAccess global<br />
signal-event domain-modify<br />
<br />
==Uninstallation==<br />
To uninstall OCS Reports and GLPI, just hit the following command:<br />
yum remove smeserver-inventory-tools<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To completly remove OCS Reports and GLPI (installation files ; MySQL user+database ; OCS Agent) you will need the following command:<br />
sh /root/OCS_GLPI-Full-Uninstall.sh<br />
You should also uninstall all dependencies if you don't need them anymore...<br />
<br />
=Client Installation=<br />
<br />
The client side is available [http://www.ocsinventory-ng.org/index.php?page=1-01 on all platforms]. Download the latest client version according to your OS.<br />
<br />
After installing the Agent, you should launch it manually to upload your first inventory (as it's updated once per day by default)<br />
<br />
While you are installing the agent, copy the cacert.pem file, see the SSL section below.<br />
<br />
==OCS Agent for SME Server==<br />
===With ''smeserver-inventory-tools''===<br />
The client-side of OCS will already be installed if you install ''smeserver-inventory-tools''.<br />
<br />
You should see an inventory of your SME Server in OCS web interface after the RPM install.<br />
<br />
If you updated from old RPMs, issue the following command to create your first inventory:<br />
ocsinventory-agent -s localhost<br />
<br />
'''Do not modify ''/etc/ocsinventory-agent/ocsinv.conf'' as this file uses SME templates system in the full install.'''<br />
<br />
===Without ''smeserver-inventory-tools''===<br />
If you want to inventory other SME Servers (without installing the server-side and web interfaces), you only need following packages in the dependencies tarball:<br />
*monitor-edid-1.11-1.el4.remi.i386.rpm<br />
*ocsinventory-agent-0.0.6-1.el4.remi.noarch.rpm<br />
*ocsinventory-ipdiscover-1.01-2.el4.remi.i386.rpm<br />
Then edit ''/etc/ocsinventory-agent/ocsinv.conf'' and modify following lines:<br />
OCSSERVER=yourdomain.com<br />
OCSTAG=your_tag<br />
And finally launch the first inventory manually:<br />
ocsinventory-agent -s yourdomain.com -t your_tag<br />
<br />
==OCS Agent for Windows==<br />
There are 2 differents ways of sending inventories on Windows. Download the latest client software, OCSNG_WIN32_AGENT_1.xx_repack.zip from ocs website. This archive contains 3 executables. <br />
<br />
See Section 4.1 in the internal OCS help file.<br />
===Service use===<br />
Using OCS as a service is what you will probably need.<br />
<br />
Launch the install of ''OcsAgentSetup.exe'' and provide default settings of the service.<br />
[[Image:OCS-winagent-setup.png]]<br><br />
----<br />
Then launch the first inventory by typing the following in the 'execute box':<br />
"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:yourdomain.com /np /debug /tag:your_tag<br />
Wait a few seconds and go to http://your-server/ocs, you should see your computer's inventory.<br />
<br />
By default, Agent will contact the Server once a day.<br />
<br />
You can override this default behaviour in ocs web interface options. Your changes will be applied next time the Agent contacts the Server.<br />
----<br />
For troubleshooting, look at the log file in ''C:\Program Files\OCS Inventory Agent\COMPUTER_NAME.log''<br />
===Standalone use===<br />
You can also make inventories on Windows without installing the service.<br />
<br />
OCS standalone client is cut into 2 executables:<br />
*''ocsagent.exe'' - This file contains all needed files for the launcher<br />
*''OcsLogon.exe'' - This file is the standalone executable (launcher)<br />
<br />
Of course, ''ocsagent.exe'' must be uncompressed before launching the standalone executable.<br />
<br />
This can be done by executing directly ''ocsagent.exe'': files will uncompress in ''c:\ocs-ng''.<br />
<br />
You can also import this file into ocs' MySQL database so that the standalone executable can download it if needed. This is documented in [http://wiki.contribs.org/index.php?title=OCS_Inventory_Tools&action=submit#MySQL_importation section MySQL importation].<br />
<br />
The command line is the same as for the service:<br />
"C:\Path_to_file\OcsLogon.exe" /server:yourdomain.com /np /debug /tag:your_tag<br />
For easier and faster inventorying, you can also rename this standalone executable to your domain name (don't forget ''.exe''):<br />
"C:\Path_to_file\yourdomain.com'''.exe'''" /np /debug /tag:your_tag<br />
<br />
For troubleshooting, look at the log file in ''C:\ocs-ng\COMPUTER_NAME.log''<br />
----<br />
===Importing ''ocsagent.exe'' in MySQL===<br />
The main advantage of this method is that you can send the standalone executable by Internet very quickly or even put the standalone executable on a floppy disk as it's only 65KB! How powerful looks your old floppy disk drive now?<br />
<br />
This also allows to update files archived in ''ocsagent.exe'' on your clients (can be service or standalone executable).<br />
<br />
A [http://prdownloads.sourceforge.net/ocsinventory/OCSNG_PACKAGER_1.01.zip?download packager] is available at ocs website. This will allow you to repackage ''ocsagent.exe'' with your own modifications (i.e. an SSL certificate!)<br />
[[Image:OCS-packager.png]]<br><br />
----<br />
1st thing you need is to copy ''ocsagent.exe'' (modified or not) in '''''/opt/inventory/ocs/ocsreports/files/'''''.<br />
<br />
Installer is locked (install.php), you need to change perms with the following command:<br />
chmod 660 /opt/inventory/ocs/ocsreports/dbconfig.inc.php<br />
<br />
Then, you can import this file in the database. Go to http://yourdomain.com/ocs/install.php<br />
<br />
Use the pre-configured account 'ocs' for that:<br />
[[Image:OCS-installphp.png]]<br><br />
----<br />
If you get a warning message (cannot alter database), refresh the page and you should see a successful import.<br />
[[Image:OCS-installphp-ocsagent.png]]<br><br />
----<br />
''ocsagent.exe'' is now in the database!<br />
{{Warning box|install.php has reset ocs password to 'ocs'. Re-apply your changes with following command:<br />
signal-event domain-modify<br />
This will also reset chmod to 440 on ''dbconfig.inc.php''<br />
}}<br />
You can now use ''OcsLogon.exe'' alone, it will download/update ''ocsagent.exe'' if needed!<br />
<br />
If you want to remove ''ocsagent.exe'' from your database, simply delete the file from the server and redo install.php. This will delete the file from the database.<br />
<br />
==OCS Agent for Linux==<br />
Download the generic linux tar.gz, unpack, read the README, and as root, run the setup script. <br />
<br />
You may required additional perl- packages, use you package management tools to search for the missing dependencies based on the README or the error messages. See Section 4.2 in the internal OCS help file.<br />
<br />
To run an inventory <br />
ocsinventory-client.pl -server=server.net -tag=network3<br />
<br />
Check the time (will the PC be on) and command given in <br />
/etc/cron.d/ocsinventory-client<br />
<br />
=OCS Inventory NG Usage=<br />
Full documentation can be found in the ocs help file, the help icon in ocs interface.<br />
<br />
==Access==<br />
OCS Reports' web interface can be reached at http://your-server/ocs<br />
<br />
'''Before login, please choose your language (flags on the top right corner)'''<br />
[[Image:OCS_login_page.png]]<br><br />
Login : admin<br><br />
Password: admin<br />
<br />
{{Warning box|For security-reasons, change admin's password after your first login, top right icon next to logout!}}<br />
Inventories can be done from WAN but the web interface is only available from inside your network for security reasons by default.<br />
See Sections 5 & 6 in the internal OCS help file for Reporting and Administration help.<br />
<br />
==IP discovery==<br />
IP discovery feature allow OCS Inventory NG to discover all network connected devices on the network. For this, Communication server asks a number of most “active” computers running OCS Inventory NG agent to scan for MAC addresses in their sub network at each run. See Section 7 in the internal OCS help file.<br />
<br />
===Modifying default behaviour===<br />
You may want to override the default IP Discovery behaviour.<br />
<br />
To force a computer to ipdiscover, simply open its inventory. Click on ''Customization'' icon and ''update'' the ipdiscover behaviour.<br />
[[Image:OCS-ipdiscover-step1.png]]<br><br />
----<br />
Now choose the IP of selected computer and save your changes.<br />
[[Image:OCS-ipdiscover-step2.png]]<br><br />
----<br />
You should now see your modifications.<br />
<br />
[[Image:OCS-ipdiscover-step3.png]]<br><br />
At this point, ipdiscover will run next time with the agent!<br />
<br />
'''Manually launch the inventory to force ipdiscover''' or wait a day for the next inventory.<br />
----<br />
===Adding networks and devices categories===<br />
Now click on ''Security'' and go to ''Config''<br />
[[Image:OCS-ipdiscover-step4.png]]<br><br />
----<br />
Add you own network/subnet. All fields are mandatory.<br />
[[Image:OCS-ipdiscover-step5.png]]<br><br />
----<br />
We can also add categories. Let's do that! Click on 'Network devices types'<br />
[[Image:OCS-ipdiscover-step6.png]]<br><br />
----<br />
<br />
===Usage===<br />
Go back to ''Security'' and click on ''Network information''. Now that your network is created, you should see ipdiscover working...<br />
<br />
Click on ''non-inventoried'' devices.<br />
[[Image:OCS-ipdiscover-step7.png]]<br><br />
----<br />
Now all you have to do is registering new devices!<br />
[[Image:OCS-ipdiscover-step8.png]]<br><br />
----<br />
[[Image:OCS-ipdiscover-step9.png]]<br><br />
----<br />
<br />
==Deploying packages==<br />
OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages which will be downloaded through HTTP/HTTPS and launched by agent on client computer. See Section 8 in the internal OCS help file.<br />
<br />
'''This feature is LAN ONLY'''<br />
<br />
===SSL certificate===<br />
Deployment feature uses SSL to authenticate Agents.<br />
<br />
To allow the Agent to authenticate with the Server, you need to '''copy the ''cacert.pem'' file in your agents' installation directory'''<br />
<br />
This file is located in '''''/home/e-smith/ssl.crt/'''''<br />
<br />
====Using default cacert.pem====<br />
If the file ''/home/e-smith/ssl.crt/cacert.pem'' can not be found, the RPM install will create it by copying your original SME certificate into this file. This is a quick and a simple method.<br />
<br />
Copy the '''''cacert.pem''''' file in your agents' installation directory. Skip to next section!<br />
<br />
====Using a custom certificate====<br />
If you've followed this [http://wiki.contribs.org/Custom_CA_Certificate howto] to create a valid certificate, you can use this certificate with OCS Deployment feature.<br />
<br />
Download cacert.org certificate with the following command:<br />
wget http://www.cacert.org/certs/root.crt<br />
And replace the old file with the following command:<br />
cp root.crt /home/e-smith/ssl.crt/cacert.pem<br />
Copy this file into your agents' installation directory.<br />
<br />
===Deployment menu===<br />
Open OCS' web interface and click on Deployment icon.<br />
[[Image:OCS-deployment-menu.png]]<br><br />
----<br />
<br />
====Building a deployment packages====<br />
Deployment packages can be either '''''.zip''''' files (Windows) or '''''tar.gz''''' files (Linux)<br />
<br />
'''Don't try to deploy other file type.'''<br />
<br />
There are many options to deploy packages, <br />
for an overview see [http://www.ocsinventory-ng.org/index.php?page=package-deployment the ocs website]<br />
for detail see section 8.3 of the help file,<br />
for [http://alufis35.uv.es/OCS-Deployment-Tips-and-tricks.html Tips and tricks] see Pablo Iranzo's site<br />
[[Image:OCS-buildpackage.png]]<br><br />
----<br />
After creating the deployment package, you should get this successful screen:<br />
[[Image:OCS-success-build.png]]<br><br />
----<br />
<br />
====Activating deployment packages====<br />
Once a package is added, you need to activate it.<br />
[[Image:OCS-activate-package1.png]]<br><br />
----<br />
Provide paths to download folder. As this feature is LAN ONLY, provide internal name or IP address for both fields.<br />
<br />
Be careful, this path will be resolved by the agent (value ''localhost'' forbidden here!)<br />
<br />
[[Image:OCS-activate-package2.png]]<br><br />
----<br />
Don't pay attention to the warning messages when activating, Just click Yes.<br />
[[Image:OCS-activate-package3.png]]<br><br />
----<br />
You can also ignore any warning messages when deleting a package, the package is removed.<br />
<br />
====Activated deployment packages====<br />
Here you will be able to see activated packages...<br />
[[Image:OCS-activated-package.png]]<br><br />
<br />
===Deploying your packages===<br />
All should be ready to go now!<br />
<br />
The final step is to affect the created package to computers...<br />
<br />
Here's a quick howto for deploying the package ''on a single computer''.<br />
<br />
To learn how to deploy on multiple computers, see section 8.5 of the help file.<br />
<br />
<br />
Open the desired computer's inventory on click on ''Config'' icon and add a new package<br />
[[Image:OCS-deploy-single-pc1.png]]<br><br />
----<br />
You should see all activated packages, affect the one you want and confirm changes<br />
[[Image:OCS-deploy-single-pc2.png]]<br><br />
----<br />
Back at Config page, you should now see affected packages and their states.<br />
[[Image:OCS-deploy-single-pc3.png]]<br><br />
----<br />
Next time the Agent contacts the server, it is notified of the package, and sometime later should be deployed! As usual, you can manually launch the agent to force the update.<br />
<br />
See section 8.1 of the help file to understand how download works<br />
<br />
=GLPI Usage=<br />
==Access==<br />
GLPI's web interface can be reached at http://your-server/glpi<br />
<br />
Login : glpi<br />
<br />
Password: glpi<br />
{{Warning box|For security-reasons, change admin's password after your first login!}}<br />
GLPI's web interface is only available from inside your network for security reasons by default.<br />
==Basics==<br />
[http://glpi-project.org/wiki/doku.php?id=en:welcome GLPI Wiki]<br />
<br />
[http://glpi-project.org/wiki/doku.php?id=en:begin What's next?]<br />
{{Incomplete}}<br />
===External authentication===<br />
You can configure GLPI so that your SME users can login. For this, we will use SME integrated IMAP feature.<br />
<br />
In GLPI interface, clic on ''Administration'' icon and open ''Setup'' menu. Then clic on ''External Authentications''.<br />
<br />
Settings are on the screenshot:<br />
[[Image:GLPI-imap-auth.png]]<br><br />
----<br />
Apply your changes. SME users can now connect with their existing user+password into GLPI interface!<br />
<br />
Logout and login with an existing SME account:<br />
[[Image:GLPI-user-interface.png]]<br><br />
----<br />
===Sync GLPI with OCS===<br />
You can import OCS inventories into GLPI.<br />
Simply clic on ''OCSNG'' in ''Tools'' menu.<br />
[[Image:GLPI-sync-OCS-1.png]]<br><br />
----<br />
Then Import/Update OCS inventories into GLPI<br />
[[Image:GLPI-sync-OCS-2.png]]<br><br />
----<br />
<br />
==Advanced==<br />
===Sync GLPI with LDAP===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]<br />
{{Incomplete}}<br />
===Sync GLPI with Active Directory===<br />
[http://glpi-project.org/wiki/doku.php?id=en:ldap Related GLPI Wiki article]<br />
{{Incomplete}}<br />
==Plugins==<br />
[http://glpi-project.org/wiki/doku.php?id=en:plugins Related GLPI Wiki article]<br />
{{Incomplete}}<br />
<br />
=Additional information=<br />
*[http://www.ocsinventory-ng.org/ OCS website]<br />
*[http://www.glpi-project.org/ GLPI website]<br />
*[http://www.ocsinventory-ng.org/index.php?page=1-01 OCS download section]<br />
*[http://forums.ocsinventory-ng.org/ OCS forums ]<br />
*[http://remi.collet.free.fr/rpms/ Rémi Collet's RPMs repo]<br />
<br />
Initial howtos:<br />
*[http://sme.firewall-services.com/spip.php?article42 Howto]<br />
*[http://www.dlaoctet.com/index.php/2006/10/12/17-installer-ocs-next-generation-inventory-et-glpi Old version howto]<br />
<br />
<br />
''Stefen Noble (Snoble)''<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Administration]]</div>Cool34000https://wiki.koozali.org/index.php?title=KPlaylist/fr&diff=9313KPlaylist/fr2008-04-23T17:10:01Z<p>Cool34000: /* Installation */ fix</p>
<hr />
<div>{{Languages|KPlaylist}}<br />
<br />
=Maintaineur=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
=Description de kPlaylist=<br />
[http://www.kplaylist.net/ kPlaylist] est un système PHP gratuit qui créé votre collection de musique via Internet. <br />
<br />
[http://www.kplaylist.net/ kPlaylist] est une base de données musicale que vous pouvez gérer via le web. Avec kPlaylist vous pouvez diffuser votre musique (ogg, mp3, wav, wma, etc.), vous pouvez uploader, créer des playlists, partager, effectuer des recherches, télécharger et bien plus encore.<br />
<br />
[http://www.kplaylist.net/index.php?readmore=true Plus] d'informations sur kPlaylist et liste des [http://www.kplaylist.net/index.php?features=true fonctionnalités].<br />
<br />
=RPM kPlaylist=<br />
==Installation==<br />
Pour installer kPlaylist, tapez la commande suivante :<br />
yum install smeserver-kplaylist --enablerepo=smecontribs<br />
Vous pouvez ignorer les messages YUM ''signal event post-upgrade'' et ''signal-event reboot''.<br />
<br />
==Commandes spéciales==<br />
Pour voir la configuration de kPlaylist, tapez la commande suivante au prompt :<br />
config show kplaylist<br />
Vous pouvez changer quelques paramètres :<br />
Paramètre DB | Options | Défaut | Explication<br />
# HTTPS | on/off | off | Active/Désactive le mode https forcé<br />
# PublicAccess | local/global | local | Accessibilité de l'interface web<br />
# MaxUpload | xM | 16M | Taille maxi des fichiers à envoyer<br />
# URL | nouvel alias | | Alias optionnel pour kPlaylist<br />
Après toute modification de la configuration de kPlaylist, vous devez appliquez vos changements avec les commandes suivantes :<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Exemple: Vous désirez changer l'accessibilité de l'interface web à "global"<br />
config setprop kplaylist PublicAccess global<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
<br />
==Mise à jour==<br />
Le RPM installe la dernière version stable (1.7.426). Si vous souhaitez essayer la version de développement (1.7.464) ou effectuer une installation personnalisée, uploadez simplement le nouveau fichier dans '''''/opt/kplaylist/html/'''''.<br />
<br />
Puis éditez ce fichier et changez le mot de passe MySQL password à la ligne #71<br />
'pass' => 'kplaylist', # MySql password<br />
Vous pouvez retrouver votre mot de passe existant en tapant la commande suivante :<br />
config getprop kplaylist DbPassword<br />
Puis renommez ce fichier en ''index.php'' et appliquez la sécurité :<br />
mv -f /opt/kplaylist/hmtl/kplaylist.1.7.464.php /opt/kplaylist/hmtl/index.php<br />
chown root:www /opt/kplaylist/hmtl/index.php<br />
chmod 660 /opt/kplaylist/hmtl/index.php<br />
Pour terminer, vous aurez besoin de mettre à jour la base de données. Cette étape sera réalisée à votre 1ère connexion.<br />
<br />
==Désinstallation==<br />
Pour désinstaller kPlaylist, tapez simplement la commande suivante :<br />
yum remove smeserver-kplaylist<br />
Vous pouvez ignorer les messages YUM ''signal event post-upgrade'' et ''signal-event reboot''.<br />
<br />
Pour supprimer complètement kPlaylist (fichiers d'installation + utilisateur/base de données MySQL) vous devrez lancez la commande suivante :<br />
sh /root/KPlaylist-Full-Uninstall.sh<br />
{{Warning box|Le répertoire de MP3 par défaut sera supprimé durant cette opération par le script ! Déplacez vos fichiers avant de lancer ce script !}}<br />
<br />
=Utilisation de kPlaylist=<br />
==Accès Web==<br />
L'interface web de kPlaylist est disponible sur le LAN UNIQUEMENT par défaut (sans HTTPS)<br />
<br />
Vous pouvez accéder à l'interface à l'adresse http://yourserver/kplaylist<br />
login : admin<br />
pass : admin<br />
Veuillez changer le mot de passe admin en 1er !<br />
==Premiers pas==<br />
Le concept de kPlaylist est assez simple à comprendre : <br />
1) Uploadez votre musique dans '''''/opt/kplaylist/files''''' (voir les 3 sections suivantes pour plus de détails)<br />
2) Mettez à jour la base de données en utilisation la console d'administration (bouton Actualiser)<br />
3) Enjoy!<br />
==Upload==<br />
Les utilisateurs enregistrés peuvent uploader des fichiers (16M maxi par défaut). Ces fichiers seront stockés dans '''''/opt/kplaylist/files''''' par défaut.<br />
<br />
Ce dossier est également le dossier de MP3 par défaut !<br />
==Accès Samba==<br />
Pour un téléchargement/envoi plus rapide, vous pouvez utiliser Samba pour accéder à '''''/opt/kplaylist/files'''''.<br />
<br />
Parcourez simplement les partages de votre serveur SME server, vous devriez voir un dossier nommé '''''kplaylist'''''.<br />
<br />
Seul l'administrateur SME peut parcourir ce dossier partagé après l'installation du RPM.<br />
<br />
Si vous souhaitez autoriser tous les utilisateurs SME à parcourir ce dossier, tapez la commande suivante :<br />
chown -R root:shared /opt/kplaylist/files<br />
Pour revenir aux réglages par défaut, tapez la commande suivante :<br />
chown -R www:www /opt/kplaylist/files<br />
<br />
<br />
Par défaut, les utilisateurs francophone pourrait rencontrer des problèmes de noms lors des transferts via Samba. Pour régler ce problème de jeu de caractères, appliquez le paramétrage suivant :<br />
db configuration setprop smb UnixCharSet ISO8859-1<br />
expand-template /etc/smb.conf<br />
/etc/init.d/smb restart<br />
Les nouveaux dossiers/fichiers envoyés utiliseront le bon jeux de caractères ! Attention, ceci est également valable pour le reste de vos ibays !<br />
<br />
==Ajouter plus de dossiers source==<br />
kPlaylist est compatible avec plusieurs sources musicales (lecteurs, répertoires, nmb, smbfs, nfs, etc).<br />
<br />
L'option ''FollowSymLinks'' est également disponible, ce qui signifie que vous pouvez utiliser des liens symboliques à l'intérieur du dossier '''''/opt/kplaylist/files'''''.<br />
<br />
Rappellez vous simplement que l'accès de kPlaylist est restreint à /opt/kplaylist par défaut, vous devriez opérer tout changement '''dans un custom-template''' pour autoriser l'accès au dossier souhaité.<br />
'''Rappel: Procédure correcte pour créer un custom-template'''<br />
# Créez le dossier s'il n'existe pas déja<br />
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf<br />
<br />
# Copiez le template original<br />
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/98kplaylist /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/<br />
<br />
# Editez ''/etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/98kplaylist''<br />
# Remplacez la ligne #34 avec vos changements désirés<br />
php_admin_value open_basedir /opt/kplaylist:/tmp:/usr/share/pear''':/home/e-smith/files/ibays/mp3_ibay/files''' ''(juste un exemple)''<br />
<br />
# Appliquez vos changements<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Vérifiez qu'Apache (''www'' ou ''shared'') puisse accéder en lecture/écriture au nouveau dossier et ses fichiers.<br />
<br />
Maintenant rendez-vous dans l'interface web de kPlaylist et connectez vous avec le compte admin. Cliquez sur ''Config'' dans la console d'administration. Puis cliquez sur ''Gestion de la librairie'' et ajouter manuellement votre nouveau chemin à la liste (ou créez un lien symbolique).<br />
<br />
==Téléchargement Multiple==<br />
Si vous souhaitez activer le téléchargement multiple, éditez le fichier '''''/opt/kplaylist/html/index.php''''' et passez la valeur suivante à 'true' :<br />
$cfg['archivemode'] = true;<br />
Maitenant vous avez plus d'options pour le téléchargement !<br />
==mp3mail==<br />
kPlaylist est capable d'envoyer des mails. Si vous désirez utiliser cette fonctionnalité, vous devez paramétrer dans MySQL ''max_allowed_packet'' (sinon vous obtiendrez une page d'erreur lors de vos tentatives d'envoi).<br />
<br />
Créez le fichier '''''/etc/e-smith/templates/etc/my.cnf/011max-allowed-packet''''' s'il n'existe pas déja et coller le code suivant dedans :<br />
max_allowed_packet=32M (vous pourriez avoir besoin d'augmenter cette valeur)<br />
<br />
Puis appliquez vos modifications:<br />
expand-template /etc/my.cnf<br />
service mysqld restart<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
==Support ID3v2==<br />
getid3 v1.7.x est le lecteur de tag par défaut recommandé pour kPlaylist. Si vous souhaitez ajouter cette fonctionnalité à votre kPlaylist, suivez ce guide rapide.<br />
<br />
Pour commencer, vérifier la dernière version disponible [http://sourceforge.net/project/showfiles.php?group_id=55859&package_id=50965 ici].<br />
wget http://surfnet.dl.sourceforge.net/sourceforge/getid3/getid3-1.7.7.zip<br />
unzip getid3-1.7.7.zip -d /opt/kplaylist/<br />
rm -f getid3-1.7.7.zip<br />
Editez le fichier '''''/opt/kplaylist/html/index.php''''' et modifiez les lignes suivantes :<br />
*Ligne #95, activez ''getid3''<br />
$cfg['enablegetid3'] = 1;<br />
*Ligne #98, renseignez le chemin d'accès vers ''getid3.php''<br />
$cfg['getid3include'] = '/opt/kplaylist/getid3/getid3/getid3.php';<br />
Sauvegardez le fichier et vérifiez le bon fonctionnement : connectez vous en tant qu'admin dans kPlaylist, cliquez sur Config puis sur 'Gestion de la librairie'. Si 'Ecrire les ID3v2 dans le flux' n'est pas grisé, getid3 devrait fonctionner. Vous devriez voir également le numéro de version sur la droite.<br />
==Tâche planifiée==<br />
Une tâche planifiée (cron) peut être créée pour mettre à jour la base de données de kPlaylist. Ceci a le même effet que de cliquer sur "Actualiser" dans la console d'administration.<br />
<br />
Editez '''''/opt/kplaylist/html/index.php''''' et modifiez les lignes suivantes :<br />
*Ligne 125, activez 'autoupdate'<br />
$cfg['autoupdate'] = 1;<br />
*Eventuellement, enlevez le commentaire ('//') aux lignes 8977, 8978 et 8979<br />
$options['deleteunused'] = 1; # Si vous désirez enlever de la base de données les fichiers qui ont étés supprimés<br />
$options['rebuildid3'] = 1; # Si vous souhaitez relire toutes les informations de vos fichiers musicaux (OGG/MP3).<br />
$options['debugmode'] = 1; # Si vous voulez le mode debug<br />
Vous pouvez vérifier le bon fonctionnement à l'adresse http://votreserveur/kplaylist/index.php?update=5000&user=autooperate<br />
<br />
Vous devriez voir ce message : '''Wrong host (VOTRE IP) or user (autooperate) for update.'''<br />
<br />
<br />
Créez un template nommé ''kplaylist'' dans '''''/etc/e-smith/templates/etc/cron.d/''''' et coller le code suivant dedans :<br />
# kPlaylist database update cron job<br />
<br />
# ___________ Minute (de 0 à 59)<br />
#| ________ Heure (de 0 à 23)<br />
#| | ______ Jour (de 1 à 31)<br />
#| | | ____ Mois (de 1 à 12)<br />
#| | | | __ Jour de la semaine (de 0 à 6 - 0 est dimanche) <br />
#| | | | |<br />
#v v v v v<br />
30 23 * * * /usr/bin/lynx -dump "http://127.0.0.1/kplaylist/index.php?update=5000&user=autooperate"<br />
Enregistrez le fichier et appliquez vos modifications avec la commande suivante :<br />
expand-template /etc/cron.d/kplaylist<br />
Maintenant, tous les jours à 23:30 le serveur effectuera une mise à jour automatique de la base de données kPlaylist.<br />
<br />
=Informations additionelles=<br />
*[http://www.kplaylist.net/ Homepage]<br />
*[http://www.kplaylist.net/index.php?documentation=true Documentation]<br />
*[http://www.kplaylist.net/forum/ Forums]<br />
*[http://www.kplaylist.net/index.php?download=true Section téléchargement]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=KPlaylist&diff=9312KPlaylist2008-04-23T17:09:12Z<p>Cool34000: /* Install */ fix</p>
<hr />
<div>{{Languages|KPlaylist}}<br />
<br />
=Maintainer=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
=kPlaylist Description=<br />
[http://www.kplaylist.net/ kPlaylist] is a free PHP system that makes your music collection available via the Internet. <br />
<br />
[http://www.kplaylist.net/ kPlaylist] is a music database that you manage via the web. With kPlaylist you can stream your music (ogg, mp3, wav, wma, etc.), you can upload, make playlists, share, search, download and a lot more.<br />
<br />
Read [http://www.kplaylist.net/index.php?readmore=true more] about kPlaylist and check the [http://www.kplaylist.net/index.php?features=true features].<br />
<br />
=kPlaylist RPM=<br />
==Install==<br />
To install kPlaylist, issue the following command:<br />
yum install smeserver-kplaylist --enablerepo=smecontribs<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
==Special commands==<br />
To view kPlaylist's configuration, you can type the following at the prompt:<br />
config show kplaylist<br />
You can change a few parameters:<br />
DB parameter | Options | Default | Explanation<br />
# HTTPS | on/off | off | Enable/Disable forced https mode of web interface<br />
# PublicAccess | local/global | local | Accessibility of web interface<br />
# MaxUpload | xM | 16M | Max uploadable file size<br />
# URL | new alias | | Optionnal alias for kPlaylist<br />
<br />
After any change to kPlaylist configuration, you should apply modifications by typing the following at the prompt:<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Example: You want to change PublicAccess to "global"<br />
config setprop kplaylist PublicAccess global<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
<br />
==Update==<br />
The RPM installs the latest stable version (1.7.426). If you want to try the development release (1.7.464) or a custom install, simply upload the new file in '''''/opt/kplaylist/html/'''''.<br />
<br />
Then edit this file and change MySQL password at line #71<br />
'pass' => 'kplaylist', # MySql password<br />
You can retrieve your existing MySQL password with the following command:<br />
config getprop kplaylist DbPassword<br />
Then rename the file into ''index.php'' and apply security:<br />
mv -f /opt/kplaylist/hmtl/kplaylist.1.7.464.php /opt/kplaylist/hmtl/index.php<br />
chown root:www /opt/kplaylist/hmtl/index.php<br />
chmod 660 /opt/kplaylist/hmtl/index.php<br />
Then you may need to update the database, this extra step will be done at your first login.<br />
<br />
==Uninstall==<br />
To uninstall kPlaylist, just hit the following command:<br />
yum remove smeserver-kplaylist<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To completly remove kPlaylist (installation files ; MySQL user+database) you will need the following command:<br />
sh /root/KPlaylist-Full-Uninstall.sh<br />
{{Warning box|Default MP3 folder will be deleted by this script! Move your files before launching this script!}}<br />
<br />
=kPlaylist Usage=<br />
==Web Access==<br />
kPlaylist web interface is LAN ONLY by default (without HTTPS)<br />
<br />
You can access the web interface at http://yourserver/kplaylist<br />
login : admin<br />
pass : admin<br />
Please change admin password first!<br />
==Getting started==<br />
kPlaylist's concept is pretty easy to understand:<br />
1) Upload your music in '''''/opt/kplaylist/files'''''(see the 3 following sections for more details)<br />
2) Update your database using Administration console ''Update''<br />
3) Enjoy!<br />
==Upload==<br />
Registered users can upload files. These files will be stored in '''''/opt/kplaylist/files''''' by default.<br />
<br />
The default maximum uploadable file size is 16M (could be enough for most needs). You can modify this default value with following commands:<br />
config setprop kplaylist MaxUpload ''xx''M<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
where ''xx'' is your needed size (don't forget the '''M'''!)<br />
==Samba Access==<br />
For faster local downloading/uploading you can use Samba to access '''''/opt/kplaylist/files'''''.<br />
<br />
Simply browse your SME server shares and you will see a folder named '''''kplaylist'''''.<br />
<br />
Only SME Admin account will be able to browse this new shared folder after the RPM install.<br />
<br />
If you want to allow all SME users to browse this directory, issue the following command:<br />
chown -R root:shared /opt/kplaylist/files<br />
If you want to revert to default, issue the following command:<br />
chown -R www:www /opt/kplaylist/files<br />
<br />
==Adding more sources folders==<br />
kPlaylist Supports multiple music sources (drives, directories, nmb, smbfs, nfs, etc).<br />
<br />
Option ''FollowSymLinks'' is also available which means that you can use symbolic links inside '''''/opt/kplaylist/files'''''.<br />
<br />
Just remember that kPlaylist is restricted to /opt/kplaylist by default, you should override the existing template '''with a custom-template''' to allow access to the needed folder.<br />
'''Reminder: Correct procedure to create a custom-template'''<br />
# Create the folder if not exist<br />
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf<br />
<br />
# Copy original template<br />
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/98kplaylist /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/<br />
<br />
# Edit ''/etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/98kplaylist''<br />
# Replace line #34 with your needed settings<br />
php_admin_value open_basedir /opt/kplaylist:/tmp:/usr/share/pear''':/home/e-smith/files/ibays/mp3_ibay/files''' ''(just an example)''<br />
<br />
# Apply your changes<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Verify that Apache (''www'' or ''shared'') have read/write access to the new folder and files.<br />
<br />
Now go to kPlaylist web interface and login with the admin account. Click on Admin control ''Settings''. Then click on ''Filehandling'' and manually add your new path to the list (or create a symbolic link).<br />
<br />
==Multiple Download==<br />
If you want to allow multiple download, edit '''''/opt/kplaylist/html/index.php''''' and modify the following value to true:<br />
$cfg['archivemode'] = true;<br />
Now you will have more download options!<br />
==mp3mail==<br />
kPlaylist can send mail. If you want to use this feature, you need to tweak MySQL ''max_allowed_packet'' (else you will see an error page when trying to send mails).<br />
<br />
Create the file '''''/etc/e-smith/templates/etc/my.cnf/011max-allowed-packet''''' if it doesn't exist and paste the following code in it:<br />
max_allowed_packet=32M (you may need to higher this value)<br />
<br />
Then apply new modifications:<br />
expand-template /etc/my.cnf<br />
service mysqld restart<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
==ID3v2 support==<br />
getid3 v1.7.x is the default recommended tag reader for kPlaylist. If you want to add this feature to your kPlaylist, just follow this quick howto.<br />
<br />
First, Check the latest version [http://sourceforge.net/project/showfiles.php?group_id=55859&package_id=50965 here].<br />
wget http://surfnet.dl.sourceforge.net/sourceforge/getid3/getid3-1.7.7.zip<br />
unzip getid3-1.7.7.zip -d /opt/kplaylist/<br />
rm -f getid3-1.7.7.zip<br />
Now edit '''''/opt/kplaylist/html/index.php''''' and modify following lines:<br />
*Line #95, enable ''getid3''<br />
$cfg['enablegetid3'] = 1;<br />
*Line #98, provide path to getid3.php<br />
$cfg['getid3include'] = '/opt/kplaylist/getid3/getid3/getid3.php';<br />
Save the file and check if it's working: log in as a admin to kPlaylist, click on Settings and then on 'Filehandling'. If 'Write id3v2 with stream' is not disabled, getid3 should be working. You should also see the version number in the right.<br />
==Cron job==<br />
A cron job can be created to update kPlaylist's database. This has the same effect of clicking on "Update" button in Administration console.<br />
<br />
Edit '''''/opt/kplaylist/html/index.php''''' and modify following lines:<br />
*Line 125, enable autoupdate<br />
$cfg['autoupdate'] = 1;<br />
*Optionnaly, uncomment lines 8977, 8978 and 8979<br />
$options['deleteunused'] = 1; # Uncomment if you want to remove deleted files from the database<br />
$options['rebuildid3'] = 1; # Uncomment if you want to reread all the information from your music files (OGG/MP3).<br />
$options['debugmode'] = 1; # Uncomment if you want to enable debug mode<br />
You can check that it's working at http://yourserver/kplaylist/index.php?update=5000&user=autooperate<br />
<br />
You should get this message: '''Wrong host (YOUR IP) or user (autooperate) for update.'''<br />
<br />
<br />
Create a template called ''kplaylist'' in '''''/etc/e-smith/templates/etc/cron.d/''''' and paste the following code in it:<br />
# kPlaylist database update cron job<br />
<br />
# ___________ Minute (from 0 to 59)<br />
#| ________ Hour (from 0 to 23)<br />
#| | ______ Day (from 1 to 31)<br />
#| | | ____ Month (from 1 to 12)<br />
#| | | | __ Day of week (from 0 to 6 - 0 is sunday) <br />
#| | | | |<br />
#v v v v v<br />
30 23 * * * /usr/bin/lynx -dump "http://127.0.0.1/kplaylist/index.php?update=5000&user=autooperate"<br />
Save the file and apply modifications with the following command:<br />
expand-template /etc/cron.d/kplaylist<br />
Now each day at 23:30 the server will auto-update kPlaylist database.<br />
<br />
=Additional information=<br />
*[http://www.kplaylist.net/ Homepage]<br />
*[http://www.kplaylist.net/index.php?documentation=true Documentation]<br />
*[http://www.kplaylist.net/forum/ Forums]<br />
*[http://www.kplaylist.net/index.php?download=true Download section]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Webapps]]</div>Cool34000https://wiki.koozali.org/index.php?title=KPlaylist/fr&diff=9311KPlaylist/fr2008-04-23T17:02:17Z<p>Cool34000: new repo fix</p>
<hr />
<div>{{Languages|KPlaylist}}<br />
<br />
=Maintaineur=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
=Description de kPlaylist=<br />
[http://www.kplaylist.net/ kPlaylist] est un système PHP gratuit qui créé votre collection de musique via Internet. <br />
<br />
[http://www.kplaylist.net/ kPlaylist] est une base de données musicale que vous pouvez gérer via le web. Avec kPlaylist vous pouvez diffuser votre musique (ogg, mp3, wav, wma, etc.), vous pouvez uploader, créer des playlists, partager, effectuer des recherches, télécharger et bien plus encore.<br />
<br />
[http://www.kplaylist.net/index.php?readmore=true Plus] d'informations sur kPlaylist et liste des [http://www.kplaylist.net/index.php?features=true fonctionnalités].<br />
<br />
=RPM kPlaylist=<br />
==Installation==<br />
Pour installer kPlaylist, tapez la commande suivante :<br />
yum localinstall smeserver-kplaylist<br />
Vous pouvez ignorer les messages YUM ''signal event post-upgrade'' et ''signal-event reboot''.<br />
==Commandes spéciales==<br />
Pour voir la configuration de kPlaylist, tapez la commande suivante au prompt :<br />
config show kplaylist<br />
Vous pouvez changer quelques paramètres :<br />
Paramètre DB | Options | Défaut | Explication<br />
# HTTPS | on/off | off | Active/Désactive le mode https forcé<br />
# PublicAccess | local/global | local | Accessibilité de l'interface web<br />
# MaxUpload | xM | 16M | Taille maxi des fichiers à envoyer<br />
# URL | nouvel alias | | Alias optionnel pour kPlaylist<br />
Après toute modification de la configuration de kPlaylist, vous devez appliquez vos changements avec les commandes suivantes :<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Exemple: Vous désirez changer l'accessibilité de l'interface web à "global"<br />
config setprop kplaylist PublicAccess global<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
<br />
==Mise à jour==<br />
Le RPM installe la dernière version stable (1.7.426). Si vous souhaitez essayer la version de développement (1.7.464) ou effectuer une installation personnalisée, uploadez simplement le nouveau fichier dans '''''/opt/kplaylist/html/'''''.<br />
<br />
Puis éditez ce fichier et changez le mot de passe MySQL password à la ligne #71<br />
'pass' => 'kplaylist', # MySql password<br />
Vous pouvez retrouver votre mot de passe existant en tapant la commande suivante :<br />
config getprop kplaylist DbPassword<br />
Puis renommez ce fichier en ''index.php'' et appliquez la sécurité :<br />
mv -f /opt/kplaylist/hmtl/kplaylist.1.7.464.php /opt/kplaylist/hmtl/index.php<br />
chown root:www /opt/kplaylist/hmtl/index.php<br />
chmod 660 /opt/kplaylist/hmtl/index.php<br />
Pour terminer, vous aurez besoin de mettre à jour la base de données. Cette étape sera réalisée à votre 1ère connexion.<br />
<br />
==Désinstallation==<br />
Pour désinstaller kPlaylist, tapez simplement la commande suivante :<br />
yum remove smeserver-kplaylist<br />
Vous pouvez ignorer les messages YUM ''signal event post-upgrade'' et ''signal-event reboot''.<br />
<br />
Pour supprimer complètement kPlaylist (fichiers d'installation + utilisateur/base de données MySQL) vous devrez lancez la commande suivante :<br />
sh /root/KPlaylist-Full-Uninstall.sh<br />
{{Warning box|Le répertoire de MP3 par défaut sera supprimé durant cette opération par le script ! Déplacez vos fichiers avant de lancer ce script !}}<br />
<br />
=Utilisation de kPlaylist=<br />
==Accès Web==<br />
L'interface web de kPlaylist est disponible sur le LAN UNIQUEMENT par défaut (sans HTTPS)<br />
<br />
Vous pouvez accéder à l'interface à l'adresse http://yourserver/kplaylist<br />
login : admin<br />
pass : admin<br />
Veuillez changer le mot de passe admin en 1er !<br />
==Premiers pas==<br />
Le concept de kPlaylist est assez simple à comprendre : <br />
1) Uploadez votre musique dans '''''/opt/kplaylist/files''''' (voir les 3 sections suivantes pour plus de détails)<br />
2) Mettez à jour la base de données en utilisation la console d'administration (bouton Actualiser)<br />
3) Enjoy!<br />
==Upload==<br />
Les utilisateurs enregistrés peuvent uploader des fichiers (16M maxi par défaut). Ces fichiers seront stockés dans '''''/opt/kplaylist/files''''' par défaut.<br />
<br />
Ce dossier est également le dossier de MP3 par défaut !<br />
==Accès Samba==<br />
Pour un téléchargement/envoi plus rapide, vous pouvez utiliser Samba pour accéder à '''''/opt/kplaylist/files'''''.<br />
<br />
Parcourez simplement les partages de votre serveur SME server, vous devriez voir un dossier nommé '''''kplaylist'''''.<br />
<br />
Seul l'administrateur SME peut parcourir ce dossier partagé après l'installation du RPM.<br />
<br />
Si vous souhaitez autoriser tous les utilisateurs SME à parcourir ce dossier, tapez la commande suivante :<br />
chown -R root:shared /opt/kplaylist/files<br />
Pour revenir aux réglages par défaut, tapez la commande suivante :<br />
chown -R www:www /opt/kplaylist/files<br />
<br />
<br />
Par défaut, les utilisateurs francophone pourrait rencontrer des problèmes de noms lors des transferts via Samba. Pour régler ce problème de jeu de caractères, appliquez le paramétrage suivant :<br />
db configuration setprop smb UnixCharSet ISO8859-1<br />
expand-template /etc/smb.conf<br />
/etc/init.d/smb restart<br />
Les nouveaux dossiers/fichiers envoyés utiliseront le bon jeux de caractères ! Attention, ceci est également valable pour le reste de vos ibays !<br />
<br />
==Ajouter plus de dossiers source==<br />
kPlaylist est compatible avec plusieurs sources musicales (lecteurs, répertoires, nmb, smbfs, nfs, etc).<br />
<br />
L'option ''FollowSymLinks'' est également disponible, ce qui signifie que vous pouvez utiliser des liens symboliques à l'intérieur du dossier '''''/opt/kplaylist/files'''''.<br />
<br />
Rappellez vous simplement que l'accès de kPlaylist est restreint à /opt/kplaylist par défaut, vous devriez opérer tout changement '''dans un custom-template''' pour autoriser l'accès au dossier souhaité.<br />
'''Rappel: Procédure correcte pour créer un custom-template'''<br />
# Créez le dossier s'il n'existe pas déja<br />
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf<br />
<br />
# Copiez le template original<br />
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/98kplaylist /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/<br />
<br />
# Editez ''/etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/98kplaylist''<br />
# Remplacez la ligne #34 avec vos changements désirés<br />
php_admin_value open_basedir /opt/kplaylist:/tmp:/usr/share/pear''':/home/e-smith/files/ibays/mp3_ibay/files''' ''(juste un exemple)''<br />
<br />
# Appliquez vos changements<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Vérifiez qu'Apache (''www'' ou ''shared'') puisse accéder en lecture/écriture au nouveau dossier et ses fichiers.<br />
<br />
Maintenant rendez-vous dans l'interface web de kPlaylist et connectez vous avec le compte admin. Cliquez sur ''Config'' dans la console d'administration. Puis cliquez sur ''Gestion de la librairie'' et ajouter manuellement votre nouveau chemin à la liste (ou créez un lien symbolique).<br />
<br />
==Téléchargement Multiple==<br />
Si vous souhaitez activer le téléchargement multiple, éditez le fichier '''''/opt/kplaylist/html/index.php''''' et passez la valeur suivante à 'true' :<br />
$cfg['archivemode'] = true;<br />
Maitenant vous avez plus d'options pour le téléchargement !<br />
==mp3mail==<br />
kPlaylist est capable d'envoyer des mails. Si vous désirez utiliser cette fonctionnalité, vous devez paramétrer dans MySQL ''max_allowed_packet'' (sinon vous obtiendrez une page d'erreur lors de vos tentatives d'envoi).<br />
<br />
Créez le fichier '''''/etc/e-smith/templates/etc/my.cnf/011max-allowed-packet''''' s'il n'existe pas déja et coller le code suivant dedans :<br />
max_allowed_packet=32M (vous pourriez avoir besoin d'augmenter cette valeur)<br />
<br />
Puis appliquez vos modifications:<br />
expand-template /etc/my.cnf<br />
service mysqld restart<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
==Support ID3v2==<br />
getid3 v1.7.x est le lecteur de tag par défaut recommandé pour kPlaylist. Si vous souhaitez ajouter cette fonctionnalité à votre kPlaylist, suivez ce guide rapide.<br />
<br />
Pour commencer, vérifier la dernière version disponible [http://sourceforge.net/project/showfiles.php?group_id=55859&package_id=50965 ici].<br />
wget http://surfnet.dl.sourceforge.net/sourceforge/getid3/getid3-1.7.7.zip<br />
unzip getid3-1.7.7.zip -d /opt/kplaylist/<br />
rm -f getid3-1.7.7.zip<br />
Editez le fichier '''''/opt/kplaylist/html/index.php''''' et modifiez les lignes suivantes :<br />
*Ligne #95, activez ''getid3''<br />
$cfg['enablegetid3'] = 1;<br />
*Ligne #98, renseignez le chemin d'accès vers ''getid3.php''<br />
$cfg['getid3include'] = '/opt/kplaylist/getid3/getid3/getid3.php';<br />
Sauvegardez le fichier et vérifiez le bon fonctionnement : connectez vous en tant qu'admin dans kPlaylist, cliquez sur Config puis sur 'Gestion de la librairie'. Si 'Ecrire les ID3v2 dans le flux' n'est pas grisé, getid3 devrait fonctionner. Vous devriez voir également le numéro de version sur la droite.<br />
==Tâche planifiée==<br />
Une tâche planifiée (cron) peut être créée pour mettre à jour la base de données de kPlaylist. Ceci a le même effet que de cliquer sur "Actualiser" dans la console d'administration.<br />
<br />
Editez '''''/opt/kplaylist/html/index.php''''' et modifiez les lignes suivantes :<br />
*Ligne 125, activez 'autoupdate'<br />
$cfg['autoupdate'] = 1;<br />
*Eventuellement, enlevez le commentaire ('//') aux lignes 8977, 8978 et 8979<br />
$options['deleteunused'] = 1; # Si vous désirez enlever de la base de données les fichiers qui ont étés supprimés<br />
$options['rebuildid3'] = 1; # Si vous souhaitez relire toutes les informations de vos fichiers musicaux (OGG/MP3).<br />
$options['debugmode'] = 1; # Si vous voulez le mode debug<br />
Vous pouvez vérifier le bon fonctionnement à l'adresse http://votreserveur/kplaylist/index.php?update=5000&user=autooperate<br />
<br />
Vous devriez voir ce message : '''Wrong host (VOTRE IP) or user (autooperate) for update.'''<br />
<br />
<br />
Créez un template nommé ''kplaylist'' dans '''''/etc/e-smith/templates/etc/cron.d/''''' et coller le code suivant dedans :<br />
# kPlaylist database update cron job<br />
<br />
# ___________ Minute (de 0 à 59)<br />
#| ________ Heure (de 0 à 23)<br />
#| | ______ Jour (de 1 à 31)<br />
#| | | ____ Mois (de 1 à 12)<br />
#| | | | __ Jour de la semaine (de 0 à 6 - 0 est dimanche) <br />
#| | | | |<br />
#v v v v v<br />
30 23 * * * /usr/bin/lynx -dump "http://127.0.0.1/kplaylist/index.php?update=5000&user=autooperate"<br />
Enregistrez le fichier et appliquez vos modifications avec la commande suivante :<br />
expand-template /etc/cron.d/kplaylist<br />
Maintenant, tous les jours à 23:30 le serveur effectuera une mise à jour automatique de la base de données kPlaylist.<br />
<br />
=Informations additionelles=<br />
*[http://www.kplaylist.net/ Homepage]<br />
*[http://www.kplaylist.net/index.php?documentation=true Documentation]<br />
*[http://www.kplaylist.net/forum/ Forums]<br />
*[http://www.kplaylist.net/index.php?download=true Section téléchargement]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=KPlaylist&diff=9310KPlaylist2008-04-23T17:01:17Z<p>Cool34000: new repo fix</p>
<hr />
<div>{{Languages|KPlaylist}}<br />
<br />
=Maintainer=<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
=kPlaylist Description=<br />
[http://www.kplaylist.net/ kPlaylist] is a free PHP system that makes your music collection available via the Internet. <br />
<br />
[http://www.kplaylist.net/ kPlaylist] is a music database that you manage via the web. With kPlaylist you can stream your music (ogg, mp3, wav, wma, etc.), you can upload, make playlists, share, search, download and a lot more.<br />
<br />
Read [http://www.kplaylist.net/index.php?readmore=true more] about kPlaylist and check the [http://www.kplaylist.net/index.php?features=true features].<br />
<br />
=kPlaylist RPM=<br />
==Install==<br />
To install kPlaylist, issue the following command:<br />
yum localinstall smeserver-kplaylist<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
==Special commands==<br />
To view kPlaylist's configuration, you can type the following at the prompt:<br />
config show kplaylist<br />
You can change a few parameters:<br />
DB parameter | Options | Default | Explanation<br />
# HTTPS | on/off | off | Enable/Disable forced https mode of web interface<br />
# PublicAccess | local/global | local | Accessibility of web interface<br />
# MaxUpload | xM | 16M | Max uploadable file size<br />
# URL | new alias | | Optionnal alias for kPlaylist<br />
<br />
After any change to kPlaylist configuration, you should apply modifications by typing the following at the prompt:<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Example: You want to change PublicAccess to "global"<br />
config setprop kplaylist PublicAccess global<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
<br />
==Update==<br />
The RPM installs the latest stable version (1.7.426). If you want to try the development release (1.7.464) or a custom install, simply upload the new file in '''''/opt/kplaylist/html/'''''.<br />
<br />
Then edit this file and change MySQL password at line #71<br />
'pass' => 'kplaylist', # MySql password<br />
You can retrieve your existing MySQL password with the following command:<br />
config getprop kplaylist DbPassword<br />
Then rename the file into ''index.php'' and apply security:<br />
mv -f /opt/kplaylist/hmtl/kplaylist.1.7.464.php /opt/kplaylist/hmtl/index.php<br />
chown root:www /opt/kplaylist/hmtl/index.php<br />
chmod 660 /opt/kplaylist/hmtl/index.php<br />
Then you may need to update the database, this extra step will be done at your first login.<br />
<br />
==Uninstall==<br />
To uninstall kPlaylist, just hit the following command:<br />
yum remove smeserver-kplaylist<br />
You can ignore the yum-comments ''signal event post-upgrade'' and ''signal-event reboot''.<br />
<br />
To completly remove kPlaylist (installation files ; MySQL user+database) you will need the following command:<br />
sh /root/KPlaylist-Full-Uninstall.sh<br />
{{Warning box|Default MP3 folder will be deleted by this script! Move your files before launching this script!}}<br />
<br />
=kPlaylist Usage=<br />
==Web Access==<br />
kPlaylist web interface is LAN ONLY by default (without HTTPS)<br />
<br />
You can access the web interface at http://yourserver/kplaylist<br />
login : admin<br />
pass : admin<br />
Please change admin password first!<br />
==Getting started==<br />
kPlaylist's concept is pretty easy to understand:<br />
1) Upload your music in '''''/opt/kplaylist/files'''''(see the 3 following sections for more details)<br />
2) Update your database using Administration console ''Update''<br />
3) Enjoy!<br />
==Upload==<br />
Registered users can upload files. These files will be stored in '''''/opt/kplaylist/files''''' by default.<br />
<br />
The default maximum uploadable file size is 16M (could be enough for most needs). You can modify this default value with following commands:<br />
config setprop kplaylist MaxUpload ''xx''M<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
where ''xx'' is your needed size (don't forget the '''M'''!)<br />
==Samba Access==<br />
For faster local downloading/uploading you can use Samba to access '''''/opt/kplaylist/files'''''.<br />
<br />
Simply browse your SME server shares and you will see a folder named '''''kplaylist'''''.<br />
<br />
Only SME Admin account will be able to browse this new shared folder after the RPM install.<br />
<br />
If you want to allow all SME users to browse this directory, issue the following command:<br />
chown -R root:shared /opt/kplaylist/files<br />
If you want to revert to default, issue the following command:<br />
chown -R www:www /opt/kplaylist/files<br />
<br />
==Adding more sources folders==<br />
kPlaylist Supports multiple music sources (drives, directories, nmb, smbfs, nfs, etc).<br />
<br />
Option ''FollowSymLinks'' is also available which means that you can use symbolic links inside '''''/opt/kplaylist/files'''''.<br />
<br />
Just remember that kPlaylist is restricted to /opt/kplaylist by default, you should override the existing template '''with a custom-template''' to allow access to the needed folder.<br />
'''Reminder: Correct procedure to create a custom-template'''<br />
# Create the folder if not exist<br />
mkdir -p /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf<br />
<br />
# Copy original template<br />
cp /etc/e-smith/templates/etc/httpd/conf/httpd.conf/98kplaylist /etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/<br />
<br />
# Edit ''/etc/e-smith/templates-custom/etc/httpd/conf/httpd.conf/98kplaylist''<br />
# Replace line #34 with your needed settings<br />
php_admin_value open_basedir /opt/kplaylist:/tmp:/usr/share/pear''':/home/e-smith/files/ibays/mp3_ibay/files''' ''(just an example)''<br />
<br />
# Apply your changes<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
Verify that Apache (''www'' or ''shared'') have read/write access to the new folder and files.<br />
<br />
Now go to kPlaylist web interface and login with the admin account. Click on Admin control ''Settings''. Then click on ''Filehandling'' and manually add your new path to the list (or create a symbolic link).<br />
<br />
==Multiple Download==<br />
If you want to allow multiple download, edit '''''/opt/kplaylist/html/index.php''''' and modify the following value to true:<br />
$cfg['archivemode'] = true;<br />
Now you will have more download options!<br />
==mp3mail==<br />
kPlaylist can send mail. If you want to use this feature, you need to tweak MySQL ''max_allowed_packet'' (else you will see an error page when trying to send mails).<br />
<br />
Create the file '''''/etc/e-smith/templates/etc/my.cnf/011max-allowed-packet''''' if it doesn't exist and paste the following code in it:<br />
max_allowed_packet=32M (you may need to higher this value)<br />
<br />
Then apply new modifications:<br />
expand-template /etc/my.cnf<br />
service mysqld restart<br />
expand-template /etc/httpd/conf/httpd.conf<br />
/etc/rc7.d/S86httpd-e-smith sigusr1<br />
==ID3v2 support==<br />
getid3 v1.7.x is the default recommended tag reader for kPlaylist. If you want to add this feature to your kPlaylist, just follow this quick howto.<br />
<br />
First, Check the latest version [http://sourceforge.net/project/showfiles.php?group_id=55859&package_id=50965 here].<br />
wget http://surfnet.dl.sourceforge.net/sourceforge/getid3/getid3-1.7.7.zip<br />
unzip getid3-1.7.7.zip -d /opt/kplaylist/<br />
rm -f getid3-1.7.7.zip<br />
Now edit '''''/opt/kplaylist/html/index.php''''' and modify following lines:<br />
*Line #95, enable ''getid3''<br />
$cfg['enablegetid3'] = 1;<br />
*Line #98, provide path to getid3.php<br />
$cfg['getid3include'] = '/opt/kplaylist/getid3/getid3/getid3.php';<br />
Save the file and check if it's working: log in as a admin to kPlaylist, click on Settings and then on 'Filehandling'. If 'Write id3v2 with stream' is not disabled, getid3 should be working. You should also see the version number in the right.<br />
==Cron job==<br />
A cron job can be created to update kPlaylist's database. This has the same effect of clicking on "Update" button in Administration console.<br />
<br />
Edit '''''/opt/kplaylist/html/index.php''''' and modify following lines:<br />
*Line 125, enable autoupdate<br />
$cfg['autoupdate'] = 1;<br />
*Optionnaly, uncomment lines 8977, 8978 and 8979<br />
$options['deleteunused'] = 1; # Uncomment if you want to remove deleted files from the database<br />
$options['rebuildid3'] = 1; # Uncomment if you want to reread all the information from your music files (OGG/MP3).<br />
$options['debugmode'] = 1; # Uncomment if you want to enable debug mode<br />
You can check that it's working at http://yourserver/kplaylist/index.php?update=5000&user=autooperate<br />
<br />
You should get this message: '''Wrong host (YOUR IP) or user (autooperate) for update.'''<br />
<br />
<br />
Create a template called ''kplaylist'' in '''''/etc/e-smith/templates/etc/cron.d/''''' and paste the following code in it:<br />
# kPlaylist database update cron job<br />
<br />
# ___________ Minute (from 0 to 59)<br />
#| ________ Hour (from 0 to 23)<br />
#| | ______ Day (from 1 to 31)<br />
#| | | ____ Month (from 1 to 12)<br />
#| | | | __ Day of week (from 0 to 6 - 0 is sunday) <br />
#| | | | |<br />
#v v v v v<br />
30 23 * * * /usr/bin/lynx -dump "http://127.0.0.1/kplaylist/index.php?update=5000&user=autooperate"<br />
Save the file and apply modifications with the following command:<br />
expand-template /etc/cron.d/kplaylist<br />
Now each day at 23:30 the server will auto-update kPlaylist database.<br />
<br />
=Additional information=<br />
*[http://www.kplaylist.net/ Homepage]<br />
*[http://www.kplaylist.net/index.php?documentation=true Documentation]<br />
*[http://www.kplaylist.net/forum/ Forums]<br />
*[http://www.kplaylist.net/index.php?download=true Download section]<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Webapps]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/de&diff=8030Egroupware/de2008-02-22T17:05:56Z<p>Cool34000: </p>
<hr />
<div>{{Languages|Egroupware}}<br />
<br />
=eGroupware 1.4 für SME 7.x=<br />
<br />
<br />
==Maintainers==<br />
[[User:Berdie/de|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
<br />
==Beschreibung==<br />
eGroupware 1.4 für SMEserver 7.x ist ein leistungsfähiges modulares Internet/Intranet Anwendungsframework und stellt Groupware-Funktionen zur Verfügung. Bereitgestellt werden die Funktionen E-Mail, Kontakte, Termine, Aufgaben und vieles mehr.<br />
eGroupWare ist ein Groupware-Server und enthält eine Web-Plattform, mit der weltweit der Zugang über das Internet möglich ist. Darüber hinaus ist es auch möglich, eGroupWare mit Offline-Clients (Kontact, Evolution, Outlook) und sogar mit Handys und PDA zu synchronisieren. eGroupWare ist international und in mehr als 25 Sprachen verfügbar.<br />
Mehr über eGroupware können Sie unter ''http://www.egroupware.org/'' erfahren.<br />
<br />
Mit dieser Erweiterung kann eGroupWare auf Ihrem SME 7.x (und höher) benutzt werden. Die Installation erfolgt als ein einziges Paket extrem einfach.<br />
<br />
==Installation und Deinstallation==<br />
Die Installation erfolgt ganz einfach mit<br />
yum localinstall smeserver-egroupware<br />
Die Deinstallation erfolgt mit<br />
yum remove smeserver-egroupware<br />
Die yum-Empfehlung, die Befehle ''signal event post-upgrade'' und anschließend ''signal-event reboot'' durchzuführen, kann ignoriert werden.<br />
<br />
'''Achtung, mit diesem RPM ist das Upgrade von eGroupWare 1.2.x nicht möglich'''<br />
{{Warning box|'''Durch einen bug in alten RPM Versionen'''*''', MUSS ERST DAS ALTE RPM DEINSTALLIERT WERDEN, BEVOR IHR SYSTEM AUF DEN NEUEN STAND GEBRACHT WERDEN KANN MIT:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Dieser Befehl schützt davor, Installationsdateien und MySQL-Datenbanken zu löschen.'''<br />
<br />
<nowiki>*</nowiki>'' Betroffene Versionen sind smeserver-egroupware-1.4-10 und älter''}}<br />
<br />
Anschließend können Sie die existierende 1.4-Installation aktualisieren mit<br />
rpm -Uvh smeserver-egroupware-1.4.002-3.noarch.rpm<br />
Falls dabei die eGroupWare Version aktualsiert wird (z.B. von 1.4.001 nach 1.4.002), müssen Sie das Upgrade mit dem Config-Admin Setup und bisherigem Passwort beenden. Danach auf Upgrade klicken...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Danach nochmals die Installation prüfen<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Falls keine Fehler auftauchen, ist der Upgrade fertig!<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Eine Sicherung wurde durch das RPM vor dem Upgrade durchgeführt. Alle Dateien und die MySQL-Datenbank finden Sie unter /opt/eGW_RPM_BACKUP<br />
'''Speichern Sie die Sicherung in einem sicheren Verzeichnis ab.'''<br />
<br />
Dieser automatische Schritt ist nur aus Sicherheitsgründen. '''Erstellen Sie bitte eigene Sicherungen vor dem Upgrade.'''<br />
<br />
<br />
==Deinstallation==<br />
Um die Anwendung zu deinstallieren, geben Sie einfach folgenden Befehl ein:<br />
rpm -e smeserver-egroupware<br />
Zusätzlich ist in neuem Release (1.4.002-x) der Befehl 'sh /root/eGW_Full_Uninstall.sh' erforderlich, mit dem Instalaltionsdateien, die MySQL-Datenbank und SME Datenbankeinträge gelöscht werden.<br />
<br />
<br />
==Anwendung==<br />
<br />
Führen Sie '''UNBEDINGT VOR''' dem ersten Anmelden bei eGroupware die Erstkonfiguration durch.<br />
Anschließend können sich die SME Benutzer an eGroupware mit Ihrem gewohnten SME Benutzernamen + Kennwort anmelden. Bei der ersten Anmeldung werden Benutzer automatisch so angelegt, dass diese mit den SME Benutzern identisch sind.<br />
<br />
===Erstkonfiguration===<br />
Sie finden eGroupware im Verzeichnis ''/opt/egroupware''. Um eGroupware zu nutzen, starten Sie Ihren Browser mit der URL ''http://servername/egroupware/setup'' und melden sich mit dem Benutzer ''config-admin'' + Kennwort ''admin'' im Setup-/Konfigurationsadmin-Login an.<br />
[[Image:EGW-config-admin-de.png]]<br />
<br />
Legen Sie jetzt das Administrator-Konto 'admin' an, dabei muss das Kennwort mit dem Kennwort des SME Admin identisch sein, um SME Admin Mails mit diesem Benutzer in eGroupware empfangen zu können. <br />
<br />
[[Image:EGW-create-admin-account-de.png]]<br />
<br />
Melden Sie sich anschließend ab.<br />
<br />
===Ändern der Kennwörter für eGW config-admin / header-admin===<br />
<br />
Starten Sie den Browser und melden Sie sich mit dem Benutzer ''header-admin'' + Kennwort ''admin'' im Login Headerverwaltung an. <br />
<br />
[[image:EGW-header-admin-de.png]]<br />
<br />
Ändern Sie jetzt die Kennwörter die Benutzer ''config-admin'' und ''header-admin'':<br />
<br />
[[image:EGW-password-config-admin-de.png]]<br />
<br />
[[image:EGW-password-header-admin-de.png]]<br />
<br />
Schließen Sie den Vorgang mit "Schreiben" ab. <br />
<br />
{{Warning box|type=Warnung|Aus Sicherheitsgründen wird dringend empfohlen, die Kennwörter für die Benutzer ''config-admin'' und ''header-admin'' unmittelbar nach der ersten Anmeldung zu ändern !}}<br />
<br />
===Spezielle Einstellungen===<br />
In der Voreinstellung ist eGroupWare über LAN und Internet nur mit dem "erzwungenen" https-Protokoll und SSL erreichbar.<br />
Das können Sie mit folgenden Befehlen an der Serverkonsole ändern:<br />
<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Anschließend aktivieren Sie Ihre Änderungen und starten Apache neu:<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# svc -h /service/httpd-e-smith<br />
<br />
===Synchronisation===<br />
<br />
eGroupware unterstützt die '''Synchronisation von Kalender, Aufgaben, Notizen und Adressbuch''' mit Offline-Clients wie MS Outlook und PDA's. Dafür ist allerdings PHP5 erforderlich, das noch nicht im SME 7 implementiert ist. Dennoch ist zumindest über das ''xmlrpc'' Protokoll und die Anwendung ''eGWOSync'' die Synchronisation mit MS Outlook möglich.<br />
<br />
====MS Outlook Synchronisation====<br />
<br />
eGroupware-Daten mit MS Outlook können folgendermaßen synchronisiert werden:<br />
<br />
'''1. Zertifikat über MS Internet Explorer installieren'''<br />
<br />
*Internet Explorer starten<br />
*URL = https://servername eingeben<br />
*Auf "Zertifikat anzeigen" klicken<br />
*Auf "Zertifikat installieren" klicken und das Zertifikat installieren<br />
{{Note box|Unter Vista muss zusätzlich die Domäne in die Liste der vertrauenswürdigen Websites kopiert werden, bevor das Zertifikat installiert werden kann.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*MS Outlook beenden, falls es aktiv sein sollte.<br />
*Aufruf der Systemsteuerung, Register Mail.<br />
*Profile anzeigen... -> alle vorhandenen Profile entfernen<br />
*MS Outlook starten, Profil komplett neu anlegen, dabei auch Mailkonto anlegen<br />
<br />
'''3. eGWOSync'''<br />
<br />
Laden Sie sich [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] und ggfs. auch [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET] in der passenden Version herunter.<br />
Sollte .NET in einer aktuelleren Version installiert sein, muss diese vorher erst deinstalliert werden.<br />
<br />
*Es muss .NET Version 1.x installiert sein, neuere .NET-Versionen werden von eGWOSync nicht akzeptiert<br />
*User/Password = SME Benutzer/Kennwort<br />
*Domain = default<br />
*Hostname = SME Hauptdomäne<br />
*Port = 443<br />
*Use SSL = aktiv<br />
*URL = Voreinstellung beibehalten<br />
*Test durchführen<br />
<br />
'''4. Funambol'''<br />
<br />
Laden Sie sich Funambol [http://www.http://www.funambol.com/opensource Funambol Web Site]<br />
unter [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14] herunter.<br />
<br />
1) Installieren Sie Funambol 6.0.14<br />
2) Ändern Sie den Wert "7" to "0" für den Schlüssel 'mbstring.func_overload = 0' in php.ini <br />
3) Öffnen Sie Outlook über Funambol Setup (Funambol --> Option)<br />
4) Markieren Sie alle Einträge<br />
5) Setup Optionen:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>http://Domain Name/egroupware/rpc.php</nowiki> or <nowiki>http://Server IP/egroupware/rpc.php</nowiki><br />
Username = Ihr login name für eGroupWare<br />
Password = Ihr Password für eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
==Weitere Informationen==<br />
<br />
*[http://www.egroupware.org Website]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]<br />
<br />
Ich wünsche allen Nutzern viel Spass beim Einsatz von eGroupware !<br />
<br />
''Dietmar Berteld (berdie)''</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/fr&diff=8029Egroupware/fr2008-02-22T17:05:02Z<p>Cool34000: /* Installation */</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupware 1.4.002 pour SME 7.x=<br />
<br />
==Mainteneurs==<br />
[[User:Berdie/fr|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
eGroupWare est un logiciel Collaboratif professionel et gratuit. Il vous permet de gérer vos contacts, vos rendez-vous, vos taches, et bien plus pour toute votre activité.<br />
eGroupWare est un serveur Collaboratif (groupware). Il est conçu nativement avec une interface Web qui vous permet d'accéder à vos données de n'importe quel plate-forme sur la planète.<br />
Vous avez le choix d'accéder au serveur eGroupWare avec votre client groupware préféré (Kontact, Evolution, Outlook) ainsi qu'avec votre téléphone portable ou votre PDA, par SyncML.<br />
<br />
eGroupWare est international. A ce jour, il supporte plus de [http://www.egroupware.org/languages 25 languages] incluant le support rtl.<br />
<br />
Pour plus d'informations, visitez ''http://www.egroupware.org/''.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-egroupware --enablerepo=sme-contribs<br />
<br />
==Mise à jour==<br />
{{Warning box|'''A cause d'un bug dans les vieilles versions du RPM'''*''', VOUS DEVEZ DESINSTALLER LE VIEUX RPM AVANT LA MISE A JOUR AVEC LA COMMANDE SUIVANTE:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Ceci empêchera que les fichiers d'installation et la base de données MySQL soient supprimés.'''<br />
<br />
<nowiki>*</nowiki>'' Versions affectées: smeserver-egroupware-1.4-10 et antérieures''}}<br />
<br />
Vous pouvez alors mettre à jour votre version 1.4 existante avec la commande suivante:<br />
rpm -Uvh smeserver-egroupware-1.4.002-3.noarch.rpm<br />
Si vous mettez à jour la version d'eGroupWare (par exemple 1.4.001 vers 1.4.002) vous devez terminer la mise à jour dans Config-Admin Setup avec vos identifiants existants. Cliquez sur mettre à jour...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Revérifiez l'installation<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Si tout s'est bien passé, la mise à jour de version est effectuée !<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Une sauvegarde est effectuée par le RPM avant la mise à jour. Tous les fichiers et la base de données MySQL DataBase sont sauvegardés dans /opt/eGW_RPM_BACKUP<br />
'''Vous devez déplacer cette sauvegarde dans un endroit plus sur.'''<br />
<br />
Cette étape automatique est juste une sécurité, '''effectuez vos propres sauvegardes avant de mettre à jour.'''<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-egroupware<br />
Dans la nouvelle release (1.4.002-x), si vous souhaitez supprimer définitivement eGroupWare de votre serveur, vous devez taper la commande suivante:<br />
sh /root/eGW_Full_Uninstall.sh<br />
Ceci supprimera les fichiers d'installation d'eGroupWare, la base de données MySQL et les entrées dans la base de données de SME.<br />
<br />
==Démarrer avec eGroupWare==<br />
Veuillez effectuer la configuration initiale '''AVANT''' de vous connecter à eGroupware.<br />
Après cette étape, les utilisateurs SME pourront se connecter avec leurs login + mot de passe SME.<br />
A la 1ere connexion d'un utilisateur SME valide, le compte est automatiquement créé dans eGroupware.<br />
<br />
===Configuration initiale===<br />
Vous trouverez les fichiers d'installation de la dossier ''/opt/egroupware''. Pour terminer la configuration d'eGroupware, ouvrez votre navigateur à l'adresse ''https://votredomaine.com/egroupware/setup'' et connectez vous avec l'utilisateur ''config-admin'' + mot de passe ''admin'' dans Setup/Config Admin.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Vous devez maintenant créer le compte d'administration d'eGroupware. Utilisez un compte existant de SME (même utilisateur et même mot de passe), par exemple l'admin (déconseillé pour des raisons de sécurité) pour pouvoir envoyer et recevoir les mails administratifs dans eGroupware.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Déconnectez vous après avoir créé le compte d'administration.<br />
<br />
===Changement des mots de passe de config-admin / header-admin===<br />
Ouvrez votre navigateur et connectez vous avec l'utilisateur ''header-admin'' et le mot de passe ''admin'' à Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Changez les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' maintenant :<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Enregistrez vos changements en cliquant sur "Ecrire".<br />
<br />
{{Warning box|Pour des raisons de sécurité, veuillez changer les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' dès votre 1ère connexion !}}<br />
<br />
===Paramétrage de l'accessibilité===<br />
Le comportement par défaut d'eGroupware est : accessible depuis le LAN + Internet avec https "forcée" (SSL + rewrite rule).<br />
<br />
Vous pouvez facilement modifier ce comportement par défaut avec les commandes suivantes :<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Une fois les changements effectués, appliquez les modifications et redémarrez Apache :<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronisation===<br />
<br />
eGroupware fournit '''la synchronisation du calendrier, des tâches, des notes et du carnet d'adresse''' pour des clients comme MS Outlook et les PDA. Malheureusement, il faut php5 pour que cela fonctionne et cela n'est pas implémenté sur SME 7.x. En fait, il est possible de synchroniser Outlook avec le protocole ''xmlrpc'' et le logiciel ''eGWOSync''.<br />
<br />
====Synchronisation de MS Outlook====<br />
<br />
Vous pouvez synchroniser les données d'eGroupware avec Outlook en suivant ces étapes:<br />
<br />
'''1. Installez le certificat dans MS Internet Explorer'''<br />
<br />
*Démarrez Internet Explorer<br />
*Allez à l'adresse https://votredomaine.com<br />
*Cliquez sur "Afficher les certificats"<br />
*Cliquez sur "Installer le certificat" et terminez l'assitant d'installation du certificat<br />
{{Note box|Sous Vista, vous devez ajouter votre domaine à la liste des sites approuvés pour être capable d'accéder à l'installation du certificat.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Fermez MS Outlook s'il est ouvert.<br />
*Dans le panneau de configuration, allez dans les options de messagerie.<br />
*Afficher les profils... -> supprimer tous les profils<br />
*Redémarrez MS Outlook, créez un nouveau profile avec votre compte mail<br />
<br />
'''3. eGWOSync'''<br />
<br />
Téléchargez [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] et [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], si nécessaire.<br />
<br />
*Vous avez besoin de .NET Version 1.x, si vous avez déja une version supérieure, vous devrez également installer .NET 1.x<br />
*User/Password = compte utilisateur/mots de passe SME<br />
*Domain = default<br />
*Hostname = domaine SME<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = laisser par défaut<br />
*Faire le test<br />
<br />
'''4. Funambol'''<br />
<br />
Page de téléchargement de [http://www.funambol.com/opensource Funambol]<br />
<br />
Lien direct vers [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14]<br />
<br />
1) Ouvrez Outlook et allez dans le paramétrage de Funambol (Funambol --> Option)<br />
4) Selectionnez tous les items<br />
5) Options de paramétrage:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>https://votredomaine.com/egroupware/rpc.php</nowiki> ou <nowiki>https://IP Serveur/egroupware/rpc.php</nowiki><br />
Username = Votre utilisateur eGroupWare<br />
Password = Votre mot de passe eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 Septembre 2007 (MDT)<br />
<br />
==Addon Gallery2==<br />
Gallery2 est le 1er addon disponible pour eGroupWare 1.4.002<br />
<br />
Il a été intégré dans smeserver-egroupware-1.4.002-3.noarch.rpm (mais non installé par défaut)<br />
<br />
===Description===<br />
Gallery est une application web open source d'organisation d'albums photos. Gallery vous donne une façon intuitive d'intégrer la gestion de photos uniformement dans votre site web, que vous ayez un petit site personel ou une plus large communauté.<br />
<br />
Pour plus d'informations, visitez ''http://gallery.menalto.com/''.<br />
<br />
===Installation de Gallery2===<br />
Pour commencer, connectez vous au Config setup avec votre utilisateur config-admin et son mot de passe et cliquez sur ''Gérer les applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Cochez simplement la case d'installation de Gallery et sauvegardez.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Configuration de Gallery2===<br />
Une fois installé, vous devez paramétrer votre site web et créer la base de données. Cette étape a été préparée par le RPM d'installation.<br />
<br />
Ouvrez votre navigateur à l'adresse ''https://yourdomain.com/egroupware/gallery/gallery2/install'' et suivez les instructions.<br />
<br />
Dans la 4ème étape, le chemin vers le dossier de stockage est demandé. L'installation du RPM a préparé ''/opt/egroupware/files/g2data'', veuillez ne pas changer le chemin et les permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
Dans la 5ème étape, les informations MySQL sont demandées. L'installation du RPM a préparé ''egwuser'' ''egroupware'' et votre ''DbPassword'' automatiquement. Cliquez simplement sur sauvegarder et finissez l'installation.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Icone Gallery2===<br />
Une fois la configuration terminée, vous pouvez ajouter l'icone dans l'interface d'eGroupWare.<br />
Connectez vous à eGroupWare avec un compte admin et éditez un utilisateur ou un groupe pour lui ajouter l'application Gallery.<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|Gallery peut être accédé sans authentification à l'adresse ''https://votredomaine.com/egroupware/gallery/gallery2''}}<br />
<br />
==Informations supplémentaire==<br />
<br />
*[http://www.egroupware.org Site web d'eGroupWare]<br />
*[http://gallery.menalto.com/ Site web de Gallery]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 topic sur le forum de contribs.org]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 topic sur le forum de contribs.org]<br />
<br />
Have much fun with eGroupware as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Groupware/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware&diff=8028Egroupware2008-02-22T17:04:36Z<p>Cool34000: repo change</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupWare 1.4.002 for SME 7.x and above=<br />
<br />
==Maintainers==<br />
[[User:Berdie/de|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
eGroupWare is a [http://www.egroupware.org/philosophy free] enterprise ready groupware software for your network. It enables you to manage contacts, appointments, todos and many more for your whole business.<br />
<br />
eGroupWare is a groupware server. It comes with a native web-interface which allowes to access your data from any platform all over the planet. Moreover you also have the choice to access the eGroupWare server with your favorite groupware client (Kontact, Evolution, Outlook) and also with your mobile or PDA via SyncML.<br />
<br />
eGroupWare is international. At the time, it supports more than [http://www.egroupware.org/languages 25 languages] including rtl support.<br />
<br />
For more information see ''http://www.egroupware.org/''.<br />
<br />
With this RPM you can use eGroupWare on your SME 7.x (and above). You can install it as one single package in a very comfortable way.<br />
<br />
==Installation==<br />
For installation just hit the following command<br />
yum install smeserver-egroupware --enablerepo=sme-contribs<br />
<br />
==Update/Upgrade==<br />
'''Please note that this RPM cannot upgrade eGroupWare 1.2.x'''<br />
{{Warning box|'''Because of a bug in old RPM versions'''*''', YOU MUST UNINSTALL THE OLD RPM BEFORE UPDATING WITH THE FOLLOWING COMMAND:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''This will prevent installation files and MySQL to be deleted.'''<br />
<br />
<nowiki>*</nowiki>'' Affected versions are smeserver-egroupware-1.4-10 and older''}}<br />
<br />
Then, you can update your existing 1.4 installation with<br />
rpm -Uvh smeserver-egroupware-1.4.002-3.noarch.rpm<br />
If you were upgrading eGroupWare version (i.e.1.4.001 to 1.4.002) you must finish the upgrade at the Config-Admin Setup with your existing credentials. Then click on upgrade...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Then re-check your install<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
If all went ok, upgrade is done!<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
A backup is done by the RPM before updating. All Files and MySQL DataBase are saved in /opt/eGW_RPM_BACKUP<br />
'''You must move the backup to a safe directory.'''<br />
<br />
This automatic step is just for safety, '''make your own backup before updating/upgrading.'''<br />
<br />
==Uninstallation==<br />
For uninstall just hit the following command<br />
yum remove smeserver-egroupware<br />
In the new release (1.4.002-x), if you want to completly remove eGroupWare from your server, you need the following command:<br />
sh /root/eGW_Full_Uninstall.sh<br />
This will delete eGroupWare's installation files, MySQL DB and SME DB entries.<br />
<br />
==Starting with eGroupWare==<br />
Please perform the Intial Configuration '''FIRST''' before login to eGroupWare.<br />
After that SME users can login to eGroupWare with their used SME account + password. At first login, eGroupWare creates user accounts and passwords automatically and synchronize them to the SME Server.<br />
<br />
===Inital Configuration===<br />
You can find eGroupWare in the ''/opt/egroupware'' directory. For using eGroupWare start your browser with the URL ''http://servername/egroupware/setup'' and logon with the user ''config-admin'' + password ''admin'' at Setup/Config Admin Login.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Now you should create eGroupWare's admin-account. Because eGroupWare uses mail authentication, the admin-account must be a valid SME account/password. This account will be able to use+administrate eGroupWare.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Logout after creating the admin account.<br />
<br />
===Changing passwords for eGW config-admin / header-admin===<br />
Go to your browser and logon with the user ''header-admin'' + password ''admin'' at Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Change the passwords for the users ''config-admin'' and ''header-admin''now:<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Store the new passwords with "Write". <br />
<br />
{{Warning box|For security-reasons, change the passwords for the users ''config-admin'' and ''header-admin'' after your first login !}}<br />
<br />
===Adjusting accessibility===<br />
The default behaviour of eGroupWare is: accessible from LAN + Internet with "forced https" (SSL on + rewrite rule)<br />
You can easily change those defaults settings with following commands:<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Once done, apply modifications and restart Apache:<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronization===<br />
eGroupWare provides '''Synchronization of calender, todo's, notes and addressbook''' with offline-clients like MS Outlook and PDA's. Unfortunally there is a requirement for PHP5 to accomplish these functions, which is not implemented in SME 7. But actually it is possible to sync to MS Outlook with the ''xmlrpc'' protocol and the ''eGWOSync'' application.<br />
<br />
====MS Outlook Synchronization====<br />
You can sync eGroupWare-Data to MS Outlook as follows:<br />
<br />
'''1. Install certificate with MS Internet Explorer'''<br />
<br />
*Start Internet Explorer<br />
*Enter URL = https://servername<br />
*Enter "show certificate"<br />
*Enter "install certificate" and go on to install your SME certificate<br />
{{Note box|Under Vista, you have to put your domain in the approved website list before being able to install the certificate.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Finish your MS Outlook if active.<br />
*Go to system control, register mail.<br />
*show profiles... -> delete all profiles<br />
*Start MS Outlook, create a new profile with your mail account<br />
<br />
'''3. eGWOSync'''<br />
<br />
Download [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] and [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], if necessary. If your .NET release is newer than version 1.x, you must install both versions on your system.<br />
<br />
*You need .NET Version 1.x, eGWOSync accepts no newer versions<br />
*User/Password = SME user account/password<br />
*Domain = default<br />
*Hostname = SME domain<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = keep default values<br />
*Perform test<br />
<br />
'''4. Funambol'''<br />
<br />
Download Web site: [http://www.funambol.com/opensource Funambol Web Site]<br />
Download Funambol 6.0.14 link [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14]<br />
<br />
1) Install Funambol 6.0.14<br />
2) Change "7" to "0" for mbstring.func_overload = 0 in php.ini <br />
3) Open Outlook go to the Funambol Setup (Funambol --> Option)<br />
4) Select all items<br />
5) Setup options:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>http://Domain Name/egroupware/rpc.php</nowiki> or <nowiki>http://Server IP/egroupware/rpc.php</nowiki><br />
Username = Your user login name for eGroupWare<br />
Password = Your user password for eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 September 2007 (MDT)<br />
<br />
==Gallery2 addon==<br />
Gallery2 is the first addon available for eGroupWare 1.4.002<br />
<br />
It has been integrated in smeserver-egroupware-1.4.002-3.noarch.rpm (but not installed by default)<br />
<br />
===Description===<br />
Gallery is an open source web based photo album organizer. Gallery gives you an intuitive way to blend photo management seamlessly into your own website whether you're running a small personal site or a large community site.<br />
<br />
For more information see ''http://gallery.menalto.com/''.<br />
<br />
===Gallery2 install===<br />
First, login at Config setup with your existing creditentials and clic on ''Manage Applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Then simply click on Gallery install checkbox and save your changes.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Gallery2 setup===<br />
Once Installed, you need to configure your website and create the database. This step has been prepared by the RPM install.<br />
<br />
Open your web browser at ''https://yourdomain.com/egroupware/gallery/gallery2/install'' and follow instructions.<br />
<br />
In the 4th step, you will be asked for a storage folder. RPM install has prepared ''/opt/egroupware/files/g2data'', please don't change neither path nor permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
In the 5th step, you will be asked for MySQL informations. RPM install has prepared ''egwuser'' ''egroupware'' and your DbPassword automatically. Just save and finish the install.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Gallery2 icon===<br />
Once the setup is done you can add the icon in eGroupWare's interface.<br />
Login to eGroupWare with an admin account, and edit a user or a group and add gallery<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|The gallery can also be accessed with no authentication at ''https://yourdomain.com/egroupware/gallery/gallery2''}}<br />
<br />
==Additional information==<br />
<br />
*[http://www.egroupware.org eGroupWare Homepage]<br />
*[http://gallery.menalto.com/ Gallery Homepage]<br />
*[http://www.egroupware.org/wiki eGroupWare Documentation]<br />
*[http://www.egroupware.org/index.php?page_name=wiki&wikipage=ManualSetupUpdate Howto Update eGroupWare]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 thread at contribs.org forum]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 thread at contribs.org forum]<br />
<br />
<br />
Have much fun with eGroupWare as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib]]<br />
[[Category: Groupware]]<br />
[[Category: Webapps]]</div>Cool34000https://wiki.koozali.org/index.php?title=Egroupware/fr&diff=8027Egroupware/fr2008-02-22T17:03:14Z<p>Cool34000: changement de disponibilité</p>
<hr />
<div>{{Languages|Egroupware}}<br />
=eGroupware 1.4.002 pour SME 7.x=<br />
<br />
==Mainteneurs==<br />
[[User:Berdie/fr|Dietmar Berteld]]<br/><br />
mailto:dietmar@berteld.com<br />
<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
eGroupWare est un logiciel Collaboratif professionel et gratuit. Il vous permet de gérer vos contacts, vos rendez-vous, vos taches, et bien plus pour toute votre activité.<br />
eGroupWare est un serveur Collaboratif (groupware). Il est conçu nativement avec une interface Web qui vous permet d'accéder à vos données de n'importe quel plate-forme sur la planète.<br />
Vous avez le choix d'accéder au serveur eGroupWare avec votre client groupware préféré (Kontact, Evolution, Outlook) ainsi qu'avec votre téléphone portable ou votre PDA, par SyncML.<br />
<br />
eGroupWare est international. A ce jour, il supporte plus de [http://www.egroupware.org/languages 25 languages] incluant le support rtl.<br />
<br />
Pour plus d'informations, visitez ''http://www.egroupware.org/''.<br />
<br />
==Installation==<br />
Pour l'installation, tapez la commande suivante<br />
yum install smeserver-egroupware<br />
<br />
==Mise à jour==<br />
{{Warning box|'''A cause d'un bug dans les vieilles versions du RPM'''*''', VOUS DEVEZ DESINSTALLER LE VIEUX RPM AVANT LA MISE A JOUR AVEC LA COMMANDE SUIVANTE:'''<br />
'''rpm -e smeserver-egroupware --noscripts'''<br />
'''Ceci empêchera que les fichiers d'installation et la base de données MySQL soient supprimés.'''<br />
<br />
<nowiki>*</nowiki>'' Versions affectées: smeserver-egroupware-1.4-10 et antérieures''}}<br />
<br />
Vous pouvez alors mettre à jour votre version 1.4 existante avec la commande suivante:<br />
rpm -Uvh smeserver-egroupware-1.4.002-3.noarch.rpm<br />
Si vous mettez à jour la version d'eGroupWare (par exemple 1.4.001 vers 1.4.002) vous devez terminer la mise à jour dans Config-Admin Setup avec vos identifiants existants. Cliquez sur mettre à jour...<br />
<br />
[[Image:eGW-upgrade-step1.png]]<br />
<br />
Revérifiez l'installation<br />
<br />
[[Image:eGW-upgrade-step2.png]]<br />
<br />
Si tout s'est bien passé, la mise à jour de version est effectuée !<br />
<br />
[[Image:eGW-upgrade-step3.png]]<br />
<br />
Une sauvegarde est effectuée par le RPM avant la mise à jour. Tous les fichiers et la base de données MySQL DataBase sont sauvegardés dans /opt/eGW_RPM_BACKUP<br />
'''Vous devez déplacer cette sauvegarde dans un endroit plus sur.'''<br />
<br />
Cette étape automatique est juste une sécurité, '''effectuez vos propres sauvegardes avant de mettre à jour.'''<br />
<br />
==Désinstallation==<br />
Pour la désinstallation, tapez la commande suivante<br />
yum remove smeserver-egroupware<br />
Dans la nouvelle release (1.4.002-x), si vous souhaitez supprimer définitivement eGroupWare de votre serveur, vous devez taper la commande suivante:<br />
sh /root/eGW_Full_Uninstall.sh<br />
Ceci supprimera les fichiers d'installation d'eGroupWare, la base de données MySQL et les entrées dans la base de données de SME.<br />
<br />
==Démarrer avec eGroupWare==<br />
Veuillez effectuer la configuration initiale '''AVANT''' de vous connecter à eGroupware.<br />
Après cette étape, les utilisateurs SME pourront se connecter avec leurs login + mot de passe SME.<br />
A la 1ere connexion d'un utilisateur SME valide, le compte est automatiquement créé dans eGroupware.<br />
<br />
===Configuration initiale===<br />
Vous trouverez les fichiers d'installation de la dossier ''/opt/egroupware''. Pour terminer la configuration d'eGroupware, ouvrez votre navigateur à l'adresse ''https://votredomaine.com/egroupware/setup'' et connectez vous avec l'utilisateur ''config-admin'' + mot de passe ''admin'' dans Setup/Config Admin.<br />
<br />
[[Image:EGW-config-admin-en.png]]<br />
<br />
Vous devez maintenant créer le compte d'administration d'eGroupware. Utilisez un compte existant de SME (même utilisateur et même mot de passe), par exemple l'admin (déconseillé pour des raisons de sécurité) pour pouvoir envoyer et recevoir les mails administratifs dans eGroupware.<br />
<br />
[[Image:EGW-create-admin-account-en.png]]<br />
<br />
Déconnectez vous après avoir créé le compte d'administration.<br />
<br />
===Changement des mots de passe de config-admin / header-admin===<br />
Ouvrez votre navigateur et connectez vous avec l'utilisateur ''header-admin'' et le mot de passe ''admin'' à Header Admin Login. <br />
<br />
[[image:EGW-header-admin-en.png]]<br />
<br />
Changez les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' maintenant :<br />
<br />
[[image:EGW-password-config-admin-en.png]]<br />
<br />
[[image:EGW-password-header-admin-en.png]]<br />
<br />
Enregistrez vos changements en cliquant sur "Ecrire".<br />
<br />
{{Warning box|Pour des raisons de sécurité, veuillez changer les mots de passe des utilisateurs ''config-admin'' et ''header-admin'' dès votre 1ère connexion !}}<br />
<br />
===Paramétrage de l'accessibilité===<br />
Le comportement par défaut d'eGroupware est : accessible depuis le LAN + Internet avec https "forcée" (SSL + rewrite rule).<br />
<br />
Vous pouvez facilement modifier ce comportement par défaut avec les commandes suivantes :<br />
# config setprop egroupware HTTPS on<br />
# config setprop egroupware HTTPS off<br />
<br />
# config setprop egroupware PublicAccess global<br />
# config setprop egroupware PublicAccess local<br />
Une fois les changements effectués, appliquez les modifications et redémarrez Apache :<br />
# expand-template /etc/httpd/conf/httpd.conf<br />
# service httpd-e-smith restart<br />
<br />
===Synchronisation===<br />
<br />
eGroupware fournit '''la synchronisation du calendrier, des tâches, des notes et du carnet d'adresse''' pour des clients comme MS Outlook et les PDA. Malheureusement, il faut php5 pour que cela fonctionne et cela n'est pas implémenté sur SME 7.x. En fait, il est possible de synchroniser Outlook avec le protocole ''xmlrpc'' et le logiciel ''eGWOSync''.<br />
<br />
====Synchronisation de MS Outlook====<br />
<br />
Vous pouvez synchroniser les données d'eGroupware avec Outlook en suivant ces étapes:<br />
<br />
'''1. Installez le certificat dans MS Internet Explorer'''<br />
<br />
*Démarrez Internet Explorer<br />
*Allez à l'adresse https://votredomaine.com<br />
*Cliquez sur "Afficher les certificats"<br />
*Cliquez sur "Installer le certificat" et terminez l'assitant d'installation du certificat<br />
{{Note box|Sous Vista, vous devez ajouter votre domaine à la liste des sites approuvés pour être capable d'accéder à l'installation du certificat.}}<br />
<br />
'''2. MS Outlook'''<br />
<br />
*Fermez MS Outlook s'il est ouvert.<br />
*Dans le panneau de configuration, allez dans les options de messagerie.<br />
*Afficher les profils... -> supprimer tous les profils<br />
*Redémarrez MS Outlook, créez un nouveau profile avec votre compte mail<br />
<br />
'''3. eGWOSync'''<br />
<br />
Téléchargez [http://downloads.sourceforge.net/egroupware/eGWOSyncSetup_0.4.0.msi?modtime=1142333502&big_mirror=1 eGWOSync] et [http://mirror.contribs.org/smeserver/contribs/dberteld/egroupware/Outlook-Sync/dotnetfx.exe .NET], si nécessaire.<br />
<br />
*Vous avez besoin de .NET Version 1.x, si vous avez déja une version supérieure, vous devrez également installer .NET 1.x<br />
*User/Password = compte utilisateur/mots de passe SME<br />
*Domain = default<br />
*Hostname = domaine SME<br />
*Port = 443<br />
*Use SSL = enabled<br />
*URL = laisser par défaut<br />
*Faire le test<br />
<br />
'''4. Funambol'''<br />
<br />
Page de téléchargement de [http://www.funambol.com/opensource Funambol]<br />
<br />
Lien direct vers [http://www.funambol.com/opensource/downloadfile.html?file_id=funambol-outlook-plugin-6.0.14.exe Funambol 6.0.14]<br />
<br />
1) Ouvrez Outlook et allez dans le paramétrage de Funambol (Funambol --> Option)<br />
4) Selectionnez tous les items<br />
5) Options de paramétrage:<br />
<br />
'''ACCOUNT'''<br />
Location = <nowiki>https://votredomaine.com/egroupware/rpc.php</nowiki> ou <nowiki>https://IP Serveur/egroupware/rpc.php</nowiki><br />
Username = Votre utilisateur eGroupWare<br />
Password = Votre mot de passe eGroupWare<br />
<br />
'''SYNC'''<br />
'''CONTACTS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifcontacts<br />
Data Format = SIF<br />
'''CALENDAR'''<br />
Sync Direction = Two-Way<br />
Remote name = calendar<br />
Data Format = vCalendar<br />
'''TASKS'''<br />
Sync Direction = Two-Way<br />
Remote name = ./siftasks<br />
Data Format = SIF<br />
'''NOTES'''<br />
Sync Direction = Two-Way<br />
Remote name = ./sifnotes<br />
Data Format = SIF<br />
<br />
--[[User:Snoopyski|Snoopyski]] 19:04, 20 Septembre 2007 (MDT)<br />
<br />
==Addon Gallery2==<br />
Gallery2 est le 1er addon disponible pour eGroupWare 1.4.002<br />
<br />
Il a été intégré dans smeserver-egroupware-1.4.002-3.noarch.rpm (mais non installé par défaut)<br />
<br />
===Description===<br />
Gallery est une application web open source d'organisation d'albums photos. Gallery vous donne une façon intuitive d'intégrer la gestion de photos uniformement dans votre site web, que vous ayez un petit site personel ou une plus large communauté.<br />
<br />
Pour plus d'informations, visitez ''http://gallery.menalto.com/''.<br />
<br />
===Installation de Gallery2===<br />
Pour commencer, connectez vous au Config setup avec votre utilisateur config-admin et son mot de passe et cliquez sur ''Gérer les applications''.<br />
<br />
[[image:EGW-Manage-apps.png]]<br />
<br />
Cochez simplement la case d'installation de Gallery et sauvegardez.<br />
<br />
[[image:EGW-Install-G2.png]]<br />
<br />
===Configuration de Gallery2===<br />
Une fois installé, vous devez paramétrer votre site web et créer la base de données. Cette étape a été préparée par le RPM d'installation.<br />
<br />
Ouvrez votre navigateur à l'adresse ''https://yourdomain.com/egroupware/gallery/gallery2/install'' et suivez les instructions.<br />
<br />
Dans la 4ème étape, le chemin vers le dossier de stockage est demandé. L'installation du RPM a préparé ''/opt/egroupware/files/g2data'', veuillez ne pas changer le chemin et les permissions!<br />
<br />
[[image:EGW-G2-data.png]]<br />
<br />
Dans la 5ème étape, les informations MySQL sont demandées. L'installation du RPM a préparé ''egwuser'' ''egroupware'' et votre ''DbPassword'' automatiquement. Cliquez simplement sur sauvegarder et finissez l'installation.<br />
<br />
[[image:EGW-G2-DB-setup.png]]<br />
<br />
===Icone Gallery2===<br />
Une fois la configuration terminée, vous pouvez ajouter l'icone dans l'interface d'eGroupWare.<br />
Connectez vous à eGroupWare avec un compte admin et éditez un utilisateur ou un groupe pour lui ajouter l'application Gallery.<br />
<br />
[[image:EGW-G2-add_icon.jpg]]<br />
<br />
{{Note box|Gallery peut être accédé sans authentification à l'adresse ''https://votredomaine.com/egroupware/gallery/gallery2''}}<br />
<br />
==Informations supplémentaire==<br />
<br />
*[http://www.egroupware.org Site web d'eGroupWare]<br />
*[http://gallery.menalto.com/ Site web de Gallery]<br />
*[http://forums.contribs.org/index.php?topic=35146.0 topic sur le forum de contribs.org]<br />
*[http://forums.contribs.org/index.php?topic=35861.0 topic sur le forum de contribs.org]<br />
<br />
Have much fun with eGroupware as your preferred Groupware !<br />
<br />
''Dietmar Berteld (berdie)''<br />
<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Groupware/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000https://wiki.koozali.org/index.php?title=OsCommerce/fr&diff=7819OsCommerce/fr2008-02-07T23:01:21Z<p>Cool34000: Traduction FR</p>
<hr />
<div>{{Languages|OsCommerce}}<br />
=osCommerce 2.2RC1 pour SME 7.x=<br />
<br />
==Mainteneur==<br />
[[User:Cool34000|Sylvain Gomez]]<br/><br />
mailto:sylvaingomez@free.fr<br />
<br />
==Description==<br />
osCommerce est une solution de commerce en ligne open source qui est disponible gratuitement sous licence GNU Licence Publique Générale. Il dispose de série d'un jeu riche de fonctionnalités de chariot en ligne qui permet au propriétaire du magasin de paramétrer, lancer et maintenir ce magasin en ligne sans efforts et ce, sans aucune dépense, honoraires, ou limitations impliquées.<br />
<br />
Pour plus d'informations visitez http://www.oscommerce.com/''.<br />
<br />
==Installation et désinstallation==<br />
Pour l'installation, tapez la commande suivante <br />
yum install smeserver-oscommerce --enablerepo=smecontribs<br />
Pour la désinstallation, tapez la commande suivante <br />
yum remove smeserver-oscommerce<br />
Vous pouvez ignorer les commentaires de YUM vous invitant à faire un ''signal event post-upgrade'' et un ''signal-event reboot''.<br />
<br />
==Utilisation==<br />
Pour utiliser osCommerce, ouvrez votre navigateur préféré à l'adresse ''http://domaine.com/oscommerce''.<br />
<br />
Le panneau d'administration est disponible à l'adresse ''https://domaine.com/oscommerce/admin''.<br />
<br />
{{Warning box|type=Warning|Pour des raisons de sécurités, veuillez changer dès que possible le mot de passe admin !<br />
User : admin<br />
<br />
Pass : admin<br />
}}<br />
<br />
==Informations additionnelles==<br />
*[http://www.oscommerce.com/ Site web]<br />
*[http://www.oscommerce.com/community/contributions Contributions]<br />
<br />
<br />
<br />
<br />
''Sylvain Gomez (Cool34000)''<br />
<br />
----<br />
[[Category: Contrib/fr]]<br />
[[Category: Webapps/fr]]</div>Cool34000