Page History

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/develtestbedsummarise/tomcatsites/bindoms ; .bin/shutdownstop_resident.sh 

; cd ~/../../../ ; rm -rrf domsmonkeytestsummarise 

 cd summarise~/sites/doms
bin/stop_resident.sh
cd -
domsmonkeytest/develtestbed/tomcat/bin ; ./shutdown.sh 

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

 cd ~/ ; rm -rf summarisedomsmonkeytest 

Install DOMS core (including Ingester)

 cd ~/ ; mkdir -p domsmonkeytest ; cd domsmonkeytest 

 wgetscp httpsfedora@alhena:/fedora/sbforge.org/nexus/service/local/repositories/releases/content/dk/statsbiblioteket/doms/testbed/testbed/0.10.18/testbeddevelkulturarv/testbed-0.10.1822-testbed.zip|nexus/service/local/repositories/releases/content/dk/statsbiblioteket/doms/testbed/testbed/0.10.18/testbed-0.10.18-testbed.zip 

+ingester.zip .

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

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

    Continue with  hotfolder2  and  hotfolder3 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

Install

 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 

Ingest + index (test = 50 records only)

DEBUG=1 ; 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 (kompletupdate)

bin/ingest_fullupdate.sh
DEBUG=1 bin/index_fullupdate.sh 

Ingest + index (updatetest = 50 records only)

DEBUG=1 bin/ingest_updatefull.sh
DEBUG=1 bin/index_updatefull.sh

Shutdown

bin/stop_resident.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:

1. Get a license key by filling the form http://www.wowzamedia.com/pro10s.php
2. Install Wowza version 2.2.3
   1. On OSX

      1. Get the install package

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

      2. Double click the installer and follow the on-screen instructions
   2. On Linux

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

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

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

      2. Then install the package:

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

Install Wowza plugin

1. On OSX

   1. Shutdown Wowza

      Code Block
      language bash
      /Library/WowzaMediaServer-2.2.3/bin/shutdown.sh

   2. Save previous configurations (OSX)

      Code Block
      language bash
      cp -r /Library/WowzaMediaServer-2.2.3/conf/doms ~/tmp cp -r /Library/WowzaMediaServer-2.2.3/conf/domslive ~/tmp

   3. Fetch release package

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

   4. Extract:

      Code Block
      language bash
      unzip ~/Download/doms-wowza-install-package-1.0rc4.zip -d ~/tmp

   5. Deploy

      Code Block
      language bash
      cp -r ~/tmp/DOMS-Wowza-plugin-1.0rc2_install-package /Library/WowzaMediaServer-2.2.3/

   6. Update configuration in the files

      Code Block
      language bash
      /Library/WowzaMediaServer-2.2.3/conf/doms/doms-wowza-plugin.properties

      Code Block
      language bash
      /Library/WowzaMediaServer-2.2.3/conf/domslive/domslive-wowza-plugin.properties

   7. Start Wowza

      Code Block
      language bash
      /Library/WowzaMediaServer-2.2.3/bin/startup.sh

1. On Linux

   1. Shutdown Wowza

      Code Block
      language bash
      cd /usr/local/WowzaMediaServer-2.2.3/bin/ ; ./shutdown.sh

   2. Save previous configurations

      Code Block
      language bash
      cp -r /usr/local/WowzaMediaServer-2.2.3/conf/doms ~/tmp cp -r /usr/local/WowzaMediaServer-2.2.3/conf/domslive ~/tmp

   3. Fetch release package

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

   4. Extract:

      Code Block
      language bash
      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/

   5. Deploy

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

   6. Update configuration in the files

      Code Block
      language bash
      sudo gedit /usr/local/WowzaMediaServer-2.2.3/conf/doms/doms-wowza-plugin.properties

          replace the two relevant lines with

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

      Code Block
      language bash
      sudo gedit /usr/local/WowzaMediaServer-2.2.3/conf/domslive/domslive-wowza-plugin.properties

          replace the two relevant lines in the same way.

   7. Start Wowza

      Code Block
      language bash
      cd /usr/local/WowzaMediaServer-2.2.3/bin/ ; ./startup.sh

Install BES

...

Install Web frontend

1. Setup configuration for the web frontend. Edit file ${user.home}/kultur.properties with the following content

   Code Block
   language bash
   summasearch=http://localhost:57308/doms/search/services/SearchWS?wsdl summastorage=http://localhost:57308/doms/storage/services/StorageWS?wsdl iprolemapping=http://localhost:7950/iprolemapping/ authchecker=http://localhost:7880/authchecker-service/ broadcastservice=http://localhost:9311/bes_DEVEL/ broadcastserviceextraction=http://localhost:9311/bes_DEVEL_EXTRACTION/

1. Checkout domsportal module

   Code Block
   language bash
   cd ~/domsmonkeytest ; svn co "https://merkur.statsbiblioteket.dk/svn/domsportal/trunk" domsportal

   Code Block
   language bash
   cd domsportal

1. Get needed libraries

   Code Block
   language bash
   ant getLibs

1. Compile and run in local tomcat on port 7070

   Code Block
   language bash
   ant tomcat.start

1. Open in browser: http://localhost:7070/kultur/

1. When done stop tomcat

   Code Block
   language bash
   ant tomcat.stop