Any2Info Installer

Category: Installer

Version: 1.0

Last Updated: November 19, 2025

Author: Any2Info

1. Overview

The Any2Info Installer is a setup wizard designed to easily install and update all components of the Any2Info platform.

It supports both new installations and updates of existing environments.

With the installer, you can:

  • Perform a full installation (IIS packages, databases, and Datahub)

  • Update only the database

  • Install or update only the Datahub

  • Upgrade an existing environment to a newer version

The wizard guides the user step by step, checks dependencies, and automatically runs the required update scripts and configurations.

Tip: The installer remembers installations based on a chosen name (e.g., Test, Production, Datahub).

By selecting the same name later, you can easily update or modify that specific installation.


2. System Requirements

2.1. Operating System & Permissions

Requirement
Minimum Specification

Windows Server

2016 or higher

Administrator Rights

Must be run as Administrator

Disk Space

Minimum 2 GB for installation files (excluding databases)

Network Ports

Port 443 (HTTPS) or a custom port

SSL Certificate

Required for IIS installations

2.2. Frameworks & Runtimes

Component
Required Runtime

IIS Packages

.NET 9 Desktop Runtime + .NET 9 Hosting Bundle

Database Update

.NET 9 Desktop Runtime

Datahub

.NET Framework 4.8 (alongside .NET 9)

2.3. Database

Requirement
Specification

SQL Server

Version 2014 or higher

Authentication

SQL login (Windows authentication not supported)

Permissions

- sysadmin when creating new databases- db_owner sufficient for updates

2.4. IIS (Internet Information Services)

Component
Requirement

Modules

ASP.NET, HTTP Initialization

Web Server Version

IIS 10.0 or higher

SSL Certificate

Required for IIS-based web services

2.5. Additional Information

  • The installer automatically creates backups before performing updates.

  • For Datahub installations as a Windows Service, IIS is not required — only .NET Framework 4.8 and an available port.

  • The installer can be run offline if all installation files are locally available.


3. Using the Any2Info Installer (Setup Wizard)

The Any2Info Installer includes a graphical Setup Wizard that guides you through each step.

3.1. Step 1 – Installation Profile & Component Selection

Installation Profile

When launching the installer, enter a name for your installation (e.g., test, production, datahub).

This name is used to save parameters for later reuse.

Component Selection

Option
Description

IIS Packages

Installs all web services required to run the Any2Info application

Database Update

Required when installing IIS Packages; can also be used separately

Datahub

Installs the Any2Info Datahub, with selectable installation methods

Datahub Installation Methods

Method
Description

Virtual Application (default)

Installs the Datahub as part of the same IIS website

IIS Website

Installs the Datahub as a separate IIS website

Windows Service (legacy)

Installs the Datahub as a Windows Service (e.g., on an edge device)


3.2. Step 2 – IIS Configuration (for IIS Packages only)

Setting
Description

Installation Path

Directory where the web application will be installed

App Service Name

Display name in the mobile app (often customer name + environment)

Version Number

Informational field showing the version being installed


3.3. Step 3 – Database Configuration

Database Connection

Enter a valid SQL Server connection string.

A SQL login is required — Windows authentication is not supported.

Available Buttons

Button
Function

Test Connection

Tests the SQL Server connection

Load Databases

Loads available databases into four dropdowns

Database Types

Type
Description

Main Database

Configuration info and form data

Document Database

Stores documents, images, and attachments

Engine Database

Caches push dataclips and dataclip logs

Logging Database

Application logging and request tracing

Update Scripts Folder

Default: installation directory (can be changed for custom setups).


3.4. Step 4 – Application Pools (IIS Packages)

Each web service receives its own application pool.

You can specify a prefix to support multiple installations on the same server (e.g., ACME-Test-AuthorizationService).


3.5. Step 5 – Website Configuration (IIS Packages)

Setting
Description

IIS Website

Select or create a website

Port Number

Unique port for the site

Overwrite Landing Page

Replaces the existing homepage during installation

Advanced Installation Options

Option
Description

Install as On-Demand Pools

Starts pools only when accessed, reducing load

Overwrite Client IDs

Keeps existing OAuth Client IDs (useful for dev environments)


3.6. Step 6 – Datahub Settings

Virtual Application

Specify only the installation path.

IIS Website

Provide DNS name, SSL certificate, port, and installation folder.

Windows Service (legacy)

Specify service name, installation folder, start mode (automatic/manual), and port.

SSL details are optional unless HTTPS is used.


3.7. Step 7 – User Management

  • During a new installation, at least one admin user must be created.

  • This step can also be used to create a new account if access is lost.


3.8. Step 8 – Summary & Installation

Review the summary and click Install.

The installer displays real-time progress and begins by creating a backup of the current installation.

After completion, a confirmation message appears and the installer can be closed.


4. Logging & Error Handling

4.1. Logging

  • Real-time logs are displayed during installation.

  • Full logs are stored at:

[InstallerFolder]\\Logs\\

4.2. Common Errors

Error Message
Cause
Solution

File in use

Files still in use despite stopped pools

Restart the installer or close open files

Database connection failed

Invalid SQL connection or server unreachable

Check the connection string and SQL login

Access denied

Installer not run as Administrator

Restart with admin privileges

Port already in use

Port is occupied by another service

Choose a different port or stop the conflicting service

Certificate not found

SSL certificate missing

Verify certificate under Local Machine → Personal


5. Troubleshooting & Support

  • Logs are always located in the Logs folder.

  • Verify that all dependencies (.NET, IIS, SQL) are installed.

  • Ensure the port is available.

  • Confirm you have sufficient permissions.

  • Rollback: In case of failed updates, manually restore from the automatic backup.

For further assistance, contact the Any2Info support team via Teams or Jira.


6. Changelog

Version
Date
Changes

1.0

November 19, 2025

Initial documentation version added.

Last updated