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 [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:
   edit-pl-config
}],

$c->{roles}->{"edit-pl-config"} = [
      "config/edit/perl",
];

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 lib/lang/en/phrases/system.xml (committed in 3.2)

<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>

3) Add the role to the database for the admin user, typically:

 mysql -u root training;
 INSERT INTO user_roles VALUES(1,0,"+repository/backup");

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.