Difference between revisions of "Building the Live CD"

From EPrints Documentation
Jump to: navigation, search
(This page is out of date. Docker is more relevant nowadays so just redirect straight to this page.)
(Tag: New redirect)
Line 1: Line 1:
#REDIRECT [[Installing_EPrints_using_Docker]]
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
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:
$c->{roles}->{"live-cd-extras"} = [
      "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>
= 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
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.

Latest revision as of 21:33, 10 January 2022