DLC Installationsanleitung

MPDL,Admin

=ESciDoc=
 * Install eSciDoc version 1.3

Indexing Stylesheets

 * Crate a new directory 'dlc_index' in ESCIDOC_INSTALL_DIR/jboss/server/default/conf/search/config/index
 * Copy all files from here to this new directory


 * Change to directory ESCIDOC_INSTALL_DIR/jboss/server/default/conf/search/config/index/item_container_admin
 * Replace itemContainerAdminXmlToLucene.xslt with the one from here


 * Edit ESCIDOC_INSTALL_DIR/jboss/server/default/conf/search/config/fedoragsearch.properties
 * Add 'dlc_index' to property fedoragsearch.indexNames

db.dlc_index.class=de.escidoc.sb.srw.EscidocSRWDatabaseImpl db.dlc_index.configuration=index/dlc_index/dlc_index.SRWDatabase.properties
 * Edit ESCIDOC_INSTALL_DIR/jboss/server/default/conf/search/config/SRWServer.props
 * Add Lines:

eSciDoc Policies

 * Go to escidoc-core database
 * Choose table aa.escidoc_policies
 * Replace xml column of role_id 'escidoc:role-depositor' with the content from depositor.xml
 * Replace xml column of role_id 'escidoc:role-moderator' with the content from moderator.xml

Content Models

 * DLC uses eSciDoc Content Models to distinguish between Monographs, Multivolumes and Volume
 * Thus, create 3 Content Models (e.g. using the eSciDoc Admin Tool) with arbitrary names and descriptions
 * The ids of these content models have to be added to the dlc.properties later (see below)

=DLC Database= DLC is currently configured in order to work with a Postgres database system. Thus, the same database system as for eSciDoc can be used.
 * Create a new database user
 * create a UTF-8 database with this user as owner
 * The credentials have to be added to the dlc.properties file later (see below)
 * Tables will be automatically created when DLC application is started for the first time

=Tomcat= JAVA_OPTS="-Xms1g -Xmx4g -XX:MaxPermSize=1g"
 * Install Apache Tomcat 7.0.29
 * Edit TOMCAT_INSTALL_DIR/conf/server.xml
 * Beware that Tomcat is using different ports than eSciDoc's JBOSS, e.g. by changing the HTTP Connector Port to 7070 and the AJP Connector port to 8010
 * Increase the connection timeout of the HTTP Connector to 300000 (necessary for the image upload servlet)
 * Edit TOMCAT_INSTALL_DIR/bin/setenv.sh (or .bat for windows, create if it does not exist)
 * Create/Change Line:

Image Upload Servlet

 * Create an empty directory for the image files, e.g. '/data/dlc_images'. Subdirectories 'thumbnails', 'web' and 'original' will be created automatically later.
 * Copy image-upload.war to TOMCAT_INSTALL_DIR/webapps
 * Create an file image-upload.properties in TOMCAT_INSTALL_DIR/conf
 * Edit TOMCAT_INSTALL_DIR/conf/image-upload.properties (see also example below)
 * image-upload.tmpDir: Select a temporary directory for the image files, e.g. /tmp
 * image-upload.destDir: Add the recentyl created image directory, '/data/dlc_images' in this example
 * image-upload.username: Select an username
 * image-upload:password: Select a password

Digilib

 * Get digilib here
 * Copy the digitallibrary directory to TOMCAT_INSTALL_DIR/webapps (In this example, the directory is called 'digitallibrary')
 * Edit TOMCAT_INSTALL_DIR/webapps/digitallibrary/WEB-INF/digilib-config.xml
 * Adapt basedir-list parameter to your image directory with the endings 'thumbnails','web' and 'original'

DLC

 * Copy dlc.war to TOMCAT_INSTALL_DIR/webapps
 * Copy dlc.properties to TOMCAT_INSTALL_DIR/conf
 * Edit dlc.properties (see also example below)
 * Adapt urls to escidoc
 * Adapt urls and username/password to image upload
 * Adapt urls to digilib
 * Adapt urls to escidoc database (Also used for batch ingest data information)
 * Adapt content model ids
 * Adapt DLC database URL and credentials

=Startup=
 * Start database (if not running yet)
 * Start eSciDoc jboss (if not running yet)
 * Start Apache Tomcat
 * DLC will be available under context-path /dlc (e.g. http://localhost:7070/dlc/)

=Example configurations=

dlc.properties
escidoc.common.framework.url=http://localhost:8080/ escidoc.common.login.url=http://dlc.mpdl.mpg.de:8080/ image.thumbnail.maxWidth=300 image.thumbnail.maxHeight=300 image.web.maxWidth=1000 image.web.maxHeight=1000 image.original.maxWidth=5000 image.original.maxHeight=5000 image-upload.thumbnailsDir=thumbnails image-upload.webDir=web image-upload.originalDir=original image-upload.tmpDir=/X/dlctmp dlc.instance.url=http://dlc.mpdl.mpg.de dlc.app.title=Digital Libraries Connected dlc.context.path=dlc

image-upload.url.upload=http://localhost:7070/image-upload/ image-upload.url.download=http://dlc.mpdl.mpg.de/image-upload/ image-upload.username=dlc-image-uploader image-upload.password=dlc-image-uploader-password digilib.scaler.url=http://dlc.mpdl.mpg.de/digitallibrary/servlet/Scaler

dlc.content-model.monograph.id = escidoc\:1 dlc.content-model.multivolume.id = escidoc\:2 dlc.content-model.volume.id = escidoc\:3

dlc.pid.handle.registration = false

escidoc.role.system.admin = escidoc:role-system-administrator escidoc.role.ou.admin= escidoc:role-ou-administrator escidoc.role.context.admin= escidoc:role-context-administrator escidoc.role.userAccount.admin= escidoc:role-user-account-administrator escidoc.role.user.depositor = escidoc:role-depositor escidoc.role.user.moderator = escidoc:role-moderator escidoc.role.user.md-editor = escidoc:role-md-editor

dfg.viewer.baseurl = http://dfg-viewer.de/demo/viewer/?set[mets]=

dlc.batch_ingest.database.connection.url = jdbc:postgresql://localhost:5432/dlc dlc.batch_ingest.database.admin_user.name = dlcuser dlc.batch_ingest.database.admin_user.password = XXXXXX

image-upload.properties
image-upload.tmpDir=/X/dlctmp image-upload.username=dlc-image-uploader image-upload.password=dlc-image-uploader-password image-upload.sizeMax=100000000 image-upload.destDir=/X/dlc_images