User Tools

Site Tools


tutorials:other:multi_instance_playout

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
tutorials:other:multi_instance_playout [2016/03/22 12:30] – [Auto Start] twtutorials:other:multi_instance_playout [2020/09/16 07:03] (current) – [Multi Instance Playout] How it works tw
Line 1: Line 1:
 ====== Multi Instance Playout ====== ====== Multi Instance Playout ======
  
-This tutorial explains how to set up a multi instance playout server with mAirList: A single computers that hosts multiple mAirList playout processes, usually each creating one or more Shoutcast/Icecast streams.+This tutorial explains how to set up a multi instance playout server with mAirList: A single computer that hosts multiple mAirList playout processes, usually each creating one or more Shoutcast/Icecast streams.
  
 Multi instance installations can be set up on ordinary PC hardware, or on Windows servers hosted in datacenters -- if you are only going to create Shoutcast/Icecast streams (no local audio), no audio hardware is required. Multi instance installations can be set up on ordinary PC hardware, or on Windows servers hosted in datacenters -- if you are only going to create Shoutcast/Icecast streams (no local audio), no audio hardware is required.
  
 +===== How It Works =====
 +
 +mAirList keeps all configuration and data in it's **data folder**, which defaults to ''C:\ProgramData\mAirList\<Version>'' for ordinary setups created with the installer. (Note that it's "ProgramData", not "Program Files"!).
 +
 +By using special command line parameters, it is possible to specify a different folder as the main data folder (or parts thereof), and thus having multiple ``mAirList.exe`` processes (instances) running at the same time, and using separate configuration sets.
 +
 +Our *Multi Instance Manager* application facilitates this process, but you can also specify these parameters manually. Both options are described in this article.
 ===== Prerequisites ===== ===== Prerequisites =====
  
-Multi-instance playout requires a special playout licenses. Ordinary mAirList licenses only allow a single simultaneous playout process. (You can still use the multi-instance setup to manage multiple configurationsbut you can only use one at time without a multi-instance license.)+Each mAirList license is valid for a single playout instance only. In order to run multiple playouts on the same computer, you will need 
 + 
 +  * either separate license per playout instance, 
 +  * or special multi-instance playout license (available as a paid add-on for mAirList Professional -- please contact <sales@mairlist.com>).
  
-Please contact sales to obtain a multi-instance add-on for your license.+(Without any of these two, you can still use the multi-instance setup to manage multiple configurations, but you can only use one at a time.)
  
-All instances will have a separate configuration and can use any kind of scheduling backend. If use use mAirListDB for scheduling, you will probably want to set up [[tutorials:mairlistdb:multi-station|mAirListDB Multi-Station]] first.+All instances will have a separate configuration and can use any kind of scheduling backend. If you use mAirListDB for scheduling, you will probably want to set up [[tutorials:mairlistdb:multi-station|mAirListDB Multi-Station]] first.
  
 ===== Multi Instance Manager ===== ===== Multi Instance Manager =====
Line 21: Line 31:
 Multi Instance Manager is available for download here: [[http://download.mairlist.com/MultiInstanceManager/]] Multi Instance Manager is available for download here: [[http://download.mairlist.com/MultiInstanceManager/]]
  
-It comes as a Zip file without any installer. Just unzip anywhere, e.g. on the Desktop. The configuration will be stored in an .ini file inside the same folder.+It comes as a .zip file without any installer. Just unzip anywhere, e.g. on the Desktop. The configuration will be stored in an .ini file inside the same folder.
  
 +Do **NOT** unzip the software anywhere inside ''C:\Program Files'', or any other folder restricted by the Windows User Account Control! The Desktop, or a custom folder like ''C:\mAirList'', is a good choice. As you will require a separate data folder per instance (see below), we suggest you create a directory structure like this:
 +
 +  C:\mAirList\MultiInstanceManager (<-- unzip here)
 +  C:\mAirList\Instances\01-firstinstance (<-- data folder for first instance)
 +  C:\mAirList\Instances\02-secondinstance (<-- data folder for second instance)
 +  etc.
 +  
 ==== Download and install mAirList ==== ==== Download and install mAirList ====
  
 If you haven't done so already, download, install and activate mAirList now. You can use a setup or zip distribution. If you haven't done so already, download, install and activate mAirList now. You can use a setup or zip distribution.
  
-In this tutorial, we use mAirList 5.3, installed through the ordinary setup:+In this tutorial, we use mAirList 6.1, installed through the ordinary setup:
  
-  * Executable files are in ''C:\Program Files (x86)\mAirList 5.3''+  * Executable files are in ''C:\Program Files (x86)\mAirList 6.1''
-  * (Default) data folder is ''C:\ProgramData\mAirList\5.3'' (you can verify this in //mAirListConfig -> Advanced -> Data Folders//).+  * (Default) data folder is ''C:\ProgramData\mAirList\6.1'' (you can verify this in //mAirListConfig -> Advanced -> Data Folders//).
  
 ==== Configure Multi Instance Manager ==== ==== Configure Multi Instance Manager ====
Line 38: Line 55:
 {{ :tutorials:other:pasted:20160322-111220.png?400 }} {{ :tutorials:other:pasted:20160322-111220.png?400 }}
  
-First, we click //Settings// and enter the location of //mAirList.exe// and the default data folder:+First, we click //Settings// and enter the location of //mAirList.exe// (path and filename) and the default data folder:
  
-{{ :tutorials:other:pasted:20160322-111349.png?400 }}+{{ :tutorials:other:pasted:20200617-125234.png?400 }}
  
 //Default license folder// can be left empty, as it is the same as the default data folder (where the ''license.lic'' file is located). //Default license folder// can be left empty, as it is the same as the default data folder (where the ''license.lic'' file is located).
Line 64: Line 81:
 //License folder// can be left empty, as we use the multi-instance license file installed in the default data folder. //License folder// can be left empty, as we use the multi-instance license file installed in the default data folder.
  
-//Configuration template// is set to //no template//, as we start with an empty configuration here. It's also possible to copy over the configuration from the default data folder (''C:\ProgramData\mAirList\5.3'') if you are migrating from a single-instance setup.+//Configuration template// is set to //no template//, as we start with an empty configuration here. It's also possible to copy over the configuration from the default data folder (''C:\ProgramData\mAirList\6.1'') if you are migrating from a single-instance setup.
  
 Click //OK//, and your instance will appear in the main window: Click //OK//, and your instance will appear in the main window:
Line 84: Line 101:
 {{ :tutorials:other:pasted:20160322-112738.png?400 }} {{ :tutorials:other:pasted:20160322-112738.png?400 }}
  
-Note that we are using the first station as the configuration template this time -- the Multi Instance Manager will simply copy over the contents of the data folder to the data folder of the newly created instance. This is a very convenient way to duplicate the configuration to a new instance when all of your instances are configured in a similar way.+Note that we are using the first station as the configuration template this time -- the Multi Instance Manager will simply copy over the contents from the initial data folder to the data folder of the newly created instance. This is a very convenient way to duplicate the configuration to a new instance when all of your instances are configured in a similar way. 
 ==== Auto Start ==== ==== Auto Start ====
  
Line 100: Line 118:
  
 {{ :tutorials:other:pasted:20160322-115010.png?400 }} {{ :tutorials:other:pasted:20160322-115010.png?400 }}
 +
 +When you run ''MultiInstanceManager.exe'' with the ''%%--%%autostart'' command line parameter, it will start all Auto Start instances automatically when it launches.
 +
 ===== Manual Management of Instances ===== ===== Manual Management of Instances =====
  
-While using+Using the Multi Instance Manager is the preferred way of managing a multi-instance setup now.
  
-The first step is to prepare the invidiual playout instances. A "playout instance" is nothing but a mAirList playout process, running with a separate configurationWe have two options here1. Use the ZIP distribution, or 2. use separate data folders and an appropriate command line switch.+It is also possible to manage the instances manually if you prefer, which is described in this sectionThere are two ways to do this: 
 +  
 +  - Use the ZIP distribution, or  
 +  - use separate data folders and an appropriate command line switch (mimics the function of the Multi Instance Manager).
  
 ==== Option 1: ZIP distribution ==== ==== Option 1: ZIP distribution ====
Line 112: Line 136:
 There is another notable difference between the "setup" installations and "ZIP" installations: There is another notable difference between the "setup" installations and "ZIP" installations:
  
-The normal setup installation store all mAirList configuration data in the system-wide ProgramData folder ''C:\ProgramData\mAirList\<version>'' -- this is the place Microsoft recommenends for all program-related configuration and data, as a normal user will not have write access to ''C:\Program Files'' anymore since Windows Vista.+The normal setup installation stores all mAirList configuration data in the system-wide ProgramData folder ''C:\ProgramData\mAirList\<version>'' -- this is the place Microsoft recommends for all program-related configuration and data, as a normal user will not have write access to ''C:\Program Files'' anymore since Windows Vista.
  
 The ZIP distribution, however, stores the configuration directly inside the program folder. That means that you can have multiple mAirList installations side-by-side, each with a separate config, just by unpacking the ZIP distribution multiple times, or duplicating an existing program folder. The ZIP distribution, however, stores the configuration directly inside the program folder. That means that you can have multiple mAirList installations side-by-side, each with a separate config, just by unpacking the ZIP distribution multiple times, or duplicating an existing program folder.
  
-(How can mAirList tell whether it is a ZIP distribution or not? In other words, how does mAirList tell whether the config should go to ''C:\Program Files'' or rather in to the program folder? It check if there is a folder named ''config'' in the same folder as ''mAirList.exe''. If there is, it assumes "ZIP-style" installation with config inside the program folder; if not, it will use ''C:\ProgramData''. Bottom line is, if you want to duplicate the program folder to make separate configurations, always make sure that there is a ''config'' subfolder inside the program folder. The ZIP distribution comes with an empty ''config'' folder for this purpose.)+(How can mAirList tell whether it is a ZIP distribution or not? In other words, how does mAirList tell whether the config should go to ''C:\Program Files'' or rather in to the program folder? mAirList checks if there is a folder named ''config'' in the same folder as ''mAirList.exe''. If there is, it assumes "ZIP-style" installation with config inside the program folder; if not, it will use ''C:\ProgramData''. Bottom line is, if you want to duplicate the program folder to make separate configurations, always make sure that there is a ''config'' subfolder inside the program folder. The ZIP distribution comes with an empty ''config'' folder for this purpose.)
  
 So in order to install multiple mAirList instances using the ZIP distribution, simply unzip it to multiple locations. Or prepare the base configuration of the first instance, then make copies of that folder. So in order to install multiple mAirList instances using the ZIP distribution, simply unzip it to multiple locations. Or prepare the base configuration of the first instance, then make copies of that folder.
 +
 ==== Option 2: Separate data folders ==== ==== Option 2: Separate data folders ====
  
tutorials/other/multi_instance_playout.1458649806.txt.gz · Last modified: 2019/07/09 16:19 (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki