MLServer 4

From Cinemar Wiki
Jump to: navigation, search


Welcome to the MLServer 4.0

MLServer 4.0 represents Cinemar's fourth generation of media management and home automation software components. MLServer 4 has been rewritten from the ground up using the latest Microsoft .NET libraries and moves from a single process controller to a multi-tasking server engine powered by a robust SQL Server back end database.

System Requirements

  • Microsoft Windows 8, Windows 7, Vista or XP with all the current service packs and security updates. (32 or 64 bit versions. 64 bit recommended)
  • modern dual-core processor
  • 2GB main memory. (4GB or more recommended)
  • 100GB free disk space
  • Microsoft SQL Server Express 2008 R2 or better (32 or 64 bit versions. 64 bit recommended)
  • MLServer version or later
  • MainLobby Client v or later
  • MLServer PC with persistent Internet connection

The ideal PC for using our software is a Core i5 processor with 8GB of memory with a SATA III hard drive running Windows 7 64 bit.

NOTE: For users using Windows Server 2008

Because of the enhanced security enabled on this operating system SQL Server will have to be manually installed on this server. If you are running Windows Server 2008 and want to run MLServer on this PC please contact Cinemar technical support and one of our technicians will install SQL Server for you. After that you will be able to install any of the other Cinemar software components without needing technical support. This requirement is for Windows Server 2008 users only.


Because of the number of new components required for the successful installation of MLServer 4 you must install all the prerequisite software prior to installing MLServer 4. This section will guide you through these steps. Make sure you follow them in order and do not skip any steps. If you have any issues installing any of these prerequisite items do not move one to another item. Call tech support and get assistance.

NOTE: It is strongly recommended that you temporarily disable any anti-virus software during the install of .NET 4.0 and SQL Server. Once these products are installed it will be safe to re-enable your virus software.

Manually open TCP ports 80 (web server), 8181 (websockets server), 6246 (system web server) and make sure you are running MLServer on the windows 8 box as administrator.

Step 1: User Access Control (UAC)

Windows 8, Windows 7 and Windows Vista introduced a security mechanism called User Access Control. While meant to be a tool to keep users from doing harm to themselves it really hinders the users ability to freely install software on their PCs. The very first step is to make sure that you have turned off UAC. To do this follow these steps

  • Go into the Control Panel and select the "User Accounts" applet.
  • Click on "Change User Account Control Settings"
  • Slide the vertical slider all the way down to the "Never Notify" position
  • Click OK. See the following illustration for an example.


Step 2: Cinemar Installation Assistant

Download and install the version 4 Cinemar Installation Assistant (MLInstaller). You can download the latest version from [here]

Windows 8 Users must now take one additional step. Right-click on the CIA icon that was created on the desktop to change the properties of the icon. Go to the compatibility section and make sure you check off the box that says "Run this program as an Administrator"


Step 3: Open Cinemar Installation Assistant


Section A in the Cinemar Installation Assistant table lists the prerequisite software that is required to run MLServer 4. You must install them in the order they are listed.

After installing the Installation assistant the next required component is item #2 the SQL Server/.NET 4 Installation assistant. This installer will take care of checking to make sure all the required Windows software components are installed along with SQL server. Download and run this installer.


Follow all the instructions presented during this installation. The installer will automatically select the correct installation components 32bit or 64bit depending on the operating system in use.

During this process your PC will need to be rebooted at least one time. The installer will automatically reboot your PC at the appropriate time and then automatically continue once the PC has been rebooted. After the PC has been rebooted and the installer has restored the master copy of the database you will be presented with the option of returning to the main Installation Assistant. Select yes and then continue to the installation of MLServer.

Step 3: Install MLServer 4

  • 1) Download and install MLServer 4 from Installation Assistant. After the install run MLServer and verify that it starts up without any issues. Current users of MLServer will note that MLServer is being installed into a new folder. The new installation folder is C:\Program Files\Cinemar\MLServer for 32 bit systems and C:\Program Files (x86)\Cinemar\MLServer for 64 bit systems. This is done for two reasons; first, we want to consolidate all the Cinemar software in one location and second, this will allow you to have both versions running on your system. This will allow you to slowly migrate from the old version to the new.

MLServer should look like the following.


MLServer 3 Migration

If you are migrating from MLServer 3 to MLServer 4 you should now copy some of your old data files into the new folders.

If you are using any legacy plugins then you should copy everything from your old "C:\Program Files\MLServer\Data" folder to the new "C:\Program Files\Cinemar\MLServer\Data" folder. (Adjust the paths to match your system.) All the legacy plugins still need their old mdb files. Doing this will get them back in sync.

You should then do the same thing for the old \MLServer\Images folder. Copy all the files and folder from the old MLServer\Images folder into the new Cinemar\MLServer\Images folder. If you get prompted to overwrite and existing files click OK. You want to make sure you are using all your old images. All your old cover art and images live in those folders.

When you go into the new Macro editor you'll see an Import option. Just change the file type to ".mdb" and point it to your old commands.mdb file in the MLServer directory and it will bring in your old macros. Do the same thing for the State Variables. When you go into the State Variables editor there will be an import option. Select that and point it to your old MLCycleStates.mdb file.

Next Steps

There are dozens of new features in MLServer 4 and you should take time to familiarize yourself with them before you start to use MLServer in daily use. The best place for you to start is the MLServer 4 primer which can be found at MLServer 4 Primer.