This document covers the following topics:
Entire Connection Version 4.5.2 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 60 MB of free disk space. During installation, additional 80 MB are required in the Temp directory. |
|---|---|
| Operating System | Entire Connection can be installed on the following operating
systems:
|
| 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, one of the following Excel versions must be installed on your PC:
|
| 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 CD.
The setup program on the CD 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 4.n.n folder. By default, this is \Program Files\Software AG\Entire Connection 4.n.n\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:
| Setup Type | Installs |
|---|---|
| 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:
| Option | Typical | Complete | Custom |
|---|---|---|---|
| Configuration Manager | X | X | X |
| Terminal | X | X | X |
| Format Converter | X | X | X |
| Host Printer LU Support | X | (X) | |
| Sample Procedures | X | X | X |
| Sample Natural Programs | X | X | X |
| Client Setup | 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 CD into your CD 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 CD.
After the installation, the administrator can define the parameters, objects (e.g. 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. Is 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 a previous 4.n.n version of Entire Connection, 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 Entire Connection in silent mode. No user interaction is required in this silent mode installation.
For installing in silent mode, you cannot run setup.exe from the CD root. In this case, you have to run the setup.exe from the folder \Windows\PCC of the CD.
To install in silent mode
Insert the Entire Connection CD in the CD drive of the PC on which you want to install Entire Connection in silent mode.
Invoke the Command Prompt.
Change to the \Windows\PCC folder on the Entire Connection CD.
Enter the following command:
setup.exe /s /L1033 /w /v"/lvoicewarmup!
%TEMP%\pccnnnmsi.log
SERIALNUMBER=serial-number
INSTALLDIR=installation-folder
INSTALLLEVEL=installlevel /qn"
where the options are:
/s
|
Silent mode (no user interaction). |
/L1033
|
Language. "L1033" installs an English version of Entire Connection. "L1031" installs a German version. |
/w
|
Wait. setup.exe waits until the installation is finished. |
/v
|
List of parameters for the Windows installer. |
/lvoicewarmup!
%TEMP%\pccnnnmsi.log
|
Log file for the installation. It is not recommended to remove this parameter. nnn in the log file name stands for the current version number of Entire Connection. |
SERIALNUMBER=serial-number
|
Required. The serial number of Entire Connection. |
INSTALLDIR=installation-folder
|
The installation folder (the default is \Program Files\Software AG\Entire Connection 4.n.n). |
INSTALLLEVEL=installlevel
|
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). |
/qn
|
Required. Silent mode for the Windows installer. |
Note:
Update installations cannot be done in silent mode. If you try to do
this, an error message is written to the log file.
By default, Entire Connection is installed in the following program folder:
\Program Files\Software AG\Entire Connection 4.n.n
| Program Folder | Contents |
|---|---|
| \Entire Connection 4.n.n |
*.exe |
| \Entire Connection 4.n.n\doc |
Readme.txt 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 4.n.n\netsetup | Client installation program Setup.exe. Only available when the option Client Setup has been specified during installation (setup type Custom). |
Depending on the operating system, the folders for the user data are by default installed at the following location:
Windows 2000, XP and Server 2003:
\Documents and Settings\All Users\Application Data\Software AG\Entire Connection
Windows Vista:
\ProgramData\Software AG\Entire Connection
The ProgramData folder, which is used with Windows Vista, 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:
| Folder | Contents |
|---|---|
| certs | Files for TN3270 SSL/TLS support. |
| data | Share411.sag. |
| home |
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 4 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.
Since the default location for the user data has changed as of Entire Connection Version 4.5.1, the user data can also be found at the new location after the upgrade.
Caution:
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 4.5.2,
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.
Important:
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).
See Uninstalling Entire Connection.
Use the standard Windows functionality in the Control Panel to uninstall Entire Connection.
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.
