View source for Building the Live CD

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 [https://help.ubuntu.com/community/LiveCDCustomization] up until the customisations section.

= Stage 2 - Installing EPrints = 

1) If not already done follow the "Prepare and chroot" instructions at [https://help.ubuntu.com/community/LiveCDCustomization].

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 [https://help.ubuntu.com/community/LiveCDCustomization] 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 [https://help.ubuntu.com/community/LiveCDCustomization] for both Cleanup and and Putting the CD together.