# 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://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. |