Software Install

The Software Install task is used to install or upgrade software on your client computers. It is primarily intended to install ESET products, but you can use it to install any software you like.

To create the task, click Tasks > New > add_new_defaultClient Task or click the desired client device in Computers and select New Task.

To prevent installation failure, ESMC performs the following checks before installing or upgrading ESET products:

if the repository is accessible

if there is enough (1 GB) free space on the client machine (not available for Linux)

note

Note

Both ESMC Server and ESET Management Agent require access to the internet to access the repository and perform installations. If you do not have internet access, you must install the client software locally because remote installation will fail.

When performing a Software Install task on computers in a domain with ESET Management Agent running, the user must have read permission for the folder where the installers are stored. Follow the steps below to grant these permissions if necessary.

1.Add an Active Directory computer account on the computer executing the task (for example NewComputer$).

2.Grant Read permissions to NewComputer$ by right-clicking the folder where installers are located and selecting Properties > Sharing > Share from the context menu. Note that the "$" symbol needs to be present at the end of the computer name string.

Installation from a shared location is only possible if the client machine is in a domain.

Basic

In the Basic section, enter basic information about the task, such as a Name and Description (optional). Click Select tags to assign tags.
In the Task drop-down menu, select the task type you want to create and configure. If you have selected a specific task type before creating a new task, Task is pre-selected based on your previous choice. Task (see the list of all Tasks) defines the settings and the behavior for the task.

Settings

Click <Choose ESET License> and select the appropriate license for the installed product from the list of available licenses. This will only work for products installed from the repository, not products installed from a custom URL.

Click <Choose package> to select an installer package from the repository or specify a package URL. A list of available packages where you can select the ESET product you want to install (for example, ESET Endpoint Security) will be displayed. Select your desired installer package and click OK. If you want to specify a URL where the installation package is located, type or copy and paste the URL (for example file://\\pc22\install\ees_nt64_ENU.msi) into the text field (do not use a URL that requires authentication).

http://server_address/ees_nt64_ENU.msi - If you are installing from a public web server or from your own HTTP server.

file://\\pc22\install\ees_nt64_ENU.msi - If you are installing from network path.

file://C:\installs\ees_nt64_ENU.msi - If you are installing from local path.

 

Select the check box I accept the terms of the application End User License Agreement and acknowledge the Privacy Policy. See License Management or EULA for more information.

If you need to, you can specify command-line installation parameters, otherwise leave this field empty.

Command-line installation parameters are intended for use only with the reduced, basic, and none user interface settings.

See documentation for the msiexec version used for the appropriate command line switches.

For ESET security product command-line installation, read the respective Online Help:

oESET Endpoint products

oESET Server products

Select the check box next to Automatically reboot when needed to force an automatic reboot of the client computer after installation. Alternatively, you can leave this option deselected and manually restart the client computer(s).

Installation of third-party software

You can use the Software Install task to install non-ESET (third party) software.

Operating system

Supported installation file types

Support for installation parameters

Windows

.msi

The Software Install task always performs silent installation of the .msi packages.

You cannot specify msiexec parameters. You can specify only parameters used by the installation package itself (unique for each software installation package).

Linux

.deb, .rpm, .sh

You can use parameters only with .sh files (.deb and .rpm do not support parameters).

macOS

.pkg, .dmg (containing .pkg file)

 

Installation parameters are not supported.

Android

.apk

iOS

.ipa

example

Example

You want to install software on Linux using the file install_script.sh that has two parameters: -a is the first parameter, -b is the second parameter.

Installation in terminal (as root user in folder where install_script.sh is located):

./install_script.sh -a parameter_1 -b parameter_2

Installation using the Software Install task:

Enter the file path in Install by direct package URL, for example: file:///home/user/Desktop/install_script.sh

Enter the Installation parameters: -a parameter_1 -b parameter_2.

Summary

Review the summary of configured settings and click Finish. The Client Task is now created and a pop-up window will open. We recommend that you click Create Trigger to specify when this Client Task should be executed and on what Targets. If you click Close, you can create a Trigger later. To create a trigger afterward, select the Client Task instance and select Run on from the drop-down menu.

client_task_finish

In Tasks you can see the progress indicator bar, status icon, and details for each created task.

List of problems when installation fails

Installation package not found.

Required newer version of the Windows Installer Service.

Another version or conflicting product is already installed.

Another installation is already in progress. Complete that installation before proceeding with this install.

Installation or uninstallation finished successfully but computer restart is required.

Task failed - there was an error, you need to look at the Agent trace log and check the return code of the installer.