AgriOcean DSpace, a customized version of DSpace. Technical background DSpace is an application which uses a web server (Tomcat) and a database server (Postgresql). The end user accesses the DSpace application on the Tomcat web server, which connects to a database on the Postgresql server. Tomcat is installed under Program Files and has specific management software (Monitor, Configure) Postgresql is installed under Program Files. It is strongly advised to install the data directories outside Windows system directories. PgAdmin III is a client software to manage the databases on the Postgresql server The DSpace application has its application under the webapps directory of Tomcat. The configuration and management directories are in a separate directory.
DSpace configuration and management: overview The Dspace management directories are in the..\repos directory. The main subdirectories are assetstore: contains the uploaded files (pdf, word, etc) bin: command line scripts for different tasks: creation of an administrator, updating indexes, etc, config: with dspace.cfg (main configuration file) and (inputforms-extended.xml (submission format file) log: use and error logs
Adapting the basic configuration of AgriOcean DSpace by changing dspace.cfg (by default in <repos_directory>\config) The configuration of DSpace is defined in text files. The main configuration file is dspace.cfg. If you look at dspace.cfg, you see too many options. In the next table you will find the most important options. We already fine-tuned as much as possible the installation. Still, you want to personalize it further. Therefore read carefully the information in this document. For further changes, read carefully the comments for every parameter in the configuration file. Make always a copy of your original file before making changes. If you want to change other parameters than the one described below, contact me.
Configuration option in dspace.cfg:!! Touch only the configuration marked in red!! ##### Basic information ###### # DSpace installation directory dspace.dir = c:/aod/repos Comment #: used to uncomment a whole line of configuration. It will not be used. If you want to install AgriOcean DSpace in another directory, all the reference to the base directory has to be changed to in the next files: <repos_directory> 1. \config\dspace.cfg 2. \config\log4j.properties 3. \config\log4j-handle-plugin.properties <tomcat_directory>\webapps 4. \agriocean\web-inf\web.xml 5. \oai\web-inf\web.xml 6. \solr\web-inf\web.xml
# DSpace host name - should match base URL. Do not include port number dspace.hostname = localhost # DSpace base host URL. Include port number etc. dspace.baseurl = http://localhost:8080 # DSpace base URL. Include port number etc., but NOT trailing slash # Change to xmlui if you wish to use the xmlui as the default, or remove # "/jspui" and set webapp of your choice as the "ROOT" webapp in # the servlet engine. dspace.url = ${dspace.baseurl}/dspace # The base URL of the OAI webapp (do not include /request). dspace.oai.url = ${dspace.baseurl}/oai # Name of the site dspace.name = AgriOcean Agriocean DSpace is installed on your local machine, to make it visible for external users you need to give it the name of your server: A URL or an IP - E.g. www.yourinstitute.org or 168.1.1.5 (ask your network manager). If tomcat is installed on port 80 you have to change the port number. When changing the port number, change it also in file <repos_directory>\config\dspacesolr-search.cfg The url of your institute will be www.yourinstitute.org/dspace If you want to rename the extension, you also have to rename it in the tomcatwebapps directory Here you can adapt the name, which will be used on the website
##### Database settings ##### # Database name ("oracle", or "postgres") db.name = ${default.db.name} db.name = postgres #db.name = oracle If you want to change database elements (eg name, password) you have to adapt them first through pgadmin III. # URL for connecting to database #db.url = ${default.db.url} db.url = jdbc:postgresql://localhost:5432/aod # JDBC Driver #db.driver = ${default.db.driver} db.driver = org.postgresql.driver # Database username and password #db.username = ${default.db.username} #db.password = ${default.db.password} db.username = dspace db.password = your password
##### Email settings ###### # SMTP mail server mail.server=smtp.gmail.com # SMTP mail server authentication username and password (if required) mail.server.username = yourmail@gmail.com mail.server.password = yourpassword # SMTP mail server alternate port (defaults to 25) mail.server.port = 25 # From address for mail mail.from.address = yourmail@gmail.com # Currently limited to one recipient! feedback.recipient = yourmail@gmail.com # General site administration (Webmaster) e-mail mail.admin = yourmail@gmail.com # Recipient for server errors and alerts alert.recipient = yourmail@gmail.com # Recipient for new user registration emails registration.notify = yourmail@gmail.com # An option is added to disable the mailserver. By default, this property is set to false # By setting mail.server.disabled = true, DSpace will not send out emails. # It will instead log the subject of the email which should have been sent # This is especially useful for development and test environments where production data is used when testing functionality. mail.server.disabled = false It is possible to use a gmail as a mail server. We created a general account. So you can use already all the services of AgriOcean DSpace (even when your server is defined on localhost). But every user should create their own gmail account and fill out the mail and password where required. If you use a local email server, consult the dspace manual for installation. When changing the email address, change it also in the file <repos_directory>\config\oaicat.properties
##Statistical Report Configuration Settings ## # should the stats be publicly available? should be set to false if you only # want administrators to access the stats, or you do not intend to generate # any report.public = false # directory where live reports are stored report.dir = ${dspace.dir}/reports/ #---------JSPUI SPECIFIC CONFIGURATIONS-----# ### i18n - Locales / Language #### # Default Locale # A Locale in the form country or country_language or country_language_variant # if no default locale is defined the server default locale will be used. default.locale = en # All the Locales, that are supported by this instance of DSpace webui.supported.locales = en, fr, es #---------SOLR STATISTICS CONFIGURATIONS----# ##### Usage Logging ##### solr.log.server = http://localhost:8080/solr/statistics #AgriOcean project specific CONFIGURATIONS# batchimport.customxml.enable = false You can make your statistics available by changing report.public to true The standard language for the interface is English. In the menus French and Spanish are also supported if the translation is available. The Message properties can be adapted in: <tomcat_directory>\webapps\dspace\web- INF\classes If you have defined tomcat under another port, you have to change this here. Also change the port number in <repos_directory>\config\ dspace-solrsearch.cfg If you use a batch import translation file which is not defined in the batch import module on the collection page
Use and error logs At <repos_directory>\log: Every activity on the server is registered in daily log files. This is a way to analyze errors. It is most of the time to technical for users. But it will help us to solve users problems. Users have to send me the dspace.log.<date> file and a description of the problem.
Bin scripts At <repos_directory>\bin To be used from the command line: Main commands: - create-administrator - index-init - itemcounter - all the stat-commands and generate-sitemaps when on line Commands have the followings syntax: C:\aod\repos\bin\dspace create-administrator
Changing the AOD interface (as Tomcat Web application) The interface is defined under <tomcat_directory>\webapps. People will like to modify the header. This can be done by changing the file bannerlarge.jpg. Keep the same pixels size. To change the menu messages, adapt the Messages.properties. We need support for the translations from English to other languages. Now if the translation is not available, it will use the default Messages.properties definitions.
Managing Postgresql with the PgAdmin III client Postgresql is a server application which after installation runs automatically on Windows. The metadata of AOD is contained in database (aod). With pgadmin III it is possible to access the database through an interface. Only use for global tasks like backup, restore and upgrade tasks.
Managing Tomcat The first time after installation Tomcat starts automatically. Later, you can start it with Monitor Tomcat from the Windows Program Menu or from the Task Bar. If Windows requests Administrator rights, run it as Administrator Localhost is sometimes blocked by Internet Explorer. Therefore it is easier to use Firefox, Chrome, Safari as browser.
To set up Tomcat to start up automatically, go to Configure Tomcat (in Windows Program Menu). Set Status type on Automatic: If Necessary change Log On rights to Administrator.
Backup procedures After installation and customization: Make a copy of: <repos_directory> and all subdirectories <tomcat_directory>\webapps and all subdirectories Regular backups of the data (daily weekly): Make a copy of <repos_directory>/assetstore and all subdirectories!!! - daily <repos_directory>/solr and all subdirectories(for the user statistics) weekly Make a backup of the database (see next page)
Creation of a back-up of aod database with pgadmin III 1. Start pgadmin III and open the database aod 2. Click with the right button on AOD and a menu will open 3. Choose backup 4. Enter the directory and filename to save the backup 5. After clicking on the Backup button the process will be realized.