This guide will show you how to install a new Fedora Repository using the installer, or from source code. If you are upgrading from a previous release, please see Upgrading from 2.x or Upgrading from 3.x. If you have never installed Fedora before, please start with some background considerations.
On this page:
| Table of Contents |
|---|
Prerequisites
Download Fedora 3.6.0
...
The MySQL commands listed below can be run within the mysql program, which may be invoked as follows:
| No Format |
|---|
mysql -u root -p
|
Create the database. For example, to create a database named "fedora3", enter:
| No Format |
|---|
CREATE DATABASE fedora3;
|
Set username, password and permissions for the database. For example, to set the permissions for user fedoraAdmin with password fedoraAdmin on database "fedora3", enter:
| No Format |
|---|
GRANT ALL ON fedora3.* TO fedoraAdmin@localhost IDENTIFIED BY 'fedoraAdmin';
GRANT ALL ON fedora3.* TO fedoraAdmin@'%' IDENTIFIED BY 'fedoraAdmin';
|
MySQL 4.1.x users must also specify the default character set for the Fedora database as "utf8" and the default collation as "utf8_bin". For example, to set the default character set and collation on a database named "fedora3", enter:
| No Format |
|---|
ALTER DATABASE fedora3 DEFAULT CHARACTER SET utf8;
ALTER DATABASE fedora3 DEFAULT COLLATE utf8_bin;
|
...
To prepare Oracle for use with Fedora, the following steps should be taken by an administrative user. First, using the Database Configuration Assistant, ensure that the database you'll be using is created with the UTF8 charset. Next, you'll need to create a Fedora tablespace and user in the database. Assuming the administrative user is sys and the SID is fedora3, log in using SQL*Plus using the following command:
| No Format |
|---|
sqlplus sys/PASSWORD@fedora3 as sysdba
|
To create a tablespace named "fedora_tblspace" with data in /var/lib/oracle, enter the following:
| No Format |
|---|
CREATE TABLESPACE fedora_tblspace
DATAFILE '/var/lib/oracle/fedora_tblspace.dat' SIZE 1024M REUSE
AUTOEXTEND ON NEXT 256M MAXSIZE UNLIMITED
SEGMENT SPACE MANAGEMENT AUTO;
|
To create a user "fedoraAdmin" with password "fedoraAdmin", using the "fedora_tblspace", enter the following:
| No Format |
|---|
CREATE USER fedoraAdmin IDENTIFIED BY fedoraAdmin
DEFAULT TABLESPACE fedora_tblspace;
|
Using the GRANT command, make sure the user has permission to connect, create, alter, and drop tables sequences, triggers, and indexes in this tablespaces. For example:
| No Format |
|---|
GRANT ALL PRIVILEGES TO fedoraAdmin;
|
...
Launch the PostgreSQL interactive terminal, psql, (optionally appending the -U argument to connect as a different user).
| No Format |
|---|
psql -d postgres
|
To create a user "fedoraAdmin"" with password "fedoraAdmin" and database named "fedora3", enter the following:
| No Format |
|---|
CREATE ROLE "fedoraAdmin" LOGIN PASSWORD 'fedoraAdmin';
CREATE DATABASE "fedora3" WITH ENCODING='UTF8' OWNER="fedoraAdmin";
|
...
To start the installer, change to the directory where you downloaded the installer and at a command prompt, enter:
| No Format |
|---|
java -jar fcrepo-installer-3.6.jar
|
...
If Fedora is configured to use SSL, the JAVA_OPTS environment variable must include the javax.net.ssl.trustStore and javax.net.ssl.trustStorePassword properties. The value of javax.net.ssl.trustStore should be the location of the truststore file and the value of javax.net.ssl.trustStorePassword is the password for the keystore. The following values may be used with the sample keystore included with the installer:
| No Format |
|---|
-Djavax.net.ssl.trustStore=$FEDORA_HOME/server/truststore -Djavax.net.ssl.trustStorePassword=tomcat
|
...
If you selected the quick install option, you will find Tomcat installed in FEDORA_HOME/tomcat. To run Fedora, start Tomcat by entering:
| No Format |
|---|
$FEDORA_HOME/tomcat/bin/startup.sh
|
(or for Windows)
| No Format |
|---|
%FEDORA_HOME%\tomcat\bin\startup.bat
|
...
To ingest the demonstration objects, at a command prompt, enter:
| No Format |
|---|
fedora-ingest-demos.sh [hostname] [port] [username] [password] [protocol]
|
(or for Windows)
| No Format |
|---|
fedora-ingest-demos.bat [hostname] [port] [username] [password] [protocol]
|
...
To change the level to DEBUG for all Fedora classes, change the logger name="org.fcrepo" line to the following:
| Code Block |
|---|
<logger name="org.fcrepo" additivity="false" level="DEBUG">
|
To change the level to DEBUG for just one class, add the following lines:
| Code Block |
|---|
log4j.logger.fedora.server.utilities.SQLUtility = DEBUG, FEDORA
log4j.additivity.fedora.server.utilities.SQLUtility = false
|
To change the level to DEBUG for a whole package, add the following lines:
| Code Block |
|---|
<logger name="org.fcrepo.server.resourceIndex" additivity="false" level="DEBUG">
<appender-ref ref="FEDORA"/>
|