This document covers the following topics:
Entire Connection is a 32-bit application. When installed on a 64-bit Windows operating system, Entire Connection will run under WOW64. WOW64 is an x86 emulator that allows 32-bit Windows-based applications to run seamlessly on 64-bit Windows.
The following hardware and software is required in order to install and run Entire Connection:
|Hardware||Any PC capable of running Microsoft Windows. Approximately 80 MB of free disk space. During installation, additional 80 MB are required in the Temp directory.|
|Operating System|| Entire Connection supports the following 64-bit
operating system platforms:
Make sure the machine on which you are going to run the installer contains the latest Windows updates before you start the installation. On Windows server 2012 R2, the installation will fail if the Microsoft update KB2919355 is missing.
Home editions of Microsoft Windows are not supported.
The runtime components of Entire Connection are always 32-bit applications, even on 64-bit platforms.
|Communication Method||At least one of the supported PC-to-host communication methods.|
|Data Transfer Software|| If you want to transfer data between the host and your
PC, the following Software AG products must be installed on the host to which
the PC is being linked:
If you want to download data to Excel format or upload Excel data, Microsoft Excel 97 or higher must be installed on your PC. The Excel version depends on the operating system you are using.
|Online Documentation||Microsoft Internet Explorer 4.0 or higher for viewing the Entire Connection documentation in HTML help format.|
Before installing Entire Connection, read the file Install.txt on the Entire Connection installation medium.
The setup program on the installation medium installs Entire Connection for one user, the administrator. In the simplest case, this is a single installation on a local PC, where the user can act as an administrator and define all required object types.
When several users are to work with the same installation (multi-user installation), the administrator can install Entire Connection on a network file server or shared drive and prepare the system for all users who are to access Entire Connection from different client workstations. For this type of installation, you have to choose the setup type Complete (or the setup type Custom and select the option Client Setup). The Client Setup option creates the netsetup folder in the Entire Connection folder. By default, this is \Program Files\Software AG\Entire Connection\netsetup. The netsetup folder contains the client installation program Setup.exe. Each user can run this program from his or her client workstation. It registers Entire Connection on the client workstation and creates an Entire Connection folder in the Start menu of the client workstation. When started, Setup.exe searches for the Readme.doc file in the netsetup folder. When found, its content is displayed. The administrator can use this file to provide the users with site-specific information for their work with Entire Connection (such as user names, defaults or session names). See Installing Entire Connection on a Client Workstation later in this section for information about the installation on the client workstation.
The following setup types are available:
|Typical (default)||The most common options. Recommended for most users.|
|Complete||All options. Required for a multi-user installation.|
|Custom||You may select the options you want to install. Recommended for advanced users.|
The following table indicates the options that are (or can be) installed with a specific setup type:
|Host Printer LU Support||X||(X)|
|Sample Natural Programs||X||X||X|
The default setting for a custom installation is the same as for the setup type Typical.
The following options are always installed: Configuration Manager and Terminal. With a custom installation, it is not possible to deselect these options.
To install Entire Connection
Close any active Windows applications.
Insert the Entire Connection installation medium into your CD/DVD drive.
The setup program is automatically started and guides you through the installation.
If the automatic startup option is disabled on your system, you must run Setup.exe which is located in the root directory of the installation medium.
After the installation, the administrator can define parameters, objects (for example, sessions), user groups and access rights for all users (see the section Configuration Manager). As the first step, make sure that the settings in the System Preferences dialog box are valid for all users. It is important that the directories for the procedure files and for the log and trace files can be accessed by all users.
If you want to merge version 3.1 user profiles, you must do this directly after installation. See Merging Existing User Profiles in the Configuration Manager section for further information.
If you upgrade from Entire Connection Version 4.3.1 or earlier, you have to upgrade your share file. Otherwise, specific new features will not be available. See Upgrading the Share File in the Configuration Manager section for further information.
InstallShield enables you to install and uninstall Entire Connection in silent mode. This also includes silent update installations. No user interaction is required in this mode.
For installing or uninstalling in silent mode, you cannot run setup.exe from the root of the installation medium. In this case, you have to run setup.exe from the \Windows\PCC folder of the installation medium.
To make sure that no user interaction is required during silent mode installation or uninstallation, it may be necessary to turn off or disable the user account control (UAC).
To install, update or uninstall in silent mode
Insert the Entire Connection installation medium in the CD/DVD drive of the PC on which you want to install or uninstall Entire Connection in silent mode.
Invoke the Command Prompt.
Change to the \Windows\PCC folder on the Entire Connection installation medium.
For a first-time installation or update installation, use the following installer command syntax:
setup.exe /s /L1033 /w /v"/lvoicewarmup!
To uninstall, use the following installer command syntax:
setup /s /w /x /v"/lvoicewarmup!
The options have the following meanings:
||Silent mode (no user interaction).|
||Optional. Language. "L1033" installs an English version of Entire Connection. "L1031" installs a German version.|
|| Optional. Used in combination with a preceding
||Uninstall mode. Uninstalls a previously installed product.|
||List of parameters for the Windows installer. See below.|
|| Log file for the installation or uninstallation.
It is not recommended to remove this parameter.
For silent mode, it is recommended that you use the following log file names:
where nnn in the log file name stands for the current version number of Entire Connection.
|| Required for the installation. The serial number
of Entire Connection.
|| The installation folder (the default is
\Program Files\Software AG\Entire Connection).
||Optional. Possible values are 1 or 100 (the default is 1). The value 1 stands for the setup type Typical; the value 100 stands for the setup type Complete (see above).|
||Required. Silent mode for the Windows installer.|
To start the first-time installation for the setup type Complete where setup.exe waits until the first-time installation is finished, enter the following command:
start /WAIT setup.exe /s /L1033 /w /v"/lvoicewarmup!
INSTALLDIR=\"C:\Software AG\Entire Connection\" INSTALLLEVEL=100
To start an update installation for the setup type Typical where setup.exe does not wait until the update installation is finished, enter the following command:
setup.exe /s /L1033 /w /v"/lvoicewarmup!
INSTALLDIR=\"C:\Software AG\Entire Connection\" /qn"
To start an uninstallation where setup.exe waits until the uninstallation is finished, enter the following command:
start /WAIT setup /s /w /x /v"/lvoicewarmup!
By default, Entire Connection uses the following log files for additional information, especially in case of errors:
The installation and uninstallation log files in
%TEMP%, with the names as described above.
The Windows event log.
By default, Entire Connection is installed in the following program folder:
\Program Files\Software AG\Entire Connection
English and German online documentation, and the help files Pccnnnxx.chm (where nnn is the current version number and xx is the language code "US" for US English or "GR" for German).
|\Entire Connection\netsetup||Client installation program Setup.exe. Only available when the option Client Setup has been specified during installation (setup type Custom).|
The folders for the user data are by default installed at the following location:
\ProgramData\Software AG\Entire Connection
The ProgramData folder is a hidden folder. It is only shown in the Explorer when you have activated the corresponding setting in the folder options of the Explorer.
If you do not install into the default program folder (that is: the Program Files folder of Windows), the folders for the user data are installed into the specified installation folder.
The folders for the user data are:
|certs||Files for TN3270 SSL/TLS support.|
Empty after installation.
|proc||System procedure files. If specified during installation, this folder may also contain sample procedure files and sample Natural programs.|
|tables||Translation tables, keyboard tables, physical terminal function code tables.|
If you install for multiple users on Terminal Services, and if you want to allow the users to change their profiles in the share file, you have to change the security properties for the file Share411.sag to allow write access for the users.
Entire Connection does not change any environment variables.
Only one version of Entire Connection can be installed on a PC (installation for an administrator). When you upgrade Entire Connection, the previous version is removed and the new version is installed. Any user data from the previous version, especially the share file, will be saved and restored.
The folder names that are stored in your share file may no longer be valid if the upgrade has changed the folder that contains your user data. In this case, after upgrading to Entire Connection Version 8.4.1 or later, you have to adjust these folder names to ensure that Entire Connection can find your procedure files, log files and trace files. The folder names that Entire Connection uses to locate these files are stored in the system preferences and in the user properties.
For a multi-user installation, the administrator must first install and prepare Entire Connection on a network file server or shared drive (see Installing Entire Connection for the Administrator). When this has been done, each user can run Setup.exe in the netsetup folder from his or her client workstation. It registers Entire Connection on the client workstation and creates an Entire Connection folder in the Start menu of the client workstation.
Each user who wants to install Entire Connection on a client workstation as described above needs administrator rights.
There is no upgrade installation for the client workstation.
The administrator must first upgrade the existing Entire Connection installation on the network file server or shared drive (see Upgrading Entire Connection). Then, for the PC on which you have an existing client installation, proceed as follows:
Uninstall Entire Connection on all client workstations (see below).
Install Entire Connection on all client workstations (see above).
Use the standard Windows functionality in the Control Panel to uninstall Entire Connection, or uninstall Entire Connection in silent mode.
The uninstall does not remove any user-supplied files in the Entire Connection installation folders. This also includes the share file in the data folder.
It is generally recommended to install Entire Connection using the installer. In certain instances, for example migration or rehosting projects, it may be useful to run a portable version in order to execute different versions in parallel.
Since Entire Connection is free from necessary registry entries, it can be transferred to different machines by copying and pasting.
Such a copied version can act as portable version. Consequentially, many different versions can exist in parallel, and it is possible to have an installed version and a portable version running on the same Windows computer.
Disadvantages of using Entire Connection as a portable version are:
The Microsoft Visual Studio Redistributable must be installed on the target system. Normally, this would be done by the installer.
Cannot be easily removed via “App & features” or other ways typical for Windows.
Configuration must be managed on your own because it is not automatically stored under “C:\Program Files\Software AG\Entire Connection” by the installer.
Can be easily removed by mistake because the folder is not protected such as C:\Program Files (x86).
The API cannot be used without changing the registry. This requires starting the program with admin rights.
A windows machine (should not be a productive environment) where you can install the newest version of Entire Connection.
A target windows machine where the parallel version should run. Here, the Microsoft Visual Studio Redistributable needs to be installed.
The following steps show how to set up and run a portal version of Entire Connection:
Use a machine where you can install the newest version of Entire Connection. Install Entire Connection with the required setup.
Open the installation directory. By default, this will be C:\Program Files (x86)\Software AG\.
Copy the installation directory to a write-enabled location, for example to C: or on the desktop.
Create a ZIP file with all the content of the newly created “Entire Connection” folder.
Copy the new ZIP to the PC where you want to run the portable version of Entire Connection.
Unzip the files to a suitable location on the target machine.
From here, the executables such as PccTerminal.exe or PCCAdmin.exe can be started directly from this folder.
To check if you really are running the intended version, select Help > About Entire Connection Terminal….
Entire Connection uses a share file located by default in C:\Program Files\Software AG\Entire Connection\data. This directory can be substituted by creating a folder, also named data, in parallel to the executables. The share file can be copied into this location.
Also, all other folders from “C:\Program Files\Software AG\Entire Connection\” can be created here to run a complete parallel environment (copy & paste).
The portable version will not change registry entries that concern an already installed version, provided the portable version is not started with admin privileges. The program only changes entries in HKEY_CURRENT_USER such as the window size. However, should the portable version be started with admin privileges and another version is installed in parallel it changes entries for the API.
If you start Entire Connection with admin privileges the running instance of Entire Connection will be used for the API.