To run the AppClarity installer in unattended mode and create a installation log in a specific location, use the following command-line notation, where a combination of the properties listed on this page can be used.

> msiexec /i AppClarity.msi /q <AppClarity installer properties> /L*xv "C:\Windows\temp\AppClarity-Install.log"

For example, the following properties are the minimum required for unattended installation because they are mandatory and their defaults are , all other properties can use defaults, assuming a local SQL Server.

> msiexec /i AppClarity.msi /qb PIDKEY=<LicenseKey> COMPANYNAME=<Name> AESERVERNAME=<AE Server> SQLSERVER=<SQL Server> CATALOGDATABASENAME=<DB Name> CATALOGSQLSERVER=<Catalog SQL Server> /L*xv  "C:\Windows\temp\AppClarity-Install.log"

Common

Catalog

Console installer

Database

Service

Software Reclaimer

 

The table details the command line arguments for the AppClarity installer

SwitchDefault valueDescription
ADDLOCAL
All

Recommended to leave this blank, which will install all features.

To install one or more features separately, specify a comma-separated list of feature names:

    • Service – installs the AppClarity service component
    • Console – installs the legacy console
    • ConsoleInstaller – installs the ClickOnce console installer website
    • Database – installs the database component (
    • SoftwareReclaimer – installs the Software Reclaimer component (source files that you can copy later to create Reclaimer package)
The values for ADDLOCAL are case sensitive and must be used as above.
AESERVERNAME
 

NetBIOS name of the server hosting ActiveEfficiency but localhost can be used if ActiveEfficiency is installed on the same server as AppClarity.

You must use the NetBIOS name of the ActiveEfficiency server as there is currently a known issue relating to using the FQDN for servers that requires a manual to the AppClarity configuration files to resolve this. Please contact 1E support for details.
CATALOGDATABASENAME
1ECatalogDatabase name of the 1E Catalog database.
CATALOGSQLSERVER
 

Connection details for the SQL Server instance that hosts the 1E Catalog database.

This can be defined in the following formats:

    • localhost – uses the local default instance
    • ServerName – uses a remote server aw the default instance
    • ServerName\Instance – uses a remote server and named instance with reference to a dynamic port
    • ServerName,Port – uses a remote server and instance defined by its fixed port

When installing onto a clustered SQL instance, you need to use the ServerName\Instance format to locate it. For this to work, the domain administrator needs to have manually registered SPN for the SQL instance if the SQL Server is running under a domain user account.

CATALOGWEBURL
 WebServer name (where 1ECatalog website is hosted)

COMPANYNAME

 Name of your organization. This value is used in all AppClarity reports.

DATABASENAME

AppClarityName of the AppClarity database.
DROPOLDDB
DisabledDrops the existing AppClarity database before the installation takes place. If you want to keep your existing database, make a backup of it before installation regardless of the DROPOLDDB argument.
IISHOSTHEADER
 Host header for the ClickOnce website. Users will need to use this name when browsing to the site if used. You will also need to set the DNS to de-reference it form its IP address.
IISIPADDRESS
 IIS IP address for the ClickOnce website.
IISPORT
80IIS port for the ClickOnce website.
INSTALLDIR
C:\Program Files (x86)\1E\AppClarity
Installation directory for AppClarity.
LOGPATH
C:\ProgramData\1E\AppClarity
Path to the AppClarity log file.

PIDKEY

 AppClarity can support desktop and server software license management, each hardware type requires its own license key. Use this argument for desktop support. It does not come with a 30-day evaluation license. Contact sales@1e.com to obtain an evaluation key.

PLATFORMURL

  

RECLAIMERPIDKEY

 The license key to enable use of the AppClarity Software Reclaim feature.
SERVERPIDKEY
 AppClarity can support desktop and server software license management, each hardware type requires its own license key. Use this argument for server support.
SERVICELOCATION
 Location for the AppClarity service. Only used when installing the Console installer or the Legacy Console components.
SQLSERVER
local

Connection details for the SQL Server instance that hosts the AppClarity database.

This can be defined in the following formats:

    • localhost – uses the local default instance
    • ServerName – uses a remote server aw the default instance
    • ServerName\Instance – uses a remote server and named instance with reference to a dynamic port
    • ServerName,Port – uses a remote server and instance defined by its fixed port

When installing onto a clustered SQL instance, you need to use the ServerName\Instance format to locate it. For this to work, the domain administrator needs to have manually registered SPN for the SQL instance if the SQL Server is running under a domain user account.
SVCPASSWORD
 Password for the domain account to be used as the AppClarity service account. To keep the default network service account, do not not use this or the SVCUSER argument on the installer command-line.
SVCUSER
Network Service

Domain account to be used for the AppClarity service and must be in the following format:

Domain\User

To keep the default network service account, do not use this or the SVCPASSWORD argument on the installer command-line.