Installing ePrints from source on Fedora Core 11

Download eprints-3.1.x.tar.gz from

1. Empowered as super users


2. Install required packages

yum install -y rpmbuild wget elinks tetex-latex mod_perl perl-Unicode-String perl-MIME-Lite perl-XML-LibXML perl-XML-Parser perl-DBI perl-DBD-mysql xpdf gdome2 gdome2-devel ImageMagick

3. RPM Build

rpmbuild -ta eprints-x.x.x.tar.gz

4. Install the rpm

rpm -i /path/to/eprints … rpm (ie. /root/rpmbuild/RPMS/noarch/eprints3-eprints-1.fc11.noarch.rpm)

5. Install MySQL

yum install -y mysql mysql-server

6. Start MySQL

/etc/init.d/mysqld start

7. Set MySQL root password

mysql -u root
SET PASSWORD FOR ‘root’@localhost = PASSWORD(‘new_password’);

8. Change user to ‘eprints’

su eprints

9. Go to eprints directory

cd (Should be in /opt/eprints3)

10. Create a repository archive

./bin/epadmin create
(follows the installation process)

11. Update apache configuration file

vi /etc/httpd/conf/httpd.conf
Add: Include /opt/eprints3/cfg/apache.conf
Save and Exit

12. Restart Apache

Restart Apache
/etc/init.d/httpd restart

13. Using eprints

ePrints can be accessed via a web browser

Note: For testing purposes only!!! Running eprints on a ‘fake’ hostname is done by editing the hosts file:
For example if eprints is set to run under but we haven’t got that domain. Getting around it is to:
1. Edit hosts file

vi /etc/hosts

2. Restart the interface

service network restart

3. ePrints can be accessible from

Installing Fedora 3 on Windows

This is a record of my attempt to install Fedora 3 on Windows

1. Install JDK 6. Can be downloaded from:

1.1 In order to prevent spacing problem in the directory name, I chose to install Java at C:\Java (Normally, it goes to C:\Program Files\Java

2. Install fedora 2. It can be downloaded from:

2.1 Navigate to folder in Command Prompt (cmd.exe). I ran the Command Prompt as Administrator by right click > Run as Administrator. Then I run

java -jar fedora-installer.jar

2.2 I selected custom and parameters [roughly] can be found here.

3. Setting Environment Variables. This can be done in 2 ways.

3.1 Right click at My Computer > Properties >Advanced >Environment Variable

3.2 Through command (only for that session)



SET CATALINA_HOME=C:\fedora\tomcat

3.3 Navigate to FEDORA_HOME\tomcat\bin

3.4 Run startup.bat

Please find your fedora at the url, for example, http://localhost:8080/fedora

Ps. It also works when setting up java to C:\Program files\Java\…

Pss. Everything seems to work fine, there must be something wrong with my installer lol

Installing The Fascinator on Ubuntu 9.04

Today I attempted to install the Fascinator on Ubuntu 9.04.

The Fascinator is a software platform for eResearch. Development started in 2008 as an attempt to create a clean and usable Institutional Repository user interface.


I first get the documentation from:

To install,

1. I download the file from the server.

2. Then I made it executable by running chmod a+x

3. Run the installer: sudo ./

4. The installer will ask for install directory, passwords, and proxy.

Then I leave it running, while getting a coffee 🙂

When I came back, I have the fascinator running. It’s so good!

Fedora add datastream Exception

Today, when I deployed my application on a production server and tested it, I received this exception:

fedora.server.errors.GeneralException: Unable to add or modify object (commit canceled)

This is caused by fedora.API-M.addDatastream() method. It turned out that the issue is because I used null value for an alternateid, instead of an empty array of string. This is quite strange because everything works fine on my development machine. Anyway, this is the correct syntax.

apim.addDatastream(“changeme:1”, “DsId”, new String[] {}, …);


apim.addDatastream(“changeme:1”, “DsId”, null, …);

Source: [1], [2].

Installing Fez on Ubuntu 8.10

This is a record of my attempt to install Fez: on Ubuntu 8.10:

Fez has couple of dependencies and requirements:

  • Apache, MySQL and PHP. (I’m using LAMP for this)
  • Fedora repository 2:
  • Java:
  • Couple of extensions: Tidy, LDAP, GD, MySQL, CURL, ImageMagick, Graphviz and JHOVE.

Installing various Extensions:

apt-get install sun-java6-jdk
apt-get install php5-tidy
apt-get install php5-ldap
apt-get install php5-gd
apt-get install php5-curl
apt-get install php5-imagick
apt-get install graphviz
apt-get install jhove

A few tweaks to PHP ini:

1. Edit /etc/php/apache/php.ini

allow_call_time_pass_reference = On
date.timezone = Australia/Perth
post_max_size = 10MB
upload_max_filesize = 10M
memory_limit = 50M

Installing Fedora:

1. Download Fedora 2 from the above website.

2. Go to fedora directory and run: java -jar fedora-jar-file.jar

3. This is a basic value that I used:

  • Type: Custom
  • Authentication for API-A: False
  • SSL: False
  • Servlet Engine: Included
  • Fedora Home: Fedora directory
  • Tomcat Home: Default
  • Tomcat HTTP Port: 8080
  • Tomcat Shutdown Port: 8005
  • Database Included
  • Policy Enforcement enabled: False
  • Resource Index: True
  • REST-API: False
  • Enable Messaging: False
  • Deploy local services/demo: True

4. After that I set couple of enviroment variables: FEDORA_HOME, JAVA_HOME, CATALINA_HOME

5. Then to go to CATALINA_HOME/bin and run: ./ to start Fedora.

Installing Fez:

1. Download Fez code from the above link.

2. Untared it and copied files across to webroot, say /var/www/fez/

3. Change the owner to www-data (for apache)

4. Go to http://myhostname/fez/ and followed the installtion process.