KB-2026001: How to Submit and Monitor Feko Jobs on an HPC Cluster

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

  1. Generate the Feko simulation input file (.cfx) on your local workstation.

  2. Ensure that the filename does not contain spaces or special characters. Use underscores (_) where necessary.

  3. 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

  1. Open your preferred SSH/SFTP client.

  2. Enter the HPC cluster hostname or IP address provided by the administrator.

  3. Authenticate using your assigned credentials.

  4. Establish an SFTP connection to access the cluster's file system.

  5. Navigate to your designated working directory.

5. Uploading Simulation Files

  1. Using the SFTP interface, navigate to your designated working directory on the HPC cluster.

  2. Upload the Feko .cfx file from your local workstation.

  3. Ensure that the file transfer is complete before proceeding.

6. Configuring the Job Submission Script

  1. Establish an SSH connection to the HPC cluster.

  2. Navigate to your working directory using:

    cd <working_directory>

  3. Locate the Feko job submission script provided or configured for the cluster.

    Example: Feko_submit.sh

  4. Open the script using a text editor:

    vi Feko_submit.sh

  5. Locate the command containing runfeko.

  6. Update the simulation filename to match the uploaded .cfx file.

  7. 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

  1. Wait until the submitted job has completed.

  2. Navigate to the working directory through the SFTP interface.

  3. Locate the generated output files.

  4. Download the completed simulation results to your local workstation.

  5. 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.

Tags
Unifying Engineering Disciplines : Multi Domain Systems Simulation with Simcenter Amesim
KB2026002: How to model condensation