Setup

1. Build DAMS Manager Application

   Clone this repo

   git clone [email protected]:ucsdlib/damsmanager.git

   Setup ant build.properties

   catalina.home=/pub/tomcat
   deploy.home=${catalina.home}/webapps

   Build damsmanager.war and deploy to tomcat

   ant clean webapp local-deploy

2. Environment

   Create a directory to hold DAMS Manager config and files

   DAMSMANAGER_HOME=/pub/damsmanager
   

   Copy conf/damsmanager.properties from source codes to this directory and edit the following properties to match your local settings

   xdre.clusterHostName=https://gimili.ucsd.edu:8443    
   xdre.damsRepo=https://gimili.ucsd.edu:8443/dams/api    
   xdre.damsRepo.user=lib-app-damspas    
   xdre.damsRepo.pwd=xxxxxx        
   xdre.staging=/pub/data1/dams_staging    
   xdre.tmpFileDir=/pub/damsmanager    
   xdre.solrBase=http://gimili.ucsd.edu:8080/solr/blacklight    
   xdre.defaultDerivatives=2,3,4,5,6,7    
   xdre.ark.urlBase=http://library.ucsd.edu/ark:    
   xdre.ark.orgCode=20775    
   [email protected]       
   

3. Tomcat

   Download Tomcat 7 from http://tomcat.apache.org/download-70.cgi if you haven't installed it

   Edit Tomcat conf/server.xml and add to the GlobalNamingResources

   <Environment name="damsmanager/home" value="/pub/damsmanager" type="java.lang.String"/>

   Enable SSL on port 8443, uncomment and update the SSL connector config if you haven't done it before:

   <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
       maxThreads="150" scheme="https" secure="true"
       keystoreFile="conf/tomcat.keystore" keystorePass="XXXXXXXX"
       clientAuth="false" sslProtocol="TLS" />
   

   Then generate a keystore in the tomcat/conf directory with Java keytool (Run the keytool and follow the prompt to enter the same password as the keystorePass parameter above, and answer the questions to create the keystore):

   keytool -genkey -alias tomcat -keyalg RSA -keystore tomcat.keystore -validity 3650

   Edit Tomcat conf/server.xml to configure the Realm for LDAP authorization or your organizational method

    <Realm className="org.apache.catalina.realm.JNDIRealm" debug="99"
       connectionName="[email protected]" connectionPassword="xxxxxxxx"
       connectionURL="ldaps://ldap.ad.ucsd.edu:636" referrals="follow"
       userBase="OU=Users,OU=University Library,DC=AD,DC=UCSD,DC=EDU"
       userSearch="(sAMAccountName={0})" userSubtree="true"
       roleBase="OU=Groups,OU=University Library,DC=AD,DC=UCSD,DC=EDU"
       roleName="CN" userRoleName="memberOf" roleSearch="(member={0})"/>

   Start Tomcat.