Frequently Asked Questions

Befinden sich Dateien mit Umlauten in den zu sichernden Verzeichnissen, so verlangt die Konfiguration des TSM-Clients mitunter eine besondere Vorbereitung, damit sichergestellt ist, dass alle Dateien fehlerfrei gesichert werden.

Ändern Sie die hier beschrieben Einstellungen nur dann, wenn Sie vom RRZ dazu aufgefordert werden oder aber, wenn dies in der entsprechenden Erstkonfiguration ausdrücklich gefordert wird!

Als erstes muss sichergestellt werden, dass die zum Sichern verwendete "locale" auch vorhanden ist. Tippen Sie dazu den Befehl

locale -a |grep en_US

ein. Es sollten nun mindestens die Einträge "en_US.iso885915" und "en_US.utf8" aufgelistet werden. Sollte dies nicht der Fall sein, dann führen Sie bitte die Befehle

locale-gen en_US.ISO-8859-15
locale-gen en_US.UTF-8

aus. Sollten Sie nicht als root eingeloggt sein, so setzen Sie dem Befehl unter Debian oder Ubuntu ein sudo voran. Unter SUSE Linux verwenden Sie bitte yast (System => Language).

Anschließend müssen Sie immer vor dem Starten des TSM-Clients (egal ob GUI oder das Kommandozeilentool dsmc) bzw. vor dem Starten des Schedulers folgende Befehle an der Kommandozeile ausführen:

unset LC_ALL
export LANG=en_US.ISO-8859-15
export LC_CTYPE=en_US.ISO-8859-15

Kontrollieren Sie bitte in den ersten Tagen der Sicherung, ob es auf Ihrem System trotzdem noch Probleme mit der Kodierung von Dateinamen gibt. Sehen Sie sich dazu den Inhalt der Datei dsmerror.log (unter Linux meist im Verzeichnis /var/log/) genauer an, die Fehlermeldungen haben die Form

ANS4042E Object name '/your/path/to/file/l\ufffdwe.jpg' contains one or more unrecognised characters and is not valid.

Sollten diese Fehler trotz der oben aufgezeigten Konfiguration weiterhin bei Ihnen auftreten, so probieren Sie bitte stattdessen die Einträge

unset LC_ALL
export LANG=POSIX
export LC_CTYPE=en_US.UTF-8

Unter SLES in der 64bit-Version sollten Sie zudem mit dem Befehl

rpm -qa | grep glibc

überprüfen, ob das Paket 'glibc-locale-32bit' installiert ist. Falls dies nicht der Fall ist, installieren Sie es bitte mit yast, starten Sie danach den TSM-Scheduler neu und kontrollieren Sie, ob der Fehler weiterhin auftritt.

Wenn Fehlermeldungen dieser Art (entweder in der genannten Logdatei oder in der täglichen Mail, in der Sie über Probleme bei der Sicherung informiert werden) nach einem Update der Client-Software erstmals auftreten und Ihr System auf systemd als Init-System basiert (quasi alle aktuellen Linux-Distributionen), verfahren Sie bitte wie folgt:

Fügen Sie am Anfang der Datei

/opt/tivoli/tsm/client/ba/bin/dsmcad.service 

folgende Zeilen hinzu:

Environment="LANG=en_US"
Environment="LC_ALL=en_US"

Danach starten Sie bitte den TSM-Schedulerdienst neu:

systemctl daemon-reload
systemctl restart dsmcad.service

Funktionseinschränkung bei der Wiederherstellung von POSIX-Rechten

Auf Grund der Art und Weise, wie TSM Dateien sichert bzw. auswählt, wie gesichert wird (vgl. Dokumentation des TSM-Clients), ist es nicht möglich, geänderte POSIX-Rechte (user/group/other bzw. Owner- / Group-ID) auf einen Stand von vor dem letzten Sicherungslauf wiederherzustellen! Es lassen sich lediglich die Dateiinhalte entsprechend wiederherstellen, die POSIX-Rechte verbleiben auf dem "aktuellen" und somit ggf. unerwünschten Stand. Ausdrücklich nicht betroffen von dieser Funktionseinschränkung sind erweiterte Attribute und ACLs.

Das TSM-Knoten-Passwort wird automatisch alle 1-7 Tage geändert. Deswegen ist das manuelle Ändern des Passwortes in der Regel nicht notwendig. Falls es in Ihrem Fall doch notwendig ist, gehen Sie bitte wie folgt vor.

Das neue Passwort muss mindestens 6 und maximal 63 Zeichen enthalten, es sollte in keinem Wörterbuch vorkommen und auch nicht leicht aus solchen Wörtern ableitbar sein ('hamburg1' ist ein ähnlich schlechtes Passwort wie 'hamburg'). Die Groß-/Kleinschreibung ist dabei nicht relevant. Gültige Zeichen sind: a-z, 0-9, +, . (Punkt), _, -, & .

Das Passwort ändern Sie entweder auf der grafischen Oberfläche unter Utilities => Change Password hierzu benötigen Sie Ihr aktuelles Passwort. Alternativ funktioniert das auch auf der Kommandozeile:

dsmc set password

das neue Passwort wird dann interaktiv abgefragt.

Zur Verwendung des TSM-Clients muss ein Benutzer nicht zwingend lokale Administratorrechte haben, es genügen folgende spezielle Rechte bzw. Mitgliedschaften in den Gruppen:

• Mitglied der Gruppe Sicherungs-Operatoren / Backup-Operators.
• Privileg Verwalten von Überwachungs- und Sicherheitsprotokollen / Manage auditing and security log.
• Besitzer / Owner der Datei bzw. des Verzeichnisses, die / das gesichert bzw. restauriert werden soll.

Es lassen sich nur gezielt Verzeichnisse von der Sicherung mit Hilfe von Include/Exclude-Listen ein bzw. ausschließen.

Starten Sie dazu die TSM GUI und wählen Sie aus dem Menü Edit => Preferences => Include/Exclude.

Das Setzen / Auswählen der entsprechenden Filter für Verzeichnisse ist weder trivial noch sehr intuitiv, Sie sollten dort nur Veränderungen vornehmen, wenn Sie wirklich sicher sind, was genau Sie damit bewirken. Bei Bedarf schauen Sie bitte in die ISP-Client-Anleitung oder fragen Sie beim Backup-Team nach Unterstützung.

Wollen Sie explizit nur einen Unterverzeichnisbaum eines Dateisystems sichern, der nicht auf einem eigenen (physikalischem) Dateisystem liegt, so müssen folgende zwei Zeilen in die dsm.sys eintragen:

*********************************************************************
VIRTUALMOUNTPOINT  /home/user1
DOmain             /home/user1
*********************************************************************

Fehlerbild

Betrifft nur Ubuntu

Tritt nur beim Backup über den Scheduler Service auf, manuelle Backup ist Fehlerfrei.
Beispiel Fehlermeldung:

2022-05-12 15:23:56 ANS1228E Sending of object '/var/www/vhosts/formularetesten.blogs.uni-hamburg.de/Datenträger-Gebühr-einbuchen-300x188.png' failed.
2022-05-12 15:23:56 ANS4042E Object name '/var/www/vhosts/formularetesten.blogs.uni-hamburg.de/Datenträger-Gebühr-einbuchen-300x188.png' contains one or more unrecognized characters and is not valid.

Lösung

In beiden Dateien:

• /etc/systemd/system/dsmcad.service
• /opt/tivoli/tsm/client/ba/bin/dsmcad.service

Folgende Parameter setzen:

• Environment="LANG=en_US.UTF-8"
• Environment="LC_ALL=en_US.UTF-8"

Scheduling Services durchstarten: sudo service dsmcad restart

In bestimmten Fällen müssen Sie den ISP-Scheduler neu starten, z. B. wenn Sie die Client-Konfigurationsdatei geändert haben. Die Vorgehensweise unterscheidet sich je nach Betriebssystem, für alles benötigen Sie Administrator- bzw. root-rechte:

Windows

Rufen Sie die Diensteverwaltung über Systemsteuerung => Verwaltung => Dienste auf und suchen Sie dort den Eintrag TSM-Client-Acceptor. Klicken Sie mit der rechten Maustaste auf diesen Eintrag und wählen Sie Neu starten.

Linux / Ubuntu

Beenden und starten Sie den TSM-Scheduler mittels der üblichen Systemctl-Skripte, also

systemctl restart dsmcad.service

Neuere Versionen des ISP-Clients können einfach über die alte Version installiert werden. Die Konfigurationsdateien bleiben in jedem Fall erhalten, das gespeicherte TSM-Knoten-Passwort in der Regel ebenfalls. In seltenen Fällen kann es vorkommen, dass Sie das TSM-Knoten-Passwort noch einmal eingeben müssen. Sofern die notwendig ist, wenden Sie sich bitte ans RRZ.

Weitergehende Dokumentation zum ISP-Client finden Sie bei IBM:

• Online-Dokumentation
• PDF-Dokumentation