434. ECCE 6.4 in a 32 bit Debian 7 Virtual Machine by compiling, or in a 64 bit Debian 7 Virtual Machine by using pre-built binaries

!NOTE!
ECCE is only available prebuilt for 64 bit OS. You will NOT be able to install the binaries from EMSL on a 32 bit OS in your virtual machine.

!NOTE2! I use localhost in the set-up below. Be aware that this will block outside access: http://www.nwchem-sw.org/index.php/Special:AWCforum/st/id858/#post_3178


This post shows how to
1. compile ECCE for a 32 bit system
and
2. install the pre-built EMSL 64 bit binaries for a 64 bit system.

The reason why I show both is that if you are running a 32 bit host system you might not be able to run a 64 bit client OS.

!NOTE!

This is essentially an update of an older post (http://verahill.blogspot.com.au/2012/06/ecce-in-virtual-machine-step-by-step.html) which describes how to install ECCE 6.3 on Debian 6.

Part of the reason for updating is this comment: http://verahill.blogspot.com.au/2012/06/ecce-in-virtual-machine-step-by-step.html?showComment=1369743102385#c8435880599103089732

If you are running a debian or redhat based linux distribution you should be able to install ecce natively without issue (e.g. http://verahill.blogspot.com.au/2013/01/325-compiling-ecce-64-on-debian-testing.html).

However, if you are using Windows or OS X you will probably want to install ecce inside a virtual machine, hence this post:

---

0. Install virtualbox
How you install virtualbox depends on your host system. I'm running debian wheezy AMD 64, so I did

cd ~/Downloads
wget http://download.virtualbox.org/virtualbox/4.2.12/virtualbox-4.2_4.2.12-84980~Debian~wheezy_amd64.deb
sudo dpkg -i virtualbox-4.2_4.2.12-84980~Debian~wheezy_amd64.deb

Note that you are in no way obliged to download the Oracle packaged version of virtualbox. I'm using it because I've had issues with the debian packages in the past when using kernels that are very new (and that I've compiled myself). See e.g.http://verahill.blogspot.com.au/2013/05/419-talking-to-myself-in-public-dkms.html

See here for other versions of virtualbox: https://www.virtualbox.org/wiki/Linux_Downloads

---

1. Download the Debian 7 installation CD
If you are on a unix-like system you should be able to do something along the lines of

mkdir ~/tmp
cd ~/tmp
wget http://cdimage.debian.org/debian-cd/7.0.0/i386/iso-cd/debian-7.0.0-i386-netinst.iso

to download the 32 bit iso and

wget http://cdimage.debian.org/debian-cd/7.0.0/amd64/iso-cd/debian-7.0.0-amd64-netinst.iso

to download the 64 bit version. Please read the introduction to this post to learn about the consequences of installing a 32 bit system.

---

2.Set up the virtual machine
(in this example I'm using the i386 version of debian, but the steps are identical for the amd64 version)

Start virtualbox and click on New:

Mount the CD

---

3. Install Debian 7 on the virtual machine
Click Start and the installation should start. (the steps are the same for the i386 and the amd64 versions)

Debian 7 (wheezy) is now installed. Log in.

At this point you can install whatever you want. I suggest installing the

• LXDE desktop environment (I know that it's a tautology). 
• openjdk-7-jdk (you might be able to get away with -jre)

Reboot.

---

4a. 32 bit Virtual machine: Compile ECCE v 6.4
Note: you might have to go to http://ecce.emsl.pnl.gov/using/download.shtml and download the source in a browser if wget doesn't work.

mkdir ~/tmp
cd ~/tmp
wget http://ecce.emsl.pnl.gov/cgi-bin/help/nwecce.pl/ecce-v6.4-src.tar.bz2
tar xvf ecce-v6.4-src.tar.bz2
sudo apt-get install bzip2 build-essential autoconf libtool ant pkg-config gtk+-2.0-dev libxt-dev csh gfortran openjdk-6-jdk python-dev libjpeg-dev imagemagick xterm
cd ecce-v6.4/
export ECCE_HOME=`pwd`
cd build/
./build_ecce

At this point you'll be going through the same steps as shown in this post: http://verahill.blogspot.com.au/2013/01/325-compiling-ecce-64-on-debian-testing.html (yesterday's testing is today's stable)

Checking prerequisites for building ECCE...
If any of the following tools aren't found or aren't the right
version, hit -c at the prompt and either find or install
the tool before re-running this script.  The whereis command
is useful for finding tools not in your path.
Found gcc in: /usr/bin/gcc
ECCE requires gcc 3.2.x or 4.x.x
This version: gcc (Debian 4.7.2-5) 4.7.2
Hit return if this gcc is OK...
[..]
This works fine unless your site needs support for multiple platforms.
Finished checking prerequisites for building ECCE.
Do you want to skip these checks for future build_ecce invocations (y/n)? y

./build_ecce

Xerxes built

./build_ecce

Mesa OpenGL built
./build_ecce

wxWidgets built
./build_ecce

wxPython built
./build_ecce

Apache HTTP server built
./build_ecce

ECCE built and distribution created in /home/verahill/tmp/ecce-v6.4
cd ../
./install_ecce.v6.4.csh

and continue to section 5.

4b. 64 bit Virtual machine: Download ECCE v 6.4

mkdir ~/tmp
cd ~/tmp
wget http://ecce.emsl.pnl.gov/cgi-bin/help/nwecce.pl/install_ecce.v6.4.rhel5-gcc4.1.2-m64.csh
sudo apt-get install csh
csh install_ecce.v6.4.rhel5-gcc4.1.2-m64.csh

and continue to section 5.

---

5. Install ECCE

Main ECCE installation menu
===========================
1) Help on main menu options
2) Prerequisite software check
3) Full install
4) Full upgrade
5) Application software install
6) Application software upgrade
7) Server install
8) Server upgrade

IMPORTANT: If you are uncertain about any aspect of installing
or running ECCE at your site, please refer to the detailed
ECCE Installation and Administration Guide at 
http://ecce.pnl.gov/docs/installation/2864B-Installation.pdf

Hit  at prompts to accept the default value in brackets.

Selection: [1] 3
Host name: [eccehost] localhost
Application installation directory: [/home/verahill/tmp/ecce-v6.4/ecce-v6.4/apps] /home/verahill/.ecce/apps
Server installation directory: [/home/verahill/.ecce/server]
ECCE v6.4 will be installed using the settings:

  Installation type: [full install]
  Host name: [localhost]
  Application installation directory: [/home/verahill/.ecce/apps]
  Server installation directory: [/home/verahill/.ecce/server]

Are these choices correct (yes/no/quit)? [yes] 

Installing ECCE application software in /home/verahill/.ecce/apps...
  Extracting application distribution...
  Extracting NWChem binary distribution...
  Extracting NWChem common distribution...
  Extracting client WebHelp distribution...
  Configuring application software...
  Configuring NWChem...

Installing ECCE server in /home/verahill/.ecce/server...
  Extracting data server in /home/verahill/.ecce/server/httpd...
  Extracting data libraries in /home/verahill/.ecce/server/data...
  Extracting Java Messaging Server in /home/verahill/.ecce/server/activemq...
  Configuring ECCE server...

ECCE installation succeeded.

***************************************************************
!! You MUST perform the following steps in order to use ECCE !!
-- Unless only the user 'verahill' will be running ECCE,
   start the ECCE server as 'verahill' with:
     /home/verahill/.ecce/server/ecce-admin/start_ecce_server

-- To register machines to run computational codes, please see
   the installation and compute resource registration manuals
   at http://ecce.pnl.gov/using/installguide.shtml

-- Before running ECCE each user must source an environment
   setup script.  For csh/tcsh users add this to ~/.cshrc:
     if ( -e /home/verahill/.ecce/apps/scripts/runtime_setup ) then
       source /home/verahill/.ecce/apps/scripts/runtime_setup
     endif
   For sh/bash users, add this to ~/.profile or ~/.bashrc:
     if [ -e /home/verahill/.ecce/apps/scripts/runtime_setup.sh ]; then
       . /home/verahill/.ecce/apps/scripts/runtime_setup.sh
     fi
***************************************************************

echo 'export ECCE_HOME=/home/verahill/.ecce/apps' >> ~/.bashrc
echo 'PATH=$PATH:/home/verahill/.ecce/server/ecce-admin/:/home/verahill/.ecce/apps/scripts/' >> ~/.bashrc
echo 
source ~/.bashrc
start_ecce_server 

/home/verahill/.ecce/server/httpd/bin/apachectl start: httpd started
[1] 4137
INFO  BrokerService
- ActiveMQ 5.1.0 JMS Message Broker (localhost) is starting
INFO  BrokerService
- ActiveMQ JMS Message Broker (localhost, ID:ecce64bit-35450-1369895708602-0:0) started

ecce

---

Note that this is just the beginning. You should now compile nwchem and set up ecce to work with nwchem either locally or remotely.

This post shows one type of configuration: http://verahill.blogspot.com.au/2012/06/ecce-in-virtual-machine-step-by-step.html

But read the documentation and search this site and you'll find more examples.