In this lab, you will install all Shopping Central components on the 1ETRNAP server along with the Shopping Receiver on the 1ETRNCM server. In addition, the Shopping agent will be installed on all PCs using ConfigMgr.
Prepare the environment
In this exercise, you will prepare the lab environment with the necessary configuration and components required by Shopping.
Understanding Shopping Users and Groups
Several components of Shopping are run with the identity of either a defined user account or a special system account (such as Network Service). Beyond the accounts used by the system, there are also roles within Shopping that define the level of access that users of the system have. These roles are assigned to AD security groups and users are added into these groups to assign them the associated role. In this task, you will review the accounts and groups that need to be created or designated for Shopping.
The installation of the various Shopping components requires specific permissions. Whichever user performs the installation of the various components requires the permissions specified below.
To install the Shopping Central server components, the installer account requires the following:
- Local admin rights on the server that Shopping Central is being installed on
- SQL Server sysadmin rights on the Shopping Database server
- Local admin rights on the ConfigMgr server that Shopping will connect to
- SQL Server sysadmin rights on the ConfigMgr Primary site database server that Shopping Central will connect to (the CAS in multi-site hierarchy) in order to create a SQL Login for the Shopping Central service account (this is then added as a user to the ConfigMgr database)
- Must be a member of the local SMS Admins group on the ConfigMgr server as the installer adds ConfigMgr security rights (through WMI) for the Shopping Central Service account
- Must be configured as a Full Administrator in ConfigMgr
- Must have a minimum of "Write Member" security right on the Full Shopping DB Admin Access and SMS / ConfigMgr Database Access AD groups defined during installation either through the UI or the installer properties SHOPPINGCONSOLEADMINUSERS and SHOPPINGCONSOLESMSUSERS.
To install the Shopping Receiver, the installer account requires the following:
- Local admin rights on the ConfigMgr Primary site server where the Receiver is being installed
- Must be a member of the local SMS Admins group on the ConfigMgr server and a member of the Full Administrators role in ConfigMgr as the installer adds ConfigMgr security rights (through WMI) for the Shopping Receiver Service account
The Shopping Central Service security principal is a Domain User specified during Shopping Central installation (through either the installer UI or using the SVCUSER and SVCPASSWORD installer properties).
This account requires the following permissions and configuration. Items marked * are configured by the Shopping Central installer.
On the Shopping Central server
- Log on as a service user right*
On the Shopping database
- Access to the Shopping database is managed through Database Roles (db_ShoppingConsoleAdmin and db_ShoppingConsoleUser). The installer adds the Shopping Central service user to Full Shopping DB Admin Access group, which in turn is associated with the db_ShoppingConsoleAdmin role in the Shopping database
On the ConfigMgr Primary site server (or CAS)
- db_datareader role on the ConfigMgr database*
In Active Directory
- Requires an email account to be defined in the Email attribute of the user. This email account is used to send system emails to administrators
- If Shopping AD Integration is to be used to manage self-service of AD group membership, the Shopping Central Service account must have write access to the AD groups which are to be managed by Shopping
The Shopping Receiver Service runs on each ConfigMgr Primary Site and primarily manages the creation of Collections and Deployments on the local site.
Note that this user (or group if multiple accounts are used) must be specified first during the Shopping Central installation, either through the installer UI or using the RECEIVERACCOUNT installer property as the Central Service uses this as a means of authorizing the receiver that is connecting to it.
For each Receiver installation, the account user name and password must also be provided to install the service, through either the UI or the SVCUSER and SVCPASSWORD installer properties.
The Shopping Receiver account requires the following permissions. Items marked * are configured by the Shopping Receiver installer.
On each ConfigMgr Primary Site
- Log on as a service user right*
- Membership of the local SMS Admins group* (required for access to the SMS Provider)
- The following ConfigMgr Security Rights are required
Configuration Policy Full
Distribution Point Read
Distribution Point Group Read
Global Condition Full
Status Messages Read
Task Sequence Package Read
- db_datareader role on the ConfigMgr database
- EXECUTE permission on the ConfigMgr database scalar functions fn_GetAppState and fnGetSiteNumber
On every workstation
- To support Policy Refresh or allowing a user to request an application for a computer more than once ('re-shopping'), the Shopping Receiver Service account (or Shopping Receivers group if multiple accounts are used) must be added to the local Administrators group on each workstation on which these features are to be used. This is because these features require the Receiver service to interface directly with the Configuration Manager client through WMI
Before installing Shopping, you must define a Shopping Admin account or group in AD that will be used the first time you open the console (additional users can be added through the console).You also need to define AD groups that will be assigned to the Report Viewer and License Manager roles in the Shopping console.
Shopping Admin account/group
The Shopping Admin account or group specified during the Shopping Central Service installation (either in the UI or by the ADMINACCOUNT installer property) is initially the only security principal that has visibility of all nodes in the Shopping Admin Console and the Administration tab in the Shopping Web Portal.
During the Shopping Central installation, the Shopping Admin account (or group), is also added to the Full Shopping DB Admin Access and SMS/ConfigMgr Access groups (detailed later in this section) to provide the necessary access to the Shopping and ConfigMgr databases to perform all admin tasks.
This account (or group) must have a valid email account defined in AD.
The Shopping Report Viewer account or group defined during the installation of the Shopping Central Service (using either the UI or the REPORTSACCOUNT installer property) is granted permissions necessary to view the Shopping reports by the Shopping Central Service installer. Only this user (or members of the group) will see the Reporting tab on the Shopping Web Portal.
The Shopping License Manager account or group defined during the installation of the Shopping Central Service (using either the UI or the LICENSEMGRACCOUNT installer property) receives e-mail notifications when application license thresholds are reached. This user or group must therefore have a valid email address defined in Active Directory.
When a user of the Shopping Console requires access to either the Shopping database (to manage Shopping objects) or the Principal ConfigMgr Site database (to look-up Sites, Packages and Programs), they are granted access through SQL Database Roles defined (and created during the Shopping Central installation) in the respective databases. The three AD groups described below are associated with these SQL Database Roles.
Full Shopping DB Admin Access group
This group, specified during the Shopping Central Service installation using either the UI or the SHOPPINGCONSOLEADMINUSERS installer property, is associated with the db_ShoppingConsoleAdmin Database Role in the Shopping database.
The db_ShoppingConsoleAdmin database role is granted full permissions on all objects presented through the Shopping Admin Console. This allows members of the Full Shopping DB Admin Access group to manage Node Security, allowing them to define the users and groups that can access each of the nodes in the Shopping Console.
The specified Shopping Admin account / group is added to the Full Shopping DB Admin Access group during installation of the Shopping Central component.
This group, specified during the Shopping Central Service installation using either the UI or the SHOPPINGCONSOLEUSERS installer property, is associated with the db_ShoppingConsoleUser Database Role in the Shopping database.
The db_ShoppingConsoleUser role has restricted permissions in the Shopping database necessary for managing Approvers and User and Computer Categories.
Definition of Sites and Applications in the Shopping Console require read access to the Principal ConfigMgr site database. This is provided through membership of the SMS / ConfigMgr Access group specified during the Shopping Central installation using either the UI or the SHOPPINGCONSOLESMSUSERS installer property. The specified group is associated with the db_datareader Database Role on the Principal ConfigMgr site database.
By default, as users or groups are granted access to a node within the Shopping console, the console adds these users or groups (under the context of the logged on user) to the relevant database access groups according to the access required for that particular node. This requires the Full Shopping DB Admin Access group to be granted full permissions on itself and the other two groups when they are first set up in AD.
This automatic group management can be disabled in the Console Settings by setting the Admin Console Manages Groups setting to False. If this is done, users and groups will need to be manually added to the appropriate groups before they attempt to use the Shopping Console. The table below lists the Admin Console Nodes and the group memberships that provide access to them.
Full Shopping DB Access group
Limited Shopping DB Access group
SMS/ConfigMgr DB Access group
Ensure users and groups have email AD attribute set
Shopping uses email as the primary notification method. It is therefore important that all users that interact with Shopping, as well as some of the special accounts and groups identified in the previous task, have a valid email address defined in Active Directory.
- Log on to 1ETRNDC as 1ETRN\Administrator and start Active Directory Users and Computers
- Review the following users and groups and ensure they have the specified email address defined in the General Properties tab
User or Group
Create a DNS Alias
- Log into 1ETRNDC as 1ETRN\Administrator
- On 1ETRNDC select DNS from the Start page
- In DNS manager, expand 1ETRNDC > Forward Lookup Zones and select 1ETRN.LOCAL
- Select the Action menu and select New Alias (CNAME)…
- In the Alias name field, type APPSTORE
- Click the Browse… button next to Fully qualified domain name (FQDN) for target host, browse to 1ETRNDC > Forward Lookup Zones > 1ETRN.LOCAL, select 1ETRNAP. The new Resource Record dialog should look like the figure below. Click OK
- Select OK to complete the New Resource Record wizard
- From a command prompt, ping appstore. Ensure it returns 10.0.0.4(1ETRNAP)
Review Windows Features, Roles and Role Services
1ETRNAP has IIS configured as required to support ActiveEfficiency up to this point in the lab exercises. The Shopping Central Server components will also be installed on 1ETRNAP and has an additional role service that is required.
- Open Server Manager on 1ETRNAP
- Select Add roles and features in the Configure this local server section of the Dashboard page
- Click Next on the Before You Begin page
- Click Next on the InstallationType page
- Click Next on the Server Selection page
- In the list of roles on the Server Roles page, scroll down and expand Web Server (IIS) and then Web Server
- Expand Common HTTP Features and select HTTP Redirection and click Next
- Click Next on the Features page
- Click Install on the Confirmation page and close the wizard when complete
- Close Server Manager
Create Service Principal Name (SPN)
The Shopping Website Application feature creates the Shopping Application Pools in IIS that use the NETWORK SERVICE identity. Connection to the web application is made through an HTTP service class request on the DNS address of the host. However, because the Shopping web site is not part of the default web site, it requires a separate Host Header and corresponding DNS alias to distinguish it from the Default Web Site on the same server.
It is therefore necessary to define the host (1ETRNAP) as the security principal for the HTTP service class on the address APPSTORE.1ETRN.LOCAL, so that when clients request a connection to
- Log on to 1ETRNDC as 1ETRN\Administrator
- Open a command prompt and type the following command. This will list all Service Principal Names currently held by the 1ETRNAP computer
- The results should appear as below. Note that SPNs have already been defined for …..
- To add an SPN to 1ETRNAP for the DNS name APPSTORE , run the following commands
- To verify the update, run the following command again
- The results should now include the SPNs for the APPSTORE DNS address
Create ConfigMgr Administrative User for the Shopping Central Service
One of the features of Shopping, OS Filtering, provides the ability to filter the applications presented to users based on operating system criteria such as Operating System Version (Windows 7 vs. Windows 10) or Operating System Architecture (32-bit vs. 64-bit). If an application installation will fail because of operating system related prerequisites, it doesn't make sense to display these applications to users in the Shopping portal.
Because the information required to filter applications based on operating system criteria resides in WMI, the Shopping Central Service will need to be granted permission to access WMI remotely.
In this task, you will grant the Shopping Central Service these rights by adding them as an administrative user with Read access to ConfigMgr objects in WMI. This will support the OS Filtering exercise later in the labs.
- Log into 1ETRNCM as 1ETRN\SCCMAdmin. Launch the SkyTap Shared Drive shortcut on the desktop and navigate to 1E Shopping - Course Content\Shopping 5.5 Course Content\ download and copy MiscFiles.zip to C:\Temp right click and extract all. Then from the MiscFiles folder copy the 1E Shopping Central Service Security Role.xml file to C:\Temp
- Launch the ConfigMgr console. In the Administration workspace of the ConfigMgr console, expand Security and select Security Roles
- Right-click on Security Roles and choose Import Security Roles
- Browse to C:\Temp and double-click on the 1E Shopping Central Service Security Role.xml file and observe that 1E Shopping Central Service now appears in the list of Security Roles
- Right-click on Administrative Users in the Administration pane and select Add User or Group
- Click on the Browse… button and enter svc_ShoppingCentral as the object name and click Check Names
- Click OK when the name resolves
- In the Assigned security roles section, click the Add… button
- Select 1E Shopping Central Service and click OK
- Click OK to close the Add User or Group dialog box
Add Receiver Service Account to local Administrators on all workstations
As you learned in the Exercise Prepare the environment (Shopping Receiver Service account ) the Shopping Receiver account requires local admin rights on client workstations in order to support the Policy Refresh and Reshopping features. The best way to configure local administrative rights for the Shopping Receiver service account / group is to add the account to the local Administrators group on workstations using Group Policy (Restricted Groups).
- On 1ETRNDC, start Active Directory Users and Computers from the Start menu
- Locate the svc_ShoppingReceiver account in the Users container and double-click it to open the svc_ShoppingReceiver Properties
- Select the Member Of tab, click Add…, enter Workstation Admins and click OK
- Click OK to close the svc_ShoppingReceiver Properties dialog box, then close Active Directory Users and Computers
Install Shopping Central
In this exercise, you will install all Shopping Central components onto 1ETRNAP.
Install Shopping Central on Application Server
- On 1ETRNAP and log in as 1ETRN\AppInstaller. Launch the SkyTap Shared Drive shortcut on the desktop and navigate to 1E Shopping - Course Content\Shopping 5.5 Course Content\Shopping.v126.96.36.1997 and copy ShoppingCentral.msi to C:\Temp
- Start a command prompt (Run as administrator) and switch to the C:\Temp directory
- Run the following command to start the installation wizard
- On the Welcome page click Next
- On the Shopping Prerequisite page, ensure all the checks passed and click Next
- Accept the license agreement and click Next
- On the Installation Type page, select Complete Install and click Next
- On the Customer Information page, input an Organization name. Copy and paste the license key from 1E Shopping - Course Content\Shopping 5.5 Course Content\License.txt by launching the SkyTap Shared Drive shortcut on the desktop into the Shopping License Key: field and click Next
- On the Custom Setup page, ensure all features are selected for installation and click Next
- On the Database Server page, leave the server as (local) and the Database Name as Shopping2 and click Next
- On the 1E ActiveEfficiency Server page, enter 1ETRNAP as the name of the ActiveEfficiency Server and click Next
- On the Active Directory Integration page, type 1ETRNDC.1ETRN.LOCAL and click Next
- On the Service Account page, in the User name field, type 1ETRN\svc_ShoppingCentral and in the Password field, type Passw0rd
- In the field for the receiver service account, type 1ETRN\svc_ShoppingReceiver and click Next
- On the Exchange or SMTP Server page, type 1ETRNDC.1ETRN.LOCAL and click Next
- On the SMS / System Center Configuration Manager Integration page, enter the name of the Principal ConfigMgr site server, in this case 1ETRNCM.1ETRN.LOCAL and click Next
- On the Admin Console Node Security page, enter the following information and click Next
- On the Shopping Management Accounts page, enter the following information and click Next
- On the Website Configuration page, in the Host Header field, type APPSTORE and click Next
- On the Shopping URL prefix page, ensure that http://appstore is displayed and click Next
- On the Ready to Install the Program page, click Install
- Click Finish to close the setup wizard once complete
Limited Shopping DB Admin Access: 1ETRN\ShoppingConsole_Users
SMS / ConfigMgr Access: 1ETRN\ShoppingConsole_SMSUsers
Reports access account: 1ETRN\Shopping_ReportViewers
License manager account: 1ETRN\Shopping_LicenseManagers
Review the installation
In this task, you will observe the changes made by the Shopping Central installer.
- Open Windows Explorer and browse to C:\Program Files (x86)\1E\Shopping. Note the following subfolders:
- From the Start screen start Internet Information Services (IIS) Manager, expand 1ETRNAP > Sites and observe the Shopping website
- Select Application Pools (just above Sites) and note that there are two application pools for Shopping (Shopping Pool and ShoppingAPI Pool) and that they are configured to run with the identity of NETWORK SERVICE
- Start the Registry Editor (from the Start screen, start typing regedit and click regedit.exe when it appears in the search results) then navigate to HKLM\Software\1E\ShoppingCentral. Note that this only contains licensing information which is hashed
- In the Registry Editor, navigate to HKLM\Software\Wow6432Node\1E\ShoppingCentral. Note that this contains basic information regarding the installation
- Open the Services console (from the Start screen) and identify the 1E Shopping Central service. Ensure this service is running
- Open Microsoft SQL Server Management Studio (from the Start screen) and expand the Shopping2 database. Note that the installer has created objects (tables, views, stored procedures etc)
- In the Security node of the Shopping2 database, navigate to Roles > Database Roles and note that the db_ShoppingConsoleAdmin and db_ShoppingConsoleUser roles have been created by the Database feature installation. View the properties of both and note that the group ShoppingConsole_Admins is added to the ShoppingConsoleAdmin role and that ShoppingConsole_Users is added to the ShoppingConsoleUser role
- Browse to C:\ProgramData\1E\ShoppingCentral. This is where you will find the ShoppingCentral diagnostic log. Double-click ShoppingCentral.log to open it. Review the log entries focussing on service startup tasks
- From the Start screen, start typing Shopping. When Shopping Administration appears in the search results, right-click it and select Pin to Taskbar (you'll be using this a lot, so let's make it easy to get to)
- Now click Shopping Administration on the Start screen. Ensure that the Shopping Admin Console opens without errors and note the different nodes available in the left-hand pane. We'll come on to each of these throughout this course
- Open Internet Explorer (from the Start screen) and go to http://appstore/shopping
- Ensure the Shopping web page opens successfully. There won't be much of interest on it currently, but the Home page should load without errors
This is the Shopping Administrator Console
This is the Shopping Central Service and includes workflow integration components for integration with 3rd party systems
This folder contains all the binary files used to configure the Shopping SQL database. Using compiled code to manage the SQL configuration enables Shopping to be easily patched using Windows Installer patches (MSP).
This folder contains the Shopping website and Shopping API components
Configure HTTP Redirection
- Open Internet Information Services (IIS) Manager and select the Shopping web site
- In the main center pane with all the icons, double-click the HTTP Redirect icon in the IIS section (you may need to scroll down to see it)
- Check the Redirect requests to this destination option and enter ../shopping
- Check the Only redirect requests to content in this directory (not subdirectories) option
- Click Apply (in the Actions list on the right)
- Open Internet Explorer (if the Shopping site is already open, close and reopen the browser) and browse to http://appstore to confirm the redirection is working and the shorter URL can be used
Increase Shopping Central logging level
In order to use the Central Service log file to monitor processes throughout this course, you will now increase the level of detail that is written to the ShoppingCentral log.
- On 1ETRNAP browse to C:\Program Files (x86)\1E\Shopping\CentralService
- Make a backup copy of ShoppingCentral.exe.config
- Right-click on ShoppingCentral.exe.config and select Edit to open the file in Notepad
- Search for the text <level value="INFO"/> in the <log4net> section of the file
- Replace the word INFO with ALL and save the file
Reduce the Cache Duration for user access to the portal
When a user launches the Shopping portal from a given computer for the first time, Shopping will evaluate the applications that are available to the user based on the User Categories associated with that the user and Computer Categories associated with that the computer. Rather than performing this evaluation every time the user logs on to the Shopping portal, the information is cached, along with the last logon time for that particular user and computer combination. If the Shopping portal is launched within 15 minutes of the last time the user launched Shopping from the same computer, the available applications will reflect whatever was cached at that earlier time.
As we will be making many changes to categories throughout this course, we do not want to be waiting around for up to 15 minutes before we see the effect of these. In this task, you will reduce this duration down to 1 minute to make things move a bit faster.
- Open Microsoft SQL Server Management Studio, select the Shopping2 database and click New Query in the toolbar
- Enter the following query and click !Execute in the toolbar. You should see (1 row(s) affected) in the Messages tab
- Restart the 1E Shopping Central service for the logging info and cache duration changes to take effect
- If the ShoppingCentral service fails to start, an error was made when editing the config file
Install the Shopping Receiver
In this exercise, you will install the Shopping Receiver Installer components onto 1ETRNCM.
Create Shopping Receiver security role in ConfigMgr
The Shopping Receiver service account requires the ConfigMgr permissions defined on page . 1E provide an XML file that can be imported to create a ConfigMgr Security Role with all the required permissions. In this task, you will import the security role definition and then add the Shopping Receiver service account to the new role.
- Log on to 1ETRNCM as 1ETRN\SCCMAdmin
- Launch the SkyTap Shared Drive shortcut on the desktop and navigate to 1E Shopping - Course Content\Shopping 5.5 Course Content\MiscFiles and copy 1E Shopping Receivers Security Role.xml to C:\Temp
- Open the Configuration Manager Console from the Start screen
- Select the Administration workspace and expand the Security node
- Right-click Security Roles and select Import Security Role
- In the Import Security Role dialog box browse to C:\Temp\1E Shopping Receivers Security Role.xml and click Open
- Right-click the Administrative Users node and select Add User or Group
- In the Add User or Group dialog box, click Browse… then enter svc_ShoppingReceiver and click OK
- Click the Add… button to the right of the Assigned security roles list, select 1E Shopping Receivers from the list of roles and click OK
- Click OK to close the Add User or Group
Install the Shopping Receiver on ConfigMgr Primary Site
In this task, you will install the Shopping Receiver Service on the ConfigMgr Primary site server.
- Launch the SkyTap Shared Drive shortcut on the desktop and navigate to 1E Shopping - Course Content\Shopping 5.5 Course Content\Shopping.v188.8.131.527 and copy ShoppingReceiver.msi to C:\Temp
- Start a command prompt (run as administrator) and switch to the C:\Temp directory
- Type the following to start the Shopping Receiver install wizard
- On the Welcome page click Next
- Accept the license agreement and click Next
- On the Destination Folder page, click Next
- On the Register Service Account page, select This Account and in the user name field, type 1ETRN\svc_ShoppingReceiver and in the password field type Passw0rd, then click Next
- On the Policy Refresh page, ensure Native is selected and set the Policy Refresh delay to 30 seconds then click Next
- On the Shopping URL Prefix page, type http://appstore and click Next
- On the Default Advanced Client Flags page, select Default and click Next
- On the Ready to Install the Program page, click Install. When the installation completes, close the setup wizard
The Receiver installer allows you to enter default settings that will be used when it creates a Deployment in ConfigMgr. These settings are especially useful if integrating Shopping with 1E Nomad. The following options are available:
Default – Uses the default deployment options for ConfigMgr.
Always download from DP – The package is always downloaded from the distribution point. This should be used when integrating with 1E Nomad.
Always run from DP –The package is always run from the distribution point (only applicable to legacy Packages).
Review the installation
In this task, you will review the effects of the Shopping Receiver installation.
- Run regedit.exe and navigate to HKLM\Software\Wow6432Node\1E\Shopping.Receiver.v5.5.0. Note that this contains basic information regarding the installation
- Open the Services console from the Start menu and identify the 1E Shopping Receiver+5.5.0 service
- Browse to C:\ProgramData\1E\Shopping.Receiver\v5.5.0. This is where you will find the Shopping Receiver diagnostic log. Double-click Shopping.Receiver.log to open it in CM Trace and ensure the Shopping Receiver service started successfully without any errors
- Browse to C:\Program Files (x86)\1E\Shopping\Shopping.Receiver.v5.5.0. This folder contains the Shopping Receiver binaries that interact with ConfigMgr
- Double-click Shopping.Receiver.exe.config to open it in Notepad and observe the configurable settings for the Shopping Receiver service in the <appSettings> section. Many of these settings were specified in the Install wizard
- Search for level value="Info"
- Change the Info to All
- Save the file
- Open SQL Server Management Studio and navigate to Databases > CM_PS1 > Security > Users
- Double-click the 1ETRN\svc_ShoppingReceiver user (this user was added to the ConfigMgr database by the Shopping Receiver installation) to view its properties
- In the Database User – 1ETRN\svc_ShoppingReceiver dialog box, select the Membership page on the left and observe that this user has been assigned only the db_datareader role on the ConfigMgr database
- In the Database User – 1ETRN\svc_ShoppingReceiver dialog box, select the Securables page. Note that the user has been granted Execute permissions on the fn_GetAppState and fn_GetSiteNumber scalar functions
- Click OK to close the user properties dialog box
Configure the Default Limiting Collection
The Shopping Receiver is responsible for creating ConfigMgr objects (collections and deployments) and placing computers and users into appropriate collections to allow software to be deployed. By default, the Limiting Collections for all the collections created by the Shopping Receiver is 'All Systems' and 'All Users and User Groups'. In many environments, this is not a desired configuration.
In this task, we will modify the default limiting collection for computer collections.
- Return to the Shopping.Receiver.exe.config file
- Locate the <appSettings> section and observe the values in RootDeviceCollectionId and RootDeviceCollectionName
- Replace the RootDeviceCollectionId value with PS10000B
- Replace the RootDeviceCollectionName value with Lab Workstations
- Save and close the file
- Restart the 1E Shopping Receiver+ 5.5.0 service
Deploy the Tachyon agent
Previous versions of Shopping used the Shopping Agent to enable the Shopping website to retrieve information about the user's PC. In an effort to reduce the number of agents customers need to deploy, 1E is in the process of combining existing agent functionality into a single agent, which happens to be the Tachyon Agent. With Shopping 5.5, the functionality of the Shopping Agent and the new Windows Servicing Assistant (WSA) functionality has been implemented as a module of the 1E Tachyon Agent v3.2. The Tachyon Agent v3.2 must be installed on all PCs from which users will access the Shopping portal. This integration requires specific client machine identification so that Configuration Manager knows the correct client deployment target.
In this exercise, we will use the 1E Agent Endpoint Installation Solution Accelerator to create the ConfigMgr deployment objects and deploy the Tachyon Agent to all ConfigMgr clients.
Prepare to Deploy the Tachyon Agent
- Launch the SkyTap Shared Drive shortcut on the desktop and navigate to 1ETools and copy the contents of EndpointInstallation.184.108.40.206 folder to C:\Temp\EndpointInstallation.v220.127.116.11 (you may need to create the folder in Temp)
- Browse to the C:\Temp\EndpointInstallation.v18.104.22.168 folder and double-click on EndpointInstallation.exe to launch the wizard
- On the Welcome page, click Next to continue
- Accept the license terms on the License Terms page and click Next
- On the ConfigMgr Connection page, with Local ConfigMgr Site Server selected, click Connect. When the status changes to Connected, click Next
- On the General Settings page, note that the fields are pre-populated with information that is appropriate for the lab environment. Click Next
- On the Agent Selection page, deselect all items except Tachyon 22.214.171.1248 and click Next
- On the Tachyon 126.96.36.1998 page, verify that the limiting collection is set to Lab Workstations and click Next to continue
- On the Tachyon Settings page, verify that Enable Shopping Module and Edge Windows App browser support are ticked and also ensure that Shopping Web URL has http://appstore/shopping/ address is entered. Click Next to continue
- On the Summary page, once the list is finished compiling, take a moment and review the actions that are about to be taken. When ready, click the Create button
- The actions will be recorded as they are completed on the Progress page. When the Status changes to Successful, you may review the completed actions and click Next when ready
- Click Finish on the Completion page to close the wizard
Shopping Central URL : It should be set to the URL for the Shopping website. The Shopping website uses a host header, for which a DNS allias was defined earlier
http://appstore/shopping/ The Tachyon Shopping module uses a loopback mechanism that enables the browser to make calls to the Shopping Agent via the local computer. The Tachyon Shopping module contacts the Shopping Central website to get the appropriate URL to use for the local loopback mechanism and the URL is no longer locally configured, as was the case for the previous Shopping Agent Installer.
Enable Edge/Windows App Support: If users are likely to access the Shopping web site using Microsoft Ede or other Metro Browsers.
Observe the Results of Running the Endpoint Agent Installation Wizard
Once we have run the Endpoint Agent installation wizard, we will look at the objects that were created in the ConfigMgr console.
- In the ConfigMgr console, select the Assets and Compliance workspace and click on Device Collections
- Note that the 1E Tachyon 188.8.131.528 – Required collection has been created and has zero members at this point
- Click on the Deployments tab at the bottom of the page and note that the 1E Tachyon 184.108.40.2068 – Required application has been deployed to the collection
- In the Software Library workspace, expand Application Management and select Applications
- Note the 1E Tachyon 220.127.116.118 application has been created and the content has been distributed to the distribution point
Deploy the Tachyon Agent to Lab Workstations
Now that all the required components are created in the ConfigMgr console, we simply need to add our desired targets to the 1E Tachyon 18.104.22.1688 – Required collection and force a machine policy update cycle to deploy the Tachyon Agent.
- In the ConfigMgr console, go to the Assets and Compliance workspace and select Devices
- Multi-select the 1ETRNW71, 1ETRNW72, 1ETRNW73, 1ETRNW101 and 1ETRNW102 computers
- Right-click on any of them, select Add Selected Items > Add Selected Items to Existing Device Collection
- Select the 1E Tachyon 22.214.171.1248 – Required collection and click OK
- Click on Device Collections, select the 1E Tachyon 126.96.36.1998 – Required collection and refresh the view until the Member Count shows 5
- Right-click on the 1E Tachyon 188.8.131.528 – Required collection, select Client Notification and choose Download Computer Policy
Validate the Tachyon Agent component installation on each client
After a few minutes, complete the following tasks to ensure the Tachyon Agent is installed and functioning.
- Log on as 1ETRN\user
- Open Programs and Features from Control Panel and verify that 1E Tachyon Agent is installed
- Open the Services applet from the desktop and note the 1E Tachyon Agent service running
- Open the Tachyon.Agent.log file in C:\ProgramData\1E\Tachyon
- Search for the following in the log file: module.shopping.enabled and note that it is set to true
- Note the line above it, showing the URL to the Shopping API
We started this lab identifying the key users and groups that Shopping uses both internally and for administration. We reviewed the permissions and security rights that these specific users and groups require, and which of these are normally configured by the Shopping Central and Receiver installers.
We learned how to use a DNS alias, combined with HTTP Redirection, to enable Shopping to be accessed using an easily remembered URL. You also understand therefore why it is necessary to define a Service Principal Name for the HTTP service class on the alias address.
We prepared the environment for the installation of Shopping. We installed the Shopping Central service on the application server, and then installed the Shopping receiver on the ConfigMgr Primary site server.
Lastly, we deployed the Tachyon agent to our lab workstations. The Tachyon agent allows for the proper identification of the machine/user accessing the Shopping portal. It is also used for WSA orders.