Zum Hauptinhalt springen

Startverknüpfung

Um das diaLIMS von jedem Arbeitsplatz aus zu starten, müssen Sie sich auf dem Desktop eine Verknüpfung zum Installationsort auf dem Server einrichten. Im Normalfall wird dies von diaLIMS-Support im Rahmen der Installation bereits vorgenommen. Um jedoch an neu eingerichteten Arbeitsplätzen eine solche Verknüpfung zu erstellen, müssen mit dieser bestimmte Parameter übergeben werden.

Übergabeparameter​

diaLIMS kann mit unterschiedlichen Angaben gestartet werden, um bestimmte Funktionen zu erfüllen. Einige dieser Angaben sind Pflicht, um eine Verbindung zur Datenbank oder dem Programm herzustellen. Viele der Startparameter finden jedoch nur Verwendung, um Fehler nachvollziehen, administrative Aufgaben am LIMS durchführen zu können oder Fehler zu vermeiden.

  • -Ddbname

    URL für die Datenbankverbindung. Abhängig von der Umgebung (DB2, SQL-Server, Azure oder Oracle) kann der Syntax unterschiedlich sein. Azure verwendet die selbe Syntax wie SQL-Server.

    DB2: //servername_or_IP:port/dbname

    Beispiel: -Ddbname=//server4711:50000/dialims

    SQL-Server/Azure: //servername_or_IP:port;DatabaseName=dbname

    Beispiel: -Ddbname=//azure-db.database.windows.net:1433;DatabaseName=dialims

  • -Dlog

    Aktiviert das Logging der Clients im Pfad Distributionspfad/Programm/log. Für jeden Rechner und/oder Benutzer wird ein eigenes Logverzeichnis angelegt. In den Logs sind Hinweis- und Fehlermeldungen protokolliert, welche für den diaLIMS Support eine wichtige Hilfequelle sein können. Diese Option wird standardmäßig eingeschaltet, wenn das diaLIMS im ausgeliefertem Zustand gestartet wird, es sich nicht um ein MultiUserEnvironment (dialims-web, dialims-middleware) handelt und das Logging nicht explizit über den Parameter "-Dlog=0" deaktiviert wird.

  • -Ddistributionpath

    Der (abweichende) absolute diaLIMS-Distributionspfad. In diesem Verzeichnis werden folgende Ordner erwartet bzw. neu angelegt:

    • Programm/Einstellungen oder der unter Optionen->Pfade eingestellte relative Einstellungspfad bzw. der über den Parameter -Ddialimspath eingestellte absolute Pfad.

    • Vorlagen oder der unter Optionen->Pfade eingestellte relative Vorlagenpfad.

    • Berichte oder der unter Optionen->Pfade eingestellte relative Berichtepfad.

    • Programm/log

    Note:

    Wenn für ein Pfad unter Optionen->Pfade ein absoluter Pfad angegeben wird, wird der absolute Pfad angewendet, der Parameter "-Ddistributionpath" hat für diesen Pfad keine Auswirkung.

    Wenn dieser Parameter nicht angegeben wird, werden die Ordner oberhalb des Ordners "Programm" angelegt.

  • -Ddialimspath

    Der (abweichende) diaLIMS-Installationspfad. Unterhalb dieses Verzeichnisses wird der Ordner "Einstellungen"erwartet.

    Wenn dieser Parameter nicht angegeben wird, wird der Ordner unterhalb des Ordners "Programm" erwartet bzw. angelegt.

    Beispiel: -Ddistributionpath=T:/dialims/Programm

  • -Dsocketport

    Portnummer für Socketserver, der den mehrfachen Programmstart am Client verhindert und externe Links an den Client weiterleitet. Wird als Portadresse 0 angegeben, dann wird der Socketserver am Client nicht verwendet/gestartet. Wenn diese Option nicht angegeben wurde, ist der Standardsocketport 51111.

    In Terminalserver- und Citrix-Umgebungen muss immer Port 0 angegeben werden: -Dsocketport=0

  • -Ddbuser

    Datenbankbenutzer, der hier angegebene Benutzername wird bei jedem Programmstart in der Anmeldemaske vorgegeben.

  • -Ddbpassword

    Kennwort für Datenbankbenutzer, das hier angegebene Passwort wird bei jedem Programmstart in der Anmeldemaske vorgegeben. Wenn dbname, dbuser und dbpassword übergeben wurden, wird gleich eine Verbindung auf die diaLIMS-Datenbank versucht. Sind die Übergabeparameter korrekt, erscheint kein Anmeldedialog mehr. Sind die Übergabeparameter nicht korrekt, erscheint die Anmeldemaske weiterhin.

    CAUTION:

    Aus Sicherheitsgründen sollten Sie niemals alle drei Parameter übergeben. Diese Daten werden unverschlüsselt in der Startverknüpfung gespeichert. Die Anmeldung sollte immer wissentlich und durch Eingabe des persönlichen Kennworts erfolgen, da die Benutzerdaten auch ins Audittrail aufgenommen werden.

  • -Ddbrole

    Rolle/Benutzergruppe mit der sich der User anmelden will, Beispiel: -Ddbrole=Administrator

  • -Dexceptionsound

    Abspielen einer Sounddatei bei abgefangenen Exceptions {yes | no}, Standardwert: no

  • -Dshow.exceptionpanel

    Anzeigen von Fehlermeldungen im Allgemeinen Fehlerdialog {yes | no}, Standardwert: no

  • -Ddb

    Datenbanktyp, zu verwendender Datenbanktreiber {db2 | db2net | db2as400 | db2as400app | orcale | mssql | azure}, Standardwert: db2

  • -Dshow.logo (bis Version 7)

    Anzeige Startbildschirm und Desktop-Hintergründe {yes | no} Standardwert: yes

  • -Dlock.dbname

    Bestimmt ob in der Anmeldemaske vom Anwender eine Datenbank gewählt werden kann {yes | no}, Standardwert: no

  • -Dzba

    Aktivieren der Zentralen Benutzeranmeldung {true | false}, Standardwert: false

  • -Dservice

    Aktivieren des Service-Modus {yes | no}, Standardwert: no

    Funktionen bei aktivem Service-Modus:

    1. Texte von nicht externalisierten (neuen) GUI-Komponenten werden mit spitzen Klammern angezeigt
    2. Außerdem erscheint der Fotoapparat im DTablePanel. Wer darauf drückt, kann auf einmal eine ganze diaLIMS-Businessklasse externalisieren
    3. Im Anmeldedialog darf man eine neue Datenbank katalogisieren.
  • -Dexternalize

    Anzeige von Hilfen und Hinweisen für unvollständige Externalisierungen {yes | no}, Standardwert: no

  • -Dcloaked.host

    Um bestimmte Client-Installationen testen zu können, kann man einen anderen Clientnamen (=Rechnernamen) vortäuschen

  • -Dtestmodus.client (ab Version 7)

    Um bestimmte Funktionen testen zu können, kann das System in einem Testmodus gestartet werden. {yes/true | no/false}, Standardwert: no/false

    Damit können Servereinstellungen, wie das aktuelle Datum bzw. die aktuelle Zeit vorgetäuscht werden. Das System darf unter keinen Umständenin der Produktivumgebung im Testmodus gestartet werden. Die Ausführung des Testmodus sollte in jedem Fall nur in Absprache mit der Firma dialog erfolgen.

  • -DsilentReconnect

    Gibt an, ob das Verbinden mit der Datenbank nach einem Verbindungsabbruch unsichtbar erfolgen soll.

    • true

      Der Anwender erhält keine Informationen, ob ein Verbindungsabbruch vorliegt. Die Wiederanmeldung erfolgt still im Hintergrund.

    • false (Standardwert)

      diaLIMS wird abgedunkelt, wenn ein Verbindungsabbruch vorliegt und es erfolgen bis zu 15 Versuche die Verbindung erneut aufzubauen.

    In beiden Fällen kann nach der Wiederherstellung der Verbindung normal weitergearbeitet werden. Schlägt der Aufbau fehl, wird eine Fehlermeldung ausgegeben und das diaLIMS muss geschlossen werden.

  • -DlauncherLockFile="SERVICE.LOCK"

    Wenn für diaLIMS Wartungsarbeiten durchgeführt werden, z.B wenn ein System-Update über die Adminkonsole durchgeführt wird, dann wird der Start des diaLIMS verhindert. Laufende diaLIMS-Programme werden ggf. sogar automatisch beendet. Durch Angabe dieses Parameters wird der Start des diaLIMS trotz Wartungsarbeiten erzwungen. Dieser Parameter sollte nur von einem Administrator verwendet werden, um diaLIMS während der Wartungsarbeiten starten zu können!

  • -Dsysoutredirect

    Leitet die System.out und die System.err in ein eigenes Fenster um, um somit auch im Kundenumfeld Konsolenausgaben zu lesen. Mögliche Werte sind "true" oder "false"