Note: The machine var3rhs, and schema prefix RHS are used below for naming, and would be modified as appropriate for a different test site.

Contents

Test Site Server Setup


Software Installation.

Firewall Configuration

If a firewall is in place, it is important that the following ports be left open:

IU DB2 User Account Creation

Get a DB2 user account id and password from Indiana University, and confirm that cataloging and production schemas have been set up.

Variations Administration User Account Creation

Variations Code Download

Download the Variations tar file from IU, and install its contents to /home/dmlserv.

Variations Modifications








Variations Build

Schema Setup

Access Manager Schema Setup

The setup of the access manager schema will need to be done on the test site server (which needs to have a copy of MySQL).

Access Groups Setup

Cron Job Setup

Several cron jobs need to be set up to get Variations to work.

Appendix


  <Server rmiHost="var3rhs.dhcp.indiana.edu" rmiPort="1099"
  rmiServiceName="RHS_4"
  kerberosPrincipalName="host@var3rhs.dhcp.indiana.edu">
    <Library name="RHS">
      <SQLRepository type="DB2" >
        <!-- jdbc universal type 4 driver -->
        <jdbcURL>jdbc:db2://rackett.dlib.indiana.edu:60000/DML_AR</jdbcURL>
        <jdbcDriver>com.ibm.db2.jcc.DB2Driver</jdbcDriver>
        <SchemaName>RHS_4</SchemaName>
        <ExtraOptions>
          <Option name="RemoteUpdateIndexPort">49999</Option>
        </ExtraOptions>
      </SQLRepository>
      <ContentRepository rmiHost="var3rhs.dhcp.indiana.edu"
                         rmiPort="1099"
                         rmiServiceName="var3rhsAudioLeaseManager"/>
      <ThemeBaseURL>http://var3rhs.dhcp.indiana.edu/themes/</ThemeBaseURL>
    </Library>
    <Logging>
      <LogFile>/home/dmlserv/log/RHS_4.log</LogFile>
      <LogLevel>DEBUG</LogLevel>
    </Logging>
  </Server>


  <LeaseManager rmiHost="var3rhs.dhcp.indiana.edu" rmiPort="1099"
    rmiServiceName="var3rhsAudioLeaseManager">
    <LeaseResource>
      <LibraryName>RHS</LibraryName>
      <AccessURL>http://var3rhs.dhcp.indiana.edu/cgi-bin/generate-ref-movie.mov?/</AccessURL>
      <ContentDir>/home/content/audio-objects</ContentDir>
      <LeaseDir>/home/content/streaming/leases</LeaseDir>
    </LeaseResource>
    <!-- How long will a lease remain valid (in minutes)? -->
    <LeaseLifeTime>480</LeaseLifeTime>
  </LeaseManager>


#!/bin/sh

echo "Starting Variations3 servers"

# Go to the dmlserv account home directory
# (where Variations should have been installed)
cd /home/dmlserv

# Start the RMI (Remote Method Invocation) Registry
# This needs to be started first
dml/bin/run_RMIRegistry.sh

# Start the user logging server that logs client messages
echo " "
echo "Starting UILoggingServer.sh"
dml/bin/run_UILoggingServer.sh

# Start the audio lease manager - this needs to be started
# before the library application servers
dml/bin/lmapp.sh restart var3rhsAudioLeaseManager

# Start the Variations library application servers
# RHS_4 is the production server
# RHS_CAT2 is the cataloging server
dml/bin/libapp.sh restart RHS_4
dml/bin/libapp.sh restart RHS_CAT2