Verifying - 1E Client

Multi-tenant SaaS platform Green checkmark | Single-tenant SaaS platform | On-premises platform

The product formerly referred to as Nomad has been rebranded as Content Distribution. Although the new name is implemented in the majority of documentation and user interfaces, references to Nomad may still appear in specific tools, scripts, or contexts.

Links to other documentation to verify features that are dependent on the 1E Client:

Installing 1E DataSync Agent
PXE Everywhere: Verifying
Shopping: Installing the Shopping Client
NightWatchman Enterprise: The 1E Client

Verify 1E Client installation

To run the following tests you need:

Two user accounts, Test User 1 and 2 , and above TCNU verification tests passed.
At least one test device on which the 1E Client will be installed.
1E Client installation source files and configuration details required by your 1E implementation.

Ref	Test	Expected response	Remediation
TCNA01	Install the 1E Client on the test device using the configuration settings required for your implementation. DNS Alias of 1E Server. Port used by the 1E Switch. Port used by the 1E Background Channel. Include optional MSP update. Confirm Programs and Features.	1E Client installed. Programs and Features display 1E Client. Correct platform x64. Correct version number. If an MSP update has been installed, the Installed Updates displays 1E Client Update (Qnnnnn).	The first clients can be installed manually or using a script. You should repeat this set of tests when you have deployed a few clients using your organization's preferred deployment method. You may need to edit the 1E Client configuration file after installation, to suit the requirements of your implementation, and restart the 1E Client service.
TCNA02	Confirm Windows services are running	The following Windows services exist and are running. 1E Client 1E Nomad Branch - only if Module.Nomad.Enabled=true	If the 1E Client service is not running, then check the Client log.
TCNA03	Check the 1E Client log.	No errors. To view LOG file locations for each OS platform, click to expand. 1E Client logs on Windows: %ALLUSERSPROFILE%\1E\Client\1E.Client.log (used by 1E Client and 1E features, and Shopping client). %ALLUSERSPROFILE%\1E\Client\NomadBranchUninstall-YYYY_MM_HHTMM_HH_SS_000Z.log 1E Client logs on macOS /Library/Logs/1E.Client.Daemon.log (shows any service start errors). /Library/Logs/1E.Client.log (shows the current operation of the 1E Client) 1E Client logs on other non-Windows platforms /var/log/1E/Client/1E.Client.log	Check the Switch setting in the Client configuration file is using the correct DNS Alias for 1E Platform, and the correct port for the Switch.
TCNA04	Start a supported browser on a workstation, refer to Supported Platforms for details. Connect to the 1E portal as Test User 1 Open the Endpoint Troubleshooting application and go to the Devices > Table page. For each Test Device that has had the 1E Client installed, confirm the device is listed in the Table page. Click on each device and view the device properties.	Each Test Device is listed on the Devices Table page. The device details show information about the device's system, activity, certificate, and configuration settings.	If you cannot use the Test User 1 or 2 accounts, then use another 1E user account. All 1E users are able to view the Devices Table page. Check the configuration of the client and review the 1E Client settings in the 1E Client configuration file. To view CONF file locations for each platform, click to expand. The 1E Client is controlled via the 1E Client configuration file 1E.Client.conf which resides in the installation folder along with the 1E Client executable. The default installation location used for the different OS supported by the 1E Client are given in the following table: Windows: %ProgramFiles%\1E\Client Linux and Solaris: /etc/1E/Client Mac: '/Library/Application Support/1E/Client' The configuration file uses ASCII encoding. A comment line starts with the # symbol.

Verify 1E Client to 1E Platform communications (stage 1 and 2 instructions)

To run the following tests you need:

At least one test device has 1E Client installed and above TCNA verification tests passed, refer to Verify 1E Client installation.

To run the following tests you need to log on to a workstation with a user account that is assigned to at least one of the 1E administration roles.

Ref	Test	Expected response	Remediation
TCNA01	See TCNA01 above.	Each Test Device is listed on the Endpoint Troubleshooting Devices page.
TCNA05	Connect to the 1E portal as Test User 1 Open the Endpoint Troubleshooting application and go to the Home page Type verification Select 1E Platform verification stage 1 Click Ask this question	When the 1E Platform verification stage 1 question is asked, the view changes to the InstructionHistory Responses page. The InstructionHistory Responses page lists the software products installed on each Test Device. Contents are shown for online Devices that have the 1E Client installed and running. If you view other Endpoint Troubleshooting pages and want to get back to the InstructionHistory Responses page, then you should select Instruction History from the navigation menu on the left side, and you should see a list of the instructions that have been run. You may then click on the name of the instruction to view its responses. The Client log indicates: Running instruction Successfully processed instruction.	You may need to refresh the InstructionHistory Responses page. Verification stage 1 tests communication between the 1E Client and Switch. Any issues will appear in the Client log. Check each test device has the 1E Client running and is online.
TCNA06	Connect to the 1E portal as Test User 1 Open the Endpoint Troubleshooting application and go to the Instructions > History page Click on the 1E Platform verification stage 1 instruction to view the response details Click on the Actions tab Type verification Select 1E Platform verification stage 2 (all platforms) Click Perform this action Enter the password for the Test User 1 account If 2FA is enabled, enter the authentication code	If Two-Factor authentication (2FA) is enabled, then Endpoint Troubleshooting will prompt for an authentication code, and Test User 1 should receive an authentication code by email. Endpoint Troubleshooting view changes to Instruction pending approval. Test User 2 should receive an email asking for approval.	This stage of the Verification tests communication between the 1E Server and the SMTP relay/gateway. If 2FA is enabled and Test User 1 does not receive an email with the authentication code, then: Check the Coordinator log and confirm it is using the correct configuration for the SMTP server. If Test User 2 does not receive an email, then: Check the user is assigned to the 1E Platform role The 1E Platform role has access rights which include Approver Check the Coordinator log and confirm it is using the correct configuration for the SMTP server.
TCNA07	Either connect to the 1E portal as Test User 2 and click on the notification icon Or click on the link in an email received in the previous step and wait for a browser to connect you to the 1E portal View the Request for action approval for the 1E Platform verification stage 2 (all platforms) action Tick the box I understand approving my request impacts my IT environment Click Approve.	When clicking on the link in the request for approval email, a browser should open automatically and take you to the Notifications page. You can view notifications and approval requests at any time by clicking on the notification icon. The icon will show the number of actions pending approval by the logged-on user. When the request is approved by Test User 2: The Endpoint Troubleshooting view changes to Approval has been processed successfully Test User 1 should receive an email saying the action has been approved.	If Test User 2 is unable to approve the request, then: Check the user is assigned to the 1E Platform role The 1E Platform role has access rights which include Approver.
TCNA08	Connect to the 1E portal as either Test User 1 or 2 Open the Endpoint Troubleshooting application and go to the Instructions > History page Click on the 1E Platform verification stage 2 instruction to view the response details.	Response details show a list of devices and their Client configuration details. You may need to refresh the Details page. This stage of the verification tests the Client's connection to the Background Channel. Successful execution of the action will cause the following to appear in the Client log: Duplicate log entries showing a repeat run of the previous question A series of log entries showing a connection to the Background Channel, then a script is downloaded and run: Windows - getConfig.ps1 PowerShell file Linux and MacOS - parseconfigStarter.sh bash and parseconfig.pl perl files. Successfully processed instruction. The response to the verification stage 2 instruction indicates its test status. This instruction tests downloading a script from the Background Channel and executing it on the endpoint. A successful response is Script downloaded and executed OK. You may have to wait up to 5 minutes for the action to complete on each device. This is because the default 1E Client setting for DefaultStaggerRangeSeconds=300.