Upgrade to 1.x.x

From FOG Project
Revision as of 15:01, 15 January 2015 by Wolfbane8653.3362 (talk | contribs) (Direct Upgrade)
Jump to: navigation, search

Overview

NOTE: 1.x.x is a, nearly, complete rewrite from previous versions of FOG. There may be issues when upgrading from past revisions of FOG so please backup your installation before upgrading!

  • Migration for v0.32 to version v1.x.x will cause you to loose the operation system information that was associated with your hosts. This information has been moved to the image item now, so you will need to update all your images to set the appropriate operating system! Please see the Migration Instructions section below for more information.
  • Many successful upgrades from v0.32 have occurred. It is possible to upgrade from v0.1 all the way to v1.x.x.


  • All commands are assumed to be run as root. If you don't have access to root, prepend the installation with sudo (ex.
sudo svn co https://svn.code.sf.net/p/freeghost/code/tags/1.2.0 /opt/fog_1.2.0
sudo ./installfog.sh

Download

  • Three Download Methods currently exist:
  1. To get the Source from SVN
    • svn co https://svn.code.sf.net/p/freeghost/code/tags/1.2.0 /opt/fog_1.2.0
  2. To get tarball file.
    • wget http://sourceforge.net/projects/freeghost/files/latest/download
  3. Click to get tarball file

Methods

  • For Migration from Old Server 0.32 to a New Server 1.x.x --> Migration Upgrade (Requires 2 separate Servers)

Direct Upgrade

  • Requirements:
  1. Current server that has 0.32
  2. The new download from the Download section above

Prepare for install

  1. Change to the downloaded source installation folder.
    • cd /opt/fog_1.2.0/bin

Install

  1. Confirm your settings in .fogsettings UNLESS YOU HAVE TO MAKE CHANGES
    • Example: If you added a password to mysql you will need to confirm the settings there. Also, if you changed the default user.
  2. Begin installing.
    • ./installfog.sh

Post Install

  1. Go to the link you normally go to and you should notice the upgrade/install database screen. (http://<ip-address-of-FOG-Server/fog/management>/)
    • Click the Submit button and it should move on to say, Click here to login, once complete.
  2. Finish the install in the terminal window.

Migration Upgrade

  • Requirements
  1. Old Server with 0.32 installed
  2. New Server with your choice flavor of Linux
  • If using a VM please create a second VM to serve as the second server

Prepare for install

  • On the Old Server
  1. Backup old database
    • mysqldump --opt -u'root' [-p'passwordhere' #only if password set] fog > fog_backup.sql
    • NOTE: There is no space between -u and root also -p and password, also the name and password are wrapped with quotes. In the case a single quote is used in your password, replace the current single quotes with double quotes. If there is both a double and single quote (for whatever reason) in the password, you will need to escape the appropriate quote [ the one matching the quotes wrapping the entire field ] with a backslash (e.g. \ )
    • DO NOT tar ball or gz
  2. Save file to an easily up-loadable location
  • As far as the old server is concerned your done with this machine.

Install

  • On the New Server
  • Click below for step-by-step guides written for your favorite flavor of Linux:

Template:Installation

  1. Change to the downloaded source installation folder.
    • cd /opt/fog_1.2.0/bin

Post Install

  1. Go to the link you normally go to and you should notice the upgrade/install database screen. (http://<ip-address-of-FOG-Server/fog/management>/)
    • Click the Submit button and it should move on to say, Click here to login, once complete.
  2. Finish the install in the terminal window.
  3. Sign in into the FOG GUI with your normal user and password.
  4. Record ALL information on Config.pngFog Confiuration --> Fog Settings and Storage.pngStorage management pages
  5. Import old database backup fog_backup.sql on Config.png Fog Configuration --> Configuration Save
  6. Click Home.png HOME.
    • The upgrade/install database screen will reappear.
  7. Click the Submit button and it should move on to say, Click here to login, once complete.
  8. Edit any settings in the Config.png Fog Configuration --> Fog Settings page that may have changed from the server move (ip, paths, etc) that you recorded from the Config.png Fog Configuration --> Fog Settings page and Storage.pngStorage Management pages
  9. Finish the install in the terminal window.
  10. Dispose of Old Server properly

Operating System Information

  • As the hostOS column has been moved to the images table rather than the hosts table, you need to specify the Operating system of the images currently on your system.
  • To do so, login to the FOG GUI and navigate to the Images.pngImage Management Page. Click on each of your images and set the OSID accordingly.

Change your DHCP Option 67

  1. Go to your DHCP server and change your Option 67 from pxelinux.0 to undionly.kpxe (or other iPXE file)
    • Default undionly.kpxe (Other boot files include ipxe.kkpxe, ipxe.pxe, default.ipxe, ipxe.kpxe, undionly.pxe, pxelinux.0.old, undionly.kkpxe and even custom ones if you wish to create them)

Congratulations

  • You should now have an UPGRADED FOG server that will be able to perform all the tasks we've all come to know and love.