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)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
[[Category:Howto]]
+
#REDIRECT [[Installing_EPrints_using_Docker]]
[[Category:Staff]]
 
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.
 

Latest revision as of 21:33, 10 January 2022