Introduction 

This article explains how to configure Azure Service Bus as a Broker service in VIDIZMO. For a better understanding of how to integrate Azure Service Bus into VIDIZMO, consult our article VIDIZMO Architecture: Understanding Azure Service Bus as a Broker.  


Deploying Azure Service Bus

Before diving into setup, let's ensure you have the necessary foundation in place. 


Prerequisites 

  • Azure Subscription: If you don't have one, head over to sign up for a free trial. 
  • Basic Azure Portal knowledge: You'll be creating resources within the Azure portal, so familiarity is helpful. 


Steps

Create a Service Bus Namespace: 

  • Access the Azure portal and search for Service Bus. 
  • Click on Service Bus and then + Create to begin creating a new namespace. 
  • Fill in the required details like resource group name, location, and namespace name. Choose a pricing tier that suits your needs. 
  • Click "Create" to bring your namespace to life. 

Create a Queue: 

  • Within your newly created namespace, navigate to Queues and click + Queue. 
  • Give your queue a name and leave the other settings at their default values. 
  • Click Create to add the queue to your namespace. 

Retrieve the Connection String: 

  • Open your namespace and go to Shared Access Policies. 
  • Select the policy named RootManageSharedAccessKey and copy the Primary Connection String. This string is crucial for configuring Azure Service Bus in VIDIZMO later as the RootManageSharedAccessKey provides administrative access to your namespace, which is essential for VIDIZMO configuration. 


For detailed instructions, refer to the official Microsoft documentation: ”Use Azure portal to create a Service Bus namespace and a queue.”   


Setting up ASB as a broker service in VIDIZMO 

The ‘Application Configuration’ tab in your VIDIZMO app includes the Distributed Run Time Config section, where you would configure the Endpoints needed to establish a connection with the broker service. If the Endpoints are not specified correctly, the application may encounter unexpected issues. Make sure the correct Connection String is added with all VIDIZMO services in the Distributed Run Time Config section.


To configure broker service in the VIDIZMO application, please follow the instructions given below:  

 

Prerequisites 

  • This applies exclusively to on-premises VIDIZMO deployments. 
  • Administrator privileges are required to proceed with the configuration. 

Steps 

1. Login VIDIZMO application with Administrator privileges. 
2. Navigate to Navigation Menu > Control Panel.



3. Navigate to Application Configuration > VIDIZMO Runtime Configuration.


  

4. Click ‘Edit’ to change/update the existing configuration. 



5. Under Event System, select Azure Service Bus from the dropdown menu. In the Connection String field, paste the Primary Connection String associated with the RootManageSharedAccessKey policy rule in your Azure Service Bus namespace. 


Please set the maximum message size (KB) to 1024 and configure the compression of messages to occur after reaching a size of 800 bytes. This recommendation is advised for optimal service performance. 



Conclusion  

If you encounter any errors, we suggest troubleshooting by consulting the article’s section "Monitoring & Troubleshooting," which outlines common issues that may arise during Azure Service Bus deployment, or you can refer to Microsoft documentation. 


For VIDIZMO-related concerns, please reach out to our support team, and we will promptly assist you. To contact the VIDIZMO support team, please send an email to support@vidizmo.com.