Technical know how

Binary Lab – Business Central App Installation Manual

1. Introduction

This guide provides detailed instructions to install the Binary Lab app for Microsoft Dynamics 365 Business Central, covering:

• Installation on Business Central Online (SaaS) via AppSource
• Manual installation on SaaS using the Extension Management page
• Installation on Business Central On-Premises

2. Prerequisites

Before starting, ensure that:

• You have Administrator or Extension Management permissions.
• You have access to the .app file (for manual or On-Prem installations).
• The Business Central environment version is compatible with the app.
• All dependent extensions (if any) re already installed.

3. Installation on Business Central Online (SaaS) – From AppSource

Step 1 – Sign in

1. Go to https://businesscentral.dynamics.com.
2. Log in with your Microsoft 365 account.

Step 2 – Open Extension Management

1. Select the Settings (⚙️) icon → choose Admin Center, or
2. Use Search (Alt + Q) and type “Extension Management”.
3. Select Extension Management from the results.

Step 3 – Get the App from AppSource

1. Click “Get more apps from AppSource.”
2. Search for “Binary Lab” or the specific app name (e.g., Data Sync).
3. Select the app and click Get it now.

Step 4 – Install the App

1. Choose the environment (e.g., Production      or Sandbox).
2. Review and accept the terms and click Install.
3. Wait for the installation to complete.

Step 5 – Verify Installation

1. Go back to Extension Management.
2. Confirm that the app appears with the status Installed.

Step 6 – Assign Permissions

1. Open Users → User Card.
2. Choose the environment (e.g., Production or Sandbox).et (e.g., BLDATASYNC).

Step 7 – Configure the App

Follow the setup instructions in the relevant app configuration manual.

4. Manual Installation on Business Central Online (SaaS) – Using Extension Management

This method is used when installing a private or custom app provided directly by Binary Lab, instead of via AppSource.

Step 1 – Sign in

1. Go to https://businesscentral.dynamics.com.
2. Log in with an account that has Extension Management permissions.

Step 2 – Open Extension Management

1. Use Search (Alt + Q) → type “Extension Management”.
2. Open the Extension Management page.

Step 3 – Upload the App File

1. In the top action bar, click “Upload Extension.”
2. In the upload window:
   • Click Choose File and select the .app file provided by Binary Lab.
   • Confirm and click Next.
   • Choose Accept to agree to the terms (if prompted).
   • Click Deploy or Install.

Note: Installation may take a few minutes depending on environment performance.

Step 4 – Monitor Installation

• You’ll see a progress indicator while the app installs.
• While installing, navigate to the Installation Status to see the progress, refresh periodically (F5) to see if the status changes.
• Once completed, it will appear in Extension Management with status Installed.

Step 5 – Assign Permissions

1. Navigate to Users → User Card.
2. Assign the app’s Permission Set to all relevant users (e.g., DATASYNCPERM).

Step 6 – Verify and Configure

1. Open the app’s pages or role centers to confirm availability.
2. Follow the configuration guide to complete setup (e.g., Data Sync Manual).

5. Installation on Business Central On-Premises

Step 1 – Obtain the .app File

Get the .app file from Binary Lab support or your deployment package.

Step 2 – Open Business Central Administration Shell

Run as Administrator.

Step 3 – Publish the App

Publish-NAVApp -ServerInstance BC210 -Path "C:\BinaryLabApps\BinaryLabApp.app" -SkipVerification

Step 4 – Synchronize the App

Sync-NavApp -ServerInstance BC210 -Name "Binary Lab App" -Version 1.0.0.0

Step 5 – Install the App

Install-NAVApp -ServerInstance BC210 -Name "Binary Lab App"

Step 6 – Verify Installation

Open Extension Management in Business Central and confirm the app appears as installed.

Step 7 – Assign Permissions

Assign the app’s permission set to users as required.

6. Updating the App

SaaS (AppSource)

• Updates are automatically handled by Microsoft.
• You will receive a notification when a new version is deployed.

SaaS (Manual Upload)

1. Go to Extension Management.
2. Find the old version → click Uninstall (if required).
3. Click Upload Extension again and install the new .app file.

On-Premises

Use the same PowerShell commands as in section 5 to publish and install the new version.

8. Support

📧 Email: support@binarylab.co.za
🌐 Website: www.binarylab.co.za
🕘 Support Hours: Monday–Friday, 9:00 AM – 5:00 PM (SAST)