Running CFDDFC with the CFDDFC CLI
- The CFDDFC command line interface (CLI)
- Install the CFDDFC CLI
- Configure the CFDDFC CLI
- Launch an Instance
- Run on an Instance
- Browser Desktop (Web CFDDFC)
- Launch a Cluster
- Terminate an Instance
Running on an Instance
Once the instance launches, the user run the following subcommands to manage data in
push: transfer OpenFOAM case files from the local machine to the remote instance.
pull: transfer OpenFOAM case files from the remote instance to the local machine.
files: list case files on the remote instance.
The following subcommands enable the user to run OpenFOAM applications and scripts etc on a remote instance.
login: login to the remote instance and run OpenFOAM applications, scripts, etc.
run: run OpenFOAM applications, scripts, etc without logging in to the remote instance.
desktop: with “Classic” CFDDFC, launch a remote desktop on the instance.
browser: with Web CFDDFC, get connection details to launch the browser desktop on the instance.
Example: Running the pitzDailySteady Case
The user can run the
pitzDailySteady example described in “Launching an Instance” as follows. First the user can transfer the case to the remote instance with
The user is prompted to create a new case directory and to transfer the data. Type “
y” to confirm. The user can then login to the remote instance with the following command.
At the prompt on the remote machine, they can change directory to
pitzDailySteady, run the example case as normal, and then logout from the remote instance, e.g.
cd pitzDailySteady blockMesh foamRun exit
The user can then transfer the data back from the remote instance to their local machine with the following command.
The user can then post-process data on their local machine. If the user wished to delete the time directories, containing their simulation results, on the remote machine (using “
) they could execute the command remotely with
run as follows.
cfddfc run "foamListTimes -rm"
The user could then list the files on the remote instance to confirm the deletion of the time directories with the following command.
The user could then re-run
foamRun without logging into the remote instance with:
cfddfc run foamRun
The script warns the user that the files on the local machine and remote instance are not synchronised. The user should ignore the warning and type “
y” to confirm they wish to continue.
If the instance is running “Classic” CFDDFC and the system configured with the optional
pyhoca package, the user can login to the instance via a remote desktop with the following command.
If the instance is running Web CFDDFC, login details to connect the browser desktop are provided by the following command.
Further details for this command are provided in the following article, Browser Desktop (Web CFDDFC only). With either desktop, the user can then perform tasks requiring a graphical interface, e.g. post-processing with