Difference between revisions of ".fogsettings"

From FOG Project
Jump to: navigation, search
Line 1: Line 1:
 
In most versions of FOG (including 1.2.0 and 1.3.0), the low-level settings that are used during installation and some settings that simply cannot be stored in the database are contained in the /opt/fog/.fogsettings file.
 
In most versions of FOG (including 1.2.0 and 1.3.0), the low-level settings that are used during installation and some settings that simply cannot be stored in the database are contained in the /opt/fog/.fogsettings file.
  
 +
This file contains the setup of variables used within the installer during upgrades/installs.
 +
 +
An example .fogsettings file
 +
= Example .fogsettings file =
 +
<pre>
 +
## Start of FOG Settings
 +
## Created by the FOG Installer
 +
## Version: 7625
 +
## Install time: Sat 14 May 2016 08:05:18 PM EDT
 +
ipaddress='192.168.1.5'
 +
interface='eth0'
 +
submask='255.255.255.0'
 +
routeraddress='192.168.1.1'
 +
plainrouter='192.168.1.1'
 +
dnsaddress='192.168.1.1'
 +
dnsbootimage='192.168.1.1'
 +
username='fog'
 +
password='Some!random_Password\here0918358'
 +
osid='2'
 +
osname='Debian'
 +
dodhcp='N'
 +
bldhcp='0'
 +
dhcpd='isc-dhcp-server'
 +
blexports='1'
 +
installtype='N'
 +
snmysqluser=''
 +
snmysqlpass=''
 +
snmysqlhost=''
 +
installlang='0'
 +
donate='0'
 +
storageLocation='/images'
 +
fogupdateloaded=1
 +
docroot='/var/www/html/'
 +
webroot='fog/'
 +
caCreated='yes'
 +
startrange=''
 +
endrange=''
 +
bootfilename='undionly.kpxe'
 +
packages='apache2 php7.0 php7.0-json php7.0-gd php7.0-cli php7.0-curl mysql-server mysql-client tftpd-hpa tftp-hpa nfs-kernel-server vsftpd net-tools wget xinetd sysv-rc-conf tar gzip build-essential cpp gcc g++ m4 htmldoc lftp openssh-server php-gettext php7.0-mcrypt php7.0-mysql curl libc6 libcurl3 zlib1g php7.0-fpm libapache2-mod-php7.0 php7.0-mbstring'
 +
noTftpBuild=''
 +
notpxedefaultfile=''
 +
sslpath='/opt/fog/snapins/ssl/'
 +
backupPath='/home/'
 +
## End of FOG Settings
 +
</pre>
 
Here are what the settings in this file mean:
 
Here are what the settings in this file mean:
 
+
== Header/Footer ==
 +
=== Header ===
 +
Only gives some simplistic information to help users.
 +
Does no actions just gives some information.
 
<pre>
 
<pre>
 +
## Start of FOG Settings
 
## Created by the FOG Installer
 
## Created by the FOG Installer
## Version: 5167
+
## Version: 7625
## Install time: Sat 31 Oct 2015 12:34:56 PM CDT
+
## Install time: Sat 14 May 2016 08:05:18 PM EDT
 
+
</pre>
 
+
=== Footer ===
#I suppose this is where the kernel is pulled from during the PXE boot process?
+
Does no actions, just tells where FOG's default variables are setup
ipaddress="10.0.0.3";
+
Any new items will go below this, and you can add your own variables.
 
+
You can add variables wherever you want.
#This is the interface to use for multicasting, I think.
+
<pre>
interface="enp2s0";
+
## End of FOG Settings
 
+
</pre>
#subnet mask given out by DHCP.
+
== IP Address ==
submask="255.255.255.0";
+
Defines the IP address of the node/server.
 
+
This is also used on servers to setup the default.ipxe file.
#router interface to be given out via DHCP
+
<pre>
routeraddress="        option routers      10.0.0.1;";
+
ipaddress='192.168.1.5'
 
+
</pre>
#not sure what this is... seems like a duplicate of above.
+
== Interface ==
plainrouter="10.0.0.1";
+
This just sets the storage nodes/server interface as it will be stored in the Database.  This used to be used for multicast setups and for the bandwidth graph. This is now setup so it is only used on the bandwidth graph as we already know the ip address anyway. Multicast tasks can get their own interface instead of relying on user entry.
 
+
<pre>
#the DNS settings to give out via DHCP
+
interface='eth0'
dnsaddress="    option domain-name-servers     10.0.0.1; ";
+
</pre>
 
+
== Subnet Mask ==
#Not sure what this one is.
+
This defines the subnet mask to use if the system is to be used as a DHCP server.  It will assume the subnet mask of the interface being used, but can be changed later if you see fit.
dnsbootimage="10.0.0.1";
+
<pre>
 
+
submask='255.255.255.0'
#Not sure what this is.
+
</pre>
password='iIXhnFHzOzDK';
+
== Router Address ==
 
+
This will setup the router address to use if the system is to be used as a DHCP server. It currently only sets as an ip address, but in the past contained the whole dhcp configuration string. The config string was removed as it would only work on isc-dhcp-server, when some might be using dnsmasq or another dhcp server.
#The type of OS detected during installation, defines what OS Specific commands should be used during installation.
+
<pre>
osid="1";
+
routeraddress='192.168.1.1'
 
+
</pre>
#The detected OS type during installation.
+
== Plain Router ==
osname="Redhat";
+
Very similar to the Router Address elements above, but can be used to redirect to maybe another router/switch other than the main.
 
+
<pre>
#Whether or not to enable & start DHCP.
+
plainrouter='192.168.1.1'
dodhcp="N";
 
 
 
#Wether or not to build /etc/dhcp/dchpd.conf
 
bldhcp="0";
 
 
 
#Whether or not to build /etc/exports
 
blexports="1";
 
 
 
#Installation mode, either `N`ormal or `S`torage node.
 
installtype="N";
 
 
 
#The username for MySQL Access
 
snmysqluser=""
 
 
 
#The password for MySQL Access
 
snmysqlpass='';
 
 
 
#The IP or Hostname of the MySQL Server to use.
 
snmysqlhost="";
 
 
 
#Language support or not.
 
installlang="0";
 
 
 
#Donate by mining crypto-currency or not.
 
donate="0";
 
 
 
#The location to be used when building the /etc/exports file
 
storageLocation="/images";
 
 
 
#Not sure what this does...
 
fogupdateloaded="1";
 
 
 
#This is the credentials for local FTP Access, these are passed to clients when uploading so that the image can be moved from /images/dev to /images, I THINK this is this setting's only use.
 
storageftpuser="fog";
 
 
 
#See storageftpuser above.
 
storageftppass='iIXhnFHzOzDK';
 
 
 
#Where the web root is located. This varies from one distro to another.
 
docroot="/var/www/html/";
 
 
 
#The name of Fog's webroot.
 
webroot="fog/";
 
 
 
#Whether or not the certificate for THIS fog server has been created or not. I THINK ???
 
caCreated="yes";
 
 
 
#DHCP's starting IP for the range DHCP will give out.
 
startrange="10.0.0.10";
 
 
 
#DHCP's ending IP for the range DHCP will give out.
 
endrange="10.0.0.254";
 
 
 
#The default boot file to set in /etc/dhcp/dchpd/conf for use with DHCP.
 
bootfilename="undionly.kpxe";
 
 
 
#The packages that are to be installed / updated when the FOG Installer runs in the future.
 
packages=" httpd php php-cli php-common php-gd mysql mysql-server tftp-server nfs-utils vsftpd net-tools wget xinetd tar gzip make m4 gcc gcc-c++ lftp php-mysqlnd curl php-mcrypt php-mbstring mod_ssl php-fpm php-process";
 
 
</pre>
 
</pre>

Revision as of 18:35, 14 May 2016

In most versions of FOG (including 1.2.0 and 1.3.0), the low-level settings that are used during installation and some settings that simply cannot be stored in the database are contained in the /opt/fog/.fogsettings file.

This file contains the setup of variables used within the installer during upgrades/installs.

An example .fogsettings file

Example .fogsettings file

## Start of FOG Settings
## Created by the FOG Installer
## Version: 7625
## Install time: Sat 14 May 2016 08:05:18 PM EDT
ipaddress='192.168.1.5'
interface='eth0'
submask='255.255.255.0'
routeraddress='192.168.1.1'
plainrouter='192.168.1.1'
dnsaddress='192.168.1.1'
dnsbootimage='192.168.1.1'
username='fog'
password='Some!random_Password\here0918358'
osid='2'
osname='Debian'
dodhcp='N'
bldhcp='0'
dhcpd='isc-dhcp-server'
blexports='1'
installtype='N'
snmysqluser=''
snmysqlpass=''
snmysqlhost=''
installlang='0'
donate='0'
storageLocation='/images'
fogupdateloaded=1
docroot='/var/www/html/'
webroot='fog/'
caCreated='yes'
startrange=''
endrange=''
bootfilename='undionly.kpxe'
packages='apache2 php7.0 php7.0-json php7.0-gd php7.0-cli php7.0-curl mysql-server mysql-client tftpd-hpa tftp-hpa nfs-kernel-server vsftpd net-tools wget xinetd sysv-rc-conf tar gzip build-essential cpp gcc g++ m4 htmldoc lftp openssh-server php-gettext php7.0-mcrypt php7.0-mysql curl libc6 libcurl3 zlib1g php7.0-fpm libapache2-mod-php7.0 php7.0-mbstring'
noTftpBuild=''
notpxedefaultfile=''
sslpath='/opt/fog/snapins/ssl/'
backupPath='/home/'
## End of FOG Settings

Here are what the settings in this file mean:

Header/Footer

Header

Only gives some simplistic information to help users. Does no actions just gives some information.

## Start of FOG Settings
## Created by the FOG Installer
## Version: 7625
## Install time: Sat 14 May 2016 08:05:18 PM EDT

Footer

Does no actions, just tells where FOG's default variables are setup Any new items will go below this, and you can add your own variables. You can add variables wherever you want.

## End of FOG Settings

IP Address

Defines the IP address of the node/server. This is also used on servers to setup the default.ipxe file.

ipaddress='192.168.1.5'

Interface

This just sets the storage nodes/server interface as it will be stored in the Database. This used to be used for multicast setups and for the bandwidth graph. This is now setup so it is only used on the bandwidth graph as we already know the ip address anyway. Multicast tasks can get their own interface instead of relying on user entry.

interface='eth0'

Subnet Mask

This defines the subnet mask to use if the system is to be used as a DHCP server. It will assume the subnet mask of the interface being used, but can be changed later if you see fit.

submask='255.255.255.0'

Router Address

This will setup the router address to use if the system is to be used as a DHCP server. It currently only sets as an ip address, but in the past contained the whole dhcp configuration string. The config string was removed as it would only work on isc-dhcp-server, when some might be using dnsmasq or another dhcp server.

routeraddress='192.168.1.1'

Plain Router

Very similar to the Router Address elements above, but can be used to redirect to maybe another router/switch other than the main.

plainrouter='192.168.1.1'