Last updated on March 23, 2019

Run a software deployment

This article provides the instructions to create, restore, deprecate, and delete player packages, as well as how to deploy these player packages and delete the deployments.

Deployments, accessed via the Appspace menu, allows Portal Administrators on On-premise deployments to deploy generic software packages to production players, or packages with custom feature requests such as special language support, at different levels of classifications.


Portal Administrators can deploy the following four different types of player packages:

  • DMP Package - customized package for DMP devices.
  • EDGE Package - customized package for Edge devices.
  • Player Package - customized package for PC players.
  • Agent Package - background agent package for PC players, to sync with Appspace.

The following are the different classification levels, which indicate where the packages are to be deployed:

  • Account level - package is deployed to all players registered in the selected account.
  • Application level - package is deployed to all players that run the selected channel.
  • Device level - package is deployed to a specific device.
  • Network level - package is deployed to all players that are in the selected network and its sub-networks.
  • System level - package is deployed to all players registered to Appspace.

Once a device receives all the packages deployed to it, the device will use the packages in the following order of priority:

  1. Device level
  2. Application level
  3. Network level
  4. Account level
  5. System level

All packages are first uploaded to the Appspace server, and then to the devices during the deployment process. Player packages bundled with the Appspace installer are deployed to System level during the installation of Appspace.


Prerequisites

  • Portal Administrator permissions required.

Add a New Deployment Package

  1. In Deployments, select the desired network from the network tree, and click the +ADD button.


  2. In the Choose an Option window, select the Add Package option, and click Next.


  3. In the New Package window, select the desired player package type from the drop-down menu, and enter in the version of the package. Click the Browse icon to browse for the package file, and click OK.


  4. If successful, the New Package Added confirmation window is displayed.

    • To deploy the package now, click Yes, and proceed to Step 3 in the Add a Deployment section below.
    • To deploy the package later, click Not now.

Add a Deployment

  1. In Deployments, select the desired network from the network tree, and click the +ADD button.


  2. In the Choose an Option window, select the Add Deployment option, and click Next.


  3. In the Add Deployment window, select the Scope of the deployment, the player package type, and the package version. Click OK to deploy the package.


  4. The package is deployed successfully.

Remove a Deployment

  1. In Deployments, select the desired network from the network tree.

  2. Select the deployment package you wish to remove.

  3. Click the Delete icon.


  4. Click OK in the Confirmation window.

Deprecate a Package

  1. In Deployments, select the desired network from the network tree.

  2. Select the deployment package you wish to deprecate, and click the package type name link.


  3. In the Package Information page, click the Deprecate package link.


  4. Click OK in the Confirmation window.

  5. Back in the Package Information page, the status of the package is displayed as Deprecated.

Restore a Package

To restore a package that was previously deprecated, follow the instructions below.

  1. Select the deployment package you wish to restore, and click the package type name link.


  2. In the Package Information page, the details and status of the package is displayed.


  3. Click the Restore package link.


  4. Click OK in the Confirmation window.

  5. Back in the Package Information page, the status of the package is displayed as Active.

Delete a Package

  1. In Deployments, select the desired network from the network tree.

  2. Select the deployment package you wish to delete, and click the package type name link.

  3. Click the Delete package link.


  4. Click OK in the Confirmation window.