Backup and Restore

The information in this document is helpful, if you want to back up your settings and data on a regular basis. It is also helpful, if want to install Entire Connection on a new PC and you want to reuse your existing settings and data from your old PC. In this case, you have to back up all required items on the old PC and restore them on the new PC.

This document covers the following topics:


What Can be Backed Up?

You can back up and restore the following:

  • Share File
    The default share file that is delivered with Entire Connection is modified, for example, when you define a new host session, when you modify the current color scheme or key scheme, or when you define a different directory for your procedure files. The share is also modified when the administrator changes, for example, the user properties or host printer sessions. See also About the Object Types.

  • Procedure Files
    You can create your own procedure files, or you can modify the existing procedure files which are delivered with Entire Connection. See also Procedure Files.

  • Security Certificates
    Certificates are used for a secure connection between Entire Connection and a Telnet server (SSL/TLS and SSH). See also TN3270 SSL/TLS Support and Telnet SSH Support.

  • Startup Parameters for the Terminal Application
    A shortcut on your desktop for the terminal application is helpful if you want to start the terminal application with special parameters. See also Startup Parameters.

Backing Up a Standard Installation

  1. Copy the folder \ProgramData\Software AG\Entire Connection with all of its subfolders to a backup location of your choice. By default, this folder also contains your share file. If certificates have been created for secure connections with SSL/TLS, this folder also contains the certificates for SSL/TLS.

  2. If certificates have been created for secure connections with SSH, you also have to copy the folder Software AG\Entire Connection\certs which can be found in the user's local AppData folder (for example, C:\Users\username\AppData\Local) to a backup location of your choice.

Note:
The folders ProgramData and AppData are hidden folders. They are only shown in the Explorer when you have activated the corresponding setting in the folder options of the Explorer.

Additional copy steps may be required in the following cases:

  1. You have renamed your share file or stored it in a different location.

    By default, the share file is located in the folder \ProgramData\Software AG\Entire Connection\data and has the name share411.sag. It it possible to change both, the location and the name of the share file. If you cannot find your share file at once, start the Configuration Manager (either directly via the Windows Start menu, or via the Utilities menu of the terminal application). The location and name of your share file is then shown in the left pane, at the top of the tree.

  2. You have created procedure files, but they are not stored in \ProgramData\Software AG\Entire Connection\data.

    If you do not know where to find your procedure files, start the Configuration Manager and display your user properties. The path to your procedure file is then shown on the Procedure page.

    Additional procedure files (that is, files with the extension .NCP) may also be located in the installation directory of Entire Connection (that is, in \Program Files\Software AG\Entire Connection).

  3. You have created a shortcut for the terminal application on your desktop and have defined specific startup parameters.

    Open the properties of the shortcut and note down the startup parameters. Or copy the shortcut to a backup location of your choice.

Restoring a Standard Installation

  1. Copy the folders you have backed up to the approriate locations on the new PC. For example, copy them to:

    • C:\ProgramData\Software AG\Entire Connection

    • C:\Users\username\AppData\Local\Software AG\Entire Connection\certs (only required if SSH is used)

  2. Start the Configuration Manager, display your user properties, go to the Procedure page, and check the settings for the procedure directory and the log & trace directory. It may be required to change these settings for the new PC. It is recommended that you use the following default settings: Use Windows common application data folder for the procedure files and Use Windows local user application data folder for the log and trace files.

  3. If required, create a new shortcut for the terminal application on your desktop, with the same startup parameters as on the old PC.

    Or if you have backed up the shortcut, copy it to your desktop. Open the properties of the shortcut and make sure that the path to Pccterminal.exe is correct.