Run a Basic Job
This example shows how you can run a Basic job on the Rescale platform. The analysis software used is OpenFOAM, an open source computational fluid dynamics (CFD) code. Please contact us if you're having trouble.
About this Simulation
This example uses the OpenFOAM simpleFOAM solver. This is a steady-state solver for incompressible turbulent flow and can be used to find a reasonable initial condition for a transient analysis. This 2D example model of a steady state flow around an airfoil was taken directly from a tutorial in the OpenFOAM Code repository. You can access and download the necessary input files by clicking the Import Job Setup button below.
Sign Up and Log In
If you have not done so already, you will need to sign up for a Rescale account. After signing up for a free trial, you will receive a verification email (this can take up to 20 minutes), in which you will find a link to the platform site. Log-in to the platform site and you will be greeted with a welcome screen.
To create a new job, click + New Job on the top-left corner of your screen.
All necessary input files are inside the compressed archive
To run a basic job, the fields highlighted in red below need to be set correctly. Do the following:
Edit the job name to one of your choice, here we use Basic Job: Airfoil2D.
Upload the file
airfoil2D.ziprequired for this run.
Check that the Job Type is Basic.
Uploading your input files as a compressed archive/file allows you to upload a collection of input files for a job all at once. Advantages of this are:
- reduced storage needs
- faster uploads
If a compressed archive/file is included as an input file for a job, when your cluster is launched any files in the zip file are automatically extracted to your job's work directory prior to the job being run. When you refer to files extracted from zipped archives in your command line or script, be careful with the relative paths to your files. The zip file itself will remain in storage for you and can be used again as input to subsequent jobs if you choose to do so. The supported compressed formats are:
- .tar, .tar.gz, .tgz, .gz
On completion, the Input Files setup page should look like that shown below. To move on to the next part of the Setup process, click the Next button at the top right of the page or the Software icon.
Select OpenFOAM by entering "OpenFOAM" in the textbox field (not case sensitive), shown highlighted in red, and clicking on the OpenFOAM icon.
The next stage of software setup is to choose the version number of the analysis code selected and to specify the Command text field that defines the command line used to run the simulation.
Select OpenFOAM version v1706+ (Intel MPI). Edit the Command field to read as follows:
The Rescale platform automatically extracts the
Allrun script with other runtime files contained in the compressed archive
airfoil2D.zip prior to beginning the simulation. The screenshot below, with modified fields highlighted in red, shows how your Software Settings setup page should look on completion of this step.
For a basic job, there are two hardware settings to edit: Number of Cores and Core Type.
- In this case, we can select Number of Cores of 1, and Core Type as Emerald. Rescale offers On Demand Economy and On Demand Priority coretype options. You can find more information on these options here.
- Maximum job duration can be set, by changing the Walltime. Note that there is currently a limit on the maximum job duration you can set on a job. More information here
- Click Save and then Next (this simple Basic Job omits the optional post-processing step, click Next again).
The Review step shows a summary of the job prior to submission. If everything is satisfactory, click the Submit button to begin the job.
The Status page allows you to monitor your analysis after the job has been submitted. The job workflow icons, highlighted in red on the right hand side of the page, allow you to navigate between the job Setup, Status, Results and Charts pages.
The Status page also allows you to view the contents of output files in real-time. This is known as live tailing a file. This can be very useful in monitoring the progress of a job. In this case, the two output files of particular interest are:
process_output.log file is created for every Rescale job and contains all the terminal output (stdout in Linux parlance) from the command as it is executed. The
log.simpleFoam file is a file specific to the OpenFOAM computation and contains information on the progress of the simulation.
To live tail a file, click on the name of the file you want to view, for example,
airfoil2D/log.simpleFoam which is shown highlighted in red. It will only take a few minutes to run this job.
Upon completion of the job, you will be presented with the Results page, as shown below.
From this page you can do several things:
- You can download all files using the blue Download button.
- You can use the Actions menu, highlighted in red, to act on groups of files selected using the checkboxes.
- The Action buttons, highlighted in blue, allow you to view, download, delete, or make individual files available for future jobs.
For more information on how to download and manipulate files on the Rescale platform, please see the Downloading Data article.