card_1 Backup – Projektarchivierung

Die card_1 Projekte werden zentral über ein Datenbanksystem verwaltet. Die zugehörigen Projektinformationen befinden sich daher nicht an einem einzelnen Speicherort, sondern sind auf verschiedene Bereiche der Festplatte verteilt. Darüber hinaus können Projekte in beliebigen Ordnern angelegt werden, wodurch sich die Daten weiter über die Festplatte verteilen.

Das Tool 'card_1 Backup' archiviert die Projektdaten automatisch und lässt sich problemlos in ein unternehmensinternes Sicherungskonzept integrieren. Es ist auf allen Betriebssystemen einsetzbar, die über eine Java-Laufzeitumgebung (Java Runtime Environment, JRE) verfügen. Der Sicherungsvorgang kann sowohl manuell als auch zeitgesteuert über die Kommandozeile des jeweiligen Betriebssystems gestartet werden.

Für den Einsatz des card_1 Backups gelten folgende Rahmenbedingungen:

  • Auf dem card_1 Arbeitsplatz muss eine Java Runtime Environment (JRE) installiert sein. Nähere Informationen finden Sie hier.
  • Das card_1 Backup muss eine Verbindung zum Firebird-Datenbankserver herstellen können (Firewalls beachten!).
  • Die card_1 Datenbank-Konfigurationsdatei 'Dbconfig.dat' muss lesend zur Verfügung stehen.
  • Die card_1 Projektsammelordner müssen lesend zur Verfügung stehen.
  • Der Sicherungsordner, in dem die card_1 Projekte archiviert werden, muss für das card_1 Backup beschreibbar sein.

  • Die Log-Datei muss für das card_1 Backup beschreibbar sein. Sie wird standardmäßig im Backup-Programmordner gespeichert. Wenn sich der Backup-Programmordner in einem schreibgeschützten Bereich befindet, können Sie den Speicherort der Log-Datei ändern: Öffnen Sie dazu die Datei Log4j2.xml im Backup-Programmordner mit einem Editor und ersetzen Sie in der Property-Zeile './log' durch den Pfad zum Log-Ordner.

    <Property name="LOG_DIR">./log</Property>

  • Die Versionen der Dateien cardbackup.jar und export.jar müssen übereinstimmen. Ist dies nicht der Fall, wird das Backup abgebrochen und eine entsprechende Meldung im Protokoll ausgegeben. Kopieren Sie die nicht übereinstimmende jar-Datei aus dem card_1 Programmordner in Ihren Backup-Programmordner.

Ab JDK 19 wird der Zeichensatz UTF-8 standardmäßig genutzt. Vor JDK 19 wurde UTF‑8 nur unter Microsoft Windows 11, Microsoft Windows Server 2019 oder Linux genutzt. Um UTF-8 für das Backup zu verwenden, muss im Java-Aufruf der Parameter '‑Dfile.encoding' gesetzt werden. Wenn dieser Parameter nicht gesetzt ist, wird das Backup abgebrochen.

Beispiel: Parameter für 'Cp1252' (Code für den westeuropäischen Zeichensatz)

  • Microsoft Windows 11, Microsoft Windows Server 2019

    "c:\Program Files\Java\jdk-21\bin\java.exe" -Dfile.encoding=Cp1252
    -jar "C:\Program Files\IBuT\CARD101\CARDP\Backup\CardBackup.jar"
/config="C:\CARD_Projekte\CARD101\dbconfig.dat"
/destination="C:\CARDBACKUP101" /increment /silent

  • Linux

    .../java -Dsun.jnu.encoding=Cp1252 -Dfile.encoding=Cp1252 -jar cardbackup.jar ...

Bei der Installation von card_1 wird das Backup automatisch in Ihrem card_1 Programmordner eingerichtet und konfiguriert. Sie können das Backup aber auch jederzeit nachträglich installieren. Dadurch ist es möglich, es an einem anderen Ort, beispielsweise auf dem Server, einzurichten.

WARNUNG  Beachten Sie jedoch, dass eine Aktualisierung per Freshup nicht möglich ist, wenn Sie das Backup außerhalb des card_1 Programmordners installieren.

Einrichten des Backups mit der card_1 Installation (Standardinstallation)

Das Backup und eine ausführbare Backup-Konfigurationsdatei werden im Unterordner \BACKUP des card_1 Programmordners eingerichtet. Eine Aktualisierung erfolgt automatisch per Freshup.

  • Backup-Programmordner: Der Ordner \BACKUP wird als Unterordner im card_1 Programmordner eingerichtet. Dies ist der Ordner, in dem das Backup-Programm installiert wird.

  • Backup-Konfigurationsdatei (*.cmd): Im Ordner \BACKUP wird eine ausführbare Konfigurationsdatei angelegt. Diese Datei wird im card_1 Verknüpfungsordner angelegt ist direkt startbar.

    Beispiel: Inhalt einer Backup-Konfigurationsdatei

    "c:\Program Files\Java\jdk-21\bin\java.exe" -Dfile.encoding=Cp1252
-jar "C:\Program Files\IBuT\CARD101\CARDP\Backup\CardBackup.jar"
/config="C:\CARD_Projekte\CARD101\dbconfig.dat"
/destination="C:\CARDBACKUP101" /increment /silent
  • E-Mail-Konfigurationsdatei (email.xml): Damit lassen sich Fehlerinformationen des Backups per E-Mail an einen vordefinierten Empfänger senden (siehe Steuerungsparameter: E-Mail-Konfigurationsdatei). Die Konfigurationsdatei befindet sich standardmäßig im Ordner des Backup-Programms. Kopieren Sie diese bitte in den card_1 Projektsammelordner, der gesichert werden soll.
  • Projektsicherungsordner: Parallel zum card_1 Projektsammelordner wird ein Projektsicherungsordner CARDBACKUP101 angelegt. Hier werden Ihre card_1 Projekte mithilfe des Backups archiviert.

Nachträgliches Einrichten des Backups

Starten Sie die card_1 Installation und wählen Sie im Hauptmenü die Option 'Weitere Installationen > card_1 Backup (Projekte archivieren) installieren' aus. Nähere Informationen finden Sie hier.

Wenn Sie das card_1 Backup über die erzeugte Verknüpfung starten, werden die card_1 Projekte im Backup-Sicherungsordner archiviert. Alternativ können Sie das Backup auch über eine Zeitsteuerung starten.

Welche Projekte werden gesichert?

Welche Projekte werden nicht gesichert?

Über die card_1 Projektverwaltung legen Sie fest, welche Projekte gesichert werden sollen. Wenn das Projektattribut Archivierung aktiviert ist, wird das Projekt mithilfe des card_1 Backups gesichert.

Folgende Projekte werden nicht mit dem card_1 Backup gesichert:

  • Projekte, die nicht der aktuellen Datenversion des Projektbereichs entsprechen.

  • Gelockte Projekte, da sie in Benutzung sind.

Das card_1 Backup unterstützt die folgenden Parameter, die Sie über die Kommandozeile setzen:

Parameter

Beschreibung

Anmerkung

config

Pfad zur card_1 Datenbank-Konfigurationsdatei dbconfig.dat im lokalen Dateisystem.

Beispiel: 

/config="C:\CARD_Projekte\CARD101\dbconfig.dat"

erforderlich

destination

Pfad zum Sicherungsordner, in dem die card_1 Projekte archiviert werden.

Beispiel: 

/destination="C:\CardBackup101"

erforderlich, ohne Backslash am Ende

shareFS

Freigabename für den Zugriff der Clients inklusive Servername (SMB Share).

optional

localFS

Pfad zur Freigabe im lokalen Dateisystem. Dieser Pfad ist erforderlich, um nicht über den Freigabenamen auf die Projektordner zuzugreifen. Pfadangaben zu den Projektordnern, die die Freigabe verwenden, werden durch den lokalen Pfad ersetzt.

optional, muss angegeben werden, wenn 'shareFS' verwendet wird.

increment

Die Datenbank wird nur gesichert, wenn sich seit dem letzten Backup Änderungen ergeben haben.

optional (empfohlen, da schneller)

silent

Mit diesem Schalter wird die Ausgabe aller Meldungen auf der Konsole unterbunden.

Wenn Sie das Backup auf einem Unix- bzw. Linux-Server ausführen, wird keine Konsole benötigt.

optional

help

Ausgabe einer Kurzhilfe zu den Parametern.

 

Während des Backups wird eine Log-Datei erstellt. Diese enthält Informationen über die Sicherung aller im Projektsammelordner registrierten Projekte.

Wird das Backup im Rahmen eines automatisierten Prozesses im Hintergrund ausgeführt, muss im Anschluss eine Fehlerprüfung stattfinden. Erfahrungsgemäß findet diese jedoch unregelmäßig statt, sodass fehlerhafte Backups möglicherweise unentdeckt bleiben. Sie haben jedoch die Möglichkeit, die Fehlerinformationen des Backups per E-Mail an einen vordefinierten Empfänger zu senden.

Die Konfigurationsdatei für die E-Mail-Benachrichtigung (Datei 'email.xml') befindet sich standardmäßig im Ordner des Backup-Programms. Kopieren Sie diese bitte in den zu sichernden card_1 Projektsammelordner.

HINWEIS  Eine E-Mail wird nur versendet, wenn das Backup fehlerhaft ist und die Konfigurationsdatei korrekt mit den erforderlichen Parametern besetzt ist.

Parameter

Bedeutung

auth

Authentifizierung ein/aus: true | false

cc

E-Mail-Adresse Cc-Empfänger

debug

Debug-Modus für Fehlersuche ein/aus: true | false

from

E-Mail-Adresse Absender

passwd

Passwort, wenn auth="true" verwendet wird

port

SMTP-Port: 25 | 465 | 587

25: unverschlüsselt

sendMail

E-Mail-Versand ein/aus: true | false

smtphost

SMTP-Servername, z. B. smtp.mustermann.de

subject

E-Mail-Betrefftext

tlsenable

StartTLS, SSL/TLS: true | false

Ports 465 | 587 erfordern 'auth'

to

E-Mail-Adresse Empfänger

HINWEIS  Bitte beachten Sie auch den Abschnitt Nutzung von UTF-8.

Im folgenden Beispiel wird das card_1 Backup auf einem lokalen Windows-Rechner gestartet. Die Verwaltung der card_1 Projekte erfolgt ebenfalls auf dem lokalen Windows-Rechner.

Windows-Client

  • Name des Windows-Rechners und der Freigabe: nicht relevant

card_1 Projekte

  • Pfad zum Projektsammelordner: C:\CARD_Projekte\CARD101
  • Pfad zur Datenbank-Konfigurationsdatei: C:\CARD_Projekte\CARD101\dbconfig.dat
  • Pfad zum Datenbankordner: C:\CARD_Projekte\CARD101\CARDDB

card_1 Backup

  • Pfad zum Backup-Programmordner: C:\Program Files\IBuT\CARD101\CARDP\BACKUP
  • Name der Backup-Konfigurationsdatei: backup.cmd
  • Pfad zum Projektsicherungsordner: C:\CardBackup101

Inhalt der Backup-Konfigurationsdatei

"c:\Program Files\Java\jdk-21\bin\java.exe" -Dfile.encoding=Cp1252
-jar "C:\Program Files\IBuT\CARD101\CARDP\BACKUP\CardBackup.jar"
/config="C:\CARD_Projekte\CARD101\dbconfig.dat"
/destination="C:\CardBackup101" /increment /silent

Im folgenden Beispiel wird das card_1 Backup auf einem Windows-Server gestartet. Die Verwaltung der card_1 Projekte erfolgt ebenfalls auf dem Windows-Server.

HINWEIS  Die Parameter 'localFS' und 'shareFS' sind nur notwendig, wenn der Zugriff zum card_1 Projektsammelordner über den Freigabenamen nicht gewährt ist.

Windows-Server

  • Name des Windows-Servers: Projektserver
  • Name der Freigabe: Projekte

card_1 Projekte

  • Lokaler Pfad zum Projektsammelordner: C:\CARD_Projekte\CARD101
  • Lokaler Pfad zur Datenbank-Konfigurationsdatei: C:\CARD_Projekte\CARD101\dbconfig.dat
  • Lokaler Pfad zum Datenbankordner: C:\CARD_Projekte\CARD101\CARDDB

card_1 Backup

  • Pfad zum Backup-Programmordner: C:\Program Files\IBuT\CARD101\CARDP\BACKUP
  • Name der Backup-Konfigurationsdatei: backup.cmd
  • Lokaler Pfad zum Projektsicherungsordner: C:\CardBackup101

Inhalt der Backup-Konfigurationsdatei

"c:\Program Files\Java\jdk-21\bin\java.exe"
-jar "C:\Program Files\IBuT\CARD101\CARDP\BACKUP\CardBackup.jar"
/config="C:\CARD_Projekte\CARD101\dbconfig.dat"
/destination="C:\CardBackup101" /shareFS=<\\Projektserver\Projekte>
/localFS=C:\CARD_Projekte\CARD101 /increment /silent