Chad-bisd: Added overview and section header for installation

2012-07-30T04:59:55Z

Added overview and section header for installation

New page

== Overview ==
An existing network is assumed to have DHCP and DNS services already functioning on separate server(s), as well as full Internet connectivity. Changes will have to be made on the DHCP server to forward PXE traffic to the FOG server. See [[Modifying existing DHCP server to work with FOG]] for assistance with this setting.

'''Note:''' The FOG installation makes several queries to resources on the Internet. The server must be connected to the Internet during the initial installation.
== Installation ==
<ol>
<li>Install the base OS and set a static IP address for this server</li>
<li>Connect to the Internet and update the base OS</li>
<li>[[FOGUserGuide#Installing_FOG|Install FOG]]
<ol>
<li><tt>What type of installation would you like to do? [N] n</tt> 
Choose Normal. Read the on-screen explanation for details.</li> 
<li><tt>What is the IP address to be used by this FOG Server? [current address]</tt> 
Your server's current Internet address is pre-filled. Just press enter to accept it.</li> 
<li><tt>Would you like to setup a router address for the DHCP server? [Y/n] Y</tt> 
We assumed there is already exists a DHCP server, so choose yes.</li> 
<LI><tt>What is the IP address to be used for the router on the DHCP server? [preFilled?] type.your.DHCP.address</tt> 
Enter the IP address of your network's DHCP server. FOG may have filled this in automatically.</li> 
<li><tt>Would you like to setup a DNS address for the DHCP server and client boot image? [Y/n] y</tt> 
Enter the IP address of your network's DNS server. FOG may have filled this in automatically.</li> 
<li><tt>What is the IP address to be used for DNS on the DHCP server and client boot image? [preFilled?] type.your.DNS.address</tt> 
Enter the IP address of your network's DHCP server. FOG may have filled this in automatically.</li> 
<li><tt> Would you like to change the default network interface from eth0? 
: If you are not sure, select No. [y/N] n</tt>
This would allow us to have multiple network cards. This is beyond the scope of this simple guide.</li> 
<li><tt>Would you like to use the FOG server for dhcp service? [Y/n] n</tt> 
No. DHCP addresses will be provided by the infrastructure's DHCP server. Having multiple DHCP servers on a single network causes a race condition for the clients, and potentially conflicting IP addresses if they are issuing out addresses within the same range.</li> 
<pre> DHCP will not be setup but you must setup your
current DHCP server to use FOG for pxe services.

On a Linux DHCP server you must set:
next-server

On a Windows DHCP server you must set:
option 066 & 067</pre>
Noted. Be sure to work with the DHCP admins to get PXE services forwarding to your FOG server. See [[FOGUserGuide#Modifying_existing_DHCP_server_to_work_with_FOG|Modifying existing DHCP server to work with FOG]] for assistance with this.</li> 
<li><tt> This version of FOG has internationalization support, would you like to install the additional language packs? [Y/n]</tt> 
Choose Yes if you'd like to install additional languages</li> 

<li><pre> #####################################################################

FOG now has everything it needs to setup your server, but please
understand that this script will overwrite any setting you may
have setup for services like DHCP, apache, pxe, tftp, and NFS.

It is not recommended that you install this on a production system
as this script modifies many of your system settings.

This script should be run by the root user on Fedora, or with sudo on Ubuntu.

Here are the settings FOG will use:
Distro: Ubuntu
Installation Type: Normal Server
Server IP Address: your.FOG.server.address
DHCP router Address: your.DHCP.address
DHCP DNS Address: your.DNS.address
Interface: eth0
Using FOG DHCP: 0
Internationalization: 1

Are you sure you wish to continue (Y/N) y</pre>
If it all looks good, enter Y</li> 
<li><pre>
Installation Started...

Installing required packages, if this fails
make sure you have an active internet connection.

* Preparing apt-get
* Installing package: apache2
...
...
...</pre>The install continues... 
The following message is displayed:<pre> * Installing package: mysql-server

We are about to install MySQL Server on
this server, if MySQL isn't installed already
you will be prompted for a root password. If
you don't leave it blank you will need to change
it in the config.php file located at:

/var/www/fog/commons/config.php

Press enter to acknowledge this message.
</pre></li>
<li>Choose a root password for your MySQL service. Take note of the file name above as it will have to be edited post-install.</li> 

<li><tt> Send notification? (Y/N)y </tt>
::<tt> * Thank you, sending notification...</tt> 
In one person's experience, this step freezes more often than not. If you choose Yes and it takes longer than a few seconds, it is likely frozen.
Here is a solution: [[Thank_you,_sending_notification]]</li> 
</ol>
The Installation script is complete:
<pre>Done

Setup complete!

You still need to install/update your database schema.
This can be done by opening a web browser and going to:

http://192.168.1.5/fog/management

Default User:
Username: fog
Password: password

$</pre></li>
</ol>
==Updating config files for non-empty MySQL root password==
{{Updating config files for non-empty MySQL root password}}

Integrating FOG into an Existing Network - Revision history

Chad-bisd: Added overview and section header for installation