Summary

Using the Tachyon Setup wizard to check prerequisites, configure, install and verify Tachyon Server. To make the process of installing Tachyon Server easier, the Tachyon Setup wizard aims to help you:

  • Prepare for a successful deployment of Tachyon Server
  • Find online resources for Tachyon
  • Configure prerequisites
  • Create the Tachyon Server certificate for use with the Tachyon Server website and the Tachyon Switch
  • Deploy selected components as well as any patches provided for them under the Installers\Patches folder. 

    If the Installers\Patches folder does not exist you will need to create it manually.

    You must not rename the extracted patch MSP files from 1E when placing them in the Installers\Patches folder.

  • Perform post-installation tasks, including configuring the components for interaction with each other
  • Running validation tests on the completed installation

Required installation files

The TachyonPlatform zip file can be downloaded from 1E Support Portal (1eportal.force.com/s/tachyontopicdetail). Extracting the zip will create a folder structure containing the following, where highlighted files are required by Tachyon Setup.

  • Licenses.txt
  • Tachyon Release Information.html
  • Tachyon.Setup.exe

Please refer to:

  • Tachyon Setup, for detailed information about each screen in Tachyon Setup
  • Quick Start if you want a brief overview of installing Tachyon.

Tachyon Setup is the only supported method of installing a Tachyon Server. Installation using standalone MSI is not supported unless advised by 1E, which may be necessary in complex installations, using non-interactive (quiet/silent) command-lines, and may require post-install configuration steps.

  • Installers\1ECatalog.msi (2.0.0.296)
  • Installers\ActiveEfficiencyServer.msi (1.10.100.10)
  • Installers\SLA.BI.Installer.msi (3.2.0.303)
  • Installers\SLA.Platform.Installer.msi (5.0.0.20)
  • Installers\TachyonServer.msi (5.0.0.592)
  • Installers\TachyonToolkit.msi (5.0.0.592)

1E may make available accumulated hotfixes (as MSP files) for the installers supported by Tachyon Setup. You should download the latest accumulated hotfixes before running Tachyon Setup.

For each product included in Tachyon Setup, you should check the 1E Support Portal (1eportal.force.com/s/article/LatestHotfixes) and download the latest Accumulated Hotfix zip (if any). Ensure you download the correct version.

If any installer MSI has a corresponding Accumulated Hotfix zip, then extract the MSP file and place it the Installers\Patches folder.

If the Installers\Patches folder does not exist you will need to create it manually.

You must not rename the extracted patch MSP files from 1E when placing them in the Installers\Patches folder.

Remove older MSP files leaving only the latest for each product (if any).

Please read the readme included in the ZIP in case there are any special installation instructions. If in doubt, apply the MSP manually after installation, following the instructions in the readme.

  • Installers\Patches\*
  • Installers\Apps\Experience\Experience.zip
  • Installers\Apps\Experience\metadata.json
  • Installers\Apps\Explorer\Explorer.zip
  • Installers\Apps\Explorer\metadata.json
  • Installers\Apps\GuaranteedState\GuaranteedState.zip
  • Installers\Apps\GuaranteedState\metadata.json
  • Installers\Apps\Inventory\Inventory.zip
  • Installers\Apps\Inventory\metadata.json
  • Installers\Apps\PatchSuccess\metadata.json
  • Installers\Apps\PatchSuccess\PatchSuccess.zip
  • Installers\Apps\Settings\metadata.json
  • Installers\Apps\Settings\Platform.zip

This folder contains Tachyon consumer applications that will be installed by Tachyon Setup if their prerequisites are met.

If you do not want to install a Tachyon consumer application, then delete the folder before running Tachyon Setup.

Later, if you need to install the Tachyon consumer application then you can reinstate the folder and install the app using Tachyon Setup as described in Tachyon Setup: Applications maintenance.

  • ProductPacks\Newtonsoft.Json.dll
  • ProductPacks\Tachyon.ProductPackDeploymentTool.exe
  • ProductPacks\Tachyon.ProductPackDeploymentTool.exe.config
  • ProductPacks\Tachyon.SDK.Consumer.dll
  • ProductPacks\Classic\1E-ConfigMgrConsoleExtensions.zip
  • ProductPacks\Classic\1E-Explorer-TachyonAgent.zip
  • ProductPacks\Classic\1E-Explorer-TachyonCore.zip
  • ProductPacks\Classic\1E-Inventory.zip
  • ProductPacks\Classic\1E-Patch-Success.zip
  • ProductPacks\Classic\1E-Tachyon-Platform.zip
  • ProductPacks\Integrated\MSSCCMClientHealth.zip
  • ProductPacks\Integrated\NomadClientHealth.zip
  • ProductPacks\Integrated\TachyonCore.zip
  • ProductPacks\Integrated\WindowsClientHealth.zip

These Product Packs are required to support various Tachyon features, for more detail please refer to Tachyon Product Packs reference. If your license permits, you can use additional Product Packs available from Tachyon Exchange (tachyonexchange.1e.com) to meet specific use-cases.

Classic Product Packs

Contain instructions, for use in Explorer and other Tachyon applications.

They can be uploaded using the Tachyon Product Pack deployment tool , or using Settings→Instructions→Instruction sets page in the Tachyon Portal.

Integrated Product Packs

Contain policies, rules and fragments for use by Guaranteed State, and may also include instructions.

They can only be uploaded using the Tachyon Product Pack deployment tool .

The Tachyon Product Pack deployment tool can be started independently, or at the end of the Tachyon Setup process via the Quick Start: Post-installation checks screen, where the screen contains a link that launches the tool. The Tachyon Setup method of starting the tool is recommended because Tachyon Setup ensures you have the correct permissions to upload the Product Packs.

Before Tachyon 5.0, Product Packs were provided as a separate TachyonProductPacks zip file, which you had to download separately and place in the right location for importing into Tachyon. Now they are included in the TachyonPlatform zip file so that the tool and packs can be found by Tachyon Setup.

You should also have access to the location for the Tachyon.lic file provided with your Tachyon purchase or evaluation.

Tachyon Setup is the only supported method of installing a Tachyon Server. Installation using standalone MSI is not supported unless advised by 1E, which may be necessary in complex installations, using non-interactive (quiet/silent) command-lines, and may require post-install configuration steps.

On this page:

If you are already familiar with earlier versions of Tachyon Setup

From Tachyon version 4.0 onward, the Tachyon release includes several applications bundled together, which were previously delivered and installed separately.

While these separate installers are still provided under an Installers folder inside the release .zip file, it is not recommended launching them individually. Instead, Tachyon.Setup.exe has been updated to provide a wrapper around the separate .msi installers. Tachyon.Setup presents a sequence of screens where it gathers configuration information, which in many cases is common to more than one installer, and then launches each individual installer with the appropriate parameters. It captures an installation log for each installer, as well as for the Tachyon.Setup executable itself, and then presents a final summary and performs some post-installation configuration tasks.

Running the Tachyon.Setup installer provides some functionality that is not available from the individual .msi installers:

  • It performs a check for prerequisites and, in most cases, it can install any that are missing.
  • While gathering configuration information, it can perform several validations on the information that you enter.
  • After installation is finished, it can perform several validations on all the installed components.
  • And, most importantly, after deploying the individual components, it can alter the configuration files and tables to fine-tune each component and connect the components to each other. If you were installing the individual .msi files these operations would have to be done manually after installation.

Running Setup

Logon to the server using the Server installation account.

To start the Tachyon Setup wizard double-click on Tachyon.Setup.exe. It will then display the following screens, you may go directly to any screen by clicking on the list on the left side of the wizard, but for best results we recommend that you follow these in the order they are presented.

Welcome

This screen provides the version number for Tachyon and outlines what the wizard will do.

It also examines the system for installed versions of the components and displays warning messages in case any of them cannot be upgraded to the versions that you are currently installing.

Click Next to go to the next screen.

Tachyon Welcome

Documentation

This screen provides links to several online resources that provide additional information about how to use and configure Tachyon.

LinkDescription
About TachyonLinks to the Tachyon page on the 1E website.

Main documentation page

Links to the Welcome page for this documentation on the help.1e.com website.
Tachyon ForumLinks to the Tachyon Forum where you can find technical resources, such as: troubleshooting and FAQs.
Tachyon ExchangeLinks to the Tachyon Exchange where you can find 1E and community-supported Tachyon product packs to supplement the Tachyon Product Packs included in Tachyon Platform download zip.

Once you've finished investigating the online resources, click Next to go to the next screen.

License agreement

You must read and then accept this license information by checking the I accept the terms in the license agreement checkbox. If you continue with the setup without checking the link to this screen will be highlighted in red and you won't be able to install until it is checked.

Click Next to go to the next screen.

License File

On the License File field page you must enter the path to a valid 1E license file for Tachyon, obtained from 1E. You can also click Browse to locate the file using a standard file browser.

1E will provide you with a Tachyon.lic license file that defines the products and features your Tachyon System is able to use, for how long, and how many devices it supports, this may be an evaluation or subscription license.

  • The license must be activated. Once activated, it may be used only by the Tachyon System that activated it.
  • Licenses can be renewed or updated, but if allowed to expire then the affected products or features will not be usable.
  • For a new installation, the Tachyon Setup program will let you select the license file from any folder on disk.
  • For an existing installation the license file is copied into the folder: %PROGRAMDATA%\1E\Licensing on your Tachyon Server.

For details of what the license file needs to contain, please refer to Design Considerations: License requirements for consumer applications.

Tachyon Setup will attempt to connect to the 1E license service in the 1E cloud, and warn you if a connection cannot be established. The product will still install successfully and you will be able to connect to the Tachyon Portal but you won't be able to fully use the system until you enable communications with the 1E license service.

For more details please refer to the License file heading on the Requirements page.

Select configuration

This screen lets you choose between installing all the Tachyon Server components onto a single server or selecting the components you want to install individually.

The options in a default setup are:

  • All components on a single server (default)
  • Tachyon Master Stack - all Tachyon systems require one Master Stack
  • Tachyon Response Stack - this is required for Real-time features of Tachyon
  • DMZ Server - this is required to provide Real-time features to Internet-facing clients
  • Business Intelligence - this is required for Patch Success


Custom configuration

A custom configuration can be made available where you can select the Tachyon components you wish to install on the server. For guidance please contact 1E.

The Tachyon Setup wizard supports the fully configured installation of Tachyon components onto a single server, with optional remote databases.

While you can select to install individual components in isolation, in practice additional configuration will be needed to get those components working together. So, before selecting the custom configuration option, you should contact 1E in order to get an overall picture of the complete custom installation and configuration process.

One custom configuration is to install Tachyon use an existing 1E Catalog server, if you have for example an existing deployment of 1E Windows Self-Service (WSS) solution. SLA Platform cannot be shared between Tachyon and WSS.

Please review Design Considerations to determine your Tachyon system architecture and decide which configuration to select.

Business Intelligence

For a default installation the only optional components are Experience, ActiveEfficiency Server and Business Intelligence, you should select:

  • Experience - if you want to use the new 1E Experience application from 1E
  • ActiveEfficiency Server - if you want to enable either the Nomad or Shopping modules of the 1E Client
  • Business Intelligence - to use Patch Success

Installing ActiveEfficiency Sever this way enables its support for HTTP and HTTPS.

You can also change the folder you wish to install to.

After selecting the installation option you want to use click Next.

Check prerequisites

This screen performs prerequisite checks on the local server and user account.

Click Start Checking to start the checks.

If any of the checks fail Tachyon Setup may be able to install the missing prerequisites. To install these click the Install missing prereqs. button.

If there are missing prerequisites which Tachyon Setup is able to install, then the Install missing prereqs. button is enabled. If you click this button, the missing prerequisites will start installation immediately.

Not all prerequisite checks have automated fixes. If your environment fails a check and the Install missing prereqs. button has not been enabled then you will need to install or configure the missing prerequisites by hand. For example SQL Server 2012 Native Client.

You can click Check Again to re-run the checks once any remediation steps have been made.

Server certificate

This screen displays a list of certificates from the Local Computer\Personal certificate store, letting you select a specific certificate you want to use for the Tachyon Server website and Tachyon Switches. Tachyon Setup will then evaluate the suitability of the selected certificate.

The option to Use the Switch certificate from a previous installation is used for the following alternatives:

  • If you are upgrading Tachyon then this option allows you to use existing Switch certificate files that exist in the Switch SSL folder.
  • If the web server certificate does not have private key exportable and you have manually created Switch certificate files, then this option allows you to use Switch certificate files that you have created manually, and placed in the Setup folder
  • for this server, then check Use the Switch certificate from a previous installation. Files in the Switch SSL folder take precedence over files in the Setup folder. (In older versions of Tachyon Server the Switch certificate files had to be created manually and included in the Setup folder, which you can use, but is no longer necessary.)

In both of the above, the Tachyon Server installer will also automatically choose the first suitable web server certificate it finds in the Windows certificate store, and use this for the Tachyon website binding and Coordinator workflow binding. If there are issues with this selection, they can be resolved using the steps in Server installation issues: Verify the Tachyon website HTTPS binding.

Client certificates

This screen lets you manage the trust(s) between the Tachyon Server and Tachyon clients.

If your Tachyon clients do not have certificates or you do not want to use them, then uncheck Switches require client certificates to be presented by Tachyon Agents. This configures Switch(es) to not require client certificates.

For a new installation this setting is checked by default.

For an upgrade, this setting is determined by the current configuration of the Switch(es). If any Switch is configured to require client certificates, then this setting will be checked and re-applied to all Switches.

Please refer to Switch Command Lines if you want to reconfigure switches post-installation.

If you want Tachyon clients to present certificates, that were issued by a different Certificate Authority than the certificate used by Switch(es), then the process described below must be used for each different Certificate Authority.

  • Create .cer or .pfx files containing the public key of the issuing CA, its root CA, and any intermediate CA in the trust path of the client certificate.
  • Use Add from .cer file or Add from .pfx file to import each public key file, which Tachyon Setup will use to update the Switch .pem file.

For more detail about Tachyon client certificates and Switch certificate files please refer to Preparation: Tachyon client certificate requirements.

Database servers

On this screen you select the SQL Server instances where you want to install each of the databases that will be deployed.

For each database, a combo-box containing a list of available SQL Server instances is displayed. This list is generated as a background task, so it may take a few seconds to populate. It may also return instances that are accessible but not necessarily on the local network. You may select one from the list or type in your own.

For each database there is a Drop existing <title> database checkbox, which If you are upgrading you can check to remove any existing data from that database on the specified database server. Obviously you should be careful when checking these checkboxes and sure that you want to continue, as data will be deleted if they are checked and the installation is started.

A Validate button is provided that performs some basic tests to check that the selected SQL instances can be accessed using the current user account.

Once the SQL Server instances have been selected and validated, click Next to continue. 

SSAS servers

This screen is only relevant if you selected the option to install Business Intelligence or Experience on the Select Configuration screen.

On this screen:

  • Enter the credentials for the BI related account that will be used to connect to the SSAS server (Patch Success only)
  • Select the server instance for the SQL Server Analysis Service where you want to deploy the Business Intelligence cube (Patch Success only)
  • Select the server instance for the SQL Server Analysis Service where you want to deploy the 1E Experience database (Experience only)

A Validate button is provided that performs some basic tests (but not a full validation of permissions and functionality on the SSAS server).

When you attempt to validate the SSAS servers settings, you may see the following dialog displayed.

This warning is related to a library missing from the local server. It is not related to the database server settings. In particular it is not related to the presence, or not, of SSAS on the selected server instances. In most cases the warning is benign and can be safely ignored.

Once the settings have been entered and validated, click Next to continue. 

Number of devices

Enter the number of devices supported by this server.

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.

Switch configuration

This screen displays a list of IP Addresses that can be assigned to each Switch in your configuration. Tachyon Setup will estimate how many Switches are required for the number of devices selected in the earlier setup screen and try to assign an IP Address for each. You will need to confirm or change which IP Address is used by each Switch.

IPv6

The screen only displays a list of IPv4 IP Addresses available on the server. If you need to use IPv6 and have a functioning IPv6 network infrastructure then please contact 1E for further advice on how to use this screen.

Ideally to maximize the performance of Tachyon you should have the following configuration:

  • You have enough Switches configured to support the selected number of devices. You can add additional Switches by clicking extra checkboxes, if you have enough IP Addresses configured.
  • One interface per Switch (interfaces may have more than one associated IP Address, so you'll need to check the MAC Addresses to make sure that the IP Addresses are on different interfaces).
  • An additional interface if you have a remote SQL Server and a dedicated connection to the SQL instance.

However in a lab or other environment which has less than 500 devices, you can have all components using a single IP Address.

If you have a local installation of SQL Server, then Used for SQL will show No for all IP Addresses, and you can select whichever IP Address you wish to for each Switch.

If you are using a remote SQL Server, then Used for SQL will show Yes for the IP Address which was used in the earlier screen to validate connection to the SQL Server you selected for the Responses database. If you have configured a dedicated network interface for your SQL connection and Setup has not selected it, then you will need to change the IP Routing table on the server, or reconfigure the connection so that your selected IP Address is used by SQL.

For an installation with multiple Switches, aside from each selected IP Address, all Switches will have an identical configuration.

Click Validate to check that your selection conforms to the best practice rules for configuring switches.

Once the selection has been validated, click Next to continue.

Website configuration

Confirm that the details are correct on this screen. If the defaults are changed, then ensure you use the Validate button.

ParameterDescription
HTTP Host Header


Sets the host header used by the Tachyon website HTTP binding. This is primarily used for internal communications between the Tachyon components.


Default value is set to the FQDN for the local computer, and should not need to be changed.

If you are upgrading from SLA Platform 3.3 and SLA Platform had a custom host header defined, you should change the host header to the host header used for the SLA Platform website. If the Tachyon website uses a different host header port than was previously used by SLA Platform and you are using Application Migration, the Application Migration Task sequence step and Shopping integration will stop working until these URLs are updated.

HTTP Port


Sets the HTTP port used by the Tachyon website. Together with the Host Header and IP Address, these bindings uniquely identify the Tachyon Website which Tachyon Switches use to connect to the Tachyon Core.

Default value 80.


If you are upgrading from SLA Platform 3.3, you should change this port to the port previously used for the SLA Platform website (default 8080). If the Tachyon website uses a different port than was previously used by SLA Platform and you are using Application Migration, the Application Migration Task sequence step and Shopping integration will stop working until these URLs are updated.

HTTPS Host Header


Sets the host header used by the Tachyon website HTTPS binding.

Must be the same as the DNS Alias FQDN and the DNS name in the Web certificate.

Default value TACHYON.<domainFQDN>


If you are upgrading from SLA Platform 3.3 and SLA Platform had a custom host header defined, you should change the host header to the host header used for the SLA Platform website. If the Tachyon website uses a different host header port than was previously used by SLA Platform and you are using Application Migration, the Application Migration Task sequence step and Shopping integration will stop working until these URLs are updated.

HTTPS Port


Sets the HTTPS port used by the Tachyon website. This is used by Tachyon clients to communicate with the Tachyon server using the background channel.

Default value 443.


If you are upgrading from SLA Platform 3.3, you should change this port to the port previously used for the SLA Platform website (default 8443). If the Tachyon website uses a different port than was previously used by SLA Platform and you are using Application Migration, the Application Migration Task sequence step and Shopping integration will stop working until these URLs are updated.

IP Address

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.

Workflow port

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.

Integrate REST port
This is used internally by the SLA Integrate services. You will normally not need to change it, unless it conflicts with any other service that is already using the same port.

After installation, you will need to manually verify the certificate bindings, as described in Tachyon Server post-installation tasks.

A Validate button is provided that performs some basic tests to check that the selected HTTP/HTTPS Host Header and ports as well as the service ports do not conflict with each other and that the addresses are resolvable from DNS.

When all the settings have been made and validated, click Next to continue.

Active Directory and email

On this screen you enter the details for the Active Directory search method. If you want email enabled then enter the SMTP server details. When email is enabled you can also select if you want two-factor authentication to be enabled.

The settings on this screen are not validated by the installer. You will need to ensure that the correct information has been added before continuing to the next screen.

ParameterDescription
Active Directory

Sets how the Tachyon Server queries Active Directory. The choice is between GC and 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.

Enable Email

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.

SMTP Server

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.

SMTP Port

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.

Mail from

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.

Enable two-factor authentication

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.

A Validate button is provided that performs some basic tests to check that the selected SMTP server and port can be contacted.

Click Next to continue.

SLA and 1E Catalog

Tachyon 5.0 supports a new AI Powered Auto-curation feature that automatically recognizes software without the need to first create mapping rules in the 1E Catalog. This means you can have greater visibility of software installed across your organization. Please refer to Tachyon 5.0 - AI Powered Auto-curation for more details.

On this screen, you can configure whether the AI Powered Auto-curation feature is enabled or not. If you are installing or upgrading 1E Catalog using Tachyon Setup, enabling this will also configure 1E Catalog to download the files needed by SLA to support this feature.

To enable the feature check the Enable AI-based auto-curation checkbox.

Click Next to continue.

Nomad synchronization

This screen is only relevant if you selected the option to install ActiveEfficiency on the Select Configuration screen.

Check the Enable Nomad Sync checkbox if you want ActiveEfficiency to synchronize with a System Center Configuration Manager (SCCM, ConfigMgr) installation.

If the checkbox is selected, the rest of the options in the screen become enabled. Select the server that contains the ConfigMgr database as well as the database name. The synchronization interval in minutes allows you to set how often the synchronization will happen.

A Validate button is provided that performs some basic validation to verify that the connection to the database can be opened.

Ready to Install

To start the Tachyon Server installation with the information you have provided click the Install! button at the bottom of the Ready to Install screen.

Because you can click on this screen at any point, the Install! button is only enabled when enough information and responses have been provided on the other screens to enable installation to start. For example, one of the conditions is that until you respond by checking the I accept the terms in the license agreement checkbox on the License Agreement screen the Install! button will not be enabled. Other items such as selecting a valid Tachyon Server website certificate are also requirements.

Once you have reached this stage and no errors are displayed, a file named Tachyon.Setup.ini is written to disk in the same folder that contains Tachyon.setup.exe. This .ini file contains the selections that you made up to this point, and can be used to re-launch the installer without having to re-enter all the settings.

When you've configured the installation properties you can click the View command line button to view the command lines used to run the various .msi installers to install Tachyon Server along with the bundled components with the settings you have entered.

Tachyon Setup is the only supported method of installing a Tachyon Server. Installation using standalone MSI is not supported unless advised by 1E, which may be necessary in complex installations, using non-interactive (quiet/silent) command-lines, and may require post-install configuration steps.

Installation results

This screen displays the current progress of the Tachyon installer. The installer log information is displayed as it occurs in the Installation Log window.

Once installation has finished successfully the message: The installer exited and reported successful completion, will be displayed in the Installation Log window.

You can find the installation logs on disk (*.log) in the same folder from where Tachyon.Setup.exe was launched.

Post-Installation checks

After an installation you can opt to run the Post-installation Checks by clicking on the Start checking button.

The aim is to achieve 100% check success results in the Result column. If any of the checks fail additional information is normally provided in the Info column. This information can contribute towards troubleshooting the issue and may be used in combination with the Troubleshooting section and/or shared with 1E Support in order to track down and resolve any installation issues that you may have encountered.

One of the post-installation checks is: Tachyon Portal web application responds. When this check passes it will display a link Open which can be used to start the default browser and connect to the Tachyon Portal.

Maintenance

You will not normally need to access this screen during a first installation of Tachyon. If you need to reach it at a later time, you can start Tachyon.Setup and click directly on the Maintenance link in the left-hand menu.

From this screen you can uninstall all or part of the components deployed from Tachyon.Setup. You can also register or re-register any Applications used by the Portal.

Uninstall

From this screen you can uninstall all or some of the components deployed from Tachyon Setup.

Tachyon Setup is the recommended method of uninstalling all or individual components instead of using the Windows Control Panel.

This is because Tachyon Setup can undo any changes that were done after deploying the components, which would not be undone by the standard application uninstaller. For an example of why this is important, see the information box below.

Tachyon Setup moves ActiveEfficiency website from Default Web Site to Tachyon in IIS

When installing ActiveEfficiency, the MSIEXEC installer deploys its web applications under the Default Web Site in IIS. However the rest of the web applications (Tachyon, Consumer, Platform etc.) are deployed to a website named Tachyon on the same server.

IIS uses host headers in website bindings to route requests to the correct website, which means bindings must be unique. Only the Tachyon website has a binding for HTTP requests that use the servername FQDN and port 80. It is not possible for the same binding to be used on the Default Web Site. To allow ActiveEfficiency HTTP requests that use the servername FQDN and port 80 it is necessary for Tachyon Setup to move its website from Default Web Site to Tachyon website.

Moving websites has advantages of providing a single, consistent, platform under a common website, and allowing these web applications to be reachable over HTTPS without needing additional DNS Names and certificates.

However, the disadvantage is if you uninstall ActiveEfficiency using the traditional uninstallation option from the Windows Control Panel, they leave an orphan entry under the Tachyon site in the IIS configuration. This is harmless but useless; ideally, we want to leave a completely clean system after uninstallation. To achieve the clean uninstallation, the Tachyon Setup uninstaller first moves back the applications to their original location (the Default Web Site). In this way, each MSIEXEC uninstaller finds its web application where expected and each one is cleanly uninstalled.

Applications maintenance

In this dialog you can select to install or re-install any Applications used by the Portal.

The top grid displays the Applications that are already installed and their versions.

To install or re-install applications:

  1. Type or select a folder in the Applications folder field.
  2. Click on Show Applications. Doing this displays all the Tachyon Applications that are found under the selected folder. The Applications are displayed using the Name, Title and Version.
  3. Click on Install Applications. This will upload the Applications into the server:
    • Any new uploaded Applications are added to the server
    • Any uploaded Applications with a newer version number will replace the older versions
    • If any uploaded Application has a version number prior to an existing Application, an error message will be generated and the version will not be downgraded.

Certificate Bindings

In this dialog you can change the certificate bindings used by the Switches, Website, Coordinator and Integrate REST components. Currently you can apply one certificate across all the components.

To view the certificate that is being used click on any of the View buttons.

To change the certificate click the Change... button and select the new certificate from the Certificate Selector dialog subsequently displayed. This dialog behaves in a similar way to the Server certificate screen displayed earlier in Tachyon Setup. When you've finished making the selection in the Certificate Selector click Ok.

The certificate displayed for the Switches, Website, Coordinator and Integrate REST components will then change to the selected certificate. Click Ok in the Certificate Bindings dialog to apply the changes.

Next Steps

After installation, you should do the following: