Configuration on Fedora Workstation

FOG (r2922) Configuration on Fedora 21 Workstation inside Windows Server 2012 Hyper-V using ProxyDHCP

Notes: These instructions are intended to be followed IN ORDER.

Although these instructions were specifically written for r2922 & Fedora 21 (non-updated) inside Hyper-V using proxyDHCP, they might help a lot with other newer versions of Fedora; although these other versions have not been tested. These instructions should work fine if you're not using Hyper-V; maintaining that everything else remains the same.

Hyper-V machine settings

• 6 cores (don’t go below 4 cores)
• 4086 MB of non-dynamic ram.
• 512GB HDD (large size for storing the images on the v-machine)
• Ensure v-machine is connected to a working virtual switch (a working internet connection is required during the FOG software installation, or else it’ll fail every time).
• set Fedora 21 workstation ISO into the virtual optical drive.
• Everything else is default

Configuring existing DHCP server (Server 2012)

Inside your DHCP server, we have to set some options.

• IPv4 -> Scope -> Scope Options.
• Right click Scope Options.
• Enable 066 Boot Server Host Name, enter the FOG server’s IP.
• Enable 067 Bootfile Name, set it as

  undionly.kpxe

Installing Fedora 21

• Boot the V-Machine
• Install to Hard drive
• english & english -> next
• ‘Automatic partitioning selected’ is not optimal. Say you want to configure them on your own, and then click the “Make partitions automatically” on the left. From there, you can customize the mount points and their sizes.

Configuring your own partitions

• Create a directory called /images and give it as much space as you can. You don’t need to specify the size at first. You can create it and then change the size in the next screen.
• To give it over 400GB, you’ll need to reduce the “/home” and “/” directories. “/” only needs double the amount of ram the system has (8GB). “/home” only needs working space… 20 gigs should be ample.
• Network & Hostname: FOG (or whatever you like)
• Click “Begin Installation”
• Set root password to the Password, MAKE NOTE OF THIS (It must be longer than 8 characters and not a dictionary word, otherwise you’ll run into problems later).
• Make user & Password (I made one called Administrator with a lowercase ‘a’ for the username.)
• Check ‘Make this user administrator’
• Wait for Fedora to install….
• When install is complete, click Quit.
• Shutdown Fedora gracefully via the in-system power button. Then remove the ISO in the settings via Hyper-V.

Pre-Configuration of Fedora 21 for FOG

• boot, if given options, choose the non-emergency one.
• Log in as the user you created. (Administrator)
• On first login, choose english & then NEXT
• Standard English keyboard and NEXT
• Skip online accounts, “SKIP”
• click “Start using Fedora”
• Close “Getting Started” because were already started….
• OPEN THIS DOCUMENT on the FOG Machine! Lots of copy/pasting!

Disable Firewall and SELinux

• Click “Activities” in top left.
• Type “Terminal” (this is a lot like windows metro on a desktop, just type what you want)
• Switch to root with

  su root

• Enter password set during install
• Disable the firewall

systemctl disable firewalld.service

• Disable SELinux by editing /etc/selinux/config

  gedit /etc/selinux/config

Change the line

SELINUX=enforcing

to

SELINUX=disabled

• save and close.
• Reboot the machine.

CHECK SETTINGS SO FAR

• After reboot, verify that the firewall is off, and SELinux is off.
• log into your Administrator account, open terminal.
• Switch to root.

  su root

• Enter your password.

sestatus

should return ‘disabled’

systemctl status firewalld.service

should return “disabled” and “dead”.

• Don’t close terminal window, don’t exit ‘root’.

Set up a static IP address

• Click Activities
• type “settings”, the Settings icon should appear. Click it.
• Click Network
• Under the “wired” adapter, click the gear to set up custom settings.
• Click “IPv4”
• Enter in the IP you want to use, netmask, gateway, and DNS server information.
• Click “Apply”
• For settings to update, turn off the adapter and then turn it back on. (click the slide)
• Test by trying to visit Google with firefox. Confirm and close.

Setting Up Fog

• install svn

yum install svn

• Yes, you want to install

svn co -r 2922 https://svn.code.sf.net/p/freeghost/code/trunk /opt/fog_trunk

cd /opt/fog_trunk

cd bin

./installfog.sh

• Choose option 1 (because we are using Fedora)
• Choose the “normal server” because we want it to do everything (but dhcp)
• Hit enter to accept the currently assigned IP address.
• Router Address for the DHCP server -> optional. I said no. You’d need this if you were using the FOG server as a DHCP server.
• DNS address for the dhcp server ->optional. I said no. You’d need this if you were using the FOG server as a DHCP server.
• Change default network interface, NO!
• Use FOG server for DHCP service? NO!
• Install internationalization support? NO! (“yes” will break FOG running on Fedora)
• Donate computer resources? NO! (Unless you want to. See wiki information on how that works)
• Do you wish to continue? Yes!
• Fog installs…. wait…
• Make notes of ANY failed package installs…
• When it asks, the installer directory should be /images (we pre-made this during the Fedora install)
• Yes, you left the mysql password blank (it’s blank out of the box).
• Update the database schema by navigating to the provided link.
• Use a web browser. Address is: x.x.x.x/fog/management You don’t have to use Linux for this, use any computer’s web browser (any computer within your LAN).
• If it only works in Fedora, check Firewall and SELinux status.
• click “install/Upgrade Now”.
• wait for that to get done.
• Press enter in installer.

Setting up ProxyDHCP

Create /etc/dnsmasq.d/ltsp.conf using gedit

gedit /etc/dnsmasq.d/ltsp.conf

• type this stuff in there (or copy paste from this document)

port=0
log-dhcp
tftp-root=/tftpboot
dhcp-boot=undionly.kpxe
dhcp-option=17,/images
dhcp-option=vendor:PXEClient,6,2b
dhcp-no-override
pxe-prompt="Press F8 for boot menu", 3
pxe-service=X86PC, “Boot from network” undionly
pxe-service=X86PC, "Boot from local hard disk", 0
dhcp-range=x.x.x.x,proxy

• Where you see x.x.x.x, that should be your FOG server’s IP.

Necessary post install configuration

• Some required file manipulation and permission changes:
• Change the fog user’s password using

  passwd fog

• enter the Password
• Make a copy of the undionly file you want to use as undionly.0.

cd /opt/fog_trunk/packages/tftp

cp undionly.kpxe undionly.0

• Restart dnsmasq with

  service dnsmasq restart

• Create blank file to make Fog check directories

cd /

touch /images/.mntcheck

touch /images/dev/.mntcheck

• Edit the FTP settings file with

  gedit /etc/vsftpd/vsftpd.conf

• add this line to the bottom of the file:

  seccomp_sandbox=NO

• Save the file.Reboot server
• Set the FOG services to start 30 seconds after boot.
• Disable FOG services with:

systemctl disable FOG{MulticastManager,Scheduler,SnapinReplicator,ImageReplicator}

Create a startup script with

gedit /etc/rc.d/rc.local

• Make that file look like below, exactly.

#!/bin/bash
sleep 30
systemctl start FOGMulticastManager
systemctl start FOGScheduler
systemctl start FOGSnapinReplicator
systemctl start FOGImageReplicator
exit 0

• save the file
• Then Run this command to make that file executable:

  chmod +x /etc/rc.d/rc.local

FOG Configuration.

• go to the web interface using

  x.x.x.x/fog/management

• login (default is fog:password)
• Click “Storage Management” (network folder looking thing at top).
• Click “Default Member” in the list.
• Change management password to the linux fog user’s Password and then click “Update”.
• Click “Fog Configuration” (blue question mark at top).
• Click “Fog Settings” on left.
• Click “TFTP Server”
• Change Password to the right one.
• Click Save Changes
• If you have custom Multicast Settings (like address and port), click Multicast settings and put them in there, and then save the changes.

FOG Server Troubleshooting Help

TFTP Services

• Check TFTP status with

  systemctl status xinetd.service

  (should be on and green, no errors, and enabled)
• stop, start, disable and enable TFTP service.

systemctl stop xinetd.service

systemctl start xinetd.service

systemctl enable xinetd.service

systemctl disable xinetd.service

RPC Services

• Check the status of RPC with

  systemctl status rpcbind

  (should be on and green, no errors, and enabled)
• Stop, start, disable and enable RPC Service

systemctl stop rpcbind

systemctl start rpcbind

systemctl enable rpcbind

systemctl disable rpcbind

NFS Services

• Check the status of NFS with

  systemctl status nfs-server

  (should be on and green, no errors, and enabled)
• stop, start, disable and enable NFS service

systemctl stop nfs-server

systemctl start nfs-server

systemctl enable nfs-server

systemctl disable nfs-server

FTP Services

• Check the status of FTP with

  systemctl status vsftpd.service

  (should be on and green, no errors, and enabled)
• stop, start, disable and enable FTP service.

systemctl stop vsftpd.service

systemctl start vsftpd.service

systemctl disable vsftpd.service

systemctl enable vsftpd.service

• Test that it’s functioning by using a web browser and going to

  ftp://x.x.x.x

• Use fog / your-fog-account-Password for the credentials
• You should see “Index of /”

Firewall Service

• Check the status of the firewall with

  systemctl status firewalld.service

  (should be OFF, no errors, and disabled)
• stop, start, disable and enable FTP service.

systemctl stop firewalld.service

systemctl start firewalld.service

systemctl disable firewalld.service

systemctl enable firewalld.service

SELinux Service

• Check the status of SELinux with

  selinux

  (should be disabled)
• Disable/enable by editing using

  gedit /etc/selinux/config

  followed by a reboot.

FOGMulticastManager

• Check status with

  systemctl status FOGMulticastManager.service

  (Should be active, green lit, with no errors)
• Start, stop, disable, enable, restart by changing the “status” portion of that command to what you need.

FOGImageReplicator

• Check status with

  systemctl status FOGImageReplicator.service

  (Should be active, green lit, with no errors)
• Start, stop, disable, enable, restart by changing the “status” portion of that command to what you need.

FOGSnapinReplicator

• Check status with

  systemctl status FOGSnapinReplicator.service

  (Should be active, green lit, with no errors)
• Start, stop, disable, enable, restart by changing the “status” portion of that command to what you need.

FOGScheduler

• Check status with

  systemctl status FOGScheduler.service

  (Should be active, green lit, with no errors)
• Start, stop, disable, enable, restart by changing the “status” portion of that command to what you need.

Client CMOS Settings for auto-boot to network

Dell Optiplex 7010 CMOS configuration

• F12 while system is powered on.
• select “BIOS setup”
• General -> Boot Sequence
• “Onboard NIC” should be the first.
• System Configuration -> Integrated NIC
• “Enabled w/PXE” should be selected.

At this point, you should be done with major configuration.