Iptor multiflex ServerComponents – Installation und Update

Installation, Update und Deinstallation der Iptor multiflex ServerComponents (Web-Services, LCService, ServerConfigurator) auf dem Webserver. Die Voraussetzungen stehen auf der Seite „Voraussetzungen“.

📷 [BILD 01: Iptor-Logo / Titelbild – optional]

1. Setup starten

1. PLX.TaskCenterBS_<Version>.exe mit Rechtsklick → Als Administrator ausführen starten.

2. Auf Install klicken.

📷 [BILD 02: Setup-Programm – Startseite mit Button „Install“]

2. Installationsassistent

2.1 Willkommen

Mit Next fortfahren.

📷 [BILD 03: Willkommensdialog]

2.2 Lizenzbedingungen

Die Allgemeinen Geschäftsbedingungen der Iptor Austria GmbH lesen, „I accept the terms in the License Agreement“ anhaken und mit Next fortfahren.

📷 [BILD 04: Lizenzdialog]

2.3 Einstellungen für den Webserver (IIS)

Das Setup schlägt Website und Anwendungspool automatisch vor:

Einträge mit dem Zusatz „(new)“ werden vom Setup neu angelegt.

Im Normalfall den Vorschlag übernehmen und mit Next fortfahren.

📷 [BILD 05: Einstellungen – Website und Anwendungspool (Vorschlag)]

Erweiterte Einstellungen („Advanced“)

Nur wenn eine andere Website, ein anderer Anwendungspool oder ein anderer Port verwendet werden soll, „Advanced“ anhaken. Dann sind die Listen auswählbar.

• Port der neuen Website: Das Feld erscheint nur, wenn eine neue Website („… (new)“) gewählt ist. Standard ist 6460. Ist der Port schon von einer anderen Website belegt, erscheint eine Meldung – dann einen freien Port eintragen (z. B. 6461).

• Regel: Ein neuer Anwendungspool („… (new)“) ist nur zusammen mit einer neuen Website erlaubt. Bei einer bestehenden Website deren Anwendungspool verwenden.

• Nicht die Website „Default Web Site“ (Ordner C:\inetpub\wwwroot) verwenden.

📷 [BILD 06: Einstellungen – „Advanced“ mit neuer Website und Port-Feld]

2.4 Option „Install legacy web services“

Die Checkbox „Install legacy web services (old ASMX URLs, e.g. /LCWebServices/LC.WebMainService)“ installiert die alten Web-Service-URLs (z. B. /LCWebServices/LC.WebMainService/MainService.asmx). Sie leiten intern auf den aktuellen LCService weiter.

• Neuinstallation: Option ist aus. Nur aktivieren, wenn externe Systeme (Webshop, EDI-Partner, eigene Schnittstellen) noch die alten URLs aufrufen.

• Update: Die bisherige Wahl ist vorausgewählt. Bei einem Update einer älteren Version (vor 5.103) ist die Option an, weil diese Versionen die alten URLs immer installiert haben.

• Wird die Option bei einem Update abgewählt, entfernt das Setup die alten Web-Services aus dem IIS.

• Fehlt das IIS-Modul URL Rewrite, erscheint bei aktivierter Option ein Hinweis unter der Checkbox. Die Installation läuft trotzdem, die alten URLs funktionieren aber erst nach der Installation von URL Rewrite.

📷 [BILD 07: Option „Install legacy web services“ mit Hinweis zu URL Rewrite]

Mit Next fortfahren.

2.5 Installation starten

Mit Install die Installation starten. Mit Back lassen sich die Einstellungen noch ändern.

📷 [BILD 08: Bereit zur Installation]

📷 [BILD 09: Installationsfortschritt]

2.6 Abschluss

Mit Finish den Assistenten beenden. Danach startet automatisch der ServerConfigurator – weiter auf der Seite „ServerConfigurator und Datenbanken“.

📷 [BILD 10: Abschlussdialog]

3. Update

Ein Update wird genauso gestartet wie eine Neuinstallation (Kapitel 1). Dabei gilt:

• Website, Anwendungspool und die Option „Legacy web services“ werden aus der bisherigen Installation übernommen.

• Eine beim Kunden eingestellte Identität des Anwendungspools (z. B. ein Domänenbenutzer für DMS-Freigaben) bleibt erhalten.

• Ein Downgrade (Installation einer älteren Version über eine neuere) ist nicht möglich, das Setup bricht mit einer Meldung ab.

• Nach dem Setup den ServerConfigurator durchlaufen, inkl. Datenbank-Update und Publish now!

⚠️ Wichtig – Dateien des Setups werden bei jedem Update ersetzt

Alle Dateien, die das Setup installiert (z. B. LCWebServices\LCService\Web.config), werden bei jedem Update im Auslieferungszustand neu geschrieben. Manuelle Änderungen an diesen Dateien gehen verloren.

Erhalten bleiben:

• Firmen-Einstellungen unter LC.NET\Company\ (z. B. ApplicationSettings.config, WebServiceUrlSettings.config, Logs)

• LCWebServices\LCService\NLog.config (Logging, Kopie einer Vorlage aus _LoggingTemplates)

Kundenspezifische Einstellungen daher nur über den ServerConfigurator bzw. die Dateien unter LC.NET\Company\ vornehmen.

4. Automatisierte Installation (ohne Benutzeroberfläche)

Für automatisierte Installationen kann das Installationspaket per msiexec mit Parametern installiert werden:

msiexec /i PLX.TaskCenterSetup_<Version>_x64.msi /qn /l*v install.log WEBSITE=Iptor APPPOOL=Iptor

• /qn = ohne Oberfläche, /passive = nur Fortschrittsanzeige

• /l*v <Datei> schreibt ein ausführliches Protokoll (bei Problemen immer mitschicken)

• Parameter auf der Kommandozeile haben Vorrang vor den gemerkten Werten der bisherigen Installation

• Mit MX_STARTSERVERCONFIGURATOR=0 muss der ServerConfigurator danach von Hand gestartet werden (Datenbank-Update, Publish)

5. Deinstallation

1. Einstellungen → Apps (bzw. Systemsteuerung → Programme und Features) öffnen.

2. Iptor multiflex ServerComponents auswählen → Deinstallieren.

📷 [BILD 14: „Apps & Features“ mit Eintrag „Iptor multiflex ServerComponents“]

Entfernt werden die installierten Dateien und die Anwendungen im IIS. Nicht entfernt werden die Website, der Anwendungspool und die Firmen-Einstellungen unter LC.NET\Company\. Eine spätere Neuinstallation findet diese Einstellungen wieder und schlägt die passende Website vor.