Installation Overview

On this page

An Alloy Navigator installation serves the Web App, the Self Service Portal, the Admin Center and the Settings App, the mobile apps, and the REST API. Each application is delivered differently, so the components you install and their locations vary. All applications work with one SQL Server database that stores configuration, workflow, and records.

The installation routes

Route How it runs What it produces
Advanced On the unified installer's Welcome page, choose Advanced Installation. For each target you choose, the installer checks that target's prerequisites and then starts that product's own setup program, one product at a time. A production installation, built component by component, on one or several machines
Evaluation On the Welcome page, choose Evaluation Installation. The installer runs a fixed, scripted sequence. A single-machine system with a sample database and fixed credentials
Unattended Command-line switches on each product's own installer; the unified installer is not used Only the components you name, with no configuration step
Cloud Alloy Software provisions the system; you install only local tools Hosted web applications, plus the Administrative Tools package installed on your computer

IMPORTANT: The evaluation route is for evaluation only. When it installs SQL Server Express, it sets the password of the SQL Server sa login to sa, enables TCP/IP and named pipes, sets the SQL Server Browser service to start automatically, and so makes the instance reachable from the network.

System Requirements lists the requirements for the on-premises routes. For the Cloud route, see Get Started with Alloy Navigator Cloud and Administering Alloy Navigator Cloud.

The unified installer

The unified installer is a launcher, not the product itself. It looks for each product's setup program in an Alloy Software folder beside itself. Every product name and version it shows is read from the setup programs it finds there, so it always shows the build that sits next to it.

Before it shows anything, the installer checks which of those products are already installed on the machine. When an installed product has a lower version than the setup program found, the whole session becomes an upgrade: the first option on the Welcome page reads Upgrade Existing Products instead of Evaluation Installation, and an evaluation run on such a machine behaves as an upgrade. The second option is always Advanced Installation.

An upgrade session does not proceed while an Alloy application is running on the machine, such as the Settings App, the Alloy Control Panel, the Automation Server Manager, the Database Management wizard, the Import wizard, the database backup tool, or the Web Configuration tool. The installer lists each running application with its file name and process ID and does not move on. It does not close them: close the applications yourself and try again. A fresh installation does not make this check, and neither do the product setups started from the Advanced page.

The prerequisites the installer checks depend on the route and on the target you choose, so a check that blocks one target is absent for another. System Requirements lists them.

The Advanced page groups its targets under Desktop Apps and Server Components, Web Services, and Other Software:

  • Desktop Apps and Server Components holds Alloy Navigator and Alloy Discovery. Alloy Discovery is a separate product, and its target starts that product's own setup program.
  • Web Services holds Web App, Self Service Portal, and API.
  • Other Software holds Microsoft SQL Server 2017 Express Advanced, described as "Installs the database engine if you do not have a SQL server to host the product's database." It starts Microsoft's own SQL Server setup with no preset options: the setup's prompt for an extraction folder and the SQL Server Installation Center, including the choice of authentication mode, are yours to complete. The unified installer stays on the Advanced page.

Where the components go

Application Primary audience How it is delivered
Web App Technicians An IIS application, installed from its own package
Self Service Portal End users An IIS application, installed from its own package
Admin Center Administrators Ships inside the Web App package, not as a package of its own
Settings App Administrators A Windows application, installed with the Administrative Tools
Mobile apps Technicians and end users Distributed through the app stores; nothing is installed on the server
REST API Integrations and the mobile apps An IIS application, installed from its own package

Three mobile apps are available, for Android and iOS: Alloy Navigator for technicians, Alloy Self-Service for end users, and Alloy Inventory Scanner for physical inventory. They are separate products, and no server package installs them. Each reaches the server through the REST API, which must be configured for Access Token authentication. When the URL entered in an app answers with a Windows authentication challenge, the app shows "Make sure the URL points to Alloy Navigator API configured for Access Token authentication".

The server side of an installation consists of these parts:

  • Automation Server: the one Windows service the installer registers. It runs scheduled and triggered work, doing part of it itself and handing the rest to separate job executables: the Mail Connector, Active Directory Import, the Data Archiving Service, the Scheduled Task Agent, and the Alloy Discovery and AlloyScan connectors.
  • Web applications: the Web App, Self Service Portal, and API packages install templates, not running sites. The Web Configuration tool turns each template into an IIS application.
  • Database: the SQL Server database. The Database Management wizard is the only supported way to create it.
  • Administrative Tools: the Settings App, the Database Management wizard, the Import wizard, and a database backup tool.
  • Reporting components: a report viewer, a standalone reporting command, and a report engine.

When you install the Alloy Navigator package interactively, the setup type you choose on its Setup Type page decides what that machine gets. Client, the default, installs Settings and Database Tools without the Automation Server and its job executables. Server and Full (Client and Server) add the Automation Server and its job executables. A silent installation ignores the setup type: it installs every component of the package unless its command line names the components to install.

The Administrative Tools are also available as a standalone package. It installs the Alloy Control Panel, Settings, Active Directory Import, the Scheduled Task Agent, the Import wizard, and the reporting engine, without the Automation Server and without the Database Management wizard. The Administrative Tools package and the full Alloy Navigator package cannot share a computer.

Every Alloy Navigator component also installs the Alloy Control Panel. It lists what is actually present on that machine: Settings, Database Management, Import, the Automation Server Manager, the Web Configuration tool, and each published web application. A component whose file is missing does not appear in it.