RSM: Structures Tutorial

This tutorial will introduce you to submitting ANSYS Structures jobs in Rescale through the ANSYS Remote Solve Manager (RSM).

This tutorial presents an example using ANSYS Mechanical APDL. All of this is done without having to leave the Workbench environment.

You can apply the instructions of these tutorials to your own ANSYS model, or if you would like you can use the example files for each method. Click on the "Import Job Setup" button to clone the job hosting the file. Click "Save" on the job to have a copy of the file in your Rescale cloud files.

Currently, to link the RSM tool to the Rescale cloud platform, you will need to setup a Rescale Desktop session.

You can find a guide on how to set up a desktop session here.

This tutorial will introduce you to submitting jobs from ANSYS Workbench directly to the Rescale platform.

For this example, we will submit a very simple setup using the APDL module on Workbench. Please use the link below to clone the job and hit the save button to have a copy of the files (input.dat) that we will be using.

Import Job Setup

Launch a Remote Desktop on Rescale

For this example, please set up a custom Windows desktop, and attach ANSYS Structures version 18.0 and the job that you have cloned above (Mechanical APDL Submission from RSM), and launch the desktop.

ANSYS Structures Desktop

RSM Submission

On the desktop, launch ANSYS Workbench through the shortcut found on the Desktop.

Launch Workbench

Next, go to File > Restore Archive to import the worbench file that you attached previously. The mech_rsm_project.wbpz file can be found in the attached_jobs folder found on the Desktop.

Upon restoring the project, you will be asked where you would like to save the project. Save this project outside of the " Desktops > attached__jobs > jobid-jobname > input" directory such as in the "This PC > Documents" folder.

Once loaded, right click on the stage that requires updating and select properties. The properties panel will pop up on the right pane. First, in the "General" section, add -mpi ibmmpi under "Command line Options". Second, in the "Solution Process" section, change "Update Option" to Submit to Remote Solve Manager, "RSM Queue" to the required coretype, "Execution Mode" to Parallel, and "Number of Processes" to number of cores you would like to run on. You can also change the "Job Name" field to name your Rescale job as well.

RSM Properties

Next, right click the same section once again and update. If you have not already done so, ANSYS will ask you to save the Workbench project before allowing you to submit it.

You can monitor the submission to RSM on the "Job Monitor" tab on the bottom right hand corner of Workbench. Alternatively, you can now log on to the Rescale platform to find a new job on your dashboard.

APDL RSM Submitted

Once the job has been completed, you will see the screen below. The job (and files) are also saved on the Rescale platform, keeping all your jobs/files organized and contained.

APDL RSM Completed

This tutorial will show you to submit jobs in the ANSYS Mechanical GUI. We will set up a "solve process setting", submit an RSM queue, and simply wait for the results to automatically populate back to ANSYS Mechanical.

You can apply the instructions of this tutorial with your own ANSYS Mechanical model, or if you would like, you can use the example Workbench project file (.wbpz) from the link below.

Import Workbench project

Launch a Remote Desktop on Rescale

For this example, please set up a custom Windows desktop, and attach ANSYS Structures version 18.0 and the job that you have cloned above (ANSYS Mechanical Example Project), and launch the desktop.

ANSYS Structures Desktop

Create and set up Job Queue

On the desktop, launch ANSYS Workbench through the shortcut found on the Desktop.

Launch Workbench

Next, go to File > Restore Archive to import the worbench file that you attached previously. The mechanical_example_project.wbpz file can be found in the attached_jobs folder found on the Desktop.

Upon restoring the project, you will be asked where you would like to save the project. Save this project outside of the " Desktops > attached__jobs > jobid-jobname > input" directory such as in the "This PC > Documents" folder.

Make sure the status of all pre-processing cells are complete (green check marks). The example model is a 15-foot long tapered I-beam made of steel under a buckling load. Make sure all pre-processing cells are complete (green check marks), as well as, all setup solver definitions. Double click on the setup cell A5 to open ANSYS Mechanical. Next, we have to create a custom RSM solve process setting that we can use.

  • In the ANSYS Mechanical GUI, go to the top and Click "Tools" and then "Solve Process Settings". A window under the latter name will display, click "Add Queue".

MECH GUI Solve process settings

  • Give the RSM Queue a name. The default name is "Remote" but we highly suggest a name describing the core type. In this example we will name it "Onyx", then press "OK". On this newly created queue, its settings now appear on the right hand side.

  • Under RSM Queue, select the Rescale hardware setting for this job. For this tutorial we will select the Rescale Onyx option.

  • Under Job Name, give the job a name which will appear on the Rescale platform once you submit. Next, select the license corresponding to your ANSYS subscription to checkout for the analysis. For this tutorial, we select the ANSYS Mechanical Enterprise license.

MECH GUI Finished Solve process settings

  • With the newly created queue still highlighted, click on "Advanced..."

  • Under "Max number of utilized cores:", select the # of cores you would like to request for this job. In this example, we are requesting 4 cores.

  • Under "Additional Command Line Arguments:", type the following command:

    -mpi ibmmpi

MECH GUI Advanced Properties

  • Press "OK" to accept and leave Advanced Properties. Press "OK" once more to accept and leave Solve Process Settings

Submit and monitor your job

Once the RSM Queue has been created, we can now push it through submission.

  • In the ANSYS Mechanical GUI, highlight the Solution state in the tree on the left. For this example, it will be Solution(A6), then click on the drop down arrow to the right of the Solve button. Be careful not to accidentally hit the "Solve" button as that will solve the analysis from your computer and ignoring your RSM configuration.

MECH GUI Ready to submit

  • Click on the name of the Queue and this action will submit the job. In this tutorial, we had named the Queue as "Onyx"

  • If you had done all previous steps correctly, you should immediately be able to see a progress window of the solution.

MECH GUI RSM solution status

The RSM Queue configured to a Rescale hardware is automatically sent to your Rescale platform account. Feel free to switch to your Rescale account in your browser and you should see your job in progress as if you had done this manually in the Rescale platform.

Feel free to monitor the status of your job and get information about your cluster in real-time. A guide on "Monitoring Status" on Rescale is found here.

Once the job finished, the results in its entirety will be populated back to ANSYS Mechanical. You can verify this in Workbench by opening the "Job Monitor" on the status bar and see the status changed to "Complete". Also the Solution state and all its sub components should show a green "down arrow" indicating a succesful transfer.

MECH GUI Succesful completion