Difference between revisions of "Upgrade to trunk"

From FOG Project
Jump to: navigation, search
 
(46 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Methods=
+
Related Article: [[Getting_FOG]]
*There are a few methods to update to the most resent revision. Each method has its pros so, you will need to figure out which you will use.
 
**'''SVN'''
 
**'''Git'''
 
**'''BTSync'''
 
**'''wget'''
 
*Remember these are mostly betas so there are bound to be bugs, but with bugs also comes fixes of the issues found in the "Stable Release"
 
*If you have nodes they will also need to be upgraded! (Excluding Beta [[Windows_Storage_Node | Windows Nodes]])
 
  
 +
<noinclude>= Methods =</noinclude>
 +
* To get the very latest version of FOG you need to follow the below instructions.
  
==SVN==
+
* Remember these are mostly betas so there are bound to be bugs, but with bugs also comes fixes of the issues found in the "Stable Release"
*Install as seen in '''[[SVN]]'''
+
* If you have nodes they will also need to be upgraded! (Excluding Beta [[Windows_Storage_Node | Windows Nodes]])
<pre>svn co https://svn.code.sf.net/p/freeghost/code/trunk /some/local/folder</pre>
 
  
*Then navigate to the folder you specified and run:
+
= Git =
 
+
* Update and then Install git (or 'yum' instead of 'apt-get' if you are running a RedHat based OS)
<pre>sudo /some/local/folder/bin/./installfog.sh</pre>
 
 
 
====Update from prior downloaded SVN====
 
<pre>cd  /some/local/folder/
 
svn up
 
cd bin
 
./installfog.sh</pre>
 
 
 
*''NOTE:'' You must run '''svn up''' in the "/some/local/folder/" and not in ".../fog/bin" nor in ".../fog"
 
 
 
 
 
----
 
==Git==
 
 
 
*Install Git
 
  
 
<pre>
 
<pre>
sudo apt-get install git
+
sudo apt-get update && apt-get install git
 
</pre>
 
</pre>
  
*Initial Setup
+
* Initial checkout and installation
 
<pre>
 
<pre>
git clone https://github.com/FOGProject/fogproject.git /some/local/folder
+
sudo -i
 +
git clone https://github.com/FOGProject/fogproject.git /root/fogproject
 +
cd /root/fogproject
 +
git checkout dev-branch
 +
cd bin
 +
./installfog.sh
 
</pre>
 
</pre>
  
*Update to latest
+
== Update to latest ==
 +
As the development tree of FOG changes quiet often (pretty much daily!) you might want to update to the very latest version from time to time. To do this use the following commands:
 
<pre>
 
<pre>
cd /some/local/folder
+
cd /root/fogproject
 +
git checkout dev-branch
 
git pull
 
git pull
 
cd bin
 
cd bin
Line 48: Line 34:
 
</pre>
 
</pre>
  
*Check your git version
+
== Check your git version ==
 +
 
 
<pre>
 
<pre>
cd /some/local/folder
+
cd /root/fogproject
git log -1
+
git log -1<noinclude>
 
</pre>
 
</pre>
  
----
 
  
==BTSync==
 
*If you want the latest, get on the BTsync :) You could have changes within 20-30 seconds of them being made.
 
**'''NOTE:''' as of 2901 the kernels are no longer synced using BTSync. They auto download when installing the fog script.
 
<pre>
 
Fog Read only Secret: BAU3NUY3XTKVMHHEZO6C7OH55AN2PCGJV
 
</pre>
 
  
*Create the location that you want to have synced.
+
= Congratulations =
 +
* Congrats! You have now upgraded to the "bleeding edge" of FOG deployment. It is your responsibility to keep upgraded until the next "Stable Release". Until then you will see in the ''cloud'' of your ''Web Gui'' '''rXXXX'''. This indicates the revision you are now on.
 +
* You can check for updates to the revisions under [[File:1.3.0 fog configuration.png]] '''Fog Configuration'''. This will state the version you are on and what the lastest revision is.
 +
 
 +
= Additional information on SVN and git & FOG Trunk =
 +
 
 +
FOG developmental versions are called "revisions." Revisions are normally stable for the PRIMARY functions of FOG: '''IMAGE > NAME > JOIN TO DOMAIN using UNICAST and MULTICAST'''
 +
 
 +
Other features in FOG revisions (not directly related to the imaging process) '''are sometimes broken'''. The developers are pretty good about fixing issues when someone finds and reports it. These other features usually do not impact imaging. Additionally, if you encounter an issue, let us know about it in the [https://forums.fogproject.org/ forums] and someone is likely to help and/or fix it quickly, making a new "revision" that you can download and install very quickly using the above methods.
 +
 
 +
However, with the current revisions, you'll benefit from a '''plethora of bug fixes''', a much '''wider range of supported host hardware''', and '''new features'''!
 +
 
 +
Updating FOG from one revision to a newer one usually takes less than a minute or two. Fog uses your settings from previous installations so you don't have to answer questions about the installation or set additional configurations. '''FOG supports upgrading, but not downgrading'''. If you would like to roll-back to a previous version, generally, this can only be done by reverting to a previous snap-shot taken from a virtualized machine that FOG is installed on.
  
<pre>
+
It's advised to backup your database and export your hosts (and label the files) prior to upgrading. You can do that like this on 1.2.0 and higher:
sudo mkdir /fog
 
sudo chrmod 777 /fog
 
</pre>
 
  
*Install BTsync:
+
* FOG Configuration -> Configuration Save -> Export
 +
* Host Management -> Export Hosts -> Export
  
<pre>
+
You may install FOG Trunk on a server that does not have FOG installed already.
sudo add-apt-repository ppa:tuxpoldo/btsync
 
sudo apt-get update
 
sudo apt-get install btsync
 
cd Downloads
 
tar xzpf btsync_i386.tar.gz (I have downloaded 32 bit. So check your version)
 
./btsync
 
</pre>
 
  
*Open a webpage: <IP Address>:8888
+
= Check what version you're running =
  
<pre>
+
On your FOG's web GUI login page, you can quickly check what revision you're running:
Add Folder:
 
Secret: BAU3NUY3XTKVMHHEZO6C7OH55AN2PCGJV
 
Path: /fog
 
</pre>
 
  
*Then <u>'''Any time'''</u> you see an update. Open up your terminal:
+
[[File:FOG Revision in cloud.png]]
 +
= Video Tutorials =
 +
</noinclude>
 +
<includeonly>==== Video Tutorials ====</includeonly>
  
<pre>
+
<font color="red">Note:</font> Video plays in Chrome or Firefox with html5 plugin
cd /fog/bin/
 
sudo ./installfog.sh
 
</pre>
 
And you are updated quite quickly!
 
  
 +
External video link: [https://youtu.be/4XtY70nCg_A FOG upgrade to trunk - Git method ]
  
~Sources: [http://askubuntu.com/questions/284683/how-to-run-bittorrent-sync,[AskUbuntu]]
+
<embedvideo service="youtube">https://youtu.be/4XtY70nCg_A</embedvideo>
----
 
  
==wget==
+
External video link: [https://youtu.be/nlYWhjkjPR8 FOG upgrade existing Git repo ]
<pre>
 
wget --no-check-certificate http://mastacontrola.com/fog_trunk.tar.bz2
 
</pre>
 
*Once downloaded you'll need to unpack the bz2 file using the command:
 
<pre>
 
tar -xjf fog_trunk.tar.bz2
 
</pre>
 
*Then go into the unextracted file.  Follow these steps:
 
<pre>
 
  cd fog_trunk/bin
 
  ./installfog.sh
 
</pre>
 
  
= Congratulations =
+
<embedvideo service="youtube">https://youtu.be/nlYWhjkjPR8</embedvideo>
* Congrats! You have now upgraded to the "bleeding edge" of FOG deployment. It is your responsibility to keep upgraded until the next "Stable Release". Until then you will see in the ''cloud'' of your ''Web Gui'' '''rXXXX'''. This indicates the revision you are now on.
 
*You can check for updates to the revisions under [[File:Config.png]] '''Fog Configuration'''. This will state the version you are on and what the lastest revision is.
 

Latest revision as of 14:25, 16 December 2017

Related Article: Getting_FOG

Methods

  • To get the very latest version of FOG you need to follow the below instructions.
  • Remember these are mostly betas so there are bound to be bugs, but with bugs also comes fixes of the issues found in the "Stable Release"
  • If you have nodes they will also need to be upgraded! (Excluding Beta Windows Nodes)

Git

  • Update and then Install git (or 'yum' instead of 'apt-get' if you are running a RedHat based OS)
sudo apt-get update && apt-get install git
  • Initial checkout and installation
sudo -i
git clone https://github.com/FOGProject/fogproject.git /root/fogproject
cd /root/fogproject
git checkout dev-branch
cd bin
./installfog.sh

Update to latest

As the development tree of FOG changes quiet often (pretty much daily!) you might want to update to the very latest version from time to time. To do this use the following commands:

cd /root/fogproject
git checkout dev-branch
git pull
cd bin
./installfog.sh

Check your git version

cd /root/fogproject
git log -1<noinclude>


Congratulations

  • Congrats! You have now upgraded to the "bleeding edge" of FOG deployment. It is your responsibility to keep upgraded until the next "Stable Release". Until then you will see in the cloud of your Web Gui rXXXX. This indicates the revision you are now on.
  • You can check for updates to the revisions under 1.3.0 fog configuration.png Fog Configuration. This will state the version you are on and what the lastest revision is.

Additional information on SVN and git & FOG Trunk

FOG developmental versions are called "revisions." Revisions are normally stable for the PRIMARY functions of FOG: IMAGE > NAME > JOIN TO DOMAIN using UNICAST and MULTICAST

Other features in FOG revisions (not directly related to the imaging process) are sometimes broken. The developers are pretty good about fixing issues when someone finds and reports it. These other features usually do not impact imaging. Additionally, if you encounter an issue, let us know about it in the forums and someone is likely to help and/or fix it quickly, making a new "revision" that you can download and install very quickly using the above methods.

However, with the current revisions, you'll benefit from a plethora of bug fixes, a much wider range of supported host hardware, and new features!

Updating FOG from one revision to a newer one usually takes less than a minute or two. Fog uses your settings from previous installations so you don't have to answer questions about the installation or set additional configurations. FOG supports upgrading, but not downgrading. If you would like to roll-back to a previous version, generally, this can only be done by reverting to a previous snap-shot taken from a virtualized machine that FOG is installed on.

It's advised to backup your database and export your hosts (and label the files) prior to upgrading. You can do that like this on 1.2.0 and higher:

  • FOG Configuration -> Configuration Save -> Export
  • Host Management -> Export Hosts -> Export

You may install FOG Trunk on a server that does not have FOG installed already.

Check what version you're running

On your FOG's web GUI login page, you can quickly check what revision you're running:

FOG Revision in cloud.png

Video Tutorials

Note: Video plays in Chrome or Firefox with html5 plugin

External video link: FOG upgrade to trunk - Git method

External video link: FOG upgrade existing Git repo