How to Submit and Monitor Feko Jobs on an HPC Cluster
1. Overview
This guide explains how to transfer Feko simulation files to a High-Performance Computing (HPC) cluster, submit simulation jobs, monitor their execution, and retrieve completed results.
The procedure uses standard SSH, SFTP, and PBS job-scheduling commands. Users can choose any compatible SSH/SFTP client, such as MobaXterm, PuTTY, WinSCP, or a Linux terminal.
2. Prerequisites
Before submitting a job, ensure that you have:
Access to an HPC cluster.
Valid HPC login credentials provided by the cluster administrator.
The Feko simulation input file (
.cfx).The appropriate job submission script (
.sh) configured for the cluster.An SSH/SFTP client or terminal application.
3. Preparing the Simulation File
Generate the Feko simulation input file (
.cfx) on your local workstation.Ensure that the filename does not contain spaces or special characters. Use underscores (
_) where necessary.Keep the simulation file and its associated input files organized in a working directory.
4. Connecting to the HPC Cluster
An SSH/SFTP client can be used to connect to the HPC cluster.
Commonly used tools include:
MobaXterm
PuTTY
WinSCP
OpenSSH (Linux/macOS/Windows terminal)
Using an SSH/SFTP Client
Open your preferred SSH/SFTP client.
Enter the HPC cluster hostname or IP address provided by the administrator.
Authenticate using your assigned credentials.
Establish an SFTP connection to access the cluster's file system.
Navigate to your designated working directory.
5. Uploading Simulation Files
Using the SFTP interface, navigate to your designated working directory on the HPC cluster.
Upload the Feko
.cfxfile from your local workstation.Ensure that the file transfer is complete before proceeding.
6. Configuring the Job Submission Script
Establish an SSH connection to the HPC cluster.
-
Navigate to your working directory using:
cd <working_directory> -
Locate the Feko job submission script provided or configured for the cluster.
Example:
Feko_submit.sh -
Open the script using a text editor:
vi Feko_submit.sh Locate the command containing
runfeko.Update the simulation filename to match the uploaded
.cfxfile.-
Save the changes:
Press
Esc.Type
:wq.Press
Enter.
Note: The submission script may contain additional scheduler directives, resource allocation settings, and environment configurations. These should be maintained according to the HPC cluster administrator's guidelines.
7. Submitting the Simulation Job
Once the submission script is configured, submit the job using:
qsub Feko_submit.sh
After successful submission, the scheduler generates a unique Job ID. Keep this ID for monitoring the simulation.
8. Monitoring Job Status
Use the following commands to monitor the submitted job.
Check job status:
qstat <Job_ID>
View job execution and node allocation details:
qstat -answ <Job_ID>
The job status can also be monitored by inspecting the corresponding output (.out) file in the working directory through an SFTP client.
9. Retrieving Simulation Results
Wait until the submitted job has completed.
Navigate to the working directory through the SFTP interface.
Locate the generated output files.
Download the completed simulation results to your local workstation.
Open the results in the appropriate Feko post-processing tools.
10. Commonly Used HPC Commands
| Command | Description |
|---|---|
pwd |
Displays the present working directory |
ls |
Lists files and directories |
cd <directory> |
Navigates to a directory |
cat <filename> |
Displays file contents |
vi <filename> |
Opens and edits a file |
:wq |
Saves changes and exits the vi editor |
qsub <script.sh> |
Submits a job to the scheduler |
qstat <Job_ID> |
Checks job status |
qstat -answ <Job_ID> |
Displays job execution and node details |
11. Important Notes
Cluster login credentials and connection details must be obtained from the respective HPC administrator.
Working directory paths and resource allocation settings may vary between HPC environments.
Job submission scripts must be configured according to the installed solver version and scheduler environment.
The commands provided in this guide assume a PBS-compatible job scheduler.
Ensure that all required simulation input files are uploaded before submitting the job.