1E Client requirements

You can plan the deployment of 1E Client using the software deployment tools you choose. In addition the Client Deployment Assistant provides a wizard that simplifies deployment of 1E Client for Windows. It also integrates with Configuration Manager to create deployments. Refer to Client Deployment Assistant.

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

Refer to Common client requirementsand Constraints of legacy operating systems, which applies to server and client OS.

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 1E clients can use PowerShell scripts. Ensure your client devices have an appropriate version of PowerShell installed to support any custom scripts you may develop. Refer to PowerShell on Windows OS.

  • Non-Windows clients use bash as their scripting medium. This should be present on all non-Windows 1E Client devices. Refer to 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.

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

 

 

 

 

 

Windows Server 2022

 

 

 

 

 

RTM (Notes 3,4)

Note 1

Windows 11

 

 

 

 

 

RTM (built-in)

 

Windows Server 2016, 2019, 2022

 

 

 

 

RTM (Note 2)

RTM (Notes 3,4)

Note 1

Windows 10

 

 

 

 

RTM (built-in)

Anniversary Update (built-in)

 

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

  2. PowerShell 5.0 is part of WMF 5.0 without any other prerequisites. Refer to https://www.microsoft.com/en-us/download/details.aspx?id=50395.

  3. PowerShell 5.1 is part of WMF 5.1 with prerequisite of .NET Framework 4.6 or later. Refer to https://www.microsoft.com/en-us/download/details.aspx?id=54616.

  4. 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 to https://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.