HTTP Transformer Installation Guide - Grass Valley - PDF Room
HTTP Transformer Installation Guide - Grass Valley - PDF Room
www.s.a.m.com
HTTP Transformer
Contact Details
Customer Support
For details of our Regional Customer Support Offices please visit the SAM web site and
navigate to Support/Customer Support Contacts.
https://s-a-m.com/support/247-support/
Customers with a support contract should call their personalized number, which can be found
in their contract, and be ready to provide their contract number and details.
Conventions Used
Text
Symbols
Contents
HTTP Transformer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Verifying the Correct Version of Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
HTTP Transformer Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Configure Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Install Transformer Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Transformer Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Network: Clipnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
QTube Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Server: Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Essence: Audio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Essence: Video (PC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Setting Group Area Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
IIS and Couch DB Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Install IIS and CouchDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Search Service Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Search Service Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Web Server Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
ISA Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Customise Log Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Install Search Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Overview
Prerequisites
To set-up the HTTP Transformer, the following is required:
• A working ISA sQ system that is configured to support a seat and has H.264 and/or
MPEG-1 browse at 1.5 Mbit. The ISA system also needs the Search service installed.
• A newly installed Windows Server 2008 R2 64-bit operating system on an X8
motherboard.
• For convenience, customise the Windows Start menu to make Administrative Tools
display on this menu.
• Sentinel Dongle Driver V7.4.2.exe
• Access to the Internet in order to download extra parts for IIS.
• An installer package containing HTTP Transformer and QTube Edit.
• A synchronised clock in order to successfully connect to remote shares.
• VC9 Redistributable (VC Runtime) must be installed.
• The PC client must be logged in as ‘Administrator’.
The previous options are usually set on installation by trained engineers with
knowledge of Windows and networking. If in doubt, always contact SAM 24-Hour
Support before changing any setting.
Upgrading
When upgrading from versions prior to V5.4 rev 8, note the following registry settings.
Registry Settings
Under its development name, the HTTP Transformer was previously known as the QTube
Transformer in versions prior to V5.4 rev 8. Software settings are saved in the Window’s
Registry under a key called QTube Transformer.
From release V5.4 rev 8 onwards, the key is called HTTP Transformer. Any existing registry
settings must be migrated from the QTube Transformer key to the HTTP Transformer key.
1. Open regedit.exe.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quantel\QTube Transformer\.
3. Right-click and select export.
4. Export this to a temporary folder.
5. Open this exported file in a text editor.
6. Within the text editor, perform a find and replace from string
'\SOFTWARE\Quantel\QTube Transformer' to '\SOFTWARE\Quantel\HTTP
Transformer'.
7. Save the changes to the file.
8. Back in regedit.exe, import the edited file.
This migrates the registry settings from QTube Transformer to HTTP Transformer.
4. In Home or work (private) network location settings, select Turn off Windows
Firewall (not recommended).
5. In Public network location settings, select Turn off Windows Firewall (not
recommended).
6. Click OK.
Running the software for the first time (step 4 above) is important as it populates the
default registry settings.
License
Obtain License using Disk ID
1. Navigate to C:\Data\Logs and open the file named Recent. This opens the most
recent activity log.
2. Press <Ctrl>+<F> to open the search tool.
3. Search the log for the phrase: Valid locking code.
4. E-mail this code to licences@s-a-m.com, quoting the order number and allow one
working day for the license to be created and mailed.
5. When the license has been received, install it using the steps below.
Install License
To install the license:
1. In Windows, create the directory C:\Data\Licenses\.
Ensure that the ‘licenses’ folder is spelt as shown above in order for it to be
correctly located by the software.
Transformer Settings
After installing the license, settings must be configured in the Settings menu. Some settings
are not described here, as they are optional, depending on user preference.
1. In Windows, navigate to: Start – All Programs – SAM – HTTP Transformer V#.# rev
# – Settings.
2. Right-click Settings then select Run as administrator.
Some of these options only become available after running the software up for the
first time.
The scroll box at the top-left of the Settings application provides access to different menus:
License
1. From the top-left drop-down box, select License.
Figure 4 License
2. Select Local.
3. Check that the License file location path is C:\Data\Licenses\lservrc.lic.
Network
1. From the top-left drop-down box, select Network.
Figure 5 Network
2. In the ISA Zone HTTP paths field, enter the location of the ISA Manager’s ZonePortal
IOR e.g., http://my-isa/ZoneManager.ior.
3. Deselect Essence Transfer – Use ISA Browse Manager.
Network: Clipnet
1. From the top-left drop-down box, select Network: Clipnet.
Figure 6 Network:Clipnet
Options
If there is video encoded as DV100 or AVCI on the server, then the relevant licence checks
need to be enabled:
1. From the top-left drop-down box, select Options.
Figure 7 Options
2. Tick either Enable AVCI decode licence, Enable AVCI encode licence check or
Enable DV100 license check (depending on sQ formats enabled).
HTTP
The web interface defaults to port 80 which is already in use by IIS so it must be changed:
1. From the top-left drop-down box, select Http Server.
Startup
1. From the top-left drop-down, select Startup.
Figure 9 Startup
QTube Settings
Setting a Mixed Browse System
If there is a mixture of clip formats being used in the system (e.g. MPEG-1 browse and H.264)
the HTTP Transformer can be set to browse mixed formats.
1. From the top-left drop-down, select QTube Settings.
Server: Search
HTTP Transformer settings allow search constraints to be set up on any connected client. To
set up a search constraint:
1. From the top-left drop-down, select Server: Search.
This example means that there is a search constraint that only allows users to search among
clips that have ‘Recording’ as all or part of the title.
3. After entering the constraint in the Search Constraint field, click OK.
Essence: Audio
If the Transformer does not have a dedicated audio disk partition set the audio folder to a
drive partition which has sufficient space to store audio for clips published via QTube.
Transformer PCs supplied have enough space in the Data Partition to set this up.
1. From the top-left drop-down box, select Essence: Audio.
Security
About Certificates
These settings depend on each organisation’s setup and there are several security options
that can be chosen. These instructions describe how to create a self-signed certificate and
then share it with any other machines in the cluster. A self-signed certificate is free to create
and use.
The effect of this is that new visitors to the site are informed that it is a valid certificate but it
has not been verified by a trusted site. This notification must be accepted and then the
certificate must be saved locally.
It is the responsibility of each organisation to arrange a server certificate from a ‘Trusted
Authority’ should one be required. SAM cannot apply for one on another organisation’s behalf
(a restriction put in place by the signing authority). On receipt, it can be imported using the
instructions below.
Certificate Creation
The certificate must be created on one PC and then imported to all others. To create
self-signed certificates and then export:
1. Go to Start – All Programs – Administration Tools – Internet Information
Services (IIS) Manager.
2. In the Connections panel, highlight the hostname (hostname\administrator). For
example, PVGIS-CC01 (PVGIS-CC01\quantel).
3. Double-click Server Certificates and select Create Self-Signed Certificate...
4. In the Specify a friendly name for the certificate field, enter the domain name of the
cluster.
5. Click OK.
6. From the Actions panel on the right, highlight the new certificate and click Export...
7. In the Export to field enter C:\<cluster-name>.
8. Enter a password into the Password and Confirm password fields.
9. Click OK.
10. Open Windows Explorer and navigate to where the certificate is stored and copy it to
somewhere centrally available.
4. Select Edit Site – Bindings... from the Actions panel on the right.
5. If all testing is finished, select http from the list of Site Bindings and click Remove.
6. Click Add... to add site bindings.
Authentication
1. Launch the IIS Manager program. Go to Start – All Programs – Administration
Tools – Internet Information Services (IIS) Manager.
2. In the Connections panel, highlight the hostname (hostname\administrator). For
example, PVGIS-CC01 (PVGIS-CC01\quantel).
Any changes made to the ISA Manager may seriously impact workflow and system
network traffic. DO NOT change any settings unless you are a qualified engineer.
Always contact SAM 24-hour support for advice beforehand.
ISA Settings
The Search service can only index one ISA Zone. The Search service must be configured
with the URL of an ISA in that Zone. An ISA master/slave URL pair can also be specified.
Given an ISA URL in the form http://[host]:[port]/ZoneManager.ior the Search service
attempts to fetch the IOR at the following URL: http://[host]:[port]/ZoneManager.ior.
The Search service also requires the appropriate user name and password for accessing the
ISA database via JDBC.
c:\Data\Search\Search\webserver\logs
• If the searchpath property exists but is not set correctly, update the existing
setting by selecting searchpath. Edit the settings by following steps 4 - 6.
3. Press Add property and set the name as ‘searchpath’.
4. Set the value to the following:
http://{IP address of search service}:8182/
5. Press searchpath and enter the correct IP for the search service.
6. Press Create and then Refresh database at the top of the page.
The Search service can be controlled by tools located under the bin folder. Most tools use the
search.bat command line interface. Execute search.bat -help for some help messages on
how to use it.
The Search service needs to be running, in order to populate the server bin with clips.
Execute bin\start_search.bat to start the Search service.
The Search service is ready when “- Waiting for an indexing operation to be submitted.”
has been displayed in the console window.
To check that the Search service is running, open the following URL:
http://localhost:[port]/quantel/search/select?q=*
Alternatively, execute search -status.
Execute stop_search.bat or search -stop to stop the Search service.
Figure 19
Check that the NLB feature is installed on both servers before proceeding further.
NLB is configured using the NLB Manager from one of the servers but this completes the NLB
cluster configuration on both servers.
1. From one of the servers start the command prompt and type nlbmgr
2. Open NLB Manager window and click Options - Credentials and enter the admin
username and password previously created on both servers.
3. Go to Cluster - New and in the Host field type the IP address of Server B, for
example.
Figure 21
8. Click OK.
9. Click Next.
10. In New Cluster: Port Rules window click Edit and use the following screenshot as a
reference for configuring the Port Rules.
Figure 22
Figure 23
Figure 24
From another PC, ping the IP address of the cluster. A successful reply confirms the NLB
cluster is configured correctly.
Figure 25
Figure 26
• Enable Shared Configuration on the second server and use the same Physical path,
same username and password and same encryption key pass.
Figure 27
From the other server check that the Bindings are the same as on the server that has been
changed.
Microsoft's Application Request Router (ARR) IIS Extension is a complex piece of software
which integrates with several other components to do its job. These components are URL
Rewrite, Web Farm Framework and ARR's External Cache module. For everything to work
correctly, all components must be installed in a specific order. Several years ago, Microsoft
introduced the Web Platform Installer (WebPI) mechanism, which makes it easy to manage
installed components, and this is a good way to install ARR and all its components properly.
Occasionally, there may be reasons to no use the WebPI installation option. For example,
when installing ARR on the Server Core edition of Windows, where WebPI cannot be used. If
so, another option is installing it using the IExpress package, which includes all the
components together. To use this, download it from www.microsoft.com.
A further option is to install the components manually, which requires all components to be
downloaded separately from www.microsoft.com:
1. Firstly, Stop IIS. From a command prompt, type net stop was /y and
net stop wmsvc /y:
Figure 28
WMSVC is the IIS Web Management Service, which may not be enabled on the
server. If it is not enabled, “The Web Management Service service is not started.”
displays. This warning can be ignored.
If downloading to an X86 server, for example, windows 2008, download the X86
version of these components.
Configure ARR
1. Open IIS Manager on one server and open Application Request Routing Cache.
Figure 29
Figure 30
Figure 31
2. Type a name for the New server Farm and click Next.
Figure 32
3. Add the ip addresses of the machines to be part of the web farm (machines behind
the load balancer).
4. Click Add to add a new machine and Finish once the list of servers is complete.
5. Click Yes to create the appropriate rewrite rules.
Figure 33
6. Once finished, inspect the servers in the IIS Manager by expanding the Server Farms
tree down to the Servers section.
Figure 34
7. Click on the name of the farm to display the options available for configuring the Farm
Figure 35
Configure the Server Farm options according to the following screenshots, clicking Apply on
the right-hand side of the screen after each change:
Configure Caching
Figure 36
Figure 37
The URL Test has the IP Address of the CLUSTER 10.165.185.163 previously
configured on NLB cluster.
Figure 38
Configure Proxy
Figure 39
Figure 40
Figure 41
To test the Transformer cluster use the URL http://10.165.185.163/quantel where the ip
address "10.165.185.163" is the ip address of the NLB Cluster.
"passThrough":{
"override":true,
"value":true
},
3. Save the file to another folder (e.g. Documents)
4. Copy the file back to the ...go folder.