Kernmodul Regelbetrieb

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.

Modulverwaltung

Modulkürzel

Hier eine aktuelle Übersicht über die Modulkürzel einer "normalen" BI Installation:

 kuerzel |                         name                          
---------+-------------------------------------------------------
 astat   | Amtliche Statistik                                
 bau     | Gebäude, Räume, Flächen                           
 cob     | Kostenrechnung                                    
 erfolg  | Studienverlauf                                    
 fin     | Finanzrechnung                                    
 gang    | Studiengänge                                      
 ivs     | Inventar                                          
 kenn    | Kennzahlen                                        
 kern    | Administration                                    
 lm      | Leistungsmonitoring                               
 man     | Management                                        
 prom    | Promovierende                                     
 res     | Forschung                                         
 sos     | Studierende, Prüfungen                            
 sva     | Personal, Stellen                                 
 zul     | Bewerbung, Zulassung

(mit folgendem SQL können Sie das für Ihre lokale Installation abfragen:)

select V.his_system as kuerzel,S.name
 from db_version V, systeminfo S
where S.tid=V.systeminfo_id
order by 1;