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.