Dspace help

General Dspace help is available on the Dspace Wiki. Here are some additional tips specific to our installation:

  1. our Dspace is installed in the /projects/vpc/dspace folder in the Venice server with a URL of
  2. to have permission to modify anything about the installation you need to have root access as a superuser or log in as the user dspace.
  3. the DSpace configuration files are under /projects/vpc/dspace/config
    • the main DSpace configuration file is /projects/vpc/dspace/config/dspace.cfg
  4. for any changes made to the dspace config file or to the specific user interfaces to take effect, you have to:
  5. to modify the structure of the metadata for an item, click the Metadata

Front End look and feel (Manakin)

  1. the manakin front end can be found at http://www.cityknowledge.org:8080/xmlui
          • The actual files are in the folder /usr/local/apps/apache-tomcat-5.5.26/webapps/xmlui
  2. Help on Manakin is found at this site
  3. Manakin works with themes. We are currently using a theme called venice
    • All themes are in the folder /usr/local/apps/apache-tomcat-5.5.26/webapps/xmlui/themes
    • To change the current theme you must edit the file /projects/vpc/dspace/config/xmlui.xconf
  4. Making changes to Manakin is not too simple but it is usually done via one of the following ways:
    • For changes in the stylesheets (css files) go to /usr/local/apps/apache-tomcat-5.5.26/webapps/xmlui/themes/venice/lib
    • There are three css files. One with general styles and two with style attributes that are specific for Internet Explorer
    • To change the text that is shown on the DSpace pages, in most cases you have to edit the file
      • /usr/local/apps/apache-tomcat-5.5.26/webapps/xmlui/i18n/messages.xml
    • To change the structure of specific pages (such as item pages, community pages, submission pages, etc.) you mainly have to edit the files in the folder
      • local/apps/apache-tomcat-5.5.26/webapps/xmlui/themes/dri2xhtml
      • It's not very easy to make changes, and DSpace seems to be very sensitive to changes made in that… So before trying something, make sure you back up the files in there, because it's very easy to break Manakin by forgetting to close brackets or a comma

RSS feeds

  1. The xml user interface doesn't really have support for RSS feeds so they are actually located in the jsp ui
  2. All the configurations regarding the RSS feed are in the dspace.cfg file
  3. to change or add descriptive labels of each component of an RSS feed for an Item (in a collection within a community) modify the dictionary file called Message.properties in the folder /usr/local/apps/apache-tomcat-5.5.26/webapps/jspui/WEB-INF/classes

Restarting DSpace

Quick Procedure (Ctrl-c and then right-click+return using putty):

  • log in with a "regular" user name, then switch to root (su -)
  1. /etc/init.d/postgresql restart
  2. cd /usr/local/apps/apache-tomcat-5.5.26/bin
  3. ./shutdown.sh
  4. ./startup.sh

Whenever the server is restarted there are a few things to check:

  • Whether postgres is running. To restart postgres:
        1. log in with a "regular" user name, then switch to root (su -)
        2. /etc/init.d/postgresql restart
  • Whether the handle server is running. To start it:
    1. cd /projects/vpc/dspace/bin
    2. ./start-handle-server
  • Whether the port 8000 is open. To open it?

A common reason for DSpace to be down is that Tomcat as a whole may be down. To check if that's the case try to access "http://www.cityknowledge.org:8080". If you can't see Tomcat's main page, you have to do the following:

  • cd /usr/local/apps/apache-tomcat-5.5.26/bin
  • ./shutdown.sh as root
  • ./startup.sh as root


In case you want to change the Favicon, the pointer to the icon is in the file:

  • /usr/local/apps/apache-tomcat-5.5.26/webapps/xmlui/themes/dri2xhtml/structural.xsl
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License