IGEL Installation Guide

Installing and Configuring the Agent

This chapter provides instructions for installing and performing initial configuration of the Nectar Endpoint Client (henceforth EPC) on an IGEL OS 12 device.

Prerequisites

Before starting, confirm that:

• The target device is running IGEL OS 12 and is registered with your UMS instance.

• Your UMS has a valid Workspace Edition or IGEL Subscription License.

• Your UMS is registered with the IGEL Customer Portal at https://cosmos.igel.com/csm with Enable App Portal turned on. Without this, devices cannot download apps from the App Portal and deployments will fail with an HTTP error.

• The user performing the deployment has the UMS Admin or Super Admin role.

• You have your Domain Name, Domain Access Code, Organization ID, and Organization Group ID. If you do not, contact support@nectarcorp.com.

Download from IGEL App Portal

Sign in to the IGEL App Portal and download the app named Nectar Endpoint Client. The downloaded file is nectarepc.ipkg.

Upload to UMS

Log in to your UMS Web App.

1. From the sidebar, select Apps.

2. Click Import App.

3. Choose the nectarepc.ipkg file you just downloaded.

Configure EPC App

Once the EPC app appears in the Apps list, open it.

First, click Edit Update Settings and set the following:

• Automatic Check for Updates in UMS = Check for updates and auto-import into UMS

• Default Version for Assigned Devices = Auto-update Default Version to newest version

Next, click Create New Profile

1. Name the Profile and set the profile location as desired.

2. Under Endpoint Client Configuration, open Endpoint Client Settings.

3. Enable and enter provided values for Domain Name and Domain Access Code.

   1. If you never received a Domain Name/Access Code, please contact support@nectarcorp.com

4. Enable Controller Port Fixed and leave the default value false.

5. Enable Controller Address and enter neccontroller.us.nectar.services .

6. Enable and enter provided values for Organization ID and Organization Group ID.

   1. If you never received an Organization/Group ID, please contact support@nectarcorp.com

7. Enable Agent Log Level and enter 6.

Distribute EPC App

From Devices in the UMS Web App, assign the profile (and the EPC app, if it is not already attached) to the target devices, directories, or device groups.

To verify the deployment:

• Check the Nectar EPC Reporter console for the new device (contact your Nectar PS Representative for assistance)

• Open a root terminal on the device and run

systemctl status nectarepc.service

Confirm that the service is enabled and active (running).

Uninstalling the Agent

To remove EPC from IGEL devices, open the UMS Web App. From the assigned objects list on the device or directory, locate the Nectar Endpoint Client app or profile, then click Detach Object. 

Troubleshooting

App Fails to Download with "HTTP error during download"

The UMS is not registered with the IGEL Customer Portal with App Portal access enabled. See Prerequisites. Registration is performed at https://cosmos.igel.com/csm under Configure Services → UMS Registration, where the Enable App Portal toggle must be turned on.

Agent Will Not Connect to the Controller

If the agent is configured with the Controller address and port but cannot connect, a firewall on the Controller host may be blocking incoming agent connections (default TCP 443). Confirm that the Controller's firewall allows traffic on this port. As a workaround, you can manually register the agent in the Nectar EPC-Controller Reporter UI.

Service Is Not Running

If systemctl status nectarepc.service shows the service as failed or inactive, restart it and inspect the journal:

systemctl restart nectarepc.service
journalctl -u nectarepc.service -n 100 --no-pager

Please sent this journal to your Nectar PS Representative.

Problems Running Tests

If the agent installs and configures successfully but cannot execute tests, the issue is most often a firewall blocking required ports. See Ports and Protocols for the full list.

For additional support, contact support@nectarcorp.com.