In this article

Overview

Before you start

Database Server Requirements

Application Server Requirements

Domain Name & SMTP Considerations

VIDIZMO Installation

Database Server Setup

Application Server Setup

Import Registry

Restore Databases

Extract Application Files

Install Services

IIS Configuration on your server

Activate License


Overview

Many organizations need to have their data secure and isolated due to which they want their applications to be deployed either on-premise or in their private cloud. VIDIZMO can be installed in either location depending upon the requirements of the enterprise. On-Premise/Private Cloud deployment is best for organizations with dynamic or unpredictable computing needs that demand direct authority & control over their environments, typically to meet security, business governance or regulatory compliance requirements. 


Before you start

Following are certain prerequisites and considerations to the installation of VIDIZMO application:


Database Server Requirements

Following are the minimum requirements for installing a Database Server:

  • Database Server:
    • Windows Server 2016 Standard Edition VM/Physical Server with a minimum of 16GB RAM, 4 Core CPU, 256 GB HDD with 150 Mbps Throughput

    • Microsoft SQL Server 2016/2017 Standard or Enterprise Edition

    • SQL Server Management Studio (will be installed separately in case of SQL Server 2016)

  • Open Firewall Ports between application and database servers: 80, 443, 11211, 1433
  • All machines should be on the same Local or Virtual Network.


Application Server Requirements

Following are the minimum requirements for installing VIDIZMO in an on-premise/private cloud environment:

  • Application Server: 
    • Windows Server 2016 Standard Edition VM/Physical Server with a minimum of 16GB RAM, 4 Core CPU, 128 GB HDD with 150 Mbps Throughput.
    • IIS 10 or greater
    • Microsoft .Net Framework 4.6 
    • .Net Core Hosting Bundle 2.1.6 or later 
  • Open Firewall Ports between application and database servers: 80, 443, 11211, 1433
  • Open Firewall Ports 80 and 443 between corporate firewall and following domains. This is required for VIDIZMO Software License Activation, monitoring, receiving ongoing software updates and upgrades, and VIDIZMO player to function properly.
    • *.enterprisetube.com
    • *.vidizmo.com
    • *.vo.msecnd.net
  • Open Firewall Port 1935 between your live encoder and streaming server, for live streaming purposes. If you are using VIDIZMO ECDN, this port should be open on all ECDN nodes. For cloud-based streaming depending on which of the following streaming providers you choose for its streaming services, following streaming server domains should be open for access via this port: 
  • All machines should be on the same Local or Virtual Network.
  • Administrative access to the VM/server on which VIDIZMO Application will be installed.


Domain Name & SMTP Considerations

Prerequisites for installation and configuration of VIDIZMO in an On-Premise/Private Cloud environment are:

  • Domain Name for your Media Portal: This is the domain name users will type in to access your media portal. The domain name should map to a public (or private in case external access is not intended) IP of VIDIZMO Application Server.
  • SSL Certificate for Selected Domain Name (Optional): In case use of HTTPS is required for secure communication between users’ browser and VIDIZMO application.
  • SMTP Service Credentials: For VIDIZMO Application to send out email notifications to administrators and users triggered in different scenarios such as registration requests, content upload, content sharing etc. This can be a service account (recommended) or user account that can be obtained from your corporate mail server administrator. Alternatively, it can also be setup with a 3rd party SMTP service such as sendgrid.com, Amazon SES etc.


VIDIZMO Installation

Database Server Setup

To install SQL Server to set up your Database Server, see: Install SQL Server from the Installation Wizard. Following this Installation Wizard, under Step 11 for Feature Selection, you need to select the following features:

  • Database Engine Services
  • Full-Text and Semantic Extractions for Search
  • SQL Client Connectivity SDK


Application Server Setup

A separate Application Server is required as a prerequisite to setting up the VIDIZMO application for On-Premise/Private Cloud deployment. This Server will be used to install the VIDIZMO Application. For a complete guide on how to set it up, see: How to Setup an Application Server for VIDIZMO Installation.


Import Registry

Now, you need to import the database registry in the Application Server in order to connect the application to the database server. This is how you may proceed with it:


1. Our Support team will provide you two registry files, namely newapi and newapi-64 tailored to your specific OS needs.

i. Paste these registries on your Application Server desktop.



The connection strings required in the registries are as follows:


1. "connection"="Data Source=<db server name>;Initial Catalog= VidizmoDB_6_0;Persist Security Info=True;User ID=<user id>;Password=<pwd>" 
2. "notificationconnection"= "Data Source=<db server name>;Initial Catalog= VidizmoNotificationSystem_6_0;Persist Security Info=True;User ID=<user id>;Password=<pwd>" 
3. "link"="<link to vlms site>" 


2. Update the Connection Strings in the registry as follows:

i. Right-click and edit registry file in notepad.



ii. Make following changes in the both registry files, for 32-bit (newapi) as well as for 64-bit (newapi-64) OS: 

  • Replace all Data Source parameters with the SQL server’s DNS name or the private IP of the SQL server.
  • Replace all User ID parameters with the username of SQL Sys Admin (sa).
  • Replace all Password parameters with the password of the Sys Admin account.





After having made the changes, save the file as a new one, to keep the original one as backup.


iii. Now, go to your system's registry editor by navigating to Start Menu > regedit.



iv. Go to File tab, and select Import.




v. Browse to the location where the edited files have been saved and select both registries.




vi. A prompt would be generated saying keys successfully added.




vii. Check keys have been updated in the registry for both 32-bit and 64-bit, respectively.





Restore Databases

You need to restore databases via SQL Server Management Studio to be used with VIDIZMO Application. To learn more about it, see: Restore a Database Backup Using SSMS.

Follow the steps mentioned under Restore a full database backup to add a backup file, that our Support Team shall provide for restoration. The file names would be the following:
  • VidizmoDB_6_0.bak
  • VidizmoNotificationSystem_6_0.bak


Extract Application Files

Our Support team will provide you zipped folders of Application files that you will have to download and extract in your Application Server:

i. Go to your C:\ drive location. Unzip and extract the folder named VIDIZMO.rar at the base location.




ii. Wait until the extraction takes place.




iii. Following which, you may go to your C:\ drive and navigate to VIDIZMO > Application to browse all application folders such as Global DLLs, Scripts, etc.



  

Install Services

Following are the list of four services that VIDIZMO application uses:

  • Caching Service used to manage application's memcache for faster streaming and lower latency.
  • Notification Service used to ping database for any changes that lead to an email alert generation.
  • Scheduler Service used to manage various clock-sensitive processes by refreshing the fetched results like analytics, reports, content purge.
  • Workflow Service used to manage various time-consuming processes by breaking them down into activities and managing them separately for a better track of progress.


1. Now, you need to install these services on your application server. Here is how you may do it:

i. Before you start, make sure you have the latest .NET Framework installed by navigating to C:\Windows\Microsoft.NET\Framework and checking the latest version.




ii. Open Start Menu and type cmd, right-click Command Prompt to Run as administrator.




iii. Type the following command to change directory to the service folder where the .exe file of your service is found, for example:

cd C:\VIDIZMO\Application\Win\MemcachedService




iv. After changing directory in the command prompt, write the following command to install service, where servicename is the name of the exe file that resides within the particular service folder:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil yourservicename.exe  




Note: In case of Memcached service, make sure you install VIDIZMOCaching.exe rather than memcached.exe.


v. This will be followed by a login prompt to verify that you have the required permissions to make these changes. Here, you are required to enter user account credentials that will be used to run background VIDIZMO services. It is recommended to create a new dedicated service user account, who must belong to Administrators group with administrative access on the local server. Enter username and password of this account here. You can either sign in using a domain user login, or a local user login.





vi. Service installed successfully over Command Prompt.




vii. Verify that VIDIZMO Caching Service was installed, by going to Start Menu > Services.




viii Repeat the above process for all four services with the following commands:


cd C:\VIDIZMO\Application\Win\MemcachedService
C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil VIDIZMOCaching.exe


cd C:\VIDIZMO\Application\Win\NotificationService
C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil VIDIZMONotification.exe


cd C:\VIDIZMO\Application\Win\SchedulerService
C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil VIDIZMOScheduler.exe


cd C:\VIDIZMO\Application\Win\WorkflowService
C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil VIDIZMOWorkflowEngine.exe




ix. After installing Scheduler Service, you need to change some additional settings. This would enable the Scheduler Service to restart, which in turn restarts all other services (Caching, Notifications and Workflows). To do so, right-click VIDIZMOScheduler service and select Properties.

x. Go to Recovery tab and set the following recovery settings: 



xi. Check the installed services via Start Menu > Services.




IIS Configuration on your Server

Now, we need to create an application site on your IIS server so that you may successfully browse and use the web application. Here is how you may do it:

i. Go to Start Menu and type in 'IIS' to launch your Server Manager.




ii. Expand your Server to view pools and sites, and expand Sites to view all sites within. We won't require default website and to free up the port 80, we shall delete it. Right-click on Default and select Remove.





iii. Right-click Sites and select Add Website from the context menu.




iv. In the resulting screen, enter a name for your site such as "VIDIZMO".

v. By default, an ApplicationPool of the same name will be created and associated with the site.

vi. Under Content Directory, add the local folder location of the web application as the Physical Path: C:\VIDIZMO\Application\Web

vii. Choose Type as http/https as per your DNS Settings and certifications.

viii. Choose IP Address as All Unassigned.

ix. Enter Port number as 80 or 8080 if Default/any other site is configured on your IIS. Or you could stop the state of the Default Website and can use port 80 here.

x. Leave Host name as blank to resolve the site on the host name of your server.

xi. Click Ok to create web site.




Activate License

After setting up your application when you browse it for the first time, you will land onto this Activation page where you may activate your product package by entering the License Key or uploading the License file provided to you by our Support team.