Document Purpose and Conventions
This document has the following aims:
- To provide instructions to delegates to enable completion of the practical training labs
- Where relevant, provide guidance which can be used during real world implementations
The following conventions are used to highlight important information.
Lab Information
The lab environment consists of the following computers:
Computer | Role | Subnet | AD Site |
1ETRNDC | Domain controller for the 1ETRN.LOCAL domain. The ConfigMgr package source folder is located on this server. | 10.0.0.0/24 | Datacenter |
1ETRNCM | ConfigMgr server with a local SQL instance. All ConfigMgr roles are installed in this server. | 10.0.0.0/24 | Datacenter |
1ETRNAP | Application server that hosts ContentDistribution and other databases. SQL is installed locally. | 10.0.0.0/24 | Datacenter |
1ETRNW71 | Windows 10 client computer | 10.0.1.0/24 | Remote Office - Floor 1 |
1ETRNW72 | Windows 10 client computer | 10.0.2.0/24 | Remote Office - Floor 2 |
1ETRNW73 | Windows 10 client computer | 10.0.1.0/24 | Remote Office - Floor 1 |
1ETRNW101 | Windows 10 client computer | 10.0.1.0/24 | Remote Office - Floor 1 |
1ETRNW102 | Windows 10 client computer | 10.0.2.0/24 | Remote Office - Floor 2 |
Ignore any patching popups on our servers. We have deliberately left them unpatched to show patching via Patch Success and/or Nomad
Unless otherwise indicated, logon to the lab VMs using the following accounts
System | Account |
1ETRNDC | 1ETRN\Administrator |
1ETRNAP | 1ETRN\AppInstaller |
1ETRNCM | 1ETRN\SCCMAdmin |
1ETRNW71 | 1ETRN\Tachyon_Actioner |
1ETRNW72 | 1ETRN\Application_Admin |
1ETRNW73 | 1ETRN\Tachyon_Approver |
1ETRNW101 | 1ETRN\Application_User |
1ETRNW102 | 1ETRN\FullAdmin |
Upgrading the 1E Client
The lab environment already has Tachyon, Nomad, Shopping, Wakeup, and Windows Servicing Suite Installed. In this lab you will learn how to upgrade the 1E Client and how to enable a module of the 1E Client after you have deployed to the device.
Upgrading Nomad Backend
This exercise will teach you how to upgrade your Nomad infrastructure to 7.0 to support using the 1E Client on your devices.
Upgrade ActiveEfficiency
Nomad version 7.0 needs ActiveEfficiency at least v 1.10.0.62 with hotfix Q20481. We already have AE 1.10 installed in our lab. We will apply the hotfix.
- Log into 1ETRNAP as 1ETRN\AppInstaller
- Open OneDrive Shortcut on the desktop and download the contents of 1E Client Upgrade Course Content\ActiveEfficiency.v1.10.0.62 and copy Q20481-activeefficiencyserver.v1.10.0.62.msp to c:\temp
- Right click on Q20481-activeefficiencyserver.v1.10.0.62.msp and click Apply
- On the Welcome page click Update
- Once the installation completes click Finish
- Click yes to restart 1ETRNAP
Install the Console Extensions and the Nomad Tools
- Log into 1ETRNCM as 1ETRN\SCCMAdmin
- Open the OneDrive Shortcut and download 1E Client Upgrade Course Content\NomadBranch.v7.0.0.205.zip to c:\temp right click and extract the contents
- Open the Config Mgr console and navigate to the Software Library Workspace
- Expand Operating Systems – Select Task Sequences
- Right Click on WSA Wipe and Load Non-Destructive and select Edit
- Scroll down to the Install and Setup Operating System Group
- Highlight Stage Nomad Package action and notice that the old Nomad package is selected
- Close the Task Sequence without making any changes
- Close the Config Mgr Console
- Open an Administrative Command Prompt and change directory to c:\temp\NomadBranch.v7.0.0.205
- Type in the following command line
MSIEXEC /I NomadBranchAdminUIExt.msi /l*v NomadBranchAdminUIExt.log
- On the Welcome page click Next
- Accept the terms in the license agreement click Next
- On the Nomad Pre-Caching page ActiveEfficiency URL field type in http://1etrnap/ActiveEfficiency click Next
- On the Nomad Tachyon Integration page click Next
- On the Ready to Install page click Install
- When the Installation completes click Finish
- In the Administrative Command Prompt type in the following command line
MSIEXEC /I NomadBranchTools.msi /l*v NomadBranchTools.log
- On the Welcome page click Next
- Accept the terms in the license agreement click Next
- On the Ready to Install page click Install
- When the installation finishes click Finish
Verify the Installation of the Tools
- Still logged into 1ETRNCM as 1ETRN\SCCMAdmin
- Open the Config Mgr console
- Navigate to the Software Library Workspace
- Expand the Operating Systems node. Click Task Sequences
- Right click the WSA Wipe and load Non-Destructive task sequence and select Edit
- Scroll down to the Install and Setup Operating System group
- Select the Stage Nomad Package step
- Notice that it now shows 1E Client Package (instead of Nomad Package) in the details of the action (right pane). The action name is still called Stage Nomad Package. Notice that the old 6.3 Nomad Package is still selected.
- Close the Task Squence without making any changes
Update the Boot Images on the DP
Now that we have installed Nomad 7.0, we need to update our Boot Image content on the DPs so that the new binaries will be injected to our boot images. Make sure you update all the boot images that you will use in our environment. We are only using our PXE Everywhere Boot Image in this lab.
- Navigate to the Boot Images node
- Right click the PXE Everywhere Boot Image and choose Update Distribution Points
- Click Next. Click Next
- When the update completes click Close
Using the 1E Client Deployment Assistant
Now that the Nomad back end has been installed, it is time to get our clients installed. In this exercise, we will deploy the 1E Client with multiple modules installed first. The next exercise will teach you how to enable modules after the installation of the 1E Client (no need to redeploy if you purchase another 1E Product later). In most enterprises, there will be a Systems Management platform to manage devices in the environment. In our lab we will use ConfigMgr, but the concept of deploying the 1E Client as a piece of software will apply to any Systems Management platform.
- Log into 1ETRNCM as 1ETRN\SCCMADMIN
- Launch the OneDrive shortcut from the desktop and download the contents of 1E Client Upgrade Course Content\1EClientDeploymentAssistant.v1.4.0.27 folder to c:\temp
- Launch the 1EClientDeploymentAssistant.exe
- On the Welcome page click Next
- On the License Terms page check I accept the license terms. Click Next
- On the Configuration Manager Connection page click connect. Once it connects click Next
- On the General settings page 1E License File field click browse and select the licenses.txt file in the 1EClientDeploymentAssistant folder
- In the 1E ActiveEfficiency Server URL change default to *http://1etrnap/ActiveEfficiency*
- On the Application and Package Content Sources fields type in \\1etrndc\ConfigMgrSource\Software
- Check the Distribute Content box and select All Distribution Points from the drop-down. Click Next.
- Uncheck all the boxes except for the 1E Client. Click Next
- On the 1E Client 5.0.0.745 page change the Limiting Collection to All Desktop and Server Clients Click OK
- On the Tachyon and other client settings page Switch field type in Tachyon.1etrn.local:4000
- In the Background Channel field type in *https://Tachyon.1etrn.local:443/Background*
- Check Enable Inventory and Enable Shopping. Type in http://Appstore/Shopping in the Shopping Web URL field and check Enable Edge/Windows App Browser support. click Next.
- On the Nomad Client Settings page check Enable Nomad Click Next
- Once the Summary page activates the Create button click Create
- Once that completes click Next
- Click Finish
- Launch the ConfigMgr console from the taskbar
- Navigate to Software Library – Application Management – Applications
- Select the 1E Client 5.0.0.745 and click Deployment Types tab at the bottom
- Right Click the 1E Client x64 deployment type and choose Properties
- Click the Requirements tab. Click the Operating System requirement type and click the edit button
- Scroll down and select all the x64 Server Operating Systems also. Click Ok. Click Apply. Click Ok
Add Supersedence for the 1E Client
You will need to either disable your current deployments for any of the products you are upgrading or, if you are deploying using the Application Model (for both the old and new versions), you can configure supersedence. If you do not configure supersedence or disable any deployments the device will be reverted to the prior version.
- Navigate to Software Library – Application Management – Applications
- Right Click 1E Client 5.0.0.745 select Properties
- Click the Supersedence tab. Click Add. Click Browse and select 1E Nomad 6.3.201.6 and Click Ok
- In the New Deployment Type fields select 1E Client for both the x86 and the x64 new deployment type.
- Click Ok. Click Apply. Click Ok
Deploy the 1E Client Application
- Navigate to Assets and Compliance workspace and click on Devices
- Multi-select all the devices in the Lab except for 1ETRNDC and add them to an existing collection – 1E Client 5.0.0.745 – Required
- Once the collection membership shows 6
- Right Click on the 1E Client 5.0.0.745 – Required collection and choose Client Notification – Download Computer Policy.
Task Sequence Update for the 1E Client
- Navigate to Software Library workspace
- Expand Operating Systems Node Select Task Sequences
- Right click on the WSA Wipe and load Non-Destructive Task Sequence and select Edit
- Scroll down to the Install and Setup Operating System Group
- Select the Stage Nomad Package action. Click Browse Select the 1E Client 5.0.0.745 x86 Package. Click Ok
- Click Apply to save the Task Sequence. Close the Task Sequence
Validate the 1E Client Install
- On the client computer, launch the Services console from the desktop
- Confirm the 1E Client service has been installed and is running
- Navigate to c:\programdata\1E\Client
- Double- click the 1E.Client.log file and review the log
- Note the uninstall of 1E Nomad Branch 6.3.201
- Review the other settings in the log
- Navigate to c:\program files\1E\Client and review the content
- Right-click 1E.Client.conf and select Open With and open with Notepad++
- Review the different sections of the config file, ensuring you do not make any changes . Note that the settings displayed in the log file are all defined here
- Scroll down to the bottom section Module Settings
- Notice that the WakeUp Module is not enabled
- Close the config file, ensuring no changes were made. If asked to save it, click NO
Enabling a Module of the 1E Client after Initial Deployment
This exercise is to simulate how you would enable a module of the 1E Client after you have done your initial deployment. If you wanted to stay at Nomad version 6.3 while you were upgrading to Tachyon v5.0 you would deploy the 1E Client with the Nomad module not enabled. Later, once you are ready to upgrade Nomad (i.e. you have the backend upgraded and are ready to deploy to your workstations) you would then use a Configuration Item and deploy a baseline to enable the Nomad module of the 1E Client. In this exercise we are going to enable the WakeUp module using Configuration Items deployed in a Baseline. 1E provides all the Configuration Items for you to import into Config Mgr to enable any of the modules. The 1EClientCIs.zip can be downloaded from Reconfiguring 1E Client: Using Configuration Manager to enable and reconfigure the 1E Client after installation.
Import the Configuration Item
- Still logged into 1ETRNCM as 1ETRN\SCCMAdmin
- Launch OneDrive shortcut and copy the contents of 1E Client Upgrade Course Content\1EClientCIs to c:\temp
- Launch the Config Mgr Console and navigate to Assets and Compliance – Compliance Settings – Configuration Items
- Right Click Configuration Items and select Import Configuration Data
- Click Add and navigate to C:\temp\1EClientCis\Enable WakeUp Module in 1E Client.cab Click Open. Click Yes on the warning box
- Click Next. Click Next. When the import finishes click Close
Create the Baseline and add the Imported CI
- Right click on Configuration Baselines and choose Create Configuration Baseline
- In the Name field type in Enable WakeUp in the 1E Client
- Click Add choose Configuration Items. Select our Enable WakeUp in the 1E Client CI that we just imported
- Click Add then click Ok
- Click OK
Deploy the Baseline to Enable the WakeUp Module
- Navigate to Configuration Baselines – Select the Enable WakeUp in the 1E Client baseline and Right Click and select Deploy
- Check the box to Remediate noncompliant rules when supported
- Check the box to Allow remediation outside the maintenance window
- In the Collection Field click Browse and Select Device Collections – Lab Workstations
- Click Ok. Click Ok
- Navigate to Device Collections – Right click on Lab Workstations and select Client Notification – Download Computer Policy – Click ok on the warning
Verify WakeUp is Enabled for the 1E Client
- Log into 1ETRNW101 as 1ETRN\User
- Launch the Config Mgr applet from the desktop
- Click the Configurations Tab. Select the Enable WakeUp Baseline and click evaluate
- Click Refresh until it shows compliant
- Navigate to c:\ProgramData\1E\Client and launch 1E.Client.Log
- Search the log for Module 'WakeUp' has been installed
- Read the lines below the installation. Notice that the 1E Client is checking for prior versions of WakeUp in order to uninstall it. In our case there was not a prior version installed on the device.
- Launch c:\Program Files\1E\Client\1e.Client.conf
- Scroll down to the bottom and see that WakeUp Module has been enabled
Lab Summary
In this lab, we learned how to upgrade to Nomad 7.0 and deploy the 1E Client. We then learned how to enable additional modules of the 1E Client for environments that have already deployed.