Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

PropertyDefaultMandatoryDescription

Anchor
ACTIVE_DIRECTORY_SERVER
ACTIVE_DIRECTORY_SERVER
ACTIVE_DIRECTORY_SERVER

GC://Yes


Multiexcerpt
MultiExcerptNameACTIVE_DIRECTORY_SERVER

Sets how the Tachyon Server queries Active Directory. The choice is between GC and LDAP methods.

Multiexcerpt
MultiExcerptNameGC_LDAP_Methods


GC method

Required if Tachyon users or groups exist in multiple domains or multiple trusted forests.

Supports only Universal security groups.

LDAP method

All Tachyon users and groups must exist within a single domain.

Supports Universal and Global security groups.

Required if a Global Catalog (GC) server does not exist in any trusted domain, or if Global AD Security groups must be used.

In either case, any domain(s) which contain Tachyon users and groups must be:

  • trusted by the domain in which the Tachyon Server exists
  • resolvable using DNS from the Tachyon Server

When using the GC method, specify GC:// alternatively you can specify GC://<domain> using the FQDN of any trusted domain, e.g. GC://acme.local. Specifying a domain does not matter because Tachyon uses it to locate the AD forest's root domain; and omitting the domain allows serverless binding to AD to achieve the same thing.

When using the LDAP method, specify LDAP://<domain> using the FQDN of the domain which contains all the Tachyon user accounts and groups, e.g. LDAP://acme.local

The Coordinator Workflow module queries AD for email details of Tachyon users, and the Consumer API queries AD for security details of Tachyon users to support Role-Based Access Control.


Anchor
ADDLOCAL
ADDLOCAL
ADDLOCAL

ALLNo

Default is ALL when installing all components on a single-server. The following components (MSI features) are selected when installing a Master Stack, Response Stack and Custom configuration. Names are delimited by a comma and are case-sensitive.

Master StackResponse Stack
  • ConfigurationViewer
  • Coordinator
  • Consumer
  • Database_EXPERIENCE
  • Database_MASTER
  • Experience
  • Portal
  • SSASDatabase_EXPERIENCE
  • Background
  • Core
  • CoreInternal

  • Database_RESPONSES
  • Switch

Specifying Portal or Experience does not install Tachyon applications, but are required in order for relevent appliactions to work. Tachyon applications are installed separately by Tachyon Setup.

Anchor
DEVICECOUNT
DEVICECOUNT
DEVICECOUNT

1000No

This is the number of devices supported by the Tachyon server which is being installed.

Multiexcerpt
MultiExcerptNameDEVICECOUNT

The number of devices supported by a Tachyon Server determines the number of Switches configured on the server.

The range is 1 to 250,000; default is 1,000.

A single server with suitable resources can support up to five Switches and up to 250,000 devices, with each Switch supporting up to 50,000 devices. Additional servers or configuration may be required according to the design of the Tachyon system. The total number of devices supported across the Tachyon system must not exceed the license file allocation.


Anchor
DROPOLDDB_EXPERIENCE
DROPOLDDB_EXPERIENCE
DROPOLDDB_EXPERIENCE

0No


Multiexcerpt
MultiExcerptNameDROPOLDDB_EXPERIENCE

If set to 1 then the installer will drop the Tachyon Experince database and attempt to create a new database. To create the database requires the server installation account has sysadmin rights on the SQL Server instance SQLSERVER_MASTER.

If set to 0 (default) then the installer will keep the existing Tachyon Responses database. This requires the installation account has db_owner rights on the database. This setting is used in the following scenarios.

  • For a new installation and an empty database has been pre-created.
  • When the database has been restored and Tachyon is being re-installed either during a recovery, or because the database has been moved to a new SQL Server instance.
  • Upgrading.


Anchor
DROPOLDDB_MASTER
DROPOLDDB_MASTER
DROPOLDDB_MASTER

0No


Multiexcerpt
MultiExcerptNameDROPOLDDB_MASTER

If set to 1 then the installer will drop the Tachyon Master database and attempt to create a new database. To create the database requires the server installation account has sysadmin rights on the SQL Server instance SQLSERVER_MASTER.

If set to 0 (default) then the installer will keep the existing Tachyon Responses database. This requires the installation account has db_owner rights on the database. This setting is used in the following scenarios.

  • For a new installation and an empty database has been pre-created.
  • When the database has been restored and Tachyon is being re-installed either during a recovery, or because the database has been moved to a new SQL Server instance.
  • Upgrading.


Anchor
DROPOLDDB_RESPONSES
DROPOLDDB_RESPONSES
DROPOLDDB_RESPONSES

0No


Multiexcerpt
MultiExcerptNameDROPOLDDB_RESPONSES

If set to 1 then the installer will drop the Tachyon Responses database and attempt to create a new database. To create the database requires the server installation account has sysadmin rights on the SQL Server instance SQLSERVER_RESPONSES.

If set to 0 (default) then the installer will keep the existing Tachyon Responses database. This requires the installation account has db_owner rights on the database. This setting is used in the following scenarios.

  • For a new installation and an empty database has been pre-created.
  • When the database has been restored and Tachyon is being re-installed either during a recovery, or because the database has been moved to a new SQL Server instance.
  • Upgrading.


Anchor
EXTERNALIISHOSTHEADER
EXTERNALIISHOSTHEADER
EXTERNALIISHOSTHEADER

TACHYON.<DomainFQDN>

Yes


Multiexcerpt
MultiExcerptNameEXTERNALIISHOSTHEADER

Sets the host header used by the HTTPS binding of the Tachyon Website. This must be the same as the DNS Alias FQDN.


Multiexcerpt
MultiExcerptNameEXTERNAL

EXTERNALIISHOSTHEADER and HTTPSIISPORT configure the HTTPS binding that uniquely identifies the Tachyon Website used by the following:

  • Browsers connection to the Explorer (Explorer and Admin)
  • Tachyon clients retrieving Tachyon content from the Background Channel
  • Internal Tachyon services


Anchor
HTTPSIISPORT
HTTPSIISPORT
HTTPSIISPORT

443Yes


Multiexcerpt
MultiExcerptNameINTERNALIISHOSTHEADER

Sets the port used by the HTTPS binding of the Tachyon Website.

Multiexcerpt include
MultiExcerptNameEXTERNAL
PageWithExcerptTachyon Server installer properties

Anchor
IISIPADDRESS
IISIPADDRESS
IISIPADDRESS

*Yes


Multiexcerpt
MultiExcerptNameIISIPADDRESS

Sets the IP Address used by the HTTP and HTTPS bindings of the Tachyon Website.

The default value of * sets IIS to listen on all IP addresses. On multihomed servers with multiple IP addresses you may optionally set this value, but in general we recommend leaving this as * to bind to all IP addresses.

If this value is set it must correspond to one of the IP addresses configured for the DNS Alias FQDN.


Multiexcerpt
MultiExcerptNameINTERNAL

INTERNALIISHOSTHEADER, IISIPADDRESS and IISPORT configure the HTTP binding that uniquely identifies the Tachyon Website used by Tachyon Switches to forward responses from Tachyon clients to the Tachyon Core web application. This is the only Tachyon web application that permits HTTP, as the other web applications are all configured to require SSL.can be used to access IIS web applications that are not configured to Require SSL, for example ActiveEfficiency, CoreExternal and CatalogWeb. Please refer to Server installation issues: Verify IIS Configuration for configuration details of IIS web applications.


Anchor
IISPORT
IISPORT
IISPORT

80Yes


Multiexcerpt
MultiExcerptNameIISPORT

Sets the port used by the HTTP binding of the Tachyon Website.

Multiexcerpt include
MultiExcerptNameINTERNAL
PageWithExcerptTachyon Server installer properties

Anchor
INSTALLDIR
INSTALLDIR
INSTALLDIR

%ProgramFiles%\1E\Tachyon\No

Sets the installation folder for all the Tachyon components.

For a non-default installation please refer to Preparation: Services and NTFS Security.

Anchor
INTERNALIISHOSTHEADER
INTERNALIISHOSTHEADER
INTERNALIISHOSTHEADER

<HOSTNAME>.<DomainFQDN>

Yes


Multiexcerpt
MultiExcerptNameINTERNALIISHOSTHEADER

Sets the host header used by the HTTP binding of the Tachyon Website. This should be the hostname FQDN of the Tachyon Server.

Multiexcerpt include
MultiExcerptNameINTERNAL
PageWithExcerptTachyon Server installer properties

Anchor
LICENSEFILEPATH
LICENSEFILEPATH
LICENSEFILEPATH


Yes (UI)

No (command-line)

The full path, including the file name, must be provided for a valid Tachyon license file.

Multiexcerpt include
MultiExcerptNameLicenseFile
PageWithExcerptRequirements

Anchor
LOGPATH
LOGPATH
LOGPATH

%AllUsersProfile%\1E\Tachyon\

No

Sets the path to the Tachyon server log files. It does not set the filename of each log.

See Log files for more details.

For a non-default installation please refer to Preparation: Services and NTFS Security.

Warning

Not supported by Tachyon Setup. If you need to change the default location, please contact 1E.


Anchor
MAILFROM
MAILFROM
MAILFROM


Yes


Multiexcerpt
MultiExcerptNameMAILFROM

Sets the mail-from email address used by the Tachyon Server when it sends emails.

For guidance about the Mail-From address see Requirements: Email Requirements.


Anchor
SERVERCERTIFICATETHUMBPRINT
SERVERCERTIFICATETHUMBPRINT
SERVERCERTIFICATETHUMBPRINT


No


Multiexcerpt
MultiExcerptNameSERVERCERTIFICATETHUMBPRINT

Used by Tachyon Setup to uniquely identify which certificate was selected by the user for use by Tachyon components. Tachyon Setup uses the selected certificate to create the Switch certificate files, and then passes the certificate's thumbprint to the Tachyon installer to complete the installation.

If you are using the installer with command-line properties, instead of Tachyon Setup, then you can optionally specify a certificate's thumbprint. You will also need to manually create the Switch certificate files using the same certificate.

Code Block
SERVERCERTIFICATETHUMBPRINT=3d699d8f28c2d7e0514cb0e047a1fd2f9db9bf4f

If you are using the installer instead of Tachyon Setup, and do not specify a thumbprint property in the command-line, the Tachyon installer will automatically select the first suitable certificate it finds in the server's Personal certificate store. In which case you must ensure there is only one suitable certificate, otherwise you may find Switches, and the bindings for the website and coordinator using different certificates. See Server installation issues: Verify the Tachyon website HTTPS binding for details of how to change bindings after installation.

See Requirements: Tachyon Server Certificates for requirements.


Anchor
SMTPENABLED
SMTPENABLED
SMTPENABLED

1No


Multiexcerpt
MultiExcerptNameSMTPENABLED

Determines whether Tachyon uses email for notifications.

If email is disabled then so is two-factor authentication which relies on email.

For guidance about using non-default SMTP settings, see Requirements: Email Requirements.

If email notifications need to be disabled after installation, then see Tachyon Server post-installation tasks: Changing the SMTP Host configuration.

If set to 1 then email is enabled.

If set to 0 then the following are disabled:

Anchor
SMTPPORT
SMTPPORT
SMTPPORT

25No


Multiexcerpt
MultiExcerptNameSMTPPORT

Sets the port used to connect to the SMTP relay/gateway

Default is 25.

If the port needs to be changed after installation, then see Tachyon Server post-installation tasks: Changing the SMTP Host configuration.


Anchor
SMTPSERVER
SMTPSERVER
SMTPSERVER


Yes


Multiexcerpt
MultiExcerptNameSMTPSERVER

Sets the FQDN of the SMTP relay/gateway.

If the FQDN needs to be changed after installation, then see Tachyon Server post-installation tasks: Changing the SMTP Host configuration.


Anchor
SQLSERVER_EXPERIENCE
SQLSERVER_EXPERIENCE
SQLSERVER_EXPERIENCE

(local)Yes


Multiexcerpt
MultiExcerptNameSQLSERVER_EXPERIENCE

Sets the name for the SQL Server instance that hosts the Tachyon Experience database.

Multiexcerpt
MultiExcerptNameSQLSERVER_Instance

This can be set in one of the following formats depending on the setup of the instance.

Code Block
(local)
ServerName
ServerName,PortNumber
ServerName\InstanceName
ServerName\InstanceName,PortNumber




Anchor
SQLSERVER_MASTER
SQLSERVER_MASTER
SQLSERVER_MASTER

(local)Yes


Multiexcerpt
MultiExcerptNameSQLSERVER_MASTER

Sets the name for the SQL Server instance that hosts the Tachyon Master database.

Multiexcerpt include
MultiExcerptNameSQLSERVER_Instance
PageWithExcerpt@self


Anchor
SQLSERVER_RESPONSES
SQLSERVER_RESPONSES
SQLSERVER_RESPONSES

(local)Yes


Multiexcerpt
MultiExcerptNameSQLSERVER_RESPONSES

Sets the name for the SQL Server instance that hosts the Tachyon Responses database.

Multiexcerpt include
MultiExcerptNameSQLSERVER_Instance
PageWithExcerpt@self


Anchor
SSASDROPDB_EXPERIENCE
SSASDROPDB_EXPERIENCE
SSASDROPDB_EXPERIENCE


0No


Multiexcerpt
MultiExcerptNameSSASDROPDB_EXPERIENCE

If set to 1 then the installer will drop the Tachyon Experience cube and attempt to create a new cube. To create the cube requires the server installation account has sysadmin rights on the SQL Server Analysis Service instance SSASSERVER_EXPERIENCE.

If set to 0 (default) then the installer will keep the existing Tachyon Experience cube.


Anchor
SSASSERVER_EXPERIENCE
SSASSERVER_EXPERIENCE
SSASSERVER_EXPERIENCE

(local)Yes


Multiexcerpt
MultiExcerptNameSSASSERVER_EXPERIENCE

Sets the name for the SQL Server Analysis Service instance that hosts the Tachyon Experience cube.

Multiexcerpt
MultiExcerptNameSSAS_Instance

This can be set in one of the following formats depending on the setup of the instance.

Code Block
(local)
ServerName
ServerName:PortNumber
ServerName\InstanceName
ServerName\InstanceName:PortNumber




Anchor
STARTCOORDINATOR
STARTCOORDINATOR
STARTCOORDINATOR

1NoFlag indicating if the Coordinator service should be started after installation.

Anchor
STARTSWITCH
STARTSWITCH
STARTSWITCH

1NoFlag indicating if the Switch Host service should be started after installation.

Anchor
TWOFACTORAUTHENABLED
TWOFACTORAUTHENABLED
TWOFACTORAUTHENABLED

1No


Multiexcerpt
MultiExcerptNameTWOFACTORAUTHENABLED

Determines whether Tachyon uses two-factor authentication.

If email is disabled then so is two-factor authentication which relies on email.

See Requirements: Two-factor Authentication Requirements.

Default is same as SMTPENABLED.

Anchor
WORKFLOWWEBPORT
WORKFLOWWEBPORT
WORKFLOWWEBPORT

8080No


Multiexcerpt
MultiExcerptNameWORKFLOWWEBPORT

Sets the port used by HTTPS binding of the Coordinator Workflow module. This is separate from the Tachyon Website.

Tachyon Setup suggests 8081 by default, and should not need to be changed.


Info

TachyonServer.msi installer defaults to 8080 if the WORKFLOWWEBPORT parameter is not provided. Tachyon Setup uses 8081 to avoid conflict with HTTP port 8080 which is the default used by SLA Platform 3.3 and earlier versions.


...