Editing Groovix Installation Guide

__TOC__


== Re-Installing Groovix ==
If a machine already has Groovix installed but the filesystem has possibly been corrupted, you can easily re-install Groovix from a USB drive or from the orignal installation files stored on the first partition of the hard drive.  

You can start a hard-drive based re-install from the ctrl-alt-g Groovix Admin Menu, or from the command line (terminal or ssh) using this command:

<code>groovix-auto-re-install</code>

This will reboot the computer and perform a fully automatic installation, preserving network and Groovix label/type/site settings.  A re-install can take 15 minutes to an hour depending on hard drive speed.

== Booting Groovix ==

'''USB Flash Drive'''<br />
You may use a bootable USB Flash Drive to install Groovix if your hardware supports USB booting.  To create a bootable USB drive from a Groovix .iso image see: http://wiki.groovix.org/index.php?title=CreatingBootableUsb

After preparing the USB drive, insert the USB Flash drive containing the Groovix software into a USB port your machine and power it on. Depending on your machine and its boot settings, it may be necessary to manually prompt your workstation to boot from USB devices; to do this, press the key indicated to '''enter setup''' or '''boot menu''' of your workstation's BIOS. BIOS information is usually displayed at the bottom of the screen immediately after the computer is powered on.  

If you have the option, choose '''boot menu''', this will display all the devices that the workstation can boot from; choose USB Device. If the only option available is '''enter setup''', find the option to configure the '''boot order''' or '''boot priority''' and change USB devices to be first in the list and exit the BIOS saving your changes.


<div style="float: left;">
[[File:BIOS-Screen-1.jpg|frame| An example of BIOS setup and boot options]]
</div><div style="clear: left;"></div>

Once you have successfully booted from your choice of media, you will see a menu with a list of options for booting Groovix similar to the one pictured below.

<div style="float: left;">
[[File:Boot-Menu-1.jpg|thumb|600px| The Groovix boot menu]]
</div>
<div style="clear: left;"></div>

Use the up and down arrows on your keyboard to select one of the options, if you do not hit any keys with 60 seconds, the computer will begin booting normally from the hard drive. Continue reading below to determine which option of running Groovix is best for your needs.

== Boot from next volume ==
The computer will try to boot normally from the hard drive.

== Groovix Fully Automatic Install ==
Choose this option to perform a new install or re-install groovix over the existing installation.  It will try to automatically determine settings from the existing install on the hard drive, i.e. the groovix label ( computer name ), and groovix types like adult, catalog, etc.
* An automatically assigned DHCP network address will be used, see [[InstallationDHCP]]

== Groovix Fully Automatic Clean Install ==
Choose this option to re-install groovix over an existing installation without preserving any parameters from the existing installation.
* An automatically assigned DHCP network address will be used, see [[InstallationDHCP]]

== Groovix Fully Automatic Clean Static IP install ==
If you are unsure if you should use a static IP address, you probably shouldn't! If you can't get a network connection please contact your system administrator.
* See [[StaticIP]] for installing Groovix '''with''' an assigned or static IP address

== Groovix Live ==
The Groovix Live option allows you to try Groovix without making any changes to your current workstation; you can revert your workstation back to its regular configuration at any time by rebooting the machine. 

The Groovix PAC Live option is also useful to troubleshoot and fix a Groovix workstation that will not boot properly. Once logged in, you can connect to Groovix Tech Support from the [[Groovix Menu]].