Skip to main content

How-To Guides

Explore step-by-step guides for accessing the Bishop computing cluster, managing workloads with SLURM and submitting jobs using specialized engineering software. These resources support computing tasks for Aerospace Engineering students, faculty and staff.

How to Get In

The best source of information for those wanting to apply is the Cal Poly Admissions website.  There you can find out about selection criteria, as well as the requirements for both new students and transfers from other programs or schools.  If you’re ready to take the next step, request information from the Admissions Office.

For transfer students, the assist.org website can help determine which courses will transfer to our program.

Undergraduate and Graduate application deadlines can also be found at the Cal Poly Admissions website.

Access Bishop Offsite

Bishop can be accessed offsite by connecting to the campus’ Global Protect VPN, logging into the Aero Open Labs at https://cengwts.calpoly.edu, and launching PuTTY or WinSCP with Bishop’s IP address.

Alternatively, VPN access to Bishop from any machine can be requested via the campus’ ticketing system [https://calpoly.atlassian.net/servicedesk/customer/portals]. If access is granted, Bishop can be reached via SSH, PuTTY, or WinSCP at Bishop’s IP address.

How to Submit an Ansys Job

To schedule a job, you will need to write a SLURM batch script for your job. See the example below. Save your script as jobname.sbatch. Once you have written your script you will need to run it.

Run a SLURM Batch Script:
[user@Head ~]$ sbatch jobname.sbatch

Example Ansys Serial Batch Script:
#!/bin/bash
#
#SBATCH –comment=ansys-serial-test
#SBATCH –ntasks=1
#SBATCH –job-name=ansys-serial-test
#SBATCH –output=output.%j.ansys-serial-test
#SBATCH –time=00:01:00

#### SLURM 1 processor Ansys test to run for 1 minute.

module add ansys182

>ansys < ansys-test.in

Example Ansys Distributed Parallel Batch Script:
#!/bin/bash
#
#SBATCH –comment=ansys-parallel-test #SBATCH –ntasks=4
#SBATCH –job-name=ansys-parallel-test
#SBATCH –output=output.%j.ansys-parallel-test
#SBATCH –time=00:10:00

#### SLURM 4 processor Ansys test to run for 10 minutes.

module add ansys182

ansys < ansys-test.in

How to Submit a FieldView Job

To schedule a job, you will need to write a SLURM batch script for your job. See the example below. Save your script as jobname.sbatch. Once you have written your script you will need to run it.

Run a SLURM Batch Script:
[user@Head ~]$ sbatch jobname.sbatch

Example SLURM Batch Script:
#!/bin/bash
#
#SBATCH –comment=fieldview-test1
#SBATCH –ntasks=4
#SBATCH –job-name=fieldview-test
#SBATCH –output=output.%j.fieldview-test
#SBATCH –time=01:00:00  

module add fieldview

fv -batch -s test.sim

FieldView Batch Command-Line Switches

Argument Description
-batch run in batch mode
-fvbN

use batch-only license, batch mode forced

N refers to the number of parallel processes which can be run in batch-only mode and can be set to 8, 16, 32 or 64. A batch-only license, consistent with N, is needed for this switch to work correctly. (1)

-f name run a restart when starting FieldView
-s name run a script when starting FieldView
-fvx name run an FVX program when starting FieldView
-pfvN

use parallel license

N refers to the number of parallel processes which can be run in parallel (not including the master process) and can be set to 8, 16, 32 or 64. A parallel license, consistent with N, is needed for this switch to work correctly. (1)

-python name run a python program when starting FieldView
-pN DataGuide TM switches:
0 : only Grid file
1 : both, function subset
2 : both, all functions
-fc use PLOT3D/Fast mouse controls
– create_exterior_fvbnd Generate FVBND file (must be used with -pN)
-create_wall_fvbnd Generate FVBND file (must be used with -pN)
-gamma value set PLOT3D gamma (default=1.4)
-gasconstant value set PLOT3D gas constant, R (default=1.0)
-silent suppress all warning pop-ups
-port port_number set the port number to use for Client-Server or Parallel operation
How to Submit a Matlab Job

To schedule a job, you will need to write a SLURM batch script for your job. See the example below. Save your script as jobname.sbatch. Once you have written your script you will need to run it.

Run a SLURM Batch Script:
[user@Head ~]$ sbatch jobname.sbatch

Example SLURM Batch Script:
#!/bin/bash

#SBATCH –job-name=test
#SBATCH –output=matlab_simple.out
#SBATCH –error=matlab_simple.err
#SBATCH –time=00:10:00
#SBATCH –nodes=4
#SBATCH –ntasks=4

# Load Module
module load matlab/2017a

# Kick off matlab
matlab -nodisplay < matlab_simple.m

How to Submit a Star-CCM+ Job

To schedule a job, you will need to write a SLURM batch script for your job. See the example below. Save your script as jobname.sbatch. Once you have written your script you will need to run it.

Run a SLURM Batch Script:
[user@Head ~]$ sbatch jobname.sbatch

Example SLURM Batch Script:
#!/bin/bash
#
#SBATCH –comment=starccm-parallel-test
#SBATCH –ntasks=4
#SBATCH –job-name=starccm-parallel-test
#SBATCH –output=output.%j.starccm-parallel-test
#SBATCH –time=01:00:00  

#### SLURM 4 processor STAR-CCM+ test to run for 1 hour.

module purge
module add StarCCM+

starccm+ -batch -power -podkey podkey -licpath 1999@flex.cd-adapco.com -np $SLURM_NTASKS filename.sim

How to Submit an Ansys Fluent Job

To schedule a job, you will need to write a script file (typically with the extension .sh, .sbatch, or .bash) with a series of commands to be executed by SLURM when resources are available. See the example below to run Ansys Fluent in serial or parallel mode.

Example Ansys Fluent Batch Script:
#!/bin/bash
#
#SBATCH –ntasks=4
#SBATCH –job-name=fluent-test
#SBATCH –output=output.%j.fluent-test
#SBATCH –time=00:10:00

####SLURM4 processor Ansys Fluent test to run for 10 minutes.

module purge
module add fluent/v182

time fluent 3ddp -t4 -g -i fluent-test.jou

NOTES:

  1. The first line of this example names the execution environment (in this case “bash” which stands for “bourne again shell”) for the subsequent commands.
  2. Lines that start with one # are comments for bash. Lines that start with two or more #’s are comments for both bash and SLURM.
  3. Lines that start with #SBATCH are SLURM job control directives. These need to come before the executable lines at the bottom (which will be executed when SLURM determines resources are available).

    –ntasks=4 sets the number of tasks (or processors) to be launched. Use 1 to execute in serial mode and more than 1 to execute in parallel mode.

    –job-name= fluent-test sets the name for your job that will be shown in queue.

    –output=output.%j.fluent-test sets the file name for any output that would otherwise be sent to the screen where the %j will be replaced by the job number. This file can be viewed while your job is still running to monitor progress.

    –time=0:10:00 sets the maximum time for execution.

  4. The “module” lines configure the execution environment by purging the environment (variables, paths, etc.) and then setting up the current version of Ansys Fluent on the server.
  5. The final line starts Ansys Fluent. At the beginning of the line is “time” which is a bash command that adds lines to the end of the output file indicating execution time. The 3ddp option starts Ansys Fluent in three-dimensional, double precision mode, -t4 sets the number of processors (which can be the same or less than the number set above), -g suppresses graphics, and -i specifies the Ansys Fluent input file. The most common input file will be a Ansys Fluent journal file that contains a list of TUI (text user interface) commands.
  6. Save your file to your current directory and execute it using the following command:

    [user@Head ~]$ sbatch ./jobname.sh

Available Queues

To see the available queues for your account, type sinfo.

Queue Name Allowed Groups Max Time Max Nodes Comments
defq (default) All 3 days 2 Low priority
quickq All 6 hours 2 Mid priority
powerq All 12 hours 5 Low priority
priorityq Faculty, Collabs 1 day 5 Receives highest priority
extendedq Faculty, Collabs 30 days 5 Low priority

To request access to priorityq or extendedq, submit a Technology Request.