Update POS Devices

This guide describes how to update Business Central, LS Central, and your app packages.

Note

See Project Changes for new updates to the project.

Update POS Bundle

Create a new version of the POS bundle to include a new version of one or more components/packages.

Such as:

Update the POS bundle as follows:

  1. Open NewBundlePackage.ps1 for editing.

  2. Either:

    • Update: Locate the target package in the dependency list and update to the new version number.

    • New: Add a new entry to the dependency list with the target package and version:

      ...
@{ Id = 'my-app'; 'Version' = "1.0.0" }
...
      • Add any packages related to Business Central to the POS Master bundle (bundle/yourprefix-pos-master) if you have one, such as apps, objects, add-ins or, licenses.
      • If you don't have a POS Master or any other packages should be added to the POS bundle (bundle/yourprefix-pos), such as, OPOS drivers, Hardware Station, SQL Management Studio ...

  3. Locate the bundle version number, and increment it.

    • If you have bundle/yourprefix-pos and bundle/yourprefix-pos-master, find the $Version variable and increment.
  4. Open a PowerShell console.

  5. Save the file and execute the script:

    PS C:\LS Retail\My Project> .\NewBundlePackage.ps1 -Import

  6. If you have a POS Master, update it to the new version of your bundle package:

    PS C:\LS Retail\My Project> .\UpdatePosMaster.ps1

  7. Roll out the update using circles.

Update POS Application and Platform

Follow these steps to update your POS devices or POS Master to a new version of LS Central and Business Central.

  1. Open Project.json and update LsCentralVersion to your preferred version and set BcPlatformVersion, BcAppVersion to null, simlar to:

    {
    ...
    "LsCentralVersion": "24.0.0",
    "BcPlatformVersion": null,
    "BcAppVersion": null,
    ...
}

    BcPlatformVersion and BcAppVersion are populated automatically in step 3. with the appropriate versions. You can specify the version numbers if you prefer a different, newer release of Business Central instead.

  2. Open a PowerShell console.

  3. To download the package of the selected versions to your Update Service Server, by running:

    PS C:\LS Retail\My Project> .\GetLsCentralPackages.ps1
    • Now you have the packages on your server, but you still need to update your POS Bundle package with the new versions.

  4. Open NewBundlePackage.ps1 for editing.

  5. Locate the bundle version number, and increment it.

    • If you have bundle/yourprefix-pos and bundle/yourprefix-pos-master, find the $Version variable and increment.

  6. Run: 

    PS C:\LS Retail\My Project> .\NewBundlePackage.ps1 -Import

  • Now you have at least two versions of the packages bundle/yourprefix-pos and possibly bundle/yourprefix-pos-master

    • 1.0.0: This version is still using the old BC and LS Central version

    • 1.1.0: This version now uses the BC and LS Central version you configured in step 1.

  1. If you have a POS Master, update it to the new version of your bundle package:

    PS C:\LS Retail\My Project> .\UpdatePosMaster.ps1

Rollout an Update with Circles

Before rolling out a new update, it's a good idea to have a test POS device to roll out the first update and then gradually roll out to larger and larger groups of devices.

Create a Circle

You always have one circle called outermost circle, this is a catch-all circle and you do not have to assign any POS devices to that circle. In other words, if a POS device is not assigned to any other circles, it will be caught by the outermost circle and will install / update according to its selected version.

To create a new circle, assign a POS device to it and roll out a new update just to that device, while other devices will remain on the previous version:

  1. Open deployment circles in the management portal.
  2. Select your POS bundle package (bundle/yourprefix-pos).
  3. Click on Outermost Circle.
  4. Click on New Circle.
  5. In the dialog, give the circle a name and description and select the new version (this version should be higher than the version set for Outermost Circle).
  6. Click the expand icon (>) on the Outermost Circle on the left side.
  7. Select the new circle.
  8. Below, in the Clients in Selected Circle pane, select a POS device you want to receive the update, and then on the plus (+) icon to the right to add it to the circle.
    • Note, the POS device is only listed if it has contacted the server beforehand.
    • Next time a POS device assigned to the circle, is asking for an update or new installation, it will install the circle's selected version.

Rollout to Existing Circles

If you already have some circles and want to roll the new update:

  1. Open deployment circles in the management portal.
  2. Select your POS bundle package (bundle/yourprefix-pos).
  3. Select a circle of your choice.
  4. Click Set Circle Version.
  5. In the dialog, select the version you want to roll out.