Commit 1ccf10eb authored by Robert Ricci's avatar Robert Ricci

Fix some problems spotted by Leigh - make sure that the FreeBSD

installation instructions tell them not to install the ports
collection or any packages. Include instructions on how to get our
approved version of the ports tree.

Remove the text about updating to -STABLE, as that is no longer our
recommended procedure.
parent 8ecf7566
...@@ -7,14 +7,11 @@ ...@@ -7,14 +7,11 @@
Install FreeBSD on the machine you'll be using for your ops node, using the Install FreeBSD on the machine you'll be using for your ops node, using the
standard FreeBSD installation process. When asked by the installer, it's best standard FreeBSD installation process. When asked by the installer, it's best
to choose the 'Developer' distribution set - this gets you full sources. The to choose the 'Developer' distribution set - this gets you full sources. When
'X-Developer' distribution set would be fine too, if you want to be able to run it asks if you want to install the ports collection, answer no. Don't install
X clients from the ops node. When it asks if you want to install the ports any packages at this time - you'll get a chance to later. You'll need to
collection, answer yes. You don't need to worry about which packages to partition your filesystems so that you have the proper amount of space for
install (of course, grab your favorite editors, etc.) - the ones our software certain directories - see below for details.
needs will be installed automatically later. You'll need to partition your
filesystems so that you have the proper amount of space for certain directories
- see below for details.
Make sure that you have the network correctly configured. Make sure that you have the network correctly configured.
...@@ -56,16 +53,6 @@ ln -s /z/proj /proj ...@@ -56,16 +53,6 @@ ln -s /z/proj /proj
It's simplest if you don't create any users yet, and just log in a root for the It's simplest if you don't create any users yet, and just log in a root for the
time being. Our software will create users later, once you get boss set up. time being. Our software will create users later, once you get boss set up.
We occasionally run into problems with certain FreeBSD ports. Also, you're going
to want the latest security updates. So, you should at the very least bring
your ports collection up to date using:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cvsup.html
It is also a good idea to bring your base system up to date with the -STABLE
branch. Instructions for doing this can be found at:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cutting-edge.html
##### Step 1 - Unpacking and running configure ##### Step 1 - Unpacking and running configure
At this point, you'll need to make a 'defs' file - see setup.txt for At this point, you'll need to make a 'defs' file - see setup.txt for
...@@ -98,6 +85,15 @@ env PKG_PATH=/usr/tmp/FreeBSD-4.10-20041102 pkg_add emulab-ops-1.4 ...@@ -98,6 +85,15 @@ env PKG_PATH=/usr/tmp/FreeBSD-4.10-20041102 pkg_add emulab-ops-1.4
Of course, if you untarred it somewhere else, put in the correct path. Of course, if you untarred it somewhere else, put in the correct path.
At this point, you can now install other ports if you want to (ie. emacs or
vim). We have run into many, many problems with versions of the FreeBSD ports.
So, rather than using the /usr/ports tree that comes on the FreeBSD
installation media, we use one that we've tested against. You can grab our
'approved' copy of the ports tree from:
http://www.emulab.net/downloads/ports-20041102.tar.gz
Untar it, move it into place as /usr/ports, and install whatever ports you
want to make ops feel like 'home'...
##### Step 3 - Running the ops installation script ##### Step 3 - Running the ops installation script
In the object tree you've configured (in my example above, ~/tbobj), there's an In the object tree you've configured (in my example above, ~/tbobj), there's an
......
...@@ -66,33 +66,21 @@ Follow the instructions in the setup-ops.txt file before the ones in this file! ...@@ -66,33 +66,21 @@ Follow the instructions in the setup-ops.txt file before the ones in this file!
Install FreeBSD on the machine you'll be using for your boss node, using the Install FreeBSD on the machine you'll be using for your boss node, using the
standard FreeBSD installation process. When asked by the installer, it's best standard FreeBSD installation process. When asked by the installer, it's best
to choose the 'Developer' distribution set - this gets you full sources. The to choose the 'Developer' distribution set - this gets you full sources. When
'X-Developer' distribution set would be fine too, if you want to be able to run it asks if you want to install the ports collection, answer no.
X clients from the boss node. When it asks if you want to install the ports You, will, however, have to make
collection, answer yes. You don't need to worry about which packages to
install (of course, grab your favorite editors, etc.) - the ones our software
needs will be installed automatically later. You, will, however, have to make
sure that you create a partition large enough to hold /usr/testbed - in sure that you create a partition large enough to hold /usr/testbed - in
addition to the testbed software, this is where many disk images will get addition to the testbed software, this is where many disk images will get
stored. The /var partition will need to be large enough to hold the database - stored. The /var partition will need to be large enough to hold the database -
100MB extra for the database should be sufficient. Also, since we'll be building 100MB extra for the database should be sufficient. Also, since we'll be
and installing a lot of software from the ports tree, you'll want to make sure installing a lot of packages, you'll want to make sure that /usr is at least 2
that /usr is at least 2 GB. GB.
If you want, you can go ahead and create an account for yourself on boss. For If you want, you can go ahead and create an account for yourself on boss. For
now, just stick the home directory somewhere local, and move it to /users/ once now, just stick the home directory somewhere local, and move it to /users/ once
you've got it mounted from ops (the boss-install script will set this up). In you've got it mounted from ops (the boss-install script will set this up). In
general, it's probably simpler to just use 'root' for now. general, it's probably simpler to just use 'root' for now.
We occasionally run into problems with certain FreeBSD ports. Also, you're going
to want the latest security updates. So, you should at the very least bring
your ports collection up to date using:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cvsup.html
It is also a good idea to bring your base system up to date with the -STABLE
branch. Instructions for doing this can be found at:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cutting-edge.html
##### Step 1 - Create a defs file ##### Step 1 - Create a defs file
The defs file will describe some of your setup, such as the hostnames of your The defs file will describe some of your setup, such as the hostnames of your
...@@ -114,6 +102,9 @@ Again, almost the same as on ops. Download the same tarball, and follow ...@@ -114,6 +102,9 @@ Again, almost the same as on ops. Download the same tarball, and follow
the same pkg_add procedure, excepth this time, you're going to install the same pkg_add procedure, excepth this time, you're going to install
the emulab-boss-1.8 package instead of emulab-ops . the emulab-boss-1.8 package instead of emulab-ops .
You can download our approved ports tree and install ports at this point
if you wish.
##### Step 4 - Running the boss installation script ##### Step 4 - Running the boss installation script
Again, this works the same as it did on ops, except that you run Again, this works the same as it did on ops, except that you run
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment