Aviva for DesktopsTM Release 15.0 Installation Guide · Aviva for Desktops includes a Setup Wizard that guides you through the installation process and lets you choose the components

Aviva® for DesktopsTM

Release 15.0

Installation Guide

2

Eleventh Edition (January 2016) 206-373-11

Aviva is a registered trademark, and Aviva for Desktops is a trademark, of Aviva Solutions Inc.

Eicon is a registered trademark of Eicon Networks Corporation.

Adobe and Adobe Acrobat are trademarks of Adobe Systems Incorporated.

Microsoft, Windows and the Windows logo are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

IBM and AS/400 are registered trademarks of International Business Machines.

DEC and VT220 are trademarks of Digital Equipment Corporation.

All other trademarks and registered trademarks are the property of their respective owners.

THE PROGRAMS INCLUDED IN THE RESOURCE KIT ARE PROVIDED TO YOU AS IS WITHOUT WARRANTY OF ANY KIND. AVIVA AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT AND THE WARRANTY AGAINST LATENT DEFECTS, WITH RESPECT TO THE PROGRAM AND THE ACCOMPANYING DOCUMENTATION. THE ENTIRE RISK ARISING OUT OF THE USE, RESULTS OR PERFORMANCE OF THE PROGRAM AND DOCUMENTATION IS ASSUMED BY YOU.

Changes are periodically made to the information in this document. These changes will be incorporated into new editions of this document. Aviva Solutions Inc. may also make improvements and/or changes in the products and/or programs described in this document at any time.

If you want to make comments about this publication, address them to:

[email protected]

or

Aviva Solutions Inc.Attention: Technical Publications185 Dorval AvenueSuite 303Montreal, Quebec, CanadaH9S 5J9

Aviva Solutions Inc. may use or distribute whatever information you supply in any way it deems appropriate, without incurring any obligations to you.

Copyright © 1996-2016 Aviva Solutions Inc. All rights reserved, including those to reproduce this publication or parts thereof in any form without permission in writing from Aviva Solutions Inc.

Contents

3

Installation Requirements............................................................................. 4Minimum system requirements ............................................................................... 4

Aviva for Desktops Licensing....................................................................... 5License installation options ..................................................................................... 5

Aviva for Desktops Components ................................................................. 6Overview ................................................................................................................. 6

Component Descriptions ......................................................................................... 8

Aviva User Profile ........................................................................................ 10Choosing a User Profile ........................................................................................ 10

Installing Aviva for Desktops...................................................................... 12Before you install .................................................................................................. 12

Completing an installation ..................................................................................... 12

Overview of install methods .................................................................................. 13

Interactive Install ......................................................................................... 14

Silent Install.................................................................................................. 20Overview of the silent install procedure ................................................................ 20

Installing Communications Support .......................................................... 22IBM Communications Server Client ...................................................................... 22

Microsoft Host Integration Server Client ............................................................... 22

Getting Started............................................................................................. 23

Post-Installation Scenarios......................................................................... 24Modifying, repairing or removing your installation ................................................. 24

Upgrading your installation .................................................................................... 25

Silent post-installation scenarios ........................................................................... 25

Installation Requirements 4

CHAPTER 1

Installation Requirements

Minimum system requirements• Any computer that is running Microsoft Windows 10, Windows 8, Windows 7, Windows

Server 2012 or Windows Server 2008 R2. The computer on which you install Aviva for Desktops must meet at least Microsoft’s minimum system requirements for the operating system that you are running.

• Microsoft .NET Framework version 4.5 or above

Important: To install Aviva for Desktops you must have Administrator rights on the computer.

Aviva for Desktops Licensing 5

CHAPTER 2

Aviva for Desktops Licensing

Each Aviva for Desktops installation must be licensed. For your convenience, Aviva for Desktops is available in both pre-licensed or post-licensed versions.

• Pre-licensed versions include a license file which is automatically set up during the installation process.

• Post-licensed versions require you to obtain a license file from Aviva Solutions Inc. The license can be set up during the installation process, or after using the included License Manager application.

If you have a post-licensed version of Aviva, but you have not yet obtained and installed a license, you can run Aviva for Desktops for an evaluation period of 15 days. If you choose not to obtain and install a license, the software will not function after the 15 day evaluation period has expired.

For a complete description of all Aviva for Desktop licensing options, or to purchase a license, contact Aviva Solutions Inc.

License installation options

Pre-licensed versions

If you are installing a pre-licensed version of Aviva, you will not have to enter licensing information during the installation, and you will not need to concern yourself with licensing issues until your license nears its expiration date.

Post-licensed versions

If you are installing a post-licensed version of Aviva, the Aviva License Manager will present you with two options for installing the license file:

• Install a Copy

This option creates a copy of the license file in the Aviva for Desktops application data folder. This option is best suited for mobile users who may not always have access to a centrally located license file. When the license expires, each installation with a copy must be individually upgraded.

• Link to Original

This option enables you to link multiple installations to a single license file stored at a central location. This option is best suited for network installations where the license file resides on a file server. When the license expires, only a single file has to be upgraded. Note that all Aviva users must have read rights to the central location.

Aviva for Desktops Components 6

CHAPTER 3

Aviva for Desktops Components

OverviewAviva for Desktops includes a Setup Wizard that guides you through the installation process and lets you choose the components that you want to install. Before you start the Setup Wizard, you should familiarize yourself with Aviva for Desktops components and decide the type of installation that you want to do and the components you want to install.

During installation, Setup Wizard presents you with two installation types: Typical or Custom.

• Typical installs a fixed set of components that should meet the requirements of most users.

• Custom lets you choose to install only those components that you want or need. By default, the Custom installation installs all of the components included in a Typical installation.

The next page provides an overview of the components that the Setup Wizard can install and shows the type of installation that installs the component:

• Typical components are installed if you choose the Typical installation.

• Custom components are installed only if you choose the Custom installation and specifically select the component.

For a brief description of each component, see Component Descriptions on page 8.

3270 Display components

- TN3270 Connection (Typical)

- IBM Communications Server Connection (Custom)

- Microsoft Host Integration Server Connection (Custom)

3270 Printer components




5250 Display components





5250 Printer components




VT220 (hereafter referred to as VT) Display components

- Telnet Connection (Typical)

- Secure connection over SSH (Custom)

FTP utility (Typical)

Automation samples (Custom)

Management tools

- Property Manager (Typical)

- Session Manager (Typical)

- License Manager (Typical)

Technical documentation (Typical)


Component DescriptionsThe tables below provide a brief description of the Aviva for Desktops components.

Connection types

For more information on any of these connection types, see the Administrator’s Guide (ADMIN.PDF) located in the DOCS folder in the installation package, or the online help.

Management tools

For more information on any of these tools, see the Administrator’s Guide (ADMIN.PDF) located in the DOCS folder in the installation package, or the online help.

Component Description

TN3270 Connection Lets 3270 displays and printers connect to a host computer via a TCP/IP network using the TN3270 or TN3270E protocol.

TN5250 Connection Lets 5250 displays and printers connect to a host computer via a TCP/IP network using the TN5250 protocol.

Telnet Connection Lets VT displays connect to a host (typically DEC or Unix) via a TCP/IP network using the Telnet protocol.

SSH Connection Lets VT displays connect to a host (typically Unix) via a TCP/IP network using the Secure Shell protocol.

IBM Communications Server Connection

Lets 3270 and 5250 displays and printers connect to a host computer via an IBM Communications Server.

Microsoft Host Integration Server Connection

Lets 3270 and 5250 displays and printers connect to a host computer via a Microsoft Host Integration Server.


Session Manager Session Manager is the main entry point into Aviva for Desktops

functions and management tools. With Session Manager, you can:

• open, connect, monitor, disconnect and close display and printer

• sessions.

• control print jobs

• access Property Manager to configure a session

• turn on tracing and logging for sessions

• open offline Aviva 3270, 5250 and VT sessions

• open an Aviva workspace

• open the Session Wizard to create new sessions

• open the Destination Wizard to create new destinations

• open the Aviva FTP Utility to perform file transfers

• open the Aviva License Manager to set up your Aviva license

Property Manager Property Manager is a utility that lets you work offline to edit sessions, and create and edit destinations and repositories.

License Manager A utility used for installing Aviva license files.


Other components

Third party components

The following components, which you may require, are not included in the Aviva for Desktops installation package.


FTP Utility A simple FTP utility that lets you use the file transfer protocol to transfer files between computers.

Automation Samples Includes sample sessions and programs written in a variety of languages that illustrate how you can use macros, the AvivaBasic programming language, and HLLAPI to automate Aviva.

Technical Documentation A collection of technical manuals in PDF format for the benefit of system administrators and power users who want to take advantage of Aviva’s more advanced features.

Communications Support To use some connection types, you need to install a third party protocol, driver, or client software.

IBM Communications Server Client: required for the IBM Communications Server 5250 connection type.

Microsoft Host Integration Server Client: required for the Microsoft Host Integration Server connection type.

Aviva User Profile 10

CHAPTER 4

Aviva User Profile

The Aviva User Profile, set during installation, determines whether the configuration data (sessions, destinations, workspaces, macros, etc.) are shared between users or are private to each user. The correct user profile settings are of particular importance in situations where many users must share a single workstation. Through the user profile settings, administrators can choose to let each user customize Aviva according to their needs and preferences or, alternatively, can ensure that all users must share a specific configuration. Once the user profile settings have been chosen during the installation, they cannot be changed when Aviva gets upgraded, repaired or has components added or removed.

In situations where each individual Aviva user has their own workstation, the user profile setting is less important. The default Aviva setting should not present any problems.

Choosing a User ProfileDuring the installation, you will be presented with this panel that allows you to specify the user configuration data location:

The default choice is My Documents. If selected, the private configuration data of every user will be located in their Documents folder in the Aviva Solutions\AFD subfolder. On first Aviva usage, every user starts with a fresh and identical configuration. This configuration data corresponds to the configuration created by the installation program. Changes to a user’s configuration do not affect other users.

Aviva User Profile 11

Hint: The original configuration data resides in the application or program data folder, in the Aviva Solutions\AFD subfolder. On first usage, this data is copied to the Aviva Solutions\AFD subfolder of the user’s documents folder.

If the All Users Shared Documents choice is selected, the configuration will be shared between users. The data is located in the shared or public documents folder in the Aviva Solutions\AFD subfolder. Changes made by one user will affect all users.

Hint: An administrator may restrict certain user rights by changing file and folder permissions. For instance, read-only permissions may be given to regular users, ensuring that only the administrator retains the right to change the configuration.

The User Defined choice is very similar to the previous one, except that the exact folder specified will contain the user profile (not the Aviva Solutions\AFD subfolder). This folder can be anywhere on a local or network drive.

Hint: If a network drive is chosen and if other installations of Aviva for Desktops choose the same drive as the location of the user configuration, data will be shared between multiple installations of Aviva. In this case, a network administrator can control the user rights.

Installing Aviva for Desktops 12

CHAPTER 5

Installing Aviva for Desktops

Aviva for Desktops provides you with a number of methods that you can use to install the software. The method that is best for you will depend on the number of computers on which you must install the software.

If the software is to be installed on only one or two computers, you will likely choose to install directly from the installation package.

If you need to perform many similar installations on many computers, you may want to consider using an alternate method of installing: silent install, which eliminates the need for user intervention in the install process.

This chapter provides an overview of the various methods that you can use to install Aviva for Desktops.

Before you install Before you install Aviva for Desktops, you should do the following:

• Read the Release Notes: The Release Notes provide the most up-to-date information about known limitations in a release. To read the Release Notes, double-click RELNOTE.TXT in the DOCS folder in the installation package.

• Read the Readme: The Readme provides information about the new features in a release. To read the Readme, double-click README.TXT located in the language specific sub-folder of the AVIVA folder in the Aviva for Desktops installation package (AVIVA\ENG for English, AVIVA\FRE for French, AVIVA\GER for German, AVIVA\ITA for Italian, AVIVA\SPA for Spanish).

Completing an installationSome connection types require that you have a specific protocol, driver, or client software installed on the computer with Aviva for Desktops. For information on which protocol, driver, or client software you need to install, and how to install it, see Installing Communications Support on page 22.

Installing Aviva for Desktops 13

Overview of install methodsA brief description of the methods you can use to install Aviva for Desktops is provided below. Detailed instructions on how to use each of these methods are provided in other chapters in this guide.

Interactive install

This method requires the most user intervention during the install process and so is best if you are installing on a small number of computers.

For detailed instructions on how to perform an interactive install, see Interactive Install on page 14.

Silent install

This method relies on the ability to record the choices made during an interactive install and later play them back without user intervention.

For detailed instructions on how to use this method, see Silent Install on page 20.

Interactive Install 14

CHAPTER 6

Interactive Install

To install Aviva for Desktops, follow these steps:

1. In the Aviva for Desktops installation package, in the AVIVA folder, double-click the setup.exe file.

2. In the first panel, you are instructed to close any programs that are running before you continue. Make sure that all other programs are closed, and then click Next.


3. Read the license agreement. If you agree to the terms of the license, click I accept the terms of the license agreement.

If you do not agree to the terms of the license, click I do not accept the terms of the license agreement. The Setup Wizard will terminate.

4. Select the folder into which you want to install Aviva for Desktops, and then click Next. By default, the program installs into C:\Program Files\Aviva Solutions, where C: is the drive on which Windows is installed.


5. Select the User Configuration Data Directory as discussed in Aviva User Profile on page 10..

6. Select the setup type as discussed in Aviva for Desktops Components on page 6.


7. If you chose Custom in the previous step, you may now choose the components you want to install. Refer to Aviva for Desktops Components on page 6 for a description of the various components. To install all the components, simply deselect and re-select the root Aviva for Desktops category. Note that by default, the components selected are the same as for a Typical installation.

8. Review the choices made so far and make corrections, as necessary, by clicking the Back button.


9. The installation process takes place.

10. Once the installation is complete, you are given the opportunity to review the ReadMe file.

11. If you purchased a pre-licensed version of Aviva for Desktops, the installation process is completed. Otherwise, you are prompted to install a license file. If you purchased a post-licensed version of Aviva for Desktops, click Install. If you do not have a license file, click Cancel. The program will be fully functional for an evaluation period of 15


days. You may install a license file during or after the evaluation period using the License Manager utility. For more information on Aviva for Desktops licensing see Aviva for Desktops Licensing on page 5.

Silent Install 20

CHAPTER 7

Silent Install

The silent install method uses a pre-recorded file to control the Aviva for Desktops setup program. User-intervention is required only to start the setup program.

Overview of the silent install procedureIn a silent install, the install procedure is controlled by an .ISS file. The type of installation that is done and the components that are installed is determined by the .ISS file that you choose. The .ISS file is generated by running the interactive install with special parameters that instruct it to record all of the user choices.

Note: A scenario recorded on a 32-bit Windows version cannot be replicated on a 64-bit Windows version, and vice versa.

Generating the .ISS file

The Aviva for Desktops installation package contains the AVIVA folder.

1. Copy the AVIVA folder to your source machine hard-disk. The source machine is the machine where you will record an interactive install to be silently replicated to other machines. When the process starts, there should be no version of Aviva for Desktops installed on the source machine.

2. If the AVIVA folder contains a license file (avivalicense.lic) you have a pre-licensed version (see Pre-licensed versions on page 5). If the AVIVA folder does not contain the license file and you obtained a license from Aviva Solutions Inc., you have a post-licensed version (see Post-licensed versions on page 5). You need to copy the license file to the AVIVA folder now. If you proceed without a license file, the silent install will create trial installations. For each such installation, the license would have to be installed manually.

3. Open a Command Prompt window and navigate to the AVIVA folder, which contains setup.exe along with other files needed by the installation process.

4. Execute the command

setup.exe /r /f1<.iss file name>

If the .ISS file name contains spaces, please enclose it in double-quotes. You must use an absolute path name, otherwise the location of the file will be relative to your system directory (typically c:\windows).

5. Perform the setup as described in Interactive Install on page 14. All your actions have been recorded to the .ISS file.

Silent Install 21

Replicating the installation

1. Make sure that the target machine(s) where the silent install will take place have access to the AVIVA folder and to the .ISS file that you generated. This can be accomplished via network sharing of the required files or copying the files to the target machine. When the process starts, there should be no version of Aviva for Desktops installed on the target machine.

2. On the target machine, open a Command Prompt window and navigate to the AVIVA folder.


setup.exe /s /f1<.iss file name>


The recorded Aviva for Desktops installation proceeds silently.

Installing Communications Support 22

CHAPTER 8

Installing Communications Support

Before you can make a connection to a host computer, you may need to install additional software (protocol, driver, or client software) to support some connection types. The tables below list the additional communications support required for each connection type.

Note: The software must be installed on the computer on which you installed Aviva.

IBM Communications Server ClientYou must install the IBM Communications Server client on your computer to use the IBM Communications Server (5250) connection type.

The client is supplied with your IBM Communication Server software.

Microsoft Host Integration Server ClientYou must install the Microsoft Host Integration Server client on your computer to use the Microsoft Host Integration Server (3270) or the Microsoft Host Integration Server (5250) connection type.

The Microsoft Host Integration Server client is supplied with your Microsoft Host Integration Server software.

3270 Connection Types Required Communications Support

IBM Communications Server No additional support required.

Microsoft Host Integration Server Microsoft Host Integration Server Client

TN3270 No additional support required.

5250 Connection Types Required Communications Support

IBM Communications Server IBM Communications Server Client

Microsoft Host Integration Server Microsoft Host Integration Server Client

TN5250 No additional support required.

VT Connection Types Required Communications Support

Telnet No additional support required.

SSH No additional support required.

Getting Started 23

CHAPTER 9

Getting Started

Now that you have installed Aviva for Desktops and the required communications support, you are ready to begin using the software.

For a brief overview of how to get started, consult the User’s Guide (USER.PDF) in the Aviva Solutions\AFD\Language folder on the Aviva for Desktops distribution media.

For in-depth information on how to use Aviva For Desktops, consult the online help.

For information on how to use some of the specialized features, tools, utilities, and applications included with Aviva for Desktops, consult the Administrator’s Guide (ADMIN.PDF) located in the DOCS folder in the installation package.

Post-Installation Scenarios 24

CHAPTER 10

Post-Installation Scenarios

After Aviva for Desktops has been successfully installed, the following tasks involving the installation program can still be performed:

- Modifying your installation

- Repairing your installation

- Removing your installation

- Upgrading your installation

The following paragraphs provide information about those tasks.

Modifying, repairing or removing your installationIn the Windows Control Panel, select Programs and Features.

Select Aviva for Desktops, and click Uninstall\Change. As a precaution, your current configuration is backed up into an Aviva Configuration Repository file. It is recommended that you should note the name and location of the file. Aviva Configuration Repository files can be later restored, if necessary, by using the Configuration Repository Wizard described in the Administration Guide.


The following panel offers three choices:

1. Click Modify to examine and eventually change the selection of components installed. This option will open the Custom Installation panel listing the Aviva components described in Interactive Install on page 14. Add or remove the desired components. The process will continue as described in Interactive Install. You will be offered the choice to restore the configuration saved at the beginning of the process.

2. Click Repair if you suspect your installation is corrupted. This action will restore the original files, registry entries and shortcuts. You will be offered the choice to restore the configuration saved at the beginning of the process.

3. Click Remove to completely remove Aviva for Desktops.

Upgrading your installationAs Aviva Solutions Inc. releases upgrades to Aviva for Desktops, the installation program will detect the presence of an older Aviva version and will propose an upgrade. If you accept, it will back up your configuration as explained in the previous section and it will install the upgrade. Your choice of components is preserved. You will be offered the choice to restore the configuration saved at the beginning of the process.

Silent post-installation scenariosJust as with silent install, silent post-installation scenarios can be controlled by an .ISS file. The scenario performed is determined by the .ISS file that you choose. The .ISS file is generated by running the interactive scenario with special parameters that instruct it to record all of the user choices.

Note: A scenario recorded on a 32-bit Windows version cannot be replicated on a 64-bit Windows version, and vice versa.


Generating the .ISS file

The Aviva for Desktops installation package contains the AVIVA folder.

1. Copy the AVIVA folder to your source machine hard-disk. The source machine is the machine where you will record a scenario to be silently replicated to other machines. When the process starts, there is already a version of Aviva for Desktops installed on the source machine.

2. Open a Command Prompt window and navigate to the AVIVA folder, which contains setup.exe along with other files needed by the scenario.


setup.exe /r /f1<.iss file name>


4. Perform the scenario. All your actions have been recorded to the .ISS file.

Replicating the scenario

1. Make sure that the target machine(s) where the silent scenario will take place have access to the AVIVA folder and to the .ISS file that you generated. This can be accomplished via network sharing of the required files or copying the files to the target machine. When the process starts, there is already a version of Aviva for Desktops installed on the target machine.

2. On the target machine, open a Command Prompt window and navigate to the AVIVA folder.


setup.exe /s /f1<.iss file name>

If you want to install Aviva in a language other than the operating system’s default language, execute the command

setup.exe /L<language code> /s /f1<.iss file name>

where the language codes are as follows:

English: 1033French: 1036German: 1031Italian: 1040Spanish: 1034


The recorded scenario proceeds silently.