Copyright: Copyright © CoCo Systems Ltd., 1995-1997.
Citation: Copyright © CoCo Systems Ltd., 1995-1997. All rights reserved.


About CoCo Systems Setup
About CoCo Systems Setup	See also ...

Overview

CoCo Systems' Setup is designed to make the process of installing CoCo Systems' products under Microsoft Windows® 3.1, Windows® 95 or Windows® NT a simple and painless task, for both single-user and network installations.

The necessary complexities of installing under Windows are taken care of with a minimum of input from yourself.

The installation process can either be interactive, where you will be asked to make a few simple choices, or unattended, in which case the choices are pre-specified via a response file. In both cases the choices to be made include:

where you wish to install the product to on your system,

which components of the product you wish to install, and

whether or not you wish to create a program group for the product.

In interactive mode (this is the default) the Setup 'wizard' will collect information from you concerning these choices at the start. The wizard will present a series of choices for you to make via easy-to-use dialog boxes before starting the actual installation. Having made a choice in a dialog, or entered the information asked for, press the Next button to proceed to the next dialog. You can go back at any time to review and change your inputs by pressing the Back button in any of the dialogs.

Throughout the operation of Setup you can obtain on-line help by pressing the F1 key on the keyboard, or clicking with the mouse on the Help button in the bottom right hand corner of the Setup window.

Should you wish to interrupt Setup temporarily to carry out some other task press the F6 key, or the Pause button in the bottom right hand corner of the Setup window.

If for any reason you wish to terminate Setup before it has completed it's task you can press the F3 key, or the Exit button in the bottom right hand corner of the Setup window.  Be warned, however, that if you do so the installation will be incomplete and the product may not function fully or correctly. If you terminate Setup before its completion you will need to re-run it again at a later time.

Your main choices

Once Setup begins, you are asked (via the Choose Action dialog) which task you wish Setup to perform. You will have the following choices:

Server Installation

Single-user Installation

Custom Installation

Server Installation installs or upgrades all components of the product onto a shared network server, for use by other network clients. Single-user Installation installs or upgrades all components of the product on a single-user system, while Custom Installation allows you to select which product components you wish to install or upgrade. Refer to the highlighted topics for further information.

NB: Not all products may necessarily have a server- or custom-installation option.

The unattended setup mode is designed primarily to ease the process of installing CoCo Systems’ products for use on multiple network client computers from a shared network server. For further information about setting up for unattended mode, see Unattended Installation.

As part of the standard CoCo Systems setup procedure, Setup also configures the product so that it can be easily un-installed later (refer to the topic Un-installation).


Server Installation
Server Installation	See also ...

Choose this option if you are a network administrator who is installing the product onto a shared network server. This option will install all components of the product. Do not use this option if you wish to build a single-user installation. You are asked via dialog boxes for the following information:

the drive and directory on your system you wish to install the product to, and

whether or not you wish to create a program group for the product.

You may also be asked to enter product registration and validation details, and to examine the CoCo Systems Licence Agreement for the product, and indicate your assent to its terms and conditions. You will also be presented with a summary of your installation choices for your review before proceeding, and be given the option to go back and change any of them.

Setup will perform the following installation tasks:

Create the necessary product directory structure, and copy the product files there from the distribution libraries.

When Setup copies or updates files to your system, it intelligently takes care not to replace any files with older versions. Where possible, it uses version control information contained within program or system files where this is present, or uses file date and time information if the version control information is not present.

When upgrading an old version of a product to a newer one, it may be that the product directory and file structure requires changes. In this case Setup performs the necessary changes automatically, deleting any old files that are no longer valid.

Where necessary for correct operation of the product, automatically update or copy selected system files to the windows and windows\system directories. Again, Setup takes care not to replace any system files with versions that are older.

Create a program group for the product, if desired, containing icons whereby you can launch the product's applications more easily. Where a program group already exists for the product (installed previously), Setup will update the icons there as necessary.

Update the WIN.INI file (and the SYSTEM.INI file, if necessary) as needed. Usually this involves only the addition or modification of entries in the [Extensions] section of WIN.INI to associate the product's data files with its application programs.

Creates or modifies the product's own .INI files in the windows directory. The product's .INI files are used to save product configuration information and other options you set. Where the structure of a product's .INI file changes from that of a previous version Setup will make the necessary changes to update it.

Update or modify the Windows registry for the product.

Additionally, Setup will install the product's Client Installation Kit. This is provided to set up the product for use on each of the network's client systems, and can be used either by the network users themselves, or by the network administrator. The Client Installation Kit is launched (on the client system) by running the program NETSETUP.EXE from the main product installation directory (which resides on the network server).

For more information on the Client Installation Kit, please see the main product's documentation or on-line help system.

As part of the product installation, Setup also installs the necessary files and configuration to enable you to later un-install the product. If you choose to create a program group, Setup will place an Un-install icon in that group. If you do not create a program group Setup will, at the end of the installation process, inform you of the command line you will need to enter to perform the un-installation. For details of the un-installation process, see the topic Un-Installation.


Single-user Installation
Single-user Installation	See also ...

Chose this option if you are installing the product for use on a single system. This option will install all components of the product. Do not use this option if you wish to create a shared network server installation, nor if you wish to use the product installed on a shared network server. You are asked via dialog boxes for the following information:

the drive and directory on your system you wish to install the product to, and

whether or not you wish to create a program group for the product.

You may also be asked to enter product registration and validation details, and to examine the CoCo Systems Licence Agreement for the product, and indicate your assent to its terms and conditions. You will also be presented with a summary of your installation choices for your review before proceeding, and be given the option to go back and change any of them.

Setup will perform the following installation tasks:

Create the necessary product directory structure, and copy the product files there from the distribution libraries.

When Setup copies or updates files to your system, it intelligently takes care not to replace any files with older versions. Where possible, it uses version control information contained within program or system files where this is present, or uses file date and time information if the version control information is not present.

When upgrading an old version of a product to a newer one, it may be that the product directory and file structure requires changes. In this case Setup performs the necessary changes automatically, deleting any old files that are no longer valid.

Where necessary for correct operation of the product, automatically update or copy selected system files to your windows and windows\system directories. Again, Setup takes care not to replace any system files with versions that are older.

Create a program group for the product, if desired, containing icons whereby you can launch the product's applications more easily. Where a program group already exists for the product (installed previously), Setup will update the icons there as necessary.

Update the WIN.INI file (and the SYSTEM.INI file, if necessary) as needed. Usually this involves only the addition or modification of entries in the [Extensions] section of WIN.INI to associate the product's data files with its application programs.

Creates or modifies the product's own .INI files in your windows directory. The product's .INI files are used to save product configuration information and other options you set. Where the structure of a product's .INI file changes from that of a previous version Setup will make the necessary changes to update it.

Update or modify the Windows registry for the product.

As part of the product installation, Setup also installs the necessary files and configuration to enable you to later un-install the product. If you choose to create a program group, Setup will place an Un-install icon in that group. If you do not create a program group Setup will, at the end of the installation process, inform you of the command line you will need to enter to perform the un-installation. For details of the un-installation process, see the topic Un-Installation.


Custom Installation
Custom Installation	See also ...

This option is used to install selected components of the product on your system, either for Server Installations or Single-User Installations. You are asked via dialog boxes for the following information:

the drive and directory on your system you wish to install the product to,

which components of the product you wish to install, and

whether or not you wish to create a program group for the product.

You may also be asked to enter product registration and validation details, and to examine the CoCo Systems Licence Agreement for the product, and indicate your assent to its terms and conditions. You will also be presented with a summary of your installation choices for your review before proceeding, and be given the option to go back and change any of them.

Setup will perform the following installation tasks:

Create the necessary product directory structure, and copy the product files there from the distribution libraries.

When Setup copies or updates files to your system, it intelligently takes care not to replace any files with older versions. Where possible, it uses version control information contained within program or system files where this is present, or uses file date and time information if the version control information is not present.

When upgrading an old version of a product to a newer one, it may be that the product directory and file structure requires changes. In this case Setup performs the necessary changes automatically, deleting any old files that are no longer valid.

Where necessary for correct operation of the product, automatically update or copy selected system files to your windows and windows\system directories. Again, Setup takes care not to replace any system files with versions that are older.

Create a program group for the product, if desired, containing icons whereby you can launch the product's applications more easily. Where a program group already exists for the product (installed previously), Setup will update the icons there as necessary.

Update the WIN.INI file (and the SYSTEM.INI file, if necessary) as needed. Usually this involves only the addition or modification of entries in the [Extensions] section of WIN.INI to associate the product's data files with its application programs.

Creates or modifies the product's own .INI files in your windows directory. The product's .INI files are used to save product configuration information and other options you set. Where the structure of a product's .INI file changes from that of a previous version Setup will make the necessary changes to update it.

Update or modify the Windows registry for the product.

As part of the product installation, Setup also installs the necessary files and configuration to enable you to later un-install the product. If you choose to create a program group, Setup will place an Un-install icon in that group. If you do not create a program group Setup will, at the end of the installation process, inform you of the command line you will need to enter to perform the un-installation. For details of the un-installation process, see the topic Un-Installation.


Unattended Installation
Unattended Installation	See also ...

If you wish to install a product on multiple network client computers from a shared network server, and make the same installation choices for each (such as the installation directory on the client computer) then CoCo Systems’ Setup unattended installation mode can greatly ease the burden.

To use unattended mode, you create a special response file called SETUP.RSP and place it in the product’s setup directory (i.e. co-located with the SETUP.EXE file). SETUP.RSP is an ASCII text file you can create with any text editor that specifies the installation choices to be made.

When Setup is subsequently run from a client computer, say, Setup reads the choices from the response file and completes the installation without the need for user intervention.

The general form of a response file is a series of key/value pairs contained within a section called [Install], as follows:

[Install]

Unattended=Y

<key>=<value>

…

<key>=<value>

Apart from the Unattended=Y pair (which is mandatory for all response files), the key/value pairs are specific to each product, and are described in the product’s User’s Guide and on-line help system. Please refer to your product’s documentation as appropriate. The order of the key/value pairs is not significant, but all required pairs must be included for unattended mode to be enabled (if you omit one or more required key/value pairs Setup will revert to interactive mode automatically).

For example, the complete SETUP.RSP response file for a product might be something like the following:

[Install]

Unattended=Y

TargetPath=C:\VisiMap

Local data directory=C:\VisiMap\Data

Global template directory=X:\VisiMap\Data

Default Save-As directory=C:\VisiMap\Data

MakeGroup=Y

GroupName=VisiMap

This response file will install the product to directory C:\VisiMap, set it’s working directories as shown and create a program group called VisiMap.


Un-Installation
Un-Installation	See also ...

To un-install the product from your system, simply run the Un-Install icon in the product’s program group (if you created one during installation), or run the command line that was given to you at the end of the installation process.

The un-installer performs the following actions:

Removes installed files.

The un-installer removes any files copied during the installation that are not shared with other applications. Any files not created by the installation process are not removed.

Removes product directories:

Directories that are created during the installation and are empty after the removal of installed files are removed by the un-installer. If any files not created by the installation process are found in the directories, the directories are not removed.

Removes program groups:

Program groups or icons that are installed or replaced during the installation process are removed by the un-installer. Any program groups that are empty after the un-installer removes the icons are also removed. Any icons added by the user are not removed.

Removes registry entries:

Registry entries created by the installation process are removed by the un-installer.


Setup Dialog Boxes

Choose Action dialog

Choose Working Directories dialog

Installation Complete dialog

Product Licence dialog

Readme File dialog

Registration dialog

Restart System dialog

Select Components dialog

Select Installation Directory dialog

Select Program Group dialog

Software Licence Agreement dialog

Summary dialog

Welcome dialog

Windows Drive is Read Only dialog


Choose Action dialog
Choose Action dialog	See also ...

This dialog box allows you to choose what you wish Setup to do.

If you wish to install all components of the product onto a shared network server, or upgrade a previous installation of the product, you should choose the Server Installation option  (see Server Installation for further information). This is the recommended option for network administrators who have purchased a network licence for the product.

If you wish to install all components of the product onto a single-user system, or upgrade a previous installation of the product, you should choose the Single-user Installation option  (see Single-user Installation for further information). This is the recommended option for users on non-networked systems, or for situations where you do not possess the requisite product network licence.

If you prefer only to install or upgrade only selected components of the product then choose the Custom Installation option (see Custom Installation for further information).

Once you have chosen the type of installation, press the Next button.


Choose Working Directories dialog
Choose Working Directories dialog	See also ...

This dialog is displayed whenever the product being installed gives you options to select one or more working directories, in addition to the product’s primary installation directory.

Each of the directories are described, together with their default location and a Browse button to allow you to select a directory other than the default.

In general, the product will also allow you to change these after installation. See the product’s on-line help and/or printed User’s Guide for further information.


Installation Complete dialog
Installation Complete dialog	See also ...

This dialog appears at the end of the installation process to inform you that the installation has been completed.

When you perform a single-user or server installation (or a custom installation and you choose to install the main program files) it will give you instructions on how to start the application.

This dialog also informs you how to un-install the product at a later date.


Product Licence dialog
Product Licence dialog	See also ...

In order for you to install the product, CoCo Systems Ltd. requires that you accept the terms of its Software Licence Agreement in full.

This dialog informs you that, on pressing the Next button, the agreement will be presented to you for your examination and acceptance.

Setup will not allow you to proceed with the installation until you have indicated your assent to all of its terms and conditions.


ReadMe File dialog
ReadMe File dialog	See also ...

This dialog box displays the product's README file (if any) for your perusal.

The README file is used to communicate to you any product enhancements or changes that have been introduced recently, or to advise you of other special factors that may influence your installation or operation of the product.

If the README file is too large to display fully in the window, you can use the scroll bars on the right to scroll freely through the file. Once you have finished viewing the file, you can return to Setup by pressing Continue.


Registration dialog
Registration dialog	See also ...

This dialog box asks you to enter your name, your company name (which is optional), your product serial number and, usually, a validator number for registration purposes. This information is needed to personalise your copy of the product.

You will normally find your product serial number and validator numbers on your end-user licence agreement. If, however, you have received your copy electronically (such as via Internet ftp), these will be communicated to you by your supplier electronically (or by other means).

You may continue with the product installation only once you have entered details into the Name, Serial number and, if needed, Validator number boxes. You do not need to enter a name in the Company box, but you are kindly requested to do so if the product has been purchased on behalf of a named organisation.

NB: this dialog box may not be used for all products.


Restart System dialog
Restart System dialog	See also ...

This dialog informs you that Setup needs to update one or more system files, but that the system needs restarting to do so.

You can choose to allow Setup to automatically restart your system and perform the updates, or you can choose to restart the system yourself later. If you choose to do so later, you should not attempt to use the product you have just installed, as it will probably fail to function correctly until your system has been restarted.


Select Components dialog
Select Components dialog	See also ...

For a Custom Installation, this dialog box is where you tell Setup which of the product’s components you would like to install.

You select or de-select a component for installation by highlighting it and then pressing the SPACE key on your keyboard.

Unless you specifically wish not to, you would normally select all product components. Given the product components you select, Setup will intelligently update any installation you have previously made: it will not overwrite any files on your system with any older versions that may be contained in the product distribution kit.


Select Installation Directory dialog
Select Installation Directory dialog	See also ...

Use this dialog to select the directory in which you wish to install the product. When it first appears the dialog will suggest a suitable directory (this will be either a default directory for the product, or will be the directory in which you have previously installed a version of the product).

If you wish to change the directory, press the Browse button and enter or select a different directory in the selection dialog that appears.


Select Program Group dialog
Select Program Group dialog	See also ...

This dialog box allows you to specify which, if any, program group you would like to add the product's icons to. By creating a program group for the product you will be able to more easily launch the product's programs.

In order to create a program group, your Windows 'shell' program (such as the Windows 3.1 Program Manager or the Windows 95 Start menu) must provide the support necessary to enable Setup to complete this task. Many popular replacement shells, such as the Norton Desktop for Windows, PC Tools for Windows or Norton Navigator also provide this support.

The dialog box will list the program groups you already have on your system. You can choose either to install the product's icons to an existing group, or enter the name of a new group for the product. Setup will suggest a default group name.

If you are upgrading from an older version of the product, you should normally choose the group in which the old icons are already present. Setup will then ensure they are updated to reflect any changes in the product's file structure.

You can also choose not to set up a program group. In this case when you wish to run the product's program(s) you will need to do so via the Windows File Manager (Windows 3.1) or Explorer (Windows 95).

Whether or not you wish to create a program group, Setup will (at the end of installation) summarise for you how to run the product.


Software Licence Agreement dialog
Software Licence Agreement dialog	See also ...

This dialog box presents you with the CoCo Systems Ltd. Software Licence Agreement for the product you are installing.

It requires that you either accept or reject the terms of the agreement. Please read the licence agreement carefully.

If you wish to accept the agreement and continue with the installation, press the Yes button.

If you do not wish to accept the full terms of the agreement press the No button - the installation will then terminate. You should then, within 30 days of purchase, return the full product to the place of purchase, accompanied by your declaration that you have neither installed nor retained any copy of the product or its accompanying materials, and your money will be refunded.


Summary dialog
Summary dialog	See also ...

This dialog is presented prior to commencing the installation process to give you the opportunity to review your installation choices, and to go back and make any changes you desire.

If you are happy with the choices listed, press the Proceed button to proceed with the installation.

If you wish to make any changes, track through the previous dialogs again using their Back and Next buttons.


Welcome dialog
Welcome dialog	See also ...

Welcome to CoCo Systems' Setup

This program is designed to make the process of installation and un-installation of CoCo Systems' products a simple and painless task.

You will be asked to make a few simple choices such as:

where you wish to install the product to on your system,

which components of the product you wish to install, and

whether or not you wish to create a program group for the product.

The Setup question-and-answer ‘wizard’ will collect information from you concerning these choices. The wizard will present a series of choices for you to make via easy-to-use dialog boxes before starting the installation process. Having made a choice in a dialog, or entered the information asked for, press the Next button to proceed to the next dialog. You can go back at any time to review and change your inputs by pressing the Back button in any of the dialogs.

For a complete overview of what Setup does, please refer to the topic About CoCo Systems Setup.

The Welcome dialog box gives you the opportunity to view the product release's README file, if any, by pressing the View Readme file button.

The README file is used to communicate to you any product enhancements or changes that have been introduced recently, or to advise you of other special factors that may influence your installation or operation of the product.

 If at any time during installation you require help, just press the F1 key or press the Help button in the bottom right hand corner of Setup's window.


Windows Drive is Read-Only dialog

This dialog box appears if Setup has determined it needs to update one or more of your Windows system files with newer versions that are needed for correct operation of the product, but has found you do not have sufficient read-write access to the Windows directory or windows\system directory.

You can choose to continue with the installation, but there is a chance the product may then not operate fully and correctly.

You are advised to terminate Setup by pressing Exit and to resolve the problem. To do so, contact your network administrator to arrange a solution: you need either to install the product while you have sufficient access rights, or to first ensure you have updated the system files to the latest versions.


See alsos
(dummy topic)


See also (About CoCo Systems Setup)
Custom Installation

Server Installation

Single-user Installation

Unattended Installation

Un-Installation


See also (Choose Working Directories dialog)
Select Installation Directory dialog


See also (Custom Installation)
Server Installation

Single-user Installation

Unattended Installation

Un-Installation

Choose Action dialog


See also (Server Installation)
Custom Installation

Single-user Installation

Unattended Installation

Un-installation

Choose Action dialog


See also (Single-user Installation)
Custom Installation

Server Installation

Unattended Installation

Un-Installation

Choose Action dialog


See also (Un-Installation)
Custom Installation

Server Installation

Single-user Installation

Unattended Installation

Installation Complete dialog


See also (Choose Action dialog)
Custom Installation

Server Installation

Single-user Installation


See also (Installation Complete dialog)
ReadMe File dialog


See also (Product Licence dialog)
Software Licence Agreement dialog


See also (ReadMe File dialog)
Installation Complete dialog

Welcome dialog


See also (Registration dialog)
Custom Installation

Server Installation

Single-user Installation


See also (Restart System dialog)
About CoCo Systems Setup

Custom Installation

Server Installation

Single-user Installation


See also (Select Components dialog)
Custom Installation


See also (Select Installation directory dialog)
Custom Installation

Server Installation

Single-user Installation

Choose Working Directories dialog


See also (Select Program Group dialog)
Custom Installation

Server Installation

Single-user Installation


See also (Software Licence Agreement dialog)
Product Licence dialog


See also (Summary dialog)
Custom Installation

Server Installation

Single-user Installation


See also (Unattended Installation)
Custom Installation

Server Installation

Single-User Installation

Un-Installation


See also (Welcome dialog)
About CoCo Systems Setup

ReadMe File dialog


Misc. Popups
(dummy topic)


Program Group
A program group (Windows 3.1) or program folder (Windows 95) is a window containing icons that represent and allow you to run various types of applications and files. Program groups are part of the Windows Program Manager (under Windows 3.1) or the Start menu (for Windows 95).

For Setup to create a program group, you must have a Windows shell program that supports the programming interface necessary for installation programs to create and modify program groups. Apart from the Program Manager and the Start menu, many replacement shells such as Norton Desktop, PC Tools for Windows or Norton Navigator also provide this interface.


Registry (Registration Database)
The Windows 95 registry (or Windows 3.1 registration database) is a system wide source of information about applications. This information is used to support the integration of applications with the Windows File Manager (Windows 3.1) or Explorer (Windows 95) and with each other, and is also used, for instance, by applications that support object linking and embedding (OLE).


Response File
A file that specifies the installation choices to be made during an unattended installation. A response file is typically created by a network administrator to ease the process of installing a CoCo Systems product on multiple network client computers from a shared network server.

A response file is always named SETUP.RSP, and is placed in the product’s client setup directory on the network server.


SYSTEM.INI
SYSTEM.INI is a Windows 3.1 data file in the windows directory that contains Windows system initialisation information for your installation of Microsoft Windows®. The applications that use this file to hold initialisation information are the core Windows programs themselves and other system-level programs such as device drivers. Application programs should not normally make use of SYSTEM.INI to hold private initialisation information.

In Windows 95, SYSTEM.INI (and WIN.INI) is replaced by the Windows 95 Registry.


WIN.INI
WIN.INI is a Windows 3.1 data file in the windows directory that contains Windows application initialisation information for your installation of Microsoft Windows®. The applications that use this file to hold initialisation information include the Windows Program Manager and File Manager. Other applications will normally hold their private initialisation information in separate .INI files in the windows directory.

In Windows 95, WIN.INI (and SYSTEM.INI) is replaced by the Windows 95 Registry.