Dokumentation
OrangeHRM
OrangeHRM Upgrade
Annahmen und Beschränkungen
OrangeHRM und TurnKey Base OS
Dieses Dokument umfasst ausdrücklich das Upgrade von OrangeHRM v4.x (TurnKey v17.x) und/oder OrangeHRM v5.x (TurnKey v18.x) auf die neueste stabile OrangeHRM-Version (v5.7 zum Zeitpunkt des Schreibens). Das tut es NOT Cover Upgrade des zugrunde liegenden TurnKey / Debian OS auf die neueste Version.
TurnKey v17.x basiert auf Debian 11/Bullseye. Bullseye ist derzeit in "LTS" (Langzeit-Support) und erhält Sicherheitsupdates mindestens bis 31. August 2026TurnKey v18.x basiert auf Debian 12/Bookworm. Bookworm wird unterstützt, bis mindestens 30. Juni 2028.
Dieser Doc geht auch davon aus, dass:
- TKLBAM ist aktiviert (oder Sie aktivieren es) - beachten Sie, dass dies nicht notwendig ist, aber sehr empfohlen wird.
- Ihr Server hat genügend freien Speicherplatz für das Upgrade - 2 GB werden empfohlen, aber mehr ist immer besser.
Viele Schritte sind möglicherweise über Webmin möglich, aber Terminalbefehle sind prägnant und können kopiert / eingefügt werden, so dass sie ziemlich einfach zu befolgen sind. Alle Schritte, bei denen Sie wissen, wie Sie über Webmin die gleichen Ergebnisse erzielen, können Sie stattdessen verwenden.
Der Zugriff auf das CLI Ihres TurnKey-Servers über "SSH" (sichere Shell) wird empfohlen. Aktuelle Windows 11-Versionen, Mac OSX und alle Linux-Desktop-Aromen werden alle mit dem OpenSSH-Client vorinstalliert, aber es gibt eine Reihe alternativer SSH-Clients, die ebenfalls gut funktionieren.
Alternativ können Sie auf TurnKey v17.x die „Webshell Ihres Servers über Ihren Browser verwenden; https auf Port 12320. z.B. https://your.domain.com:12320. Auf TurnKey v18.x können Sie das Webmin „richtige interaktive Terminalmodul verwenden (v18.x enthält keine WebShell).
DO NOT verwenden Sie das TurnKey v17.x Webmin Terminal! Es ist kein echtes interaktives Terminal und wird Probleme verursachen.
Im Allgemeinen wird ein lokaler SSH-Client eine bessere Benutzererfahrung bieten (z.B.) Copy/Paste sollte zuverlässig funktionieren, aber v17.x's Webshell oder v18.x's Webmin Interactive Terminal Modul sollten gut funktionieren.
So starten Sie eine SSH-Sitzung:
ssh root@DOMAIN_OR_PUBLIC_IP
Wenn Sie Authentifizierungsschlüssel anstelle eines Passworts verwenden, müssen Sie möglicherweise den Pfad zum privaten Schlüssel in Ihrem lokalen System explizit angeben:
# Linux/OSX ssh -i ~/path/to/my_private_key root@DOMAIN_OR_PUBLIC_IP # Windows C:\Users\ME\path\to\my_private_key root@DOMAIN_OR_PUBLIC_IP
Hinweis für AWS Marketplace-Benutzer
AWS Marketplace Instanzen haben das "Root" Konto standardmäßig deaktiviert. Enable Root oder loggen Sie sich als "Admin" ein und werden dann wie folgt root:
sudo su -
Erste Schritte - Vorbereitung
Bevor Sie das OrangeHRM-Upgrade starten, stellen Sie sicher, dass Sie über ein aktuelles Backup und genügend freien Speicherplatz verfügen. Ich empfehle auch, dass Sie alle Systempakete aktualisieren und das System neu starten, bevor Sie das Upgrade starten.
Backup
Ich empfehle, sowohl ein "Snapshot" als auch ein "richtiges" Backup zu erstellen. Ein Snapshot ist technisch gesehen kein Backup, aber das Laden eines Snapshots ist eine schnelle und einfache Möglichkeit, bei Bedarf genau dorthin zurückzukehren, wo Sie sich gerade befinden.
Wenn Ihr Server über das TurnKey Hub läuft, können Sie einen Snapshot über das Hub auslösen Seite „ServerBitte beachten Sie, dass es einige Zeit dauern kann, bis die Fertigstellung abgeschlossen ist. Andere Virtualisierungs-/Cloud-Plattformen sollten diese Funktionalität ebenfalls haben - konsultieren Sie die entsprechenden Dokumente, wenn Sie nicht sicher sind, wie. Bare Metal Server können ein Tool wie Clonezilla.
Wenn Sie TKLBAM verwenden, lösen Sie manuell ein vollständiges TKLBAM-Backup Ihres Servers aus.
tklbam-backup --full-backup now
Überprüfen Sie den freien Platz und bereinigen Sie, falls erforderlich
Um den freien Platz zu überprüfen:
df -h /
Beispielausgabe (Hub-Server mit 10GB Root-Volume):
Filesystem Size Used Avail Use% Mounted on /dev/xvda 10.0G 2.1G 8.0G 21% /
Schauen Sie sich die Spalte „Verfügbar an (8.0G im obigen Beispiel). ich empfehle mindestens 1GB minimalen freien Speicherplatz, vorzugsweise mindestens 2GB. Wenn Sie nicht genug haben, führen Sie zuerst eine Bereinigung wie unten durch.
apt clean apt autoremove
Der Befehl 'autoremove' sollte nur einige Pakete auflisten, wahrscheinlich auch alte Kernel (Pakete, die mit 'linux-Bild' beginnen). Wenn es eine große Anzahl von Paketen oder Listen alle Kernpakete bitte sicher sein, ihre Funktion zu überprüfen und wenn irgendwelche Bedenken Sie manuell entfernen können, die angezeigt werden sicher zu entfernen mit „apt remove PKG1 PKG2 .... Wenn Sie Bedenken haben und genügend freien Speicherplatz haben, überspringen Sie diesen Schritt einfach für jetzt.
Upgrade OS Software (optional)
So aktualisieren Sie die Systemsoftware auf die neuesten verpackten Versionen:
apt update apt upgrade
Wenn Sie diesen Schritt ausführen, empfehle ich auch, die oben genannten apt-Bereinigungsbefehle erneut auszuführen, Ihren Server neu zu starten und den freien Speicherplatz zu überprüfen.
Manuelles lokales Backup (optional)
Mit einem Snapshot und einem TKLBAM Backup, machen andere Backup mag wie Overkill erscheinen, aber ich würde argumentieren, dass mehrere Redundanzebenen immer wünschenswert sind. Wenn dann etwas schief geht, haben Sie mehrere Wiederherstellungsoptionen und Wege, um die Funktionalität wiederherzustellen. Unabhängig davon ist dieser Schritt rein optional und ein Snapshot und ein vollständiges TKLBAM-Backup bieten ausreichende Wiederherstellungsoptionen.
Manuelle DB-Dump
mysqldump orangehrm > orangehrm_db.sql.orig
Upgrade OrangeHRM v4.x auf v4.10.1
Die neueste OrangeHRM-Version zum Zeitpunkt des Schreibens ist v5.7. Sie müssen jedoch v4.10.1 (die neueste Version von v4.x) ausführen, um auf v5.x zu aktualisieren. Wenn Sie bereits v4.10.1 oder höher ausführen, überspringen Sie bitte diesen Schritt.
OrangeHRM bieten Aktualisierung der Dokumentation Aber ich werde hier Schritt für Schritt eine detailliertere und TurnKey-spezifischere Beschreibung geben.
Download v4.10.1
wget https://sourceforge.net/projects/orangehrm/files/stable/4.10.1/orangehrm-4.10.1.zip
Bestehende Installation verschieben
mv /var/www/orangehrm /var/www/orangehrm.orig
Neue Version auspacken
unzip orangehrm-4.10.1.zip mv orangehrm-4.10.1 /var/www/orangehrm
Geben Sie Webserver-Schreibzugriff auf die erforderlichen OrangeHRM-Dateien:
chown -R www-data:www-data /var/www/orangehrm/lib/{confs,logs}
chown -R www-data:www-data /var/www/orangehrm/symfony/{config,apps/orangehrm,cache,log}
Holen Sie sich das vorhandene DB-Orangehrm-Benutzerpasswort (aus der alten Konfigurationsdatei):
grep -m 1 password /var/www/orangehrm.orig/symfony/config/databases.yml
Installieren und aktivieren Sie die php zip-Erweiterung:
apt install --yes php-zip systemctl restart apache2
Laden Sie die Upgrade-Seite in Ihrem Webbrowser
Öffnen Sie in Ihrem Webbrowser und durchsuchen Sie die "Upgrade"-Seite Ihrer OrangeHRM-Website-Domain:
https://DOMAIN_OR_PUBLIC_IP/upgrader/web
Z. B.:
https://orangehrm.domain.com/upgrader/web
Wenn Sie keine "saubere" Installation durchführen möchten, laden Sie einfach Ihre Domain ohne "/upgrader/web" URL. Andernfalls werden Ihre vorhandenen Daten überschrieben.
Geben Sie die DB-Details ein
Host*: 127.0.0.1 Port: 3306 Username* orangehrm Password <password from the above 'grep' command> Database Name: orangehrm
Klicken Sie dann auf den Button „Proceed.
Systemprüfung
Alles sollte in Ordnung sein, aber überprüfen Sie, ob jede Zeile ein grünes "OK" auf der Systemcheckseite hat.
Angenommen, alles ist gut, klicken Sie auf den Button "Proceed".
Wählen Sie die aktuelle OrangeHRM-Version
Wählen Sie aus der Dropdown-Version die aktuelle/alte OrangeHRM-Version. Sofern Sie nicht bereits ein Upgrade durchgeführt haben, sollte TurnKey v17.1 die OrangeHRM-Version „4.9 haben. Unabhängig davon können Sie die aktuelle / alte Version mit diesem Befehl bestätigen:
grep -m 1 'OrangeHRM ver' /var/www/orangehrm.orig/CHANGELOG.TXT
Standardmäßig sollte es zurückkehren:
New & Changed Features for OrangeHRM ver 4.9
Wählen Sie die entsprechende Version und klicken Sie auf den Button „Proceed.
Manuelle Änderungen anwenden - falls erforderlich
Auf der nächsten Seite werden alle manuellen Schritte/Änderungen angezeigt, die Sie möglicherweise durchführen müssen.
Wenn Sie die Datenverschlüsselung aktiviert haben, kopieren Sie die kryptographischen Schlüssel aus Ihrem alten OrangeHRM-Verzeichnis.
cp /var/www/orangehrm.orig/lib/confs/cryptokeys/key.ohrm /var/www/orangehrm/lib/confs/cryptokeys/
Sobald Sie zusätzliche manuelle Schritte ausgeführt haben, klicken Sie auf die Schaltfläche "Proceed".
Aktualisierungsdatenbank
Die nächste Seite wird tatsächlich das Datenbank-Upgrade durchführen. Wie bereits erwähnt, kann das Upgrade eine Weile dauern und es ist wichtig, dass Sie diese Seite nicht schließen oder neu laden, bis der Fortschritt 100% erreicht und der Button "Start" wechselt zu Einen „Proceed-Button.
Klicken Sie auf die Schaltfläche "Start" und wenn sie fertig ist, klicken Sie auf die Schaltfläche "Proceed".
Erstellen Sie neue Config-Dateien
Auf der nächsten Seite werden die neuen Konfigurationsdateien generiert. Dieser Schritt sollte nicht lange dauern, aber gemäß der vorherigen Datenbank-Upgrade-Seite, DO NOT schließen oder laden Sie diese Seite neu.
Klicken Sie auf die Schaltfläche "Start" und wenn sie fertig ist, klicken Sie auf die Schaltfläche "Proceed".
Finalisieren des Upgrades
Sie sollten mit einer Seite mit dem Titel "Glückwunsch!" begrüßt werden, wobei darauf hingewiesen wird, dass Sie jetzt OrangeHRM v4.10.1 ausführen.
Wie auf dieser Seite erwähnt, stellen Sie sicher, dass alle manuellen Schritte abgeschlossen sind (sollte innerhalb des vorherigen Schritts "Manuelle Änderungen anwenden" behandelt worden sein, aber Sie können sie aus dem Vermerkte Datei in Ihrem OrangeHRM-Verzeichnis:
cat /var/www/orangehrm/upgrader/log/notes.log
Klicken Sie auf den Button „Proceed.
Validieren Sie Ihre aktualisierten OrangeHRM-Daten
Nach dem vorherigen Schritt werden Sie zurück zur Anmeldeseite weitergeleitet.
Wie auf der letzten Seite „Glückwunsch! angemerkt wurde: > [...] führen Sie eine vollständige Überprüfungsrunde durch, um zu sehen, ob Daten aus der vorherigen > Version ordnungsgemäß importiert wurden.
Überprüfen Sie insbesondere, ob diese Seiten verfügbar sind und Ihre Daten enthalten: - Admin - PIM - Leave
Upgrade OrangeHRM v4.10.1 auf v5.7
Einige der Schritte zum Upgrade auf v5.7 sind dem vorherigen Upgrade sehr ähnlich. OrangeHRM v5.x enthält jedoch einen CLI-Installer / Upgrader, den diese Anweisungen abdecken.
Gemäß dem Upgrade von v4.10.1 bietet OrangeHRM Aktualisierung der Dokumentation Diese Anweisungen werden TurnKey-spezifische Notizen mit dem CLI-Tool bereitstellen.
Zubereitung
Überprüfen Sie den freien Speicherplatz und erstellen Sie ein neues OS-Backup und einen neuen Snapshot gemäß dem ersten OrangeHRM v4-Upgrade.
Erstellen Sie auch ein manuelles lokales Datenbank-Backup:
mysqldump orangehrm > orangehrm_v4.10.1_db.sql
Download v5.7
wget https://sourceforge.net/projects/orangehrm/files/stable/5.7/orangehrm-5.7.zip
Bestehende Installation verschieben
mv /var/www/orangehrm /var/www/orangehrm-4.10.1
Neue Version auspacken
unzip -o orangehrm-5.7.zip mv orangehrm-5.7 /var/www/orangehrm
Upgrade über CLI installieren
Das CLI-Upgrade ist viel schneller und einfacher IMO.
Stellen Sie sicher, dass Sie Ihr vorhandenes Datenbankpasswort haben:
grep -m 1 password /var/www/orangehrm.*/symfony/config/databases.yml
Dann wechseln Sie zum neuen OrangeHRM-Verzeichnis (das Sie oben heruntergeladen und ausgepackt haben) und führen Sie das CLI-Tool aus.
cd /var/www/orangehrm
php installer/console upgrade:run \
--dbHost=127.0.0.1 \
--dbPort=3306 \
--dbName=orangehrm \
--dbUser=orangehrm \
--dbUserPassword=<db password> \
--currentVersion=4.10.1
Verifizieren der Umgebung
Der obige Befehl gibt ein gutes Stück Text aus, von dem vieles sicher ignoriert werden kann, aber bitte überprüfen Sie den Abschnitt „Systemprüfung. Alle Werte sollten grün (oder gelb, wenn nicht verwendet) sein.
Wenn eine der Systemprüfungen rot ist, müssen Sie mit "n" antworten und sie zuerst lösen, bevor Sie den oben genannten Upgrade-Befehl erneut ausführen.
Angenommen, alle Systemprüfungen sind in Ordnung, drücken Sie Enter ("Ja" ist der Standard).
Das Upgrade kann eine Weile dauern, aber schließlich wird es ohne Fehlermeldung abgeschlossen und beendet.
Validieren Sie Ihre aktualisierten OrangeHRM-Daten
Sobald das Upgrade-Skript abgeschlossen ist, melden Sie sich über Ihren Webbrowser bei Ihrer OrangeHRM-Instanz an und bestätigen Sie, dass alle Ihre Daten vorhanden sind und alles so funktioniert, wie es sollte.
Angenommen, herzlichen Glückwunsch - Sie haben jetzt die neueste OrangeHRM! :