Maestro

Schrödinger Maestro is a versatile molecular modeling environment. It has modules for drug design and materials science. It can be used to build, edit, run and analyze chemical model systems.

Schrödinger Maestro provides access to the Desmond molecular dynamics engine, which runs very well on GPUs. We recommend watching the video below on how to set up and run Desmond MD simulations on Puhti easily.

See also the bottom of this page for links to further self-learning materials.

• Maestro
  • Available
  • License
  • Usage
    • Local installation
    • Standalone usage on Puhti
      • Video: How to run a Desmond simulation on Puhti
  • References
  • More information

Available

• Puhti: 2023.1, 2023.2, 2023.3, 2023.4, 2024.1, 2024.2, 2024.3, 2024.4
• Mahti: 2023.1, 2023.2, 2023.3, 2023.4, 2024.1, 2024.2, 2024.3, 2024.4

A two-year cleaning cycle is applied on the Maestro modules on CSC supercomputers. Specifically, this means that module versions older than two years will be removed. This policy is enforced to free up disk space and encourage use of the latest versions which tend to be more performant and have less bugs.

Some notes about warnings

Maestro gives a warning for using a schrodinger.hosts file from your home directory. This is not an issue: that file cannot be made available in the installation directory, so please ignore the warning, but consider any others you may see.

Similarly, warnings about missing graphics libraries should be harmless. However, don't hesitate to contact CSC Service Desk if you are unsure about any warning or error message you might get when using Maestro at CSC.

License

Maestro is available for all academic users in Finland: staff and students, for academic purposes. Please consult the EULA for the exact definition. Using Maestro means that you accept the EULA linked to above. The Maestro license consists of floating licenses and tokens. If licenses run out, contact us via ServiceDesk.

Usage

It is recommended to download and install Maestro on your own computer, see below.

Local installation

Maestro versions 2024.3 onward use a new license manager

Please note that the license configuration instructions have been updated for Maestro versions 2024.3 and later, which use the new Schrödinger License Manager (SLM).

Maestro can be installed on a Linux, Mac or Windows computer. Download the appropriate files from the Schrödinger website. You don't need a license to download the software, although you do need to register at the Schrödinger website first. Note that getting access may take up to 24 hours, so please be patient.

After you've downloaded and installed Maestro, you'll need to configure licensing to be able to run the software. See these instructions on how to configure licensing (logging in to Eduuni requires Haka authentication). Accessing the license requires that your computer is in the FUNET network, i.e. you're at the university or connected to it via VPN from home.

Standalone usage on Puhti

Puhti vs. Mahti

Note that Mahti is mostly suitable for running Desmond MD simulations on GPUs. Most other jobs do not scale to full nodes, so please use Puhti instead for these. If in doubt, contact us.

It is possible to run heavier computations on Puhti. Here, a brief overview is given. Additional details and some diagnostics tips are explained in our Maestro power usage tutorial. See also the video below.

First, you need to get a CSC account and apply for access to Puhti. Before you start the actual workflow below, you need to set up your Maestro environment on Puhti.

These first four steps you only need to do once:

1. SSH to Puhti
   • ssh <your username>@puhti.csc.fi
2. Initialize Maestro with module load maestro
   • Make sure you use the same version as on your local computer
3. An error may appear on your screen. If it asks you to run a script to generate the hosts file, run it (copy paste it to the command line)
   • Now you have your own schrodinger.hosts file in your $HOME directory
4. Copy the HOST descriptions from the schrodinger.hosts file on Puhti to your local hosts file on your computer
   • Copy everything starting from name: test and paste it at the end of your local schrodinger.hosts file
   • This step may need administrator privileges

For actual simulations we recommend using Puhti as follows:

1. Set up your simulations on your local computer
2. Write the GUI-generated input files to disk
3. Copy them to Puhti with e.g. scp or through the Puhti web interface
4. If needed, edit the submission script (your-jobname.sh)
5. Run the script on the Puhti command line to submit the jobs to the queuing system
6. Copy the results back for analysis

Note

Maestro jobs are not run via batch scripts like most other applications at CSC, but via Schrödinger binaries using options.

For example, a Desmond workflow could be run with the script:

"${SCHRODINGER}/utilities/multisim" -JOBNAME 2hhb_test -HOST gputest  \
-maxjob 1 -cpu 1 -m 2hhb_test.msj -c 2hhb_test.cfg -description "Molecular Dynamics" \
2hhb_test.cms -mode umbrella -set stage[1].set_family.md.jlaunch_opt=["-gpu"] \
-o 2hhb_test-out.cms -lic "DESMOND_GPGPU:16 -set "stage[1].set_family.md.jlaunch_opt=["\-LOCAL\"]" \
-LOCAL"

The scripts tend to be somewhat complicated, so it's best to write them out from the Maestro GUI as explained above. Please also have a look at the additional flags we recommend to use.

To submit such a script in Puhti, you need to first load Maestro and then run the script

module load maestro
bash your_script_name.sh

Maestro GUI

We do not recommend running the Maestro GUI remotely on Puhti. It can be done via the Puhti web interface remote desktop, but the performance may be somewhat slow and submitted jobs may end up fizzled. Also, no long/heavy tasks should be done on the login nodes. Please consult the Usage policy page for more details.

Note for Windows users

Windows users may need to edit the script created by the GUI a little. Replace the backslashes \ with / in the path to the Maestro binary (right after $SCHRODINGER in the script).

Video: How to run a Desmond simulation on Puhti

The following tutorial video walks you through the process:

References

Please cite the Maestro modules in all published work as described in the Module manuals. Jaguar, for example, should be acknowledged with:

Jaguar, version 7.6, Schrödinger, LLC, New York, NY, 2009.

More information

• Tutorial and tips for power usage on Puhti
• Manual including tutorials come with the Maestro GUI
• Schrödinger training materials overview
  • Life science
  • Materials science
• Free learning resources at Schrödinger
  • Life science
  • Materials science
• The Schrödinger knowledge base has an extensive collection of articles, for example:
  • How to restart a single Desmond simulation
  • How to restart a Desmond multisim workflow
  • Structure file formats compatible with Maestro
• Video materials:
  • Preparing, running and analyzing molecular dynamics simulations with Desmond
  • Getting Going with Maestro
  • Getting Going with Materials Science Maestro
  • Schrödinger YouTube channel
• Issues on how to run Maestro in CSC environment: contact CSC Service Desk
• Scientific questions related to Maestro modules: contact Schrödinger Support

Do you find this page useful?

Yes

Thank you for your feedback!

No

Thank you! Your feedback is appreciated.

Please let us know how we could improve this page by contacting us or by creating an issue in GitHub. You can also edit this page yourself and contribute your improvements by creating a pull request.