On Fri, Mar 16, 2012 at 12:05, Christopher Sean Morrison <[email protected]> wrote:
>
>>> Love the code samples, though I'd suggest some alternates. I'll come up
I've updated files in brlcad/ova for the VM.
I've also attached them for comment.
I'm having trouble getting the new VM compressed (it's at ~2.5 Gb).
If anyone can successfully get into single user mode and remount the
hard drive into read-only mode let me know how. I did it once
successfully, but now there are processes running that prevent it and
that shouldn't be happening.
Best,
-Tom
Virtual Machine
===============
The "*.ova" file in this directory is a Virtual Machine (VM) built and
tested on a Windows 7 64-bit host of Oracle's VirtualBox (using
version 4.1.10: http://virtualbox.org/). The VM contains a turn-key
BRL-CAD development environment.
The intent of the VM is to give Google Summer of Code interns a
good starting place so they can be productive as soon as possible.
You will need about 6 Gb free space on your computer (after the
download) to import the VM into Oracle VirtualBox and run it.
When starting the VM you may get a message about problems with the
network adapter. If you cannot start the VM successfully, you may
have to experiment with the VM's network settings to find something
that works for your VirtualBox host's harware.
In the event nothing works for getting access to the network, you can
choose to use no network at all. Please read the VirtualBox
documentation and then ask for help from the BRL-CAD developers if you
don't find an answer quickly.
The VM is set to autoboot and autologin. The user name is "brlcad"
with a password of "Brlcad!" (you should change the password upon
first login).
Note: To access the VM boot menu, press and hold the <SHIFT> key after
starting the VM.
mount -n -o remount,ro -t ext2 /dev/sda1 /
Configuration Notes
===================
The Firefox browser has links on the bookmarks tool bar grouped by
major dependency or category. There are folder icons on the desktop
for common BRL-CAD source code references, and important working
sub-directories in the home directory. Note that the "Downloads"
directory can be removed but it tends to reappear if you download
through Firefox and don't change its download defaults.
The "brlcad-svn" directory has the brlcad/trunk current as of
2012-03-16 and the "brlcad-build "directory has a configured and
tested build followed by a "make clean" command. The
"README.txt" describes a recommended configuration and
build sequence for use inside the build directory.
The "Documentation" directory has BRL-CAD documents from the BRL-CAD
site. The "Other" directory has documents from the Bullet library
home site.
The successful trunk build (debug, with pdf extra docs) is installed
in the default location (/usr/brlcad/dev-7.21.0). The PATH and
MANPATH reflect that location, and Firefox has links to the installed
BRL-CAD documentation.
The latest CMake, Bullet Physics, and Apache FOP are installed, and
the environment variable APACHE_FOP points to the fop executable.
Editors vi, emacs, and jEdit are installed alongside the simple gedit.
The latest Java runtime environment from Oracle is installed.
The ~/.bash-aliases file has some handy aliases for getting around:
cad='cd ~/brlcad-svn'
cabd='cd ~/brlcad-build'
svu='svn update'
svs='svn status'
There are other aliases for safe versions of destructive commands (cp,
rm, mv) and shortcuts for commonly-used commands and options.
There is also a PERL5LIB environment variable set for the current
directory:
PERL5LIB=.
Suggestions for change or additions are encouraged. Send to
<[email protected]>.
BRL-CAD Build Configuration
===========================
The recommended practice is to build BRL-CAD outside the BRL-CAD
source directory. There is a build directory already created in the
home directory.
Here is a starting build configuration and build sequence. (See
~/brlcad-svn/HACKING for more information.)
$ cd ; cd brlcad-build
$ cmake ../brlcad-svn \
\
-DBRLCAD_BUNDLED_LIBS=ON \
-DBRLCAD_ZLIB=OFF \
-DCMAKE_BUILD_TYPE=DEBUG \
-DBRLCAD_EXTRADOCS_PDF=PDF \
-DBRLCAD_EXTRADOCS_PDF_MAN=OFF \
-DBRLCAD_ENABLE_OPENGL=OGL
For convenience you make want to put the commands into a shell script.
If you do so, make sure it is placed outside the build directory in
case you want to delete everything in that build directory.
BRL-CAD Build
=============
The following assumes you have a valid configuration following the
steps above:
$ cd ; cd brlcad-build
$ make
BRL-CAD Deveopment
==================
Note that as you modify files during your development work, you will
repeat the configure/make cycle often. The configuration may not have
to be done as often as a remake, depending on what is changed.
Sometimes, when a build fails, there may be a bug in the build system
that fails to pick up a subtle dependency and you may need to delete
all files and subdirectories in the build directory and start anew
with the configuration step. It is worth a public compliment from the
BRL-CAD development team if you discover and report such a bug. It is
worth an additional and very favorable compliment if you can submit a
patch which fixes that bug!
BRL-CAD Installation
====================
If you want to override the current installation (not recommended
until you are comfortable and successful with the build process), take
the next step after completing all the above successfully:
$ cd ; cd brlcad-build
$ sudo make install
------------------------------------------------------------------------------
This SF email is sponsosred by:
Try Windows Azure free for 90 days Click Here
http://p.sf.net/sfu/sfd2d-msazure
_______________________________________________
BRL-CAD Developer mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-devel
