Skip to main content

1E 23.7 (SaaS)

1E Client requirements

You will need to plan the deployment of 1E Client using whichever software deployment tools you have.

The 1E Client Deployment Assistant provides a wizard that simplifies deployment of 1E Client for Windows. It also integrates with Configuration Manager to create deployments, for more details refer to Introducing 1E Client Deployment Assistant.

Deployment

You must decide how you will configure the 1E Client and deploy to devices.

Note

For more information about configuring the 1E Client properties during and after installation, please refer to 1E Client configuration settings and installer properties.

For details of interactive and command-line installation, please refer to Deploying 1E Client.

1E, Content Distribution, and Shopping require client certificates. For more detail, please refer to Certificate requirements.Certificate requirements

Installation accounts
1E Client Windows installation account

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).

1E Client non-Windows installation account

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

Supported device platforms

Below are lists of supported OS Platforms. Please also refer to Constraints of Legacy OS, which applies to server and client OS.

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 1E, and by 1E Client 23.7.

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)

  • CD 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 Analytics 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 23.7.

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 8.2 (or later)

  • PowerShell 3.0 (or later)

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

For more details please refer to Content Distribution client requirements.

PowerShell is not a prerequisite for installation of the 1E Client. PowerShell is used by some 1E 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 1E Configuration Manager Console extensions

  • CD 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.

1E, CD, WakeUp, and Application Migration (unavailable for SaaS) 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 23.7.

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 Ventura 13

  • 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.

1E 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.

1E 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.

1E scripting requirements

You must ensure the appropriate scripting environment is present on client devices. DEXCode supports running native PowerShell on Windows and bash on non-Windows devices, which can be script files downloaded when an instruction runs, or command text.

  • Windows Tachyon clients can use PowerShell scripts. Ensure your client devices have an appropriate version of PowerShell installed to support any custom scripts you may develop. PowerShell on Windows OS.

  • Non-Windows clients use bash as their scripting medium. This should be present on all non-Windows 1E Client devices. See Bash on non-Windows OS.

PowerShell on Windows OS

PowerShell is used by some 1E 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.

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.

Tip

To determine the version of PowerShell on a computer, start PowerShell (command prompt or ISE) and enter one of the following commands: $PSVersionTable.PSVersion or $PSVersionTable for more detail.

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 2022

RTM (Notes 12, 13)

Note 4

Windows 11

RTM (built-in)

Windows Server 2016, 2019, 2022

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:

  1. PowerShell is not built-in for these OS. These OS do not support 3.0 or later. See Constraints of Legacy OS

  2. If PowerShell 1.0 is installed it must be removed in order to install a later version.

  3. Support for PowerShell 2.0 is included in PowerShell 3.0 and later.

  4. PowerShell is not installed by default on these OS but is an optional feature that should be enabled using Server Manager.

  5. PowerShell 2.0 is part of WMF Core package (KB968930) with prerequisite of .NET Framework 3.51 (which includes .NET 2.0 SP1).

  6. 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

  7. 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

  8. 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

  9. 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

  10. 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

  11. 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

  12. 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

  13. In these Server OS, PowerShell 5.1 is referred to as the Desktop Experience. You can use the PowerShell Core version if you prefer.

Please refer tohttps://support.microsoft.com/en-gb/help/17455/lifecycle-faq-net-framework for details of Microsoft support for .NET Framework.

  • Support for 4, 4.5, and 4.5.1 ended on January 12, 2016

  • Support for 4.5.2, 4.6 and 4.6.1 ended on April 26, 2022

Bash on non-Windows OS

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

1E 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 the Scripting.Run method. 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.