Upgrade to 1.x.x

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 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
   • http://sourceforge.net/projects/freeghost/files/FOG/fog_1.2.0/fog_1.2.0.tar.gz/download

Methods

• For Direct upgrade from 0.32 to 1.x.x --> Direct

• For Migration from Old Server 0.32 to a New Server 1.x.x --> Migration

Direct Upgrade

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.

• Continue to Operating_System_Information

Migration

Prepare for install

1. Backup old database

   • mysqldump --opt -u root -p [mysqlpassword-default-blank] fog > fog_backup.sql

   • NOTE: There is no space between -u and root also -p and password
   • DO NOT tar ball or gz
2. Change to the downloaded source installation folder.

   • cd /opt/fog_1.2.0/bin

3. Begin as if you're installing.

Install

• On the new server install Linux
• Click below for step-by-step guides written for your favorite flavor of Linux:

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 Fog Confiuration --> Fog Settings and Storage management pages
5. Import old database backup fog_backup.sql on Fog Configuration --> Configuration Save
6. Click 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 Fog Configuration --> Fog Settings page that may have changed from the server move (ip, paths, etc) that you recorded from the Fog Configuration --> Fog Settings page and Storage Management pages
9. Finish the install in the terminal window.

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 Image 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.