Chapter 4: Running ANSYS Fluent Utility Scripts under SGE

You can run the ANSYS Fluent utility scripts (for example, fe2ram, fl42seg, ic3m2ram, partition, tconv, tmerge, viewfac, tpoly) with the SGE load management system.

The command line syntax to launch an ANSYS Fluent utility script under SGE is as follows:

utility utility_name [utility_opts] -sge [-sgeq queue_name] [-sgepe parallel_env MIN_N-MAX_N] utility_inputs

where

utility_name

is the name of the utility to be launched (for example, fe2ram, fl42seg, ic3m2ram, partition, tconv, tmerge, viewfac, tpoly).

utility_opts

are the options that are part of the syntax of the utility being launched. For more information about the options for the various utilities, see the ANSYS Fluent User's Guide.

-sge

(start-up option) instructs utility_name to run under SGE.

-sgeq queue_name

(start-up option) specifies the name of the queue.

-sgepe parallel_env MIN_N-MAX_N

(start-up option) specifies the parallel environment to be used when utility_name is run in parallel. This should be used only if the -sge option is used.

The specified parallel_env must be defined by an administrator. For more information about creating a parallel environment, refer to the sample_pe file that is located in the /addons/sge directory in your ANSYS Fluent installation area.

The values for MIN_N and MAX_N specify the minimum and maximum number of compute nodes, respectively.

If utility_name is run in parallel under SGE and the -sgepe parameter is not specified, by default the utility will attempt to utilize a parallel environment called utility_pe. Note that utility_pe must be defined by an administrator if you are to use this default parallel environment. In such a case, MIN_N will be set to 1 and MAX_N will be set to the maximum number of requested compute nodes specified in the utility_opts (for example, -t4).

For example, to run the viewfac utility on file_name in serial, the line command would be the following:

utility viewfac -sge file_name

In parallel with 4 CPUs, without the use of -sgepe (and therefore using the parallel environment utility_pe), the command would be:

utility viewfac -t4 -sge file_name

In parallel on a range of nodes (between 1 and 2) with the use of -sgepe and the parallel environment diff_pe, the command would be:

utility viewfac -t4 -sge -sgepe diff_pe1 -2 file_name

utility_inputs

are the fields that are part of the syntax of the utility being launched. For more information about the necessary fields for the various utilities, see the ANSYS Fluent User's Guide.


Important:  Note that neither checkpointing, restarting, nor migrating are available when using the utility scripts under SGE.


For more information, see the following section:


Release 18.2 - © ANSYS, Inc. All rights reserved.