Introduction


The client deployment in the network

To run the iPlus client, you do not need to perform any installation on a Windows computer that is on the network. It is enough that you deploy a network drive where the current program version is available. . 
 
.NET programs typically cannot be started directly from a network drive due to code access security (CAS, https://docs.microsoft.com/en-us/dotnet/framework/misc/code-access-security). 
 
There are two different ways to solve this problem:
 
  1. Change the security policy for the gip.iplus.client.exe / gip.mes.client.exe with the Code Access Security Policy Tool https://msdn.microsoft.com/de-de/library/cb6t8dtz(v=vs.110).aspx 
  2. You can copy files from the network drive to the local drive of the Windows machine and start the application from there. Disadvantage of this is that you need to manually update the local drive with each update. However, you can automate this with another application called gip.iplus.startup.exe:

Automatic update the local folder using gip.iplus.startup.exe

The latest version of iPlus should always be on the visualisation server. To ensure that the clients are running the same version, iPlus distributes the iPlus files present on the visualization server to the clients. Take the following precautions for the automatic distribution on each client computer which should receive automatic iPlus updates.

First create the following three folders.

  1. Assemblies: Local files for iPlus.
  2. Startup: Local folder for the startup program.
  3. StartupLink: Link directory for the Startup program.

After creating the folders, follow the steps below.

  1. Copy the gip.iplus.startup.exe into the Startup folder.
  2. Create a shortcut for gip.iplus.startup.exe and copy the shortcut to the StartupLink folder.

Open the properties of the gip.iplus.startup.exe shortcut via the context menu of the shortcut with the right mouse button / Properties.

Enter the parameters for the copy operation in the Target input field:

e.g. F:\Client\Startup\gip.iplus.startup.exe \\Server\iPlusShare F:\Client\Assemblies

  • The first parameter is present by default and specifies the path to the linked file (you don't usually need to change it).
  • The second parameter is the path to the directory where the current iPlus files are located.
  • The third parameter is the target directory on the client computer.

In the Run in input field, enter the path to the configuration file iplus.config.

Now start iPlus by linking the gip.iplus.startup.exe. At the first startup, all iPlus files will be copied to the target folder. This process may take some time, but depending on the speed of your network it usually takes less than a minute.

 

 

Other optional launch parameters:

  • With the fourth parameter you specify the start parameters for the iplus-Exe. You should put these in single quotes. If no start parameters are required, enter "-".
  • With the fifth parameter you specify the working directory in which the program is to be executed. Usually it is the same as the target directory (third parameter).
  • The sixth parameter is a string with four options:
    • updatestart: Standard behavior - The latest version is copied from the server directory and the program is started.
    • start: There is no copying process from the server directory and only the program is started.
    • updatemax: It is first checked whether the program has already been started. If yes, then the program window will be maximized. If the program is not started, then copy the latest version from the server directory and start the program. This option prevents iplus from being started multiple times and only one process being active at a time.
    • max: There is no copying process from the server directory and only the program is started. If the program is already started, the program window will be maximized. This option prevents iplus from being started multiple times and only one process being active at a time.
      Example:
      F:\Client\Startup\gip.iplus.startup.exe \\Server\iPlusShare F:\Client\Assemblies - F:\Client\Assemblies updatemax
  • If the seventh parameter is set to "true", then there is no comparison with the server directory in order not to delete a local superfluous dll.

Startoptionen der *client.exe

Startparameter der *client.exe:

Startparameter werden mit Leerzeichen getrennt und beginnen immer mit einem Schrägstrich "/":

  • /autologin: Es wird der aktuell angemeldete Windows-Benutzer abgefragt. Existiert in der iPlus-Datenbank ein Benutzer mit dem selben Benutzernamen so erfolgt eine automatische Anmeldung ohne Passwortabfrage.
  • /WCFOff: Der Client wird im Offlinemodus gestartet. Das bedeutet, dass keine Netzwerkverbindungen zu den konfigurierten iPlus-Anwendungen (Service) aufgebaut werden.
  • /Simulation: Sind dem zu anmeldenden Benutzer iPlus-Anwendungen zugerodnet worden die als Service gestartet werden sollen, dann werden alle entsprechenden ACComponents im Simulationsmodus instanziiert. Im Siumlationsmodus erfolgt keine Kommunikation zu den untergoerdneten Steuerungen und alle Workflowschritte laufen im Zeitraffer ab. ACHTUNG: Diese Funktionalität ist zur Zeit noch nicht freigegeben und darf im Produktivbetrieb nicht eingesetzt werden.

 

Weitere Startoptionen:

  • F1-Taste: Wird beim Anmelden gleichzeitig die F1-Taste mit der Login-Taste gedrückt dann werden sämtliche Eigenschaften von allen ACComponents die normalerweise während der Laufzeit persistiert werden sollen nicht persistiert.
  • Ctrl-Taste + Linksklick: Wird beim Anmelden gleichzeitig die Ctrl bzw. Strg-Taste mit der Login-Taste (Linke Maustaste) gedrückt, wird die Aktualisierung gestartet. Bei der Aktualisierung werden folgende Aktionen in der folgenden Reihenfolge durchgeführt:
    • Im Unterverzeichnis "DBScripts" nach neuen SQL-Skripten gesucht und entsprechen Datenbankupdates durchgeführt
    • Per Reflection alle Assemblies analysiert und mit den ACClass-Tabellen in iPlus-Datenbank synchronisiert.
    • Zuletzt im Unterverzeichnis "VBControlScripts" nach Design- und Konfigurationspdates gesucht und in die Datenbank eingespielt.
  • Ctrl-Taste + Rechtsklick: Wird beim Anmelden gleichzeitig die Ctrl bzw. Strg-Taste mit der Login-Taste (RechteMaustaste) gedrückt, dann erscheint ein zusätzliches Textfeld mit einem Anforderungscode für den Remote-Developer-Login. Dieser ist dann nötig, wenn man beim Kunden per Fernwartung programmieren will und es dort keinen USB-Dongle gibt.