Bootstrap script to build and upgrade the BitCurator ISO (Live and installation media)
Branch: master
Clone or download
Latest commit aac4502 Dec 15, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
attic Removed legacy refs from attic Mar 13, 2016
.gitignore Initial commit Jun 10, 2015
LICENSE Initial commit Jun 10, 2015
POSTINSTALL.txt Notes in postinstall Oct 22, 2016
README.md README update Dec 15, 2018
bc-bootstrap.sh Updated bootstrap Jun 2, 2018

README.md

bitcurator-bootstrap: Build, upgrade, and configuration scripts for the BitCurator Environment

GitHub issues GitHub forks

DEPRECATION NOTICE:

This repository has been deprecated, and is no longer actively maintained. Future releases of BitCurator will be created and maintained using SaltStack. You can find additional information in the current main repository (https://github.com/bitcurator/bitcurator-distro) and the Salt-based build tool repository (https://github.com/bitcurator/bitcurator-distro-salt).

Building the BitCurator environment

The bc-boostrap.sh shell script assists in building releases of the BitCurator environment. The script automates the majority of the process of preparing a clean Ubuntu 16.04.1LTS install for testing and respin as a BitCurator release.

This README includes basic information on how to use the script. We recommend that it is only used by developers or community members actively contributing to or maintaining the project. You may wish to visit https://github.com/bitcurator/bitcurator-distro-main/ for additional information on getting started.

Looking for the latest release? You can find it at our release portal:

https://github.com/BitCurator/bitcurator-distro/wiki/Releases

Installation

The bc-bootstap.sh script expects to find itself in a Ubuntu 16.04.1LTS environment. It has not been tested on any other versions of Ubuntu. The environment must have the git package installed to checkout this repository. When running in a VM, any extensions (for example, the VirtualBox extensions) should be installed prior to running this script.

Once you have a clean Ubuntu 16.04.1LTS environment running as a VM (or on a host), install dkms. You must perform this step in order for the VirtualBox extensions to be automatically built for all future kernels that may be automatically downloaded and installed by Ubuntu:

sudo apt-get install dkms

Now, install the VirtualBox extensions using the "Insert Guest Additions CD Image..." entry in the VirtualBox "Devices" menu.

To check out the code, make sure you have git installed. Enter the following in a terminal:

sudo apt-get install git
git clone https://github.com/bitcurator/bitcurator-bootstrap

To run, enter the following inside the bitcurator-bootstrap directory:

sudo ./bc-bootstrap.sh -s -i -y

This will tell the script to skin the environment, install all packages, and continue without prompting the user (even if failures are encountered).

The script should eventually terminate. You must run the command:

sudo reboot

and hit enter to reboot. Once the environment has rebooted, you should be logged in to a desktop that displays several BitCurator environment icons, the BitCurator logo as the background, and the write-blocking logo in the top right menu bar. If one or more of these things does not happen, something has gone wrong. You can review the bitcurator-install.log file in /home/bcadmin to determine where the failure may have occurred.

License(s)

The BitCurator logo, BitCurator project documentation, and other non-software products of the BitCurator team are subject to the the Creative Commons Attribution 4.0 Generic license (CC By 4.0).

Unless otherwise indicated, software items in this repository are distributed under the terms of the GNU General Public License, Version 3. See the text file "COPYING" for further details about the terms of this license.

In addition to software produced by the BitCurator team, BitCurator packages and modifies open source software produced by other developers. Licenses and attributions are retained here where applicable.