Documentation STUDER DigiMedia Internet Publisher Pro 1… · Internet Publisher Pro 1.0 6 © mhs...

Internet Publisher Pro 1.0 1

© mhs internet GmbH St. Gallen http://inetpub.mhs.ch 08.09.2000

DocumentationSTUDER DigiMediaInternet Publisher Pro 1.0

Developer Kit for Internet Embedding of STUDER DigiMedia



1. Table of Contents

1. Table of Contents ...................................................................................2

2. Introduction ...........................................................................................42.1. Versions........................................................................................................... 42.2. Application Range............................................................................................ 52.3. Legal Issues ..................................................................................................... 6

2.3.1. License Agreement .......................................................................................... 62.3.2. Protection of third party rights ........................................................................ 7

3. Installation.............................................................................................83.1. Technical Prerequisites ................................................................................... 83.2. Directory Structure ......................................................................................... 9

3.2.1. Basic Aspects.................................................................................................. 93.2.2. Example for single machine "Encoder/Webserver" ......................................... 113.2.3. Webserver Machine ....................................................................................... 11

3.3. Short Instructions ......................................................................................... 123.4. Setup of Encoder ........................................................................................... 123.5. Setup of ODBC-Database................................................................................ 123.6. Setup of Webserver ........................................................................................ 14

3.6.1. Apache Configuration.................................................................................... 14

4. Configuration .......................................................................................154.1. Configuration File mhs-encoder.ini .............................................................. 15

4.1.1. [Directories] .................................................................................................. 154.1.2. [Files]............................................................................................................ 154.1.3. [CGIMapping]................................................................................................ 154.1.4. [Extensions] .................................................................................................. 154.1.5. [Station]........................................................................................................ 164.1.6. [ODBC] ......................................................................................................... 164.1.7. [Other] .......................................................................................................... 174.1.8. [DiskSpaceLevels].......................................................................................... 184.1.9. [TypeX] ......................................................................................................... 184.1.10. [CGI]............................................................................................................. 194.1.11. [Logging] ....................................................................................................... 194.1.12. [TriggerN]...................................................................................................... 204.1.13. [ReplaceN]..................................................................................................... 204.1.14. Regular Expressions ..................................................................................... 21

4.2. Configuration File DMEDIA.INI ...................................................................... 22

5. CGI-script request.pl............................................................................245.1. Purpose.......................................................................................................... 245.2. Application .................................................................................................... 245.3. Templates...................................................................................................... 245.4. Parameters .................................................................................................... 24

5.4.1. General......................................................................................................... 245.4.2. FUNC=QUERY .............................................................................................. 255.4.3. FUNC=PLAY.................................................................................................. 26



5.4.4. FUNC=TRIGGER ........................................................................................... 26

6. Other Items ..........................................................................................276.1. Clean-up Tool "CleanUp.exe"......................................................................... 27

6.1.1. Functional Description.................................................................................. 276.1.2. Call-up Syntax.............................................................................................. 276.1.3. Configuration................................................................................................ 27

7. Error Messages and their Origins ..........................................................28

8. Data Sheet............................................................................................29

9. Versions history ...................................................................................309.1. mhs-encoder.exe............................................................................................ 309.2. request.pl ...................................................................................................... 319.3. cleanup.exe ................................................................................................... 33

10. Appendices.........................................................................................3410.1. Microsoft SQL 7.......................................................................................... 34

11. Index .................................................................................................35



2. Introduction2.1. VersionsThe following documentation relates to the software package «STUDER DigiMedia InternetPublisher Pro», which consists of various modules.

The subsequent documentation is based on the following releases:

• STUDER DigiMedia 3.5.00Attention: 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



2.2. Application RangeThe software solution «STUDER DigiMedia Internet Publisher Pro» enhances the RadioAutomation software STUDER DigiMedia which is in use at numerous renowned radiostations all over Europe. It enables the supply of already sent out contributions and musictitles into the Internet. Immediately after on-air transmission, completely automatedwithout further manual assistance. Besides this the Net visitor is offered various searchfacilities.

Possible applications

• On-air retrieval history for backlog periods of months (What was going on at whichdate?

• 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 ona high level despite of the limited Internet speed. .

Special FunctionsFor periodically updated transmissions (news, weather report, traffic info etc.) «STUDERDigiMedia Internet Publisher Pro» offers a trigger function which allows the homepage userto retrieve and to listen to the topical (latest) program item by a simple mouse click.



2.3. Legal Issues2.3.1. License Agreement«STUDER DigiMedia Internet Publisher Pro» is a software module for the Broadcast SystemDigiMedia from STUDER. It is delivered as an SDK (Software Development Kit) and itspurpose is to establish an Internet embedding of STUDER DigiMedia.

The entire set includes a documentation. Customer training, technical support as well asengineering 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 eachnew release. Nevertheless some remaining bugs can not be excluded.

During the warranty period of one year after purchase mhs@internet will rectify theaccepted and reproducible bugs within the possible and reasonable, free of cost for thecustomer

SupportThe manufacturer mhs@internet offers the following customer services:

• Phone SupportPhone: +41 (0)71 274 93 933 free calls or 60 mins. of support service, whatever is reached first . Further supportqueries will be charged at usual hourly rates.

• [email protected]

• On-site Supportfor installation, problem elimination, training etc. will be charged at usually hourlyrates excluding travel expenses.



2.3.2. Protection of third party rights"STUDER DigiMedia Internet Publisher Pro" allows archiving and public access to the entirestation output via the Internet. This can easily lead to legal implications. Therefore thesoftware has been designed to be highly flexible in its configuration possibilities to cope withthe various national regulations while providing maximum benefit to Internet users:

Example 1:All program material, including music titles is fully archived and available for unrestrictedaccess.

Example 2:All program material, including music titles is fully archived in its full length. While beingrecalled, the in-house produced material is available in its entirety – pre-recordedcontributions are played back completely while music titles are only played back during 30seconds (or some other definable interval).

Example 3:All in-house produced sound material is fully archived. while pre-recorded music iscaptured 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. forpromo purposes or with the consent of the owner of the rights) and others which must notbe 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 salesorganization refrain from any liability of non-legal use of the software. Theresponsibility for pursuing the third party rights is with the radio station at whichthis software is in use.



3. Installation3.1. Technical Prerequisites

inetpub.radioxy.chencoder.radioxy.ch

DMGATE.EXE

receives MetaData

MHS-ENCODER.EXE

SQL-DB

mySQL orMS SQL7

APACHEWebserver

MICROSOFTMEDIA-SERVER

REQUEST.PLRequest of CGI-Script

AUDIO-ARCHIVEstorage of

audioarchive files

(ASF)

leas

edlin

e

Meta-Daten from DigiMedia OnAir (viaDigiMedia TCP/IP Gateway)

Audiosignal (analog)

Ethernet

TCP/IP-Gateway module

from DigiMedia OnAir

• Responds to Meta-Data from OnAir• Creates ASF-Audio-archive files• Fills Meta-Data into SQL-database

According to the above diagram we recommend the partition of the system into two separatecomputers. The Encoder module is quite sensitive and can hardly fulfil its function if thecomputer attains a 100% workload. High CPU usage has therefore to be avoided. This canbe 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. 40kbps is required (configurable). For this a sufficient wide-band link to the network has tobe ensured.



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 Structure3.2.1. Basic AspectsA 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

For this variant the radio station requires a sufficient bandwidth.

Webserverwww.radio.ch

Contains the «normal» homepage aswell as the query-form which sends theuser input data to:inetpub.radio.ch

STUDER DigiMedia SystemCAB solution from V3.0.36. Preparesthe ON-air data in a defined folder.

Tuner/AudioAudio signal to bef d i ifed-in viasoundcard.

Media ServerResponsible forthe streaming ofarchive audio files.

Internet Publisher EncoderResponds to Onair data, digitizes theaudio data (encoding) and writes thedatabase for later use.

Webserver inetpub.radio.chReceives queries, processes themand outputs the result template-bbased. Link to trigger and Media-Server

Livestream

Encoding and preparation of the Live-Stream (Webradio).



Variant 2: Inetpub located at the ProviderFor variant 1 the radio station requires a suitable leased line to the Internet. Instead ofupgrading its capacity there is also the possibility of a further variant.

The additional software module "DigiMedia Onair-Gateway" (not included in standarddelivery) 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 onlyprerequisite is the radio reception (either from cable or off-air) at the location of theencoder.

• No direct network link necessary. No need for two NICs nor for file sharing. Sufficient ifDigiMedia 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 becut at its beginning by approx. 0..1 sec.

Location: Provider

Webserverwww.radio.ch

Contains the «normal» homepage aswell as the query-form which sends theuser input data to:inetpub.radio.ch

STUDER DigiMedia SystemCAB solution from V3.0.36 up.Prepares the On-Air data in a definedfolder.

Media Server

DigiMedia Onair-GatewayTCP/IP-Gateway for On-Air data.

Webserver inetpub.radio.ch

Livestream

Encoding and preparation of the Live-Stream (Webradio).

Location: Radio station or Provider

Location: Radio station (Audio-Network)

Tuner/AudioInternet Publisher Encoder



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)

Storage location for live title display data

D:\INETPUB\CONFIG\ inetpub.asd

Contains the file 'inetpub.asd'. This file defines the bit rate(sampling quality), Stereo/Mono etc. Can be adapted toindividual needs with the tool "Windows Media Encoder".The included file:

• 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:

Erases the most ancient files to create space for newaudio files (see 6.1 «Clean-up Tool "CleanUp.exe»)

D:\INETPUB\ mhs-encoder.ini mhs-encoder.exe

The main program «mhs-encoder» together with thecentral configuration files «mhs-encoder.ini» make up thecore component of the entire package.

3.2.3. Webserver MachineD:\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 statisticsprogram.

C:\WWW\INETPUB\CGI-BIN\INETPUB request.pl

Perl-script – accesses the archive database and replies touser 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 containvarious internal template sections.

Important: Only to be processed with an ASCI-Editor.Loading/storing with FrontPage can destroy thetemplates.

C:\APACHE

D:\AUDIO

D:\AUDIO\ASF From Encoder V1.0.080 up a separate subdirectory perday will be created.



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 Encoder3.5. Setup of ODBC-Database

Configure in Control Panel under «ODBC-Data Sources» a system DSN with the followingentries:



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



3.6. Setup of Webserver3.6.1. Apache ConfigurationThe Webserver has to be configured to respond to Port 21211. At the same time it has tosupport the MIME-Type in use.

Following a sample configuration:

ServerType standalonePort 21211HostnameLookups offUser nobodyGroup #-1ServerAdmin [email protected] "d:/Apache"ErrorLog logs/error_logPidFile logs/httpd1.pidScoreBoardFile logs/apache1_statusServerName inetpub.radiodomain.chTimeout 300KeepAlive OnMaxKeepAliveRequests 100KeepAliveTimeout 15MaxRequestsPerChild 0ThreadsPerChild 50Listen 195.65.24.64:21211

<VirtualHost 195.65.24.64>DocumentRoot /www/inetpub/docsErrorLog /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 .shtmlAddHandler server-parsed .shtml</VirtualHost>

Additionally the following MIME-type has to be defined (file: mime.types):application/x-mplayer2 asx asf



4. Configuration4.1. Configuration File mhs-encoder.iniA central component of the «Internet Publisher Pro»- package is the configuration file "mhs-encoder.ini". It enables an individual adaptation for general behaviour and systemenvironment 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 (ANDrequest.pl 1.0.031) an individual subdirectory per day willbe created.

audiourl=mms://media.radio.ch/asf/ URL of Microsoft Windows Media Server with pathDefines the URL with which the stored audio files cab beretrieved 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 WindowsMedia 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 currentlyplayed 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 currentlyplaying 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 theEncoder 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 thedrive Y:, the CGI-script however on drive D.

4.1.4. [Extensions]audio=.asf File suffix for audio files: The Microsoft Windows Media

System normally uses the suffix ASF for audio files. Thissetting should normally not be altered.



4.1.5. [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/lowercasecharacters while inputting.

name=Radio XY Name of radio station. All audio files will be marked withdifferent 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 (194x32pixels) 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) isdisplayed during playback as a system icon. The graphicitem 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 enablesa 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 SystemControl/ODBC data sources.

Screenshots of an ODBC configurationfor a simple environment with Access-database files (MDB).



The following parameters of the configuration file will be used from the components ofSTUDER 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 drivermysql = database on mySQL-Server (www.mySQL.com)mssql = Microsoft SQL Server 7 database

dsn=INETPUB_LOGDB DSN-Name of ODBC system servicesdatabase=logdb Name of database or table in use.

Needs usually not to be changed.

user= If necessary: Usernamepwd= If necessary: Password

Please use for this application absolutely a separatepassword. This is necessary because of the visible, non-encrypted 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 database0 (default) = Audio files will be encoded

maxduration=10 Maximum recording time (in sec while idling. Definesthe period of continuation of the encoding if DigiMediashows the status «Idle». At the value 0 the recording willimmediately be terminated in the idle status (suitable forlive contributions, interviews etc). A suitable value isaround 900secs (quarter of an hour).

recordduration_default=20 Maximum recording time (in sec, if no type-specificvalue has been defined. Defines the maximum recordingtime of a clip. This default value only applies if no specificvalue has been defined for the type definition (see 4.1.9). Ifno 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 beshown at the Online Retrieval. Further type-specificparameters may be defined via [TypeX] (see 4.1.9).

timeoffset=20 Offset at time display. A news jingle being played only afew seconds before the full hour will not appear at 12:00,but at 11:59. In most cases the user will be offered anhour selection according to hours (12-13 o‘clock). In sucha case he can not recall a transmission on the hour.



Solution: define an offset, which will be added.

Example: the jingle will be played at 11:59:55. With atimeoffset=20 it appears to the Web visitor as if played at12:00:15. Because of the usually selected short timedisplay, the transmission time will appear as 12:00 sharp.

This parameter is only relevant at the moment ofrecording.

4.1.8. [DiskSpaceLevels]red=10 DiskSpaceLevel RED. If the remaining harddisk storage

space falls below the listed percentage value, the cleanupbatch routine becomes active, erasing the most ancientaudio files or moving them to an archive location (thisprocedure is repeated until the status GREEN has beenreached). During the status RED the encoding continuesand will only be stopped if less than 100 KB harddiskspace is left.

green=15 DiskSpaceLevel GREEN. When reaching theDiskSpaceLevel RED the cleanup routine will be startedrepeatedly until level GREEN has been reached.

cleanupbatch=<programm> <parameter> Cleanup batch. This free definable program shall removeold audio files or move them into an archive to increasethe empty storage space. The Cleanup.exe tool isincluded in the standard package delivery (see 6.1). It alsoerases the n oldest audio files. See also «DiskSpaceLevelRED/GREEN» and option «deletecount» (below).

deletecount=50 Parameter for CleanUp.exe: Defines the number ofoldest files which shall be deleted at each start. For adetailed 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 accountwhich have been defined as "types" in the section [Other].

playduration=10 Initial play duration. Defines how many seconds of anaudio files belonging to this type will be played. Thisallows the definition that only the first 30 sec. of musictitles are being played; news etc. however can be played atwill.

Unlimited: deactivate with a semicolon (;)

recordduration=30 Recording duration. Defines the possible recording timeof a played title. This allows the definition that only thefirst 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 youmay 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.



You will find on the harddisk only an ASF-file with thislength. With playduration the title will be recorded andsaved in its full length; merely the playback duration isshortened.

4.1.10. [CGI]

maxplayasf=10 No. of audio clips, to be played in sequence. Therecording basically takes place chronologically. To enablea continuous listening to transmissions which areinterrupted, e.g. by music titles it is necessary to line upseveral titles in a row. With this parameter you can definethe number of titles.

maxplayseconds=1200 Overall duration of all audio clips which will be playedback 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 withthe CGI-parameter CNT=n.

beautycase=1 Conversion of Artist and Title in regularuppercase/lowercase lettering. Each first letter of aword 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 successfulrequest.

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 befilled-in by the CGI-script and outputted in case of a call-up of the CGI-script w/o parameters. (allows embeddingvia Server Side Include (SSI)).

tpl_detail=tpl/detail.htm Template for displaying the detail pagedir_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 theLogging 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 beretrieved via the Media Server. The protocol usually is:«mms://»

This parameter is optional (if internally other IP-



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 dedicatedjingles or elements can be done in the same way. These rules are used by the CGI-application. The database still contains the original entries.

Important: Each rule slows down the selection and the display at the Internet user end. Bya clever organization of your jingles and types it can be tried out to export only thosecontribution which are also in the display.

Remark for searching: For the selection the original entries are being used. The Replace-definitions are only influencing the output.

[Replace1] Name of Replace rule. Starting with Replace, followed bya number.

Important: no double values and no "holes" in theenumeration are allowed.

[Replace1] to [Replace99] are possible.

type=Jtype=JMtype=*

Limitation according to Type. Define if this rule shallapply only for a certain type.

Validation for all types: type=*

Validation of the rule for some types: capture all typesw/o separator in sequence: type=JM

artist=searchtxt|replacetxt Replace expression for the Artist. Define whichexpression/search item should be exchanged againstwhich new text part. Search and replace text will beseparated by a pipe-symbol (ALT-0124, resp. ALTGR-7).

title=searchtxt|replacetxt Replace expression for the Title. Define whichexpression/search item should be exchanged againstwhich new text part. Search and replace text will beseparated by a pipe-symbol (ALT-0124, resp. ALTGR-7).

exactcompare=0 Accuracy of the comparison. As per default theuppercase/lowercase writing is not taken into account.With exactcompare=1 you may distinguish between UC andLC writing.

ignore=0 Display entry if the rule applies? If ignore=0 has beenset, only the text parts according to the definition will bereplaced. If ignore=1 has been set, the entire data set willnot be shown. As an example this basically allowsfiltering pout of all Outro-jingles.



You can recognize that this filtering function may be used in different ways. One purpose isa „make-up“ of entries by replacing text sequences by others. An other application is thededicated filtering of entries. A typical application are Outros which shall not be shown at aretrieval output.

4.1.14. Regular ExpressionsFor defining a rule the syntax of «regular expressions applies. Although quite complex it isextremely flexible.

Example 1: Replacement of text[Replace1]type=Rartist=Rawmaterial.*|Originalsoundtitle=ignore=0exactcompare=0

• This rule influences all entries with the Type R, theothers remain untouched.

• With each entry containing where the artist namecontains the wording "Rawmaterial", «Rawmaterial»with all its subsequent characters will be replacedby «Originalsound» .

• Rule:Rawmaterial.* means: following the word may comeany 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 containedwithin the artist name but it need not necessarily startwith 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=Jartist=title=Outro|ignore=1exactcompare=0

• This rule influences all entries with

type J, all others remain unchanged.

• Each entry containing the word «Outro» will not bedisplayed (ignore=1)



4.2. Configuration File DMEDIA.INIThe 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 followinglines (unless already existing):

ARTISTTITLEFILE=c:\dmedia\ export\onair.txt DigiMedia Export File /Interface. This file will becreated by DigiMedia Studio and contains themomentarily played title.

mhs-encoder monitors this file and registers all changes.

This is the only file of the audio network for which theInternet 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 remotelocation.

ARTISTTITLETYPE=MKJT Type definition of the Jingles to be exported.Capturing of all types which shall be exported to theInternet Publisher Pro.

Important: try to achieve a most accurate filtering withthis 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 ofthe music title will be included in the export data and canthus 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 Gateway2).

For SMS this can be restricted in the Gateway in order to have only the selected typespassing through.[DMGATE]EXTERNTYPE1=M

Several Gateways can be aligned in series:[DMGATE]CLIENTGATEPORT=862 ; PortCLIENTGATEADDR= 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 oneis performing the Gateway function.

Configuration example:[DMGATE]SOCKETPORT= 862DATAFILE=all.txt



EXTERNLEN1=255EXTERNMODE1=0OUTFILE1=music.txtEXTERNTYPE1=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 = 862ARTISTTITLEADDR = 192.11.11.11 ;Address of Gateway-PCARTISTTITLETYPE=MKJT

„music.txt“ contains only types EXTERNTYPE1 (example here: M).-DigiMedia Gateway new with transfer to 2nd Gateway

[DMGATE]CLIENTGATEPORT=862CLIENTGATEADDR=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:\dmediac:\dmedia\exportc:\dmedia\configc:\dmedia\system



5. CGI-script request.pl5.1. Purpose5.2. Application5.3. Templates5.4. Parameters5.4.1. GeneralFUNC=QUERY Processing of a query. If no further parameters are

handed over all entries (max. maxrecordcount, see 4.1.10) willbe displayed.

FUNC=PLAY Playback of a submitted title. Stringent, additionalparameter 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 notused the value maxrecordcount (see 4.1.10) will be used.

MODE=WAP Defines the use of the WAP-mode. It allows to displaythe outputs on WAP compatible handies (WML).

MODE=LOGGING Use of STUDER DigiMedia Internet Publisher Pro as alogging system. In logging-mode all filters are deactivatedand the other template "tpl_query_logging" will be used. Inthis mode the correct password with the parameter PWDhas to be handed over.

PWD=xxx Password, will be requested in Logging-mode.



5.4.2. FUNC=QUERYDATE=YYYYMMDD Selection according to DateDATE=1999 All entries of year 1999 will be displayed.

DATE=199912 All entries of year 1999 and of month December will bedisplayed.

DATE=19991220 All entries of the 20th December 1999 will be displayed.

TIME=HHMMSS Selection according to TimeTIME=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 MonthDATE_MONTH=05 Display of month MAY

DATE_DAY=dd Selection according to DayDATE_DAY=12 display of 12th day

ARTIST=xxx Selection according to ArtistARTIST=PAULARTIST=*PAUL*

All entries which contain the search term search «Paul» inthe field "Artist" will be displayed.

ARTIST=PAUL* All entries which start with the search term «Paul» will bedisplayed.

ARTIST=*PAUL All entries which end with the search term «Paul» will bedisplayed.

TITLE=xxx Selection according to Title (Syntax is analog to Artist)

TYPE=X Selection according to TypeTYPE=J Display of all entries of type J (usually Jingle)

YEAR=jj Selection according to Year of issueYEAR=88 Display of all entries of year '88 (year of title issue)

STATIONID=xxxY Selection according to Station-IdSTATIONID=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.



5.4.3. FUNC=PLAY

5.4.4. FUNC=TRIGGER



6. Other Items6.1. Clean-up Tool "CleanUp.exe"This tool is called up by the „mhs-encoder“ in case of space shortage on the audio drive (see4.1.8 DiskLevels). The callup will be repeated until sufficient storage space is availableagain.

6.1.1. Functional DescriptionErases the n oldest audio files in the folder „Audio“.

6.1.2. Call-up SyntaxCLEANUP.EXE Path/Configfile

Example:cleanup c:\inetpub\mhs-encoder.ini

6.1.3. ConfigurationThe following parameters in the configuration file mhs-encoder.ini are ..................... for theCleanUp:

• [Directories]– audio

• [Extensions]– audio

• [DiskSpaceLevels]– deletecount

A detailed description of these parameters can be found in chapter 4.1 «Configuration Filemhs-encoder.ini».



7. Error Messages and their Origins

Possible sources of errors- Drive-Mapping (see ini-file) is differing from Encoder-PC and CGI-PC.



8. Data SheetUse this sheet for your personal installation notes.

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-

______________________________________________________________________________________-



9. Versions history9.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 problemsit 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: encoderrestartAutomatic termination after n minutes -> Callup via batch go.bat with repeated start,after delay for manual termination:

:startecho New Start!mhsencoder.exeecho.echo New start in 30 seconds. Abort with CTRL-Cdelay.exe 30if errorlevel 1 goto endgoto 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-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=xxxSelection 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)



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 technologyPerl 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 Parameters:Simplified logical search parameters for ARTIST and TITLE:paul* all entries which start with «paul»*paul all entries which end with «paul»paul all entries containing «paul» (identical with *paul*)



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 aparameter.



10. Appendices10.1. Microsoft SQL 7



11. Index

A

Apache Configuration ..........................................14ASF

file suffix ..........................................................15Audio directory...................................................15

B

beautycase ............................................................19

C

CleanUp.EXE.......................................................27Configuration....................................................27deletecount........................................................18DiskSpaceLevels ..............................................18Syntax...............................................................27

CNT .......................................................................24Codec....................................................................11compresshtml........................................................19

D

Digimedia export file ..........................................15digimediaconfigmode ............................................17Direct interface file .............................................17DiskSpaceLevels

Configuration....................................................18Drive mapping ....................................................15DSN......................................................................17

F

Filter ...................................................... see ReplaceFUNC

PLAY ...............................................................24QUERY ............................................................24PLAY ...............................................................26QUERY ............................................................25TRIGGER.........................................................26TRIGGER.........................................................24

H

heardays................................................................19Homepage.............................................................16

I

Icon ......................................................................16ignore....................................................................20images/Links

Image path ........................................................19inetpub.asd......................................................11, 15Initial play duration ...........................................18

L

License Agreement.................................................6licensekey .............................................................16Licensing Key......................................................16

M

maxduration..........................................................17Maximum recording time (in sec while idling.. 17Maximum recording time (in sec, if no type-

specific value has been defined ...................... 17maxplayasf ........................................................... 19maxplayseconds ................................................... 19maxrecordcount ....................................................19mhs-encoder.ini .................................................... 15Microsoft SQL 7

Table structure.................................................. 34MIME

Apache definition ............................................. 14

N

name ..................................................................... 16noaudioencoding .................................................. 17

O

ODBCDSN.................................................................. 17

ODBC configuration ............................................16

P

Path and filename of export files....................... 15playduration..........................................................18Protection of third party rights ............................... 7

R

recordduration ......................................................18recordduration_default .........................................17Regular Expressions ............................................. 21Replace

Configuration ................................................... 20Example

Filtering ........................................................ 21Replacement of text ............................................ 21

S

SDK (Software Development Kit) ......................... 6Setup of ODBC-Database .................................... 12Setup of Webserver .............................................. 14SQL

ODBC configuration ........................................ 16Station banner .................................................... 16STUDER DigiMedia OnAir-Gateway

configuration .................................................... 22Support ..................................................................6

T

TemplatesLive .................................................................. 19NotFound.......................................................... 19Query................................................................ 19

Timeoffset ............................................................17tpl_live.................................................................. 19



tpl_notfound .........................................................19tpl_query...............................................................19Trigger

Configuration....................................................20Type of ODBC-access.........................................17Types

configuration ....................................................17TypeX ...................................................................18

U

Upper/Lowercase typingbeautycase ........................................................19

V

Versions................................................................30

W

WAPMode ................................................................24

Warranty Disclaimer .............................................. 6warranty period ...................................................... 6Windows Media Encoder .....................................11WML.................................................................... 24

mhs@internet GmbHZürcherstrasse 2049014 St. Gallen

T 071 274 93 93F 071 274 93 94

http://www.mhs.ch

Documentation STUDER DigiMedia Internet Publisher Pro 1… · Internet Publisher Pro 1.0 6 © mhs...

Documents

Transcript of Documentation STUDER DigiMedia Internet Publisher Pro 1… · Internet Publisher Pro 1.0 6 © mhs...