Difference between revisions of "Upgrade to trunk"

From FOG Project
Jump to: navigation, search
m
(Additional information on SVN and git & FOG Trunk)
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<noinclude>=Methods=
+
<noinclude>= Methods =</noinclude>
*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.</noinclude>
+
* To get the very latest version of FOG you need to follow the below instructions.
**'''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]])
 
  
 +
* 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]])
  
==SVN==
+
= Git =
*Install as seen in '''[[SVN]]'''
+
* Update and then Install git (or 'yum' instead of 'apt-get' if you are running a RedHat based OS)
<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:
 
 
 
<pre>sudo /some/local/folder/bin/./installfog.sh</pre>
 
 
 
===Update to latest===
 
<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"
 
 
 
===Check your SVN version===
 
<pre>
 
cd  /some/local/folder/
 
svn log -v
 
</pre>
 
 
 
=== Upgrade to specific revision ===
 
 
 
This is recommended only for experienced FOG users: [[Upgrade to Revision]]
 
 
 
 
 
----
 
 
 
==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 59: Line 32:
 
</pre>
 
</pre>
  
=== Check your git version ===
+
== Check your git version ==
<pre>
 
cd /some/local/folder
 
git log -1
 
</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>
 
<pre>
Fog Read only Secret: BAU3NUY3XTKVMHHEZO6C7OH55AN2PCGJV
+
cd /root/fogproject
 +
git log -1<noinclude>
 
</pre>
 
</pre>
  
*Create the location that you want to have synced.
 
  
<pre>
 
sudo mkdir /fog
 
sudo chrmod 777 /fog
 
</pre>
 
 
*Install BTsync:
 
 
<pre>
 
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
 
 
<pre>
 
Add Folder:
 
Secret: BAU3NUY3XTKVMHHEZO6C7OH55AN2PCGJV
 
Path: /fog
 
</pre>
 
 
*Then <u>'''Any time'''</u> you see an update. Open up your terminal:
 
 
<pre>
 
cd /fog/bin/
 
sudo ./installfog.sh
 
</pre>
 
And you are updated quite quickly!
 
 
 
~Sources: [http://askubuntu.com/questions/284683/how-to-run-bittorrent-sync,[AskUbuntu]]
 
----
 
 
==wget==
 
<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 =
 
= 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.
 
* 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.
+
* 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 =
 
 
 
 
 
Subversion (often abbreviated SVN, after the command name svn) is a software package that allows you to 'check out' software. SVN in and of itself is not FOG, but a lot of FOG users use it. It's provided by [http://sourceforge.net/ SourceForge]. Git allows the same general functions as svn and is provided by [https://github.com/ GitHub]. Either method is as valid as the other, albeit the commands are different for each.  
 
  
 +
= 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'''
 
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.
 
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'''!
 
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.
 
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.
Line 148: Line 57:
 
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:
 
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
+
* FOG Configuration -> Configuration Save -> Export
 
+
* Host Management -> Export Hosts -> Export
*Host Management -> Export Hosts -> Export
 
 
 
  
 
You may install FOG Trunk on a server that does not have FOG installed already.
 
You may install FOG Trunk on a server that does not have FOG installed already.
  
 
+
= Check what version you're running =
== Check what version you're running ==
 
  
 
On your FOG's web GUI login page, you can quickly check what revision you're running:
 
On your FOG's web GUI login page, you can quickly check what revision you're running:
  
 
[[File:FOG Revision in cloud.png]]
 
[[File:FOG Revision in cloud.png]]
 
+
= Video Tutorials =
== Video Tutorials ==
+
</noinclude>
 
+
<includeonly>==== Video Tutorials ====</includeonly>
 
 
  
 
<font color="red">Note:</font> Video plays in Chrome or Firefox with html5 plugin
 
<font color="red">Note:</font> Video plays in Chrome or Firefox with html5 plugin
  
 
+
External video link: [https://youtu.be/4XtY70nCg_A FOG upgrade to trunk - Git method ]
External Video Link: [https://youtu.be/1QSOLib22n4 FOG Upgrade To Trunk - SVN Method ]
 
 
 
Video:
 
 
 
<embedvideo service="youtube">https://youtu.be/1QSOLib22n4</embedvideo>
 
 
 
 
 
 
 
External Video Link: [https://youtu.be/joXmkJHG274 FOG Upgrade Existing SVN Trunk-Repo  ]
 
 
 
Video:
 
 
 
<embedvideo service="youtube">https://youtu.be/joXmkJHG274</embedvideo>
 
 
 
 
 
 
 
 
 
External Video Link: [https://youtu.be/4XtY70nCg_A FOG Upgrade To Trunk - Git Method ]
 
 
 
Video:
 
  
 
<embedvideo service="youtube">https://youtu.be/4XtY70nCg_A</embedvideo>
 
<embedvideo service="youtube">https://youtu.be/4XtY70nCg_A</embedvideo>
  
 
+
External video link: [https://youtu.be/nlYWhjkjPR8 FOG upgrade existing Git repo ]
 
 
External Video Link: [https://youtu.be/nlYWhjkjPR8 FOG Upgrade Existing Git Trunk-Repo ]
 
 
 
Video:
 
  
 
<embedvideo service="youtube">https://youtu.be/nlYWhjkjPR8</embedvideo>
 
<embedvideo service="youtube">https://youtu.be/nlYWhjkjPR8</embedvideo>

Revision as of 01:39, 30 December 2016

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