Cinegy

cineweb installation manual v 8.0

cinegy cineweb installation manual v 8.0

Copyright and Disclaimer

Information in this document is subject to change without notice and does not represent commitment
on the part of Cinegy GmbH. The software described in this document is furnished under a license
agreement. The software can be used or copied only in accordance with the terms and conditions of
the agreements. No part of this document may be reproduced or transmitted in any form or by any
means, electronic or mechanical, for any purpose without the express written permission of Cinegy
GmbH.

Trademarks
All terms mentioned in this document that are known to be trademarks or service marks have been
appropriately marked in bold. Cinegy GmbH cannot attest to the accuracy of this information. Use
of a term in this document should not be regarded as affecting the validity of any trademark or
service mark. Other products and company names mentioned herein may be the trademarks of their
respective owners.

Cinegy GmbH:
Müllerstr. 27
80469 Munich, Germany
Phone: +49 (89) 23885360
Fax: +49 (89) 23885369
Email: info@cinegy.com
WWW: www.cinegy.com

Page - II -
 Preface

Preface
Congratulations on your purchase of cinegy cineweb! You can use your cinegy
cineweb client to get remote access to your cinegy media archive.

 Your system might not contain certain features described in this manual. Our documents describe all features
regardless of which version you purchased.

About This Manual

This manual is designed to keep pace with the current advances in the cinegy workflow by
consolidating all the information you need to take advantage of the many options available to you.

Symbols and Conventions

The cinegy cineweb installation manual uses the following special conventions:
1 Numbered lists when the order of the items is important.
• Bulleted lists when the order of the items is unimportant.

 A note provides important information, recommendations, reminders and suggestions.

 The See Also notes refer you to other relevant sections, chapters or manuals.

 The caution paragraph indicates a potentially dangerous operation.

Page - III -
cinegy cineweb installation manual v 8.0

Page - IV -
 Contents

Contents
Copyright and Disclaimer.................................................................................................... II
Trademarks......................................................................................................................... II

Preface
About This Manual............................................................................................................. III
Symbols and Conventions.................................................................................................. III

Introduction
cinegy cineweb Installation
Architecture........................................................................................................................ 2
Client Tier................................................................................................................ 2
Web/Mid Tier.......................................................................................................... 2
Persistence Tier...................................................................................................... 3
Installation.......................................................................................................................... 3
Configuration...................................................................................................................... 6
Jboss Configuration................................................................................................ 6
Datasources............................................................................................................ 6
Configure cinegy cineweb Properties.................................................................... 7
Running JBoss on a port other than 8080............................................................... 8
Applying Patches to cinegy cineweb ............................................................................... 8
The cinegy cineweb License............................................................................................. 8

Page - V -
cinegy cineweb installation manual v 8.0

Page - VI -
 Introduction: cinegy cineweb Installation

Introduction
cinegy cineweb Installation

These are the installation notes for the cinegy cineweb installer to be used with
the cinegy eXpress 8.0.

• Architecture
• Installation
• Configuration
• Applying Patches to cinegy cineweb
• The cinegy cineweb License

 cinegy cineweb requires Java SDK version 6. Be sure to have this version installed. cinegy cineweb will
only work with additional stored procedures installed (see below).

Page - 1 -
cinegy cineweb installation manual v 8.0

Architecture

Client Tier
The Client Tier is a web browser. As the webfrontend is implemented in Silverlight, all web browsers
supporting the Silverlight plugin (Version 3) can be used.

 To be able to use the cinegy cineweb client, ensure you have the Silverlight installed on your computer.
Web/Mid Tier
The Mid Tier hosts the deployed applications and connects the Web Tier with the Persistence
Tier. From a logical perspective, the Mid Tier contains all business logic. The application is mainly
implemented as J2EE Beans and a web application. Some components are native Windows libraries
(DLL’s). The Web/Mid Tier consists of the following components:

Component Description
Application Server This is a container for the application and for all connecting interfaces. For
cinegy cineweb the J2EE Application Server JBoss is used.
Cineweb Business The Application’s business logic and access methods and API’s are a part of
Layer (CBL) the Mid Tier and contain J2EE components, native code, dynamic libraries,
and configuration files.
Cineweb Cineweb This API enables access of most CBL functionality through http calls. The
AJAX API response of such a request is an XML structure. The API can be used to
build arbitrary web applications on top of cinegy cineweb.
Cineweb Web The Web Application is based on Cocoon, a Java XML development
Application framework from Apache and uses CBL to connect to the cinegy media
archive database. It also contains the AJAX API.
Datasource The datasource configures access of the Application to the database through
defined access points within the Application Server.

Thumbnailer Generating thumbnails dynamically from media essence is handled by the

Thumbnailer. It is a combination of native Windows Libraries (DLL’s) and
Java libraries accessing it through Java Native Interfaces (JNI). It requires
DirectX and Windows Media Player operational on the server.
Streaming Media The Streaming Media Server can be utilised to deliver media essence to
Server the Web Client over a streaming protocol when the environment is a local
Intranet. Media content may also be delivered via http when using WAN /
extranet environments.
Internet Information The IIS can be used as an alternative configuration for the non-server
Services (IIS) Windows OS.

Page - 2 -
 Introduction: cinegy cineweb Installation

Persistence Tier
The Persistence Tier contains all persistent data either in the database (metadata) or in the essence
repository (media essence). Both the database and the essence repository are defined during the
installation of cinegy workflow. The following diagram gives an overview of the structure and the
components needed for the cinegy cineweb application installation:

Installation
For the cinegy cineweb installation, follow the instructions:
1 If Java SDK is not yet installed on the system, you are required to install Java SDK 1.6 before
the cinegy cineweb installation (Java Runtime Environment (JRE) is not sufficient). The
following steps describe the installation process:
1.1 Open and execute the Cinegy cineweb\java sdk\jdk-6u3-windows-i586-p.exe file from the
cinegy eXpress 8.0 distribution disk. When the Installer wizard requests a destination
path, it is recommended that there are no spaces in the path. E.g. D:\Java\jdk1.6.0_03.
1.2 Add a new System Environment Variable JAVA_HOME: This is performed by
right-clicking “My Computer” –> Properties –> Advanced –> Environment Variables –>
System variables –> New
- Enter the variable name as JAVA_HOME and the variable value as the directory where
Java was installed in step 1.1 E.g. D:\Java\jdk1.6.0_03.
- Edit the path or create a path variable (if it does not already exist) to add the path
“%JAVA_HOME%\bin“.
1.3 Open a Command shell (START>RUN>cmd) and enter the command:
java -version
End result should look like this:
java version “1.6.0_03”
Java(TM) SE Runtime Environment (build 1.6.0_03-b05)
Java HotSpot(TM) Client VM (build 1.6.0_03-b05, mixed mode, sharing)

Page - 3 -
cinegy cineweb installation manual v 8.0

2 Run the cinegy cineweb installer from your cinegy eXpress 8.0 distribution disk. During the
cinegy cineweb installation, you will be asked to define the location where cinegy cineweb
will be installed to:

It is recommended that there are no spaces in the path. E.g. D:\cineweb.

It will take a few moments to register cinegy cineweb on your computer.
3 This step is necessary only if you have Microsoft Windows Server 2008. In this case, you
can use the Streaming Server to deliver the content to the media player within the cinegy
cineweb application. If a Streaming Server is required, it is recommended that a dedicated
server is used. Otherwise, go to step 4.

 The Streaming Server is provided with the Windows Server versions only.

The following describes the installation and configuration required to install a Streaming Server:
3.1 Check whether your server has already been configured for the role Streaming Media
Server:
• Start –> Programs –> Administrative Tools –> Manage your Server
• If the server (role) has previously been configured, go to the next section of this list;
• If the server (role) has not been configured, choose “Add or remove a role” and press
“Next”;
• Choose the role “Streaming Media Server” from the list and press “Next”;
• Confirm the installation of Windows Media Service by pressing “Next”;
• Complete the installation by pressing “Finish”.
3.2 Configure Streaming Media Server:
• Press “Manage this streaming media server” in the “Manage Your Server” dialogue;
• Choose your server from the list with the Windows Media Services;
• Select the “Properties” tab;
• Select the “Authorization“ category;
• Set the status of all methods to disabled by right-clicking on the current status and
selecting “Disable”;
• Select the “Control protocol“ category;
• Enable WMS Server HTTP Control Protocol and WMS Server MMS Control Protocol;
• Select the “Authentication“ category;
• Enable all authentication methods.

Page - 4 -
 Introduction: cinegy cineweb Installation

3.3 Set up a publishing point:

• Find Publishing Points under the tree of your server;
• Right-click on “Publishing Points” and choose “Add Publishing Point (Wizard)...”; press
“Next”;
• State a name (e.g. cineweb) and press “Next”;
• Choose “Files” as content type and press “Next”;
• Choose “On-demand publishing point” as publishing point type and press “Next”;
• State as Directory Location the location where the *.wmv files of the essence repository
are stored and press “Next”;
• Leave checkboxes in the Content Playback dialog unchecked and press “Next”;
• Disable logging on the "Unicast Logging" dialog and press “Next”;
• Check the summary against the options you should have chosen in the “Publishing
Point Summary” dialog and press “Next”;
• On the last page of the wizard note the URL pointing to your publishing point;
• Uncheck the checkboxes after the wizard finishes and press “Finish”;
• Select the “Properties” tab;
• Select the category “Authorization”;
• Set the status of all methods to disabled by right-clicking on the current status and
selecting “Disable”;
• Select the category “Authentication”;
• Disable all authentication methods.
4 Installation of the Internet Information Services (IIS). The IIS can be used as an alternative
configuration for the non-server Windows OS. The IIS installation and configuration process is
described below:
4.1 Check whether your server has already been configured for the IIS:
• Start –> Control Panel –> Administrative Tools. If the IIS has previously been installed,
it would be displayed. If so, go to step 4.2;
• If the IIS has not been installed, go back to “Control Panel” and choose “Add or Remove
Programs”;
• Choose “Add/Remove Windows Components“.
• Choose the Internet Information Services (IIS) from the components list and press
“Next”;
• Insert the installation Windows disk and the installation process will start;
• Complete the installation by pressing “Finish”.
4.2 Configure IIS:
• Start –> Control Panel –> Administrative Tools –> Internet Information Services;
• Choose “Internet Information Services”–> Local computer –> “Web Sites” –> “Default
Web Site”. Right-click “Default Web Site”, then “New” –> “Virtual Directory...”. The
“Virtual Directory Creation Wizard” dialog box appears.
• Press “Next”; then enter the "cinemedia" virtual directory name in the “Alias” field.

 The "cinemedia" alias is used by default for the cinegy express cineweb configuration; refer to the Configure
cinegy cineweb Properties subsection below for information about the IIS configuration.

• Next browse for the path to the cinegy media archive database:
- If the local path was chosen, press “Next” on the further steps and “Finish” to
complete the directory creation.
- If the network path was chosen, fill in additionally the “User name” and “Password”
fields. Then press “Next” on the further steps and “Finish” to complete the directory
creation.

 To change the path to the cinegy media archive database of the virtual directory created before, use the
“Virtual Directory” tab of the “Properties” dialog box. Set the desired content resource (located on the local
computer or share located on another computer) and browse for the corresponding path to it.

Page - 5 -
cinegy cineweb installation manual v 8.0

• Open the “Properties” dialog box of “Default Web Site”. Choose the corresponding IP
address from the drop-down list to make cinegy media archive files accessible local
or via the network;
• If “Default Web Site” does not run automatically, right-click it and press “Start”;

 If an error message appears, change the TCP port in the “Properties” dialog box of “Default Web Site”.

5 After the installation of cinegy cineweb, the JBoss server is installed as a Windows
Service.
Alternatively JBoss can be run manually from a command line or from a start-up directory by
executing:
5.1 Go to  <cineweb_root>\jboss\bin.
5.2 Execute the run.bat file.

 You cannot run JBoss both manually and as a Service at the same time.

 To log in to the cinegy cineweb portal, you will need to use the login credentials for the user that is a member
of the "cinegy express" workgroup.

Configuration
If needed, it is possible to change the default cinegy cineweb configuration parameters.

Jboss Configuration
If you decide to run JBoss as a Windows service, you probably have to change the user account
under which the service is running.
1 Go to “Start/Administrative Tools/Services”.
2 In the Services Panel select “Cineweb” and open the “Properties” dialog box via double-click.
3 Go to the “Logon” tab and click on “This account”. Select a user that has sufficient rights
to access the network, e.g. to access the essence files (the standard login “Local System
account” does not have these rights).
4 Restart the Service.

 If the Configuration of cinegy cineweb (e.g. cineweb.properties or mssql-ds.xml) is changed, JBoss has to
be restarted.

Datasources
Open the “<cineweb_root>jboss\server\default\deploy\mssql-ds.xml” file with a text editor and
edit the following datasource entries according to your needs:
• <jndi-name>
• <connection-url>
• <user-name>
• <password>
• <max-pool-size>

 The user (<user-name>) must be a user, that is a DB user only (not a Windows Domain user).

Page - 6 -
 Introduction: cinegy cineweb Installation

Configure the database access rights for the selected DB user:

• Open Microsoft SQL Server Management Studio (MSSMS);
• Select your SQL Server;
• Go to “Security/Login“;
• Open the “Properties” dialog box for the required DB user:
- Select the “sysadmin“ role on the “Server roles” page;
- Select the corresponding cinegy cineweb database on the “User Mappings“ page and
tick off the “public“ and “mam_Admin“ roles.

Configure cinegy cineweb Properties

• Open the “<cineweb_root>\jboss\server\default\conf\cineweb\properties\Cineweb.properties”
file with a text editor and edit the following sections.

Domain
# list of domains available to user. Use .0, .1 etc
cineweb.login.domain.0=CINEGY-GROUP
cineweb.login.domain.1=CINEGY-GROUP08

Workgroups
• cineweb.workgroups – should list all workgroups (e.g. cineweb.
workgroups=mam138express)
• For all workgroups listed, there should be the following entries:
cineweb.workgroup.mam138express.text=cinegy express workgroup
cineweb.workgroup.mam138express.datasource=java:/mam138express

 The JNDI name of the datasources are defined in mssql-ds.xml

Notification
• cineweb.notification.enabled=true – should not be modified for this release. You can change
cineweb.notification.interval to whatever is appropriate.

Authorisation
# Flag to enable or disable the role based authentication
cineweb.role.authentication.enable=false

Configure Streaming Server

• Change the property cineweb.player.server.url to the name of your Streaming Server and
your publishing point (e.g. cineweb) and the protocol (mms or http) you would like to use
(e.g. mms://streamingserver.com/cineweb/)

Configure IIS
• Change the property cineweb.player.server.url to the name of your IIS and your
virtual directory (e.g. cineweb) and the protocol (mms or http) you would like to use
(e.g. http://<IP address>/<alias name>)

Page - 7 -
cinegy cineweb installation manual v 8.0

Running JBoss on a port other than 8080

If you want to change the port of the JBoss server:
1 Stop JBoss.
2 Go to <cineweb_root>\jboss\server\default\deploy\jboss-web.deployer\ and open the
server.xml file with a text editor.
3 Change the property port=”8080” in (at the beginning of server.xml):
<!-- A “Connector” represents an endpoint by which requests are received and
responses are returned. Documentation at:
Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)
Java AJP Connector: /docs/config/ajp.html
APR (HTTP/AJP) Connector: /docs/apr.html
Define a non-SSL HTTP/1.1 Connector on port 8080
-->
<Connector port=”8080” address=”${jboss.bind.address}”
maxThreads=”250” maxHttpHeaderSize=”8192”
emptySessionPath=”true” protocol=”HTTP/1.1”
enableLookups=”false” redirectPort=”8443” acceptCount=”100”
connectionTimeout=”20000” disableUploadTimeout=”true” />
to another port eg. port=”80”. Be sure not to change the port in the Comment
<!--
...
Define a non-SSL HTTP/1.1 Connector on port 8080
-->
but the property
port=”8080
4 Restart the Cineweb JBoss server (either execute the run.bat file or restart the Cineweb
service).

 If another service is running on the selected port (e.g. port 80 is used by most web servers), JBoss will start
up with errors and will not work properly.

 JBoss uses a lot of ports internally for different services (webservice, JMX, RMI etc), if these ports are
blocked or already used, JBoss will not work properly.

Applying Patches to cinegy cineweb

1 Open Cineweb Administrator.
2 Select the “Patches” tab (that’s the default tab).
3 Press the “Install Patch” button and select the patch (cinegy cineweb patches have the
extension *.cpatch).
4 If cinegy cineweb is running as a service, Cineweb Administrator will stop it. If cinegy
cineweb is running in console mode, please stop the server before applying the patch.
Cineweb Administrator will install the patch and then restart the service.

The cinegy cineweb License

This version of cinegy cineweb is included to the cinegy eXpress bundle and does not require the
license installation and activation.

Page - 8 -