Table of Contents - HARMAN Professional Solutions

Table of Contents - HARMAN Professional Solutions
Internet Publisher Pro 1.0
1
Documentation
STUDER DigiMedia
Internet Publisher Pro 1.0
Developer Kit for Internet Embedding of STUDER DigiMedia
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
2
1. Table of Contents
1. Table of Contents ...................................................................................2
2. Introduction ...........................................................................................4
2.1.
Versions........................................................................................................... 4
2.2.
Application Range............................................................................................ 5
2.3. Legal Issues ..................................................................................................... 6
2.3.1. License Agreement .......................................................................................... 6
2.3.2. Protection of third party rights ........................................................................ 7
3. Installation.............................................................................................8
3.1.
Technical Prerequisites ................................................................................... 8
3.2. Directory Structure ......................................................................................... 9
3.2.1. Basic Aspects.................................................................................................. 9
3.2.2. Example for single machine "Encoder/Webserver" ......................................... 11
3.2.3. Webserver Machine ....................................................................................... 11
3.3.
Short Instructions ......................................................................................... 12
3.4.
Setup of Encoder ........................................................................................... 12
3.5.
Setup of ODBC-Database ................................................................................ 12
3.6. Setup of Webserver ........................................................................................ 14
3.6.1. Apache Configuration.................................................................................... 14
4. Configuration .......................................................................................15
4.1. Configuration File mhs-encoder.ini .............................................................. 15
4.1.1. [Directories] .................................................................................................. 15
4.1.2. [Files]............................................................................................................ 15
4.1.3. [CGIMapping]................................................................................................ 15
4.1.4. [Extensions] .................................................................................................. 15
4.1.5. [Station]........................................................................................................ 16
4.1.6. [ODBC] ......................................................................................................... 16
4.1.7. [Other] .......................................................................................................... 17
4.1.8. [DiskSpaceLevels].......................................................................................... 18
4.1.9. [TypeX] ......................................................................................................... 18
4.1.10. [CGI]............................................................................................................. 19
4.1.11. [Logging] ....................................................................................................... 19
4.1.12. [TriggerN]...................................................................................................... 20
4.1.13. [ReplaceN]..................................................................................................... 20
4.1.14. Regular Expressions ..................................................................................... 21
4.2.
Configuration File DMEDIA.INI ...................................................................... 22
5. CGI-script request.pl............................................................................24
5.1.
Purpose.......................................................................................................... 24
5.2.
Application .................................................................................................... 24
5.3.
Templates...................................................................................................... 24
5.4. Parameters .................................................................................................... 24
5.4.1. General......................................................................................................... 24
5.4.2. FUNC=QUERY .............................................................................................. 25
5.4.3. FUNC=PLAY.................................................................................................. 26
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
5.4.4.
3
FUNC=TRIGGER ........................................................................................... 26
6. Other Items ..........................................................................................27
6.1. Clean-up Tool "CleanUp.exe"......................................................................... 27
6.1.1. Functional Description.................................................................................. 27
6.1.2. Call-up Syntax .............................................................................................. 27
6.1.3. Configuration................................................................................................ 27
7. Error Messages and their Origins ..........................................................28
8. Data Sheet............................................................................................29
9. Versions history ...................................................................................30
9.1.
mhs-encoder.exe............................................................................................ 30
9.2.
request.pl ...................................................................................................... 31
9.3.
cleanup.exe ................................................................................................... 33
10. Appendices.........................................................................................34
10.1.
Microsoft SQL 7 .......................................................................................... 34
11. Index .................................................................................................35
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
4
2. Introduction
2.1. Versions
The following documentation relates to the software package «STUDER DigiMedia Internet
Publisher Pro», which consists of various modules.
The subsequent documentation is based on the following releases:
•
STUDER DigiMedia
3.5.00
Attention: New definitions of export interfaces from V. 3.3.038 and up
•
CGI-script «request.pl»
1.0.031
•
Encoder mhs@encoder
1.0.080
•
Cleanup.exe
1.1.001
•
Apache
1.3.9
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
5
2.2. Application Range
The software solution «STUDER DigiMedia Internet Publisher Pro» enhances the Radio
Automation software STUDER DigiMedia which is in use at numerous renowned radio
stations all over Europe. It enables the supply of already sent out contributions and music
titles into the Internet. Immediately after on-air transmission, completely automated
without further manual assistance. Besides this the Net visitor is offered various search
facilities.
Possible applications
•
On-air retrieval history for backlog periods of months (What was going on at which
date?
•
Replay of already broadcasted contributions.
•
Archiving / Preparing of important, focussed program parts.
•
Live-Webradio with display of current title.
•
Application as Air-check solution.
•
Display of last titles/request via WAP-Handy.
By using the Microsoft Media Technology the possible audio quality can be maintained on
a high level despite of the limited Internet speed. .
Special Functions
For periodically updated transmissions (news, weather report, traffic info etc.) «STUDER
DigiMedia Internet Publisher Pro» offers a trigger function which allows the homepage user
to retrieve and to listen to the topical (latest) program item by a simple mouse click.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
6
2.3. Legal Issues
2.3.1.
License Agreement
«STUDER DigiMedia Internet Publisher Pro» is a software module for the Broadcast System
DigiMedia from STUDER. It is delivered as an SDK (Software Development Kit) and its
purpose is to establish an Internet embedding of STUDER DigiMedia.
The entire set includes a documentation. Customer training, technical support as well as
engineering and installation onsite can be achieved by mhs@internet against separate cost.
Warranty Disclaimer
«STUDER DigiMedia Internet Publisher Pro» is continuously and carefully tested for each
new release. Nevertheless some remaining bugs can not be excluded.
During the warranty period of one year after purchase mhs@internet will rectify the
accepted and reproducible bugs within the possible and reasonable, free of cost for the
customer
Support
The manufacturer mhs@internet offers the following customer services:
•
Phone Support
Phone: +41 (0)71 274 93 93
3 free calls or 60 mins. of support service, whatever is reached first . Further support
queries will be charged at usual hourly rates.
•
E-Mail-Support
inetpub@mhs.ch
•
On-site Support
for installation, problem elimination, training etc. will be charged at usually hourly
rates excluding travel expenses.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
2.3.2.
7
Protection of third party rights
"STUDER DigiMedia Internet Publisher Pro" allows archiving and public access to the entire
station output via the Internet. This can easily lead to legal implications. Therefore the
software has been designed to be highly flexible in its configuration possibilities to cope with
the various national regulations while providing maximum benefit to Internet users:
Example 1:
All program material, including music titles is fully archived and available for unrestricted
access.
Example 2:
All program material, including music titles is fully archived in its full length. While being
recalled, the in-house produced material is available in its entirety – pre-recorded
contributions are played back completely while music titles are only played back during 30
seconds (or some other definable interval).
Example 3:
All in-house produced sound material is fully archived. while pre-recorded music is
captured for only 30 seconds (or some other definable interval).
Example 4:
Differentiation between music titles which are allowed to be played back completely (e.g. for
promo purposes or with the consent of the owner of the rights) and others which must not
be recorded. This can be achieved via two different types.
Example 5:
Only in-house productions are archived and made available to web site visitors.
Basically the manufacturer of this software, mhs@internet GmbH, as well as its sales
organization refrain from any liability of non-legal use of the software. The
responsibility for pursuing the third party rights is with the radio station at which
this software is in use.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
8
3. Installation
3.1. Technical Prerequisites
encoder.radioxy.ch
inetpub.radioxy.ch
MHS-ENCODER.EXE
APACHE
Webserver
• Responds to Meta-Data from OnAir
• Creates ASF-Audio-archive files
REQUEST.PL
Request of CGI-Script
• Fills Meta-Data into SQL-database
Ethernet
MICROSOFT
MEDIA-SERVER
DMGATE.EXE
TCP/IP-Gateway module
receives MetaData
SQL-DB
storage of
audio
archive files
(ASF)
mySQL or
MS SQL7
leased
line
from DigiMedia OnAir
AUDIO-ARCHIVE
Audiosignal (analog)
Meta-Daten from DigiMedia OnAir (via
DigiMedia TCP/IP Gateway)
According to the above diagram we recommend the partition of the system into two separate
computers. The Encoder module is quite sensitive and can hardly fulfil its function if the
computer attains a 100% workload. High CPU usage has therefore to be avoided. This can
be achieved by dispersing the database server and the Webserver to an other machine.
Per active user listening to a contribution from the archive, a bandwidth of approx. 40
kbps is required (configurable). For this a sufficient wide-band link to the network has to
be ensured.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
9
We recommend the following minimum configurations:
PC-Workstation 1 ( encoder.radioxy.ch)
• Pentium 233 MHz
• 2 GB Harddisk
• 64 MB Memory
• 100 Mbit/s NIC
• Soundblaster PCI
• Windows NT Workstation
• Remote communication software Timbuktu Pro 2000
PC-Workstation 2 (inetpub.radioxy.ch)
• Pentium II 450 MHz
• 128 MB Memory (better 256 MB!)
• 20 GB Harddisk (per archiving day approx. 0.8 GB data + 5 GB for the system
environment)
• 100 Mbit/s NIC
• Windows NT Server (Workstation not suitable), Servicepack 6a
• Remote communication software Timbuktu Pro 2000
• SQL-Server (MS SQL 7 or mySQL), whereas SQL7 is recommended
3.2. Directory Structure
3.2.1.
Basic Aspects
A deployment of «STUDER DigiMedia Internet Publisher Pro» is possible in different steps,
depending from the situation and from the overall access quantity.
Variant 1: Inetpub- PC located at the radio station
STUDER DigiMedia System
CAB solution from V3.0.36. Prepares
the ON-air data in a defined folder.
Internet Publisher Encoder
Responds to Onair data, digitizes the
audio data (encoding) and writes the
database for later use.
Webserver
www.radio.ch
Tuner/Audio
Audio signal to be
f d i via
fed-in
i
soundcard.
Contains the «normal» homepage as
well as the query-form which sends the
user input data to:
inetpub.radio.ch
Livestream
Webserver inetpub.radio.ch
Receives queries, processes them
and outputs the result templatebased. Link to trigger and MediaServer
Media Server
Responsible for
the streaming of
archive audio files.
Encoding and preparation of the LiveStream (Webradio).
For this variant the radio station requires a sufficient bandwidth.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
10
Variant 2: Inetpub located at the Provider
For variant 1 the radio station requires a suitable leased line to the Internet. Instead of
upgrading its capacity there is also the possibility of a further variant.
Location: Radio station (Audio-Network)
STUDER DigiMedia System
Webserver
www.radio.ch
CAB solution from V3.0.36 up.
Prepares the On-Air data in a defined
folder.
Contains the «normal» homepage as
well as the query-form which sends the
user input data to:
inetpub.radio.ch
DigiMedia Onair-Gateway
TCP/IP-Gateway for On-Air data.
Livestream
Internet Publisher Encoder
Tuner/Audio
Webserver inetpub.radio.ch
Media Server
Encoding and preparation of the LiveStream (Webradio).
Location: Provider
Location: Radio station or Provider
The additional software module "DigiMedia Onair-Gateway" (not included in standard
delivery) creates a link between the audio network and the Internet Publisher PC.
By using the DigiMedia Onair-Gateway the following benefits will result:
•
High autonomy for larger distances between radio station and encoder. The only
prerequisite is the radio reception (either from cable or off-air) at the location of the
encoder.
•
No direct network link necessary. No need for two NICs nor for file sharing. Sufficient if
DigiMedia can communicate with the Internet-Publisher PC via TCP/IP.
One possible drawback must not be neglected however:
•
A small time delay has some influence on the encoding. Any started contribution will be
cut at its beginning by approx. 0..1 sec.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
11
3.2.2.
Example for single machine "Encoder/Webserver"
Drive C:
System harddisk
Drive D:
Audio data media incl. Internet Publisher software
D:\INETPUB\DB\
logdb.mdb
log.now
Storage location for archive database
(access via ODBC driver)
D:\INETPUB\CONFIG\
inetpub.asd
Contains the file 'inetpub.asd'. This file defines the bit rate
(sampling quality), Stereo/Mono etc. Can be adapted to
individual needs with the tool "Windows Media Encoder".
The included file:
Storage location for live title display data
•
optimized for 37 kbit/s (56 kbps-modem)
•
Codec: Windows Media Audio V2
•
Format: 22 kbps, 22 kHz, Stereo
D:\INETPUB\CLEANUP\
cleanup.exe
Contains the clean-up tool:
D:\INETPUB\
mhs-encoder.ini
mhs-encoder.exe
The main program «mhs-encoder» together with the
central configuration files «mhs-encoder.ini» make up the
core component of the entire package.
3.2.3.
Erases the most ancient files to create space for new
audio files (see 6.1 «Clean-up Tool "CleanUp.exe»)
Webserver Machine
D:\WWW\INETPUB\DOCS
index.html
Test form to check the installation function easily.
C:\WWW\INETPUB\LOG
Logfiles – can be used for analyzing by a statistics
program.
C:\WWW\INETPUB\CGI-BIN\INETPUB
request.pl
Perl-script – accesses the archive database and replies to
user requests.
C:\WWW\INETPUB\CGI-BIN\INETPUB\TPL
notfound.htm
query.htm
query_wap.wml
live.htm
HTML-sample files are used by "request.pl" . They contain
various internal template sections.
Important: Only to be processed with an ASCI-Editor.
Loading/storing with FrontPage can destroy the
templates.
C:\APACHE
D:\AUDIO
D:\AUDIO\ASF
© mhs internet GmbH St. Gallen
From Encoder V1.0.080 up a separate subdirectory per
day will be created.
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
12
3.3. Short Instructions
-
Check if Windows NT Server (not Workstation) has been installed.
-
Install Windows NT Server 4.0, Service Pack 5.
-
Install Internet Explorer 4 or newer.
-
Installation of Windows Media Server (wmserver.exe)
-
Activate additionally «HTTP-Streaming».
Enables the access to audio files – also visa Firewall by using HTTP-port 80.
-
Install Windows Media Tools (wmtools.exe)
-
Set up the Apache Webserver:
-
Configure it – provided that it is running on the same machine as the Media Server
(Port 21211)
-
Install the Perl-Interpreter Active State Perl (from V. 5.018).
-
Enhance it with the Win32::ODBC-Modul:
-
Execute C:\PERL\BIN\PPM.BAT
-
«Install Win32-ODBC»
-
«y»
-
«quit»
3.4. Setup of Encoder
3.5. Setup of ODBC-Database
Configure in Control Panel under «ODBC-Data Sources» a system DSN with the following
entries:
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
13
Remark:
If the Access-driver is not ready yet or not operating properly, please follow the steps below:
- Install Microsoft DAO 2.1 (ODBC-driver)
- Latest release to be found under http://www.microsoft.com/data
(Attention: Newer version – better performance!)
- Installation file MDAC_TYP.EXE
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
14
3.6. Setup of Webserver
3.6.1.
Apache Configuration
The Webserver has to be configured to respond to Port 21211. At the same time it has to
support the MIME-Type in use.
Following a sample configuration:
ServerType standalone
Port 21211
HostnameLookups off
User nobody
Group #-1
ServerAdmin info@radiodomain.ch
ServerRoot "d:/Apache"
ErrorLog logs/error_log
PidFile logs/httpd1.pid
ScoreBoardFile logs/apache1_status
ServerName inetpub.radiodomain.ch
Timeout 300
KeepAlive On
MaxKeepAliveRequests 100
KeepAliveTimeout 15
MaxRequestsPerChild 0
ThreadsPerChild 50
Listen 195.65.24.64:21211
<VirtualHost 195.65.24.64>
DocumentRoot /www/inetpub/docs
ErrorLog /www/inetpub/log/error
# ***** LOG *****
CustomLog /www/inetpub/log/access "%h %l %u %t \"%r\" %s %b \"%{Referer}i\"
\"%{User-Agent}i\""
# ***** CGI-BIN *****
ScriptAlias /cgi-bin/ /www/inetpub/cgi-bin/
# ***** SSI *****
AddType text/html .shtml
AddHandler server-parsed .shtml
</VirtualHost>
Additionally the following MIME-type has to be defined (file: mime.types):
application/x-mplayer2
asx asf
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
15
4. Configuration
4.1. Configuration File mhs-encoder.ini
A central component of the «Internet Publisher Pro»- package is the configuration file "mhsencoder.ini". It enables an individual adaptation for general behaviour and system
environment according to individual requirements.
mhs-encoder.ini will be used by different applications of this software package.
4.1.1.
[Directories]
audio=k:\audio\asf\
Audio directory. This is the location where the encoder
stores the audio files (*.ASF). From encoder v1.0.080 (AND
request.pl 1.0.031) an individual subdirectory per day will
be created.
audiourl=mms://media.radio.ch/asf/
URL of Microsoft Windows Media Server with path
Defines the URL with which the stored audio files cab be
retrieved via the Media Server. Default protocol is usually
«mms://»
4.1.2.
[Files]
config=y:\inetpub\config\inetpub.asd
Configuration file for the encoder
Can be created and modified with «Microsoft Windows
Media Author». Usually the included file «inetpub.asd»
does not need any modification.
digimedia=y:\dmedia\export\onair.txt
DigiMedia export file . This file is being created by the
«DigiMedia OnAir» application and contains the currently
played title with additional information.
loglive=y:\inetpub\db\log.now
Path and filename of export files for live display.
The CGI application enables displaying of the currently
playing title. This application refers to the export file
"mhsencoder.exe" ,created by mhsencoder.exe.
4.1.3.
[CGIMapping]
driveX=Y
Drive mapping for the CGI-script. If the CGI-script is
running on an other computer (Webserver) than the
Encoder application the drive letters may be different.
Example:
[Directory] logdb=y:\inetpub\db\
[CGIMapping] driveY=D
In this case the encoder searches the log library on the
drive Y:, the CGI-script however on drive D.
4.1.4.
[Extensions]
audio=.asf
© mhs internet GmbH St. Gallen
File suffix for audio files: The Microsoft Windows Media
System normally uses the suffix ASF for audio files. This
setting should normally not be altered.
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
4.1.5.
16
[Station]
licensekey=XXXX
Licensing Key. This key enables the encoder. It becomes
available at the time of the purchase of this product.
Please mind the correct use of uppercase/lowercase
characters while inputting.
name=Radio XY
Name of radio station. All audio files will be marked with
different data, among this with the station name.
url=http://www.radioXY.ch
URL of radio station. Define the URL of your Homepage.
The definition of the protocol («http://») is mandatory.
banner=http://www.radioXY.ch/banner.gif
Station banner. This GIF- or JPG-graphic (194x32
pixels) will be displayed during playback of audio files.
The graphic item has to be specified with its entire URL.
icon=http://www.radioXY.ch/favicon.ico
Icon of radio station. The icon graphic (32x32 pixels) is
displayed during playback as a system icon. The graphic
item has to be declared with its entire URL.
4.1.6.
[ODBC]
The use of the ODBC-interface for update and interpretation of the archive database enables
a high scalability. With smaller system environments an access to a simple Access database
(MDB) is sufficient; with high user-frequencies it is recommended to use a SQL-server
(mySQL, MS SQL etc.)
The following parameters have to .correspond with those defined in the System
Control/ODBC data sources.
Screenshots of an ODBC configuration
for a simple environment with Accessdatabase files (MDB).
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
17
The following parameters of the configuration file will be used from the components of
STUDER DigiMedia Internet Publisher Pro:
mode=mdb|mysql|mssql
Type of ODBC-access. Each database behaves differently.
Thus this parameter allows the definition of the access.
Allowed choice of databases:
mdb = local Access file via ODBC driver
mysql = database on mySQL-Server (www.mySQL.com)
mssql = Microsoft SQL Server 7 database
dsn=INETPUB_LOGDB
DSN-Name of ODBC system services
database=logdb
Name of database or table in use.
Needs usually not to be changed.
user=
If necessary: Username
pwd=
If necessary: Password
Please use for this application absolutely a separate
password. This is necessary because of the visible, nonencrypted password in the configuration file.
4.1.7.
[Other]
digimediaconfigmode=0
0=Direct interface file (w/o StationID)
1=via DMGate 3.5.05 (with StationID)
Completion in dmedia.ini (on Gateway-PC):
[DMGATE]
STATION=DEMO1
noaudioencoding=0
1=Write only title files into database
0 (default) = Audio files will be encoded
maxduration=10
Maximum recording time (in sec while idling. Defines
the period of continuation of the encoding if DigiMedia
shows the status «Idle». At the value 0 the recording will
immediately be terminated in the idle status (suitable for
live contributions, interviews etc). A suitable value is
around 900secs (quarter of an hour).
recordduration_default=20
Maximum recording time (in sec, if no type-specific
value has been defined. Defines the maximum recording
time of a clip. This default value only applies if no specific
value has been defined for the type definition (see 4.1.9). If
no max. recording time is to be defined – set a semicolon
(;) in front of this parameter.
Important: Please observe also the remarks at section
[TypeX] (see chapter 4.1.9)
types=KJ
Types to be outputted. Define, which audio files shall be
shown at the Online Retrieval. Further type-specific
parameters may be defined via [TypeX] (see 4.1.9).
timeoffset=20
Offset at time display. A news jingle being played only a
few seconds before the full hour will not appear at 12:00,
but at 11:59. In most cases the user will be offered an
hour selection according to hours (12-13 o‘clock). In such
a case he can not recall a transmission on the hour.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
18
Solution: define an offset, which will be added.
Example: the jingle will be played at 11:59:55. With a
timeoffset=20 it appears to the Web visitor as if played at
12:00:15. Because of the usually selected short time
display, the transmission time will appear as 12:00 sharp.
This parameter is only relevant at the moment of
recording.
4.1.8.
[DiskSpaceLevels]
red=10
DiskSpaceLevel RED. If the remaining harddisk storage
space falls below the listed percentage value, the cleanup
batch routine becomes active, erasing the most ancient
audio files or moving them to an archive location (this
procedure is repeated until the status GREEN has been
reached). During the status RED the encoding continues
and will only be stopped if less than 100 KB harddisk
space is left.
green=15
DiskSpaceLevel GREEN. When reaching the
DiskSpaceLevel RED the cleanup routine will be started
repeatedly until level GREEN has been reached.
cleanupbatch=<programm> <parameter>
Cleanup batch. This free definable program shall remove
old audio files or move them into an archive to increase
the empty storage space. The Cleanup.exe tool is
included in the standard package delivery (see 6.1). It also
erases the n oldest audio files. See also «DiskSpaceLevel
RED/GREEN» and option «deletecount» (below).
deletecount=50
Parameter for CleanUp.exe: Defines the number of
oldest files which shall be deleted at each start. For a
detailed description of the operating see chapter 6.1 Clean-up Tool "CleanUp.exe».
4.1.9.
[TypeX]
[TypeX]
Type-specific parameters. X characterizes the type for
which the following parameters will be defined.
Important: Only those types will be taken into account
which have been defined as "types" in the section [Other].
playduration=10
Initial play duration. Defines how many seconds of an
audio files belonging to this type will be played. This
allows the definition that only the first 30 sec. of music
titles are being played; news etc. however can be played at
will.
Unlimited: deactivate with a semicolon (;)
recordduration=30
Recording duration. Defines the possible recording time
of a played title. This allows the definition that only the
first 30 sec. of music titles are being recorded; news etc.
however can be recorded at will.
Unlimited: deactivate with a semicolon (;)
Difference to playduration: with both parameters you
may achieve the same result on the user side:
limiting of the clip length. With recordduration however,
the recording will be terminated after the defined time.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
19
You will find on the harddisk only an ASF-file with this
length. With playduration the title will be recorded and
saved in its full length; merely the playback duration is
shortened.
4.1.10. [CGI]
maxplayasf=10
No. of audio clips, to be played in sequence. The
recording basically takes place chronologically. To enable
a continuous listening to transmissions which are
interrupted, e.g. by music titles it is necessary to line up
several titles in a row. With this parameter you can define
the number of titles.
maxplayseconds=1200
Overall duration of all audio clips which will be played
back in sequence [in seconds].
compresshtml=1
HTML-compression.
maxrecordcount=100
Maximum no. of displayed entries after a selection
(Default). This value can be "overwritten" specifically with
the CGI-parameter CNT=n.
beautycase=1
Conversion of Artist and Title in regular
uppercase/lowercase lettering. Each first letter of a
word will be in uppercase:
«Jessica Simpson: I Wanna Love You Forever»
heardays=30
tpl_query=tpl/query.htm
Template for displaying of titles after a successful
request.
tpl_query_wap=tpl/query_wap.htm
As above but fore WAP-mode (see also 5.4.1)
tpl_notfound=tpl/notfound.htm
tpl_live=tpl/live.htm
Template for displaying the last played title. Will be
filled-in by the CGI-script and outputted in case of a callup of the CGI-script w/o parameters. (allows embedding
via Server Side Include (SSI)).
tpl_detail=tpl/detail.htm
Template for displaying the detail page
dir_images=../../docs/clips
Physical path in which the picture files are stored. (To
be used for verifying the existence of picture files).
url_images=/clips
Logical URL-path to picture files.
4.1.11. [Logging]
tpl_query_logging=tpl/query_logging.htm
Template for displaying the titles after a successful
request in Logging mode.
password=xxx
Password which has to be handed over with the
parameter PWD for a request in order to use the
Logging mode.
audiourl=mms://media.radio.ch/asf/
URL of Microsoft Windows Media Server with path.
Defines the URL with which the stored audio files can be
retrieved via the Media Server. The protocol usually is:
«mms://»
This parameter is optional (if internally other IP-
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
20
addresses are used as for external users.
4.1.12. [TriggerN]
[Trigger1]
type=J
artist=
title=Energy
exactcompare=0
file=trigger01
4.1.13. [ReplaceN]
With this powerful function you may control the text-oriented output. Filtering of dedicated
jingles or elements can be done in the same way. These rules are used by the CGIapplication. The database still contains the original entries.
Important: Each rule slows down the selection and the display at the Internet user end. By
a clever organization of your jingles and types it can be tried out to export only those
contribution which are also in the display.
Remark for searching: For the selection the original entries are being used. The Replacedefinitions are only influencing the output.
[Replace1]
Name of Replace rule. Starting with Replace, followed by
a number.
Important: no double values and no "holes" in the
enumeration are allowed.
[Replace1] to [Replace99] are possible.
type=J
type=JM
type=*
Limitation according to Type. Define if this rule shall
apply only for a certain type.
Validation for all types: type=*
Validation of the rule for some types: capture all types
w/o separator in sequence: type=JM
artist=searchtxt|replacetxt
Replace expression for the Artist. Define which
expression/search item should be exchanged against
which new text part. Search and replace text will be
separated by a pipe-symbol (ALT-0124, resp. ALTGR-7).
title=searchtxt|replacetxt
Replace expression for the Title. Define which
expression/search item should be exchanged against
which new text part. Search and replace text will be
separated by a pipe-symbol (ALT-0124, resp. ALTGR-7).
exactcompare=0
Accuracy of the comparison. As per default the
uppercase/lowercase writing is not taken into account.
With exactcompare=1 you may distinguish between UC and
LC writing.
ignore=0
Display entry if the rule applies? If ignore=0 has been
set, only the text parts according to the definition will be
replaced. If ignore=1 has been set, the entire data set will
not be shown. As an example this basically allows
filtering pout of all Outro-jingles.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
21
You can recognize that this filtering function may be used in different ways. One purpose is
a „make-up“ of entries by replacing text sequences by others. An other application is the
dedicated filtering of entries. A typical application are Outros which shall not be shown at a
retrieval output.
4.1.14. Regular Expressions
For defining a rule the syntax of «regular expressions applies. Although quite complex it is
extremely flexible.
Example 1: Replacement of text
[Replace1]
type=R
artist=Rawmaterial.*|Originalsound
title=
ignore=0
exactcompare=0
•
This rule influences all entries with the Type R, the
others remain untouched.
•
With each entry containing where the artist name
contains the wording "Rawmaterial", «Rawmaterial»
with all its subsequent characters will be replaced
by «Originalsound» .
•
Rule:
Rawmaterial.* means: following the word may come
any number of any character.
•
Attention – trap:
Rawmaterial* would have meant: following the word
«Rawmateria» (w/o «l») may come any number of «l».
•
Variants: Contained or start with?
•
Rawmaterial means that this word is contained
within the artist name but it need not necessarily start
with that word sequence.
For this you have several alternatives:
^Rawmaterial -> starts with «Rawmaterial»
Rawmaterial -> contains «Rawmaterial»
Rawmaterial$ -> ends with «Rawmaterial»
Example 2: selective filtering of an entry
[Replace2]
type=J
artist=
title=Outro|
ignore=1
exactcompare=0
© mhs internet GmbH St. Gallen
•
This rule influences all entries with
type J, all others remain unchanged.
•
Each entry containing the word «Outro» will not be
displayed (ignore=1)
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
22
4.2. Configuration File DMEDIA.INI
The following settings have to be added or changed in this configuration file:
[DMEDIA]
Name of paragraph. Locate this section in the file
\DMEDIA\CONFIG\DMEDIA.INI and add the following
lines (unless already existing):
ARTISTTITLEFILE=c:\dmedia\ export\onair.txt
DigiMedia Export File /Interface. This file will be
created by DigiMedia Studio and contains the
momentarily played title.
mhs-encoder monitors this file and registers all changes.
This is the only file of the audio network for which the
Internet Publisher Pro package requires a read access.
With the optionally available «DigiMedia Onair-Gateway»
this file may also be placed via TCP/IP to a remote
location.
ARTISTTITLETYPE=MKJT
Type definition of the Jingles to be exported.
Capturing of all types which shall be exported to the
Internet Publisher Pro.
Important: try to achieve a most accurate filtering with
this filter. Any subsequent filtering by the CGI application
/ReplaceN (see 4.1.13) reduces the performance.
MOREINFOS=3
Additional information. With this parameter the Year of
the music title will be included in the export data and can
thus be displayed also in the Internet.
Configuration via STUDER DigiMedia OnAir-Gateway:
DigiMedia exports the largest required number of types:
[DMEDIA]
ARTISTTITLETYPE=JM
They are all written into the file for the Internet Publisher Pro (from Gateway 1 or Gateway
2).
For SMS this can be restricted in the Gateway in order to have only the selected types
passing through.
[DMGATE]
EXTERNTYPE1=M
Several Gateways can be aligned in series:
[DMGATE]
CLIENTGATEPORT=862 ; Port
CLIENTGATEADDR= xxx.xxx.xxx.xxx ; address of 2nd Gateway, fed in series from the 1st
Gateway.
2nd Gateway requires an own DigiMedia environment, otherwise the already configured one
is performing the Gateway function.
Configuration example:
[DMGATE]
SOCKETPORT= 862
DATAFILE=all.txt
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
23
EXTERNLEN1=255
EXTERNMODE1=0
OUTFILE1=music.txt
EXTERNTYPE1=M
Al records which are sent from DigiMedia to the Gateway are in the data file „all.txt“ .
Configuration of the types in:
[DMEDIA]
ARTISTTITLEPORT = 862
ARTISTTITLEADDR = 192.11.11.11 ;Address of Gateway-PC
ARTISTTITLETYPE=MKJT
„music.txt“ contains only types EXTERNTYPE1 (example here: M).
-DigiMedia Gateway new with transfer to 2nd Gateway
[DMGATE]
CLIENTGATEPORT=862
CLIENTGATEADDR=192.11.11.12 ; address of 2nd Gateway PC
The 2nd Gateway PC should have its own DigiMedia environment and its own dmedia.ini.
Directories:
c:\dmedia
c:\dmedia\export
c:\dmedia\config
c:\dmedia\system
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
24
5. CGI-script request.pl
5.1. Purpose
5.2. Application
5.3. Templates
5.4. Parameters
5.4.1.
General
FUNC=QUERY
Processing of a query. If no further parameters are
handed over all entries (max. maxrecordcount, see 4.1.10) will
be displayed.
FUNC=PLAY
Playback of a submitted title. Stringent, additional
parameter is START=nnn (see 5.4.3).
FUNC=TRIGGER
Playback of a triggered contribution. Stringent,
additional parameter is START=nnn (see 5.4.4).
CNT=50
No. of data sets to be outputted. If this parameter is not
used the value maxrecordcount (see 4.1.10) will be used.
MODE=WAP
Defines the use of the WAP-mode. It allows to display
the outputs on WAP compatible handies (WML).
MODE=LOGGING
Use of STUDER DigiMedia Internet Publisher Pro as a
logging system. In logging-mode all filters are deactivated
and the other template "tpl_query_logging" will be used. In
this mode the correct password with the parameter PWD
has to be handed over.
PWD=xxx
Password, will be requested in Logging-mode.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
5.4.2.
25
FUNC=QUERY
DATE=YYYYMMDD
Selection according to Date
DATE=1999
All entries of year 1999 will be displayed.
DATE=199912
All entries of year 1999 and of month December will be
displayed.
DATE=19991220
All entries of the 20th December 1999 will be displayed.
TIME=HHMMSS
Selection according to Time
TIME=12
Display of hour 12.00 to 12.59 (12-13)
TIME=1203
Display of time range around 12.03 (–preroll /+postroll)
DATE_MONTH=mm
Selection according to Month
DATE_MONTH=05
Display of month MAY
DATE_DAY=dd
Selection according to Day
DATE_DAY=12
display of 12th day
ARTIST=xxx
Selection according to Artist
ARTIST=PAUL
ARTIST=*PAUL*
All entries which contain the search term search «Paul» in
the field "Artist" will be displayed.
ARTIST=PAUL*
All entries which start with the search term «Paul» will be
displayed.
ARTIST=*PAUL
All entries which end with the search term «Paul» will be
displayed.
TITLE=xxx
Selection according to Title (Syntax is analog to Artist)
TYPE=X
Selection according to Type
TYPE=J
Display of all entries of type J (usually Jingle)
YEAR=jj
Selection according to Year of issue
YEAR=88
Display of all entries of year '88 (year of title issue)
STATIONID=xxxY
Selection according to Station-Id
STATIONID=DEMO1
Display of all entries of Station DEMO1.
(See digimediaconfigmode)
CNT=nn
No. of outputted entries
* resp. the no. defined by maxrecordcount (see 4.1.10) or defined by CNT=nnn.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
5.4.3.
FUNC=PLAY
5.4.4.
FUNC=TRIGGER
© mhs internet GmbH St. Gallen
26
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
27
6. Other Items
6.1. Clean-up Tool "CleanUp.exe"
This tool is called up by the „mhs-encoder“ in case of space shortage on the audio drive (see
4.1.8 DiskLevels). The callup will be repeated until sufficient storage space is available
again.
6.1.1.
Functional Description
Erases the n oldest audio files in the folder „Audio“.
6.1.2.
Call-up Syntax
CLEANUP.EXE Path/Configfile
Example:
cleanup c:\inetpub\mhs-encoder.ini
6.1.3.
Configuration
The following parameters in the configuration file mhs-encoder.ini are ..................... for the
CleanUp:
•
[Directories]
– audio
•
[Extensions]
– audio
•
[DiskSpaceLevels]
– deletecount
A detailed description of these parameters can be found in chapter 4.1 «Configuration File
mhs-encoder.ini».
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
28
7. Error Messages and their Origins
Possible sources of errors
- Drive-Mapping (see ini-file) is differing from Encoder-PC and CGI-PC.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
29
8. Data Sheet
Use this sheet for your personal installation notes.
____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________-
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
30
9. Versions history
9.1. mhs-encoder.exe
09.10.2000 – Version 1.0.081
•
New: creation of one separate SubDir per day in the audio folder. To avoid any problems
it is mandatory to use:
request.pl 1.0.031 and cleanup.exe v1.1.001
•
«Division_ by_ zero error if audio directory locks up. Fixed!
•
Station-ID will now be attached to the audio filename, e.g.:
20000919095140_DEMO1.asf
08.09.2000 – Version 1.0.080
•
[OTHER]
• New parameter: digimediaconfigmode=0
Variant via DMGATE from v3.5.05 with additional StationID
•
Support of Microsoft SQL Server
• [ODBC] mode = mdb|mysql|mssql
•
[OTHER]
• New: encoderrestart
Automatic termination after n minutes -> Callup via batch go.bat with repeated start,
after delay for manual termination:
:start
echo New Start!
mhsencoder.exe
echo.
echo New start in 30 seconds. Abort with CTRL-C
delay.exe 30
if errorlevel 1 goto end
goto start
:end
•
Parameter correction: noaudioencoding instead of noadioencoding
16.08.2000 – Version 1.0.072
•
[OTHER]
• New parameter: noaudioencoding=0
•
No more empty fields (filled with '-' if empty).
•
Index-speedup by mySQL
04.04.2000 – Version 1.0.071
•
Bug removed re. ODBC-parameter (username/password exchanged).
02.03.2000 – Version 1.0.070
•
Transfer to ODBC-database technology
•
New in \WinNt\System32\ -> MSRDO20.DLL, MSRDO20.DEP, RDOCURS.DLL
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
•
31
mhs-encoder.ini:
•
[DIRECTORIES]
• Parameter 'logdb' deleted w/o replacement
•
[FILES]
• Parameter 'logdb' deleted w/o replacement
• Parameter 'loglive' new including path reference (previously only file name)
•
[ODBC]
• New parameters: dsn, database, user, pwd
•
[CGI]
• Parameter 'timeoffset' moved to section [OTHER].
•
[DiskSpaceLevels]
• Parameter 'yellow' and 'orange' deleted w/o replacement.
• New parameter 'green'
•
Bug fixed at callup of CleanUpBatch.
•
Interval of check of memory area/ "Disk free" display increased to 30 sec.
•
New layout and improvement of screen display.
9.2. request.pl
09.10.2000 – Version 1.0.031
•
Support for daily SubDirs
•
Speed enhancement at mySQL-mode.
08.09.2000 – Version 1.0.030
•
Live display new via database query (instead via loglive-file)
•
Significant speedup
•
Adaptation to database structure: filed Status -> StationID (if digimediaconfigmode=1)
•
FUNC=DETAIL -> detailpage for a record (also used for Live)
• tpl_detail
• dir_images
• url_images
•
Amendments in Beautycase-routine (let'S -> let's/FlasHlight -> Flashlight)
•
STATIONID=xxx
Selection according to station
16.08.2000 – Version 1.0.028
•
Speed optimizing
•
Only running from Encoder v1.0.072
21.07.2000 – Version 1.0.027
•
Adaptation with ContentType (better compatibility)
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
32
12.06.2000 – Version 1.0.026
•
Bugfix when searching of TYPE
•
mhs-encoder.ini
• New parameter [CGI] maxplayseconds=nnn
• New parameter [CGI] beautycase=1
•
Bugfix at Filterin (first character had been erased sometimes...)
23.03.2000 – Version 1.0.025
•
Adaptations for mySQL mode
•
mhs-encoder.ini
• New parameter [ODBC] mode=mdb|mysql
• New parameter [Logging] audiourl=xxx
23.03.2000 – Version 1.0.023
•
Application as OnAir-Check/Logging-System possible
•
mhs-encoder.ini:
• New paragraph [Logging]
• New parameter 'tpl_query_logging'
• New parameter 'password'
•
Standard templates with new layout.
16.03.2000 – Version 1.0.022
•
WAP-Support integrated
•
mhs-encoder.ini:
•
[CGI]
• New parameter 'tpl_query_wap'.
02.03.2000 – Version 1.0.020
•
Support for changes in the configuration file (see 9.1 mhs-encoder.exe)
•
Conversion to ODBC-database technology
Perl has to be enhanced with the Win32::ODBC module.
•
•
•
•
•
cd c:\perl\bin [ENTER]
ppm.bat [ENTER]
install Win32-ODBC [ENTER]
y [ENTER]
quit [ENTER]
•
Replace Definitions:
to validate a rule for all types: Type=*
to validate a rule for some types: Type=MJ
•
Selection
Simplified
paul*
*paul
paul
Parameters:
logical search parameters for ARTIST and TITLE:
all entries which start with «paul»
all entries which end with «paul»
all entries containing «paul» (identical with *paul*)
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
33
9.3. cleanup.exe
09.10.2000 - Version 1.1.001
•
Support of daily SubDirs
02.03.2000 - Version 1.0.001
•
New: Path and Name of configuration file "mhs-encoder.ini" has to be defined as a
parameter.
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
10.
Appendices
10.1.
Microsoft SQL 7
© mhs internet GmbH St. Gallen
34
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
11.
35
Index
A
M
Apache Configuration ..........................................14
ASF
file suffix ..........................................................15
Audio directory...................................................15
maxduration.......................................................... 17
Maximum recording time (in sec while idling.. 17
Maximum recording time (in sec, if no typespecific value has been defined ...................... 17
maxplayasf ........................................................... 19
maxplayseconds ................................................... 19
maxrecordcount .................................................... 19
mhs-encoder.ini .................................................... 15
Microsoft SQL 7
Table structure.................................................. 34
MIME
Apache definition ............................................. 14
B
beautycase ............................................................19
C
CleanUp.EXE .......................................................27
Configuration....................................................27
deletecount........................................................18
DiskSpaceLevels ..............................................18
Syntax...............................................................27
CNT ....................................................................... 24
Codec....................................................................11
compresshtml........................................................19
D
Digimedia export file ..........................................15
digimediaconfigmode ............................................17
Direct interface file.............................................17
DiskSpaceLevels
Configuration....................................................18
Drive mapping ....................................................15
DSN......................................................................17
N
name ..................................................................... 16
noaudioencoding .................................................. 17
O
ODBC
DSN.................................................................. 17
ODBC configuration ............................................ 16
P
Path and filename of export files....................... 15
playduration.......................................................... 18
Protection of third party rights ............................... 7
F
R
Filter ...................................................... see Replace
FUNC
PLAY ...............................................................24
QUERY ............................................................24
PLAY ...............................................................26
QUERY ............................................................25
TRIGGER.........................................................26
TRIGGER.........................................................24
recordduration ...................................................... 18
recordduration_default ......................................... 17
Regular Expressions ............................................. 21
Replace
Configuration ................................................... 20
Example
Filtering ........................................................ 21
Replacement of text ............................................ 21
H
S
heardays................................................................19
Homepage.............................................................16
SDK (Software Development Kit) ......................... 6
Setup of ODBC-Database .................................... 12
Setup of Webserver .............................................. 14
SQL
ODBC configuration ........................................ 16
Station banner .................................................... 16
STUDER DigiMedia OnAir-Gateway
configuration .................................................... 22
Support.................................................................. 6
I
Icon ...................................................................... 16
ignore....................................................................20
images/Links
Image path ........................................................19
inetpub.asd...................................................... 11, 15
Initial play duration ...........................................18
L
License Agreement.................................................6
licensekey .............................................................16
Licensing Key......................................................16
© mhs internet GmbH St. Gallen
T
Templates
Live .................................................................. 19
NotFound.......................................................... 19
Query................................................................ 19
Timeoffset ............................................................ 17
tpl_live.................................................................. 19
http://inetpub.mhs.ch
08.09.2000
Internet Publisher Pro 1.0
tpl_notfound ......................................................... 19
tpl_query...............................................................19
Trigger
Configuration....................................................20
Type of ODBC-access.........................................17
Types
configuration .................................................... 17
TypeX ...................................................................18
U
Upper/Lowercase typing
beautycase ........................................................19
36
V
Versions................................................................ 30
W
WAP
Mode ................................................................ 24
Warranty Disclaimer .............................................. 6
warranty period ...................................................... 6
Windows Media Encoder ..................................... 11
WML .................................................................... 24
mhs@internet GmbH
Zürcherstrasse 204
9014 St. Gallen
T 071 274 93 93
F 071 274 93 94
http://www.mhs.ch
© mhs internet GmbH St. Gallen
http://inetpub.mhs.ch
08.09.2000
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising