Situation

A deployment maintainer needs to install Flux on a host with the right Windows, IIS, PowerShell, SQL Server, and installer prerequisites.

Outcome

Flux installation work is treated as a repeatable Hive administration workflow instead of a role-section document. The durable site points administrators at the product capability and generated reference they need for setup work.

Prerequisites

  • Use a Windows Server host that can run PowerShell 7 and remain available for scheduled after-hours processing. The legacy installation baseline covered Windows Server 2012 through Windows Server 2022.
  • Install the supported PowerShell 7 runtime for the target Flux release. Existing Flux deployments commonly place the runtime under D:\Flux\Support\PowerShell.
  • Prepare a SQL Server database that the installation account can access with the ddladmin role so Flux can create configuration and logging tables.
  • Install SQL Server Native Client 11.0 when OGR bulk loading needs BCP support. The legacy download location is https://cdn.flux.mapdojo.com/public/sqlncli.msi.
  • Request the Flux installer link from support@mapdojo.com; installer links are license-gated and time limited.

Steps

  1. Confirm the supported Windows Server and PowerShell prerequisites for the target release.

  2. Confirm SQL Server connectivity, database permissions, and the required native client components.

  3. Enable the IIS features needed by the Hive application:

    dism /online /enable-feature /featurename:IIS-WebServerRole
dism /online /enable-feature /featurename:IIS-WebServer
dism /online /enable-feature /featurename:IIS-ApplicationDevelopment
dism /online /enable-feature /featurename:IIS-ApplicationInit
dism /Online /Enable-Feature /FeatureName:IIS-CGI
dism /online /enable-feature /featurename:IIS-IPSecurity

  4. Unlock the IIS IP security section when the environment needs it:

    cd C:\Windows\System32\inetsrv\
./appcmd.exe unlock config -section:system.webServer/security/ipSecurity

  5. Run the Flux installer for the target environment.

  6. Use the generated PowerShell reference for repeatable environment commands.

Implementation Evidence

  • Flux/PowerShell/Config/
  • Flux/Hive/Hive.Infrastructure.Configuration/
  • Docs/Generated/PowerShell/New-FluxHiveEnvironment.mdx