Building the Live CD

From EPrints Documentation
Revision as of 13:43, 8 February 2010 by Pm705 (talk | contribs)
Jump to: navigation, search

This page is designed as a HOW-TO on building the LiveCD for the development team, if you find it useful then great.

The current machine with this on is the Xubuntu install on rizzo.ecs.soton.ac.uk

Stage 1 - Initial Setup

Note: This only needs to be done once per rebuild (from a new distro)

1) Go fetch a Ubuntu variation as the base image. Currently Xubuntu Desktop i386

2) Install this on a box.

3) Once installed follow the instructions at [1] up until the customisations section.

Stage 2 - Installing EPrints

1) If not already done follow the "Prepare and chroot" instructions at [2].

2) Add the apt mirror for eprints. (http://deb.eprints.org/...)

3) Install eprints via "apt-get install eprints"

4) Create the training repository, url = training.eprints.org, admin user = admin, admin password = eprints.

5) Add training.eprints.org to hosts file pointing at 127.0.0.1

6) As eprints import the test data

Upgrading

1) apt-get remove eprints

2) apt-get install eprints

3) epadmin upgrade training

Allowing Admin user to edit conf files

1) In user_roles.pl in the local archive cfg.d directory:

$c->{user_roles}->{admin} = [qw{
#
# Just add this to the end:
   live-cd-extras
}],


$c->{roles}->{"live-cd-extras"} = [
      "config/edit/perl",
      "repository/backup" #DO NOT ALLOW THIS ON A PRODUCTION SERVER!!!!!!!!!!!!!!!
];

Backup and Restore Plugins

1) Download the Backup and Restore plugins from the SVN to their place in the EPrints tree (Plugin/Screen/Admin)

2) Add the following to a new file lib/lang/en/phrases/backup.xml (committed in 3.2)

<?xml version="1.0" encoding="iso-8859-1" standalone="no" ?> <!DOCTYPE phrases SYSTEM "entities.dtd">

<epp:phrases xmlns="http://www.w3.org/1999/xhtml" xmlns:epp="http://eprints.org/ep3/phrase" xmlns:epc="http://eprints.org/ep3/control">

 <epp:phrase id="Plugin/Screen/Admin/Backup:action:backup_repository:title">Backup Repository</epp:phrase>
 <epp:phrase id="Plugin/Screen/Admin/Backup:action:backup_repository:description">Exports a single compressed file of EPrints system, archive data and database files for this repository.</epp:phrase>
 <epp:phrase id="Plugin/Screen/Admin/Restore:title">Restore Repository</epp:phrase>
 <epp:phrase id="Plugin/Screen/Admin/Restore:description">Restores a complete repository, including all eprints system files..</epp:phrase>
  <epp:phrase id="Plugin/Screen/Admin/Restore:backup_archive">Backup archive file:</epp:phrase>
 <epp:phrase id="Plugin/Screen/Admin/Restore:upload">Upload</epp:phrase>

</epp:phrases>

Building the CD

NOTE: There is one line in the following guide [3] from which is wrong:

sudo mksquashfs edit extract-cd/casper/filesystem.squashfs -nolzma

SHOULD BE

sudo mksquashfs edit extract-cd/casper/filesystem.squashfs -nolzma -no-sparse

1) Follow the instructions from [4] for both Cleanup and and Putting the CD together.