Building the Live CD - Revision history

Drn@ecs.soton.ac.uk: This page is out of date. Docker is more relevant nowadays so just redirect straight to this page.

2022-01-10T21:33:27Z

This page is out of date. Docker is more relevant nowadays so just redirect straight to this page.

Pm705 at 12:49, 20 March 2010

2010-03-20T12:49:37Z

Pm705 at 13:43, 8 February 2010

2010-02-08T13:43:44Z

Af05v@ecs.soton.ac.uk: /* Backup and Restore Plugins */

2008-11-11T12:48:29Z

‎Backup and Restore Plugins

Af05v@ecs.soton.ac.uk: /* Backup and Restore Plugins */

2008-11-11T12:46:21Z

‎Backup and Restore Plugins

Af05v@ecs.soton.ac.uk: /* Allowing Admin user to edit conf files */

2008-11-11T12:46:07Z

‎Allowing Admin user to edit conf files

DaveTarrant: Building the Live CD

2008-09-24T12:54:07Z

Building the Live CD

New page

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:
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 [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.

← Older revision		Revision as of 21:33, 10 January 2022
Line 1:		Line 1:
−	~~[[Category:Staff]]~~	+	#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 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.~~

← Older revision		Revision as of 12:49, 20 March 2010
Line 1:		Line 1:
−	~~[[Category:Howto]]~~
	[[Category:Staff]]		[[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.		This page is designed as a HOW-TO on building the LiveCD for the development team, if you find it useful then great.

← Older revision		Revision as of 13:43, 8 February 2010
Line 1:		Line 1:
		+	[[Category:Howto]]
		+	[[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.		This page is designed as a HOW-TO on building the LiveCD for the development team, if you find it useful then great.

@@ Line 55: / Line 55: @@
 ) Download the Backup and Restore plugins from the SVN to their place in the EPrints tree (Plugin/Screen/Admin)
-) Add the following to lib/lang/en/phrases/system.xml (committed in 3.2)
+) Add the following to a new file lib/lang/en/phrases/backup.xml (committed in 3.2)
- <!-- Backup / Restore Admin Screen -->
- <epp:phrase id="Plugin/Screen/Admin/Backup:action:backup_repository:title">Backup Repository</epp:phrase>
+<?xml version="1.0" encoding="iso-8859-1" standalone="no" ?>
- <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>
+<!DOCTYPE phrases SYSTEM "entities.dtd">
- <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: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/Restore:backup_archive">Backup archive file:</epp:phrase>
+  <epp:phrase id="Plugin/Screen/Admin/Backup:action:backup_repository:title">Backup Repository</epp:phrase>
    <epp:phrase id="Plugin/Screen/Admin/Restore:upload">Upload</epp:phrase>
 = Building the CD =

@@ Line 42: / Line 42: @@
+  #
   # Just add this to the end:
-     edit-pl-config
+     live-cd-extras
   }],
-  $c->{roles}->{"edit-pl-config"} = [
+  $c->{roles}->{"live-cd-extras"} = [
         "config/edit/perl",
   ];