BI Maintenance
Um auch in der BI Umgebung weiterhin über die Shell als Cronjob die Updates laufen zu lassen, haben wir Scripte erstellt, die über Java-Befehle dies ermöglichen und auch per Mail über den Verlauf informieren.
Der Aufbau der Scripte ist denkbar simpel und angelehnt an das bisherige Vorgehen unter SuperX und daher altbekannt.
Umgebungsvariablen in der BI_ENV
Den zentralen Kern bildet die BI_ENV
, in der ein paar Pfade, Variablen zu verwendeten Modulen und dem Mailversand eingerichtet werden müssen.
- BI_UPDATE_MODULES: In der Variable werden die Module mit Leerzeichen getrennt angegeben. Alle Module in der Liste werden bei dem Update berücksichtigt.
- BI_UPGRADE_MODULES: In der Variable werden die Module mit Leerzeichen getrennt angegeben. Alle Module in der Liste werden bei dem Upgrade berücksichtigt.
- MAILPROG: Hier wird das verwendete Mailprogramm angegeben. Bei s-nail z.B. können auch weitere Parameter wie account angegeben werden.
- MAIL_APPEND: Da das von uns empfohlene s-nail und das etwas ältere (aber dennoch beliebte) mail Programm unterschiedliche Parameter verwenden, kann hier dieser angegeben werden. Für s-nail wäre das "-a" und für mail "-A".
- LOGMAIL: In der Variable Logmail werden die einzelnen Mailadressen mit Leerzeichen getrennt angegeben. An alle Mailadressen wird der Status des Updates nach Abschluss verschickt. Es kann natürlich auch nur eine Mail Adresse angegeben werden.
- MAIL_BETREFF: Hier kann der Betreff der Mail angepasst werden, um z.B. die Mail über einen Filter im eigenen Postfach später automatisch verschieben zu lassen.
- MAIL_BETREFF_SUFFIX_ERFOLGREICH: Dieser Text wird dem Betreff angehängt, wenn der Update erfolgreich abgeschlossen wurde.
- MAIL_BETREFF_SUFFIX_FEHLER: Dieser Text wird dem Betreff angehängt, wenn der Update mit einem Fehler abgeschlossen wurde.
- JAVA_HOME: Falls nicht schon per default oder über eine SQL_ENV geschehen, sollte hier noch der Pfad zu einer JAVA Version angegeben werden. Diese sollte ab HISinOne-BI 2023.12 JAVA Version 17 sein.
Scripte für Modul Updates
Mit dem Laden der BI_ENV
kann dann schon der erste Lauf mit Ausführen der modules_update.sh
getestet werden. Wenn dieser erfolgreich war, steht dem cronjob nichts mehr im Wege. Dafür einfach aus der modules_update_cron.sh.sam
den Beispiel-Eintrag anpassen und in die crontab eintragen und die Datei umbenennen (ohne die Endung .sam "modules_update_cron.sh.sam
" -> "modules_update_cron.sh
"). Die Datei modules_update_cron.sh
sollte dann von dem Cronjob gestartet werden. Inhaltlich wird in der modules_update_cron.sh
nur die BI_ENV
geladen und dann das zuvor getestete Script modules_update.sh
gestartet.
Scripte für Modul Upgrades
Um ein Upgrade der BI Module zu starten, wird nun einfach die BI_ENV
geladen und dann mit dem Script modules_upgrade.sh
durchgeführt. Per Mail erhält man dann eine Info, wenn der Vorgang abgeschlossen ist.