Contents
-
Introducing Tachyon
-
Quick Start
-
Implementing Tachyon
-
Using Tachyon
-
Maintaining Tachyon
-
Extending Tachyon
-
Training
-
Reference
-
Supported Platforms
-
1E Companion Products
-
Server Sizing
-
Communication Ports
-
Tachyon Server installer properties
-
Tachyon Agent installer and configuration properties
-
Tachyon Agent command-line parameters
-
Devices dashboard filters and charts
-
Responses Summary tab information
-
Coverage parameters
-
Tachyon Explorer comparison operators
-
Switch Command Lines
-
Tachyon Log Files
-
Glossary
-
Tachyon release information
-
Index
-
Supported Platforms
Tachyon Agents
Category | Product | Notes |
---|---|---|
Windows OS |
| Professional and Enterprise editions of Windows 10 are supported. All versions are provided with 32-bit & 64-installers. A service is installed called 1E Tachyon Agent with a small footprint. Please refer to sections on Legacy OS regarding Windows XP, Vista, Server 2003, 2008 and 2012, and PowerShell on Windows OS. For installation guidance on Windows, please refer to Deploying Tachyon Agents: Deploying on Windows platforms. |
Other Windows Software |
| Tachyon Agent installer includes the redistributable package for Visual C++ 2013. PowerShell is not a prerequisite for installation of the Agent. PowerShell is used only by Tachyon instructions that have PowerShell commands embedded or scripts that are downloaded. 1E Nomad Branch service is not a prerequisite for installation of the Agent. Nomad is only used to download instruction resource files if it is installed and the Tachyon Agent integration with Nomad feature is enabled. For more details about PowerShell requirements, please refer to PowerShell on Windows OS below. For more details please refer to Design Considerations: Downloading Agent Resources and Nomad Integration. |
Non-Windows OS | macOS
Linux
Solaris
Android
| Other versions of these Operating Systems should work but have not been tested by 1E. The Tachyon Agent is available for download from the 1E Support Portal, for the following architectures:
Also included in the download are Tachyon Agents for the following legacy Linux distributions:
Tachyon Agents for other Linux distributions can be requested, including Raspbian for Raspberry Pi, and Debian. For Solaris, the following specific libraries are required, but are usually installed by default:
For installation guidance on the following OS, please refer to:
For installation guidance on other non-Windows OS, please contact 1E. |
Other Non-Windows Software |
| Bash and perl are required for installation of all non-Windows Agents, with the exception of the Agent for Android. Tachyon instructions support the use of Bash scripts on all supported non-Windows OS. For more details please refer to Bash on non-Windows OS below. |
Microsoft System Center Configuration Manager Client | Not applicable at this time. | Configuration Manager is not a prerequisite for installation of the Tachyon Agent, and the Tachyon Agent has no built-in providers or modules that depend on Configuration Manager. Tachyon provides Configuration Manager Console extensions, which is part of the Tachyon Toolkit. For more details please refer to Microsoft System Center Configuration Manager Console Extensions. (Microsoft System Center Configuration Manager is also known as Configuration Manager, ConfigMgr and SCCM among other names. Version names include 2012 and Current Branch or CB.) |
Tachyon Server Components
Category | Product | Notes |
---|---|---|
Server OS |
| For more detail, please refer to Requirements: Server requirements. The server must be domain-joined. This version of Tachyon requires the server to be US-English because of a known issue with certain regional settings. |
SQL Server |
| For more detail, please refer to Requirements: SQL Server requirements. Databases must be configured to use a case-insensitive, accent-sensitive collation. The preferred collation isSQL_Latin1_General_CP1_CI_AS , which is also the default.If installing SQL Server locally, note:
For latest information about SQL Server prerequisites, please refer to MSDN: Hardware and Software Requirements for Installing SQL Server. SQL Server 2016 RTM is not supported due to some issues, which are resolved by SP1. Please contact 1E if you require Microsoft SQL Cluster or SQL Always On to be used. |
Microsoft System Center Configuration Manager | Not applicable. | Tachyon Server components have no dependencies on Configuration Manager. Instead, see Tachyon Toolkit and Microsoft System Center Configuration Manager Console Extensions. |
Web Server |
| See Preparation: Windows Server roles and features for details about required IIS roles and features. |
Other Software |
| See Preparation: Windows Server roles and features for details about required .NET Framework roles and features. Windows Server 2012 R2 has .NET Framework 4.5.1 installed by default. You will need to upgrade to 4.6.1 or 4.6.2. Windows Server 2016 has .NET Framework 4.6.1 installed by default. Tachyon Server installer includes the redistributable package for Visual C++ 2013. The Tachyon Switch is written in C++ using Visual Studio 2013 and therefore requires the C++ 2013 runtime (x64); other server components use .NET. PowerShell is required by the installer during installation. |
Browsers | Latest version of:
| A browser is not a prerequisite for installation of Tachyon Server, but is required to use and administer it. Administration is performed via the Tachyon Explorer Portal and can be on a remote computer. |
Tachyon Explorer Portal
Category | Product | Notes |
---|---|---|
Browsers | Latest version of:
| These browsers are supported on all OS platforms which the browser vendor supports. Please review Known issues: Using Tachyon. |
Tachyon Toolkit
Microsoft System Center Configuration Manager Console Extensions
Category | Product | Notes |
---|---|---|
Client OS |
| For OS supported by the 2012 Configuration Manager Console, see Configuration Manager Console Requirements (Microsoft). For OS supported by Configuration Manager Current Branch (CB) see Supported configurations for System Center Configuration Manager (Microsoft). |
Microsoft System Center Configuration Manager Admin Console |
| These are the versions of Configuration Manager that 1E has tested and therefore support, but later versions are assumed to work also. Please see Configuring the Tachyon Configuration Manager extensions. |
TIMS (Tachyon Instruction Management Studio)
Category | Product | Notes |
---|---|---|
Windows OS |
| Professional and Enterprise editions of Windows 10 are supported. All versions are provided with 32-bit & 64-installers. TIMS is currently only available for Windows OS. For installation guidance, please refer Tachyon SDK - Getting started with TIMS. |
Other Windows Software |
| TIMS installer includes the redistributable package for Visual C++ 2013. PowerShell 3.0 or later is required when testing instructions that have PowerShell commands embedded or scripts that are downloaded. |
Tachyon App
The below table lists the mobile device OS versions that support the Tachyon App.
Category | Product | Notes |
---|---|---|
Mobile OS |
| The Tachyon App, also known as Tachyon Auth mobile app, is deprecated and will be removed in a future release of Tachyon. As a consequence, the Registered mobile phones administration page is also deprecated. |
Scripting
Tachyon Agent language SCALE directly supports running PowerShell on Windows OS and bash on non-Windows OS devices, which can be scripts that must be downloaded by SCALE when an instruction runs, or actual command text. You will very probably want to use this feature in your own instructions and ones that you download from 1E. Therefore you must ensure the appropriate scripting environment is present on Agent devices.
PowerShell on Windows OS
PowerShell is used by some Tachyon instructions (that have PowerShell commands embedded or scripts that are downloaded) and some of these require PowerShell 3.0 or later, although some scripts will support PowerShell 2.0. PowerShell scripts are supported only on Windows OS.
To see if an instruction requires PowerShell, look in its Instruction Definition XML file for PowerShell resources defined under the <Resources> tag.
If installing or upgrading PowerShell, it is best to install the latest version available. However, do not expect full forward or backward compatibility between PowerShell versions.
The table below shows which versions of PowerShell are supported on each OS version and Service Pack, and if it is built-in or needs to be installed.
OS Version | PowerShell Version | Notes | |||||
---|---|---|---|---|---|---|---|
1.0 | 2.0 (Note 3) | 3.0 | 4.0 | 5.0 | 5.1 | ||
Windows Server 2016, 2019 | RTM (Note 9) | RTM (Notes 12, 13) | Note 4 | ||||
Windows 10 | RTM (built-in) | Anniversary Update (built-in) | |||||
Windows Server 2012 R2 | RTM (built-in) | RTM (Note 9) | RTM (Note 12) | Note 4 | |||
Windows 8.1 | RTM (built-in) | RTM (Note 9) | RTM (Note 12) | ||||
Windows Server 2012 * | RTM (built-in) | RTM (Note 7) | RTM (Note 9) | RTM (Note 12) | Note 4 | ||
Windows 8 * | RTM (built-in) | ||||||
Windows Server 2008 R2 * | RTM (built-in) | SP1 (Note 6) | SP1 (Note 7) | SP1 (Note 8) | SP1 (Note 10) | Note 4 | |
Windows 7 | RTM (built-in) | SP1 (Note 6) | SP1 (Note 7) | SP1 (Note 8) | SP1 (Note 10) | ||
Windows Server 2008 * | RTM (built-in) | SP1 & SP2 (Note 2) | |||||
Windows Server 2003 * | RTM & SP1 | R2 & SP2 | Notes 1, 2 | ||||
Windows Vista * | RTM | SP1 & SP2 | Notes 1, 2 | ||||
Windows XP * | RTM, SP1 & SP2 | SP3 | Notes 1, 2 |
* These OS are regarded as Legacy OS.
- PowerShell is not built-in for these OS. These OS do not support 3.0 or later. See Constraints of Legacy OS.
- If PowerShell 1.0 is installed it must be removed in order to install a later version.
- Support for PowerShell 2.0 is included in PowerShell 3.0 and later.
- PowerShell is not installed by default on these OS but is an optional feature that should be enabled using Server Manager.
- PowerShell 2.0 is part of WMF Core package (KB968930) with prerequisite of .NET Framework 3.51 (which includes .NET 2.0 SP1).
- PowerShell 3.0 is part of WMF 3.0 with prerequisite of .NET Framework 4.0 or later. Refer https://www.microsoft.com/en-us/download/details.aspx?id=34595
- PowerShell 4.0 is part of WMF 4.0 with prerequisite of .NET Framework 4.5 or later. Refer https://www.microsoft.com/en-us/download/details.aspx?id=40855
- PowerShell 5.0 is part of WMF 5.0 with prerequisites of .NET Framework 4.5 or later and WMF 4.0. Refer https://www.microsoft.com/en-us/download/details.aspx?id=50395
- PowerShell 5.0 is part of WMF 5.0 without any other prerequisites. Refer https://www.microsoft.com/en-us/download/details.aspx?id=50395
- PowerShell 5.1 is part of WMF 5.1 with prerequisites of .NET Framework 4.6 or later, WMF 4.0 and SHA-2 Code Signing. Refer https://msdn.microsoft.com/en-us/powershell/wmf/5.1/install-configure
- PowerShell 5.1 is part of WMF 5.1 with prerequisites of .NET Framework 4.6 or later and WMF 4.0. Refer https://msdn.microsoft.com/en-us/powershell/wmf/5.1/install-configure
- PowerShell 5.1 is part of WMF 5.1 with prerequisite of .NET Framework 4.6 or later. Refer https://msdn.microsoft.com/en-us/powershell/wmf/5.1/install-configure
- In these Server OS, PowerShell 5.1 is referred to as the Desktop Experience. You can use the PowerShell Core version if you prefer.
Bash on non-Windows OS
Bash and perl are required for installation of all non-Windows Agents, with the exception of the Agent for Android which is available from the Google Playstore.
Tachyon instructions support the use of Bash scripts on all supported non-Windows OS.
To see if an Instruction requires a Bash script, look in its Instruction Definition XML file for Bash script resources defined under the <Resources> tag. Bash is the preferred choice when developing custom Instructions for non-Windows OS.
There are slight differences between OS implementations of Bash, particularly on the Mac. Therefore 1E recommends testing custom Bash scripts on each supported OS.
Constraints of Legacy OS
In this documentation, the following are referred to as legacy OS. Below are described some known issues for these OS.
|
|
Support
1E does not provide support for the Tachyon Agent on the following OS. This is because Microsoft has withdrawn support for these OS or they are not significantly used by business organizations.
|
|
Please contact 1E if you require support for these legacy OS.
If you experience an issue on these OS, then please try replicating the issue on a supported OS.
PowerShell limitations
Some Tachyon instructions use PowerShell and some of those expect PowerShell version 3.0, which is not supported by the legacy OS listed above. However, PowerShell 2.0 is supported on the following OS versions:
- Windows XP SP3
- Vista SP1 & SP2
- Windows Server 2003 R2 & SP2
Certificate limitations - encrypted certificate requests
Windows XP and Server 2003 are unable to encrypt certificate requests, whereas later OS are able to support higher more secure RPC authentication levels. If you are using a Microsoft CA and expect these clients to request (enrol) certificates then the CA must have its IF_ENFORCEENCRYPTICERTREQUEST flag disabled. It is disabled by default on Windows 2003 and 2008 CA, but is enabled by default on Windows 2012 CA.
To determine which InterfaceFlags are set, execute the following command on the CA server:
certutil -getreg CA\InterfaceFlags
If the following is specified then it means the flag is enabled.
IF_ENFORCEENCRYPTICERTREQUEST -- 200 (512)
To disable the encrypt certificate requests flag, execute the following commands on the CA server:
certutil -setreg CA\InterfaceFlags -IF_ENFORCEENCRYPTICERTREQUEST
sc stop certsvc
sc start certsvc
Certificate limitations - SHA2
When installing Tachyon Agent on Windows XP and Server 2003 you may also require a hotfix as described in KB968730. This hotfix is required if your PKI has CAs configured to use SHA2 256 or higher encryption.
Certificate limitations - expired root certificates
Ensure that your Root Certificates are up-to-date. The Update Root Certificates feature is enabled by default on these OS but its configuration may have been changed or restricted by Group Policy. You may see DisableRootAutoUpdate = 1 (dword)
in HKLM\Software\Policies\Microsoft\SystemCertificates\AuthRoot.
Certificate limitations - signing certificates missing
As described in Requirements: Digital Signing Certificates the root VeriSign Class 3 Public Primary Certification Authority - G5 certificate must exist in the Third-Party Root Certification Authorities store (which is replicated in the Trusted Root Certification Authorities store). This root certificate is normally automatically provided by Microsoft's Update Root Certificates feature, however this may not be present for legacy OS. To verify if you affected by this issue see Implementation issues: 1E Digital Signing Certificate.