Skip to main content

Shopping

Configuring the Shopping components

Shopping Central service command-line arguments

Command line arguments for the Shopping central service are:

  • Help – displays the command-line help for the Shopping Central service. -? can be used instead as a shorthand synonym

  • Relicense – value is a valid the Shopping central license key.

Relicensing Shopping Central from the command-line

If your evaluation license has expired, you can re-license Shopping with a new evaluation license or a new production license. To do this, run the ShoppingCentral executable with a command-line:

ShoppingCentral.exe -relicense=ABCDE-1234-5678-8765-4321

where ABCDE-1234-5678-8765-4321 is your new license key. The command-line may need to be run with elevated rights.

Configuring the Shopping Receiver service

The Shopping Receiver service is configured with the Shopping.Receiver.exe.config file, located by default in:

  • 32-bit systems – Program Files\1E\Shopping\Shopping.Receiver

  • 64-bit systems – Program Files (x86)\1E\Shopping\Shopping.Receiver

The user-configurable settings:

Switch

Default value

Notes

AdvertFlags

The Configuration Manager legacy package deployment creation setting. This is a decimal value that is directly related to the AdvertFlags value in the SMS_Advertisement Server WMI Class. For example, to set the alternate recommended value:

<add key="AdvertFlags" 
     value="15728672"/>

Default and recommended Configuration Manager legacy package settings has a discussion on default and recommended values for this property.

Refer to the Microsoft Configuration Manager SDK documentation for more details on the values that can be set here.

AdvertFolder

Enables folder customization where Shopping creates its adverts.

Note

Configuration Manager limits the folder name length to 127 characters.

AdvertIdPath

The path where in-progress advert IDs are stored. For example:

<add key="AdvertIdPath" 
     value="C:\TEMP\Shopping"/>

FailureStatusMessageIDs

Any Configuration Manager status IDs returned that match with the IDs provided in this parameter are considered by Shopping to indicate failure. Must be a comma-delimited list of IDs, for example:

<add key="FailureStatusMessageIDs" 
     value="10000,10001,10003,10004,10006,
            10007,10018,10019,10021,10025,
            10026,10030,10031,12101,11170"/>

PolicyRefreshDelay

The Configuration Manager Policy Refresh delay (in seconds), for example:

<add key="PolicyRefreshDelay" 
     value="10"/>

PolicyRefreshInterval

Interval (in seconds) between policy refreshes, for example:

<add key="PolicyRefreshInterval" 
     value="5"/>

PolicyRefreshMode

None

The Shopping Policy Refresh mode, for example:

<add key="PolicyRefreshMode" 
     value="Native"/>

Parameters (values are not case sensitive) are:

  • WakeUp – enables 1E WakeUp policy refresh integration and automatically detects the location of 1E WakeUp using the WakeUp API

  • Native – enables the built-in Shopping policy refresh behavior

  • None – disables Shopping policy refresh behavior.

The WakeUp option requires the following:

  • WakeUp Server to be already installed on the same server as the Shopping Receiver

  • NightWatchman and WakeUp Server infrastructure (does not require the optional NightWatchman Agent)

  • The WakeUp client to be enabled in the 1E Client, in addition to the Shopping client.

RemoteClientFlags

The Configuration Manager Advert remote client flags. This is an integer value that is directly related to the RemoteClientFlags value in the SMS_Advertisement Server WMI Class. For example, to set the alternate recommended value:

<add key="RemoteClientFlags" 
     value="2896"/>

Default and Recommended Advertisement Settings has a discussion on default and recommended values for this property.

Refer to the Microsoft Configuration Manager SDK documentation for more details on the values that can be set here.

RootDeviceCollectionId

SMS00001

ID of the root device collection for application model, machine-centric applications. By default, this is the ID for All Systems. Using this value it is possible to configure an alternative machine limiting collection.

RootDeviceCollectionName

All Systems

Name of the root device collection for application model, machine-centric applications. By default, this is All Systems. Using this value it is possible to configure an alternative machine limiting collection.

RootUserCollectionId

SMS00004

ID of the root user collection for application model, user-centric applications. By default, this is the ID for All Users and User Groups. Using this value it is possible to configure an alternative user limiting collection.

RootUserCollectionName

All Users and User Groups

Name of the root user collection for application model, user-centric applications. By default, this is All Users and User Groups. Using this value it is possible to configure an alternative user limiting collection.

ShoppingRequestAttempts

The number of times the Receiver attempts to process a Shopping request, for example:

<add key="ShoppingRequestAttempts" value="3"/>

ShoppingRequestInterval

The interval (in seconds) between checking for unprocessed Shopping requests, for example:

<add key="ShoppingRequestInterval" 
     value="5"/> 

ShoppingWebUrl

The Shopping Web service URL used for querying the API, for example:

<add key="ShoppingWebUrl" 
     value="http://localhost/Shopping.Web"/> 

StatusMessageInterval

The interval, in seconds, between checking Configuration Manager status messages, for example:

<add key="StatusMessageInterval" 
     value="10"/> 

SuccessStatusMessageIDs

Any Configuration Manager status IDs returned that match with the IDs provided in this parameter are considered by Shopping to indicate success.

<add key="SuccessStatusMessageIDs" 
     value="10008,10009,12100,11171"/> 

CommandTimeout

The time out value (in seconds) for the Shopping Receiver when fetching the list of pending AppModel deployments

<add key="CommandTimeout" 
     value="300"/>