Entire Connection installieren

#### Search Results

Search

# Entire Connection installieren

Dieser Abschnitt behandelt die folgenden Themen:

- Systemvoraussetzungen

- Entire Connection für den Administrator installieren

- Stille Installation und Deinstallation

- Programmordner

- Umgebungsvariablen

- Entire Connection aktualisieren (Upgrade)

- Entire Connection auf einer Client-Workstation installieren

- Entire Connection deinstallieren

- Versionsportabilität und Parallelität

## Systemvoraussetzungen

Entire Connection ist eine 32-Bit-Anwendung. Bei einer 64-Bit-Version von Windows läuft Entire Connection unter WOW64. WOW64 ist ein x86-Emulator, der es ermöglicht, 32-Bit-Anwendungen mit einer 64-Bit-Version von Windows auszuführen.

Die folgende Hardware und Software ist für die Installation und den Einsatz von Entire Connection erforderlich:

Hardware | Ein PC auf dem Microsoft Windows lauffähig ist und der ca. 80 MB freien Speicherplatz hat. Während der Installation sind weitere 80 MB im Temp-Verzeichnis erforderlich.
Betriebssystem | Entire Connection unterstützt die folgenden 64-Bit-Betriebssystemplattformen: Microsoft Windows 10 Microsoft Windows 11 Microsoft Windows Server 2016 Microsoft Windows Server 2019 Microsoft Windows Server 2022 Bevor Sie mit der Installation beginnen, achten Sie darauf, dass alle aktuellen Windows-Updates auf der Maschine installiert sind, auf der Sie Entire Connection installieren wollen. Die Laufzeitkomponenten von Entire Connection sind immer 32-Bit-Anwendungen, auch auf 64-Bit-Plattformen. Home-Editionen von Microsoft Windows werden nicht unterstützt.
Kommunikationsmethode | Mindestens eine der unterstützten Methoden für die Kommunikation zwischen PC und Host.
Datentransfer-Software | Wenn Sie Daten zwischen dem Host und Ihrem PC übertragen wollen, müssen die folgenden Produkte der Software AG auf dem Host installiert sein, mit dem der PC verbunden ist: Eine Version von Natural for Mainframes, Natural for Linux and Cloud oder Natural for OpenVMS, mit der die Benutzung von Entire Connection unterstützt wird. Natural for Mainframes: die Version von Natural Connection, die mit Ihrer Natural-Version kompatibel ist. Anmerkung Natural Connection wird automatisch installiert, wenn Natural for Linux and Cloud oder Natural for OpenVMS installiert wird. Wenn Sie Daten nach Excel herunterladen oder Daten im Excel-Format hochladen wollen, muss Excel 97 oder eine höhere Version auf Ihrem PC installiert sein. Die Excel-Version ist abhängig von Ihrem Betriebssystem.
Online-Dokumentation | Ein Browser zum Lesen der Dokumentation von Entire Connection im HTML-Hilfe-Format.

## Entire Connection für den Administrator installieren

Lesen Sie vor der Installation zuerst die Datei Install_gr.txt auf dem Installationssmedium von Entire Connection.

Das Setup-Programm auf dem Installationssmedium installiert Entire Connection für einen Benutzer, den Administrator. Im einfachsten Fall ist dies eine einzelne Installation auf einem lokalen PC, wobei der Benutzer auch gleich Administrator ist und alle erforderlichen Objekttypen selbst definiert.

Wenn mehrere Benutzer mit der selben Installation arbeiten sollen, kann der Administrator Entire Connection auf einem Netzwerk-File-Server oder einem freigegebenen Laufwerk installieren und das System für alle Benutzer vorbereiten, die in der Lage sein sollen, Entire Connection von verschiedenen Client-Workstations aus zu starten. Für diese Art der Installation müssen Sie den Setup-Typ Komplett wählen (oder den Setup-Typ Benutzer und die Option Client-Setup markieren). Die Option Client-Setup erstellt den Ordner netsetup im Ordner Entire Connection. Standardmäßig ist das \Program Files\Software AG\Entire Connection\netsetup. Der Ordner netsetup enthält das Client-Installationsprogramm Setup.exe. Jeder Benutzer kann dieses Programm von der eigenen Client-Workstation aus aufrufen. Es registriert Entire Connection auf der Client-Workstation und erstellt einen Ordner für Entire Connection im Windows-Startmenü. Nach dem Start sucht Setup.exe nach der Datei Readme.doc im Ordner netsetup. Wenn sie gefunden wird, wird ihr Inhalt angezeigt. Der Administrator kann diese Datei dafür verwenden, den Benutzern umgebungsspezifische Informationen (z.B. Benutzernamen, Vorgaben oder Session-Namen) für ihre Arbeit mit Entire Connection mitzuteilen. Weitere Informationen zur Installation auf einer Client-Workstation finden Sie später in diesem Abschnitt unter Entire Connection auf einer Client-Workstation installieren.

Bei der Installation stehen folgende Setup-Typen zur Verfügung:

Setup-Typ | Installiert
--- | ---
Standard (Vorgabe) | Die gängigsten Optionen. Empfohlen für die meisten Benutzer.
Komplett | Alle Optionen. Erforderlich wenn mehrere Benutzer mit der selben Installation arbeiten sollen.
Benutzer | Sie können wählen, welche Optionen Sie installieren möchten. Empfohlen für fortgeschrittene Benutzer.

Die folgende Tabelle zeigt die Optionen, die bei einem bestimmten Setup-Typ installiert werden (bzw. installiert werden können):

Option | Standard | Komplett | Benutzer
--- | --- | --- | ---
Konfigurationsmanager | X | X | X
Terminal | X | X | X
Formatkonverter | X | X | X
Host-Drucker-LU-Unterstützung |  | X | (X)
Beispielprozedurdateien | X | X | X
Beispiel-Natural-Programme | X | X | X
Client-Setup |  | X | (X)

Die Standardeinstellung beim Setup-Typ Benutzer ist dieselbe wie beim Setup-Typ Standard.

Die folgenden Optionen werden immer installiert: Konfigurationsmanager und Terminal. Beim Setup-Typ Benutzer ist es nicht möglich, diese Optionen zu deaktivieren.

Entire Connection installieren

1. Beenden Sie alle aktiven Windows-Anwendungen.

2. Legen Sie das Installationssmedium von Entire Connection in Ihr CD-/DVD-Laufwerk ein.

   Das Setup-Programm startet automatisch und führt Sie durch die Installation.

   Wenn die automatische Startoption bei Ihnen ausgeschaltet ist, müssen Sie Setup.exe selbst ausführen. Diese Datei befindet sich im obersten Verzeichnis des Installationssmediums.

3. Nach der Installation kann der Administrator die Parameter, Objekte (z.B. Sessions), Benutzergruppen und Zugriffsrechte für alle Benutzer definieren (siehe Konfigurationsmanager). Als Erstes sollte überprüft werden, ob die Einstellungen im Dialogfeld Systemvoreinstellungen für alle Benutzer gültig sind. Es ist wichtig, dass alle Benutzer auf die hier definierten Verzeichnisse für die Prozedurdateien und die Log- und Trace-Dateien zugreifen können.

4. Wenn Sie die Benutzerprofile der Version 3.1 übernehmen wollen, müssen Sie dies direkt nach der Installation tun. Weitere Informationen hierzu finden Sie im Abschnitt Konfigurationsmanager unter Bestehende Benutzerprofile übernehmen.

5. Bei einem Upgrade von Entire Connection 4.3.1 oder einer früheren Version müssen Sie einen Share-Datei-Upgrade durchführen. Ansonsten stehen Ihnen bestimmte neue Funktionen nicht zur Verfügung. Weitere Informationen hierzu finden Sie im Abschnitt Konfigurationsmanager unter Share-Datei-Upgrade.

## Stille Installation und Deinstallation

Mit InstallShield können Sie Entire Connection im stillen Modus installieren und deinstallieren. Dies beeinhaltet auch stille Update-Installationen. In diesem Modus ist kein Benutzereingriff erforderlich.

Für eine stille Installation oder Deinstallation dürfen Sie nicht setup.exe im obersten Verzeichnis des Installationssmediums benutzen. Benutzen Sie statt dessen setup.exe im Verzeichnis \Windows\PCC des Installationssmediums.

Um sicherzustellen, dass kein Benutzereingriff während des stillen Installationsmodus oder Deinstallationsmodus erforderlich ist, kann es notwendig sein, die Benutzerkontensteuerung (UAC) abzuschalten oder zu deaktivieren.

Im stillen Modus installieren oder deinstallieren

1. Legen Sie das Installationssmedium von Entire Connection in das CD-/DVD-Laufwerk des PCs ein, auf dem Sie Entire Connection im stillen Modus installieren oder deinstallieren möchten.

2. Rufen Sie die Eingabeaufforderung (DOS-Fenster) auf.

3. Wechseln Sie in das Verzeichnis \Windows\PCC des Installationssmediums.

4. Für eine Erstinstallation oder Update-Installation geben Sie den folgenden Befehl ein:

   `setup.exe /s /L1033 /w /v"/lvoicewarmup! %TEMP%\pccsilentnnnmsi.log SERIALNUMBER=seriennummer INSTALLDIR=installationsverzeichnis INSTALLLEVEL=installlevel /qn"`

   Oder:
   Für eine Deinstallation geben Sie den folgenden Befehl ein:

   `setup /s /w /x /v"/lvoicewarmup! %TEMP%\pccsilentnnnuninstmsi.log /qn"`

   Die Optionen haben die folgende Bedeutung:

   `/s` | Stiller Modus (kein Benutzereingriff).
   `/L1031` | Optional. Language (Sprache). "L1031" installiert eine deutsche Version von Entire Connection. "L1033" installiert eine englische Version.
   `/w` | Optional. Wird in Verbindung mit einem vorhergehenden `start /WAIT`-Befehl benutzt. setup.exe wird hiermit veranlasst so lange zu warten, bis die Erstinstallation, Update-Installation oder Deinstallation fertig ist.
   `/x` | Deinstallationsmodus. Deinstalliert ein vorher installiertes Produkt.
   `/v` | Parameterliste für den Windows-Installer. Siehe unten.
   `/lvoicewarmup! %TEMP%\name.log` | Logdatei für die Installation oder Deinstallation. Es wird nicht empfohlen, diesen Parameter zu entfernen. Es wird empfohlen, dass Sie beim stillen Modus die folgenden Namen verwenden: Installation: pccsilentnnnmsi.log Deinstallation: pccsilentnnnuninstmsi.log wobei nnn im Namen der Logdatei für die aktuelle Versionsnummer von Entire Connection steht.
   `SERIALNUMBER=seriennummer` | Erforderlich für die Installation. Die Seriennummer von Entire Connection. Wichtig Bei einer Update-Installation müssen Sie die Seriennummer der neuen Version angeben.
   `INSTALLDIR=installationsverzeichnis` | Das Installationsverzeichnis (die Vorgabe ist \Program Files\Software AG\Entire Connection). Wichtig Bei einer Update-Installation müssen Sie dasselbe Installationsverzeichnis angeben wie für die ursprüngliche Installation.
   `INSTALLLEVEL=installlevel` | Optional. Mögliche Werte: 1 oder 100 (die Vorgabe ist 1). Der Wert 1 steht für den Setup-Typ Standard; der Wert 100 steht für den Setup-Typ Komplett (siehe oben).
   `/qn` | Erforderlich. Stiller Modus für den Windows-Installer.

### Beispiele

#### Erstinstallation

Geben Sie den folgenden Befehl ein um eine Erstinstallation mit dem Setup-Typ Komplett zu starten, wobei setup.exe wartet bis die Erstinstallation beendet wurde:

`start /WAIT setup.exe /s /L1033 /w /v"/lvoicewarmup! %TEMP%\pccsilent9130msi.log SERIALNUMBER=PCC9139999999999 INSTALLDIR=\"C:\Software AG\Entire Connection\" INSTALLLEVEL=100 /qn"`

#### Update-Installation

Geben Sie den folgenden Befehl ein um eine Update-Installation mit dem Setup-Typ Standard zu starten, wobei setup.exe nicht wartet bis die Update-Installation beendet wurde:

`setup.exe /s /L1033 /w /v"/lvoicewarmup! %TEMP%\pccsilent9130msi.log SERIALNUMBER=PCC9139999999999 INSTALLDIR=\"C:\Software AG\Entire Connection\" /qn"`

#### Deinstallation

Geben Sie den folgenden Befehl ein um eine Deinstallation zu starten, wobei setup.exe wartet bis die Deinstallation beendet wurde:

`start /WAIT setup /s /w /x /v"/lvoicewarmup! %TEMP%\pccsilent9130uninstmsi.log /qn"`

### Installations-Log-Dateien

Standardmäßig benutzt Entire Connection die folgenden Log-Dateien für zusätzliche Information, insbesondere bei Fehlern:

- Die Installations- und Deinstallations-Log-Dateien in `%TEMP%`, mit den oben angegebenen Namen.

- Die Windows-Ereignisanzeige.

## Programmordner

Standardmäßig wird Entire Connection im folgenden Programmordner installiert:

\Program Files\Software AG\Entire Connection

Anmerkungen:

1. Der Datei-Explorer von Windows zeigt immer einen sprachabhängigen symbolischen Namen für den Programmordner an. Bei einem deutschen Windows-Betriebssystem wird zum Beispiel der Name "Programme" statt "Program Files" im Datei-Explorer angezeigt.
2. Bei einem 64-Bit-Windows-Betriebssystem wird Entire Connection standardmäßig im folgenden Programmordner installiert: "Program Files (x86)". Im Datei-Explorer wird dann der symbolische Name "Programme (x86)" angezeigt.

Programmordner | Inhalt
--- | ---
\Entire Connection | *.exe *.dll API-ActiveX-Control PccAPI.ocx.
\Entire Connection\doc | Readme_gr.txt Deutsche und englische Online-Dokumentation, und die Hilfedateien Pccnnnxx.chm (wobei nnn die aktuelle Versionsnummer ist und xx der Sprachcode "GR" für Deutsch (German) oder "US" für US-Englisch).
\Entire Connection\netsetup | Client-Installationsprogramm Setup.exe. Steht nur zur Verfügung, wenn bei der Installation die Option Client-Setup angegeben wurde (Setup-Typ Benutzer).

Standardmäßig werden die Ordner für die Benutzerdaten hier installiert:

\ProgramData\Software AG\Entire Connection

Der Ordner ProgramData ist ein versteckter Ordner. Er ist nur dann im Explorer zu sehen, wenn die entsprechende Option in den Orderoptionen des Explorers aktiviert ist.

Wenn Sie nicht in den Standardprogrammordner (d.h. nicht in den Windows-Ordner Program Files) installieren, dann werden die Ordner für die Benutzerdaten in den von Ihnen angegebenen Ordner installiert.

Dies sind die Ordner für die Benutzerdaten:

Ordner | Inhalt
--- | ---
certs | Dateien für die SSL/TLS-Unterstützung von TN3270.
data | Share411.sag.
home | Leer nach der Installation. *.log Trace-Dateien (z.B. Monnn.trc). Temporäre Dateien für die Host-Drucker-LU-Unterstützung.
proc | Systemprozedurdateien. Wenn dies bei der Installation angegeben wurde, enthält dieser Ordner auch Beispielprozedurdateien und Natural-Beispielprogramme.
tables | Übersetzungs-, Tastatur- und physische Funktionscodetabellen.

Bei einer Installation für mehrere Benutzer unter Terminal Services müssen Sie Folgendes beachten: wenn Sie den Benutzern das Ändern ihrer eigenen Profile in der Share-Datei erlauben wollen, dann müssen Sie die Sicherheitseigenschaften für die Datei Share411.sag ändern und den Benutzern Schreibrechte erteilen.

## Umgebungsvariablen

Entire Connection ändert keine Umgebungsvariablen.

## Entire Connection aktualisieren (Upgrade)

Es kann nur eine Version von Entire Connection auf einem PC installiert werden (Installation für den Administrator). Wenn Sie Entire Connection aktualisieren, wird die bisherige Version zuerst entfernt und die neue Version anschließend installiert. Alle Benutzerdaten der vorherigen Version, insbesondere die Share-Datei, werden gesichert und wiederhergestellt.

Vorsicht
Wenn sich durch die Aktualisierung Ihrer Installation der Ort für Ihre Benutzerdaten geändert hat, sind die in der Share-Datei gespeicherten Verzeichnisnamen möglicherweise nicht mehr gültig. In diesem Fall müssen Sie diese Verzeichnisnamen im Anschluss an die Aktualisierung anpassen, damit Entire Connection Version 8.4.1 oder höher Ihre Prozedurdateien, Log-Dateien und Trace-Dateien finden kann. Die Verzeichnisnamen für diese Dateien sind in den Systemvoreinstellungen und in den Benutzereigenschaften gespeichert.

## Entire Connection auf einer Client-Workstation installieren

Wenn mehrere Benutzer mit der selben Installation arbeiten sollen, muss der Administrator Entire Connection zuerst auf einem Netzwerk-File-Server oder einem freigegebenen Laufwerk installieren und vorbereiten (siehe Entire Connection für den Administrator installieren). Danach kann jeder Benutzer das Programm Setup.exe im Ordner netsetup von der eigenen Client-Workstation aus aufrufen. Es registriert Entire Connection auf der Client-Workstation und erstellt einen Ordner für Entire Connection im Windows-Startmenü.

Wichtig
Jeder Benutzer, der Entire Connection wie oben beschrieben auf einer Client-Workstation installieren möchte, benötigt Administratorrechte.

### Entire Connection auf einer Client-Workstation aktualisieren (Upgrade)

Für eine Client-Workstation gibt es keine Upgrade-Installation.

Der Administrator muss zuerst die existierende Installation von Entire Connection auf dem Netzwerk-File-Server oder freigegebenen Laufwerk aktualisieren (siehe Entire Connection aktualisieren (Upgrade)). Anschließend müssen Sie auf dem PC, auf dem sich eine existierende Client-Installation befindet, folgendermaßen vorgehen:

1. Deinstallieren Sie Entire Connection auf allen Client-Workstations (siehe unten).

2. Installieren Sie Entire Connection auf allen Client-Workstations (siehe oben).

### Entire Connection auf einer Client-Workstation deinstallieren

Siehe Entire Connection deinstallieren.

## Entire Connection deinstallieren

Entire Connection wird in der Windows-Systemsteuerung mit der Windows-Standardfunktionalität deinstalliert. Sie können Entire Connection aber auch im stillen Modus deinstallieren.

Beim Deinstallieren werden die Benutzerdaten in den Installationsordnern von Entire Connection nicht gelöscht. Dies gilt auch für die Share-Datei im Ordner data.

## Versionsportabilität und Parallelität

Vorsicht
Es wird allgemein empfohlen, Entire Connection mit dem Installationsprogramm zu installieren. In bestimmten Fällen, wie zum Beispiel bei Migrations- oder Rehosting-Projekten, kann es sinnvoll sein, eine portable Version laufen zu lassen, um verschiedene Versionen parallel auszuführen. Es wird jedoch empfohlen, eine portable Version nur zu Testzwecken zu verwenden.

Da Entire Connection keine Einträge in der Registrierung benötigt, kann es durch Kopieren und Einfügen auf andere Rechner übertragen werden.

Solch eine kopierte Version kann als portable Version fungieren. Als Folge davon können viele verschiedene Versionen parallel existieren, und es ist möglich, eine installierte Version und eine portable Version auf demselben Windows-Computer laufen zu lassen.

Wichtig
Die Nachteile der Verwendung von Entire Connection als portable Version sind:

- Microsoft Visual Studio Redistributable muss auf dem Zielsystem installiert sein. Normalerweise wird dies vom Installationsprogramm erledigt.

- Kann nicht einfach über “Apps & Features” oder andere Windows-typische Wege entfernt werden.

- Die Konfiguration muss von Ihnen selbst verwaltet werden, da sie vom Installationsprogramm nicht automatisch unter C:\Program Files\Software AG\Entire Connection gespeichert wird.

- Kann versehentlich leicht entfernt werden, da der Ordner nicht (wie zum Beispiel C:\Programme (x86)) geschützt ist.

- Das API kann nicht verwendet werden, ohne die Registrierung zu ändern. Dies erfordert einen Programmstart mit Administratorrechten.

#### Voraussetzungen

- Ein Windows-Computer (sollte keine Produktionsumgebung sein), auf dem Sie die neueste Version von Entire Connection installieren können.

- Ein Windows-Zielcomputer, auf dem die parallele Version laufen soll. Hier muss Microsoft Visual Studio Redistributable installiert werden.

Die folgenden Schritte zeigen, wie Sie eine portable Version von Entire Connection einrichten und ausführen:

1. Verwenden Sie einen Computer, auf dem Sie die neueste Version von Entire Connection installieren können. Installieren Sie Entire Connection mit den erforderlichen Einstellungen.

2. Öffnen Sie das Installationsverzeichnis. Standardmäßig ist dies C:\Program Files (x86)\Software AG\.

3. Kopieren Sie das Installationsverzeichnis an einen nicht schreibgeschützten Speicherort, zum Beispiel nach C: oder auf den Desktop.

4. Erstellen Sie eine ZIP-Datei mit dem gesamten Inhalt des neu erstellten Entire Connection-Verzeichnisses.

5. Kopieren Sie die neue ZIP-Datei auf den Computer, auf dem Sie die portable Version von Entire Connection ausführen möchten.

6. Entpacken Sie die Dateien an einen geeigneten Speicherort auf dem Zielcomputer.

7. Hier können die ausführbaren Dateien (zum Beispiel PccTerminal.exe oder PCCAdmin.exe) direkt aus diesem Verzeichnis gestartet werden.

8. Um zu überprüfen, ob die beabsichtigte Version wirklich ausgeführt wird, wählen Sie aus dem Menü Hilfe den Befehl Info über Entire Connection Terminal.

9. Entire Connection benutzt eine Share-Datei, die sich standardmäßig im Verzeichnis C:\Program Files\Software AG\Entire Connection\data befindet. Sie können dieses Verzeichnis ersetzen, indem Sie ein Verzeichnis, welches ebenfalls den Namen data trägt, parallel zu den ausführbaren Dateien erstellen und die Share-Datei in dieses Verzeichnis hinein kopieren.

   Auch alle anderen Verzeichnisse aus C:\Program Files\Software AG\Entire Connection\ können Sie hier erstellen (kopieren und einfügen), damit eine komplette parallele Umgebung ausgeführt werden kann.

Die portable Version ändert keine Registrierungseinträge, die eine bereits installierte Version betreffen, vorausgesetzt, die portable Version wird nicht mit Administratorrechten gestartet. Das Programm ändert nur Einträge in HKEY_CURRENT_USER, wie zum Beispiel die Fenstergröße. Wenn die portable Version jedoch mit Administratorrechten gestartet wird und eine andere Version parallel installiert ist, dann ändert sie die Einträge für das API.

| Warnung: Wenn Sie Entire Connection mit Administratorrechten starten, dann verwendet das API die laufende Instanz von Entire Connection.

### On this page

- Systemvoraussetzungen
- Entire Connection für den Administrator installieren
- Stille Installation und Deinstallation
- Programmordner
- Umgebungsvariablen
- Entire Connection aktualisieren (Upgrade)
- Entire Connection auf einer Client-Workstation installieren
- Entire Connection deinstallieren
- Versionsportabilität und Parallelität