HELIX MEDIA LIBRARY INSTALL GUIDE FOR WINDOWS SERVER 2008 Helix Media Library Version 3.0 Revision Date: June 2014
Summary of Contents Summary of Contents... 2 Pre Installation Checklist... 4 Prerequisites... 5 Install Windows 2008 Server... 5 Installation Types... 6 Install Internet Information Services and.net 3.5... 7 Pre-installation Software... 12 Download and Install third party browsers:... 12 Install Java... 12 Install Windows DirectShow Codecs... 12 Download Flash Player... 13 Install Apple QuickTime... 13 Adding an Additional IP Address to a Network Card... 14 Install Microsoft SQL 2008 Express Edition... 18 Configure SQL to allow connections... 28 Binding IP Addresses - IIS... 29 Install Helix Server... 30 Install Helix Mobile Producer... 33 IP Address and Domain Settings... 34 Binding IP Addresses - Helix Server... 35 Install Helix Media Library... 37 Updating to Version 3.0... 46 Setting Permissions on the Helix Media Library directories.... 47 Create Mount Points for RealMedia and Flash Player Content... 49 RealMedia Content... 49 Flash Player H.264 MP4 Content... 50 Add HTTP Mount Point... 50 URL Aliasing... 51 Configure E-Mail Server Settings... 52 2
Helix Media Library Install Guide Customize Helix Media Library Appearance... 53 Segmentation... 54 Enabling Segmentation on Helix Universal Server 14.3... 54 Enabling Segmentation on Helix Universal Server 15.1... 57 How to add the.srt file extension as an accepted MIME type in IIS... 59 Troubleshooting... 72 Helix Server fails to start and the Administration pages cannot be reached.... 72 The website reports a Service Unavailable application error.... 72 IIS 32 App Support on 64 bit OS... 73 Starting the Helix Server Administrator... 74 Uninstalling Helix Media Library... 76 WMV s Fail to Encode... 79 3
Pre Installation Checklist Use this section to ensure you have all the required components to complete a successful installation of the Media Library Server. Windows 2008 Server / R2 (32/64Bit)? Alternative Browser? [Links on Page 6].NET Framework v3.5 installer? SQL Server Express installer? Helix Server installer and license? Helix Mobile Producer installer and license? JAVA installer? Windows Audio and Video Codecs? Apple QuickTime installer? 2 available IP addresses? 3 available Host Names? Media Library installer and license? E-Mail server and administrator account (if required) available? Logo and colors for Helix Media Library customization? 4
Helix Media Library Install Guide Prerequisites Install Windows 2008 Server Microsoft Windows Server 2008 required. Versions supported: Standard Standard R2 Both 32Bit and 64bit are supported 5
Installation Types There are different ways that the Helix Media Library can be installed in terms of how the hardware used and how the services are spread. For the purposes of this document it is assumed that all of the components will be installed on a single piece of hardware which will also house both the Media Content and Database. As a first run of the Installation this set up is recommended. Different Configurations are possible but this is best implemented following a successful installation on a single piece of hardware, and with the advice of your System Supplier. IMPORTANT Version 3.0 of the Helix Media Library is installed by using the version 1.1 installer, and is then updated using Updatemanager3_0.exe To install version 3.0, follow this guide through and then apply the update using the guidelines at the end. 6
Helix Media Library Install Guide Install Internet Information Services and.net 3.5 Open Server Manager. This can be done by clicking on the picture of the server and toolbox by the Start button, or if that is not there going to Start, Administrative Tools and then Server Manager. or 7
Once in Server Manager click on Roles, and then Add Roles Tick the box for Web Server (IIS). Click Next. At the next screen there will be some information about IIS. Click Next. 8
Helix Media Library Install Guide On the screen after this you will be shown the role services and you can choose to add additional ones. Select ASP.NET. When you click on this an Add Roles Wizard window will appear. Click on Add Required Role Services. Click install at the next screen to install IIS and ASP.NET. 9
It will show that the installation was successful. Click Close, and restart the server. When the server is back up and you have logged in, open up Server Manager again. To install.net 3.5 it must be added as a feature using the Server Manager page: Click on Add Features and check the box for.net 3.5. 10
Helix Media Library Install Guide Click OK in the pop-up box to install all the components of the feature and click next to complete the install. Close Server Manager. 11
Pre-installation Software Before going on to install the main components of the Helix Media Library, there are is a list of software that should be installed first: Alternate Browsers This is good for testing to check whether the software can be accessed from different browsers.net 3.5 Required for IIS Java (Optional) Used for viewing the Helix Server monitor K-Lite Codec Pack This installs the codecs to allow files to be encoded Flash Required to test upload and playback functionality on the Server once HML is installed QuickTime Installs additional codecs Download and Install third party browsers: Mozilla Firefox: http://www.getfirefox.com Google Chrome: http://google.com/chrome Opera: http://www.opera.com Install Java Obtain the latest copy of Java using the following link: http://java.com/en/download/index.jsp This is optional, but required if you want to view the Server Monitor on Helix Server which reports real-time statistics of streams being accessed. Install Windows DirectShow Codecs The K-Lite Codec packs are recommended (but not essential) for use with the Media Library Server, and will allow it to encode a far greater number of audio and video formats. Launch the K-Lite Mega Codec Pack installer. The second screen of the installer will be the Select Components dialog. Choose Lots of stuff (without player). 12
Helix Media Library Install Guide Manually select MPEG-2 DVD -> ffdshow (libmpeg2), as shown: Select the defaults for all other screens until the installation is complete. Download Flash Player Use the following URL to get the most current version of Flash player, and just run through the installer: http://get.adobe.com/flashplayer/ Install Apple QuickTime Download and launch the installer. Accept all defaults apart from Automatically update QuickTime and other Apple Software and decline the offer to Go Pro Now. 13
Installer available from: http://www.apple.com/quicktime/ Adding an Additional IP Address to a Network Card As two IP addresses are required, one will need to be added to the network card. Open you network card properties by clicking on Start, opening the Control Panel and opening Network and Sharing Centre. From the options on the left-hand side select Manage Network Connections Right-click on your active network connection and click Properties. 14
Helix Media Library Install Guide Click on Internet Protocol Version 4 (TCP/IPv4) and then click on Properties If the fields on the following screen are blank and the IP addresses are set to be obtained automatically then you will need to change these to manual entries. Ensure all the IP addresses are filled out and then click on Advanced. 15
In the advanced settings you will see the existing IP address. Click Add to add the second one. Enter the IP address in the box that appears and hit tab after entering it. The default gateway will automatically appear when you do this. If your default gateway is different to the one shown then change it and click Add. 16
Helix Media Library Install Guide Click OK on the advanced settings window, then on the Internet Protocol Properties window to save the changes and exit. 17
Install Microsoft SQL 2008 Express Edition Download Microsoft SQL Server 2008 with Advanced Services from: http://www.microsoft.com/sqlserver/en/us/editions/express.aspx Choose either 32 or 64 bit depending on your hardware, and select the download that says W/TOOLS to download the version with Management Studio. Open the package to begin the install. At the SQL Server Installation Centre screen, click on Installation. Click on the top option to install a new stand-alone server installation 18
Helix Media Library Install Guide At the next screen click Install to install the Setup Support Files The next screen will be the Setup Support Rules screen. This will list the rules and their status. If any have failed they will need to be rectified before continuing with the installation. If any have 19
warnings these can be ignored for the installation and later rectified if they are going to cause a problem. For more information on what the problem is for flagged status click on the status in blue. Click Next. If Windows PowerShell fails on the screen above, please see the troubleshooting section at the foot of this document for steps on how to rectify this. Once you have completed the steps, click on the Re-run button on the Setup Support Screen above and the warning will have cleared. 20
Helix Media Library Install Guide Click Next at the Product Key page. Accept the license terms on the next page and click Next. 21
Select the features that you are going to install. Database Engine Services and Management Tools Basic are required. Tick the boxes for them and click Next * You may not have the option of installing the management tools at this point depending on the version of the SQL installer you are running. If there isn t an option to install it, complete this process and once finished download it from the following link: http://www.microsoft.com/downloads/en/details.aspx?familyid=08e52ac2-1d62-45f6-9a4a- 4b76a8564a2b The installer is exactly the same as this one, but you will have the check box to install the management tools. 22
Helix Media Library Install Guide Click Next if you are happy with the named instance and the root directory, or change them if you would like a different name or install location. There will be a disk usage summary, click Next. Figures in this image are an example only. 23
Choose an account from the drop-down box on the Server Configuration screen. Here the system account has been used. Click next. An SA password needs to be used for the Helix Media Library to communicate properly with the server. This means that the server needs to be configured in Mixed Mode. Check the radio button and enter a password. The username will be sa. IMPORTANT: Make a note of the password that you have used here as this will be required when you install Helix Media Library, along with the username sa. 24
Helix Media Library Install Guide Add a user to the SQL server administrators role, and click Next. Click Next at the Error and Usage Reporting screen. The Installation Rules screen is next and this should run fine. If there are any failed items click on the Show Details button to see what they are. Click Next. The Ready to Install page will be a summary of the installation. Click Install to start the install. 25
The status should be Success once the install has completed. Click Next. Following this there will be a summary. Click close the complete the installation. 26
27 Helix Media Library Install Guide
Configure SQL to allow connections Once installation has completed click Start -> All Programs -> Microsoft SQL Server 2008 -> Configuration Tools -> SQL Server Configuration Manager. Expand the Protocols for SQLEXPRESS tree in the new window that appears as below: Right click on TCP/IP and select properties. In the pop-up dialogue change the Enabled property to Yes: Click on the IP Addresses tab and change the Enabled property for the 127.0.0.1 address and the IP address you are going to assign to the HML to Yes. Also update the TCP Port under IPAll to 1433 as shown: 28
Helix Media Library Install Guide Click OK and close the reminder about restarting services. Binding IP Addresses - IIS By default IIS, and Helix Server will try to listen on all available IP Addresses. In order to stop the resulting conflicts between services complete the following before setting up and running Helix Server for the first time. Open a command prompt, and execute the following to list the IP s that IIS is listening on: Netsh http show iplisten If the IP address to be used for Helix appears in the list use the following command to remove it: (x.x.x.x replace with listed IP) Netsh http delete iplisten ipaddress=x.x.x.x N.B. At this point, even though there may be no IP address listed, run the above command with the IP address that you want to use for the Helix server. This will ensure that IIS is not listening on this address. Then explicitly set the IP address which should be used for requests to IIS: Netsh http add iplisten ipaddress=x.x.x.x 29
(Where x.x.x.x is the IP address to be used for IIS) Now restart IIS by issuing the following commands: net stop http /y net start http /y net start w3svc Install Helix Server Launch the Helix Server installation file and click next until you reach the dialogue requesting the license key. At this point you will be required to select a license key file that matches the machine ID displayed. This can be obtained from http://pam.realnetworks.com/pam. Enter your credentials to access the product and license key download section. 30
Helix Media Library Install Guide Accept the license agreement and choose an installation location. The default in most cases. The next screen requests details for your Administration user name and password plus the ports required for administration access to the system. Enter your chosen credentials. For the administration port settings, any appropriate port not already in use can be set. For this example we have used Admin Port: 54321 and Secure Port: 12345 for ease. The following screen will ask for a number of ports to be used: RTSP [554] HTTP [80] HTTPS [443] MMS [1755] RTMP [1935] Channel-Control [8008] PlayList Control [8009] File System Control [8010]. These are recommended. 31
The above screen is modified for reference only, and not indicative of the installer. This screen allows you to enter the details that will be used in your security certificate. This certificate is employed during HTTPS connections to the server. Here is an overview of some of the fields that may be unfamiliar: Org. Unit: The organizational unit will correspond to your department, e.g. Accounts Common Name: Your domain name. For large organizations, use a wildcard before the domain name, e.g. *.myorganization.com. CSR Name: The name for your encrypted certificate request, e.g. Helix. 32
Helix Media Library Install Guide On the next screen ensure that Helix Server will be installed as a service and proceed to the end of the wizard. Upon clicking finish Helix Server will be installed, but not started. Install Helix Mobile Producer Launch the Producer installer. You will be given the option of selecting Helix Mobile Producer or RealProducer. Select Install Helix Mobile Producer. Similar to the Helix Server installation, a key will need to be selected to license Helix Mobile Producer and this must match the machine ID. 33
Follow the installation wizard through until the install is complete, selecting the default values unless otherwise necessary. IP Address and Domain Settings In order to run successfully, the Media Library requires 2 IP addresses and 3 host names: IP Address Host Name Bound To 0.0.0.1 hml.domain.com IIS 0.0.0.1 hmlupload.domain.com IIS 0.0.0.2 helix.domain.com Helix Server If the DNS entries needed aren't yet configured they can be added to the hosts file at the following location: C:\windows\system32\drivers\etc\ An example domain name and how to add other is explained within the hosts file and can be edited with Notepad or any standard text editor. 34
Helix Media Library Install Guide Binding IP Addresses - Helix Server Stop the IIS service running by opening the command prompt and issuing the following command into the command prompt window. net stop http /y Start the Helix Server for the first time by going to Start -> Administrative Tools -> Services. Helix Server or Helix Mobile Server should be showing a status of Started. Open Helix Server Administrator using the link on the desktop and log in using the credentials previously configured. Click on Server Setup -> IP Binding. Click the [+] sign to add an IP address and specify the address to be used by Helix server before clicking Apply. In this case you would enter 0.0.0.2 as per the table in the previous page. NOTE: 127.0.0.1 is used for illustrative purposes only; you should bind whatever IP Address is being used by Helix Server Click the Restart Server button at the top right of the page to apply the change to the IP address. At the command prompt window start IIS using the following command: net start http /y net start w3svc 35
Troubleshooting At this point the Server Administrator Web Page might say Internet Explorer Cannot Display the Webpage. If you do see this message then click the yellow bar at the top of the page and click on Enable Intranet Settings. 36
Helix Media Library Install Guide Install Helix Media Library Launch the HelixMediaLibrary.exe installer. If you do not have.net 4 installed on the server then you will be prompted to install it. Click Install. When it has finished downloading and installing, the installer will request a reboot of the system. Click Yes to reboot. 37
When the server has restarted and you have logged in, you will see a message asking you if you want to open a file. This is the Helix Media Library installer starting again. Click Run. Click Next at the welcome screen. 38
Helix Media Library Install Guide Upon agreement with the EULA, select I accept and click Next. Check that the prerequisites are available and can be accessed by the installer. 39
Choose your installation location for the Media Library software: Choose your installation location for the video content (bear in mind that this will need to be a large drive in most cases or network attached storage) for the initial installation it is recommended that this is a Local Drive. This can be changed later in the HML Admin GUI, if you wish to use an alternative Windows NTFS File System e.g. SAN or NAS. A separate document on alternative deployment scenarios is available with advice on specific set-ups 40
Helix Media Library Install Guide Browse to the location of your Helix Media Library Server license that will have been provided to you on purchase, for example, HML_Key_1.1_123456.licx. On finding a valid license, a dialog will confirm this. Enter the domain name assigned for the Helix Media Library front end, for example, hml.domain.com. Input the IP address associated with the domain name. Press TAB on the keyboard or left click to select each subsequent input field. IMPORTANT: hmladmin is the assigned administrator user name. Enter an administrator password and confirm it. Remember to record this information. Click Next when complete. 41
Complete the domain name and IP details for the Helix Media Library upload and administration web site, for example, hmlupload.domain.com. Enter the URLs where the RealMedia and Flash H.264 content will be held. For example, rtsp://helix.domain.com/media and rtmp://helix.domain.com/flash. The RealMedia and Flash content delivery services (mount points) are configured later. 42
Helix Media Library Install Guide Confirm the installation location of Helix Mobile Producer. 43
Enter the details for the SQL Server, including the SA password you configured earlier during the installation. Click Next to confirm. The details entered will be tested. If it fails to connect please refer back to the section on configuring SQL to allow connections from the software. Click Install to start the installation process. 44 A number of configuration messages will be displayed during the install. This may take several minutes so please be patient and wait until the installation is finished.
Helix Media Library Install Guide Once the install is complete click Finish. Upon completion two desktop icons will be created, Helix Media Library and Helix Media Library Administrator. These will provide access to the web front end of the service. Selecting the checkbox for detailed instructions in configuring the Windows Services will show information for configuring IIS 7Service 45
Updating to Version 3.0 Unzip the Updatemanager3_0.zip Right-click the Updatemanager.exe and click Run As Administrator Enter the administrator account credentials for the computer. These are required so that the scheduled task for the encoder is created with the sufficient privileges. Using the button with in it, navigate to the install directory of the Helix Media Library Click Update. The window will show the update process and then tell you when it is finished and the console window can be closed. 46
Helix Media Library Install Guide Click on Close to close the updater. Setting Permissions on the Helix Media Library directories. Once the Helix Media Library has been installed the permissions need to be set on the install and content directories. By default the sites will run under the Network Service account, as this is what the Helix App Pool in IIS and the VLS Service will be running under. To do this go to the install directory of the Helix Media Library software and right-click on the folder, i.e.: C:\HelixMediaLibrary. Click on the Security tab and click Edit 47
In the list locate and select the NETWORK SERVICE account (if it is not present in the list click on Add and add it in). From the permissions check the Modify box and then click OK. Click OK on the HelixMediaLibrary Properties window to close it, and then repeat the process for the Helix Media Library Content directory. 48
Helix Media Library Install Guide Create Mount Points for RealMedia and Flash Player Content RealMedia Content The Helix Media Library will look for the Real media content at the URL specified in the installer wizard. For the purposes of this document this is rtsp://helix.domain.com/media, so we need to create the media mount point. This can be configured by logging into Helix Administrator and browsing to Server Setup -> Mount Points and clicking [+] to add a new mount point. This should be configured to point to the content folder specified in the installer, as shown in the example below: (add the correct content directory to the Base Path, this was defined during the Media Library Installation). Click Apply, confirm the changes and then select Restart Server from the top of the page. 49
Flash Player H.264 MP4 Content As before the Media Library will look for the Flash H.264 content at the URL specified in the installer wizard. The example URL of rtmp://helix.domain.com/flash is used, so we need to create the flash mount point. Add the second mount as per the instructions above, based on the example settings shown below. The Base Path should be configured to point to the flash content folder specified in the installer as before. Click Apply, confirm the changes and then select Restart Server from the top of the page. Add HTTP Mount Point Select Server Setup -> HTTP Delivery. Click [+] to add a new path. Under Edit Path, add /flash (or the flash mount point name you specified above) and select Apply. The HTTP Mount point must be configured for mobile content to work. 50
Helix Media Library Install Guide URL Aliasing In order to deliver content to Android and Blackberry the files need to be referenced as.3gp instead of.mp4. Instead of moving them to a different mount point and renaming the extensions they can be aliased by Helix Server. This means that when the request comes in from a device asking for a.3gp file the Helix Server will point it to the.mp4 file instead. To set this up log into the Helix Server Administrator and open up the Server Setup menu on the left, then click on URL Aliasing. Enter in a description for the alias and then enter the alias of _lo.3pg, then the resource it will point to, _lo.mp4. Note: Only the _lo files are aliased, as high quality will not be viewed from mobile devices. IMPORTANT: The URL Aliasing must be configured for the Blackberry and Android streaming to work 51
Configure E-Mail Server Settings You will need to set the mail server settings within the Helix Media Library so that the relevant parties are notified on: Content encode success Content encode failure Reporting of inappropriate content to the administrator Log onto the Upload site of the Helix Media Library, by double clicking on the Helix Media Library Administrator icon on the desktop. Enter the hmladmin credentials you stored earlier. Go to Settings -> E-Mail Notifications as shown below and fill out the required details. SMTP Server: For example post.domain.com with SMTP administrator user credentials if authentication is required. From e-mail address: e.g. medialibrary@post.domain.com. This is the e-mail address that all notifications of success or failure will come from. Cc: address for all notifications to be copied to. Allow reporting of offensive content: a user will have the ability to warn the administrators of any content deemed inappropriate. 52
Helix Media Library Install Guide Customize Helix Media Library Appearance In the administration area, the Customization area lets you modify the headers for the sites and mobile devices, and add and edit disclaimer, email notification and help text. You can also add custom links to the front end portal, and change the footer text. For more information on customizing the mobile sites and changing text for email notifications, the disclaimer and the help page please see the user guide. 53
Segmentation You can enable segmentation for the iphone and ipad which means that when you access clips from these devices you will be accessing the file in segments to enable smoother delivery for long form content. When it is enabled, the Helix Server needs to be configured to allow this to happen. Segmentation is recommended when viewing clips over 2 MB in size from the iphone/ipad. If it is likely that there will be heavy mobile usage with the HML it is recommended that segmentation is enabled. Enabling Segmentation on Helix Universal Server 14.3 To configure the Helix Server to do this: Before loading the Helix Server Administrator, create a directory to where you would like the segments to be output. Load Helix Server Administrator Expand Server Setup and click on Mount Points. Create a new mount point to point to the directory just created. 54
Helix Media Library Install Guide In the example above, the segments directory has been created on the root of the E:\drive. Once the mount point is created apply the changes with the Apply button and then in the top right of the Helix Server Administrator screen click Restart to restart the server. Click on IP Binding and note down the IP address that the Helix Server is bound to. Now from the menus on the left click on Content Management and then click on Media Segmentation. Change the drop-down box to Yes where it says Enable Segmentation, and for the Server Hostname put in the IP address you noted down in the step above. Click on the plus icon where it says Source Path and enter your flash mount point. Change Enable Source Path to Yes and select the destination mount point, which will be your /segments/ one. 55
Scroll to the bottom of the page and click Apply. From the menus on the left go back up to HTTP/S Delivery under the Server Setup heading. Under HTTP Delivery click the plus icon and add the /segments/ mount point, and if not already added, the /flash/ one. Click Apply to save the changes. 56
Helix Media Library Install Guide Enabling Segmentation on Helix Universal Server 15.1 There is a default segmentation library which is created during the installation of Helix Server. This resides on the installation drive and is purged when 5GB is reached. For the purposes of this installation, the following steps describe how to enable segmentation using this default location for segments. Consult the Helix Universal Server guide for information on how to create a new location for segments. Load Helix Server Administrator Expand Server Setup and click on Mount Points. The Segment Library mount point can be seen in the list and it displays the base path where the segments will be generated. Now from the menus on the left click on Media Delivery and then click on HLS Setup. Change the drop-down box to Yes where it says Enable Segmentation. Under Source Paths click the 57
plus button and enter /flash/. Select /flash/ and set it to the Destination Mount Point of /segments/. Scroll to the bottom of the page and click Apply. 58
Helix Media Library Install Guide How to add the.srt file extension as an accepted MIME type in IIS Open IIS Manager and click on the server name on the left-hand side From the right-hand side click on Add In the window that opens, enter in the extension as.srt and the MIME type as text/plain 59
Enabling Session Manager for Secure Categories How to Configure Session Manager for Helix Server v14.x This document applies to Helix Sever version 14.x installations only. If you are running Helix Server version 15.x then please skip to the next section for configuring Session Manager for v15.x Go to your PAM site: http://pam.realnetworks.com/pam Log in and go to Your Product Upgrades. Under your licensing program click View Details or Download Product. Accept the EULA and find the Session Manager license. Click on View Details or Download Product. Next to the version of Helix Server you are using, click Download License Key. Fill out the form and get it sent to your email address When you get the license download it and place it in the licenses directory in your Helix Server install, for example: C:\Program Files\Real\Helix Server\Licenses Now go back into your licensing program and download the Helix Session Manager version that corresponds with your version of Helix Server Once downloaded you will need to use a tool that can unzip the.tar file. Once you ve unzipped it open the folder which corresponds with your system type and copy the.dll to the Plugins folder within your Helix Server directory. N.B. If you are running Windows Server 64 bit but have Helix Server 32 bit installed, take the.86.dll Open the rmserver.cfg file located in the root install of your Helix Server software, e.g. C:\Program Files\Real\Helix Server\rmserver.cfg Scroll to the bottom and add in the following text in red in between the text that is black: 60
Helix Media Library Install Guide ==================================================================== ========================================================== <Var ValidPlayersOnly="0"/> <Var User="%-1"/> <Var RTSPMessageDebug="0"/> <Var PlusOnly="0"/> <Var MonitorConnections="4"/> <Var MinPlayerProtocol="0"/> <Var MaxBandwidth="0"/> <Var KeepAliveInterval="79"/> <List Name="IPBindings"> <Var Address_1="212.70.71.194"/> <Var Group="%-1"/> <Var ClientConnections="0"/> <Var Capacity="10000"/> <List Name="DAUCSessionMgr"> 61 <Var Enabled="1"/> <List Name="SessionManagement"> <Var Realm="server.realm"/> <Var Port="8087"/> <Var Username="admin"/> <Var Password="helix"/> <Var AuthenticationType="basic"/> <List Name="LogOutput"> <Var AuthLogging="1"/> <Var AuthLogFileName="C:\Program Files (x86)\real\helix Server\Logs\sessionmgr.log"/> <Var LogRollSize="50"/>
<Var TemplateFormat="%Client.*.Session.*.PlayerRequestedURL%"/> <Var LogServerStart="1"/> <Var IntervalLogging="1"/> <Var IdleLogging="1"/> <List Name="Events"> <List Name="SessionStart"> <Var Blocking="1"/> <List Name="Actions"> <List Name="Action_1"> <Var Type="ExternalAuth"/> <Var ExternalAuthServer="Server"/> <Var ConnectionTimeout="30"/> <Var ResponseTimeout="15"/> <List Name="DefaultAction"> <Var Name="Deny"/> <List Name="Action_2"> <Var Type="Log"/> <List Name="ExternalAuthServers"> <List Name="Server"> <Var Server="upload.videolibraryserver.com"/> <Var Port="80"/> <Var Path="/Security/HelixSessionAuth.aspx"/> 62
Helix Media Library Install Guide <List Name="Aliases"> <List Name="Mobile Delivery"> <Var Alias="_lo.3gp"/> <Var Resource="_lo.mp4"/> ======================================================================= ========================================================== Change the password in the value <Var Password="helix"/> to the password to log into your Helix Server Administrator Replace the value for <Var Server= upload.videolibraryserver.com /> with the name of the upload site for your Helix Media Library Restart the Helix Server service 63
How to Configure Session Manager for Helix Server v15.1 This document applies to Helix Sever version 15.1 installations only. If you are running Helix Server version 14 then please search the KB for configuring Session Manager for v14. This document describes how to configure Session Manager for Helix Server in order to use the Secure Categories feature in the Helix Media Library. Session Manager is included with Helix Universal Media Server v15.1, and as such there is no need to download it from the Real Networks PAM site. It is just configured in the Helix Sever configuration file Open the rmserver.cfg file located in the root install of your Helix Server software, e.g. C:\Program Files\Real\Helix Server\rmserver.cfg Scroll to the bottom and find the following section: <!-- Begin Session Manager Section --> <!-- This section is only required for the Session Manager --> <List Name="DAUCSessionMgr"> <Var Enabled="0"/> <List Name="LogOutput"> <Var AuthLogging="1"/> <Var AuthLogFileName="Logs/sessionmanager.log"/> <Var LogRollSize="20"/> <Var TemplateFormat=""/> <Var LogServerStart="1"/> <Var IntervalLogging="0"/> <Var IdleLogging="0"/> 64
Helix Media Library Install Guide <List Name="URLKeywords"> <Var LogIntervalKeyword="li"/> <Var HLSSessionExpiration="60"/> <List Name="Events"> <!-- ====== S E S S I O N S T A R T ====== --> <List Name="SessionStart"> <Var Blocking="1"/> <List Name="Actions"> <List Name="Action_1"> <Var Type="Log"/> <List Name="Action_2"> <Var Type="ExternalAuth"/> <Var ExternalAuthServer="EventTracker01"/> <Var ConnectionTimeout="30"/> <Var ResponseTimeout="15"/> <List Name="DefaultAction"> <Var Name="Deny"/> <Var Message="We are sorry. This clip cannot be streamed."/> <!-- ====== P L A Y ====== --> <!-- Log each session play action.--> <List Name="Play"> <List Name="Actions"> <List Name="Action_1"> <Var Type="Log"/> 65
<!-- ====== P A U S E ====== --> <!-- Log each session play action.--> <List Name="Pause"> <List Name="Actions"> <List Name="Action_1"> <Var Type="Log"/> <!-- ====== R E S U M E ====== --> <!-- Log each session play action.--> <List Name="Resume"> <List Name="Actions"> <List Name="Action_1"> <Var Type="Log"/> <!-- ====== S E S S I O N S T O P ====== --> <!-- Log each session stop.--> <List Name="SessionStop"> <List Name="Actions"> <List Name="Action_1"> <Var Type="Log"/> 66
Helix Media Library Install Guide <List Name="ExternalAuthServers"> <List Name="EventTracker01"> <Var Server="authorization.example.com"/> <Var Port="8080"/> <Var Path="/media/authorization.pl"/> <Var AllowRedirect="1"/> <Var SendFullURL="1"/> <List Name="SessionManagement"> <Var Realm="server.realm"/> <Var Port="port"/> <Var Username="name"/> <Var Password="password"/> <Var AuthenticationType="basic"/> <List Name="ByPassAuthentication"> <Var MatchAction="ByPassAuth"/> <Var MatchMask="1"/> <List Name="MatchStrings"> <Var MatchString_1="free"/> <Var MatchString_2="sample"/> <Var MatchString_3="error"/> <Var MatchString_4="clients"/> <Var MatchString_5="sdpgen"/> <Var MatchString_6="ramgen"/> <Var MatchString_7="flashgen"/> <Var MatchString_8="asxgen"/> <Var MatchString_9="m3ugen"/> <Var MatchString_10="handset"/> <Var MatchString_11="[/]dashgen[/](?!.*([.]ts [.]m4s))"/> 67
<!-- End of Session Manager Section --> ==================================================================== ========================================================== Replace all of the text above with the text in red below: <!-- Begin Session Manager Section --> <!-- This section is only required for the Session Manager --> <List Name="DAUCSessionMgr"> 68 <Var Enabled="1"/> <List Name="LogOutput"> <Var AuthLogging="1"/> <Var AuthLogFileName="C:\Program Files\Real\Helix Universal Media Server\Logs\sessionmgr.log"/> <Var LogRollSize="50"/> <Var TemplateFormat="%Client.*.Session.*.PlayerRequestedURL%"/> <Var LogServerStart="1"/> <Var IntervalLogging="1"/> <Var IdleLogging="1"/> <List Name="Events"> <List Name="SessionStart"> <Var Blocking="1"/> <List Name="Actions"> <List Name="Action_1"> <Var Type="ExternalAuth"/> <Var ExternalAuthServer="Server"/> <Var ConnectionTimeout="30"/>
Helix Media Library Install Guide <Var ResponseTimeout="15"/> <List Name="DefaultAction"> <Var Name="Deny"/> <List Name="Action_2"> <Var Type="Log"/> <List Name="ExternalAuthServers"> <List Name="Server"> <Var Server="upload.helixmedialibrary.com"/> <Var Port="80"/> <Var Path="/Security/HelixSessionAuth.aspx"/> <!-- End of Session Manager Section --> ======================================================================= ========================================================== At the bottom of your rmserver.cfg file add the following: <Var DAUCHttpPostUsingNewLine="1"/> Replace the value for <Var Server= upload.helixmedialibrary.com /> with the name of the upload site for your Helix Media Library Restart the Helix Server service 69
You may need to add a bypass rule so that some URL s are ignored, for example if you are doing live streams or streaming to mobile devices. Session manager will only evaluate one URL, and if there is a redirect then it will not validate. For example the setup as described above will work for the Flash mount point used in the Helix Media Library, but other URL s will fail because it won t recognise the virtual mount point after the main URL, for example: http://hml.domain.com/m3ugen/mountpoint/12345678.mp4 A bypass rule needs to be created so virtual mount points such as m3ugen, flashgen, ramgen etc or streaming protocols that responds or generates additional links such as HLS and DASH behind the scenes, are ignored and playback will work. Place the following text in RED inside the tags in black below. DO NOT COPY THE TEXT IN BLACK BELOW: <List Name="ExternalAuthServers"> <List Name="Server"> <Var Server="upload.helixmedialibrary.com"/> <Var Port="80"/> <Var Path="/Security/HelixSessionAuth.aspx"/> <List Name="ByPassAuthentication"> <Var MatchAction="ByPassAuth"/> <Var MatchMask="1"/> <List Name="MatchStrings"> <Var MatchString_1="free"/> <Var MatchString_2="sample"/> <Var MatchString_3="error"/> <Var MatchString_4="clients"/> <Var MatchString_5="sdpgen"/> <Var MatchString_6="ramgen"/> <Var MatchString_7="flashgen"/> 70
Helix Media Library Install Guide <Var MatchString_8="asxgen"/> <Var MatchString_9="m3ugen"/> <Var MatchString_10="handset"/> <Var MatchString_11="[/]dashgen[/](?!.*([.]ts [.]m4s))"/> <!-- End of Session Manager Section --> 71
Troubleshooting Helix Server fails to start and the Administration pages cannot be reached. If due to existing IP conflicts you are unable to start the Helix Service, add the following lines to the end of the rmserver.cfg file found in the Helix Server installation directory. <! I P B I N D I N G --> <List Name= IPBinding > <Var Address_1= 127.0.0.1 /> Replace 127.0.0.1 with your Helix servers IP The website reports a Service Unavailable application error. This error normally arises from either a) conflicting versions of.net on the system, or b) a failed installation of.net. Solution: Open a command prompt Run: net stop w3svc Run: net stop http /y cd %windir%\microsoft.net\framework\v4.0.30319 Run: aspnet_regiis.exe ua Run: aspnet_regiis.exe i Run: net start w3svc Run: net start http /y Go to Start Menu -> Administrative Tools -> Internet Information Service (IIS) Manager. Select your server; highlight Web Service Extensions. In the right pane, make sure ASP.NET version is set to v4.0.30319 72
Helix Media Library Install Guide IIS 32 App Support on 64 bit OS If you are installing the software on Windows 2008 64 bit, then you may need to change the Default App Pool so that it supports 32 bit applications before the web sites will start. To do this open IIS Manager, expand the server name on the left-hand side and click on Application Pools. Right-click on the DefaultAppPool on the right-hand side and click on Advanced Settings. Click on the drop-down box next to Enable 32-Bit Applications and change the value to True. Then click OK. 73
Back on the main IIS page, right-click on Application pools in the left menu and click refresh. Now try accessing the sites again. Starting the Helix Server Administrator If when you start the Helix Server administrator you see an Internet Explorer cannot display the web page message, then making a change to the URL could fix this. You can replace the name of your server in the URL of the administrator page with localhost and this should show you the logon screen. For example, if your Helix Server Administrator page URL is: http://servername:54321/admin/index.html Try changing it so that it reads: http://localhost:54321/admin/index.html 74
Helix Media Library Install Guide SQL Troubleshooting Installing Windows PowerShell If you notice that Windows PowerShell has failed, then it means that it needs to be installed. This can be done from the Server Manager. Open the Server Manager by clicking Start, Administrative Tools, and clicking Server Manage. Click on features on the left-hand side and then on the righthand side click Add Features. Scroll down and select Windows PowerShell then click Next. At the next page click Install. Once the installation is successful close the Add Features Wizard. 75
Uninstalling Helix Media Library If an installation has previously been performed and was unsuccessful, follow the below steps to completely remove the software before attempting a re-install. This is because to protect the database and media content the uninstaller does not remove all components required for a reinstall to occur successfully. To uninstall completely follow the steps below. Run the Helix Media Library uninstaller from the Add/Remove Programs wizard. To do this click on Start, then open Control Panel and click Programs/Programs and Features. Click on Helix Media Library in the list, then click Remove. Click Yes at the prompt asking you whether you want to remove the Helix Media Library and it will be uninstalled. 76
Helix Media Library Install Guide Open IIS by clicking on Start, then Administrative Tools and selecting IIS. Ensure that the sites have been deleted by the installer. If they haven t then delete them by right-clicking them one at a time and clicking Delete. Click Yes to confirm the deletion. Check that the scheduled task has been deleted by clicking on Start, Administrative Tools then double-clicking Task Scheduler. If there is a task there called Encoder Activity then right-click it and click Delete. Confirm it s deletion by clicking Yes. Check that the VLS and ASPState databases have been removed from SQL. To do this, click Start, All Programs, and find and open SQL Server Management Studio. Log in using the SA password or Windows Authentication (it the Windows account has administrative rights). Expand the databases folder, and if you see the databases VLS or ASPState delete them by rightclicking them and clicking delete. Confirm you are sure to delete by clicking Yes at the message. 77
Navigate to the directory X:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data (where X: is the drive SQL is installed on) and ensure that the following databases and associated logs are removed: ASPState.mdf, ASPState_log.ldf, VLS.mdf, VLS)log.ldf Lastly, check that the HML service has gone from within Services, and if not reboot the server. To check this click on Start, Run, then type services.msc in the run box and click OK. If the HMLService is listed, it should not be once the server has been restarted. Once these tasks have been performed then try the installation again and Helix Media Library should re-install without issue 78
Helix Media Library Install Guide WMV s Fail to Encode On Windows Server 2008 WMV s may fail to encode in the Helix Media Library even with the K- lite codec pack installed. This is because the operating doesn t ship with a copy of Windows Media Player that is configured by default. This can be installed however by adding the Desktop Experience Feature from the Server Manager. Open the Server Manager. 79
Click on Features and then click Add Features Tick the box for Desktop Experience and then click Next 80
Helix Media Library Install Guide At the next screen click Install Once installation is complete click Close to close the wizard and then click Yes to restart the server now. 81