DLC Installation

MPDL

ESciDoc  Install eSciDoc version 1.3  Indexing Stylesheets  Create 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 <a href="https://subversion.mpdl.mpg.de/repos/dlc/trunk/digi_lifecycle/digi_lifecycle_logic/src/main/resources/escidoc_dlc_index/item_container_admin/">here</a></li> Edit ESCIDOC_INSTALL_DIR/jboss/server/default/conf/search/config/fedoragsearch.properties <ol> Add 'dlc_index' to property fedoragsearch.indexNames</li> </ol> </li> Edit ESCIDOC_INSTALL_DIR/jboss/server/default/conf/search/config/SRWServer.props <ol> Add Lines: <ol>  </li>  </li> </ol> </li> </ol> </li> </ul> eSciDoc Policies  Go to escidoc-core database</li> Choose table aa.escidoc_policies</li> Replace xml column of role_id 'escidoc:role-depositor' with the content from <a href="https://subversion.mpdl.mpg.de/repos/dlc/trunk/digi_lifecycle/digi_lifecycle_logic/src/main/resources/escidoc_policies/depositor.xml">depositor.xml</a></li> Replace xml column of role_id 'escidoc:role-moderator' with the content from <a href="https://subversion.mpdl.mpg.de/repos/dlc/trunk/digi_lifecycle/digi_lifecycle_logic/src/main/resources/escidoc_policies/moderator.xml">moderator.xml</a></li> Replace xml column of role_id 'escidoc:role-md-editor' with the content from dlc_logic/src/main/resources/escidoc_policies/md-editor.xml</li> </ul> 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</li> The ids of these content models have to be added to the dlc.properties later (see below)</li> </ul> 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.  <li>Create a new database user</li> <li>create a UTF-8 database with this user as owner</li> <li>The credentials have to be added to the dlc.properties file later (see below)</li> <li>Tables will be automatically created when DLC application is started for the first time</li> </ul> Tomcat <ul> <ul> <li>Install <a href="http://archive.apache.org/dist/tomcat/tomcat-7/">Apache Tomcat</a> 7.0.29</li> <li>Edit TOMCAT_INSTALL_DIR/conf/server.xml <ol> <li>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</li> <li>Increase the connection timeout of the HTTP Connector to 300000 (necessary for the image upload servlet)</li> </ol> </li> <li>Edit TOMCAT_INSTALL_DIR/bin/setenv.sh (or .bat for windows, create if it does not exist) <ol> <li>Create/Change Line: </li> </ol> </li> </ul> </ul> Image Upload Servlet <ul> <ul> <ul> <li>Create an empty directory for the image files, e.g. '/data/dlc_images'. Subdirectories 'thumbnails', 'web' and 'original' will be created automatically later.</li> <li>Download the current image-upload-X.X.war from <a href="http://rd.mpdl.mpg.de/nexus/content/repositories/releases/de/mpg/escidoc/digi_lifecycle/image-upload/">MPDL Maven Repository</a></li> <li>Rename it to "image-upload.war"</li> <li>Copy image-upload.war to TOMCAT_INSTALL_DIR/webapps</li> <li>Copy image-upload.properties to TOMCAT_INSTALL_DIR/conf</li> <li>Create TOMCAT_INSTALL_DIR/conf/image-upload.properties (see also example below) <ol> <li>image-upload.tmpDir: Select a temporary directory for the image files, e.g. /tmp</li> <li>image-upload.destDir: Add the recentyl created image directory, '/data/dlc_images' in this example</li> <li>image-upload.username: Select an username</li> <li>image-upload:password: Select a password</li> </ol> </li> </ul> </ul> </ul> Digilib <ul> <ul> <li>Get <a href="http://prdownload.berlios.de/digilib/digilib-core-1.8.3.zip">Digilib</a></li> <li>Copy the digitallibrary directory to TOMCAT_INSTALL_DIR/webapps (In this example, the directory is called 'digitallibrary')</li> <li>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'</li> <li>e.g. </li> </ul> </ul> OAI Data Provider (JOAI) <ul> <ul> <li>Get <a href="http://www.dlese.org/dds/services/joai_software.jsp">JOAI</a></li> </ul> </ul> DLC <ul> <ul> <li>Download the current digi_lifecycle_presentation-X.X.war from <a href="http://rd.mpdl.mpg.de/nexus/content/repositories/releases/de/mpg/escidoc/digi_lifecycle/digi_lifecycle_presentation/">MPDL Maven Repository</a></li> <li>Rename it to "dlc.war"</li> <li>Copy dlc.war to TOMCAT_INSTALL_DIR/webapps</li> <li>Create dlc.properties in TOMCAT_INSTALL_DIR/conf (see also example below)</li> <li>Edit dlc.properties <ol> <li>Adapt urls to escidoc</li> <li>Adapt urls and username/password to image upload</li> <li>Adapt urls to digilib</li> <li>Adapt urls to escidoc database (Also used for batch ingest data information)</li> <li>Create three content models in eSciDoc (eg. using admin tool) and adapt content model ids</li> </ol> </li> </ul> </ul> Startup <ol> <li>Start database (if not running yet)</li> <li>Start eSciDoc jboss (if not running yet)</li> <li>Start Apache Tomcat</li> <li>DLC will be available under context-path /dlc (e.g. http://localhost:7070/dlc)</li> <li>Login with eSciDoc system administrator account</li> <li>Now you can create organizations and organization Administrators</li> <li>Now login with an organization administrator</li> <li>You can then create collections and users which are allowed to deposit to collections and edit the content of collections</li> </ol> Examples 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 = XXXXX

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

Build from scratch If you want to build the project from scratch, you can checkout the source code from our <a href="https://subversion.mpdl.mpg.de/repos/dlc/trunk/">Subversion Repository</a>