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 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, 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 4.5 folder. By default, this is \Program Files\Software AG\Entire Connection 4.5\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 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 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 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!
%TEMP%\pccsilentnnnmsi.log
SERIALNUMBER=serial-number
INSTALLDIR=installation-folder
INSTALLLEVEL=installlevel /qn"
Or:
To uninstall, use the following installer command syntax:
setup /s /w /x /v"/lvoicewarmup!
%TEMP%\pccsilentnnnuninstmsi.log /qn"
The options have the following meanings:
/s
|
Silent mode (no user interaction). |
/L1033
|
Optional. Language. "L1033" installs an English version of Entire Connection. "L1031" installs a German version. |
/w
|
Optional. Used in combination with a preceding start
/WAIT command. Causes setup.exe to wait until the
first-time installation, update installation or uninstallation is finished.
|
/x |
Uninstall mode. Uninstalls a previously installed product. |
/v
|
List of parameters for the Windows installer. See below. |
/lvoicewarmup!
%TEMP%\name.log
|
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. |
SERIALNUMBER=serial-number
|
Required for the installation. The serial number of Entire
Connection.
Important: |
INSTALLDIR=installation-folder
|
The installation folder (the default is
\Program Files\Software AG\Entire Connection 4.5).
Important: |
INSTALLLEVEL=installlevel
|
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). |
/qn
|
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!
%TEMP%\pccsilent4530msi.log SERIALNUMBER=PCC4539999999999
INSTALLDIR=\"C:\Software AG\Entire Connection 4.5\" INSTALLLEVEL=100
/qn"
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!
%TEMP%\pccsilent4530msi.log SERIALNUMBER=PCC4539999999999
INSTALLDIR=\"C:\Software AG\Entire Connection 4.5\" /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!
%TEMP%\pccsilent4530uninstmsi.log /qn"
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 4.5
Notes:
| Program Folder | Contents |
|---|---|
| \Entire Connection 4.5 |
*.exe |
| \Entire Connection 4.5\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.5\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:
| 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 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.
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, 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.