Difference between revisions of "Basic Installation Steps"

From OpenFOAMWiki
Redirect page
(New page: This is a step-by-step installation guide to OpenFOAM on 32bit machines. It is highly focused on Linux-newbies, thus many steps might look superfluous on more experienced users. The chara...)
 
(Consolidating)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is a step-by-step installation guide to OpenFOAM on 32bit machines. It is highly focused on Linux-newbies, thus many steps might
+
#REDIRECT [[Installation]]
look superfluous on more experienced users. The character ">" is used to signal that what follows on that specific line is to be typed in a command line.
+
 
+
- Make a directory for your OpenFOAM installation by typing:
+
  > mkdir $HOME/OpenFOAM
+
  > cd $HOME/OpenFOAM
+
  > mkdir linux
+
 
+
- Download the following six archives from the opencfd-homepage to the $HOME/OpenFOAM directory:
+
  > OpenFOAM-1.4.1.General.gtgz
+
  > OpenFOAM-1.4.1.linuxGccDOpt.gtgz
+
  > OpenFOAM-1.4.1.linuxGccSOpt.gtgz
+
  > gcc-4.2.1.linux.tgz
+
  > j2sdk1.4.2_05.linux.tgz
+
  > paraview-2.4.4.linux.tgz
+
 
+
- Open a terminal and type:
+
  > ls /usr/include/features.h
+
  a) EITHER "/usr/include/features.h" is written to screen. Do not do any further.
+
  b) OR "cannot access /usr/include/features.h: No such file or directory"
+
    is written to screen. You need the build essentials to compile your own
+
    boundary conditions, thus type the following in a terminal:
+
    > aptitude install build-essential gcc
+
 
+
- Unpack the archives by typing the following command:
+
  > cd $HOME/OpenFOAM
+
  > tar -xzf OpenFOAM-1.4.1.General.gtgz
+
  > tar -xzf OpenFOAM-1.4.1.linuxGCCDPOpt.gtgz
+
  > tar -xzf OpenFOAM-1.4.1.linuxGCCSPOpt.gtgz
+
  > tar -xzf gcc-4.2.1.linux.tgz linux/
+
  > mv *.tgz linux/.
+
  > cd linux
+
  > tar -xzf gcc-4.2.1.linux.tgz
+
  > tar -xzf j2sdk1.4.2_05.linux.tgz
+
  > tar -xzf paraview-2.4.4.linux.tgz
+
 
+
- You need to set some environmental variables to be able to run OpenFOAM. This is done in the following way:
+
 
+
  a) EITHER, if running bash or ksh (if in doubt type 'echo $SHELL'), do the
+
    following:
+
    > nano $HOME/.bashrc (this open a text-editor in your command window)
+
    In the end of the file you type:
+
    . $HOME/OpenFOAM/OpenFOAM-1.4.1/.OpenFOAM-1.4.1/bashrc
+
    Press 'CTRL-X' to quit nano and agree to save changes.
+
 
+
  a) OR, if running tcsh or csh (if in doubt type 'echo $SHELL'), do the
+
    following:
+
    > nano $HOME/.cshrc (this open a text-editor in your command window)
+
    In the end of the file you type:
+
    source $HOME/OpenFOAM/OpenFOAM-1.4.1/.OpenFOAM-1.4.1/cshrc
+
    Press 'CTRL-X' to quit nano and agree to save changes.
+
 
+
- Open a new command-window. This will read $HOME/.bashrc and set all the necessary environmental variables. To check the installation do:
+
  > cd ~/OpenFOAM/OpenFOAM-1.4.1/bin
+
  > sh foamInstallationTest
+
 
+
- On single-machine setups, the installation test will probably produce a report which looks like this in the last couple of lines:
+
+
  ==============================================================================
+
  Checking networking...
+
 
+
  -------------------------------------------------------------------------------
+
  Action                  Result                                      Crit
+
  -------------------------------------------------------------------------------
+
  Pinging_ngj-ubuntu      Successful                                  yes
+
  Pinging_localHost        Successful                                  yes
+
  Test_rsh:                Unsuccessful_connection_refused*            yes
+
  Test_ssh:                Unsuccessful_connection_refused*            yes
+
  FATAL ERROR: No remote shell available.
+
              Foam1.4.1 enviroment requires either ssh and/or rsh.
+
              Contact your system administrator.
+
+
+
  -------------------------------------------------------------------------------
+
+
  The system test has evoked 1 fatal error(s).
+
+
  Critical systems ok.
+
+
  Review the output for warning messages and consult
+
  the installation guide for trouble shooting.
+
  ==============================================================================
+
 
+
  This fatal error is due the test_rsh and test_ssh critiria, though they are
+
  irrelevant on single-machine installations, i.e. only relevant for parallel-
+
  processing on multiple machine.
+
 
+
- To setup the a working directory, follow step 6 in the ~/OpenFOAM/OpenFOAM-1.4.1/README file.
+
 
+
- You are now ready to begin working with OpenFOAM.
+
 
+
- Have fun:)
+

Latest revision as of 02:42, 3 September 2009