.. ========================================================================== = = File: build_ubuntu_system.rst = Date: 6-May-2010 = Author: Hugh Secker-Walker = Description: Steps for creating an Ubuntu system = = This file is part of Onyx http://onyxtools.sourceforge.net = = Copyright 2010 The Johns Hopkins University = = Licensed under the Apache License, Version 2.0 (the "License"). = You may not use this file except in compliance with the License. = You may obtain a copy of the License at = http://www.apache.org/licenses/LICENSE-2.0 = = Unless required by applicable law or agreed to in writing, software = distributed under the License is distributed on an "AS IS" BASIS, = WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or = implied. See the License for the specific language governing = permissions and limitations under the License. = ========================================================================== Building an Ubuntu System ========================= In the following pages we describe the steps needed to *build* an Ubuntu system that can install, build, and work with Onyx. These steps are outlined in the context of a virtualized PC platform running in a VMware player, either VMware Fusion on the Mac, or VMware Player on Windows. The result is a 610 MB ZIP file containing a complete Ubuntu appliance that can be copied to any system with a VMware player. Once unpacked, the appliance can be run by the VMware player. The core steps for installing and configuring the Ubuntu system are also applicable to an installation of Unbuntu on real hardware. If you just wish to run such a system from an existing ZIP file, see these instructruction for :ref:`installing-the-ubuntu-vmware-appliance`. Prerequisites ------------- Get the latest `Ubuntu InstallationMinimalCD `_. This is a roughly 13 MB image for a bootable CD that handles configurations and other downloads to build a minimal Ubuntu server system. The 32-bit (x86) option will run on more platforms than the 64-bit option, so use the 32-bit version unless you are an expert and that know your target platform will run a 64-bit Linux system. The ISO image for the CD should be downloaded to a file, :file:`mini.iso`. You need some sort of PC platform with a network connection. The following instructions are written for a virtualized PC running under VMware Fusion on the Mac. It is believed the steps are comparable for a virtualized PC running under VMware Player on Windows, and by and large for users of real hardware. If you are using real hardware, it will need to have a network connection and a CD reader, and you should burn :file:`mini.iso` to a physical CD. You need access to a terminal application that can run the SSH protocol. This will let you login to the new system 'remotely' and avoid the rather limited console. Conventions ----------- In the following pages we describe the settings you must make in various dialoges. Actions for which you must patiently await completion are shown in *Italics* at the left margin. For configuration work, the name of the dialogue window appears **In bold** at the left margin. Indented from the window name is the name of the setting that's being made. Setting from a list or a button is shown *In italics*. A setting that you must type is shown ``In fixed-width font``.. Items in parentheses, if any, are descriptions about the settings or sub-dialogues you may go to. .. toctree:: :maxdepth: 2 build_ubuntu_vm.rst build_ubuntu_install.rst build_ubuntu_static_setup.rst build_ubuntu_dynamic_setup.rst build_ubuntu_packaging.rst