How to install DOMS system for kulturarvs-DEVEL or on your own machine

The quick and dirty guide to installing the different DOMS-system-components on DEVEL or for monkey-testing on your own machine.

Please let each step finish before continuing to the next.

Clean up an existing monkey-test install (if it exists)

 cd ~/domsmonkeytest/summarise/sites/doms ; bin/stop_resident.sh ; cd ../../../ ; rm -rf summarise

 cd ~/domsmonkeytest/develtestbed/tomcat/bin ; ./shutdown.sh

Wait for Tomcat to disappear from a ps ax | grep tomcat

 cd ~/ ; rm -rf domsmonkeytest

Install DOMS core (including Ingester)

 cd ~/ ; mkdir -p domsmonkeytest ; cd domsmonkeytest

 scp fedora@alhena:/fedora/develkulturarv/testbed-0.10.22-testbed+ingester.zip .

 unzip testbed-0.10.22-testbed+ingester.zip ; cd testbed-0.10.22/bin ; ./install.sh ../../develtestbed

 cd ../../develtestbed/ingester/radio-tv-0.0.6 ; bash bin/ingest.sh -h files/preingestfiles/2007

Continue with files/preingester/2008, files/preingester/2009 and files/preingester/2010 if you need more objects in the DOMS. If you need a quick ingest, do cd files/preingester/2007 ; ls -1 | grep -v 00-00_dr1 | xargs rm ; cd ../../.. just before the ingest.

Install DigiTV

Not needed for monkey-testing (pre-ingested objects for testing included in the above).

Install IP Rolemapper

 cd ~/domsmonkeytest ; scp fedora@alhena:/fedora/DomsReleases/iprolemapping/0.0.7/ipRoleMapping-0.0.7-bin.zip ./ ; unzip ipRoleMapping-0.0.7-bin.zip

 mkdir ~/domsmonkeytest/develtestbed/services/conf/iprolemapper ; cp ~/domsmonkeytest/ipRoleMapping-0.0.7/data/ipRoleMappingService/ipRangesAndRoles.xml ~/domsmonkeytest/develtestbed/services/conf/iprolemapper/ ;
 cp ~/domsmonkeytest/ipRoleMapping-0.0.7/data/ipRoleMappingService/log4jproperties.xml ~/domsmonkeytest/develtestbed/services/conf/iprolemapper/

 cd ~/domsmonkeytest/develtestbed/tomcat/conf/Catalina/localhost/ ; gedit context.xml.default

before </Context> insert

    <!-- IP role mapper -->
    <Parameter name="dk.statsbiblioteket.doms.iprolemapper.webservice.IPRoleMapperService.configurationFile"
               value="${user.home}/domsmonkeytest/develtestbed/services/conf/iprolemapper/ipRangesAndRoles.xml" override="false"/>
    <Parameter name="dk.statsbiblioteket.doms.iprolemapper.log4jConfigurationFilePath"
               value="${user.home}/domsmonkeytest/develtestbed/services/conf/iprolemapper/log4jproperties.xml" override="false"/>

and save the file.

 cd ~/domsmonkeytest/develtestbed/services/conf/iprolemapper ; gedit ipRangesAndRoles.xml

remove all iprange elements, except the last. Change both begin- and end-IPs to your own IP (which you find with ifconfig)

 cp ~/domsmonkeytest/ipRoleMapping-0.0.7/wars/iprolemapping.war ~/domsmonkeytest/develtestbed/services/webapps/

 cd ~/domsmonkeytest/develtestbed/tomcat/bin ; ./shutdown.sh

Wait for Tomcat to disappear from a ps ax | grep tomcat

 ./startup.sh

Install Summa backend

 cd ~/domsmonkeytest ; svn co "https://merkur.statsbiblioteket.dk/svn/summarise/trunk" summarise
 cd summarise/sites/doms ; bin/synchronize.sh ; mkdir data index suggest ; DEBUG=1 bin/setup.sh -v ; bin/deploy.sh -v
 gedit config/storage_doms.xml

below DOMSWebserviceURL define instead

 http://localhost:7880/centralWebservice-service/central/?wsdl

and save the file.

 bin/start_resident.sh ; cd ~/domsmonkeytest/summarise/sites/doms/ ; ls -als log/*fatal*

if any of the listed fatal-logs are of non-zero size, repeat the start_resident line above and check again.

 bin/ingest_full.sh
 DEBUG=1 bin/index_full.sh

Ingest + index (update)

bin/ingest_update.sh
DEBUG=1 bin/index_update.sh

Ingest + index (test = 50 records only)

DEBUG=1 bin/ingest_full.sh
DEBUG=1 bin/index_full.sh

Test front end (search for "*"): http://localhost:57308/doms/

Install Wowza with plugins

Prerequisites

Install VLC by downloading it at http://www.videolan.org/vlc/ and follow the installation instructions for the relevant OS on the page. (See if you already have VLC with a vlc --version)
Install Wowza Streaming Server:

Get a license key by filling the form http://www.wowzamedia.com/pro10s.php

Install Wowza version 2.2.3

On OSX

Get the install package

 scp wowza@iapetus:/home/wowza/releases/binary_packages/WowzaMediaServer-2.2.3.dmg ~/Download

Double click the installer and follow the on-screen instructions

On Linux

Get the install package for either as a Debian or RPM package (Warning: the DEB installer will overwrite prior versions.)

 scp wowza@iapetus:/home/wowza/releases/binary_packages/WowzaMediaServer-2.2.3.deb.bin.sh ~/Download

 scp wowza@iapetus:/home/wowza/releases/binary_packages/WWowzaMediaServer-2.2.3.rpm.bin.sh ~/Download

Then install the package:

cd ~/Download ; sudo chmod +x WowzaMediaServer-2.2.3.deb.bin.sh
sudo ./WowzaMediaServer-2.2.3.deb.bin.sh

Install Wowza plugin

On OSX

Shutdown Wowza

/Library/WowzaMediaServer-2.2.3/bin/shutdown.sh

Save previous configurations (OSX)

cp -r /Library/WowzaMediaServer-2.2.3/conf/doms ~/tmp
cp -r /Library/WowzaMediaServer-2.2.3/conf/domslive ~/tmp

Fetch release package

scp fedora@alhena:/fedora/DomsReleases/wowzaplugin/1.0rc4/doms-wowza-install-package-1.0rc4.zip ~/Download/

Extract:

unzip ~/Download/doms-wowza-install-package-1.0rc4.zip -d ~/tmp

Deploy

cp -r ~/tmp/DOMS-Wowza-plugin-1.0rc2_install-package /Library/WowzaMediaServer-2.2.3/

Update configuration in the files

/Library/WowzaMediaServer-2.2.3/conf/doms/doms-wowza-plugin.properties

/Library/WowzaMediaServer-2.2.3/conf/domslive/domslive-wowza-plugin.properties

Start Wowza

/Library/WowzaMediaServer-2.2.3/bin/startup.sh

On Linux

Shutdown Wowza

cd /usr/local/WowzaMediaServer-2.2.3/bin/ ; ./shutdown.sh

Save previous configurations

cp -r /usr/local/WowzaMediaServer-2.2.3/conf/doms ~/tmp
cp -r /usr/local/WowzaMediaServer-2.2.3/conf/domslive ~/tmp

Fetch release package

scp fedora@alhena:/fedora/DomsReleases/wowzaplugin/1.0rc4/doms-wowza-install-package-1.0rc4.zip ~/Download/

Extract:

mkdir ~tmp/doms-wowza-install-package-1.0rc4 ; unzip ~/Download/doms-wowza-install-package-1.0rc4.zip -d ~/tmp/doms-wowza-install-package-1.0rc4/

Deploy

sudo cp -r ~/tmp/doms-wowza-install-package-1.0rc4/* /usr/local/WowzaMediaServer-2.2.3/

Update configuration in the files

sudo gedit /usr/local/WowzaMediaServer-2.2.3/conf/doms/doms-wowza-plugin.properties

replace the two relevant lines with

ticketInvalidFile=${com.wowza.wms.context.VHostConfigHome}/usr/local/WowzaMediaServer-2.2.3/data/rck_10mins.flv
ticketCheckerLocation=http://localhost:7880/authchecker

sudo gedit /usr/local/WowzaMediaServer-2.2.3/conf/domslive/domslive-wowza-plugin.properties

replace the two relevant lines in the same way.