HELIX MEDIA LIBRARY INSTALL GUIDE
FOR WINDOWS SERVER 2003
Helix Media Library Version 1.1
Summary of Contents
Summary of Contents ... 2
Pre Installation Checklist ... 4
Prerequisites ... 5
Install Windows 2003 Server ... 5
Installation Types ... 6
Installation ... 7
Install Security Updates ... 7
Install Server Roles ... 7
Application Server ... 8
Install Windows DirectShow Codecs ... 12
Install Apple QuickTime ... 13
Install Microsoft SQL 2005 Express Edition ... 14
Configure SQL to allow connections ... 18
Install Helix Server ... 20
Install Helix Mobile Producer ... 23
IP Address and Domain Name Settings ... 25
Binding IP Addresses ... 28
Binding to Internet Information Services (IIS) ... 28
Helix Server ... 28
Install Helix Media Library ... 30
Create Mount Points for RealMedia and Flash Content ... 37
RealMedia Content ... 37
Flash Player H.264 MP4 Content ... 38
Add HTTP Mount Point ... 38
Configure E-‐Mail Server Settings ... 39
Customize Helix Media Library Appearance ... 40
Troubleshooting ... 42
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 2003 Server / R2 (32/64Bit)?
o
Alternative Browser? [Links on Page 6]
o
Windows Server Support Tools?
o
.NET Framework v3.5 installer?
o
SQL Server Express installer?
o
Helix Server installer and license?
o
Helix Mobile Producer installer and license?
o
Windows Audio and Video Codecs?
o
Apple QuickTime installer?
o
2 available IP addresses?
o
3 available domain names?
o
Media Library installer and license?
o
E-‐Mail server and administrator account (if required) available?
o
Logo and colors for Helix Media Library customization?o
Prerequisites
Install Windows 2003 Server
Microsoft Windows Server 2003 required. Versions supported:
§Standard
§Standard R2
§Enterprise
§Enterprise R2
§Both 32Bit and 64bit are supported
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 best implemented following a successful installation on a single piece of hardware and with the advice of your System Supplier
Installation
The following guide assumes that you are installing all the components on the same sever. It is important to remember that if you intend to later on separate out the services across different hardware, the pre-‐installation software (listed in this guide), Helix Mobile Producer and Helix Media Library software needs to be installed on the same server.
Install Security Updates
Run Windows Update and confirm all advised security updates are installed. Service Pack 2, with auto-‐update enabled is recommended.
Install Server Roles
A number of additional services are required for the Media Library Server.
To install, select Start Menu -‐> Control Panel -‐> Add/Remove Programs. From the new control panel window that appears, select Add/Remove Windows Components.
Under Application Server, select the following: (highlight as shown, click Details button).
Application Server
Select Enable network COM+ access.
Highlight Internet Information Services (IIS) and then click Details.
Select Active Server Pages. Select World Wide Web Service.
At this point, press OK to proceed back through all the previous screens. An installation dialog will appear showing the update process.
You may require your Windows Server 2003 operating system installation disc at this point. Ordinarily the files required reside in the I386 folder of the Disc so it may be easy just to copy this folder.
Once complete, you may close the Control Panel window.
Select Start Menu -‐> Administrative Tools -‐> Internet Information Service (IIS) Manager.
Delete the Default FTP Site and the Default Web Site. Close IIS.
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
Windows Server 2003 Support Tools – Required for binding the IP address to 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 an additional browser for testing:
Mozilla Firefox: http://www.getfirefox.com
Download and install .NET 3.5:
Obtain the .NET installer from: http://www.asp.net/downloads/essential/ *
As of this document, Microsoft .NET Framework Version 3.5 SP1 is the current version. Run the installer and follow the prompts shown. All default values can be selected.
This requirement must be a full install, do not skip this step as older version with updates can lead to potential problems. * We are not responsible for software downloaded from third party web sites. Once the .NET installation is completed, please check that IIS is able to access it.
Go to Start Menu -‐> Administration Tools – Internet Information Service (IIS) Manager Select Web Service Extensions from the panel on the left (as shown below). Within the panel on the right select ASP.NET v2.0.50727. Confirm the Status for the extension is set to Allowed.
Install Windows 2003 Server Support Tools
Obtain a copy of the Support Tools installer. This can be found on the Windows Server 2003 disc at the following path -‐ \support\tools.
Double click the SUPTOOLS.MSI file and follow the prompts to install the software.
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 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.
http://www.streaming.co.uk/installers/prereq/k-‐lite/K-‐Lite_Codec_Pack_700_Mega.zip
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).
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.
Installer available from:
http://www.apple.com/quicktime
Install Microsoft SQL 2005 Express Edition
Download Microsoft SQL Server 2005 with Advanced Services from:
http://www.microsoft.com/downloads/en/details.aspx?FamilyId=5b5528b9-‐13e1-‐4db9-‐a3fc-‐ 82116d598c3d&displaylang=en
Launch the installer and follow the setup wizard until you reach the Registration Information dialogue, here uncheck the Hide advanced configuration options box:
On the next screen, ensure that the features selected below are selected for installation:
• Database Services ü Data Files
ü Shared Tools
• Client Components
ü Management Studio Express
Accept the default options on the subsequent screens until you reach the Authentication Mode screen. Here select Mixed Mode and enter your chosen sa * password:
*sa = the super user account for overall administration of MSSQL
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’.
Accept the default options on the subsequent screens until you reach Configuration Options. Here, uncheck Enable User Instances and check Add user to the SQL Server Administrator role:
Configure SQL to allow connections
Once installation has completed click Start -‐> All Programs -‐> Microsoft SQL Server 2005 -‐> 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 to Yes. Also update the TCP Port under IPAll to 1433 as shown:
Click OK and close the reminder about restarting services.
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.
Accept the license agreement and choose an installation location.
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] n HTTP [80] n HTTPS [443] n MMS [1755] n RTMP [1935] n Channel-‐Control [8008] n PlayList Control [8009] n File System Control [8010]. These are recommended.
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. If you are not going to use an SSL certificate with your Helix Server leave this section blank.
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.
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.
Follow the installation wizard through until the install is complete, selecting the default values unless otherwise necessary.
IP Address and Domain Name Settings
In order to run successfully, the Media Library requires 2 IP addresses and 3 domain names:
IP Address Domain 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 of how to add entries is explained within the hosts file and it can be edited using Notepad or any standard text editor.
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 Connections. Right-‐click on your active network connection and select Properties.
Select Internet Protocol and 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.
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.
Click OK on the advanced settings window, then on the Internet Protocol Properties window to save the changes and exit.
Binding IP Addresses
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 process to bind one IP address to IIS before running Helix Server for the first time.
Binding to Internet Information Services (IIS)
Open the command prompt and change to the following directory (use ‘cd ‘ to change directory):
c:\program files\support tools
Execute the following to list the IP’s that IIS is listening on:
httpcfg query 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)
httpcfg delete iplisten /i x.x.x.x
Then explicitly set the IP address which should be used for requests to IIS:
httpcfg set iplisten /i x.x.x.x
(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
Run the command httpcfg query iplisten to check that the ip address is now listed. Close the command prompt.
Helix Server
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.
Click the [+] sign to add an IP address and specify the address to be used by Helix server before clicking Apply.
Click the “Restart Server” button at the top right of the page to apply the change to the IP address.
Install Helix Media Library
Launch the HelixMediaLibrary.exe installer. Click next at the initial screen:
Upon agreement with the EULA, select I accept and click Next.
Click Next at the prerequisites screen -‐ Each should be APPROVED. If there is one that isn’t note which it is and review the installation procedure.
Choose your installation location for the Media Library software:
Choose your installation location for the 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 File System e.g. SAN or NAS:
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.
IMPORTANT: hmladmin is the assigned administrator user name. Enter an administrator password and confirm it. Remember to record this information. Click Next when complete.
Complete the domain name and IP details for the Helix Media Library upload and administration web site, for example, hmlupload.institution.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.
Confirm the installation location of Helix Mobile Producer.
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.
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.
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 7. This check box can be unticked as it only applies to Server
2008 installations.
Create Mount Points for RealMedia and Flash Content
RealMedia ContentThe 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).
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.
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
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
Allow reporting of offensive content: a user will have the ability to warn the administrators of any content deemed inappropriate.
Customize Helix Media Library Appearance
In the administration area, selecting Settings -‐> Customization, the coloring, logos and text style of the Media Library can be changed.
• Change the navigation menu color (top) and the accompanying text. • Change the site wide font used for all body text and its color. • Change the text color, highlight and selected color of the side menu. • Apply an image to the bottom of the page (800 pixels wide).
Changes can also be made to the iPhone site from this screen. Please see the user guide for further information on this.
The initial setup is now complete and ready for testing. Upload a number of clips with varying codecs to test the upload, encoding, and email processes.
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”/> </List>
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 3.5.
Solution:
• Open a command prompt • Run: net stop w3svc • Run: net stop http /y
• cd %windir%\Microsoft.Net\Framework\v2.0.50727 • Run: aspnet_regiis.exe –ua
• 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 v2.0.5027 has an Allowed status.
Select Web Sites. Right-‐click on HML, select Properties. Select the ASP.NET tab; make sure ASP.NET version is set to v2.0.50727.
Repeat this last step for the HML Upload site.
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 the uninstaller misses a couple of components which if not removed will prevent a re-‐installation.
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 double-‐click Add/Remove Programs.
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.
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 on at a time and clicking Delete. Click Yes to confirm the deletion.
Check that the scheduled task has been deleted by clicking on Start, Control Panel then double-‐ clicking Scheduled Tasks. 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 right-‐ clicking them and clicking delete. Confirm you are sure to delete by clicking Yes at the message.
Navigate to the directory ‘X:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data’ 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.
