Permalink
Browse files

Revert.

  • Loading branch information...
jhixson74 committed Jun 22, 2013
1 parent e4f2039 commit ccdff24ed30aaec0cf6a86ece87dac696175e7f4
Showing with 38 additions and 22 deletions.
  1. +38 −22 README
View
60 README
@@ -1,61 +1,77 @@
-FreeNAS 9.x is a complete different software compared to 0.7. There is a
+FreeNAS 8.x is a complete different software compared to 0.7. There is a
complete feature parity between 0.7 (legacy) and 8.x with plugins, there
-are also some features in 9.x that aren't available in 0.7.
-There isn't an upgrade path from 0.7 to 9.x.
+are also some features in 8.x that aren't available in 0.7.
+There isn't an upgrade path from 0.7 to 8.x.
To build the system (experts only):
Requirements:
-- Your build environment must be FreeBSD 9.1-RELEASE or newer.
+- Your build environment must be FreeBSD 8.1-RELEASE or newer.
- amd64 or i386 for i386 builds; an amd64 for amd64 builds.
- You will need the following ports/packages when compiling anything
FreeNAS-related:
- - devel/git
+ - devel/git-subversion
- lang/python26 or lang/python27
- You need the following additional ports/packages to build the FreeNAS base
OS image:
- sysutils/cdrtools
+- You need the following additional ports/packages to build the plugins jail:
+ - ports-mgmt/pbi-manager
+
- The port security/sudo is recommended but not required, if you do not have
the port installed you can run the commands listed in this doc as root.
+- If you have the devel/gamin port installed, you may encounter errors
+ during the FreeNAS build when it tries to unmount nullfs file systems.
+ To fix this, you either can remove the port, or create a config file
+ /usr/local/etc/gamin/gaminrc with the following entries to disable gamin
+ notifications on certain file systems:
+
+ fsset nullfs none
+ fsset ufs none
+ fsset zfs none
+
+ See: http://people.gnome.org/~veillard/gamin/config.html for more details.
+
Building the System Quickstart Flow:
- Checking out the code from git:
-% git clone http://github.com/freenas/freenas.git
+% git clone --depth 1 git://github.com/freenas/freenas.git
% cd freenas
-More information about checking out sources from git via github
-can be found here: https://github.com/
-
- Use the build script
% sudo sh build/do_build.sh
-- Or, If you want jail distfiles and packages as part of the image:
+This will fetch TrueOS and ports for the build. However it is recommended that you maintain a local git mirror to speed up further builds:
+
+% git clone git://github.com/freenas/ports.git ${HOME}/ports
+% git clone git://github.com/trueos/trueos.git ${HOME}/trueos
+
+To build using those local mirrors run:
-% sudo sh build/do_build.sh -J
+% sudo env GIT_REPO=${HOME}/trueos GIT_PORTS_REPO=${HOME}/ports sh build/do_build.sh
That's it.
The End Result:
If your build completes successfully, you'll have an image in
-os-base/ARCH/FreeNAS-VVVV-XXXX-YYYY-ZZZZ.(iso|img.xz|GUI_Upgrade.txz)
+obj.yyyy/FreeNAS-VVVV-XXXX-yyyy.img.xz where:
-- VVVV is the 'release' branch version.
-- XXXX is ALPHA, BETA or RELEASE.
-- YYYY is either x32 or x64 depending on your platform and what was
+- VVVV is the 'release' branch version or.
+- XXXX is the git commit hash from the FreeNAS repo.
+- yyyy is either i386 or amd64 depending on your platform and what was
provided via $FREENAS_ARCH on the command line / via the environment.
-- ZZZZ is the git revision.
This is a compressed raw disk image, and needs to be decompressed and
converted to your favorite VM container format before use, flashed on to a USB
key fob, etc. There will also be a CD/DVD image,
-obj.yyyy/FreeNAS-VVVV-XXXX-YYYY-ZZZZ.iso, that you can use to install/upgrade
+obj.yyyy/FreeNAS-VVVV-XXXX-yyyy.iso, that you can use to install/upgrade
FreeNAS.
Common workflows:
@@ -66,12 +82,12 @@ Common workflows:
2. Forcing an source / ports update:
-% sudo env build/do_build.sh -u
+% sudo sh build/do_build.sh -u
3. Updating ports patches:
-% sudo rm -Rf obj.$FREENAS_ARCH/ports/packages/
-% sudo env build/do_build.sh -u
+% sudo rm -Rf os-base/$FREENAS_ARCH/ports/packages/
+% sudo sh build/do_build.sh -u
NOTE: when things get smarter (and they will.. the developers feel your pain
too :/..), nuking individual packages won't be required; this will require
@@ -82,11 +98,11 @@ things properly!).
4. Update source and ports, patch, and rebuild FreeBSD:
-% sudo env build/do_build.sh -fu
+% sudo sh build/do_build.sh -fu
5. Force a build from scratch (nukes packages, rebuild FreeBSD):
-% sudo env build/do_build.sh -ff
+% sudo sh build/do_build.sh -ff
6. Build everything required (src, ports) but don't produce GUI upgrade/CD
images:

0 comments on commit ccdff24

Please sign in to comment.