# Upgrading Process Description

## Upgrade Definition

New versions of the existing ToolsTalk 2 installations on computer shall search for existing installations and decide if the installation should act like an upgrade or fresh installation. MSI specific rule set shall be executed to decide if the installation is an upgrade or fresh installation.

Through version numbers it can be determined if an upgrade is a Major upgrade or Minor upgrade

Example: 2.21.2 to 2.21.3 is a Minor upgrade but 2.21 to 2.22 is a Major upgrade. This difference is only important for database upgrade operations. During Minor upgrades database upgrade is not necessary so operation shall not occur.

## InstallShield

As common in all installation types mentioned in section in, Installation Types assemblies in system shall be upgraded with newer versions.

Depending on installation type, the following operations shall be performed in addition to updating assemblies:

- FMS Uninstall and Re-install (see section Installation Process Description to see which setup type installs FMS assemblies)

- Database migration (during Server and ServerClickOnce installation)

## Database Migration

During installation of Server and ServerClickOnce packages, Database migration operation shall start to upgrade the database of ToolsTalk 2 application. This operation is only executed during Major upgrades.

## Installation Configurator

Modification of following configurations are enabled by installation configurator:

- ToolsTalk 2 SQL database settings

  - SQL server address

  - ToolsTalk 2 database name

  - Database installation

- ToolsTalk 2 server settings

  - Authentication mode

  - Active directory to be used by Windows authentication

  - ToolsTalk 2 server address

  - ToolsTalk 2 server web application port

  - Enable HTTPS

  - Server Authentication Certificate

  - Controller port

  - Setting for converting service URL to IP address

  - Power Focus Web Server: alternative port

  - ClickOnce: certificate (optional)

- ToolsTalk 2 backup settings

  - Controller backup folder

- ACDC settings

  - ACDC server address

  - ACDC WebAPI port

  - ACDC SignalR port

  - Exchange Server settings

    - Validate

    - Use ACDC Configuration

- FMS settings

  - Get host ID Information

  - Default host ID

  - List of available host IDs

  - Active host ID

  - Update Active host ID

  - Last used active host ID

  - Possibility to change active host ID

Some of above settings and configurations may not be available for different versions of ToolsTalk 2.

When user modifies the configuration, the modification is applied by selecting the Save button. When saving the configurations, the Installation Configurator will

1. Update related config files with new values

2. Store a copy of all settings locally in a file named Storage

3. Start ToolsTalk 2 server to get the new configuration changes

At startup, the installation configurator always compares the configuration stored in storage file and config files exists at installation folder. If they differ, then it asks the user to choose which one should be loaded in installation configurator. When you select the Save button, both storage and config files in installation folder will get the same settings and configuration.

Relevant Information

- Installation and Upgrades