Skip to main content

Shopping

Installing the Shopping Receiver

Installing the Shopping Receiver on the Configuration Manager CAS enables application deployments, using legacy or application model applications and Operating System deployments.

Prior to installation of each Shopping Receiver, complete the Preparation steps.

After installation each Receiver, you must use the Shopping Admin Console to add the Configuration Manager site to the Sites list. This authorizes the new Receiver to access the Shopping Central server, the procedure for this is described in Setting up Configuration Manager sites.

Note

If you intend installing Shopping Central and the Shopping Receiver services on the same server, install Shopping Central first.

Installing the Shopping receiver with the wizard

The installer MSI file for the Shopping Receiver is ShoppingReceiver.msi and will only run on a server using a supported server operating system with a local installation of a Configuration Manager site.

When running the MSI, ensure you:

To install the Shopping receiver, start a command prompt with elevated rights using Run as administrator, change directory to the location where you downloaded ShoppingReceiver.msi and run the following suggested command-line:

msiexec /i ShoppingReceiver.msi /l*v ShoppingReceiverInstaller.log

Warning

The installer will terminate if a local installation of Configuration Manager site is not detected.

Running ShoppingReceiver.msi
Welcome

This screen provides the version number for the Shopping Receiver and outlines what the wizard will do.

Click Next to go to the next screen.

Receiver_New.png
License Agreement

You must read and then accept this license information by clicking the I accept the terms in the license agreement option before you can continue with the installation.

Click Next to go to the next screen.

License_agreement_Receiver.png
Install Type

On the Install Type screen, if displayed, choose either:

  • Upgrade – upgrades existing Shopping Receivers to the latest versions

  • Side-by-side installation – installs the latest version of the Shopping Receiver alongside existing ones. Use this option if you intend to run the older versions of the Shopping Receiver in parallel with the latest versions.

    Note

    This screen is displayed only if a previous version of the Shopping Receiver is detected.

    If the existing version is Shopping version 4.7 or earlier, you can only upgrade. Side-by-side installation is not supported in that case.

Click Next to go to the next screen.

Install_type_receiver.png
Destination Folder

The default destination folder will be suitable for most installations. Click Change... if you want to specify a new location for the installation.

Click Next to go to the next screen.

Destination_folder_receiver.png
Receiver Service Account

Choose whether the Shopping Receiver service account uses Network Service or a domain account. See Preparation: Service accounts for more details.

If you're using a domain service account, enter the name and password for the account, you would have already set this up when you were Installing Shopping Central.

Click Next to go to the next screen.

Service_account_receiver.png
Policy Refresh

Configure how policy refresh is implemented. Enable or disable its integration and set the refresh delay. The choices determines how the Receiver initiates a policy refresh on the client, effectively enabling a rapid software push to the user's machine

If the installer detects that 1E WakeUp Server is installed on the same server, WakeUp will be the default option. Otherwise, Native is the default

Selecting WakeUp or Native allows you to specify the Policy Refresh delay in seconds. The default is 10 seconds, which causes WakeUp or Shopping to send a policy refresh 10 seconds after the Shopping Receiver has added the machine to a collection and wait for Configuration Manager to create the machine policy and replicate it. The delay depends on the responsiveness of the Configuration Manger architecture.

Click Next to go to the next screen.

Policy_refresh_receiver.png
Shopping URL Prefix

Set the base URL for the Shopping Central Website so that the Shopping Receiver service can communicate with the Shopping API.

You will need to modify the URL prefix and replace the default <ShoppingCentralServer> with the host header for the Shopping website, refer to Installing Shopping Central: Shopping URL Prefix.

Click Next to go to the next screen.

Shopping_URL_receiver.png
Default Advanced Client Flags

Enter the settings to use for a default deployment.

Setting

Explanation

Default

Uses the default advertisement options.

Always download from DP

The package is always downloaded from the distribution point. This should be used when integrating with Nomad Branch from 1E.

Always run from DP

The package is always run from the distribution point.

Note

These settings affect only packages and not app-model applications whose settings are controlled with Configuration Manager.

If you have used the installer property DPFLAG on the command-line and given it a value that does not match any of the 3 options on the screen, then none of the options will be selected. In this case, do not select an option, and just click Next to continue to configure the command-line option.

Click Next to go to the next screen.

Default_config_manager_receiver.png
Configuration Manager Database Connection

Check the TLS 1.0 disabled - install using TLS 1.1/1.2 checkbox if TLS 1.0 is disabled in your environment.

Click Next to go to the next screen.

Config_manager_integration_receiver.png
Ready to Install the Program

Click Install to start the installation, or use the < Back button to go back and review your settings prior to installation.

Install_receiver.png
Completed

When the installer completes, optionally check Show the Windows Installer log,then click Finishto close the installer.

Complete_receiver.png
Installing the Shopping Receiver in unattended mode

To install the Shopping receiver in unattended mode, you must provide the Shopping URL Prefix and the Shopping Receiver service user account and password. Other settings are optional.

In the example the policy refresh setting is configured to use Native mode even if there is a WakeUp Server already installed.

The command-line example is separated onto different lines for clarity and is entered on a single line in practice. These and other command-line switches are described in Shopping Receiver installer properties.

Installing the Shopping Receiver in unattended mode

msiexec /i ShoppingReceiver.msi 
SHOPPINGURLPREFIX="https://shopping.acme.local" 
SVCUSER=ACME\svc_ShoppingRcvr 
SVCPASSWORD=svcpassword
POLICYREFRESHMODE=NATIVE
/l*v %temp%\ShoppingReceiver-install.log /qn