Difference between revisions of "Getting FOG"

From FOG Project
Jump to: navigation, search
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
Related Article: [[Upgrade_to_trunk]]
 +
 
= Read First =
 
= Read First =
  
 
* If you have a multi-node setup, they all need to be on the same version of FOG. Start by updating the master/web server, then update all your nodes.
 
* If you have a multi-node setup, they all need to be on the same version of FOG. Start by updating the master/web server, then update all your nodes.
* If your fog server is in a VM, snapshot/checkpoint it first.
+
* If updating a VM, snapshot/checkpoint it first.
* Backup your database first via: <font color="red">Web GUI -> FOG Configuration -> Configuration Save -> Export Database -> Export</font>
+
* If updating, backup your database first via: <font color="red">Web GUI -> FOG Configuration -> Configuration Save -> Export Database -> Export</font>
  
  
Line 14: Line 16:
  
 
The preferred method of getting FOG is via GIT. [https://en.wikipedia.org/wiki/Git Read about git here.]  First you'll need to install git onto your chosen Linux server. There's a couple ways to do this below.
 
The preferred method of getting FOG is via GIT. [https://en.wikipedia.org/wiki/Git Read about git here.]  First you'll need to install git onto your chosen Linux server. There's a couple ways to do this below.
 +
  
 
== Install GIT on Debian or Ubuntu ==
 
== Install GIT on Debian or Ubuntu ==
Line 21: Line 24:
 
apt-get -y install git
 
apt-get -y install git
 
</pre>
 
</pre>
 +
  
 
== Install GIT on CentOS 7 or RHEL 7 ==
 
== Install GIT on CentOS 7 or RHEL 7 ==
Line 28: Line 32:
 
yum -y install git
 
yum -y install git
 
</pre>
 
</pre>
 +
  
 
== Install GIT on CentOS 8, RHEL 8, or Fedora ==
 
== Install GIT on CentOS 8, RHEL 8, or Fedora ==
Line 35: Line 40:
 
dnf -y install git
 
dnf -y install git
 
</pre>
 
</pre>
 +
  
 
= Getting FOG =
 
= Getting FOG =
Line 46: Line 52:
 
cd fogproject
 
cd fogproject
 
</pre>
 
</pre>
 +
  
 
= Using the desired FOG branch =
 
= Using the desired FOG branch =
  
If you want to use the master branch, skip to the next section. If you'd like to use the dev-branch, use this command:
+
If you want to use the master branch (latest stable release), skip to [[Getting_FOG#Running_the_installer]].  
 +
 
 +
If you'd like to use the dev-branch, use this command:
  
 
<pre>
 
<pre>
Line 67: Line 76:
 
git pull
 
git pull
 
git checkout master
 
git checkout master
 +
git pull
 
</pre>
 
</pre>
  
Line 78: Line 88:
 
./installfog.sh
 
./installfog.sh
 
</pre>
 
</pre>
 +
  
 
= Installation arguments =
 
= Installation arguments =

Latest revision as of 13:30, 7 February 2018

Related Article: Upgrade_to_trunk

Read First

  • If you have a multi-node setup, they all need to be on the same version of FOG. Start by updating the master/web server, then update all your nodes.
  • If updating a VM, snapshot/checkpoint it first.
  • If updating, backup your database first via: Web GUI -> FOG Configuration -> Configuration Save -> Export Database -> Export


FOG has branches

What's a branch? In development terms, a branch is different states of the code. The developers of FOG keep the latest stable version in the master branch. Release candidates are kept in dev-branch and often you will be asked to try this branch to overcome some problem. The latest changes to FOG are kept in the working branch. These latest changes may have broken something but generally the working branch is workable.


Installing GIT

The preferred method of getting FOG is via GIT. Read about git here. First you'll need to install git onto your chosen Linux server. There's a couple ways to do this below.


Install GIT on Debian or Ubuntu

sudo -i
apt-get -y install git


Install GIT on CentOS 7 or RHEL 7

sudo -i
yum -y install git


Install GIT on CentOS 8, RHEL 8, or Fedora

sudo -i
dnf -y install git


Getting FOG

Now that GIT is installed, you should be able to clone the FOG repository. Generally we recommend to put the repository inside of /root but if you've done this sort of thing before, put it wherever you want. Here's how we clone FOG:

sudo -i
cd /root
git clone https://github.com/FOGProject/fogproject.git
cd fogproject


Using the desired FOG branch

If you want to use the master branch (latest stable release), skip to Getting_FOG#Running_the_installer.

If you'd like to use the dev-branch, use this command:

git checkout dev-branch

If you would like to use the working branch, use this command:

git checkout working

To go back to master at a later date, always update your repository via the git pull command like this:

sudo -i
cd /root/fogproject
git pull
git checkout master
git pull

Running the installer

To start the installation process, you would follow the below steps. Running the installer must be done as root.

sudo -i
cd /root/fogproject/bin
./installfog.sh


Installation arguments

The FOG installer has installation arguments available. You can get them all by using this command with the installer:

./installfog.sh --help

If you wanted the installer to 'just go' and use all defaults, use this command:

./installfog.sh -y

If you want the installer to follow a configuration with the -y argument, just create a .fogsettings file ahead of time and put it here: /opt/fog/.fogsettings You can copy another server's file but will need to update the IP settings. Here's a writeup on the fogsettings file: .fogsettings