Installation von epirent auf macOS

Beachten Sie das Aktualisierungen auf ältere Versionen gesonderte Aktionen erfordern kann.
—> siehe "Für ältere Versionen > macOS"

Download

Stelle sicher die richtigen Zugangsdaten für unsere Webportal zur Hand zu haben.

  • Mit dem Browser unsere Homepage https://epi.rent aufrufen.
  • Über das „Haus-Symbol“ (oben rechts) können die privaten Daten eingesehen werden!
  • Über den Reiter „Downloads“ epirent Einzelplatz oder Server&Client für Ihr Betriebssystem herunterladen.

Browser:
z.B. Safari, Firefox, Chrome

32- oder 64-bit?

  • Spotlight-Suche öffnen („cmd“-Taste + Leertaste)
  • „Terminal“ eintippen und öffnen (Enter)
  • folgenden Befehl ausführen:
getconf LONG_BIT

Strukturaufbau

Wir empfehlen die zu erzeugende Datenbankdatei außerhalb des Anwendungspaketes zu speichern und die BackUps auf einer separatem Festplatte speichern zu lassen.

Erstelle dazu zunächst einen Hauptordner, z.B. epirent_Server oder epirent_EP.
In diesen Ordner wird/werden später die Anwendung/en abgelegt.

Erstelle den Unterordner epirent_Data.
Auf der separaten Festplatte erstellen Sie den Ordner epirent_BackUp.
Falls keine separate Festplatte existiert erstellen Sie den BackUp-Ordner ebenfalls als Unterordner.


Hauptordner:
Wir empfehlen den Speicherort „Home“ des Benutzers.

Anwendungs-Installation macOS

Ggf. über den Finder des Rechners Downloads öffnen.

  • Mit rechter Maustaste auf die Datei „epirentxxx_xxx.dmg“ klicken und aus dem Menü Öffnen wählen oder Datei mit Doppelklick öffnen.

Es öffnet sich das Fenster mit der Software-Lizenz.

  • Diese muss nach dem Durchlesen akzeptiert werden.

Die „.dmg“-Datei wird geöffnet, dies kann etwas dauern.


  • Die Anwendung in den erstellten „epirent_Server“ oder „epirent_EP“ Ordner ziehen.

Die epirent-Datei wird in den gewählten Ordner kopiert. Dies nimmt erneut Zeit in Anspruch. Es ist keine Aktion notwenidg.


Verknüpfungen erstellen:

  • Öffnen Sie im „Finder“ die epirent Struktur: „epirent_Server“ oder „epirent_EP“
  • Klicken Sie mit der linke Maustaste auf die „epirent Server.app“ oder „epirent.app“
  • Wählen Sie „Alias erzeugen“ und Verifizieren Sie sich ggf. als Administrator
  • Der erzeugte Alias kann nun verschoben werden

Inbetriebnahme

:!:
epirent starten!

Bei der Server-Client Variante muss der epirent Server gestartet sein damit der epirent Client funktioniert.

—> Nur bei Neuinstallation
Es öffnet sich eine Abfrage zur Datenbankdatei, .4DD (nicht .4DC).

  • Wähle Erzeugen oder Öffnen um eine Datenbankdatei zu erstellen oder zu verwenden.
  • Öffne den vorhin erstellten Ordner epirdent_data.
  • Sichere oder wähle die Datei „epirent-{NAME}.4DD“.

Einrichtungsassistent

Der Einrichtungsassistent öffnet sich bei der Client-Server Variante nach Start des Clients.


Alle Abfragen aus dem Einrichtungsassistenten können später in den administrativen Einstellungen geändert werden.
Mit dem Button Weiter bestätigen.


Abfrage der Währung: Zutreffendes auswählen.
Mit dem Button Weiter die aktuelle Auswahl bestätigen.
—> siehe "Einstellungen Währungen"


Abfrage der Sprachen: Zutreffendes auswählen.
+ drücken um die ausgewählte Sprache hinzuzufügen.
Mit dem Button Weiter die aktuelle Auswahl bestätigen.
—> siehe "Einstellungen Sprachen"


Eingabe der „eigenen Daten“, wie z.B. Firmenbezeichnung, Kürzel etc.
Eingabe der Lagerbezeichnung.
Mit dem Button die Auswahl bestätigen.
—> siehe "Einstellung Mandanten"
—> siehe "Einstellungen Lager & Lagerplätze"


Abfrage der Nummernkreisläufe für Stammdaten und Faktura.
Mit dem Button Fertig die aktuelle Auswahl bestätigen.
—> siehe "Einstellungen Nummernkreisläufe"


Mit dem Button Ok bestätigen.


Es stehen drei Möglichkeiten zur Registrierung zur Verfügung:

  1. Online: Der Lizenzschlüssel wird durch die Logeninformationen des Webportals automatisch geladen.
  2. Manuell: Der Lizenzschlüssel kann eingegeben werden.
  3. Demo (nur Einzelplatz): Es kann 30 Tage kostenlos auf die Datenbank zugegriffen werden.


Mit dem Button Weiter bestätigen.


:!:
epirent muss erneut gestartet werden. Das Standardpasswort für den Benutzer „Administrator“ ist admin!

macOS Konfiguration

In Bearbeitung


Einzelplatz-Konfiguration

Eine erste wichtige Maßnahme nach der Installation ist, die Einstellungen für das Backup zu konfigurieren!

  • Im Menü Ablage(macOS) oder Datei(Windows), den Punkt Administrative Einstellungen auswählen.

:!:
Einige Änderungen in den administrativen Einstellungen sind nur möglich, wenn sich als Administrator angemeldet wird.


In den Administrativen Einstellungen unter Administration Backup wählen.


Wir empfehlen ein tägliches Backup.
Datum und Uhrzeit für das erste Backup eingeben, das folgende Backup wird am entsprechenden Tag zur gleichen Uhrzeit ausgeführt.


Backup Prefs

:!: Achtung:
Unter dem Reiter Planer die „Automatisches Backup“-Einstellung auf Nie gestellt lassen oder stellen.


Inhalt
Datendatei und Struktur müssen für ein erfolgreiches Backup ausgewählt sein.

Backup Zielordner
Angabe des Speicherortes für die Backup-Dateien.
Hier den zuvor angelegten Ordner auf der zweiten Festplatte auswählen.

Logbuch-Verwaltung
Das epirent-Journal bei der Datenbankdatei oder den Backup-Dateien ablegen.
Dazu „Benutze Logbuch“ deaktivieren und beim erneuten aktivieren den Zielordner wählen.


Allgemeine Einstellungen

Die letzten 3 Backup-Dateien werden behalten.
Wir empfehlen, bei ausreichend Speicherplatz, 10 zu verwenden.

Die älteste Backup-Datei wird nach dem aktuellen Backup gelöscht.

Läuft ein Backup nicht, so wird das anstehende Backup zum nächsten geplanten Zeitpunkt gestartet.

Automatische Wiederherstellung

:!: Wenn die Datenbank beschädigt sein sollte, erfolgt eine automatische Reparatur.
Wenn die Datenbank unvollständig sein sollte, wird das letzte Protokoll (Log) integriert.
Aktivieren Sie diese Punkte unbedingt.


Cache Prefs

Hier kann der maximal verwendete Arbeitsspeicher, von epirent Server, angegeben werde.
Wird zu wenig angegeben können Suchen ungewöhnlich lange dauern.
Bei zu viel hat das ausführende Betriebssystem zu wenig. Halten Sie mindestens 2 GB für das Betriebssystem frei.


Server-Client-Konfiguration

Eine erste wichtige Maßnahme nach der Installation ist, die Einstellungen für das Backup zu konfigurieren!


Server-Konfiguration

macOS: Öffnen Sie zunächst das Administrationsfenster des Servers, Statusleiste > Fenster > Administration.
Windows: Beenden Sie den epirent-Dienst, sofern eingerichtet, und führen die „.exe“-Datei aus.

Unter Ablage/Bearbeiten (macOS/Windows) befindet sich das Menü Datenbank-Eigenschaften > Struktur Einstellungen.
In dem neuem Fenster muss noch auf den Reiter Backup gewechselt werden.

:!: Achtung:
Unter dem Reiter Planer die „Automatisches Backup“-Einstellung auf Nie gestellt lassen oder stellen.


Inhalt
Datendatei und Struktur müssen für ein erfolgreiches Backup ausgewählt sein.

Backup Zielordner
Angabe des Speicherortes für die Backup-Dateien.
Hier den zuvor angelegten Ordner auf der zweiten Festplatte auswählen.

Logbuch-Verwaltung
Das epirent-Journal bei der Datenbankdatei oder den Backup-Dateien ablegen.
Dazu „Benutze Logbuch“ deaktivieren und beim erneuten aktivieren den Zielordner wählen.


Allgemeine Einstellungen

Die letzten 3 Backup-Dateien werden behalten.
Wir empfehlen, bei ausreichend Speicherplatz, 10 zu verwenden.

Die älteste Backup-Datei wird nach dem aktuellen Backup gelöscht.

Läuft ein Backup nicht, so wird das anstehende Backup zum nächsten geplanten Zeitpunkt gestartet.

Automatische Wiederherstellung

:!: Wenn die Datenbank beschädigt sein sollte, erfolgt eine automatische Reparatur.
Wenn die Datenbank unvollständig sein sollte, wird das letzte Protokoll (Log) integriert.
Aktivieren Sie diese Punkte unbedingt.


Cache / Arbeitsspeicher

Unter Ablage/Bearbeiten befindet sich das Menü Datenbank-Eigenschaften > Benutzer Einstellungen.
In dem neuem Fenster muss noch auf den Reiter Datenbank gewechselt werden.

Hier kann der maximal verwendete Arbeitsspeicher, von epirent Server, angegeben werde.
Wird zu wenig angegeben können Suchen ungewöhnlich lange dauern.
Bei zu viel hat das ausführende Betriebssystem zu wenig. Halten Sie mindestens 2 GB für das Betriebssystem frei.


Client-Konfiguration

Im Menü Ablage(macOS) oder Datei(Windows), den Punkt Administrative Einstellungen auswählen.

:!:
Änderungen in den administrativen Einstellungen sind teilweise nur möglich, wenn der Administrator (-Benutzer) angemeldet ist.

In den Administrativen Einstellungen unter Administration Backup wählen.


„Erweiterte Einstellungen“ sind nur für die Einzelplatz-Version.
Wir empfehlen ein tägliches Backup.
Datum und Uhrzeit für das erste Backup eingeben, das folgende Backup wird am nächsten Tag / Woche zur gleichen Uhrzeit ausgeführt.


PDF-Treiber Installation macOS

Unter macOS ist eine PDF-Treiberinstallation nur notwendig falls eine PDF-Briefvorlage verwendet wird.
—> Administrative Einstellungen > PDF

Installation

Laden Sie die nötige Software herunter.

  • Unter „Mehr Tools“
  • PDFtk 2.02 herunterladen
  • ab „EL Capitan“ (macOS 10.11) verwenden Sie den unteren Link

Die heruntergeladene „pdftk_server-2.02-mac_osx-10.xx-setup.pkg“ ausführen und einfach installieren.


Nun epirent starten.

Update von epirent auf macOS

Download

Stelle sicher die richtigen Zugangsdaten für unsere Webportal zur Hand zu haben.

  • Mit dem Browser unsere Homepage https://epi.rent aufrufen.
  • Über das „Haus-Symbol“ (oben rechts) können die privaten Daten eingesehen werden!
  • Über den Reiter „Downloads“ epirent Einzelplatz oder Server&Client für Ihr Betriebssystem herunterladen.

Browser:
z.B. Safari, Firefox, Chrome

32- oder 64-bit?

  • Spotlight-Suche öffnen („cmd“-Taste + Leertaste)
  • „Terminal“ eintippen und öffnen (Enter)
  • folgenden Befehl ausführen:
getconf LONG_BIT

Backup

:!:
Achtung: Vor einem Update muss immer ein Backup der Datenbank gemacht werden

Währenddessen muss epirent beendet sein.
Unter Windows ist epirent ggf. als Dienst installiert.
Sofern unserer Installations-Anleitung gefolgt wurde sind die entsprechenden Dateien im Ordner „epirent_Data“.

Das Datenpaket umfasst folgende Dateien und Ordner:
dbname.4DD
dbname.index
dbname.journal
dbname.externalData
dbname.match

„dbname“ steht für Ihre individuelle Benennung der Dateien, meist epirent-„Name“.

  • Dieser wird per Rechtsklick komprimiert, dubliziert oder an einen anderen Ort kopiert.

  • Die vorhandene epirent-Anwendung umbenennen z.B „epirent_old“, „epirent Server_old“.

Anwendungs-Installation macOS

Ggf. über den Finder des Rechners Downloads öffnen.

  • Mit rechter Maustaste auf die Datei „epirentxxx_xxx.dmg“ klicken und aus dem Menü Öffnen wählen oder Datei mit Doppelklick öffnen.

Es öffnet sich das Fenster mit der Software-Lizenz.

  • Diese muss nach dem Durchlesen akzeptiert werden.

Die „.dmg“-Datei wird geöffnet, dies kann etwas dauern.


  • Die Anwendung in den erstellten „epirent_Server“ oder „epirent_EP“ Ordner ziehen.

Die epirent-Datei wird in den gewählten Ordner kopiert. Dies nimmt erneut Zeit in Anspruch. Es ist keine Aktion notwenidg.


Verknüpfungen erstellen:

  • Öffnen Sie im „Finder“ die epirent Struktur: „epirent_Server“ oder „epirent_EP“
  • Klicken Sie mit der linke Maustaste auf die „epirent Server.app“ oder „epirent.app“
  • Wählen Sie „Alias erzeugen“ und Verifizieren Sie sich ggf. als Administrator
  • Der erzeugte Alias kann nun verschoben werden

Inbetriebnahme

:!:
epirent starten!

Bei der Server-Client Variante muss der epirent Server gestartet sein damit der epirent Client funktioniert.

—> Nur bei Neuinstallation
Es öffnet sich eine Abfrage zur Datenbankdatei, .4DD (nicht .4DC).

  • Wähle Erzeugen oder Öffnen um eine Datenbankdatei zu erstellen oder zu verwenden.
  • Öffne den vorhin erstellten Ordner epirdent_data.
  • Sichere oder wähle die Datei „epirent-{NAME}.4DD“.

Einstellungen übertragen

  • Altes Anwendungspaket (epirent_old, epirent Server_old) öffnen
  • In der Struktur „Database“ oder „Server Database“ den Ordner „Preferences“ auswählen und in die Zwischenablage kopieren (Rechtsklick > „Preferences“ kopieren).
  • Neues Anwendungspaket (epirent, epirent Server) öffnen
  • In der Struktur „Database“ oder „Server Database“ den vorhanden „Preferences“ Ordner löschen und den sich in der Zwischenablage befindenden einfügen.

Anwendungspaket öffnen:

  • Per Rechtsklick und Auswahl des Punktes „Paketinhalt anzeigen“
  • Sie können vor dem Öffnen die „cmd“-Taste gedrückt halten um direkt einen neuen Tab zu öffnen.
  • Die Anwendungsstruktur befindet sich im Unterordner „Contents“

Update abschließen

nur Server-Client:
Der „epirent Client“ aktualisiert sich über „epirent Server“.
Ein manuelles Update ist nur beim Versionssprung von „epirent 4“ zu „epirent“ notwendig.
Sollte die automatische Aktualisierung nicht funktionieren hat der ausführende Benutzer keine ausreichenden Rechte.
Die Abschlussmeldung erscheint bei der Server-Client Variante nach dem Start des epirent Client.

alle Versionen:

  • Meldung mit Ok bestätigen.

Sollte die Meldung nicht erscheinen wurde das Update nicht erfolgreich installiert.
Ein löschen der Cache-Dateien kann abhelfen.

Wartung & Administration macOS

Wartungsmodus

Mit dem Wartungsmodus kann die Datenbankdatei auf Beschädigungen
von außen (Festplattenfehler, Abstürze, etc.) und innen (Indexfehler, Gremlins, etc.) geprüft und ggf. repariert werden.


Maintenance and Security Center(MSC):

Beenden Sie zunächst Ihren epirent Einzelplatz oder Server.
Starten Sie den epirent Einzelplatz- oder die Serverversion und halten sie sofort danach die Alt-Taste gedrückt.

In dem neuen Fenster den letzten Punkt Das Maintenance and Security Center öffnen auswählen und den Button Weiter drücken.


Prüfen:

Im Reiter „Prüfen“ kann eine erste Kontrolle der Datenbank durchgeführt werden.


Wiederherstellen:

Unter dem Reiter „Wiederherstellen“ können die BackUp-Dateien entpackt werden.

Zunächst muss in der linken Spalte ein BackUp gewählt werden.
Falls Ihnen keine angezeigt werden, klicken Sie unten auf „Wählen“ und navigieren Sie zu Ihren BackUp-Ordner.

In der rechten Spalte kann nun der zu wiederherstellende Inhalt ausgewählt werden.
Sie benötigen in der Regel nur die „.4dd“-Datei und den „.ExternalData“-Ordner.
Abschließend kann der Zielordner konfiguriert werden.
Wählen Sie nicht „epirent_data“ aus, eine Wiederherstellung ist keine Reperatur(siehe unten).

Haben Sie alle Einstellungen überprüft, drücken Sie ganz unten rechts auf „Wiederherstellen“.

Die wiederhergestellte Datenbank wird in dem angegebenen Ordner abgelegt und nicht automatisch von „epirent“ eingebunden.

Dies kann über zwei Wege bewerkstelligt werden:

1. Auswahl einer neuen Datenbankdatei
Starten Sie dazu „epirent“ erneut mit gedrückter „Alt“-Taste.
Wählen Sie anschließend „Eine andere Datendatei auswählen“.
Sofern Sie die wiederhergestellte Datenbank wählen ist die laufende Datenbank nicht mehr im Ordner „epirent_data“.

2. Datenbankdatei austauschen:
Sichern Sie Ihre originale (beeinträchtigte) Datenbankdatei („epirent_Data“-Ordner).
Verschieben Sie die wiederhergestellte Datenbankdatei in den Ordner der original Datenbankdatei.


Reparieren:

:!: Eine Reparatur ist nur hilfreich, falls in der Prüfung Fehler | Error aufgetreten sind.
Eine Reparatur löst keine Dispofehler.
Eine Reparatur bringt keine „nicht auffindbare Informationen“ zurück.

Achten Sie zunächst auf die Pfade der zu reparierenden Datenbankdatei und Ihrer BackUps. Prüfen Sie, ob die Pfade korrekt sind.

Führen Sie nur eine Standard Reparatur durch.
Einige „Anomalien“ verschwinden erst nach Neustart von epirent und, oder des Rechners.
Sie sind in der Regel keine Beeinträchtigung der Datenbankdatei und werden ebenfalls durch unsere Wartungsroutinen behoben.

Das „Reparieren nach Datensatzheader“ kann auch Informationen aus Ihrer Datenbankdatei löschen, um deren Funktionalität wiederherzustellen.
Sie sollten unbedingt einen Techniker der EPI development konsultieren bevor Sie eine solche Reparatur auslösen, bezüglich der Notwendigkeit.

Erläuterung:
Anwendung: Die Datenträgerfunktionalität der Datenbankdatei war stark beeinträchtigt, die Datei konnte geradeso gerettet werden.
Dennoch sind die gespeicherten Datensätze innerhalb der Datenbankdatei nun schwer beschädigt, epirent sagt „Nein“.
Das „Reparieren nach Datensatzheader“ überschreibt die Datensätze dessen Headerinformationen er findet.
In den Datensatzheadern sind weniger Informationen, komprimierter gespeichert als in den den Datensätzen selbst.
Dadurch können insbesondere Verknüpfungs-Informationen (z.B. Vertriebstätigkeiten in Adressen, Packscheine und Rechnungen bei Aufträgen) verloren gehen.


Cache löschen macOS

Sämtliche Cache-Ordner können ohne bedenken gelöscht werden, während „epirent“ beendet ist.

  • Öffnen Sie den „Finder“
  • Klicken Sie in der Statusleiste auf „Gehe zu“
  • Halten Sie die „Alt“-Taste gedrückt und wählen Sie den Punkt „Library“

Liste an möglichen Cache-Ordnern epirent.app (Einzelplatz; schwarzer Ring):
- Application Support > epirent
- Caches > epirent
- Caches > 4d.com….
- Caches > com.4D….
- Saved Application State > 4d.com….
- Saved Application State > com.4D….

Liste an möglichen Cache-Ordnern epirent.app (Server; weißer Ring):
- Application Support > epirent
- Caches > epirent
- Caches > 4d.com….
- Saved Application State > 4d.com….
- WebKit > 4d.com….

Liste an möglichen Cache-Ordnern epirent Client.app:
- Application Support > epirent Client
- Caches > epirent Client
- Caches > com.4D….
- Saved Application State > com.4D….

Tipps & Empfehlungen macOS

Download:

Browser:
z.B. Safari, Firefox, Chrome

32- oder 64-bit?

  • Spotlight-Suche öffnen („cmd“-Taste + Leertaste)
  • „Terminal“ eintippen und öffnen (Enter)
  • folgenden Befehl ausführen:
getconf LONG_BIT

Strukturaufbau:

Hauptordner:
Wir empfehlen den Speicherort „Home“ des Benutzers.

Installation:

Verknüpfungen erstellen:

  • Öffnen Sie im „Finder“ die epirent Struktur: „epirent_Server“ oder „epirent_EP“
  • Klicken Sie mit der linke Maustaste auf die „epirent Server.app“ oder „epirent.app“
  • Wählen Sie „Alias erzeugen“ und Verifizieren Sie sich ggf. als Administrator
  • Der erzeugte Alias kann nun verschoben werden

Einstellungen übertragen:

Anwendungspaket öffnen:

  • Per Rechtsklick und Auswahl des Punktes „Paketinhalt anzeigen“
  • Sie können vor dem Öffnen die „cmd“-Taste gedrückt halten um direkt einen neuen Tab zu öffnen.
  • Die Anwendungsstruktur befindet sich im Unterordner „Contents“

Bis Version 5.9635

Bevor epirent gestartet werden kann müssen gegebenenfalls die Sicherheitseinstellungen angepasst werden:

  • In den Systemeinstellungen innerhalb des Menüs Sicherheit muss der Punkt von Apps-Download erlauben auf Keine Einschränkungen gestellt werden.
  • Starten des neuen Programms „epirent“ per Doppelklick.
  • Wir empfehlen die geänderten Sicherheitseinstellungen wieder auf Ihre Ursprungsform zurückzustellen.

Ab macOS Sierra (10.12) ist die Auswahl von „Keine Einschränkungen“ ausgeblendet. Über das Terminalfenster lassen sich diese

Einblenden:

sudo spctl --master-disable

Ausblenden:

sudo spctl --master-enable