Installation Overview

To install or update third-party software for use in your Microsoft Dynamics 365 for Finance and Operations environment, Microsoft requires that you apply an all-in-one deployable package. You can create an all-in-one deployable package by combining various packages from different partners and independent software vendors (ISVs) into a single deployable package before applying the updated software to the environment. For more information about deployable packages, see the Microsoft Dynamics 365 for Finance and Operations documentation: 

To update or install Subscription Billing, you must incorporate the Subscription Billing license deployment package to the compressed (zip) folder of the deployable package for the main application.

If you do not already have the license file, contact the Binary Stream Licensing Team (RegKeys@binarystream.com).

If you do not have an account to access the Binary Stream Portal, send an email message to portal@binarystream.com with the following information: 

  • Email address you want to use
  • Your company's name

Instructions will be sent for how to set up the account and log on to the Binary Stream Portal.

Prerequisites

Before you create the all-in-one deployable package, ensure you have completed the following activities: 

To create the all-in-one deployment package, see the following knowledge base article: 

Applying Binary Stream Deployment Packages

You can apply the Binary Stream all-in-one deployment package automatically through Lifecycle Services (LCS) or manually. It is preferred that the deployment package is applied automatically. However, some situations might arise where it is not possible to apply the deployment package automatically.

Automatic Deployment

To apply the all-in-one deployment package automatically, follow these steps: 

  1. Upload the all-in-one deployable package to your asset library.
  2. Open up the environment page on LCS and select Maintain to apply the deployment package.

Manual Deployment

To apply the all-in-one deployment package manually, follow these steps: 

  1. Connect remotely to the Dynamics 365 environment.
  2. Copy the deployment package to the environment.
  3. For the deployment package, do the following: 
    1. Right-click the deployment package, and select Properties.
      The following security message might appear: 
      This file came from another computer and might be blocked to help protect this computer.
    2. If you see the security message, select the Unblock check box to unblock the file.
      If you do not see the security message, continue to the next step.
  4. Extract the deployment package to a folder.
    Note icon. Note: Long path names can result in an error during the installation process. To prevent this type of error, it is suggested that you extract the deployment package to a subfolder within C:/Temp, which helps keep the path name shorter.
  5. Run a Command Prompt as administrator.
  6. For the deployment package, do the following: 
    1. Specify the command to go to the extraction folder.
    2. When you are in the folder, specify the following command: 
      axupdateinstaller quickinstallall
  7. Note icon. Note: Once you start the manual deployment, you must complete it. Do not stop part way through the process. During the process, the command prompt text might not change for an extended period of time, which is normal. So while it may seem like nothing is happening, the deployment is processing.

After the Installation

After automatically or manually applying the Binary Stream all-in-one deployment package, ensure to refresh the data entites so that you can export data from and import data to Subscription Billing.

Updating the Software

Downloading and installing the latest version of Subscription Billing is optional. You might want to download the latest version for any of the following reasons: 

  • You want to take advantage of the latest enhancements.
  • You have an outstanding issue or have encountered an issue and the latest release has a software fix for it.

If you choose to skip installing the latest software update, any enhancement or software fix will always be available in a future release and installed when you choose to install the newer release. Also, all software updates are backwards compatible.