tutorials:other:multi_instance_playout
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
tutorials:other:multi_instance_playout [2016/03/22 10:24] – [Add the first instance] tw | tutorials: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 | + | This tutorial explains how to set up a multi instance playout server with mAirList: A single |
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/ | 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/ | ||
+ | ===== How It Works ===== | ||
+ | |||
+ | mAirList keeps all configuration and data in it's **data folder**, which defaults to '' | ||
+ | |||
+ | 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 | + | Each mAirList |
+ | |||
+ | * either | ||
+ | * or a special | ||
- | Please contact sales to obtain a multi-instance | + | (Without any of these two, you can still use the multi-instance |
- | 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: | + | 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: |
===== Multi Instance Manager ===== | ===== Multi Instance Manager ===== | ||
Line 21: | Line 31: | ||
Multi Instance Manager is available for download here: [[http:// | Multi Instance Manager is available for download here: [[http:// | ||
- | 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: | ||
+ | C: | ||
+ | C: | ||
+ | etc. | ||
+ | | ||
==== Download and install mAirList ==== | ==== Download and install mAirList ==== | ||
If you haven' | If you haven' | ||
- | In this tutorial, we use mAirList | + | In this tutorial, we use mAirList |
- | * Executable files are in '' | + | * Executable files are in '' |
- | * (Default) data folder is '' | + | * (Default) data folder is '' |
==== Configure Multi Instance Manager ==== | ==== Configure Multi Instance Manager ==== | ||
Line 38: | Line 55: | ||
{{ : | {{ : | ||
- | First, we click // | + | First, we click // |
- | {{ : | + | {{ : |
//Default license folder// can be left empty, as it is the same as the default data folder (where the '' | //Default license folder// can be left empty, as it is the same as the default data folder (where the '' | ||
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. | ||
- | // | + | // |
Click //OK//, and your instance will appear in the main window: | Click //OK//, and your instance will appear in the main window: | ||
Line 80: | Line 97: | ||
==== Add another instance ==== | ==== Add another instance ==== | ||
+ | Once the first instance is set up, we can continue with the second instance: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | 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 ==== | ||
+ | |||
+ | Using the Auto Start feature, you can easily start up all " | ||
+ | |||
+ | To mark an instance as Auto Start, edit its properties and check the Auto Start option: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | All Auto Start instances that are not currently running will be displayed using a red background: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Now click the //Auto Start// button in the toolbar -- the playout will be started for all instances, and they turn green in the list: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | When you run '' | ||
===== 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 | + | It is also possible |
+ | |||
+ | - Use the ZIP distribution, | ||
+ | - use separate data folders and an appropriate command line switch | ||
==== Option 1: ZIP distribution ==== | ==== Option 1: ZIP distribution ==== | ||
Line 93: | Line 136: | ||
There is another notable difference between the " | There is another notable difference between the " | ||
- | The normal setup installation | + | The normal setup installation |
The ZIP distribution, | The ZIP distribution, | ||
- | (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 '' | + | (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 '' |
So in order to install multiple mAirList instances using the ZIP distribution, | So in order to install multiple mAirList instances using the ZIP distribution, | ||
+ | |||
==== Option 2: Separate data folders ==== | ==== Option 2: Separate data folders ==== | ||
tutorials/other/multi_instance_playout.txt · Last modified: 2020/09/16 07:03 by tw