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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.any2info.com/any2info-academy/quick-start/any2info-installer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.