A.5 Configuration to run FoamX

Back to OpenFOAM Home

OpenCFD®

Company profile

OpenFOAM support

OpenFOAM development

OpenFOAM training

Solutions

Contact OpenCFD

Recruitment

A.5 Configuration to run FoamX

The FoamX user configuration files are located in the user .OpenFOAM-1.5/apps/FoamX directory, that may be copied to the user’s $HOME, maintaining the directory structure. The files that can be configured, if the user so wishes, are:

FoamXClient.cfg

contains settings for the networking and appearance of FoamX. In particular, the user may wish to set:

the host/port address given by the org.omg.CORBA.ORBInitialHost= and org.omg.CORBA.ORBInitialPort= entries.
the default browser, by editing the FoamX.Browser= entry to netscape, mozilla, konqueror or any other browser or executable that can be passed a URL;
the default editor, by commenting out (#) the relevant entries for FoamX.Editor= to leave the editor of choice from e.g.internal, nedit, xemacs.

FoamX.cfg

contains settings for processControl that can be edited. In particular the user should set the remoteShell to rsh or ssh, depending on whether they are running remote or secure shell. The file also contains settings for timings associated with the connection timing out and retries of commands which can be increased if the user experiences problems.

The environment variables associated with FoamX compilation are prefixed by $FOAMX_ and listed in A.3.

Environment variable	Description and options

$FOAMX_PATH	Path to FoamX installation, $FOAM_UTIL/FoamX
$FOAMX_SYSTEM_CONFIG	Path to FoamX system configuration files, $FOAMX_PATH/config
$FOAMX_USER_CONFIG	Path to FoamX user configuration files, $HOME/$FOAM_DOT_DIR/apps/FoamX

Table A.3:

Environment variable settings for FoamX.

A.5.1 JAVA

The FoamX case browser uses JAVA 1.5 which may be installed as standard on the machine, although perhaps not the required version. It is therefore supplied with the OpenFOAM release and the $JAVA_HOME environment variable is specified by default in $WM_PROJECT_DIR/.bashrc (or .cshrc) to the top level directory of the supplied JAVA release. The system administrator may choose to install JAVA 1.5 in an alternative location setting $JAVA_HOME accordingly.

A.5.2 Paths to case files

FoamX finds paths to the user’s case files from the caseRoots entries in the .OpenFOAM-1.5/controlDict file. By default they are set as:

    caseRoots
    (
        "."
        "$FOAM_RUN/tutorials/icoFoam"
        "$FOAM_RUN/tutorials/turbFoam"
        ...
    );

where $FOAM_RUN points by default to the directory $HOME/OpenFOAM/${USER}-1.5/run. This means that by default the user can open cases in the tutorial directory copied to their run directory and cases within the directory from which FoamX is launched. If the user wished to set their own paths, they should do so in a local copy of controlDict file in the $HOME/.OpenFOAM-1.5 directory.

[next] [prev] [prev-tail] [front] [up]