Interactive Startup Reference

Simcenter STAR-CCM+ presents you with a dialog containing startup options when you create a simulation or load an existing simulation. These options control how Simcenter STAR-CCM+ launches the server. Some options are specific to the Load Simulation dialog.

Process Options

Serial
Launches a server on a single process on the local machine. This means that both the client and the server are running on your local machine. This setting is the default setting.
Remote Server
To launch a server in serial on a remote machine, activate the Remote Server checkbox. Complete the Remote Host and Remote User properties, and set the type of Remote Shell that Simcenter STAR-CCM+ must use for the connection. If you previously set default values for the Generic Remote Process Launch Command in the Options dialog, these values are shown here.
If you are using a remote server with a different user name, the Connection Mode of the simulation must be set to Collaboration.
To view files on the remote machine, activate Use Remote File Browser.
Parallel on Local Host
Launches a server running across the number of Compute Processes that you choose. Simcenter STAR-CCM+ applies the default choice of Message Passing Interface (MPI) unless you specify an alternative within the Command line entry at the bottom of the dialog. See Supported MPI Implementations.
Parallel on Named Hosts
As for Parallel on Local Host, except that you can enter a list of Host names and the number of compute processes that Simcenter STAR-CCM+ allocates on each.

Specify the machines by typing entries into the list. Click in the Host column of the first row of this list and type the first machine name. Press <Tab> or <Enter> to move to the next row.

In addition to the table format, this dialog contains buttons for modifying the list of hosts. Simply enter the name of the host in the Add Host text box and click the Add button. The Delete button deletes from the list a host whose name you select in the list. Simcenter STAR-CCM+ stops using this host for parallel processing.

Verify all your hostnames before attempting to launch the simulation. If any of the hostnames is incorrect when you click the OK button, Simcenter STAR-CCM+ generates an error message and no simulation is started.

If you frequently use the same set of machines for your parallel jobs, you can create a machine file for convenience.
Parallel Specified by Machine File
Launches a server running on machines that Simcenter STAR-CCM+ selects, in order, from the chosen Machine File. For details on how you define this file, see Defining a Machine File. Set the number of Compute Processes for the server.

GPGPU Usage

After enabling GPGPU Usage, you can select which of the avilable GPGPU cards you intend to use.

Automatic
Simcenter STAR-CCM+ uses all suitable GPGPUs available on the local machine. This is the default option.
Count
Allows you to specify the number of GPGPUs Simcenter STAR-CCM+ uses when running the simulation. To determine their suitability, the installed GPGPUs are sorted according to their memory capacity in descending order.
Specific
Allows you to specify the GPGPUs Simcenter STAR-CCM+ uses when running the simulation from a list of available GPGPUs. For more information, see GPGPU Options.
File
Allows you to specify the GPGPU configuration from a file. This option is useful when different selections must be made on different hosts.

The file must contain a single line per host, with the -gpgpu arguments defined for each host. See GPGPU Options.

No MPS
Prevents CUDA Multi-Process (MPS) being automatically enabled when there are more CPU processes than GPGPUs being used on the host. Activating this option can result in serialization for oversubscribed GPGPU utilization. See Using MPS. This option has no effect on AMD GPUs.
Force
Forces the usage of the GPGPUs with the indices specified without validation. Available when the GPGPUs are selected using Specific.

Saved Configurations

To save all the options on the current dialog:
  • Enter a name within the text entry and click Save.
To reload an existing configuration:
  • Select the configuration from the drop-down list.

License

Choose the correct license option for your organization:
  • Read-only Mode (Load Simulation only): allows you to view a simulation without consuming a Simcenter STAR-CCM+ license. However, the license manager must still be detected by the launch process. When this option is selected, the OK button is grayed out unless you specify a file path.
  • Lite: launches Simcenter STAR-CCM+ with a limited set of capabilities. Not compatible with Power Session or Power on Demand. See Capabilities of STAR-CCM+ Lite
  • Power Session: allows you to launch a Simcenter STAR-CCM+ server with an unlimited number of compute processes on CPUs.
  • Power Session Plus: allows you to launch a Simcenter STAR-CCM+ server with an unlimited number of compute processes on CPUs and GPGPUs
  • Power on Demand: allows you to use a Simcenter STAR-CCM+ Power Session from a public license server rather than a license server on your own network. See Power on Demand Licensing.

Server Connection Mode

The following settings control whether and how other users may connect to the server of this simulation:

  • Default: A user on the local area network (LAN) can connect using the user name of the person who started the server.
  • No Connections: The server session is exclusive to the Simcenter STAR-CCM+ client (or console) session that launched it. No other users can connect to that server. The File > Disconnect menu item is grayed out.
  • Collaboration: Any Simcenter STAR-CCM+ user on the LAN can connect to the server regardless of the user name.

Rendering

This parameter causes graphics rendering to use the graphics capabilities of a remote machine:

  • Local (default)—rendering is not remote. Rather, it is performed in the local Simcenter STAR-CCM+ client.
  • Server—rendering is performed by a separate server process on the same machine that hosts the Simcenter STAR-CCM+ primary process.
  • Dedicated Service—allows you to select a host and port on which a rendering service is already available. To locate a rendering service on a particular machine:
    • Enter the hostname of that machine in the Host field.
    • Click Scan. Any available rendering services appear in a drop-down list of ports in the Port field.
  • Ad hoc Service—allows the server to launch a render server on the user-defined machine. For details about this type of rendering, see Additional Information on Remote Rendering.

Simulation File Browse and Query

The Use Remote File Browser checkbox, when activated, starts the file browser on a remote machine when you click the Browse button.

You would use this option if a remote server is specified and the remote machine does not share a file system with the local machine. However, sometimes it is faster to use the local file browser when the local and remote hosts do share a common file system (for example, NFS or Windows Shared Folders). The path to the simulation file must always be valid on the server host (controller host for parallel).

If you click OK with no file path specified, Simcenter STAR-CCM+ creates a simulation.

Command

This entry box shows the command line options that the client applies when you launch the server. Some options are defined by choices that you make in the launch dialog; other options, such as the choice of remote shell, are set within the Options dialog. You can also define options within the command line itself.

The server command line can include parameters that have been internally encoded. This encoding is applied in order to avoid issues with different unicode encoding and special characters. All encoding is applied using base64 on UTF-8 representations of command line parameters. Encoded parameters are passed explicitly using arguments that reflect their encoding, that is, -xencoded-* <encoded value>.

For a list of command line options, see the Command-Line Reference. Some command line parameters are internal and not reflected in the command line reference.
  • If you edit the command line directly, Simcenter STAR-CCM+ parses the options and updates its launch settings. For example, if you change "-np 2" to "-np 4", Simcenter STAR-CCM+ updates the Compute Processes entry in the launch panel.
  • Invalid edits to the command line are ignored.
  • Simcenter STAR-CCM+ retains changes that you make to launch settings for the rest of the client session.