Skip to main content

1E 8.1 (on-premises)

Common client requirements

Prerequisites and dependencies that are common to all client features and modules of the 1E Client.

Tip

1E Client contains client features and modules for Tachyon, Shopping/WSA, WakeUp, Nomad and PXE Everywhere clients. You can optionally enable and configure clients during and after installation.

Installation account for Windows

The 1E Client installer installs a service as local system, therefore the installation account for Windows clients must be capable of being elevated in order to run the installer. The simplest way of achieving this is for the account to have full local administrator rights (as a member of the localgroup administrators, either directly or indirectly).

Installation account for non-Windows

To install the 1E Client on a non-Windows client the installation account must have privileges to run the sudo command.

1E Client supports only Tachyon platform client features on non-Windows devices.

Supported Platforms

A list of all the platforms supported by 1E Client, and the software required to allow 1E Client to be installed or to work.

Windows client

Category

Product

Notes

Operating System
  • Windows Server 2022

  • Windows Server 2019

  • Windows Server 2016

  • Windows 11 CB 22H2

  • Windows 11 CB 21H2

  • Windows 10 CB 22H2

  • Windows 10 CB 21H2

The zip for 1E Client for Windows is available for download from the support.1e.com/.

Professional and Enterprise editions are supported for Windows 10 and Windows 11.

All versions are provided with 32-bit & 64-installers, and can be installed on physical and virtual computers.

Note

This list shows only those OS versions in mainstream support by Microsoft, and therefore supported by Tachyon, and by 1E Client .

Please refer to Constraints of Legacy OS regarding the end of mainstream support.

For Microsoft product lifecycle details, please refer to https://support.microsoft.com/en-us/lifecycle/search.

Refer to Support for Microsoft Rapid-Release Cycle on https://support.1e.com/ for details of which Current Branch versions are supported by 1E products, and known issues regarding specific versions.

For installation guidance on Windows, please refer to Deploying 1E Client on Windows.

The following 1E Client features and modules are supported on Windows OS:

  • Real-time features (for example instructions, experience, interaction)

  • Nomad client

  • PXE Everywhere Agent client

  • Shopping client

  • Windows Servicing Assistant (WSA) client (workstation OS only, not server OS)

  • WakeUp client

Runtime libraries
  • .NET Framework 4.8

  • Visual C++ 2015-2019 Redistributable

.NET Framework is required only for the following features of 1E Client:

  • The Real-Time Control Center feature of the 1E Client (also known as 1E Client UI and Interaction module) supports Experience Engagements (Announcements and Surveys), and ITSM Support Tickets

  • Windows Servicing Assistant (WSA) is a feature of the Shopping/WSA client module, which supports OS deployment, upgrades and migrations.

Note

This list shows only those .NET Framework versions in mainstream support by Microsoft, and therefore supported by 1E, and by 1E Client .

For Microsoft product lifecycle details, please refer to https://support.microsoft.com/en-us/lifecycle/search.

1E Client installer includes the Visual C++ 2015-2019 Redistributable package.

Other Windows Software
  • Nomad (or later)

  • PowerShell 3.0 (or later)

1E Client provides real-time client features. It also includes the Nomad client module. Real-time client features can optionally use Nomad to download content (feature enabled by default) if the Nomad client module in 1E Client is enabled (module disabled by default) or Nomad 7.0 or later is running.

For more details please refer to Nomad client requirements.

PowerShell is not a prerequisite for installation of the 1E Client. 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.

Microsoft Endpoint Configuration Manager Client
  • MECM CB 2211

  • MECM CB 2207

  • MECM CB 2203

  • MECM CB 2111

  • MECM CB 2107

The following client features work with these versions of Configuration Manager on Windows computers:

  • Real-time client - instructions used by Tachyon Configuration Manager Console extensions

  • Nomad client

  • PXE Everywhere Agent

  • Shopping/WSA client

  • WakeUp client - including Policy Refresh and REFRESHONSUBNETCHANGE features

Configuration Manager is not a prerequisite for installation of the 1E Client, and except for above features, the 1E Client, its features and modules, have no dependency on Configuration Manager.

Tachyon, Nomad, WakeUp, and Application Migration have Configuration Manager Console extensions which are available separately.

Note

This list shows only those Configuration Manager versions in mainstream support by Microsoft, and therefore supported by 1E, and by 1E Client .

For Microsoft product lifecycle details, please refer to https://support.microsoft.com/en-us/lifecycle/search.

Please refer to the Support for the Microsoft Rapid-Release Cycle on https://support.1e.com/ for details of which Current Branch versions are supported by 1E products, and known issues regarding specific versions.

(Microsoft Endpoint Configuration Manager - MECM - is also known as Configuration Manager, ConfigMgr, Config Man, CM, and SCCM among other names. Version names include 2012 and Current Branch or CB.)

macOS clients

Category

Product

Notes

Operating System
  • macOS Monterey 12.0

  • macOS Big Sur 11.6

  • macOS Big Sur 11.0

  • macOS Catalina 10.15

  • macOS Mojave 10.14

Other versions of these non-Windows OS should work but have not been tested by 1E.

1E Client package for macOS is included in the non-Windows zip available for download from the support.1e.com/.

Note

1E Client for macOS is written for Intel and supported on Apple devices using Intel processors. It is also supported on Apple devices using the M1 chip, provided you have installed Rosetta 2, which is included with Big Sur. 1E Client is a daemon (not an app), therefore, during installation or running it will not prompt for Rosetta 2, which does not get installed on-demand.

You only need to install Rosetta 2 once, using one of the following commands, but repeating the command will safely reinstall it. The second version of the command requires root permission. Attempting to install on an Intel device will issue a harmless "unrecognized option" usage message.

/usr/sbin/softwareupdate --install-rosetta
/usr/sbin/softwareupdate --install-rosetta --agree-to-license

For installation guidance, please refer to Deploying 1E Client on macOS.

Other Software
  • Bash

  • Perl

  • Rosetta 2 (on non-Intel)

Bash and perl are required for installation of 1E Client on all non-Windows OS.

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.

Rosetta 2 must be installed before installing 1E Client for macOS on an Apple device using a non-Intel processor such as M1 chip. Please see note above about installing Rosetta 2.

Linux clients

Category

Product

Notes

Operating System
  • CentOS Stream 8

  • Debian 10.4

  • Fedora 34

  • openSUSE Leap 15.2

  • Red Hat Enterprise Linux 7.9

  • Red Hat Enterprise Linux 8.5

  • SUSE Linux Enterprise 15.2

  • Ubuntu 18.04

Other versions of these non-Windows OS should work but have not been tested by 1E.

  • 1E Client packages for other Linux distributions can be requested, including Raspberry Pi.

  • 1E Client for Linux supports Linux variations on Intel 64-bit platforms.

  • 1E Client packages for Linux are included in the non-Windows zip available for download from support.1e.com/.

  • 1E Client supports features on non-Windows devices. For installation guidance on the following OS, please refer to Deploying 1E Client on Linux.

Other Software
  • Bash

  • Perl

Bash and perl are required for installation of 1E Client on all non-Windows OS.

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.

Solaris clients

Category

Product

Notes

Operating System
  • Withdrawn

Note

1E Client is no longer available for Solaris, but 1E may reintroduce it, if there is sufficient demand.

Feature dependencies

Products and Features with dependencies on the 1E Client.

Supported versions of 1E companion products with features that depend on 1E Client .

Products and features that depend on 1E Client

Supported versions of companion products

Tachyon

Tachyon requires the 1E Client (with 1E Client platform features enabled) to be installed on all client computers. This replaces the legacy Tachyon Agent.

Tachyon platform features:

  • Real-time response to instructions, which supports the retrieval of information using questions, and running actions

  • Tags (freeform and device/coverage)

  • Criticality and Location

  • 1E Client UI to support the Real-Time Control Center, Announcements, Surveys, and Sentiment features of the Experience application #

  • Inventory, including process usage, to support the:

    • Tachyon Activity Record feature

    • Inventory and other consumer applications.

  • Performance metrics features to support the Experience application #

  • Policy feature to support consumer applications: Guaranteed State ##, Experience #, and Nomad #

    • Patch Success application #

    • Command and script execution

    • Nomad

    • Device criticality

    • Manipulation of files and processes

    • Manipulation of the registry and WMI #

    • Security #

    • Software uninstallation

    • User sessions, including Primary User.

  • Modules to support:

# not supported on non-Windows, ## partially supported on non-Windows

Clients can optionally use the Nomad client module of 1E Client to more efficiently download content.

  • Tachyon

  • Tachyon 8.0

  • Tachyon 5.2

  • Tachyon 5.1

Nomad

Nomad requires the 1E Client (with Nomad client module enabled) to be installed on all client computers, and on Distribution Points if Configuration Manager is used.

  • Nomad

  • Nomad 8.0

  • Nomad 7.1

Nomad

Nomad Download Pause is an optional feature of Nomad. It requires the 1E Client (with Nomad client module enabled) to be installed on all client computers, and a Tachyon server infrastructure.

  • Tachyon

  • Tachyon 8.0

  • Tachyon 5.2

  • Tachyon 5.1

  • Nomad 8.0

  • Nomad 7.1

PXE Everywhere

PXE Everywhere requires the 1E Client (with PXE Everywhere Agent client module enabled) to be installed on all client computers.

  • PXE Everywhere

  • PXE Everywhere 8.0

  • PXE Everywhere 4.0

Shopping

Shopping requires the 1E Client (with Shopping client module enabled) to be installed on all client computers. This replaces the legacy Shopping Agent.

  • Shopping 6.1

  • Shopping 6.0

Shopping

Windows Servicing Assistant (WSA) is an optional feature of Shopping that supports OS Deployment.

Please refer to Shopping 6.1 - Preparation: Windows Servicing Assistant (WSA) for WSA features in different versions of 1E Client.Windows Servicing Assistant (WSA)

  • Nomad

  • Nomad 8.0

  • Nomad 7.1

  • Shopping 6.1

  • Shopping 6.0

WakeUp

WakeUp requires the 1E Client (with WakeUp client module enabled) to be installed on all client computers, and WakeUp Servers. This replaces the WakeUp component of the 1E Agent.

  • WakeUp 7.3

Supported versions of 1E companion products that 1E Client features depend on.

Products and features that 1E Client depends on

Supported versions of companion products

Tachyon

Tachyon real-time and other features require a full Tachyon infrastructure including a Tachyon Server and a Tachyon license.

  • Tachyon

  • Tachyon 8.0

  • Tachyon 5.2

  • Tachyon 5.1

Nomad

Tachyon platform clients can optionally use Nomad (1E Client with Nomad client features enabled) to provide more efficient downloading of content.

  • 1E Client (with Nomad client module enabled)

  • 1E Client 8.0 (with Nomad client module enabled)

  • 1E Client 5.2 (with Nomad client module enabled)

  • 1E Client 5.1 (with Nomad client module enabled)

Firewall ports

1E does not provide a combined diagram showing all components and features. Please refer to the communications reference page for each product:

Anti-Virus and Malware

The following should be excluded from scans to prevent file locking and resource deletion.

  • 1E log files. See Log files.

  • The 1E Client temporary directory. We recommend modifying the TemporaryDirectory 1E Client configuration setting to %programdata%\1E\Client\Temp and excluding that directory. See 1E Client settings.

    Note

    TemporaryDirectory must be specified as an absolute path. The directory is not automatically created by 1E Client. It must be created before being set otherwise 1E Client will use its default.

Digital signing certificates

On Windows computers, the installation MSIs, executables and DLLs of the 1E software are digitally signed by 1E using the 1E Limited SHA1 and SHA256 signature certificates.

These signing certificates are issued by the Symantec Class 3 SHA256 Code Signing CA, which in turn is issued by the root CA VeriSign Class 3 Public Primary Certification Authority - G5.

The SHA1 and SHA256 signature certificates are each countersigned with the same Timestamp signature certificate Starfield Timestamp Authority - G2, itself issued by Starfield Secure Certificate Authority - G2, in turn issued by the root CA Starfield Root Certificate Authority – G2.

The root CA certificates (for signing and countersigning) must exist in the Third-Party Root Certification Authorities store (which is replicated in the Trusted Root Certification Authorities store). These root CA certificates are normally automatically provided by Microsoft's Update Root Certificates feature, however for legacy OS computers in a lab environment that are not connected to the Internet, see Common client requirements.

Constraints of Legacy OS

1E does not provide support for 1E products on the following OS unless the OS is explicitly listed as being supported for a specific 1E product or product feature. This is because Microsoft has ended mainstream support for these OS or they are not significantly used by business organizations. For details, refer to Supported Platforms