Here are some examples to help clarify the use of the command line:
Start CFX-Solver
To start CFX-Solver running from the CFX-Solver input file model.def, enter the command:
cfx5solve -def model.def
If the input file is for a multiple configuration (.mdef file), enter the command:
cfx5solve -mdef model.mdef
Start CFX-Solver Manager
To start CFX-Solver Manager, passing it the name of the CFX-Solver input file, enter the command:
cfx5solve -interactive -def model.def
Produce a Partition File
To produce a partition file with the MeTiS
partitioning method
and seven partitions, but not run CFX-Solver to solve for the
solution, enter the command:
cfx5solve -def model.def -partition 7
This command will produce a file named model_001.par in the local run directory.
Note: If the file model.par exists in the working directory, then
the partition type (MeTiS
, RecCoordBis
or
SpecDir
) is read from this file, even if you have not
specified the file model.par. Because this could potentially be
confusing, you are advised to use the CFX-Solver Manager to set up a partitioning run, unless
you are certain that either there is no file model.par or that
the partitioning method specified in the model.par file is what
you require.
Start CFX-Solver in Local Parallel
To run CFX-Solver in parallel, starting from the CFX-Solver input file model.def and running only on the local machine with two partitions, enter the command:
cfx5solve -def model.def -par-local -partition 2
If you have already created a file model.par (for instance, by
using the command cfx5solve -def model.def -partition 7
), then you
can run the parallel CFX-Solver by entering the
command:
cfx5solve -def model.def -par-local -parfile-read model.par
To
run the CFX-Solver in parallel for the configuration named
<config>
and in serial for other configurations in a
multi-configuration simulation, enter the
command:
cfx5solve -mdef model.mdef -config "<config>" -par-local -partition 2
Start CFX-Solver in Distributed Parallel
Note: To ensure that the following example works, define the hosts
hosta
, hostb
and
hostc
in the central hostinfo.ccl
file. (cfx5solve
attempts to automatically detect hosts
that are not listed in hostinfo.ccl, but this is not guaranteed
to work.)
To run CFX-Solver in distributed parallel, starting from the CFX-Solver input file
model.def, and using one partition on
hosta
, two partitions on hostb
,
and four partitions on hostc
, for a total of seven partitions,
enter the command:
cfx5solve -def model.def -par-dist 'hosta,hostb*2,hostc*4'
Start CFX-Solver in Parallel
To start the CFX-Solver in parallel with four partitions on two hosts, enter the command:
cfx5solve -def file.def -par-dist 'hosta*2,hostb*2'
If you have already created a partitioning file, say model.par
(for instance, by using the command cfx5solve -def model.def -partition
7
), then you can execute the distributed parallel run as follows:
cfx5solve -def model.def -parfile-read model.par -par-dist \ 'hosta,hostb*2,hostc*4'
The
number of partitions specified using the -par-dist
command-line
flag must be the same as that in the partitioning file, model.par,
or the run will fail.
Start CFX-Solver in Parallel with Cray MPI
To start the CFX solver in parallel on a system running the Cray Linux Environment, having reserved the required processing elements via the built-in batch queuing system:
cfx5solve -def model.def -start-method "Cray MPI Distributed Parallel"
Preprocess Incomplete Configuration Files
Configuration definition (.cfg) files that are created in conjunction with a multi-configuration simulation file (.mdef) are incomplete; they do not contain global information like equation and material definitions.
To preprocess the configuration files so that they are complete and can be run independently of the multi-configuration simulation, enter the command:
cfx5solve -mdef model.mdef -norun
To preprocess the configuration
definition file corresponding to the configuration name
<config>
, enter the command:
cfx5solve -mdef model.mdef -config "<config>" -norun
Stopping the CFX-Solver from the Command Line
After CFX-Solver is running, stop it by using cfx5stop
from the
command line.
Suppose a run is called mixer_001
in the current
directory. There will be a temporary directory called
mixer_001.dir
in the current directory while that
run is actually running. To stop the run, enter the following command line:
cfx5stop -directory mixer_001.dir